ZapMap13 - Copyright 1989 by Michael Brandon - All Rights Reserved
Released to Public Domain by author - April, 1989.


What is it?
    ZapMap13 contains the equivalent of AmigaDos 1.3 .bmap files (accounting
    for it's size). Running the program is all that a BASIC programmer will
    need to use the Amiga's LIBRARY Functions.  You can throw away your 1.3
    .bmap files if you choose (NOT recommended!) as you will not need them
    to either use this program or to use the LIBRARY functions in your own
    BASIC programs.  It can also be used with Absoft's AC-BASIC (and other
    BASICS that require the use of .bmaps to make library calls) enabling
    you to create TRUE stand alone programs!

What does it do?
    ZapMap13 will create a small SUB Program and will append that SUB
    program to the end of YOUR BASIC program (if you so desire).  The SUB
    Program adopts the name of the LIBRARY you have chosen to use.  In YOUR
    program where you would normally have the statement (for Example):
                                LIBRARY "graphics.library"

    You will substitute the statement:
                                GRAPHICS.LIBRARY

    Every other programming statement in YOUR program remains the same - You
    must still use the DECLARE FUNCTION statement and you must CLOSE the
    library before exiting YOUR program by using the LIBRARY CLOSE
    statement.

How to Use ZapMap:

    Either double-click the icon from WorkBench or start the program from
    the CLI by typing: ZapMap

    As soon as the program loads (it takes a few seconds because of it's
    size), you will be asked to select a library from the MENU.  Select the
    Library you want to use in YOUR program.

    The Program will then Create a list of all of the functions accessable
    by BASIC for the chosen library.  It will list them in alphabetical
    order and assign a number to each.

    You simply follow the program's instructions and select the functions
    you wish to use by it's NUMBER.  Select as many or as few as you want,
    they will high-light when selected.  If you change your mind, select the
    function again and it will become "UN-selected?" (and UN-high-lighted).
    When you have what you want press ESC to quit selecting functions.

    Now the program will ask you for the NAME of YOUR BASIC program to
    APPEND the SUB Program.  You can optionally give it any filename you
    wish and it will either APPEND to the named file or CREATE it if it does
    not exist and write the SUB there.

    IMPORTANT NOTE: YOUR BASIC PROGRAM must be in ASCII format and NOT in
    AmigaBASIC's compressed format. (ie. SAVE it using option "A").

    You can now choose additional libraries and repeat the above steps or
    you can QUIT.

    Look at the file you named and you will see a new SUB program appended
    at the END of it.  You CALL this SUB from within YOUR program INSTEAD of
    using the AmigaBasic LIBRARY statement.  (See bove paragraph titled
    "What does it do?").  Be sure to follow ALL OTHER rules for using
    LIBRARY CALLS in BASIC including DECLARE FUNCTION, if required, and
    LIBRARY CLOSE.  You should also use the BASIC "KILL" statement to clean
    up the RAM: disk before exiting YOUR program by deleting .bmap files
    created in RAM: (Not absolutely necessary - if you want to keep the
    created .bmap files, save them to disk - they can be used in the normal
    way).

Other Stuff You Need to know:

    Some Libraries contain more functions than will fit on one screen.  Use
    the UP ARROW and DOWN ARROW to view all the functions and their numbers.

    You will notice that the SUB program created opens a file to write the
    RAM: bmap string.  The File opened is #255.  The High number was used to
    avoid conflict with any already opened files in YOUR program (most
    people would not normally use file #255). In the event YOUR program has
    file #255 already open, you will need to change ONE of the file numbers
    to something else.

    This program is for use with Operating System 1.3 ONLY.  I have others
    for Operating System 1.2 and 1.1.  I even have one for the ARP library.
    They are called ZapMap11, ZapMap12, and ZapMapA (I'm sure you can figure
    out which is which). You can probably find these on the same BBS where
    you got this one, or you can get everything on one disk plus some other
    useful tools for advanced BASIC programming by sending a blank disk and
    $5.00 for postage (plus my trouble) to:

                Michael Brandon
                378 La Mancha Av.
                Royal Palm Beach, Fla 33411

    You may also send any suggestions, complaints or compliments to the
    above address.

    OR.. You may just USE the programs with my good wishes for your success!

                                    == M.B.==