home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 224a.lha / ZapMap_v1.3 / Instructions < prev    next >
Encoding:
Text File  |  1989-04-09  |  5.0 KB  |  109 lines
  1.  
  2. ZapMap13 - Copyright 1989 by Michael Brandon - All Rights Reserved
  3. Released to Public Domain by author - April, 1989.
  4.  
  5.  
  6. (ADDED NOTE:  Please do not confuse THIS program with the "QuickLib" program
  7. that appeared in the April issue of Amazing Computing. ZapMap is MUCH more
  8. than that and does not require that you even have copies of .bmap files.)
  9.  
  10.  
  11. What is it?
  12.     ZapMap13 contains the equivalent of AmigaDos 1.3 .bmap files (accounting
  13.     for it's size). Running the program is all that a BASIC programmer will
  14.     need to use the Amiga's LIBRARY Functions.  You can throw away your 1.3
  15.     .bmap files if you choose (NOT recommended!) as you will not need them
  16.     to either use this program or to use the LIBRARY functions in your own
  17.     BASIC programs.  It can also be used with Absoft's AC-BASIC (and other
  18.     BASICS that require the use of .bmaps to make library calls) enabling
  19.     you to create TRUE stand alone programs!
  20.  
  21. What does it do?
  22.     ZapMap13 will create a small SUB Program and will append that SUB
  23.     program to the end of YOUR BASIC program (if you so desire).  The SUB
  24.     Program adopts the name of the LIBRARY you have chosen to use.  In YOUR
  25.     program where you would normally have the statement (for Example):
  26.                                 LIBRARY "graphics.library"
  27.  
  28.     You will substitute the statement:
  29.                                 GRAPHICS.LIBRARY
  30.  
  31.     Every other programming statement in YOUR program remains the same - You
  32.     must still use the DECLARE FUNCTION statement and you must CLOSE the
  33.     library before exiting YOUR program by using the LIBRARY CLOSE
  34.     statement.
  35.  
  36. How to Use ZapMap:
  37.  
  38.     Either double-click the icon from WorkBench or start the program from
  39.     the CLI by typing: ZapMap
  40.  
  41.     As soon as the program loads (it takes a few seconds because of it's
  42.     size), you will be asked to select a library from the MENU.  Select the
  43.     Library you want to use in YOUR program.
  44.  
  45.     The Program will then Create a list of all of the functions accessable
  46.     by BASIC for the chosen library.  It will list them in alphabetical
  47.     order and assign a number to each.
  48.  
  49.     You simply follow the program's instructions and select the functions
  50.     you wish to use by it's NUMBER.  Select as many or as few as you want,
  51.     they will high-light when selected.  If you change your mind, select the
  52.     function again and it will become "UN-selected?" (and UN-high-lighted).
  53.     When you have what you want press ESC to quit selecting functions.
  54.  
  55.     Now the program will ask you for the NAME of YOUR BASIC program to
  56.     APPEND the SUB Program.  You can optionally give it any filename you
  57.     wish and it will either APPEND to the named file or CREATE it if it does
  58.     not exist and write the SUB there.
  59.  
  60.     IMPORTANT NOTE: YOUR BASIC PROGRAM must be in ASCII format and NOT in
  61.     AmigaBASIC's compressed format. (ie. SAVE it using option "A").
  62.  
  63.     You can now choose additional libraries and repeat the above steps or
  64.     you can QUIT.
  65.  
  66.     Look at the file you named and you will see a new SUB program appended
  67.     at the END of it.  You CALL this SUB from within YOUR program INSTEAD of
  68.     using the AmigaBasic LIBRARY statement.  (See bove paragraph titled
  69.     "What does it do?").  Be sure to follow ALL OTHER rules for using
  70.     LIBRARY CALLS in BASIC including DECLARE FUNCTION, if required, and
  71.     LIBRARY CLOSE.  You should also use the BASIC "KILL" statement to clean
  72.     up the RAM: disk before exiting YOUR program by deleting .bmap files
  73.     created in RAM: (Not absolutely necessary - if you want to keep the
  74.     created .bmap files, save them to disk - they can be used in the normal
  75.     way).
  76.  
  77. Other Stuff You Need to know:
  78.  
  79.     Some Libraries contain more functions than will fit on one screen.  Use
  80.     the UP ARROW and DOWN ARROW to view all the functions and their numbers.
  81.  
  82.     You will notice that the SUB program created opens a file to write the
  83.     RAM: bmap string.  The File opened is #255.  The High number was used to
  84.     avoid conflict with any already opened files in YOUR program (most
  85.     people would not normally use file #255). In the event YOUR program has
  86.     file #255 already open, you will need to change ONE of the file numbers
  87.     to something else.
  88.  
  89.     This program is for use with Operating System 1.3 ONLY.  I have others
  90.     for Operating System 1.2 and 1.1.  I even have one for the ARP library.
  91.     They are called ZapMap11, ZapMap12, and ZapMapA (I'm sure you can figure
  92.     out which is which). You can probably find these on the same BBS where
  93.     you got this one, or you can get everything on one disk plus some other
  94.     useful tools for advanced BASIC programming by sending a blank disk and
  95.     $5.00 for postage (plus my trouble) to:
  96.  
  97.                 Michael Brandon
  98.                 378 La Mancha Av.
  99.                 Royal Palm Beach, Fla 33411
  100.  
  101.     You may also send any suggestions, complaints or compliments to the
  102.     above address.
  103.  
  104.     OR... You may forget that I even exist and just USE the programs with my
  105.     good wishes for your success!
  106.  
  107.                                     == M.B.==
  108.  
  109.