Basic 8 Manual Errata Manual Corrections page 77 @CYLNDER,X,Y,RADIUS,HALFLEN,VIEW radius=1-127 page 100 @SCLIP,left,right,down,up radius is from 1-127 page 107 @SPHERE,X,Y,Radius radius=1-127 page 108 @SPOOL,X,Y,INNER RADIUS,OUTER RADIUS,VIEW radius=1-127 page 115 @TOROID,X,Y,INSIDE RADIUS,OUTSIDE RAD1US,VIEW radius 1-127 @LOGO PARANETER CHANGES FOR USE WITH @STRUCT/@SDAT/@SEND You DO NOT follow the parameters with a string of characters. Instead follow the parameters with a series of numbers that are the ASCII equivilent of the characters. For example, if your letters are "abc" you would send the following parameters after the Length parameter;,65,66,67. This will create the logo string "abc". Also, while there are no required parameters for LOGO types, you must still follow the @STRUCT command with a @SDAT on a line by itself. For example; @STRUCT,5,2,1,AD @SDAT @SDAT,l,254,0,0,0,1,1,2,3,65,66,67 @SDAT,0 @SEND This creates the LOGO string "abc". Basic 8.0 The Enhanced Graphics System For The C128 Developed by LR Wallace, DP Darus WALRUSOFT March 19, 1987 (C) 1986 WALRUSOFT ---------------------------------------------------------- Dear Valued Customer, Thank you for purchasing Basic 8 with Basic Paint. Basic Paint was created using Basic 8 and has been included with the package as an added bonus to show what can be accomplished with Basic 8. Also included is an Icon based, Desk-top utility which enables you to access your Basic 8 programs quickly and conveniently. We think you will find Basic 8 to be one of the most sophisticated and powerful software packages available for the C-l28. It breaks new ground in unleashing hidden graphic capabilities rivaling those of l6-Bit Computers! Your purchase enables us to continue to offer software of the highest quality to users of the Commodore 64 and 128. Patech Software is founded on Three Basic Principles: 1. To offer the best quality software at a fair price. (One which accurately reflects its true value to the user.) 2. To offer realistic and usable support to each Registered user after purchase, to ensure that he gets full value from the software. 3. To Present the software in its original state, without copy-protection of any kind! This enables you to make back-ups for your convenience and the protection of your investment (as well as your equipment!). You put your trust in Patech when you purchased Basic 8. In turn, we are putting our trust in you to help ensure that we are fairly compen- sated for our software. Only through this mutual trust can we continue to serve your software needs. Please don't force us to add copy protection to our software. That would only hurt both of us! Patech is a very open company. If you have any questions, comments or suggestions, please write to us. We will do our best to respond promptly. If you have written any programs (with or without the aid of Basic 8) which you think have merit, or if you have an idea for one which you think fills a genuine need, please contact us. We are always interested in good programs and ideas. Who knows, you may just become the newest member of the Patech Software Development Team! To keep fully informed of future products and updates; and to become a Registered User, please mail the enclosed Registration Card. Whenever you contact us for support, please reference the Serial Number printed on the card. (Make a record of the number before you mail the card!) I hope you find that Basic 8 fulfills your expectations. Thanks again for your support. Sincerely, Paresh Patel, President Patech Software, Inc. P.O. Box 5208 Somerset, NJ 08873 (1) TABLE OF CONTENTS Page TABLE OF CONTENTS 1 HARDWARE REQUIREMENTS 2 MAKING BACKUPS 3 PHILOSOPHY 4 FOREWORD 6 1. INTRODUCTION 8 1.1 COMMAND SUMMARY 12 1.2 STARTING BASIC 8.0 13 2. SCREENS AND MODES 14 3. DRAWING COMMANDS 20 4. THREE DIMENSIONAL GRAPHICS 25 5. MEMORY MANAGEMENT 31 5.1 BUFFERS 31 5.2 STRUCTURES 32 A. Saving and recalling STRUCTURES 33 B. Patterns 35 C. Logo 36 D. Character Font 36 E. Brush 37 6. Exotic Commands 38 7. Making A Distributable Disk - The Run Time System 42 8. BASIC PAINT 44 9. WIOS WORKBENCH And Other Supplied Utilities 62 10. Basic 8.0 COMMAND ENCLYOPEDIA 65 11. Printer Drivers 122 Appendix A: The 8563 VIDEO CHIP - Ram Expansion 173 Appendix B: VIDEO RAM MEMORY MAPS (MODE's 0-3) 175 Appendix C: C128 Basic 8.0 MEMORY MAP 177 Appendix D: File Formats, Naming Conventions 179 Appendix E: Data Compression Algorithms 185 Appendix F: Other Suggested Standards 187 The Players 188 (2) Required Equipment Commodore C128 (or C128D) Computer in C128 80 column Mode only At Least 1 disk drive (154l, 1571, 1581 and compatibles) RGB Monitor Supported Hardware Options External RAM Expansion Model 1700 128K RAM cartridge, or Model 1750 512K RAM cartridge Internal 64K RAM Expansion for the 8563 Video Display Chip (New C128D model comes with the 64K already built in.) Model 1351 Proportional Mouse Standard Joystick Dot Matrix Printers (See Chapter 11 for specific printers) (3) MAKING BACKUPS OF YOUR BASIC 8.0 DISK Even though it is copyrighted, your BASIC 8.0 disk is not copyprotected. In fact, it comes with a built in backup facility. The original disk you buy is not meant to be used for work. The first time you boot the disk, have three formatted blank disks ready. Put the original BASIC 8.0 disk into the drive and either turn on the computer or press the reset button (if the computer is already on). You vill be prompted with a menu which has three choices. These menu options allow you to make a BASIC 8.O Work Disk, a BASIC PAINT Work Disk or a BASIC 8.0 RunTime Disk. You should make one of each, then put the original BASIC 8.0 System Disk away, where it will be safe. Use it at another time to make additional work disks or runtime disks. Of course, you can also use your favorite disk copy program to back up your work disks and runtime disks. The BASIC 8.O Work Disk is for writing and editing your BASIC 8.0 programs. You may not give this disk away! Make a backup of this disk, and work from your backup work disk. This disk contains the complete BASIC 8.0 editor system, and is the disk you will use for creating your own BASIC 8.0 programs. To use this disk, just put it in the drive and boot the computer. The BASIC 8.0 system will load and become initialized. You may then write programs, run them and save them as you normally would. The difference lies in the many new BASIC 8.O commands available. The BASIC PAINT Work Disk contains the included 80 column color paint program, as well as menus, fonts and requestors. It is a RunTime Program, meaning it contains only the runtime library, not the editor. You cannot edit or list the program, (4) and you cannot sell or give it away. The BASIC PAINT disk is also an autoboot disk. Just plug in a 1351 mouse into port one or a joystick into port two and boot the disk. You will be presented with a series of menus and requestors that allow you to configure the program to your system. The BASIC 8.0 RunTime Disk is the only legal way to sell or give away programs you have written with BASIC 8.0. It contains the RunTime Library, which is a program that allows BASIC 8.0 programs to run, but not edited or listed. This disk also contains the WORKBENCH program, which is simply a BASIC 8.0 program that allows you to use a mouse to load and run BASIC 8.0 programs. This disk too is a autoboot disk. It will load and activate the RunTime Library, and then it loads and runs the WIOS WORKBENCH. You can put your own programs and their required files on this disk, where they can be loaded by pointing the mouse and selecting them with the mouse buttons. Or you can alter the booting sequence of the RunTime Disk in order to directly load and run your program. See Chapter Seven for details. OUR PHILOSOPHY ON SOFTWARE COPY PROTECTION We made a very deliberate decision to not put any type of copy protection on the disk, so you could easily make working disks. At this time, nearly all new Commodore software is protected. So why not BASIC 8.0? We believe that C128 users deserve to be trusted. We believe in giving you valu...
Amiga7878