SILICON SALAD INSTRUCTIONS -------------------------- This disk contains many programs- so many, in fact, that they are divided into three groups, selectable from three separate menus, named "M", "U" and "T". the HELLO program, which Runs when you boot the disk, lets you select a Menu, or see the Program Notes, which (might) discuss programs or features not described in these instructions. All program titles may be displayed by typing "CATALOG", and accessed with normal commands (such as "RUN Program"), without using a menu. M: THE MAIN MENU ---------------- The command "RUN M" will Run a Menu of all the miscellaneous Run-able programs on the Silicon Salad disk-not including the Two-Liners and the more useful programming utilities. These are mostly short "trick" programs, games or other items of interest that you will probably want to observe, and then List. To get back to the Program Menu, just type "RUNM". U: THE UTILITIES MENU --------------------- The command "RUN U" will Run the Utilities Menu, which lets you LOAD (not Run) the more useful Applesoft programming utilities. If you want to Run a utility, type "RUN" after it's loaded. To re-run the Utilities Menu, type "RUNU". T: THE TWO-LINER MENU --------------------- The command "RUN T" will Run the Two-Liners Menu. "Two-Liners" are short Applesoft programs written in one or two program line. The 26 Two-Liners on the Silicon Salad disk (all begin with the prefix "TL.") are all winners in Uncle Louie's semi-perpetual Two-Liner contest. You can have fun with many of these short programs by changing their variable values and Running them again (just type "RUN"). Note: Our GPLE is very helpful for editing long program lines. To select a Two-Liner from the "T" Menu, type a letter between A and Z. to exit, type control-C or control-Reset. The command "RUNT" gets you back to the Two-Liner Menu. FUN STUFF --------- Type "CATALOG" and scroll to the end. You will find a "Fun Stuff" category and several miscellaneous programs. Each one may be Run (type "RUN Program Name"). These are freebies not appearing in any menu- no charge for these. SELECTED PROGRAM FROM APPLE MECHANICS TIP BOOK #5 Program Name Menu BLACK+WHITE=COLOR M Proves once and for all that hi-res colors (HCOLORs 1,2,5 and 6) are nothing more than black and white (HCOLORs 0,4,3 and 7) in disguise. CHARACTER CHART M Use this program with your printer to make an ASCII conversion chart that doubles as a handy 0-255 hex/decimal converter. DEC/ROM CONVERTER M Not a program you'll use every day. DECIMAL DISASSEMBLER M For machine-languagers. This program de-hexes monitor listings. DIGIT DISSECTOR M Two ways to break a number into its separate digits. DOUBLE HI-RES M Proves the existence of 560 horizontal hi-res plots. For real machine language double hi-res, ask about Beagle Bros' Double Hi-Res Graphics utility (requires Apple IIe with Extended 80-column Card.) ERROR TOKENS M We honestly don't know why this short program prints all of those Applesoft error messages. Do you? ERROR TRAPPER U Type "EXEC ERROR TRAPPER" to add lines 0 and 63999 to an Applesoft program. Any encountered error will then LIST the offending program line, with an "arrow" (greater-than sign) pointing to the bad statement. FANCY FILER M Delete this program; it is absolutely worthless. FLASH FIX M Not as flashy as FLASH, but aesthetically more pleasing. HI-RES FLIX M Does a high-speed switch between hi-res pages 1 and 2. Variables W1 and W2 determine the time each page remains on the screen. NO-TRACE CAT M No matter how hard you try, you can't cursor-trace over these file names, because the first character of each has been converted to a control-character. PRINT-U$ING U A fast-and-easy subroutine that converts any decimal number into a rounded-off dollars-and-cents format. SNAKE CARS M Another computer dice-rolling program. SELECTED PROGRAMS FROM BEAGLE BASIC'S TIP BOOK #6 AUTO HI-RES U This program will "operate" on a hi-res picture and make it BRUNable, not just BLOAD-able.AND, when you Brun your picture, it will appear on a pre-determined page, revealing that page in split-or full screen format. Never mess with Poking or Bloading again! A 3-byte catch: If you BLOAD a converted picture, the first three bytes (upper-left silver of the screen) will be flawed. To fix the flaw, simply CALL 8192 (page 1 images) or CALL 16384 (page 2 images). BEAGLE BLACKJACK M Have fun! The space bar acts like an N ("No") key, and as an advancer for skipping the score printouts. Feel free to add enhancements like betting, insurance, and so on- we pay a hefty 1/8% royalties on computer Blackjack games! CALL 64246 M Why? Why? Why? CENTERSTRING M Centers strings! CURSOR KILLER U Say so long to your old flashing cursor. Reset gets it back. CURSOR MADNESS M Don't get too close to the screen to view this one. DEC DUMPER U After Running this program, use the "&" command to dump a range of memory in decimal, rather than hex. For example, to look at memory range 768 through 800, use this command: &768,800. HCOLOR COMBOS M A hi-res color mixer. KEYPEEKER DEMO M Demonstrates one way to tell which key has been pressed. ONERR TRY AGAIN U This program patches 48K DOS so that when a DOS error (like "File Not Found") occurs, the cursor will be placed on the same line as the typed statement that caused the error. That way, you can simply trace over your statement, making corrections as you go. (This DOS patch kills the CHAIN command.) PRINTER DE-BUGGER U Hidden control-characters or inverse screen characters can cause havoc when sent to a printer - causing line feeds, form feeds, beeps, etc. After you RUN this program (only once please), do a PR#1 to turn on your printer, then CALL 768. All control characters will be sent to the printer as lower case. Inverse and flashing characters will be printed as normal. SUBSTRING SEARCH U This program demonstrates how to find a string within a longer string. TEXT SCREEN FORMATTER U This program lets you format the 40-column text screen and convert the finished product into VTAB, HTAB and PRINT statements that can be appended to any Applesoft program. To begin, BLOAD TEXT SCREEN FORMATTER (or BRUN if you want). Then type, "CALL 25000". The following commands will let you type and format text on the 40-column screen. TO MOVE THE CURSOR TEXT APPEARANCE Left Arrow: Mover cursor left. control-F: Flash. Right Arrow: Move cursor right. control-I: Inverse. Up Arrow: Mover cursor up control-N: Normal. (non IIe; use ctrl-A). ESC: Upper/lower case toggle. Down Arrow: Move cursor down control-@: Clear the (non IIe; use ctrl-Z). screen. control-C: Center text line. TO MOVE ENTIRE SCREEN control-L: Clear to (keys are in diamond pattern) end of Line. control-S: Move screen left. Control-W: Window toggle. control-D: Move screen right. Return: Carriage return. control-E: Move screen up. QUIT AND CONVERT control-X: Move screen down. control-Q: Quit and convert. When you Quit (control-Q), any program in memory will be replaced by Applesoft statements that will print the screen the way you had it formatted. Type RUN to check it out. If you don't like what you see, add a CALL 25003 as the last program line, and you will be put back in the Screen Editor when you RUN. To start over with a clean screen, CALL 25000 again. The Applesoft code (without any Calls) may be saved on disk or appended to another Applesoft program. The default starting line and increment are both 10. To change them: POKE 25006, START-INT(START/256)*256 POKE 25007, INT(START/256) POKE 25008, INCREMENT SELECTED PROGRAMS FROM GPLE'S TIP BOOK #7 BOX EYES M Demonstrates two things: (1) Most dice, even computer dice, are normal. (2) You can make a nice bar graph on the text screen (who needs graphics?). First bar to the right side of the screen wins! HELP SCREEN M This program installs a "Help Page" on text page 2 and lets you view it whenever you want, by typing control-I (for "info") or pressing TAB key on your Apple IIe. It's up to you to expand this into a full-blown word processor. Call us when you're finished. METRONOME M Turns your $2000 Apple into a $29.95 metronome. NO WORD BREAK M This program breaks long strings, like sentences, only at spaces and hyphens. Line 100 determines if you have an Apple IIe or non IIe. Line 200 is a sample paragraph. Variable WD is column-width minus 1. HT i the left margin. QUOTE MAKER M A subroutine that makes quote marks on the screen. ROUTE 6502 M Lo-res has gotten a bad name over the years. This program demonstrates why. SCREEN SHIFTER M Run this one and press the LEFT arrow key until a non-space is in the upper left corner of the screen. Then press the RIGHT arrow. The left arrow moves the screen memory down one byte. The right arrow moves it up. Due to the nature of this memory move, the upward move copies the value of the first byte (Vtab 1, Htab 1) all the way through the screen. SCREEN FILLER M Puts all the above program to work in a slightly different way. SHUFFLER M This program shuffles cards. If doesn't play cards, it just shuffles them. TOWERS OF HANOI M This is a puzzle involving three vertical pegs. On peg #1 there is a stack of "disks" (not floppy) of decreasing sizes. The object is to transfer these disks, one at a time, in their same order, to peg #2. Use peg #3 as temporary storage. The big stickler is that you can never place a disk on top of one that is smaller. Run the program and your Apple will solve the puzzle for you. Use the Return key to view the process step by step. You may want to alter the program so that you can make the moves yourself. One of the neat tricks in this program occurs in line 1000, which GOSUBs itself repeatedly until N(TS) equals zero. VERTI-CALC M Another worthless program. Don't run this one. PROGRAMS FORM DOUBLE-TAKES TIPS & TRICKS CHART #1 BASIC DISASSEMBLER U Lets you do a no-pause disassembly of any range of memory. Now you don't have to type endless L's when doing printer dumps. HI-RES TEXT IMPRINT U This demo program uses the IMPRINT and HI-RES FONT files to transfer the text screen onto hi-res. LIST it to see how it works. You may use DOS tool kit and certain other fonts if you want (sorry, not Apple Mechanic fonts). LIST CUSTOMIZER U Applesoft, for some reason, makes you List in column-width 33. You can change that by poking a new number in program Line 20, and Running this program. PICTURE INVERSER M Makes a "negative" image of any hi-res picture. PROGRAM PEEKER U Converts short machine language programs into Applesoft: 1. LOAD PROGRAM PEEKER 2. BLOAD your machine language program. 3. RUN 4. Cursor-trace over the text on the screen. TEXT PAGE 2 TRANSFER U Transfers any windowed portion of text page 1 to text page 2. To avoid clobbering the Applesoft program in memory, do these pokes before loading or running the program: POKE 104,12: POKE 3070,0 TEXT WINDOW DUMP U Dumps any windowed portion of the 40-columned text screen to your printer. Poke locations 32-35 to set the window (see your Peeks & Pokes chart). ZERO PAGE ADDRESS CHECKER U For machine-language programmers- This program checks a range of memory to see if it uses a specified Zero-Page address. NEW UTILITIES DISK SCANNER U BRUN DISK SCANNER to search for physically damaged sectors on an unprotected initialized disk. If bad sectors are found, you may have the disk's VTOC updated-any bad sectors will be "sealed off" and not used. DOS-KILLER U If DOS 3.3 showed in your catalogs, you would see it occupying a hefty 48 sectors of disk space. Since you only need DOS on disks that will be booted, DOS-KILLER allows DOS's sectors to be over-written by your programs and files. RUN DOS-KILLERS to remove DOS. Due to the nature of DOS itself, DOS KILLER will only free 32 sectors instead of 48- a normal "data disk" will now hold 528 (496+32) sectors of information. KEY CLICKER U RUN KEY CLICKER to make each keystroke emit a click. You will be asked to select a value for the click; 12 is our favorite. Any value above 40 or below 1 gets a bit ridiculous. Reset will kill the click. CALL 768 will (probably) re-instate it. PROGRAM SPLITTER U Some Applesoft programs are so big that they and/or their variables "over write" hi-res memory, making it impossible to use hi-res. Program Splitter makes a "hole" in your program, so it "jumps over" one or both hi-res memory areas. Load your program and renumber it, if necessary, so there are no lines 0-5. Then EXEC PROGRAM SPLITTER to add a few new lines to your program. The variables P1 and P2 in Line 0 will determine which hi-res pages will be protected. When you RUN your program, don't save it; it will access a binary file called "SPLITTER". After you Run your program, don't save it; it will occupy far too much disk space. If you want to make program changes, (1) Load the program, (2) make the changes, (3) Save the program, (4) Run it. (Note: Program Splitter probably won't work if you have embedded machine code at the end of you program.) TWO-TRACK CAT U A normal disk will hold 105 file names (or 496 sectors, whichever comes first). RUN TWO-TRACK CAT with a freshly-initialized disk in your drive. Now that disk will hold 210 file names (or 480 sectors, whichever comes first.) The Silicon Salad disk itself uses a two-track catalog. UNDELETE U If you have a program that has been deleted, this program just MIGHT undelete it. If the file name has just been deleted, no problem. If other files have since been written on the disk, maybe not; give it a try anyway. After re-writing the undeleted file, test it to make sure it's all there. Try UNDELETE on disks that friends give you- uncover their deleted files! WORD ALPHABETIZER M Our contest winner- 50 words sorted in 3 seconds! In Applesoft!!