Generous Efforts of Many/gemcd.zip/GEM.CD.A.po/FEATURES:BEAGLE/SILIC.SALAD.DOC/T.SILICON.SALAD

Text File | 1990-02-15 | 16KB | 458 lines

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!!