home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 2 / CDPD_II_2352.bin / scope / 151-175 / scopedisk164 / c64emulator / manual < prev    next >
Text File  |  1992-10-27  |  158KB  |  4,885 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                                The A64 Package
  27.  
  28.                         Copyright (C) 1990, QuesTronix
  29.  
  30.                      Designed and Written By: Cliff Dugan
  31.  
  32.  
  33.                                   QuesTronix
  34.                                 P.O. Box 340285
  35.                             Hartford, CT 06134-0285
  36.                  (203)296-5331
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                                                     10/90 1.01n
  65.  
  66. -
  67.  
  68.  
  69.  
  70. COPYRIGHT
  71.  
  72.     The A64 Package, Copyright (C) 1990, QuesTronix.
  73.  
  74.     All programs in The A64 Package including, but not limited to: A64, 64Cmd,
  75.     64Dir, 64Print, 64Status, 64ToAmiga, AmigaTo64, Cache, InstallA64Font,
  76.     Pet2ASCII and StripLoadAddr are Copyright (C) 1990, QuesTronix.
  77.  
  78.     All documentation in The A64 Package including this manual are Copyright
  79.     (C) 1990, QuesTronix.
  80.  
  81.  
  82. LICENSE AGREEMENT    
  83.  
  84.     The A64 Package is being licensed to you.  You may use and distribute The
  85.     A64 Package as long as the following terms are agreed to:
  86.  
  87.     The A64 Package may not be modified in any way.  If distributed, it must
  88.     include all of the original programs and documentation it came with and all
  89.     copyright notices must remain intact.
  90.  
  91.     You may not reverse engineer any of the programs in The A64 Package nor may
  92.     you examine their inner workings in any way.
  93.  
  94.     The A64 Package may not be distributed for profit nor will it be made part
  95.     of a "for sale" public domain software collection without prior written
  96.     permission from QuesTronix.
  97.  
  98.     QuesTronix is charging a license fee, of $25.00 (plus $3.00 for shipping
  99.     and handling of the hardware interface), for the use of The A64 Package. 
  100.     After receiving the license fee, from you, QuesTronix will send you the
  101.     hardware interface that is used with most of the programs in The A64
  102.     Package. 
  103.  
  104.     Your use of any program in The A64 Package states that you agree to these
  105.     terms and have accepted this license agreement.
  106.  
  107.  
  108. DISCLAIMER
  109.  
  110.     The A64 Package is provided "as is" without warranty of any kind, either
  111.     expressed or implied, including, but not limited to, the implied warranties
  112.     of merchantability and fitness for a particular purpose.  In no event will
  113.     QuesTronix be liable for incidental, consequential or other similar
  114.     damages.  The entire risk as to the quality and performance of The A64
  115.     Package is with you.
  116.  
  117.     QuesTronix reserves the right to change The A64 Packages' copyright status
  118.     and/or cost at any time, without notice.
  119.  
  120.  
  121. CREDITS
  122.  
  123.     The A64 Package was designed and written by Cliff Dugan.
  124.  
  125.  
  126.  
  127.  
  128.                                                                           1
  129.  
  130.  
  131.  
  132. -
  133.  
  134.  
  135.  
  136. SYSTEM REQUIREMENTS
  137.  
  138.     All programs in The A64 Package will work on all Amiga models except the
  139.     A3000 (See A64 AND THE A3000 in the technical section).
  140.  
  141.     All programs in The A64 Package will work with V1.2 or higher WorkBench
  142.     (including V2.0).
  143.  
  144.     The utility programs included with The A64 Package will run with 512k RAM.
  145.  
  146.     A64 will run "as is" with 1mb RAM, but can be made to run with 512k RAM
  147.     (See A64 AND MEMORY in the TECHNICAL section).
  148.  
  149.     All programs included with The A64 Package will work with any 680x0
  150.     microprocessor (See 680x0 SUPPORT in the TECHNICAL section).
  151.  
  152.     If the hardware interface is used, a separate adapter cable is required for
  153.     the Amiga 1000.
  154.  
  155.  
  156. UPDATES
  157.  
  158.     The A64 Package may be updated from time to time.  QuesTronix will notify
  159.     registered owners, by mail, whenever The A64 Package has a major revision.
  160.     QuesTronix will upload new releases to GEnie, People Link and CompuServe
  161.     and you may obtain a copy from any one of these services.  For people who
  162.     do not have access to these services, you may order an update directly from
  163.     QuesTronix.  We are charging $3.50 for updates.  You do NOT have to be a
  164.     registered owner of The A64 Package to order an update.
  165.  
  166.  
  167. REPLACEMENTS
  168.  
  169.     QuesTronix will provide replacements of the hardware interface should it
  170.     become damaged.  Replacements will be made available to registered owners
  171.     only and will cost a nominal fee.  Please contact QuesTronix for exact
  172.     details on replacements.
  173.  
  174.  
  175. TECHNICAL SUPPORT
  176.  
  177.     QuesTronix will provide technical support to REGISTERED OWNERS ONLY!  To
  178.     become a registered owner you must fill out the registration form and mail
  179.     it with the license fee to QuesTronix (See HOW TO BECOME A REGISTERED OWNER
  180.     in the INTRODUCTION section).
  181.  
  182.  
  183. HOW TO CONTACT QUESTRONIX
  184.  
  185.     You may contact QuesTronix by calling (203)296-5331, please keep phone
  186.     calls brief, or by writing to:
  187.  
  188.                                   QuesTronix
  189.                                 P.O. Box 340285
  190.                             Hartford, CT 06134-0285
  191.  
  192.  
  193.  
  194.                                                                         2
  195.  
  196.  
  197.  
  198. -
  199.  
  200.  
  201.  
  202.     We may also be contacted via EMail on GEnie, People Link and CompuServe.
  203.  
  204.     GENie mail address: QUESTRONIX
  205.     CompuServe mail address: 73670,1510
  206.  
  207.     NOTE: As of this writing we were not yet established on People Link, but
  208.           should be within a matter of days (10/20/90).
  209.  
  210.  
  211. TRADEMARKS
  212.  
  213.     The A64 Package, A64, A64 BASIC, A64 Prefs, A64Mon and QuesTronix are
  214.         trademarks of QuesTronix.
  215.  
  216.     Commodore 64 and C64 are trademarks and COMMODORE is a registered trademark 
  217.         of Commodore Electronics, Ltd.
  218.  
  219.     Amiga, AmigaDOS and Workbench are registered trademarks of
  220.         Commodore-Amiga, Inc.
  221.  
  222.     GO-64! is a trademark of Software Insight Systems, Inc.
  223.  
  224.     The 64 Emulator is a trademark of ReadySoft, Inc.
  225.  
  226.     Deluxe Paint is a trademark of Electronic Arts.
  227.  
  228.     PrintShop is a trademark of Broderbund Software.
  229.  
  230.     GEOS is a trademark of Berkely Softworks.
  231.  
  232.     GEnie is a service mark of GE Information Services
  233.  
  234.     CompuServe is a service mark of CompuServe, Inc.
  235.  
  236.     People Link is service mark of American Home Network, Inc.
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.                                                                           3
  261.  
  262.  
  263.  
  264. -
  265.  
  266.  
  267.  
  268. TABLE OF CONTENTS
  269.  
  270.     COPYRIGHT .........................................................    1
  271.     LICENSE AGREEMENT .................................................    1
  272.     DISCLAIMER ........................................................    1 
  273.     CREDITS ...........................................................    1
  274.     SYSTEM REQUIREMENTS ...............................................    2
  275.     UPDATES ...........................................................    2
  276.     REPLACEMENTS.......................................................    2
  277.     TECHNICAL SUPPORT .................................................    2
  278.     HOW TO CONTACT QUESTRONIX .........................................    2
  279.     TRADEMARKS ........................................................    3
  280.  
  281.     INTRODUCTION ......................................................  1-1
  282.         WHAT IS THE A64 PACKAGE? ......................................  1-1
  283.         WHAT IS NEEDED? ...............................................  1-1
  284.         WHAT DOES IT COST? ............................................  1-2
  285.         HOW TO BECOME A REGISTERED OWNER ..............................  1-2
  286.         A NOTE FROM THE AUTHOR ........................................  1-3
  287.  
  288.     GETTING STARTED ...................................................  2-1
  289.        RUNNING A64 ....................................................  2-1
  290.        A64'S HARDWARE INTERFACE .......................................  2-3
  291.        INSTALLING A64'S HARDWARE INTERFACE ............................  2-3
  292.        INSTALLING THE A64 PACKAGE ON ANOTHER DISK OR HARD DISK ........  2-4
  293.  
  294.     A64 PREFS .........................................................  3-1
  295.         A64 PREFS SETTINGS AND CONFIGURATION FILES ....................  3-1
  296.         THE MENUS .....................................................  3-2
  297.  
  298.         THE PROJECT MENU ..........................................  3-2
  299.                 RESET A64 .............................................  3-2
  300.             LOAD CONFIG ...........................................  3-2
  301.             SAVE CONFIG ...........................................  3-3
  302.             NAMING CONFIGURATION FILES ........................  3-3
  303.             RESET CONFIG ..........................................  3-4
  304.             ABOUT A64 .............................................  3-4
  305.             QUIT A64 ..............................................  3-4
  306.             EXIT PREFS ............................................  3-5
  307.  
  308.         THE SYSTEM MENU ...........................................  3-6
  309.             PAR PORT ..............................................  3-6
  310.             SER PORT ..............................................  3-6
  311.             MODEMS ............................................  3-7
  312.             GAME PORTS (JOYSTICKS) ................................  3-7
  313.             SWAP PORTS GADGET .................................  3-7
  314.                     PORT 1 AND PORT 2 GADGETS .........................  3-8
  315.             DRIVES ................................................  3-9
  316.             AMIGA DRIVES ......................................  3-10
  317.  
  318.         THE GRAFIX MENU ...........................................  3-11
  319.             COLORS ................................................  3-11
  320.             COLOR GADGETS .....................................  3-11
  321.             SLIDER GADGETS ....................................  3-12
  322.             COLOR MODE GADGET .................................  3-12
  323.                 20 COLOR MODE .................................  3-13
  324.                 16 COLOR MODE .................................  3-13
  325.  
  326.                                                                           4
  327.  
  328.  
  329.  
  330. -
  331.  
  332.  
  333.  
  334.                 2, 4, & 8 COLOR MODES .........................  3-14
  335.             BORDERS ...............................................  3-15
  336.             SCRN REFRESH ..........................................  3-16
  337.             SCREEN REFRESH TYPE GADGET ........................  3-16
  338.                 DIRECT MODE ...................................  3-16
  339.                 SAMPLE MODE ...................................  3-16
  340.             SCREEN REFRESH RATE GADGET ........................  3-16
  341.             SCREEN REFRESH RATE TABLE......................  3-17
  342.  
  343.         RASTERS ...............................................  3-18
  344.             SCAN LINE READ GADGET .............................  3-18
  345.             REAL ..........................................  3-18
  346.             FAKE ..........................................  3-18
  347.  
  348.         THE TOOLS MENU ............................................  3-20
  349.             SAVE SCREEN ...........................................  3-20
  350.  
  351.         A64 PREFS NOTES ...............................................  3-21
  352.  
  353.     UTILITIES .........................................................  4-1
  354.         UTILITY SUMMARY ...............................................  4-1
  355.             CONVENTIONS FOR THE CLI BASED UTILITIES ...................  4-1
  356.         64Cmd .........................................................  4-3
  357.         64Dir .........................................................  4-4
  358.         64Print .......................................................  4-5
  359.         64Status ......................................................  4-6
  360.         64ToAmiga .....................................................  4-7
  361.         AmigaTo64 .....................................................  4-8
  362.     Cache .........................................................  4-9
  363.         InstallA64Font ................................................  4-10
  364.         Pet2ASCII .....................................................  4-11
  365.         PrintFile .....................................................  4-12
  366.         StripLoadAddr .................................................  4-13
  367.         C64 PROGRAMS ..................................................  4-14
  368.             SaveROMs ..................................................  4-14
  369.             64Colors ..................................................  4-14
  370.  
  371.     TECHNICAL .........................................................  5-1
  372.          THE A64 PACKAGES FILE STRUCTURE ..............................  5-1
  373.          THE KEYBOARD .................................................  5-2
  374.          KEYBOARD DIFFERENCES .....................................  5-2
  375.          A PROBLEM WITH THE KEYBOARD ..............................  5-2
  376.          THE NUMERIC KEYPAD .......................................  5-2
  377.          UNUSED KEYS ..............................................  5-3
  378.          A64 AND MULTITASKING .........................................  5-4
  379.          A64 AND MEMORY ...............................................  5-4
  380.          680x0 SUPPORT ................................................  5-5
  381.      A64 AND THE A3000 ............................................  5-5
  382.          ROMS .........................................................  5-6
  383.              WHAT IS ROM? .............................................  5-6
  384.              THE C64'S ROMS ...........................................  5-6
  385.              A64'S ROMS ...............................................  5-6
  386.              INSTALLING THE C64'S ROMS ................................  5-7
  387.  
  388.       PROBLEMS AND SOLUTIONS ..........................................  6-1
  389.         A64 ERRORS ....................................................  6-2
  390.         ERROR LIST ................................................  6-3
  391.  
  392.                                                                           5
  393.  
  394.  
  395.  
  396. -
  397.  
  398.  
  399.  
  400.         INCOMPATIBILITIES .............................................  6-9
  401.         FAST LOADERS ..............................................  6-9
  402.             CASSETTE PORT, USER PORT and CARTRIDGE PORT ...............  6-9
  403.             SPRITES ...................................................  6-9
  404.         KNOWN BUGS ....................................................  6-11
  405.         PAR PORT BUG ..............................................  6-11
  406.             SCREEN SHIFTED BUG ........................................  6-11
  407.       WHAT IS IN THE FUTURE ...........................................  7-1
  408.  
  409.       VERSION CHANGES .................................................  8-1
  410.           V1.01n ......................................................  8-1
  411.  
  412.       APPENDICES .......................................................   A
  413.           ERROR REPORT .................................................   A
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.                                                                           6
  459.  
  460.  
  461.  
  462. -
  463.  
  464.  
  465.  
  466. INTRODUCTION
  467.  
  468.     Welcome to The A64 Package.  This manual assumes that you are familiar with
  469.     the basic usage of the CLI and WorkBench.  If you are not please consult
  470.     your Amiga user's guide.  This manual also makes the assumption that you
  471.     are familiar with using the Commodore 64.  If you want to learn more about
  472.     using the Commodore 64 there are many good books available on the subject.
  473.  
  474.     Throughout this manual some names are used that we would like to clarify.
  475.     When you see the name "The A64 Package" we are referring to the entire
  476.     package including all its utilities.  When you see the name "A64" by itself
  477.     we are referring only to the A64 program.  The names: "A64's hardware
  478.     interface","hardware interface" or just "interface" all refer to the same
  479.     interface.
  480.  
  481.     The bulk of this manual is for describing the use and function of A64.  The
  482.     descriptions and instructions for all of The A64 Packages' utilities can be
  483.     found in the UTILITIES section.  We recommend that you fully read this
  484.     manual before attempting to use any of the programs included with The A64
  485.     Package.
  486.  
  487.  
  488. WHAT IS THE A64 PACKAGE?
  489.  
  490.     The A64 Package is a collection of Amiga programs to help Commodore 64
  491.     users upgrade to the Amiga.  We like to call The A64 Package "a Commodore
  492.     64 upgrade kit."  Commodore 64 owners have spent hundreds or even thousands
  493.     of dollars on their C64 peripherals and software.  Many of them would like
  494.     to upgrade to the Amiga, but they do not want to lose their investment.
  495.     There is a solution!  The A64 Package will allow them to continue to use
  496.     their familiar Commodore 64 software and peripherals while they're learning
  497.     how to use their powerful, new Amiga.  The main program included with The
  498.     A64 Package is A64.  A64 is a Commodore 64 emulator.  The word emulate
  499.     means to strive to equal or excel, especially through imitation.  A64
  500.     emulates the Commodore 64.  This means that using A64 is just like using a
  501.     C64.  There are literally thousands of programs available for the Commodore
  502.     64 and A64 will run a majority of them.  The A64 Package also includes
  503.     several utilities to help with the transfer of data or programs from the
  504.     Commodore 64 to the Amiga and back again.  Now bridging the gap from the
  505.     Commodore 64 to the Amiga is easier than ever before.  The A64 Package
  506.     helps to make the upgrade path a little easier to take.
  507.  
  508.  
  509. WHAT IS NEEDED?
  510.  
  511.     The A64 Package is a hardware and software combination.  The software, the
  512.     A64 program and its associated utilities, perform the actual Commodore 64
  513.     emulation and allow you to transfer data or programs from C64 drives to
  514.     Amiga drives and back again.  The hardware is an interface that plugs into
  515.     the parallel port of your Amiga 500 or 2000 and allows The A64 Package to
  516.     access Commodore 64 disk drives and printers.  A separate adapter cable is
  517.     needed for the A1000.  You already have the software and the hardware is
  518.     available from QuesTronix.  You DO NOT need the hardware to use A64, but
  519.     without it, its use is very limited.  You DO need the hardware to use most
  520.     of The A64 Packages' utility programs.
  521.  
  522.  
  523.  
  524.                                                                         1-1
  525.  
  526.  
  527.  
  528. -
  529.  
  530.  
  531.  
  532. WHAT DOES IT COST?
  533.  
  534.     The software portion of The A64 Package is licensed to you.  You are free
  535.     to use and distribute it as long as certain terms are agreed to (See
  536.     LICENSE AGREEMENT on page 1).  One of these terms is that QuesTronix is
  537.     charging a license fee for the use of The A64 Package.  This license fee is
  538.     $25.00 (plus $3.00 for shipping and handling of the hardware interface,
  539.     overseas orders please add an additional $2.00 for a total of $5.00 for
  540.     shipping and handling.  Connecticut residence please add 8% sales tax.
  541.     Paying this license fee makes you a registered owner of The A64 Package and
  542.     grants you certain rights and privileges.  Also, after receiving the
  543.     license fee, from you, QuesTronix will send you the hardware interface that
  544.     is used with most of the programs in The A64 Package.
  545.  
  546.     The adapter cable needed for the A1000 is available for an additional
  547.     $20.00.  Please add $3.00 for shipping and handling if you order the
  548.     adapter cable separately (overseas orders add $2.00 more for a total of
  549.     $5.00 for shipping and handling).
  550.  
  551.  
  552. HOW TO BECOME A REGISTERED OWNER
  553.  
  554.     Included with The A64 Package is the file "Registration.form".  This file
  555.     serves as a registration form for The A64 Package.  Please print this file
  556.     (See PrintFile in the UTILITIES section) and then fill it out and send it
  557.     with a check or money order, for the license fee, to:
  558.  
  559.                                   QuesTronix
  560.                                 P.O. Box 340285
  561.                             Hartford, CT 06134-0285
  562.  
  563.     Funds must be drawn on a US bank.  Please allow 4-6 weeks for personal
  564.     checks to clear.  Sorry no CODs or charge cards.
  565.  
  566.     Please take the time to fill out the registration form completely.  The
  567.     information you put on it will help us to put out better updates of The
  568.     A64 Package.  Users without printers can substitute the registration form
  569.     with a letter. 
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.                                                                         1-2
  591.  
  592.  
  593.  
  594. -
  595.  
  596.  
  597.  
  598. A NOTE FROM THE AUTHOR
  599.  
  600.     Those of you that have been around the Amiga community for a while know all
  601.     about C64 emulators and what a disappointment they have been.  I hope that
  602.     A64 is going to change that.  I decided to write A64 because I knew that a
  603.     C64 emulator could be faster and more compatible than the two commercially
  604.     available emulators.  Seeing how I was co-author of one of them (GO-64!),
  605.     I had a slight advantage in writing another emulator.  A64 V1.01n is the
  606.     second release in my attempt to write a better emulator and I see many
  607.     improvements and more features in the future.  Although I believe that The
  608.     A64 Package, in its current state, to be useful and in many ways superior
  609.     to the competitors packages, it still needs quite a bit of work to be the
  610.     best it can be.  Unfortunately writing a program as complex as a C64
  611.     emulator takes a great deal of time and for QuesTronix to continue
  612.     development of The A64 Package we need your support.  If you find The A64
  613.     Package useful and would like to see it improve, send in the license fee.
  614.     I believe that the license fee is minimal.  Where else can you find a
  615.     quality Amiga hardware/software product for $25.00?
  616.  
  617.                             Thanks in advance,
  618.                             Cliff Dugan
  619.  
  620.     P.S. I would like to say thank you to the people who have supported The A64
  621.          Package so far.  If the support continues it won't be long before the
  622.          next major revision is released.
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.                                                                         1-3
  657.  
  658.  
  659.  
  660. -
  661.  
  662.  
  663.  
  664. GETTING STARTED
  665.  
  666.     If you already have A64's hardware interface you should install it before
  667.     running A64 (See INSTALLING A64'S HARDWARE INTERFACE in the GETTING STARTED
  668.     section).
  669.  
  670.  
  671. RUNNING A64
  672.  
  673.     To run A64 you should have:
  674.  
  675.         1. A copy of WorkBench that can be to written to.  You can either use
  676.            the WorkBench that you usually use with your Amiga or make a copy of
  677.            it.  If you decide to use your normal WorkBench you should note that
  678.            a font will be added to it and it should have enough room on it to
  679.            store this font (less than 1%).  You should make sure that the
  680.            WorkBench disk contains the following directories and files:
  681.  
  682.            "C" directory containing the files "Execute, Assign, Path and Copy"
  683.            "Libs" directory containing the file "diskfont.lib"
  684.            "Fonts" directory
  685.  
  686.         2. A separate disk containing The A64 Package, which should be in the
  687.        directory named "TheA64Package."  Please note that A64 expects  
  688.            certain files to be in certain directories and if you have
  689.            downloaded The A64 Package from a BBS The A64 Packages' expected
  690.            file structure may not be intact (although it is NOT supposed to be
  691.            distributed in this manner).  Check THE A64 PACKAGES FILE STRUCTURE
  692.            in the TECHNICAL section to make sure your A64 disk is in order.
  693.  
  694.     Before you can run A64 you must install a font onto the WorkBench disk that
  695.     you will be using with The A64 Package.  This is easily done by using the
  696.     program "InstallA64Font" that is included with The A64 Package (See
  697.     InstallA64Font in the UTILITIES section).  The procedure for installing the
  698.     font, from the WorkBench, is as follows:
  699.  
  700.         1. Insert the disk containing The A64 Package into any drive.
  701.         2. Double-click The A64 Packages' disk icon. 
  702.         3. When the disk window appears double-click TheA64Package drawer icon.
  703.         4. When the drawer window appears you will see an icon that is named
  704.            "InstallA64Font," double-click this icon.
  705.         5. A window will appear asking you to enter the name of the drive
  706.            containing The A64 Package.  You should enter the name of drive and
  707.            press the RETURN key when you are done.  For example, if the drive
  708.            containing The A64 Package was drive 1 then you would enter: df1:
  709.            and then press return.
  710.         6. The A64 font will then be installed to your WorkBench fonts
  711.            directory.  If you have a single drive system just swap disks when
  712.            needed.
  713.  
  714.     To run InstallA64Font from the CLI, type the following:
  715.  
  716.         cd TheA64Package
  717.     run InstallA64Font
  718.  
  719.         You can now follow the procedure listed above, starting at step 5.
  720.  
  721.  
  722.                                                                         2-1
  723.  
  724.  
  725.  
  726. -
  727.  
  728.  
  729.  
  730.     The installation of the A64 Font only needs to be done once as long as you
  731.     always use the same WorkBench disk with A64.  If you change WorkBench disks
  732.     you will have to install the A64 Font on the new WorkBench disk.
  733.  
  734.     After installing the A64 Font you are now ready to run A64.  If you still
  735.     have TheA64Package drawer window open from installing the A64 Font you can
  736.     go directly to step 4.
  737.  
  738.         1. Insert the disk containing The A64 Package into any drive.
  739.         2. Double-click The A64 Packages' disk icon. 
  740.         3. When the disk window appears double-click TheA64Package drawer icon.
  741.         4. You will see an icon named "A64" that looks like an Amiga 2000,
  742.            double-click it.
  743.         5. You will then see A64's title screen.  There will be a brief pause
  744.            while A64 loads its files.  After it's done loading you will see a
  745.            message flashing on the lower left hand side of the screen saying
  746.            "PRESS A MOUSE BUTTON."  At this time you should do so.
  747.         6. You will then be shown A64's license agreement screen.  You should
  748.            read this entire screen before proceeding.  If you agree to the
  749.            terms listed on the screen you should press the left mouse button to
  750.            enter A64.  If you do not agree to the terms you should press the
  751.            right mouse button to quit A64.
  752.  
  753.     To run A64 from the CLI, type the following:
  754.  
  755.         cd TheA64Package
  756.     run A64
  757.  
  758.         Make sure you type run before A64 to take advantage of A64's
  759.         multitasking capabilities.  You can now follow the procedure for
  760.         running A64 starting at step 5.
  761.  
  762.     Assuming you agreed to the terms of the license agreement and pressed the
  763.     left mouse button, you will now be shown the A64 BASIC screen.  The A64
  764.     BASIC screen will differ from the C64 BASIC screen in two ways:
  765.  
  766.        1. The startup message will say "*** QUESTRONIX A64 BASIC V1 ***"
  767.           instead of "**** COMMODORE 64 BASIC V2 ****."  This is because the
  768.           Commodore 64 ROMs are not present in A64 (See ROMS in the TECHNICAL
  769.           section).
  770.        2. There will be no borders around the screen. (See BORDERS in the
  771.           GRAFIX MENU section).
  772.  
  773.     You have now turned your Amiga into a C64.  You can do almost everything in
  774.     A64 that you would do on a C64.  You can try all the BASIC commands or POKE
  775.     and PEEK around memory. It's all there.
  776.  
  777.     NOTE: While the A64's title screen is being displayed you can press the
  778.           TAB key to cycle the background.  Pressing it again will stop the
  779.           cycling.
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.                                                                         2-2
  789.  
  790.  
  791.  
  792. -
  793.  
  794.  
  795.  
  796. A64'S HARDWARE INTERFACE
  797.  
  798.     To fully utilize The A64 Package you need its hardware interface.  This
  799.     interface is a small hardware box that plugs into the parallel port of
  800.     your Amiga 500 or 2000.  A separate adapter cable is required for the Amiga
  801.     1000.  This interface allows you to connect your Commodore 64 disk drive
  802.     and printers to the Amiga in the same way you would connect them to your
  803.     C64.  It's this interface that allows you to load and save C64 programs
  804.     from C64 disk drives and transfer them to and from Amiga disks.  The
  805.     hardware interface is not absolutely required to use A64, but without it,
  806.     its use is very limited.  To get the interface you must become a registered
  807.     owner of The A64 Package (See HOW TO BECOME A REGISTERED OWNER in the
  808.     INTRODUCTION section).
  809.  
  810.  
  811. INSTALLING A64'S HARDWARE INTERFACE
  812.  
  813.     The hardware interface is a small box with two connectors on it.  The large
  814.     connector is the end that plugs into your Amiga and the small connector is
  815.     the end where you plug in your C64 disk drives and printers. 
  816.  
  817.     To install the hardware interface use the following procedure:
  818.  
  819.     1. Make sure your Amiga is turned off.  You should NEVER plug anything into
  820.        your Amiga while it's turned on, because damage to your Amiga could
  821.        result by doing so.
  822.     2. If you have the Amiga 500 or 2000 you may now plug the interface
  823.        directly into its parallel port.  If you have the Amiga 1000 you must
  824.        first plug the adapter cable into the parallel port and then connect the
  825.        interface to the cable.  Please note that this adapter cable is not a
  826.        simple gender changer and only a cable specifically made to connect
  827.        A500/A2000 devices to an A1000 parallel port should be used.
  828.     3. You are now ready to connect your C64 disk drives and printers to the
  829.        interface.  Make sure that each C64 device that you wish to connect has
  830.        its power turned off.  Using the serial cable that came with your disk
  831.        drive or printer,  plug one end of the cable into the interface and the
  832.        other into your C64 peripheral.  The C64 peripherals may now be "daisy
  833.        chained" in the same way as they would be on a C64, by plugging each new
  834.        device into the back of each previous device.  After all C64 devices are
  835.        connected you can then turn them on.  A64 will support up to four
  836.        different C64 disk drives and two separate C64 printers, simultaneously.
  837.     4. You may now turn on your Amiga and boot it up as you normally would.
  838.  
  839.     The hardware interface can stay plugged in at all times without interfering
  840.     with any programs on your Amiga, as long as they do not use the parallel
  841.     port.  If you want to use your parallel port with some other piece of
  842.     hardware, like a printer or digitizer, you must remove the hardware
  843.     interface and install the other device as you normally would.  You can also
  844.     use an A-B switch and just switch between devices.  Please note that A64
  845.     takes over the parallel port and for the parallel port to be used by other
  846.     devices while A64 is running certain procedures must by followed (See PAR
  847.     PORT in the SYSTEM MENU section).
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.                                                                         2-3
  855.  
  856.  
  857.  
  858. -
  859.  
  860.  
  861.  
  862. INSTALLING THE A64 PACKAGE ON ANOTHER DISK OR HARD DISK
  863.  
  864.     To install The A64 Package on another floppy disk or hard disk all you need
  865.     to do is copy TheA64Package directory (drawer) to the disk you want to
  866.     install it on.  The way to do this is as follows:
  867.  
  868.     From the WorkBench:
  869.  
  870.        drag the TheA64Package drawer to the destination disk.
  871.  
  872.     From the CLI type:
  873.  
  874.        makedir <destination disk>TheA64Package
  875.        copy <source disk>TheA64Package <destination disk>TheA64Package all
  876.        copy <source disk>TheA64Package.info <destination disk>
  877.  
  878.     <source disk> is the disk containing TheA64Package directory and
  879.     <destination disk> is the disk you want to install The A64 Package on.
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.                                                                         2-4
  921.  
  922.  
  923.  
  924. -
  925.  
  926.  
  927.  
  928. A64 PREFS
  929.  
  930.     A64 Prefs utilizes an Intuition user interface with menus, requesters and
  931.     gadgets.  This manual assumes that you are familiar with using this type of
  932.     user interface and the terms used to describe it.  If you are not familiar
  933.     with them please consult your Amiga user's manual.
  934.  
  935.     A64 is the Amiga's first truly multitasking Commodore 64 emulator and A64
  936.     Prefs is your bridge, from A64, to the multitasking environment.  A64 Prefs
  937.     allows A64 to have features you've come to expect from Amiga programs, like
  938.     an Intuition user interface with menus and requesters.  A64 Prefs allows
  939.     you to change the way A64 is configured to run C64 programs, access tools
  940.     included with The A64 Package and, most importantly, it allows you to stop
  941.     any C64 program that A64 is currently running and return to the WorkBench,
  942.     after which you can use A64 Prefs and re-enter the C64 program and pick up
  943.     EXACTLY where you left off.  A64 Prefs gives A64 the power and flexibility
  944.     that, until now, no C64 emulator has had.
  945.  
  946.     To gain access to A64 Prefs from A64 press the [LEFT ALT] key and the
  947.     [RIGHT ALT] key simultaneously.  After doing so a title bar will appear on
  948.     the C64 program that is currently running.  At this point you can get back
  949.     to the Workbench or CLI by dragging the screen down or by depth arranging
  950.     the A64 Prefs screen by using the front-back gadgets.  To get back to A64
  951.     Prefs you do the same thing, drag or depth arrange any other screen that
  952.     may visible.  You can also use the following key sequences to depth arrange
  953.     the A64 Prefs screen with the Workbench screen:
  954.  
  955.     [LEFT AMIGA] [M]: Send Workbench to back, A64 Prefs to front
  956.     [LEFT AMIGA] [N]: Send Workbench to front, A64 Prefs to back
  957.  
  958.  
  959. A64 PREFS SETTINGS AND CONFIGURATION FILES
  960.  
  961.     A64 Prefs effects the operation of A64 much like the WorkBench Preferences
  962.     program effects the operation of the Amiga.  By changing A64 Prefs'
  963.     settings you can force A64 to change its performance or appearance, in the
  964.     way that it runs a C64 program.  All of A64 Prefs' settings are accessed
  965.     with menus and requesters.  When you change one or more of these settings
  966.     they become the current settings, meaning they will take effect immediately
  967.     or when A64 is re-entered.  These settings will stay in effect until you
  968.     change them again or until you quit A64.  You can also save all of A64
  969.     Prefs' settings in what is called a "configuration file."  Unlike the
  970.     WorkBench Preferences program, A64 Prefs allows you to create as many
  971.     different configuration files as you like and name them what ever you
  972.     choose.
  973.  
  974.     The procedure for changing A64 Prefs' settings and loading and saving
  975.     configuration files is detailed in THE MENUS section.
  976.  
  977.     NOTE: A64 has a default configuration file.  This file is named
  978.           "A64.config" and it is loaded anytime you run A64.  It contains all
  979.           of A64's initial settings, which are shown by A64Prefs' menus and
  980.           requesters.  By changing any one or more of A64 Prefs' settings and
  981.           saving them with the name "A64.config" will force A64 to use your new
  982.           settings as its initial settings.
  983.  
  984.  
  985.  
  986.                                                                         3-1
  987.  
  988.  
  989.  
  990. -
  991.  
  992.  
  993.  
  994. THE MENUS
  995.  
  996.     A64 Prefs is broken up into several menus.  Each having its own function
  997.     and options.  All of A64 Prefs settings and features are accessed with
  998.     these menus.  Each menu and its options are described in the following
  999.     sections.
  1000.  
  1001.  
  1002. THE PROJECT MENU
  1003.  
  1004.  
  1005. RESET A64
  1006.  
  1007.     KEY SEQUENCE: [LEFT AMIGA] [N] (New)
  1008.  
  1009.     The RESET A64 menu option allows you to reset A64 back to its initial
  1010.     state.  If selected, this option will terminate the program that A64 is
  1011.     currently running and return A64 to the BASIC startup screen.  Essentially,
  1012.     this is the same thing as turning a Commodore 64 off and then on again.
  1013.  
  1014.     When selecting RESET A64 you will be prompted with a requester asking you
  1015.     "Are sure you want to reset A64?".  Select one of the requester's gadgets
  1016.     to answer the question:
  1017.  
  1018.         YES, Reset A64.
  1019.  
  1020.         NO, Abort the procedure.
  1021.  
  1022.     NOTES: RESET A64 is non-destructive.  Any programs that were in memory
  1023.            before the reset will still be there after the reset.
  1024.  
  1025.            RESET A64 does not reset any devices connected with A64's hardware
  1026.            interface (i.e., C64 disk drives and printers).  If you were using
  1027.            a program that used copy protection and/or sent commands to the
  1028.            devices you may have to reset them by turning them off and then on
  1029.            again.
  1030.  
  1031.  
  1032. LOAD CONFIG
  1033.  
  1034.     KEY SEQUENCE: [LEFT AMIGA] [L] (Load)
  1035.  
  1036.     The LOAD CONFIG menu option allows you to load a previously saved
  1037.     configuration file.  If selected, this option will load the requested
  1038.     configuration file and the newly loaded settings will become A64 Prefs'
  1039.     current settings.
  1040.  
  1041.     When selecting LOAD CONFIG you will be prompted with a requester asking
  1042.     you to enter the name of the configuration file you wish to load.  Use the
  1043.     requester's string gadget to enter the name and then press the RETURN key
  1044.     to load the file.  You can also use the requester's other gadgets to
  1045.     select the following:
  1046.  
  1047.         OK, Load the configuration file (pressing RETURN does the same).
  1048.  
  1049.         CANCEL, Abort the procedure.
  1050.  
  1051.  
  1052.                                                                         3-2
  1053.  
  1054.  
  1055.  
  1056. -
  1057.  
  1058.  
  1059.  
  1060.     NOTE: The filename can contain any legal AmigaDOS path name, limited to 31
  1061.           characters in length.
  1062.  
  1063.     SEE:  A64 PREFS SETTINGS AND CONFIGURATION FILES and SAVE CONFIG in the
  1064.           A64 PREFS section.
  1065.  
  1066.  
  1067. SAVE CONFIG
  1068.  
  1069.     KEY SEQUENCE: [LEFT AMIGA] [S] (Save)
  1070.  
  1071.     The SAVE CONFIG menu option allows you to save the current A64 Prefs'
  1072.     settings.  If selected, this option will save all of A64 Prefs' current
  1073.     settings in the configuration file that you specified, to be loaded at a
  1074.     later time.
  1075.  
  1076.     When selecting SAVE CONFIG you will be prompted with a requester asking
  1077.     you to enter the name of the configuration file you wish to save A64
  1078.     Prefs' current settings to.  Use the requester's string gadget to enter the
  1079.     name and then press the RETURN key to save the file.  You can also use the
  1080.     requester's other gadgets to select the following:
  1081.  
  1082.         OK, Save the configuration file (pressing RETURN does the same).
  1083.  
  1084.         CANCEL, Abort the procedure.
  1085.  
  1086.     NOTES: The filename can contain any legal AmigaDOS path name, limited to 31
  1087.            characters in length.
  1088.  
  1089.            You can change the default A64 Prefs' settings, the settings used
  1090.            when A64 is first loaded, by saving the current settings with the
  1091.            name "A64.config".  This configuration file is always loaded
  1092.            whenever you run A64.
  1093.  
  1094.     SEE:   A64 PREFS SETTINGS AND CONFIGURATION FILES and LOAD CONFIG and
  1095.            NAMING CONFIGURATION FILES in the A64 PREFS section.
  1096.  
  1097.  
  1098. NAMING CONFIGURATION FILES
  1099.  
  1100.     It is a good practice to end your configuration files with the file
  1101.     extension ".config".  This will help you to remember what you named your
  1102.     configuration files.  For example, if you saved a configuration file for
  1103.     the C64 program "PrintShop" and you named it "PrintShop.config" then when
  1104.     loading the file at a future time you would have no problem remembering
  1105.     what you named it.
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.                                                                         3-3
  1119.  
  1120.  
  1121.  
  1122. -
  1123.  
  1124.  
  1125.  
  1126. RESET CONFIG
  1127.  
  1128.     KEY SEQUENCE: [LEFT AMIGA] [R] (Reset config)
  1129.  
  1130.     The RESET CONFIG menu option allows you to reset A64 Prefs' current
  1131.     settings to their default states.  If selected, this option will reset all
  1132.     of A64 Prefs' settings to their original settings.
  1133.  
  1134.     When selecting RESET CONFIG you will be prompted with a requester asking
  1135.     you "Are sure you want to reset config?".  Select one of the requester's
  1136.     gadgets to answer the question:
  1137.  
  1138.         YES, Reset the configuration settings.
  1139.  
  1140.         NO, Abort the procedure.
  1141.  
  1142.     NOTE: The default settings set by RESET CONFIG are not necessarily the ones
  1143.           currently saved in the default configuration file "A64.config".  If
  1144.           you have changed this file and you want to reset it to the default
  1145.           settings you must save them with the name "A64.config".
  1146.  
  1147.     SEE:  A64 PREFS SETTINGS AND CONFIGURATION FILES and SAVE CONFIG in the
  1148.           A64 PREFS section.
  1149.  
  1150.  
  1151. ABOUT A64
  1152.  
  1153.     KEY SEQUENCE: [LEFT AMIGA] [A] (About)
  1154.  
  1155.     The ABOUT A64 menu option allows you to read some information about A64.
  1156.  
  1157.     When selecting ABOUT A64 you will be shown a screen with a cycling blue
  1158.     background.  On the screen will be a requester with some information about
  1159.     A64.  After you have read the information you can select the requester's
  1160.     OK gadget to return to A64 Prefs.
  1161.  
  1162.     NOTE: The TAB key will NOT toggle the cycling background on and off as it
  1163.           will with the title screen.
  1164.  
  1165.     IMPORTANT NOTE: See SCREEN SHIFTED BUG in KNOWN BUGS section!
  1166.  
  1167.  
  1168. QUIT A64
  1169.  
  1170.     KEY SEQUENCE: [LEFT AMIGA] [Q] (Quit)
  1171.  
  1172.     The QUIT A64 menu option allows you to quit A64.  If selected, this option
  1173.     will terminate A64 for good and return you to the WorkBench.
  1174.  
  1175.     When selecting QUIT A64 you will be prompted with a requester asking you
  1176.     "Are sure you want to quit A64?".  Select one of the requester's gadgets
  1177.     to answer the question:
  1178.  
  1179.         YES, Quit A64.
  1180.  
  1181.         NO, Abort the procedure.
  1182.  
  1183.  
  1184.                                                                         3-4
  1185.  
  1186.  
  1187.  
  1188. -
  1189.  
  1190.  
  1191.  
  1192. EXIT PREFS
  1193.  
  1194.     KEY SEQUENCE: [LEFT AMIGA] [X] (eXit)
  1195.  
  1196.     The EXIT PREFS menu option will allow you to exit A64 Prefs and return to
  1197.     A64.  If selected, this option will close A64 Prefs and return you to A64
  1198.     at the exact point where you left it.
  1199.  
  1200.     When selecting EXIT PREFS you will be prompted with a requester asking you
  1201.     "Are sure you want to exit prefs?".  Select one of the requester's gadgets
  1202.     to answer the question:
  1203.  
  1204.         YES, Exit A64 Prefs and return to A64.
  1205.  
  1206.         NO, Abort the procedure.
  1207.  
  1208.     NOTE: You can get back to A64 Prefs by pressing the [LEFT ALT] key and the
  1209.           [RIGHT ALT] key simultaneously.
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.                                                                         3-5
  1251.  
  1252.  
  1253.  
  1254. -
  1255.  
  1256.  
  1257.  
  1258. THE SYSTEM MENU
  1259.  
  1260.  
  1261. PAR PORT
  1262.  
  1263. KEY SEQUENCE: None
  1264.  
  1265.     The PAR PORT menu option allows you to toggle ownership of the Amiga's
  1266.     parallel port between A64 and other Amiga programs.  Because A64 takes over
  1267.     the Amiga's parallel port for its hardware interface, it can only be used
  1268.     by either A64 or other Amiga programs at any one time.
  1269.  
  1270.     The PAR PORT menu option has two settings: AMIGA and A64. You can select
  1271.     one or the other of these settings and selecting one automatically
  1272.     unselects the other.  The current selected setting is shown by displaying
  1273.     a checkmark next to it.  To use A64's hardware interface, A64 must own the
  1274.     parallel port and the A64 setting must be selected.  If you want to use
  1275.     some other program, while A64 is running, that needs the parallel port for
  1276.     some other piece of hardware (i.e., parallel printers or digitizers) then
  1277.     the Amiga must own the parallel port and the AMIGA setting must be
  1278.     selected.
  1279.  
  1280.     NOTES: The A64 setting should only be selected when the A64 program itself
  1281.            needs the parallel port.  If you want to use the utility programs
  1282.            included with The A64 Package, that also need A64's hardware
  1283.            interface (i.e., 64Dir, 64ToAmiga, AmigaTo64, etc.), the AMIGA
  1284.            setting must be selected.
  1285.  
  1286.     IMPORTANT NOTE: See PAR PORT BUG in the KNOWN BUGS section!
  1287.  
  1288.  
  1289. SER PORT
  1290.  
  1291.     KEY SEQUENCE: None
  1292.  
  1293.     The SER PORT menu option allows you to toggle ownership of the Amiga's
  1294.     serial port between A64 and other Amiga programs.  Because A64 takes over
  1295.     the Amiga's serial port for using modems, it can only be used by either
  1296.     A64 or other Amiga programs at any one time.
  1297.  
  1298.     The SER PORT menu option has two settings: AMIGA and A64. You can select
  1299.     one or the other of these settings and selecting one automatically
  1300.     unselects the other.  The current selected setting is shown by displaying
  1301.     a checkmark next to it.  To use modems with A64, A64 must own the serial
  1302.     port and the A64 setting must be selected.  If you want to use some other
  1303.     program, while A64 is running, that needs the serial port for some other
  1304.     piece of hardware (i.e., serial printers or modems with Amiga programs)
  1305.     then the Amiga must own the serial port and the AMIGA setting must be
  1306.     selected.
  1307.  
  1308.     NOTE: You should not change the SER PORT setting to AMIGA while A64 is
  1309.           running a C64 telecommunications program.  This could cause the C64
  1310.           program to lose data and possibly crash, forcing you to reset A64.
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.                                                                         3-6
  1317.  
  1318.  
  1319.  
  1320. -
  1321.  
  1322.  
  1323.  
  1324. MODEMS
  1325.  
  1326.     A64 supports Amiga modems.  To use an Amiga modem with A64 you must make
  1327.     sure the SER PORT menu item is set to A64 (See SER PORT in the SYSTEM MENU
  1328.     section).  You do not have to set BAUD, PARITY or other telecommunications
  1329.     parameters with either A64 Prefs or the WorkBench Preferences program. The
  1330.     C64 program that A64 is running will set these parameters.  A64 does not
  1331.     support BAUD rates of 50 and 75 which are available on the C64, but it does
  1332.     support all common BAUD rates from 110 to 19200. 
  1333.  
  1334.    NOTE: A64's modem support is still in development and C64 telecommunications
  1335.          programs may or may not fully work.  For the best results with A64
  1336.          V1.01n try to use C64 programs that use the following settings: NO
  1337.          PARITY, 300 or 1200 BAUD, 1 STOP BIT, 8 DATA BITS and 3-LINE protocol.
  1338.          Modem support will be fully implemented by the next version of A64.
  1339.  
  1340.  
  1341. GAME PORTS (JOYSTICKS)
  1342.  
  1343.     KEY SEQUENCE: [LEFT AMIGA] [G] (Game port)
  1344.  
  1345.     The GAME PORTS menu option allows you to tell A64 what kind of input
  1346.     devices are connected to the Amiga's game ports (Game ports are the ports
  1347.     that you plug your Amiga mouse and joysticks into).
  1348.  
  1349.     In the following explanation of the GAME PORTS menu option, reference is
  1350.     made to each port in the following manner: port 1 means the port that your
  1351.     Amiga's mouse is normally plugged into and port 2 means the other port.  By
  1352.     default, port 1 on the Amiga corresponds to port 1 on the C64 and port 2 on
  1353.     the Amiga corresponds to port 2 on the C64.
  1354.  
  1355.     When selecting GAME PORTS, you will be prompted with a requester containing
  1356.     several gadgets. The function of each gadget is as follows:
  1357.  
  1358. SWAP PORTS GADGET 
  1359.  
  1360.     Selecting SWAP PORTS will toggle the game ports on the Amiga.  This is
  1361.     shown by toggling the gadget between YES and NO.  The meaning of both are
  1362.     as follows:
  1363.  
  1364.         NO, The Amiga's game ports act as normal. Port 1 on the Amiga
  1365.         corresponds to port 1 on the C64 and port 2 on the Amiga corresponds to
  1366.         port 2 on the C64.
  1367.  
  1368.         YES, The Amiga's game ports are swapped.  Port 1 on the Amiga will
  1369.         become port 2 on the C64 and port 2 on the Amiga will become port 1 on
  1370.         the C64.  This swapping of the ports is in reference to the actual
  1371.         game ports on the Amiga and not the PORT 1 and PORT 2 gadgets described
  1372.         below.
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.                                                                         3-7
  1383.  
  1384.  
  1385.  
  1386. -
  1387.  
  1388.  
  1389.  
  1390.    For example, you are using a C64 program that requires a joystick in port 1.
  1391.    Instead of unplugging your Amiga's mouse from port 1 you can plug the
  1392.    joystick into port 2 and select YES as the SWAP PORTS setting.  Now A64 will
  1393.    read the joystick as if it was plugged into port 1.  Please note that you
  1394.    must still set the PORT 1 gadget to JOYSTICKS as described below.  Also note
  1395.    that SWAP PORTS only effects how A64 reads the game ports and not how the
  1396.    Amiga and WorkBench read them.  With proper use, SWAP PORTS will allow you
  1397.    to use almost any C64 program and not have to unplug your Amiga's mouse,
  1398.    unless of course both game ports are required by the C64 program.
  1399.  
  1400. PORT 1 AND PORT 2 GADGETS
  1401.  
  1402.     Selecting PORT 1 or PORT 2 will allow you to change the input device for
  1403.     the corresponding C64 game port.  This is displayed by changing the name of
  1404.     the input device for the corresponding port.  Both of these gadgets work in
  1405.     the same way, except that PORT 1 corresponds to the C64's port 1 and PORT 2
  1406.     corresponds to the C64's port 2.  These gadgets ALWAYS correspond to the
  1407.     C64's game ports and not the Amiga's, regardless of the status of the SWAP
  1408.     PORTS gadget described above.  That means if a C64 program requires a
  1409.     joystick in port 1 you MUST set the PORT 1 gadget to JOYSTICKS.  Currently
  1410.     there are only two supported settings for these gadgets:
  1411.  
  1412.     JOYSTICKS: Selects joysticks for the corresponding C64 port.
  1413.  
  1414.     NO DEVICE: Acts as if there is no device connected regardless of what is
  1415.                actually plugged in.
  1416.  
  1417. OK GADGET
  1418.  
  1419.     Selecting OK will preserve all changes to the GAME PORTS settings.  They
  1420.     will become the current GAME PORTS settings and be active as soon as A64 is
  1421.     re-entered.
  1422.  
  1423. CANCEL GADGET
  1424.  
  1425.     Selecting CANCEL will ignore all changes to the GAME PORTS settings and
  1426.     abort the procedure.
  1427.  
  1428.     NOTES: While the PORT 1 gadget is set to JOYSTICKS and SWAP PORTS is set to
  1429.            NO the Amiga's mouse will interfere with the keyboard and characters
  1430.            will appear on the screen when the mouse is moved.  This is normal.
  1431.            The same thing will happen if you plug an Amiga mouse into port 1 of
  1432.            the C64.  This problem can be avoided by setting SWAP PORTS to YES
  1433.            or setting the PORT 1 gadget to NO DEVICE.  Also note, because of
  1434.            the way the SWAP PORTS gadget works this problem can also be created
  1435.            with the Amiga's game port 2.
  1436.  
  1437.            More input devices will be supported in future versions of A64.
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.                                                                         3-8
  1449.  
  1450.  
  1451.  
  1452. -
  1453.  
  1454.  
  1455.  
  1456. DRIVES
  1457.  
  1458.     KEY SEQUENCE: [LEFT AMIGA] [D] (Drives)
  1459.  
  1460.     The DRIVES menu option allows you to assign a type of disk drive to a drive
  1461.     number.  The Commodore 64 allows you to connect up to four disk drives to
  1462.     it.  A64 is no different in that it also allows you to utilize up to four
  1463.     drives, but unlike the C64, A64 allows you to use not only C64 drives, but
  1464.     you can also use Amiga drives.  The C64 uses drive numbers to access its
  1465.     drives.  Numbered 8-11.  A64 uses these same drive numbers and the DRIVES
  1466.     option allows you to assign a type of drive to them.
  1467.  
  1468.     When selecting DRIVES you will be prompted with a requester. On this
  1469.     requester you will see the numbers 8-11 on the left hand side of it.  These
  1470.     numbers correspond to the C64's drive numbers mentioned above.  To the
  1471.     right of each of these numbers are two gadgets.  The 1st gadget (going left
  1472.     to right) allows you to toggle between a C64 drive or an Amiga drive for
  1473.     that particular drive number.  This is displayed by showing the word C64 or
  1474.     AMIGA.  If you want to assign a C64 drive to a drive number you set this
  1475.     gadget to C64 and if you want to assign an Amiga drive to a drive number
  1476.     you set this gadget to AMIGA.  The second gadget is a string gadget and is
  1477.     only used when you the first gadget is set to AMIGA.  If you set the first
  1478.     gadget to C64 then this gadget will be disabled.  The purpose of the second
  1479.     gadget is to tell A64 what Amiga device you want to assign to a drive
  1480.     number.  This is done by typing in the device name that you want to assign
  1481.     to a drive number.  This name can be any Amiga drive or any valid AmigaDOS
  1482.     path name.  Some valid device names are: df0:, df1:, dh0:, and RAM:.  You
  1483.     can also use volume names like WorkBench 1.3: or directory names like
  1484.     df0:TheA64Package/64Prgs.
  1485.  
  1486.     For example, you want to load the C64 program named "64Colors" and this
  1487.     program is located on the The A64 Package disk in the 64Prgs directory,
  1488.     which itself is in the directory TheA64Package.  With the A64 disk in df0:
  1489.     you would do the following:
  1490.  
  1491.         1. Select the DRIVES menu option with either the mouse or key sequence.
  1492.         2. When the requester appears change drive 8 to AMIGA.  This is done by
  1493.            clicking on the first gadget (going left to right) next to the
  1494.            number 8.
  1495.         3. The string gadget will then become enabled.  Select the string
  1496.            gadget and type in the following:
  1497.  
  1498.                df0:The64Package/64Prgs [RETURN]
  1499.  
  1500.          4. Select the OK gadget so your changes will be preserved.
  1501.          5. Exit A64 Prefs using the EXIT PREFS menu item in the PROJECT menu.
  1502.          6. When you are back in A64 type in the following:
  1503.  
  1504.                 LOAD"64COLORS",8 [RETURN]
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.                                                                         3-9
  1515.  
  1516.  
  1517.  
  1518. -
  1519.  
  1520.  
  1521.  
  1522.     A64 will then load the program from the path you assigned to drive 8,
  1523.     "df0:The64Package/64Prgs."  You can now RUN the program as if were loaded
  1524.     from a C64 drive.  Now whenever you perform an action involving drive 8,
  1525.     A64 will act as if "df0:The64Package/64Prgs" is drive 8. Please note that
  1526.     you could also have assigned drive 8 to just df0: and typed the following
  1527.     when you re-entered A64:
  1528.  
  1529.                 LOAD"THEA64PACKAGE/64PRGS/64COLORS",8 [RETURN]
  1530.  
  1531.     The remaining two gadgets are as follows:
  1532.  
  1533.         OK will preserve all changes to the DRIVES settings. They will become
  1534.         the current DRIVES settings and be active as soon as A64 is re-entered.
  1535.  
  1536.         CANCEL will ignore all changes to the DRIVES settings and abort the
  1537.         procedure.
  1538.  
  1539.  
  1540. AMIGA DRIVES
  1541.  
  1542.     A64 supports Amiga drives for the loading and saving of programs and data
  1543.     to and from A64.  These drives can be floppy drives, hard drives and RAM
  1544.     drives.  But before you attempt to use any of these with A64 you must
  1545.     understand an important fact about using them.  They are not as compatible
  1546.     as using a C64 drive with A64 and their use is limited.  The reason for
  1547.     this is that C64 disk drives are what is referred to as "intelligent
  1548.     devices."  This means that C64 drives have ROM and RAM (memory) giving them
  1549.     the ability to run programs just like the C64 does.  Basically they are
  1550.     computers!  The C64 can transfer a program or send a command to the C64
  1551.     disk drive telling it to perform some internal action.  This action happens
  1552.     totally independent of the C64.  This ability is used for everything from
  1553.     reading drive errors to copy protection and FAST LOADERS.  Amiga drives on
  1554.     the other hand are not "intelligent devices."  They have no RAM or ROM and
  1555.     basically rely on the Amiga to perform all actions.  Because of this fact,
  1556.     Amiga drives will not work with most C64 copy protection and will not
  1557.     support any kind of communications meant for a C64 drive besides the simple
  1558.     reading and writing of programs and data.  If you try to perform some
  1559.     action with an Amiga drive that it can not handle an error requester will
  1560.     appear (See A64 ERRORS in the PROBLEMS AND SOLUTIONS section).  You can
  1561.     avoid these incompatibilities by using C64 disk drives whenever possible.
  1562.     A64 supports all communications with C64 disk drives and when using them
  1563.     these incompatibilities do not exist.
  1564.  
  1565.     NOTES: You can not do a directory of an Amiga disk from within A64. You
  1566.            must exit A64 to A64 Prefs and use the CLI to get the directory.
  1567.  
  1568.            Amiga drives will support reading and writing of the file types:
  1569.            PRG, SEQ and USR.  Relative (REL) files are not supported.  Please
  1570.            note that file types are not saved with the file on Amiga drives,
  1571.            but the file formats are identical to the C64's (PRG files include
  1572.            load address, SEQ and USR do not).
  1573.  
  1574.            In A64 V1.01n LOADING (reading) from Amiga drives is slow, even from
  1575.            RAM disks.  We do expect to dramatically increase the speed of LOADs
  1576.            in the future.
  1577.  
  1578.  
  1579.  
  1580.                                                                         3-10
  1581.  
  1582.  
  1583.  
  1584. -
  1585.  
  1586.  
  1587.  
  1588. THE GRAFIX MENU
  1589.  
  1590.  
  1591. COLORS
  1592.  
  1593.     KEY SEQUENCE: [LEFT AMIGA] [C] (Colors)
  1594.  
  1595.     The COLORS menu option allows you change A64's colors and the number of
  1596.     colors A64 uses to draw the C64's display.
  1597.  
  1598.     Before explaining the COLORS option we must first explain a little bit
  1599.     about the Commodore 64's colors and how it uses them.  The Commodore 64 is
  1600.     capable of displaying a maximum of 16 colors at any one time.  On the C64
  1601.     you are not able to change its colors, they are always displayed the same
  1602.     (Until now!).  The C64 uses numbers to signify its colors.  Seeing how
  1603.     there are 16 colors and computers start counting at 0, these color numbers
  1604.     range from 0 to 15.  The C64's color numbers and there corresponding colors
  1605.     are as follows:
  1606.  
  1607.     0 = BLACK    4 = PURPLE     8 = ORANGE    12 = MED GRAY
  1608.     1 = WHITE    5 = GREEN     9 = BROWN    13 = LGT GREEN
  1609.     2 = RED        6 = BLUE    10 = LGT RED    14 = LGT BLUE
  1610.     3 = CYAN    7 = YELLOW    11 = DARK GRAY    15 = LGT GRAY
  1611.  
  1612.     When selecting COLORS a screen will open at the bottom of the A64 Prefs
  1613.     screen.  This screen has many gadgets that allow you to control A64's
  1614.     colors.  The color screen's gadgets will be explained by separating them
  1615.     into sections.  Please note that most of the color screen's gadgets
  1616.     interact with each other.  If you change the setting of one gadget it will
  1617.     probably change the setting of one or more other gadgets, because of this
  1618.     we suggest that you read this section of the manual in order, without
  1619.     jumping from section to section.  The color screen's gadgets and their
  1620.     functions are as follows:
  1621.  
  1622. COLOR GADGETS
  1623.  
  1624.     The COLOR GADGETS are the 20 small gadgets that start at the top, left hand
  1625.     side of the screen. These gadgets represent A64's current color palette,
  1626.     with each gadget containing one of A64's colors.  These COLOR GADGETS allow
  1627.     you to select a color that you want to change.  The current selected gadget
  1628.     will be displayed with a red square around it.  You will note that there
  1629.     are 20 gadgets, while the C64 only has 16 colors.  This is because A64
  1630.     needs other colors, in addition to the C64's 16 colors, for some of it's
  1631.     COLOR MODES (COLOR MODES are discussed in the following sections).  To
  1632.     explain this we need to define what C64 colors are represented by each
  1633.     COLOR GADGET.  Going left to right, the first COLOR GADGET represents the
  1634.     C64's current background color.  The background color is the color of the
  1635.     screen that doesn't contains any graphics data, the transparent part of the
  1636.     screen.  For those of you that know a little about the C64's graphics, the
  1637.     background color is stored in the C64's color register at 53281.  The
  1638.     actual color this gadget contains depends on what COLOR MODE you are using.
  1639.     If you are using 16 or 20 COLOR MODE, this gadget will contain a mirror
  1640.     image of one of the C64's 16 colors (it will contain the same color as one
  1641.     of the other gadgets).  If you are using one of the other COLOR MODES: 2,
  1642.     4, or 8, then it will contain it's own independent color.  The next 16
  1643.     gadgets represent the C64's 16 colors, with the first gadget representing
  1644.     the C64's color 0 and the last gadget, of the 16, representing the C64's
  1645.  
  1646.                                                                         3-11
  1647.  
  1648.  
  1649.  
  1650. -
  1651.  
  1652.  
  1653.  
  1654.     color 15. The last three color gadgets are only used for A64's 20 COLOR
  1655.     MODE.  They represent three of the C64's color registers that are used for
  1656.     two of it's graphics modes.  For the people who know a little bit about the
  1657.     C64's graphics, the C64 color registers are at 53282-53284 and are used for
  1658.     multicolor text and extended background color text modes.  These three
  1659.     gadgets are like the background color gadget and will contain a mirror
  1660.     image of one of the C64's 16 colors.
  1661.  
  1662.     NOTES: The four gadgets described above, the background color gadget and
  1663.            the three gadgets used by 20 COLOR MODE, are different from the
  1664.            other 16 COLOR GADGETS.  While the other 16 COLOR GADGETS represent
  1665.            actual C64 colors that the C64 can not change, these four gadgets
  1666.            represent color registers within the C64 that can be changed to any
  1667.            one of its 16 colors.  Seeing how the C64 can change the color in
  1668.            these registers, thus changing the color in the gadgets that
  1669.            represent them, any changes you make to these gadgets will be
  1670.            temporary.  If you want to change one of these four gadgets and have
  1671.            its color preserved when A64 is re-entered you must find the other
  1672.            gadget (in the other 16 gadgets) that contains the same color as the
  1673.            gadget you want to change and then modify that gadget to the color
  1674.            you want.  For example, using the default C64 colors, the background
  1675.            color gadget will contain the color blue and will be a mirror image
  1676.            of the seventh COLOR GADGET, which will also contain the color blue.
  1677.            If you change the color of the seventh COLOR GADGET to white and
  1678.            then re-enter A64, the background color will be changed to white,
  1679.            the color you selected in the seventh COLOR GADGET.  If you had only
  1680.            changed the color in the background color gadget and re-entered A64
  1681.            the background color would be changed back to blue, the color in the
  1682.            seventh COLOR GADGET.
  1683.       
  1684.            When selecting a COLOR MODE of less than 20, all unused COLOR
  1685.            GADGETS will be disabled.
  1686.  
  1687. SLIDER GADGETS
  1688.  
  1689.     The SLIDER GADGETS are the three long, multicolored gadgets located below
  1690.     the COLOR GADGETS.  These gadgets are used to change A64's colors.  More
  1691.     specifically, they allow you to change the color contained in the selected
  1692.     COLOR GADGET.  On the Amiga, colors are formed by adding a combination of
  1693.     RED, GREEN and BLUE color parts.  These SLIDER GADGETS represent these
  1694.     three color parts with; RED on top, GREEN in the middle and BLUE on the
  1695.     bottom.  Each one of these gadgets contain 16 different colors.  By
  1696.     selecting one of these colors you will change the selected COLOR GADGET to
  1697.     that color.  You will note that every time you select a color that all the
  1698.     colors in the SLIDER GADGETS will change, this is to show what new colors
  1699.     are available within a certain range from the color you just selected.  All
  1700.     of the Amiga's 4096 possible colors can be achieved by changing the
  1701.     settings of these three gadgets.
  1702.  
  1703. COLOR MODE GADGET
  1704.  
  1705.     The COLOR MODE gadget is the located at the top, right hand side of the
  1706.     color screen.  It is shown by the words "COLOR MODE:" followed by a gadget
  1707.     containing a number.  This gadget allows you to pick how many colors A64
  1708.     will use to draw the C64 display.  The possible settings are: 2, 4, 8, 16
  1709.     and 20.  Each setting corresponds to the number of colors that A64 will
  1710.     use.  These color modes also relate to how many bitplanes are used to make
  1711.  
  1712.                                                                         3-12
  1713.  
  1714.  
  1715.  
  1716. -
  1717.  
  1718.  
  1719.  
  1720.     the C64 display.  The Amiga uses bitplanes to make up its screens (You do
  1721.     not need to fully understand bitplanes to grasp this example, but what you
  1722.     should understand is that the more bitplanes that are used, the more colors
  1723.     that can be displayed at one time and the more work A64 has to do to
  1724.     display them.  By lowering the number of bitplanes, we lower the number of
  1725.     available color, but also decrease the amount of work A64 has to do to draw
  1726.     the screen, resulting in A64 running faster). The following chart shows you
  1727.     how many colors the Amiga is capable of displaying for a certain number of
  1728.     bitplanes and how many colors A64 will display for the same number of
  1729.     bitplanes:
  1730.  
  1731.     NUMBER OF    NUMBER OF    NUMBER OF
  1732.     BITPLANES    AMIGA COLORS    A64 COLORS
  1733.     ---------    ------------    ----------
  1734.             1              2             2
  1735.             2              4             4
  1736.             3              8             8
  1737.             4             16             16
  1738.             5             32             20
  1739.  
  1740. 20 COLOR MODE
  1741.  
  1742.     There are only 16 colors on the C64, but because of differences in the way
  1743.     that the Amiga and the C64 make their screens A64 uses more than 16 colors
  1744.     to display all of the C64's colors.  In addition to the C64's 16 colors,
  1745.     A64 needs one color for the background color and it also uses three
  1746.     additional colors for two of its graphics modes (See COLOR GADGETS in the
  1747.     COLORS section).  That brings our total up to 20 colors needed for A64 to
  1748.     draw the C64's screen. That's how we get 20 COLOR MODE.  When using this
  1749.     COLOR MODE A64 can replicate the C64's screen perfectly.  The confusion
  1750.     starts when we start changing the COLOR MODE and lowering the number of
  1751.     bitplanes.  When we start lowering the COLOR MODE, we start losing colors.
  1752.     A64 handles this slightly different for 16 COLOR MODE than it does for the
  1753.     2, 4 & 8 COLOR MODES.  We will explain this by separating 16 COLOR MODE
  1754.     from the 2, 4 & 8 COLOR MODES and explaining them separately.
  1755.  
  1756. 16 COLOR MODE
  1757.  
  1758.     With 16 COLOR MODE A64 uses four bitplanes.  This allows us to have a 
  1759.     maximum of 16 colors, exactly the number the C64 has, but remember, A64
  1760.     needs other colors.  A64 needs a maximum of 20 colors and we now only have
  1761.     16, four colors short.  A64 handles this by replacing the missing colors
  1762.     with other available colors.  The first colors A64 can replace are the
  1763.     three colors mentioned above, that were needed for two of A64's graphics
  1764.     modes.  These three colors are only used for 20 COLOR MODE and can be
  1765.     ignored for all other COLOR MODES.  Getting rid of these three colors
  1766.     brings our total colors, needed by A64, down to 17.  This still leaves us
  1767.     with one color too many.  The way A64 handles this, is to replace one of
  1768.     the C64's colors.  A64 replaces the C64's color 15 (light gray) with the
  1769.     C64's color 1 (white).  This means, when using 16 COLOR MODE, whenever
  1770.     something is supposed to be displayed in color 15 it will be displayed in
  1771.     color 1.  This replacement was picked, because the default color 1 (white)
  1772.     looks very close to the default color 15 (light gray).  For all practical
  1773.     purposes, this is the only difference between 16 COLOR MODE and 20 COLOR
  1774.     MODE.  With 16 COLOR MODE all colors will look the way they should, except
  1775.     color 15 will be replaced with color 1.
  1776.  
  1777.  
  1778.                                                                         3-13
  1779.  
  1780.  
  1781.  
  1782. -
  1783.  
  1784.  
  1785.  
  1786. 2, 4 & 8 COLOR MODES
  1787.  
  1788.     The remaining three COLOR MODES: 2, 4 & 8, are all handled by A64 in the
  1789.     same way.  With these COLOR MODES A64 must replace more colors, the lower
  1790.     the color mode, the more colors that need to be replaced.  The way A64 does
  1791.     this is by taking the number of allowed colors (the COLOR MODE number) and
  1792.     reserving one color for the background color and using the remaining colors
  1793.     for the C64 colors.  Because of the limited number of colors provided by
  1794.     these COLOR MODES A64 sets aside one color for the background color that
  1795.     will be different than all the remaining colors, this is slightly different
  1796.     than the 20 & 16 color modes, where the background color is always a copy
  1797.     of one of the C64's colors. For example, in 8 COLOR MODE, A64 uses 1 color
  1798.     for the background color, leaving 7 colors free for C64 colors. In 4 COLOR
  1799.     MODE, A64 uses 1 color for the background color, leaving 3 colors free for
  1800.     C64 colors and in 2 COLOR MODE A64 uses 1 color for the background color,
  1801.     leaving 1 color free for C64 colors (this is the equivalent of a monochrome
  1802.     mode).  The following chart shows what colors are replaced by these COLOR
  1803.     MODES:
  1804.  
  1805.         The 2, 4 & 8 COLOR MODE numbers correspond to the COLOR GADGETS
  1806.         starting with the second gadget in, from the left (skip the 1st color
  1807.         gadget, the background color gadget). 
  1808.  
  1809.         C64 COLOR    8 COLOR MODE    4 COLOR MODE    2 COLOR MODE
  1810.         ---------    ------------    ------------    ------------
  1811.             0                1               1               1
  1812.             1                2               2               1
  1813.             2                3               3               1
  1814.             3                4               1               1
  1815.             4                5               2               1
  1816.             5                6               3               1
  1817.             6                7               1               1
  1818.             7                1               2               1
  1819.             8                2               3               1
  1820.             9                3               1               1
  1821.            10                4               2               1
  1822.            11                5               3               1
  1823.            12                6               1               1
  1824.            13                7               2               1
  1825.            14                1               3               1
  1826.            15                2               1               1
  1827.  
  1828.     The different COLOR MODES supported by A64 may seem very confusing, but
  1829.     they are really not that complicated once you start using them.  Included
  1830.     with The A64 package is a C64 program named "64Colors."  It is located in
  1831.     the directory "64Prgs."  We suggest you use this program and experiment
  1832.     with the different COLOR MODES to see their effect on the C64's colors.
  1833.  
  1834.     NOTES: Each COLOR MODE has its own color palette containing the number of
  1835.            colors supported by the COLOR MODE (i.e., 16 COLOR MODE has its own
  1836.            palette of 16 colors).  When changing COLOR MODES the new COLOR
  1837.            MODE's palette will be switched in and the previous palette, and any
  1838.            changes you made to it, will be preserved.  This is the same as if
  1839.            you had selected the OK gadget for the changes, so before changing
  1840.            COLOR MODES make sure any colors that you changed are they way you
  1841.            want them.
  1842.  
  1843.  
  1844.                                                                         3-14
  1845.  
  1846.  
  1847.  
  1848. -
  1849.  
  1850.  
  1851.  
  1852.            The drawing of the C64's screen is the most time consuming part of
  1853.            A64.  The general rule is that the more graphics a C64 program uses,
  1854.            the more work A64 has to do to display them and the slower A64 will
  1855.            run the C64 program.  You can help compensate for this extra work,
  1856.            by lowering the COLOR MODE.  When you lower the COLOR MODE you
  1857.            decrease the number of bitplanes that A64 has to draw to making A64
  1858.            run faster.  We strongly recommend that you lower the COLOR MODE to
  1859.            at least 16 whenever possible.  16 COLOR MODE will handle most C64
  1860.            programs with no dramatic decrease in color resolution.  Also note
  1861.            that if you are running an A1000 with 512k or an A500 or A2000 with
  1862.            1mb or less, selecting 16 COLOR MODE, which eliminates the 5th
  1863.            bitplane, will give you a more noticeable speed increase.
  1864.  
  1865. OK GADGET
  1866.  
  1867.     Selecting OK will preserve all changes to the COLORS settings. They will
  1868.     become the current COLORS settings and become active immediately.
  1869.  
  1870. CANCEL GADGET
  1871.  
  1872.     Selecting CANCEL will ignore all changes to the current COLORS settings in
  1873.     the current COLOR MODE and abort the procedure.  CANCEL will not cancel out
  1874.     changes to the COLOR MODE setting itself nor will it restore changes made
  1875.     to another COLOR MODES' colors.
  1876.  
  1877.     NOTES: When the A64 Colors screen is open the A64 Prefs screen will become
  1878.            "locked" and you will not be able to access any of A64 Prefs menus
  1879.            until you close the A64 Colors screen (when A64 Prefs screen is
  1880.            locked it will say "SCREEN LOCKED" on its title bar).
  1881.  
  1882.            A64 COLORS is still in the early stages of development.  Future
  1883.            versions of it will have many more features that you would expect
  1884.            from a color selection screen of this type (i.e., COPY, SWAP,
  1885.            SPREAD, etc.). 
  1886.  
  1887.  
  1888. BORDERS
  1889.  
  1890.     KEY SEQUENCE: None
  1891.  
  1892.     The BORDERS menu option allows you to toggle the C64's borders on and off.
  1893.     Because the Amiga does not support a true border around its screen, a
  1894.     border around the entire C64 screen can not be emulated efficiently.  To
  1895.     support programs that need borders, for such things as changing the border
  1896.     color to signify some status within the program, A64 supports a border on
  1897.     the top and bottom of the screen.  Changing the status of the borders will
  1898.     have no effect on the operation of A64, but may make some programs look
  1899.     better.
  1900.  
  1901.     The BORDERS menu option has two settings: ON and OFF.  You can select one
  1902.     or the other of these settings and selecting one automatically unselects
  1903.     the other.  The current selected setting is shown by displaying a checkmark
  1904.     next to it.  To turn the on borders, select ON, and to turn the borders
  1905.     off, select OFF.
  1906.  
  1907.     NOTE: The borders will not be visible until re-entering A64.
  1908.  
  1909.  
  1910.                                                                         3-15
  1911.  
  1912.  
  1913.  
  1914. -
  1915.  
  1916.  
  1917.  
  1918. SCRN REFRESH
  1919.  
  1920.     KEY SEQUENCE: None
  1921.  
  1922.     The SCRN REFRESH menu option allows to change how fast and the way A64
  1923.     draws the C64 screen.  When selecting, you will be prompted with a
  1924.     requester containing several gadgets.  The function of each gadget is as
  1925.     follows:
  1926.  
  1927. SCREEN REFRESH TYPE GADGET
  1928.  
  1929.     The SCREEN REFRESH TYPE GADGET allows you to toggle the way A64 draws the
  1930.     C64 screen.  When selecting this gadget it will toggle between DIRECT and
  1931.     SAMPLE.  These settings correspond to the two ways that A64 can draw the
  1932.     C64 screen.  The meaning of each setting is as follows:
  1933.  
  1934. DIRECT MODE
  1935.  
  1936.     When A64 is in DIRECT MODE it writes to the Amiga's screen directly.  This
  1937.     means, when the C64 is performing an operation that changes some part of
  1938.     the C64's screen A64 make the same change immediately to the Amiga's
  1939.     screen.  This way of drawing directly to the Amiga's screen has the
  1940.     advantage of showing changes of the C64's screen immediately resulting in
  1941.     smoother screen updates, but has the disadvantage of having the tendency
  1942.     to slow down A64 when alot of changes are happening to the C64's screen
  1943.     seemingly at one time.  For example, scrolling in games.  DIRECT MODE is
  1944.     the default setting for the way A64 draws the screen and it is suggested
  1945.     that you try using this setting before trying SAMPLE mode for most C64
  1946.     programs.
  1947.  
  1948. SAMPLE MODE
  1949.  
  1950.     When A64 is in SAMPLE MODE it draws the changes in the C64 screen at a set
  1951.     SAMPLE rate.  This means that A64 will sample the C64 graphics at a certain
  1952.     rate to see what has changed and then draw the changes.  This way of
  1953.     drawing the screen has the advantage of being faster when alot of changes
  1954.     are happening to the C64's screen seemingly at one time.  For example,
  1955.     scrolling in games, but has the disadvantage of making the screen updates
  1956.     appear jerky and at times out of sequence.  When using C64 programs that
  1957.     are real graphics intensive you can select SAMPLE MODE to make them run
  1958.     faster.
  1959.  
  1960.     NOTE: There are times in A64 when SAMPLE MODE will override DIRECT MODE,
  1961.           because SAMPLE MODE can perform the screen updates more efficiently. 
  1962.           When you are running a C64 program that uses a graphics technique
  1963.           called "raster interrupts" and more than one graphics mode is used at
  1964.           one time SAMPLE MODE will automatically be used, regardless of the
  1965.           SCREEN REFRESH TYPE gadget setting. 
  1966.  
  1967. SCREEN REFRESH RATE GADGET
  1968.  
  1969.      The SCREEN REFRESH RATE GADGET allows you to change the rate at which A64
  1970.      redraws the screen.  This gadget is a string gadget and it will allow you
  1971.      to enter a five digit number that corresponds to A64's screen refresh
  1972.      rate.  This number can range from 1-65535 and the way A64 interprets it
  1973.      is as follows:
  1974.  
  1975.  
  1976.                                                                         3-16
  1977.  
  1978.  
  1979.  
  1980. -
  1981.  
  1982.      A64 uses the SCREEN REFRESH RATE value as a countdown to redraw the
  1983.      screen.  A64 subtracts 1 from this value 60 times per second and when the
  1984.      value counts down to 0 A64 resets the counter and redraws the screen.
  1985.      For example if you set this setting to 1 then A64 would subtract 1 from
  1986.      it 60 times per second (1-1=0) and would result in A64 redrawing the
  1987.      screen 60 times per second.  Listed below is a table showing how often
  1988.      A64 will redraw the screen based on the SCREEN REFRESH RATE setting.
  1989.  
  1990. SCREEN REFRESH RATE TABLE
  1991.  
  1992.     REFRESH RATE VALUE      REFRESH RATE
  1993.     ------------------    ----------------
  1994.         1        60 x per second
  1995.         2        30 x per second
  1996.         3        20 x per second
  1997.         4        15 x per second
  1998.         5        12 x per second
  1999.         6        10 x per second
  2000.     .....
  2001.        10         6 x per second
  2002.     .....
  2003.        15         4 x per second
  2004.     .....
  2005.        30         2 x per second
  2006.     .....
  2007.        60         1 x per second
  2008.     .....
  2009.       120            1 x per 2 seconds
  2010.     .....
  2011.       600         1 x per 10 seconds
  2012.     .....
  2013.          6000         1 x per 100 seconds (1.66 minutes)
  2014.     .....
  2015.     65535         1 x per 1092.25 seconds (18.20 minutes)
  2016.  
  2017. OK GADGET
  2018.  
  2019.     Selecting OK will preserve all changes to the SCREEN REFRESH settings. They
  2020.     will become the current SCREEN REFRESH settings and be active as soon as
  2021.     A64 is re-entered.
  2022.  
  2023. CANCEL GADGET
  2024.  
  2025.     Selecting CANCEL will ignore all changes to the SCREEN REFRESH settings and
  2026.     abort the procedure.
  2027.  
  2028.     NOTE: Both the SCREEN REFRESH TYPE and SCREEN REFRESH RATE settings can
  2029.           have major effects on how fast A64 runs.  We suggest you play around
  2030.           with these settings while using different C64 programs to see their
  2031.           effects.
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.                                                                         3-17
  2043.  
  2044.  
  2045.  
  2046. -
  2047.  
  2048.  
  2049.  
  2050. RASTERS
  2051.  
  2052.     KEY SEQUENCE: None
  2053.  
  2054.     The RASTERS menu option allows to change how A64 handles reads of the video
  2055.     scan line.
  2056.  
  2057.     Before explaining this setting we need to discuss some basic principals of
  2058.     video circuitry and how the C64 uses them.  Inside your computer's monitor
  2059.     is an electron beam that sweeps across the inside of your monitor's
  2060.     picture tube, refreshing the picture as it goes.  This electron beam sweeps
  2061.     across the screen from left to right and refreshes the screen one
  2062.     horizontal line at a time.  This horizontal line is called a scan line. The
  2063.     standard NTSC screen is made up of 262 of these scan lines.  This process
  2064.     of refreshing the screen, one scan line at time, happens very rapidly.  It
  2065.     takes your monitor 1/60th of a second to refresh one entire screen.  This
  2066.     means that in one second the screen will have been refreshed 60 times.
  2067.     Inside the C64 is a pair of registers (memory locations) that contain the
  2068.     current scan line number that is being refreshed by the monitor.  These
  2069.     registers are used by MANY C64 programs for a variety of purposes.  Seeing
  2070.     how these registers change at a regular rate many C64 programs use them
  2071.     for timing.  Another popular use for these registers is for a program to
  2072.     wait for a specific scan line before continuing.
  2073.  
  2074.     When selecting RASTERS you will prompted with a requester containing
  2075.     several gadgets.  The function of each gadget is as follows:
  2076.  
  2077. SCAN LINE READ GADGET
  2078.  
  2079.      The SCAN LINE READ GADGET allows you to select the way A64 reads the scan
  2080.      line registers.  When selecting this gadget it will toggle between REAL
  2081.      and FAKE.  These settings correspond to the two ways that A64 can read the
  2082.      scan line registers.  The meaning of each setting is as follows:
  2083.  
  2084. REAL
  2085.  
  2086.     When the SCAN LINE READ GADGET is set to REAL, A64 will use the Amiga's
  2087.     hardware to get the current scan line.  This method is the more compatible
  2088.     of the two and should be used whenever possible.  There is one problem with
  2089.     using this method.  Because of internal timing in the Amiga some scan lines
  2090.     can not be read (scan lines 6-12).  Because of this, if a C64 program is
  2091.     waiting for one of these scan lines it will lock up waiting for something
  2092.     that will never happen.  (NOTE: If this does happen you can still RESET
  2093.     A64.  See: RESET A64 in the PROJECT MENU section).  Because of this problem
  2094.     A64 supports another way of reading the scan line registers.
  2095.  
  2096. FAKE
  2097.  
  2098.     When the SCAN LINE READ GADGET is set to FAKE, A64 will simulate the
  2099.     function of the scan line registers.  This method will allow some C64
  2100.     programs to run that wouldn't ordinarily with the above mentioned REAL
  2101.     method.  This method will allow all scan lines to be read, but because of
  2102.     the fact that it is a FAKE reading it will not be in sync with the true
  2103.     scan line.  This should not cause major problems with most C64 programs,
  2104.     but it will throw of the timing of any program that uses the scan line
  2105.     registers for that purpose.
  2106.  
  2107.  
  2108.                                                                         3-18
  2109.  
  2110.  
  2111.  
  2112. -
  2113.  
  2114.  
  2115.  
  2116. OK GADGET
  2117.  
  2118.     Selecting OK will preserve all changes to the RASTERS settings. They will
  2119.     become the current RASTERS settings and be active as soon as A64 is
  2120.     re-entered.
  2121.  
  2122. CANCEL GADGET
  2123.  
  2124.     Selecting CANCEL will ignore all changes to the RASTERS settings and abort
  2125.     the procedure.
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.                                                                         3-19
  2175.  
  2176.  
  2177.  
  2178. -
  2179.  
  2180.  
  2181.  
  2182. THE TOOLS MENU
  2183.  
  2184.  
  2185. SAVE SCREEN
  2186.  
  2187.     KEY SEQUENCE: [F1]
  2188.  
  2189.     The SAVE SCREEN menu option allows you to save the currently displayed C64
  2190.     screen as an IFF file.  After saving the screen you can then load it into
  2191.     any Amiga graphics program that supports IFF pictures, like Deluxe Paint.
  2192.  
  2193.     When selecting SAVE SCREEN you will be prompted with a requester asking you
  2194.     to enter the name of the file you wish to save the screen as.  Use the
  2195.     requester's string gadget to enter the name and then press the RETURN key
  2196.     to save the file.  You can also use the requester's other gadgets to select
  2197.     the following:
  2198.  
  2199.         OK, Save the screen. (Pressing RETURN does the same.)
  2200.  
  2201.         CANCEL, Abort the procedure.
  2202.  
  2203.     NOTE: The filename can contain any legal AmigaDOS path name, limited to 31
  2204.           characters in length.
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.                                                                         3-20
  2241.  
  2242.  
  2243.  
  2244. -
  2245.  
  2246.  
  2247.  
  2248. A64 PREFS NOTES
  2249.  
  2250.     This section contains miscellaneous information about A64 Prefs that did
  2251.     not fit into other sections of the manual.
  2252.  
  2253.     When in A64 Prefs you can press [F10] to toggle the title bar on and off.
  2254.  
  2255.     When A64 is running some programs and you bring up A64 Prefs, you may
  2256.     notice some images disappear from the C64 screen, this is normal. These
  2257.     images are called "sprites."  Sprites are independent graphics images and
  2258.     not part of the screen in the normal sense.  Because A64 Prefs does not
  2259.     support C64 sprites, they will disappear from the screen when it is
  2260.     entered.  An example of a sprite is the Amiga's mouse pointer.
  2261.  
  2262.     When A64 is running some programs and you bring up A64 Prefs, you may
  2263.     notice the background changes color, this is normal.  This can happen if a
  2264.     C64 program is using a graphics technique called "raster interrupts" and
  2265.     the background color is different in areas on the same screen.  Because A64
  2266.     Prefs does not support multiple background colors on the same screen, as
  2267.     A64 does, it will display the last background color used for its background
  2268.     color.
  2269.  
  2270.     You should never attempt to bring up A64 Prefs while I/O (INPUT/OUTPUT) is
  2271.     in progress.  This means that whenever A64 is loading or saving from a disk
  2272.     drive, accessing a modem or using a printer, you should wait until the
  2273.     operation is completed before bringing up A64 Prefs.  This warning should
  2274.     especially be noted when accessing C64 devices.  Bringing up A64 during
  2275.     I/O should not "crash" A64, but may result in a "C64 crash" forcing you to
  2276.     reset A64 and/or the C64 devices that you interrupted.  To be on the safe
  2277.     side you should heed this warning.
  2278.  
  2279.     If at anytime you try to bring up A64 Prefs and the title bar does not
  2280.     appear and/or the screen goes blank this means A64 Prefs has not yet been
  2281.     entered correctly.  The most likely cause of this is the Amiga has brought
  2282.     up a system requester on the WorkBench screen.  You must clear this
  2283.     requester before A64 Prefs will be entered correctly.  To do this, follow
  2284.     this procedure:
  2285.  
  2286.         1. Use the following key sequence to get access to the WorkBench
  2287.            screen:
  2288.  
  2289.                [LEFT AMIGA] [N]: Send Workbench to front, A64 Prefs to back
  2290.  
  2291.         2. Perform the action requested by the requester or select CANCEL.
  2292.         3. If A64 Prefs does not appear automatically after handling the
  2293.             requester use the following key sequence or depth arrange the
  2294.             WorkBench screen to get to A64 Prefs:
  2295.  
  2296.                [LEFT AMIGA] [M]: Send Workbench to back, A64 Prefs to front
  2297.  
  2298.         NOTE: If there is not a system requester on the WorkBench screen then
  2299.               A64 is stuck somewhere and you will have to reboot your Amiga to
  2300.               get everything back to normal.  Every precaution has been taken
  2301.               to make sure this doesn't happen.
  2302.  
  2303.  
  2304.  
  2305.  
  2306.                                                                         3-21
  2307.  
  2308.  
  2309.  
  2310. -
  2311.  
  2312.  
  2313.  
  2314. UTILITIES
  2315.  
  2316.     The A64 Package comes with a number of utility programs serving a variety
  2317.     of functions.  The majority of these utility programs are for helping with
  2318.     the transfer of C64 programs and data to the Amiga.  These utilities allow
  2319.     you to access C64 disk drives and printers directly from AmigaDOS and most
  2320.     of them must be run from the CLI.  In the following sections we will
  2321.     outline each utility and how to use it. 
  2322.  
  2323.  
  2324. UTILITIES SUMMARY
  2325.  
  2326.     The following list gives a brief summary of the utilities included with
  2327.     The A64 Package.  A couple of the headings need explanation.  The heading
  2328.     HDW is short for HarDWare interface and is used to signify if the utility
  2329.     directly needs A64's hardware interface.  The heading ENV is short for
  2330.     ENVironment and is used to state what environment the utility is to be used
  2331.     in.  The different environments are: WB - the utility is meant to be used
  2332.     with the WorkBench, but can also be used from the CLI, CLI - the utility
  2333.     is used from the CLI only, C64 - the utility is meant to be used on the
  2334.     C64, and A64 - the utility can be used by both A64 and the C64.  Please
  2335.     note that the utilities with their environment set to C64 or A64 are
  2336.     actual Commodore 64 programs, all other utilities are Amiga programs. Also
  2337.     note that just because a utility does not use the hardware interface
  2338.     directly does not mean that the utility will be useful without it.  For
  2339.     example the utility "Pet2ASCII" will convert a file from PetASCII to ASCII,
  2340.     but to use it you must first transfer a C64 program to an Amiga disk.
  2341.  
  2342.     UTILITY NAME    HDW    ENV    FUNCTION
  2343.     ------------    ---    ---    --------
  2344.     64Cmd        YES    CLI    Send a command to a C64 drive
  2345.     64Dir        YES    CLI    Read the dir of a C64 drive
  2346.     64Print        YES    CLI    Print an Amiga file to a C64 printer
  2347.     64Status            YES    CLI    Read a C64 drives' status
  2348.     64ToAmiga            YES    CLI    Copy a file from a C64 drive to an
  2349.                                         Amiga drive
  2350.     AmigaTo64            YES    CLI    Copy a file from an Amiga drive to a
  2351.                                         C64 drive
  2352.     Cache        NO    WB    Toggle 68020/30/40 cache on and off
  2353.     InstallA64Font    NO    WB    Install A64's font to FONTS:
  2354.     Pet2ASCII            NO    CLI    Convert a file from PetASCII to ASCII
  2355.     PrintFile            NO    WB    Print an Amiga file to an Amiga printer
  2356.     StripLoadAddr    NO    CLI    Strip the load address from a file
  2357.  
  2358.     64Colors            NO    A64    View the C64's colors
  2359.     SaveROMs            NO    C64    Save the C64's ROMs
  2360.  
  2361.  
  2362. CONVENTIONS FOR THE CLI BASED UTILITIES
  2363.  
  2364.     Here are some general conventions for using the CLI based utilities that
  2365.     will help make them easier to use:
  2366.  
  2367.     For all the CLI based utilities except one, 64Status, you may enter the
  2368.     utilities name alone to get it's usage (for 64Status enter ? after its name
  2369.     to get its usage).
  2370.  
  2371.         For example, if you type: 64ToAmiga [RETURN]
  2372.                                                                         4-1
  2373.  
  2374.  
  2375.  
  2376. -
  2377.  
  2378.  
  2379.  
  2380.         The utility will print a short copyright message followed by a usage
  2381.         line that shows the syntax of the input that the utility expects.  A
  2382.         usage line appears like this:    
  2383.  
  2384.         Usage: 64ToAmiga <source filename> <destination filename> [file type]
  2385.  
  2386.     A utilities usage line shows what parameters are needed by the utility and
  2387.     incloses these parameters with symbols:
  2388.  
  2389.         When you see a parameter inclosed in < > this parameter is required by
  2390.         the utility and must be entered for the utility to function properly.
  2391.  
  2392.         When you see a parameter inclosed in [ ] this parameter is optional. If
  2393.         you don't enter anything for this parameter the utility will use some
  2394.         default value for it.
  2395.  
  2396.     NOTE: When using the CLI commands that require A64's hardware interface
  2397.           you should make sure the interface and the correct device for the
  2398.           utility is connected before attempting to use the utility.  Failing
  2399.           to do this can lock-up your Amiga.
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.                                                                         4-2
  2439.  
  2440.  
  2441.  
  2442. -
  2443.  
  2444.  
  2445.  
  2446. 64Cmd
  2447.  
  2448.     PURPOSE:     Send a command to a C64 disk drive
  2449.  
  2450.     USAGE:       64Cmd <command string> [drive]
  2451.                      <command string> is a valid C64 drive command string.
  2452.                      [drive] is a C64 drive, specified as df8:, df9:, df10: or
  2453.                          df11:.  df8: is the default.
  2454.  
  2455.     ENVIRONMENT: CLI
  2456.  
  2457.     INTERFACE:   YES
  2458.  
  2459.     64Cmd will allow you to send a command to a C64 disk drive.  It supports
  2460.     all of the standard Commodore DOS commands.  Some examples of using 64Cmd
  2461.     are:
  2462.  
  2463.         FORMAT:   Format a disk
  2464.         USAGE:    64Cmd N0:<disk name>,<2 digit id> [C64 drive]
  2465.         EXAMPLE:  64Cmd N0:testdisk,64 df8:
  2466.  
  2467.         SCRATCH:  Delete a file
  2468.         USAGE:    64Cmd S0:<filename> [C64 drive]
  2469.         EXAMPLE:  64Cmd S0:testfile df8:
  2470.  
  2471.         RENAME:   Rename a file
  2472.         USAGE:    64Cmd R0:<new name>=<old name> [C64 drive]
  2473.         EXAMPLE:  64Cmd R0:testfile2=testfile1 df8:
  2474.  
  2475.     For more information on C64 drive commands see your 1541 disk drive user's
  2476.     manual.
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.                                                                         4-3
  2505.  
  2506.  
  2507.  
  2508. -
  2509.  
  2510.  
  2511.  
  2512. 64Dir
  2513.  
  2514.     PURPOSE:     Get a directory listing of a C64 disk
  2515.  
  2516.     USAGE:       64Dir <search string> [drive]
  2517.                      <search string> is a valid C64 search string.
  2518.                      [drive] is a C64 drive, specified as df8:, df9:, df10: or
  2519.                          df11:.  df8: is the default.
  2520.  
  2521.     ENVIRONMENT: CLI
  2522.  
  2523.     INTERFACE:   YES
  2524.  
  2525.     64Dir will allow you to get a directory of a C64 disk. Some examples of
  2526.     using 64Dir are:
  2527.  
  2528.          64Dir $ df8:
  2529.  
  2530.         Will list the entire directory of drive 8.
  2531.  
  2532.          64Dir $:a* df9:
  2533.  
  2534.             Will list only the files that begin with "a" on drive 9.
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.                                                                         4-4
  2571.  
  2572.  
  2573.  
  2574. -
  2575.  
  2576.  
  2577.  
  2578. 64Print
  2579.  
  2580.     PURPOSE:     Print a file to C64 printer
  2581.  
  2582.     USAGE:       64Print <filename> <device> [option]
  2583.                      <filename> is the name of the file you wish to print.
  2584.                      <device> is a C64 printer number, either 4 or 5.  The
  2585.                          default is 4.
  2586.                      [option] can be either A for ASCII or B for Binary The
  2587.                          default is A.  The difference between these options
  2588.                          is that A will convert the file from ASCII to
  2589.                          PetASCII before printing it and B will not do any
  2590.                          conversion of the file.
  2591.  
  2592.     ENVIRONMENT: CLI
  2593.  
  2594.     INTERFACE:   YES
  2595.  
  2596.     64Print will allow you to print a file to a C64 printer.  Some examples of
  2597.     using 64Print are:
  2598.  
  2599.          64Print testfile
  2600.  
  2601.                  Will print the file "testfile"
  2602.  
  2603.          64Print testfile2 B
  2604.  
  2605.             Will print the file "testfile2" without any ASCII conversions.
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.                                                                         4-5
  2637.  
  2638.  
  2639.  
  2640. -
  2641.  
  2642.  
  2643.  
  2644. 64Status
  2645.  
  2646.     PURPOSE:     Read a the status of a C64 disk drive
  2647.  
  2648.     USAGE:       64Status [drive]
  2649.                      [drive] is a C64 drive, specified as df8:, df9:, df10: or
  2650.                          df11:.  df8: is the default.
  2651.  
  2652.     ENVIRONMENT: CLI
  2653.  
  2654.     INTERFACE:   YES
  2655.  
  2656.     64Status allows you to read the status of a C64 disk drive.  When a C64
  2657.     drive encounters an error it will flash its read light off and on.  You
  2658.     can use 64Status to find out what caused the error.  An example of 64Status
  2659.     is:
  2660.  
  2661.         64Status df8:
  2662.  
  2663.             Will read the status of drive 8.
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.                                                                         4-6
  2703.  
  2704.  
  2705.  
  2706. -
  2707.  
  2708.  
  2709.  
  2710. 64ToAmiga
  2711.  
  2712.     PURPOSE:     Copy a file from a C64 drive to an Amiga drive.
  2713.  
  2714.     USAGE:       64ToAmiga <source filename> <destination filename> [file type]
  2715.                      <source filename> is a C64 filename.
  2716.                      <destination filename> is an Amiga filename.
  2717.                      [file type] can be either P for PRG file or S for SEQ
  2718.                          file.  The default is P.
  2719.  
  2720.     ENVIRONMENT: CLI
  2721.  
  2722.     INTERFACE:   YES
  2723.  
  2724.         64ToAmiga will allow you to copy a file from a C64 disk drive to an
  2725.         Amiga disk drive.  Some examples of using 64ToAmiga are:
  2726.  
  2727.             64ToAmiga df8:testfile df0:
  2728.  
  2729.         Will copy the file "testfile" from the C64 drive 8 to the Amiga
  2730.                 drive 0.
  2731.  
  2732.             64ToAmiga df8:testfile2 df0:64Prgs/testfile S
  2733.  
  2734.                 Will copy the sequential file "testfile2" from the C64 drive 8
  2735.                 to the file "testfile" in the directory 64Prgs on Amiga drive
  2736.                 0.
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.                                                                         4-7
  2769.  
  2770.  
  2771.  
  2772. -
  2773.  
  2774.  
  2775.  
  2776. AmigaTo64
  2777.  
  2778.     PURPOSE:     Copy a file from an Amiga drive to a C64 drive.
  2779.  
  2780.     USAGE:       AmigaTo64 <source filename> <destination filename> [file type]
  2781.                      <source filename> is an Amiga filename.
  2782.                      <destination filename> is a C64 filename.
  2783.                      [file type] can be either P for PRG file or S for SEQ
  2784.                          file.  The default is P.
  2785.  
  2786.     ENVIRONMENT: CLI
  2787.  
  2788.     INTERFACE:   YES
  2789.  
  2790.         AmigaTo64 will allow you to copy a file from an Amiga disk drive to a
  2791.         C64 disk drive.  Some examples of using AmigaTo64 are:
  2792.  
  2793.             AmigaTo64 df0:testfile df8:
  2794.  
  2795.         Will copy the file "testfile" from the Amiga drive 0 to the C64
  2796.                 drive 8.
  2797.  
  2798.             AmigaTo64 df0:64Prgs/testfile df8:testfile2 S
  2799.  
  2800.                 Will copy the sequential file "testfile" from the directory
  2801.                 64Prgs on the Amiga drive 0 to the file "testfile2" on the C64
  2802.                 drive 8.
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.                                                                         4-8
  2835.  
  2836.  
  2837.  
  2838. -
  2839.  
  2840.  
  2841.  
  2842. Cache
  2843.  
  2844.     PURPOSE:     Toggle 68020/30/40 microprocessor cache on and off.
  2845.  
  2846.     USAGE:       Cache
  2847.  
  2848.     ENVIRONMENT: WorkBench or CLI
  2849.  
  2850.     INTERFACE:   NO
  2851.  
  2852.     Cache will allow you to toggle the 68020/30/40 microprocessor cache on and
  2853.     off.  When using one of these microprocessors you must disable it's cache
  2854.     before using one The A64 Packages utilities that directly use A64's
  2855.     hardware interface.  Turning off the cache is not required when using A64
  2856.     or any other utility that does not use the hardware interface.
  2857.  
  2858.     When Cache is run a window will appear stating the new microprocessor's
  2859.     cache status.  The possible responses are:
  2860.  
  2861.         Installed microprocessor does NOT have a cache.
  2862.  
  2863.         Microprocessor cache is OFF.
  2864.  
  2865.         Microprocessor cache is ON.    
  2866.  
  2867.     See 680x0 SUPPORT in the TECHNICAL section.
  2868.  
  2869.         
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.                                                                         4-9
  2901.  
  2902.  
  2903.  
  2904. -
  2905.  
  2906.  
  2907.  
  2908. InstallA64Font
  2909.  
  2910.     PURPOSE:     Install the A64 Font to FONTS:
  2911.  
  2912.     USAGE:       InstallA64Font
  2913.  
  2914.     ENVIRONMENT: WorkBench or CLI
  2915.  
  2916.     INTERFACE:   NO
  2917.  
  2918.     Install A64 Font will allow you to install the A64 font to the current
  2919.     FONTS: directory.  This font is needed by A64 and it must be installed on
  2920.     any WorkBench disk that you use with A64.
  2921.  
  2922.     To run InstallA64Font from the WorkBench follow this procedure:
  2923.  
  2924.         1. Double-click the InstallA64Font icon.
  2925.         2. A window will appear asking you to enter the name of the drive
  2926.            containing The A64 Package.  When this window appears enter the
  2927.            drive name and press RETURN.  For example, if the disk containing
  2928.            The A64 Package is in drive 0, enter: df0: [RETURN].
  2929.  
  2930.     The font will then be installed to the fonts directory on your WorkBench
  2931.     disk.
  2932.  
  2933.     See RUNNING A64 in the GETTING STARTED section for more information.
  2934.  
  2935.         
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.                                                                         4-10
  2967.  
  2968.  
  2969.  
  2970. -
  2971.  
  2972.  
  2973.  
  2974. Pet2ASCII
  2975.  
  2976.     PURPOSE:     Convert a file from PetASCII to ASCII.
  2977.  
  2978.     USAGE:       Pet2ASCII <source filename> [destination filename]
  2979.                      <source filename> is the name of the file you want to
  2980.                          convert
  2981.                      [destination filename] is the name of the file you want
  2982.                          to output the converted file to.  If not specified then
  2983.                          <source filename> will be overwritten by the converted
  2984.                          file.
  2985.  
  2986.     ENVIRONMENT: CLI
  2987.  
  2988.     INTERFACE:   NO
  2989.  
  2990.     Pet2ASCII will allow you to convert a file from PetASCII to standard ASCII.
  2991.     The C64 does not use standard ASCII.  "ASCII" stands for "American Standard
  2992.     Code for Information Interchange" and is a standardized method for the way
  2993.     that many computers represent certain information, namely english text. 
  2994.     This manual was written on an Amiga which uses ASCII codes to represent
  2995.     each letter and symbol.  The C64 has it's own form of ASCII called
  2996.     PetASCII.  The Commodore 64's PetASCII is quite a bit different from
  2997.     standard ASCII and for the Amiga to represent it correctly it must be
  2998.     converted to standard ASCII.
  2999.  
  3000.     Some examples of Pet2ASCII's usage are as follows:
  3001.  
  3002.         Pet2ASCII testfile
  3003.  
  3004.         Will covert the file "testfile" from PetASCII to ASCII.
  3005.  
  3006.         Pet2ASCII testfile testfile.asc
  3007.  
  3008.         Will covert the file "testfile" from PetASCII to ASCII, leaving
  3009.                 file "testfile" unchanged and the converted file in
  3010.                 "testfile.asc".
  3011.  
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.                                                                         4-11
  3033.  
  3034.  
  3035.  
  3036. -
  3037.  
  3038.  
  3039.  
  3040. PrintFile
  3041.  
  3042.     PURPOSE:     Print a file
  3043.  
  3044.     USAGE:       PrintFile [filename]
  3045.  
  3046.     ENVIRONMENT: WorkBench or CLI
  3047.  
  3048.     INTERFACE:   NO
  3049.  
  3050.     PrintFile will allow you to print a file to an Amiga printer.  It can be
  3051.     used from either the CLI or the WorkBench.  To use it from the WorkBench
  3052.     double-click its icon and then enter the name of the file you wish to
  3053.     print.  After entering the filename press the RETURN key to print the file.
  3054.     You can also pass PrintFile a filename by selecting a document icon and
  3055.     holding down one of the SHIFT keys while double-clicking the PrintFile
  3056.     icon.  For example if you want to print the file "ReadMe":
  3057.  
  3058.         1. Select the ReadMe icon by clicking the left mouse button on it once.
  3059.         2. Press one of the shift keys on the Amiga keyboard.
  3060.         3. Double-click the PrintFile icon while still holding down the shift
  3061.            key.
  3062.  
  3063.     PrintFile will then be started and automatically start printing the file
  3064.     "ReadMe."
  3065.  
  3066.     To run PrintFile from the CLI enter the following:
  3067.  
  3068.         PrintFile [filename]
  3069.  
  3070.     PrintFile will then be started and automatically start printing the file
  3071.     you specified.
  3072.  
  3073.     When PrintFile is done printing a file it does not close itself.  This
  3074.     allows you to print multiple files without restarting it.  To quit
  3075.     PrintFile select the close gadget at the top left hand corner of its window.
  3076.  
  3077.  
  3078.         
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.                                                                         4-12
  3099.  
  3100.  
  3101.  
  3102. -
  3103.  
  3104.  
  3105.  
  3106. StripLoadAddr
  3107.  
  3108.     PURPOSE:     Strip a C64 load address from a file
  3109.  
  3110.     USAGE:       StripLoadAddr <filename>
  3111.                      <filename> is the name of the file you want to strip the
  3112.                          load address from.
  3113.  
  3114.     ENVIRONMENT: CLI
  3115.  
  3116.     INTERFACE:   NO
  3117.  
  3118.     StripLoadAddr will allow you to strip a load address from a C64 file.  The
  3119.     C64 adds a two byte load address to the start of its PRG files that tells
  3120.     it where to load the file.  When transferring these files to the Amiga
  3121.     you may wish to strip this load address.  An example of using StripLoadAddr 
  3122.     is:
  3123.  
  3124.         StripLoadAddr testfile
  3125.  
  3126.         Will strip the load address from the file "testfile."
  3127.  
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.                                                                         4-13
  3165.  
  3166.  
  3167.  
  3168. -
  3169.  
  3170.  
  3171.  
  3172. C64 PROGRAMS
  3173.  
  3174.     The A64 Package comes with a couple of Commodore 64 programs, located in
  3175.     the directory 64Prgs.  These programs are as follows:
  3176.  
  3177.  
  3178. SaveROMs
  3179.  
  3180.     SaveROMs is for saving the C64 ROMs to disk.  It is meant to be run on a
  3181.     C64 because A64 does not contain the C64's ROMs.  To use this program
  3182.     see INSTALLING THE C64's ROMs in the TECHNICAL section.
  3183.  
  3184.  
  3185. 64Colors
  3186.  
  3187.     64Colors is a simple BASIC program that allows you to view the C64 colors.
  3188.     It was included with The A64 Package so you could experiment with A64's
  3189.     COLOR MODES while using it (See COLORS in the A64Prefs section).
  3190.  
  3191.     For information on how to load and run this program see DRIVES in the
  3192.     SYSTEM MENU section.
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.                                                                         4-14
  3231.  
  3232.  
  3233.  
  3234. -
  3235.  
  3236.  
  3237.  
  3238. TECHNICAL
  3239.  
  3240.  
  3241.  
  3242. THE A64 PACKAGES FILE STRUCTURE
  3243.  
  3244.     The A64 Package is very large and fills over 70% of 3.5" floppy disk,
  3245.     because of this, the entire package will not fit on a WorkBench disk.  Some
  3246.     users may wish to fit parts of The A64 PAckage onto a WorkBench disk,
  3247.     especially if they only have one disk drive.  This can be done by
  3248.     separating A64 from the rest of The A64 Package.  Please note that if you
  3249.     do separate The A64 Package into different parts you may not distribute
  3250.     them.  The A64 Package may only be distributed in its entirety.
  3251.  
  3252.     We are not going to discuss the exact details of how to extract parts of
  3253.     The A64 Package, but what we will do is tell you what directories and files
  3254.     are needed to run just A64.  Listed below is a directory listing of The
  3255.     A64 Package.  Directories and Files that appear with an "*" before their
  3256.     name must appear as listed for A64 to run.  All other files may be moved
  3257.     or removed.  Please note that the "*" is not part of the name of the
  3258.     directories and files and appears only to show what should stay as listed.
  3259.     Please note that if you want to have the ability to install the A64 Font
  3260.     onto a WorkBench disk you will need the files marked with "#".  Again, this
  3261.     symbol is not part of the names, but is used to signify them.
  3262.  
  3263.     *TheA64Package
  3264.          A64Utilities (dir)
  3265.            !.info                           .info
  3266.            64Cmd                            64Dir
  3267.            64Print                          64Status
  3268.            64ToAmiga                        AmigaTo64
  3269.            Pet2ASCII                        StripLoadAddr
  3270.          64Prgs (dir)
  3271.            64Colors                         SaveROMs
  3272.         #Fonts (dir)
  3273.              #A64 (dir)
  3274.                #6                                
  3275.           #A64.font                         
  3276.         *64Fonts (dir)
  3277.           *CharROM.64font                   
  3278.       .info                           *A64
  3279.      *A64.config                      *A64.info
  3280.       A64Utilities.info               *BASIC.data
  3281.       Cache                            Cache.info
  3282.       InitA64                         #InstallA64Font
  3283.      #InstallA64Font.info             *KERNAL.data
  3284.      *Lic                              Manual
  3285.       Manual.info                      PrintFile
  3286.       PrintFile.info                   ReadMe
  3287.       ReadMe.info                      Registration.form
  3288.       Registration.form.info          *ROM
  3289.      *Title                            
  3290.     *TheA64Package.info
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.                                                                         5-1
  3297.  
  3298.  
  3299.  
  3300. -
  3301.  
  3302.  
  3303.  
  3304. THE KEYBOARD
  3305.  
  3306.  
  3307. KEYBOARD DIFFERENCES
  3308.  
  3309.     There are some minor differences between the C64 keyboard and the Amiga's.
  3310.     The way A64 maps the keyboard is pretty much "what you see is what you
  3311.     get."  In most cases the legends on the keys represent their equivalent
  3312.     function.
  3313.  
  3314.     The exceptions to this are:
  3315.  
  3316.         AMIGA KEY            C64 EQUIVALENT
  3317.         ---------            --------------
  3318.         ESC                RUN/STOP
  3319.         BACKSPACE (BACKARROW)        CLR/HOME
  3320.         HELP                RESTORE
  3321.         LEFT AMIGA            COMMODORE
  3322.         `~                BACK ARROW
  3323.         \|                LYRA
  3324.         [{                [ (when shifted gives PI)
  3325.         ]}                ] (when shifted gives shift @)
  3326.  
  3327.     NOTE: The key sequence [RUN/STOP] [RESTORE] that is used to stop C64 BASIC
  3328.           programs, can be done by pressing [ESC] [HELP].
  3329.  
  3330. A PROBLEM WITH THE KEYBOARD
  3331.  
  3332.     Because of differences in a small number of keys on the keyboards of the
  3333.     C64 and the Amiga, a minor problem can occur with certain key sequences.
  3334.     This problem is rare and under normal typing situations should not be
  3335.     apparent.  It is related to pressing one or more of the shift keys and
  3336.     one of the numeric or punctuation keys simultaneously.  What will happen
  3337.     is that A64 will think you pressed a key that you didn't and an unwanted
  3338.     character will appear on the screen.  If this happens use the DEL key to
  3339.     delete the unwanted character.  Please note that this is not a "BUG" in
  3340.     A64, but is related to the way that the C64 reads the keyboard.
  3341.  
  3342. THE NUMERIC KEYPAD
  3343.  
  3344.     The numeric keypad on the Amiga keyboard is fully supported.  It should be
  3345.     noted that shifting the keys on the keypad will give the C64 equivalent and
  3346.     not the Amiga's equivalent.
  3347.  
  3348.     For example, using the key sequence: [SHIFT] [2]
  3349.  
  3350.     On the Amiga: [SHIFT] [2] (2 key at top left of keyboard) produces the '@'
  3351.                   [SHIFT] [2] (2 key on the numeric keypad) produces the '"'
  3352.  
  3353.     On the C64:   [SHIFT] [2] produces the '"'
  3354.  
  3355.     NOTE: By using the numeric keypad and it's C64 shifted equivalents you will
  3356.           eliminate most of the keys that can cause the problem listed above. 
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.                                                                         5-2
  3363.  
  3364.  
  3365.  
  3366. -
  3367.  
  3368.  
  3369.  
  3370. UNUSED KEYS
  3371.  
  3372.     There are a few keys on the Amiga keyboard that are unused by A64.  They
  3373.     are as follows: TAB, F9, F10 and RIGHT AMIGA.  Also, when pressed
  3374.     simultaneously the two ALT keys will invoke A64 Prefs, but have no meaning
  3375.     when pressed by themselves.
  3376.  
  3377.  
  3378.  
  3379.  
  3380.  
  3381.  
  3382.  
  3383.  
  3384.  
  3385.  
  3386.  
  3387.  
  3388.  
  3389.  
  3390.  
  3391.  
  3392.  
  3393.  
  3394.  
  3395.  
  3396.  
  3397.  
  3398.  
  3399.  
  3400.  
  3401.  
  3402.  
  3403.  
  3404.  
  3405.  
  3406.  
  3407.  
  3408.  
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.                                                                         5-3
  3429.  
  3430.  
  3431.  
  3432. -
  3433.  
  3434.  
  3435.  
  3436. A64 AND MULTITASKING
  3437.  
  3438.     A64 is the first true multitasking Commodore 64 emulator.  A64's
  3439.     multitasking ability gives it power and flexibility and allows it to be a
  3440.     stable and reliable program (Multitasking programs are MUCH easier to debug
  3441.     and improve than programs that take over your Amiga).  We hope you'll agree
  3442.     with us when we say "it's A64's multitasking ability that sets it apart
  3443.     from the other C64 emulators."
  3444.  
  3445.     Until now, everyone thought a program like a C64 emulator had to take over
  3446.     your Amiga, because it needs to run as fast as possible and needs system
  3447.     resources that the Amiga's operating system usually uses.  A64 manages to
  3448.     run faster than the other C64 emulators, use all the Amiga resources it
  3449.     needs and still leave the Amiga's operating system intact.  We can not even
  3450.     begin to explain what went into getting A64 to accomplish this amazing
  3451.     feat.  What we can say is that A64 should work just fine with any program
  3452.     that follows the rules of multitasking programming on the Amiga.  There have
  3453.     been times that we forgot that we were running A64 because we exited back
  3454.     to the WorkBench or the CLI to do something else and then after hours of
  3455.     running other programs we remembered that A64 was still in memory and we
  3456.     went back to it and found it working perfectly.  The only programs that A64
  3457.     may not work with are programs that take over, some part of or all of, your
  3458.     Amiga, like some games and other emulators.  Which brings up to our next
  3459.     point.  A64 can not multitask itself.  Even though A64 is capable of
  3460.     multitasking it still takes over system resources that can not be shared
  3461.     with other programs, so one copy of A64 can not share these resources with
  3462.     another copy of A64.
  3463.  
  3464.  
  3465. A64 AND MEMORY
  3466.  
  3467.     A64 is a very memory hungry program and in its full capacity it will take
  3468.     up over 300k of your Amiga's memory.  If your Amiga has less than 1mb of
  3469.     RAM, more likely than not, A64 will not run.  There are some things that
  3470.     users with 512k can do to get A64 to work.  If they install the C64's ROMs
  3471.     (See INSTALLING THE C64's ROMs in the TECHNICAL section) they can save
  3472.     about 135k of RAM, but doing this will greatly decrease A64's speed. 
  3473.     Please note that it is not the installation of the C64's ROMs that slows
  3474.     down A64, but rather the fact that 512k users do not have enough RAM to use
  3475.     A64's ROM emulation, which runs dramatically faster than the C64's ROMs
  3476.     by themselves.  Users with 1mb or more can install the C64's ROMs with no
  3477.     decrease in speed, just added compatibility.  Other things can also be done
  3478.     to save memory, like: make sure there are no other programs running, don't
  3479.     load the WorkBench and remove all external drives.  None of these options
  3480.     are really desireable and for that reason we recommend at least 1mb of RAM
  3481.     when using A64.
  3482.  
  3483.     Different memory configurations can make a dramatic difference in the speed
  3484.     of A64.  The worst case is running A64 on a 512k RAM system and the best
  3485.     case is running A64 on a 68020+ based system with 32 bit RAM.  On a 68030
  3486.     based system speeds of around 200% have been reached with some programs
  3487.     (See 680x0 SUPPORT in the TECHNICAL section).  We normally recommend at
  3488.     least 1mb of RAM no matter how your Amiga is configured and this statement
  3489.     can be elaborated.  If you are running A64 on an Amiga 1000 we recommend at
  3490.     least 1mb of RAM.  If you are running A64 on an A500 or A2000 we recommend
  3491.     at least 1.5mb.  The reason for this difference is not because A64 will not
  3492.     run on A500s or A2000s with only 1mb, it's because A64 will run faster if
  3493.  
  3494.                                                                         5-4
  3495.  
  3496.  
  3497.  
  3498. -
  3499.  
  3500.  
  3501.  
  3502.     these machines have more than 1mb.  This is because A500's and A2000's with
  3503.     only 1mb do not have what is called FAST RAM.  This is RAM that can not be
  3504.     used by graphics and as a result programs run faster when using it.  We
  3505.     also recommend running the program "FastMemFirst," found in the System
  3506.     drawer of the V1.3 WorkBench, before running A64.  This program will force
  3507.     A64 (and other programs) to use this FASTer memory first.
  3508.  
  3509.  
  3510. 680x0 SUPPORT
  3511.  
  3512.     All of the programs in The A64 Package will work with any 680x0
  3513.     microprocessor.  They have been tested with the 68000, 68010, 68020 and
  3514.     68030 microprocessors.
  3515.  
  3516.     68020/30/40 users should note that to use The A64 Packages utility programs
  3517.     that directly use A64's hardware interface you must first turn off the
  3518.     microprocessor's cache before attempting to use the utilities (See Cache
  3519.     in the UTILITIES section).  Leaving the cache turned on will interfere with
  3520.     internal timing of the access to C64 devices causing your Amiga to lock up.
  3521.     Turning the cache off is only required for the utilities that directly use 
  3522.     A64's hardware interface and is not required when using A64 or any other
  3523.     utility.
  3524.  
  3525.  
  3526. A64 AND THE A3000
  3527.  
  3528.     We finally had the opportunity to test A64 on the A3000 and the results
  3529.     were not very good.  This release of A64 will NOT work correctly with the
  3530.     A3000.  A64 has problems with the new enhanced chip set and with the 32
  3531.     bit bus to CHIP RAM.  We do not see these problems as major and we should
  3532.     be able to overcome them in a future release.  Please note that these
  3533.     problems do not exist with other Amiga models using 68030 boards, these
  3534.     problems are specific to the A3000.
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541.  
  3542.  
  3543.  
  3544.  
  3545.  
  3546.  
  3547.  
  3548.  
  3549.  
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.                                                                         5-5
  3561.  
  3562.  
  3563.  
  3564. -
  3565.  
  3566.  
  3567.  
  3568. ROMS
  3569.  
  3570. WHAT IS ROM
  3571.  
  3572.     ROM is short for "READ ONLY MEMORY."  A ROM is a computer chip that is
  3573.     capable of storing a program and like its name implies, it is READ ONLY,
  3574.     which means you can not change the program it contains.  ROM unlike RAM
  3575.     (your computer's memory) does not loose its contents when your computer is
  3576.     turned off.  Computers usually come with ROM to tell it what to do when
  3577.     it's turned on.  Your Amiga uses a ROM called "KickStart."
  3578.  
  3579. THE C64's ROMS
  3580.  
  3581.     The C64 has two ROMs that contain its operating system.  One ROM holds the 
  3582.     C64's BASIC and the other ROM holds the C64's KERNAL.  A64 does not come
  3583.     with the C64's BASIC or KERNAL, because they are copyrighted.  Before you
  3584.     start worrying that A64 will not work without them, this is NOT the case.
  3585.     A64 contains a very complex C64 ROM emulation which allows A64 to run most
  3586.     C64 programs, without the C64's ROMs.
  3587.  
  3588. A64'S ROMS
  3589.  
  3590.     NOTE: This section of the manual gets a little technical by discussing
  3591.           machine language.  If you are not familiar with machine language you
  3592.           should still read this section and and try to follow it as best you
  3593.           can, it contains some important information about A64.
  3594.  
  3595.     As mentioned above, A64 comes with a very complex C64 ROM emulation, this
  3596.     ROM emulation will handle the majority of C64 programs, but not all of
  3597.     them.  To explain what A64's ROM emulation will and will not handle we need
  3598.     to discuss machine language.
  3599.  
  3600.     The C64's ROMs contain machine language programs.  Machine language
  3601.     programs are made up of opcodes.  Opcodes are machine language instructions
  3602.     that tell the computer to perform some tiny operation, like move a value
  3603.     from one place to another or perform some kind of operation to a value.  It
  3604.     takes many, many opcodes to perform even the simplest operations on your
  3605.     computer.  The C64's ROMs contain many thousands of these opcodes.  The
  3606.     C64's ROMs are located in the C64's memory map at 40960-49151 (BASIC) and
  3607.     57344-65535 (KERNAL), these numbers are called addresses.  To access the
  3608.     C64's ROMs and the opcodes they contain you need to JUMP to one of these
  3609.     addresses.  With BASIC this done with the command "SYS."
  3610.  
  3611.     For example, to reset the C64 (or A64), you can type the following:
  3612.  
  3613.        SYS 64738 [RETURN]
  3614.  
  3615.     This will cause the C64 (or A64) to enter the KERNAL ROM at address 64738
  3616.     and start executing machine language opcodes starting at that address.
  3617.  
  3618.     If you were to disassemble (a disassembler is a program that turns machine 
  3619.     language into a readable form) one of the C64's ROMs, you would get a
  3620.     listing similar to this:
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.                                                                         5-6
  3627.  
  3628.  
  3629.  
  3630. -
  3631.  
  3632.  
  3633.  
  3634.         40960   LDX #10
  3635.         40962    LDA #138
  3636.         40964    STA 1024
  3637.         40967    ...
  3638.  
  3639.     NOTE: This listing is only used as an example and is not part of the C64's
  3640.           ROMs.
  3641.  
  3642.     The listing shows ROM addresses followed by the opcode stored at each
  3643.     address.  Please note that the addresses are not perfectly consecutive,
  3644.     this is because different opcodes have different lengths.  If A64 was to
  3645.     JUMP into the ROMs, using the above example, it would handle JUMPING in at
  3646.     all of the shown addresses: 40960, 40962, 40964 and 40967.  The problem
  3647.     occurs if A64 tried to JUMP in at one of the addresses not shown, the
  3648.     addresses between opcodes.  Because of the way machine language is, it is
  3649.     possible for an opcode to have another opcode contained within it.  For
  3650.     example, if you disassembled the same code as above, but started at address
  3651.     40963, you would get a listing like this:
  3652.  
  3653.         40963    TXA
  3654.         40964    STA 1024
  3655.         40967    ...
  3656.  
  3657.     The opcode "TXA" at address 40963 is contained within the opcode "LDA #138"
  3658.     at address 40962.  This is what A64 will not handle, when emulating the
  3659.     C64's ROMs, the JUMPING into the ROMs between opcodes.  If you are running
  3660.     a program that tries to JUMP into the C64's ROMs between opcodes A64 will
  3661.     trap it and display an error requester telling you "PROGRAM TRYING TO
  3662.     EXECUTE BETWEEN OPCODES."  This problem is only apparent when JUMPING into
  3663.     the C64's ROMs between opcodes and is not a problem when running C64
  3664.     programs that use the same technique to JUMP within themselves.  This
  3665.     problem can be corrected by installing the C64's ROMs into A64.
  3666.  
  3667. INSTALLING THE C64 ROMS
  3668.  
  3669.     Installing the C64's ROMs into A64, basically involves saving the contents
  3670.     of the C64's ROMs (this must be done on a C64) to a C64 disk and then
  3671.     copying them to your A64 disk.  Installing the C64's ROMs into A64 is not
  3672.     difficult, but it does require a few small steps to accomplish.  Once the
  3673.     C64's ROMs are installed you never have to worry about them again.  A64
  3674.     will automatically load the C64's ROMs and use them whenever the above
  3675.     mentioned problem occurs.
  3676.  
  3677.     To install the C64 ROMs you need the following:
  3678.  
  3679.     A C64
  3680.     A C64 disk drive (i.e., 1541)
  3681.     A64's hardware interface
  3682.     A 5 1/4" disk, formatted on a C64, with at least 20k free
  3683.             (NOTE: You can format the C64 disk with the utility 64Cmd).
  3684.  
  3685.     and the following programs that are included with The A64 Package:
  3686.  
  3687.         SaveROMs
  3688.     AmigaTo64
  3689.     64ToAmiga
  3690.     StripLoadAddr
  3691.  
  3692.                                                                         5-7
  3693.  
  3694.  
  3695.  
  3696. -
  3697.  
  3698.  
  3699.  
  3700.     The following procedure outlines the installation of the C64 ROMs. Part of
  3701.     it has to be done on a C64 and the rest must be done from the CLI on an
  3702.     Amiga.  Your current directory from the CLI should be TheA64Package.
  3703.     For example, with the disk containing The A64 Package in drive 1, you
  3704.     should type:
  3705.  
  3706.         cd df1:TheA64Package
  3707.  
  3708.     The first thing you need to do is copy the C64 program "SaveROMs" from
  3709.     The A64 Package to a C64 disk.  This program is used to save the Commodore
  3710.     64's ROMs to a C64 disk.
  3711.  
  3712.         1. Install A64's hardware interface and connect a C64 disk drive to it
  3713.            (See INSTALLING A64'S HARDWARE INTERFACE in the GETTING STARTED
  3714.            section).
  3715.         2. With a C64 disk in the C64 drive, use the utility "AmigaTo64" to
  3716.            transfer the program "SaveROMs to the C64 disk.  To do this type the
  3717.            following from the CLI:
  3718.  
  3719.             A64Utilities/AmigaTo64 64Prgs/saveroms df8: [RETURN]
  3720.  
  3721.             (Note "saveroms" is in all lowercase letters)
  3722.  
  3723.     Now that the C64 program "SaveROMs" is on the C64 disk you need to load and
  3724.     run it on a C64:
  3725.  
  3726.         1. Either unplug the C64 disk drive from the interface or use another
  3727.            C64 disk drive and connect it to a C64.
  3728.         2. With the C64 disk containing the program "SaveROMs" in the C64 disk
  3729.            drive type the following on the C64:
  3730.  
  3731.             LOAD "SAVEROMS",8 [RETURN] 
  3732.  
  3733.         3. After the program is done loading type:
  3734.  
  3735.             RUN [RETURN]
  3736.  
  3737.         4. You will then be prompted to insert a disk into drive 8 and press
  3738.            any key when ready.
  3739.         5. After pressing any key the C64 ROMs will be saved to the C64 disk.
  3740.  
  3741.     Now that the C64's ROMs are saved to a C64 disk you need to transfer them
  3742.     to your disk containing The A64 Package.
  3743.  
  3744.         1. If you need to reconnect the C64 disk drive to your Amiga with A64's
  3745.            hardware interface, do so.
  3746.         2. With the program "64ToAmiga" transfer the files BASIC.rom and
  3747.            KERNAL.rom from the C64 disk to your disk containing The A64
  3748.            Package.  To do this type the following from the CLI:
  3749.  
  3750.             A64Utilities/64ToAmiga basic.rom BASIC.rom [RETURN]
  3751.  
  3752.             and then:
  3753.  
  3754.             A64Utilities/64ToAmiga kernal.rom KERNAL.rom [RETURN]
  3755.  
  3756.  
  3757.  
  3758.                                                                         5-8
  3759.  
  3760.  
  3761.  
  3762. -
  3763.  
  3764.  
  3765.  
  3766.         3. After the C64's ROMs are installed onto The A64 Package disk you
  3767.            must run "StripLoadAddr" on them before A64 can use them. To do this
  3768.            type the following from the CLI:
  3769.  
  3770.             A64Utilities/StripLoadAddr BASIC.rom [RETURN]
  3771.  
  3772.             and then:
  3773.  
  3774.             A64Utilities/StripLoadAddr KERNAL.rom [RETURN]
  3775.  
  3776.     The C64's ROMs are now installed.  A64 will automatically load and use them
  3777.     when needed.
  3778.  
  3779.     NOTES: If you are running A64 with 512k RAM, installing the C64's ROMs will
  3780.            replace A64's ROM emulation and save you about 135k of RAM, but will
  3781.            result in A64 running slower.  Because A64's ROM emulation operates
  3782.            much faster than the C64 ROMs do, A64 will try to use its ROM
  3783.            emulation whenever possible and if you are running A64 with 1mb or
  3784.            more, the C64's ROMs will only be used as a fail-safe when the above
  3785.            mentioned problem occurs.
  3786.  
  3787.            It is highly recommended that you install the C64's ROMs if you have
  3788.            access to a C64.  We have come across a few programs that won't run
  3789.            without the ROMs installed for reasons other than the in-between
  3790.            opcode problem described above.  You have to expect the lack of ROMs
  3791.            in the C64 memory map to create problems with some C64 programs.
  3792.            The C64's ROMs take up about 20% of the C64's total memory map,
  3793.            that's a big chunk of missing information.
  3794.  
  3795.  
  3796.  
  3797.  
  3798.  
  3799.  
  3800.  
  3801.  
  3802.  
  3803.  
  3804.  
  3805.  
  3806.  
  3807.  
  3808.  
  3809.  
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.  
  3816.  
  3817.  
  3818.  
  3819.  
  3820.  
  3821.  
  3822.  
  3823.  
  3824.                                                                         5-9
  3825.  
  3826.  
  3827.  
  3828. -
  3829.  
  3830.  
  3831.  
  3832. PROBLEMS AND SOLUTIONS
  3833.  
  3834.     I can't get programs in The A64 Package to recognize a C64 disk drive.
  3835.  
  3836.         First of all make sure the hardware interface is installed correctly
  3837.         (See INSTALLING A64'S HARDWARE INTERFACE in the GETTING STARTED
  3838.         section).  If you think the interface is installed correctly then try
  3839.         turning the disk drive of and then on again, this will reset the disk
  3840.         drive.  The C64 disk drives may need to be reset from time to time when
  3841.         running A64.  If you are running a C64 program that used copy
  3842.         protection you may have to reset the drive to clear it.
  3843.  
  3844.     When trying to load a C64 program the C64 disk drive light comes on but the
  3845.     program doesn't load and A64 appears to have locked up.
  3846.  
  3847.         The program you are trying to load may be using a technique called
  3848.         "FAST LOADING."  FAST LOADING is a technique used to to speed up
  3849.         communications with a C64 disk drive.  A64 can not handle FAST LOADING
  3850.         (See INCOMPATIBILITIES in the PROBLEMS and SOLUTIONS section).  If this
  3851.         situation occurs you will have to reset the C64 drive and then reset
  3852.         A64.
  3853.  
  3854.     I think my hardware interface is faulty.
  3855.  
  3856.         We have a VERY low failure rate with our hardware interfaces.  Usually
  3857.         when a problem occurs it is because of something not being done
  3858.         correctly or by trying to do something that A64 will not handle. If you
  3859.         think you're interface is bad you can run the program "64Status" to
  3860.         test it (See 64Status in the UTILITIES section).  If this program works
  3861.         as it's supposed to then your interface is not faulty and the problem
  3862.         lies somewhere else.  Please note that if the 64Status program doesn't
  3863.         work it is still possible that the interface is still not faulty.  We
  3864.         know of a couple of people who have "blown" their parallel port by
  3865.         plugging in the interface or some other piece of hardware with their
  3866.         Amiga turned on.  Before concluding that the interface is faulty you
  3867.         should try using some other piece of hardware on your Amiga's parallel
  3868.         port like a parallel printer or digitizer.  If they work, and the
  3869.         interface doesn't, then you probably do have a faulty interface.  You
  3870.         could also try to test the interface on someone elses Amiga.  If you
  3871.         do have a faulty interface we will replace it (See REPLACEMENTS on page
  3872.         2).
  3873.  
  3874.     When moving the mouse strange characters appear on the screen and the
  3875.     keyboard doesn't work.
  3876.  
  3877.         See GAME PORTS in the SYSTEM MENU section.
  3878.  
  3879.     When in A64 Prefs I can't read what's in the string gadgets.
  3880.  
  3881.         This is caused by the background color being the same color as the text
  3882.         in the string gadgets, which is black.  The text is there, but appears
  3883.         invisable.  To get around this problem you can use the colors screen
  3884.         to temporarily change the background color to some other color besides
  3885.         black (See COLORS in the GRAFIX MENU section).
  3886.  
  3887.     For more information on other possible problems see A64 PREFS NOTES in the
  3888.     A64 PREFS section.
  3889.  
  3890.                                                                         6-1
  3891.  
  3892.  
  3893.  
  3894. -
  3895.  
  3896.  
  3897.  
  3898. A64 ERRORS
  3899.  
  3900.     A64 has quite an extensive error handling system.  A64 does its best to
  3901.     tell you when it can't do something by displaying a requester.  These
  3902.     requesters are called error requesters and they display an error in three
  3903.     ways:
  3904.  
  3905.         1. At the top of the requester will be the type of error, either FATAL
  3906.            or NON-FATAL.  The meaning of each is as follows:
  3907.  
  3908.             FATAL ERRORs are just as the name implies, FATAL to A64.  If you
  3909.             get a fatal error this means that A64 has encountered some
  3910.             situation that will forbid it to continue and it will have to exit
  3911.             back to WorkBench.  After you handle the requester, by selecting
  3912.             one of its gadgets, a fatal error will force A64 to remove itself
  3913.             from memory and return you to the WorkBench.  Fatal errors usually
  3914.             occur only during the loading and initialization of A64.
  3915.  
  3916.             NON-FATAL ERRORs are a little more forgiving than FATAL errors.
  3917.             They signify that A64 has encountered some situation that it can
  3918.             not currently handle, but which is not serious enough to cause A64
  3919.             to exit back to the WorkBench.  After you handle the requester, by
  3920.             selecting one of its  gadgets, A64 will automatically leave you in
  3921.             A64 Prefs to try to correct the situation that caused the error.
  3922.             After being put into A64 Prefs your choice of action depends on
  3923.             what caused the error.  If you are unable to correct the situation
  3924.             that caused the error then you should reset A64 (See RESET A64 in
  3925.             the PROJECT MENU section).
  3926.  
  3927.         2. Following the type of error will be an eight digit error number.
  3928.            This error number is an error code that represents the exact cause
  3929.            and location of the error.
  3930.  
  3931.         3. In the middle of the requester will be one or two lines of text
  3932.            giving a short description of the error.
  3933.  
  3934.     At the bottom of the error requester are two gadgets, labeled CONTINUE and
  3935.     DEBUG.  Their functions are:
  3936.  
  3937.     CONTINUE will cause A64 to remove the requester.  You will then either
  3938.         be returned to WorkBench or put into A64 Prefs depending on the type of
  3939.         error (FATAL or NON-FATAL) discussed above.
  3940.  
  3941.     DEBUG will cause A64 to put up an Alert showing the internal state of
  3942.         A64 when the error occurred.  This information will probably not mean
  3943.         anything to you, but it can be invaluable to us for tracking down
  3944.         errors.  After viewing the information in the Alert press a mouse
  3945.         button to remove the Alert.  You will then either be returned to
  3946.         the WorkBench or put into A64 Prefs depending on the type of error
  3947.         (FATAL or NON-FATAL) discussed above.
  3948.  
  3949.         NOTE: In the appendices of this manual is an ERROR REPORT.  If you are
  3950.               experiencing problems with a particular C64 program, or if you
  3951.               encounter an error that is not in the error list, you can send us
  3952.               a copy of the ERROR REPORT containing the information displayed
  3953.               in the Alert.  We will try to correct as many errors as possible
  3954.               for future releases.    
  3955.  
  3956.                                                                         6-2
  3957.  
  3958.  
  3959.  
  3960. -
  3961.  
  3962.  
  3963.  
  3964. ERROR LIST
  3965.  
  3966.     The following list contains A64's possible errors.  The errors are shown by
  3967.     the error number followed by a line stating the error, which should be the
  3968.     same text that appears in the error requester.  Below the line stating the
  3969.     error is a short comment on what caused the error, how to correct it and
  3970.     what section of the manual to check for more information.
  3971.  
  3972.     Errors that state "Should NEVER happen" should never occur, but if they do
  3973.     the probable cause is that something has corrupted your Amiga's memory or
  3974.     that you are out of memory.
  3975.  
  3976.     The appearance of a "x" in an error number means, that digit of the error
  3977.     number will contain some unpredetermined value.  There may be a comment
  3978.     stating what the digit will be.
  3979.  
  3980.     Error numbers that start with 8 are FATAL errors.  All other errors are
  3981.     NON-FATAL.
  3982.  
  3983.     Multiple error numbers mean that the error can be generated in more than
  3984.     one place in A64.
  3985.  
  3986.  
  3987. $80000001    COULD NOT OPEN: DOS LIBRARY
  3988.         Should NEVER happen.
  3989.  
  3990. $80000002    COULD NOT OPEN: GRAPHICS LIBRARY
  3991.         Should NEVER happen.
  3992.  
  3993. $80000003    COULD NOT OPEN: DISKFONT LIBRARY
  3994.         Make sure the file diskfont.lib is in your WorkBench's Libs
  3995.         directory (See THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL
  3996.         section).
  3997.  
  3998. $80000004    COULD NOT OPEN: CIA A RESOURCE
  3999.         Should NEVER happen.
  4000.  
  4001. $80000005    COULD NOT OPEN: CIA B RESOURCE
  4002.         Should NEVER happen.
  4003.  
  4004. $80000006    COULD NOT OPEN: MISC RESOURCE
  4005.         Should NEVER happen.
  4006.  
  4007. $80000007    OUT OF MEMORY, COULD NOT ALLOCATE: C64 MEMORY MAP
  4008.         You do not have enough RAM available to run A64 (See A64 AND
  4009.         MEMORY in the TECHNICAL section).
  4010.  
  4011. $8f000108    COULD NOT OPEN OR READ: BASIC.DATA
  4012. $8f000208    Make sure the file BASIC.data is in the TheA64Package
  4013.         directory (See THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL
  4014.         section).
  4015.  
  4016. $8f000109    COULD NOT OPEN OR READ: KERNAL.DATA
  4017. $8f000209    Make sure the file KERNAL.data is in the TheA64Package
  4018.         directory (See THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL
  4019.         section).
  4020.  
  4021.  
  4022.                                                                         6-3
  4023.  
  4024.  
  4025.  
  4026. -
  4027.  
  4028.  
  4029.  
  4030. $8f00010a    COULD NOT OPEN OR READ: CHARROM.64FONT
  4031. $8f00020a     Make sure the file CharROM.64Font is in the 64Fonts directory
  4032.         (See THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL section).
  4033.  
  4034. $8000000b    OUT OF MEMORY, COULD NOT ALLOCATE: A64 ROM BUFFER
  4035.         You do not have enough RAM available to run A64 (See A64 AND
  4036.         MEMORY in the TECHNICAL section).  You may be able to correct
  4037.                 this error by installing the C64's ROMs (See INSTALLING THE
  4038.         C64's ROMs in the ROMs section).
  4039.  
  4040. $8f00010c    COULD NOT OPEN OR READ: ROM
  4041. $8f00020c    Make sure the file ROM is in the TheA64Package directory (See
  4042.         THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL section).
  4043.  
  4044. $8000000d    COULD NOT: INSTALL A64 ROMs
  4045.         This error should never occur, if it does something has
  4046.         probably corrupted the Amiga's memory.
  4047.  
  4048. $8000000f    YOU CAN NOT RUN TWO COPIES OF A64 SIMULTANEOUSLY
  4049.         A64 can not multitask itself (See A64 AND MULTITASKING in the
  4050.         TECHNICAL section).        
  4051.  
  4052. $80010000    OUT OF MEMORY, COULD NOT ALLOCATE: CHIP RAM 1
  4053.         You do not have enough RAM available to run A64 (See A64 AND
  4054.         MEMORY in the TECHNICAL section).
  4055.  
  4056. $80010001    OUT OF MEMORY, COULD NOT ALLOCATE: CHIP RAM 2
  4057.         You do not have enough RAM available to run A64 (See A64 AND
  4058.         MEMORY in the TECHNICAL section).
  4059.  
  4060. $80010002    OUT OF MEMORY, COULD NOT ALLOCATE: CHIP RAM 3
  4061.         You do not have enough RAM available to run A64 (See A64 AND
  4062.         MEMORY in the TECHNICAL section).
  4063.  
  4064. $8f010x03    COULD NOT OPEN OR READ: TITLE
  4065. $8f010x04    Make sure the file Title is in the TheA64Package directory (See
  4066. $8f010x05    THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL section).
  4067. $8f010x06    The "x" in the error number will be either 1 or 2.
  4068.  
  4069. $80010007    COULD NOT OPEN: TITLE SCREEN
  4070.         If this error occurs you are probably out of memory (See A64
  4071.         AND MEMORY in the TECHNICAL section).
  4072.  
  4073. $80010008    COULD NOT OPEN: TITLE WINDOW
  4074.         If this error occurs you are probably out of memory (See A64
  4075.         AND MEMORY in the TECHNICAL section).
  4076.  
  4077. $80010009    COULD NOT OPEN: A64 SCREEN
  4078.         If this error occurs you are probably out of memory (See A64
  4079.         AND MEMORY in the TECHNICAL section).
  4080.  
  4081. $8001000a    COULD NOT OPEN: A64 WINDOW
  4082.         If this error occurs you are probably out of memory (See A64
  4083.         AND MEMORY in the TECHNICAL section).
  4084.  
  4085.  
  4086.  
  4087.  
  4088.                                                                         6-4
  4089.  
  4090.  
  4091.  
  4092. -
  4093.  
  4094.  
  4095.  
  4096. $8001000b    COULD NOT OPEN: A64 6 FONT
  4097.         Make sure you have installed the font with InstallA64Font (See
  4098.         RUNNING A64 in the GETTING started section and InstallA64Font
  4099.         in the UTILITIES section).  If you still get this error after
  4100.         installing the font you are probably out of memory (See A64 AND
  4101.         MEMORY in the TECHNICAL section).
  4102.  
  4103. $8001000c    COULD NOT OPEN: TOPAZ 8 FONT
  4104.         Should NEVER happen.
  4105.  
  4106. $8f01010d    COULD NOT OPEN OR READ: LIC
  4107. $8f01020d    Make sure the file Lic is in the TheA64Package directory (See
  4108.         THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL section).
  4109.  
  4110. $00020000    COULD NOT OPEN: REQUESTER
  4111.         If this error occurs you are probably out of memory (See A64
  4112.         AND MEMORY in the TECHNICAL section).
  4113.  
  4114. $0f020102    COULD NOT OPEN OR READ: CONFIG FILE
  4115. $0f020202    The configuration file your trying to load can not be loaded.
  4116.         Check the spelling of the filename (See LOAD CONFIG in the
  4117.         PROJECT MENU section).  If this error occurs when A64 is
  4118.         loading then it can not read the file A64.config and you
  4119.         should make sure this file is in the TheA64Package directory
  4120.         (See THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL section).
  4121.  
  4122. $0f020103    COULD NOT OPEN OR WRITE: CONFIG FILE
  4123. $0f020303    For some reason A64 can not create the configuration file you
  4124.         requested.  Make sure you've specified the correct drive and
  4125.         that the disk is write enabled. (See SAVE CONFIG in the PROJECT
  4126.         MENU section)
  4127.  
  4128. $00030000    COULD NOT TAKE: PARALLEL PORT
  4129.         Some program has exclusive use of the Amiga's parallel port.
  4130.         You must make the program release the parallel port before A64
  4131.         can use it (See PAR PORT in the SYSTEM MENU section).
  4132.  
  4133. $00040000    A64 DOES NOT OWN THE PARALLEL PORT
  4134.         You are trying to access the parallel port when A64 does not
  4135.         own it.  Select A64 in PAR PORT menu option (See PAR PORT in
  4136.         the SYSTEM MENU section).
  4137.  
  4138. $00040001    ERROR TRYING TO WRITE TO AN AMIGA DEVICE
  4139. $00040002    Some problem has occurred when trying to write a file to an
  4140. $00040003    Amiga drive.  Make sure you've specified the correct drive and
  4141.         that the disk is write enabled. (See DRIVES and AMIGA DRIVES
  4142.         in the SYSTEM MENU section).
  4143.  
  4144. $00040004    ILLEGAL ACCESS TO AMIGA DEVICE CAN NOT USE COMMAND CHANNEL 15
  4145.         The C64 program you are running is trying to access a disk
  4146.         drive in a way that an Amiga drive can not handle (See AMIGA
  4147.         DRIVES in the SYSTEM MENU section).
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.                                                                         6-5
  4155.  
  4156.  
  4157.  
  4158. -
  4159.  
  4160.         
  4161.  
  4162. $00040005    ERROR TRYING TO SAVE TO AN AMIGA DEVICE
  4163. $00040006    Some problem has occurred when trying to save a file to an
  4164. $00040007    Amiga drive.  Make sure you've specified the correct drive and
  4165.         that the disk is write enabled. (See DRIVES and AMIGA DRIVES
  4166.         in the SYSTEM MENU section).
  4167.  
  4168. $00040008    ERROR TRYING TO LOAD FROM AN AMIGA DEVICE
  4169. $00040009    Some problem has occurred when trying to load a file from an
  4170. $0004000a    Amiga drive.  Check the spelling of the filename and the DRIVES
  4171.         settings (See DRIVES and AMIGA DRIVES in the SYSTEM MENU
  4172.         section).
  4173.  
  4174. $0004000b    ERROR TRYING TO READ FROM AN AMIGA DEVICE
  4175. $0004000c    Some problem has occurred when trying to read a file from an
  4176. $0004000d    Amiga drive.  Check the spelling of the filename and the DRIVES
  4177.         settings (See DRIVES and AMIGA DRIVES in the SYSTEM MENU
  4178.         section).
  4179.  
  4180. $80050000    COULD NOT OPEN: MSGPORT
  4181.         Should NEVER happen.
  4182.  
  4183. $80050001    COULD NOT OPEN: REPLY PORT
  4184.         Should NEVER happen.
  4185.  
  4186. $80050002    COULD NOT OPEN: INPUT DEVICE
  4187.         Should NEVER happen.
  4188.  
  4189. $80050003    COULD NOT: ADD IEHANDLER
  4190.         Should NEVER happen.
  4191.  
  4192. $80050004    COULD NOT: DOIO.
  4193.         Should NEVER happen.
  4194.  
  4195. $80060000    COULD NOT TAKE: CIA A: SERIAL DATA INTERRUPT
  4196.         You are running another program that is utilizing a low level
  4197.         function of your Amiga.  The other program must be exited
  4198.         before A64 will run (See A64 AND MULTITASKING in the TECHNICAL
  4199.            section).
  4200.  
  4201. $80060001    COULD NOT FREE: CIA A: SERIAL DATA INTERRUPT
  4202.         Should NEVER happen.
  4203.  
  4204. $80070000    COULD NOT TAKE: CIA B: TIMER B INTERRUPT
  4205.         You are running another program that is utilizing a low level
  4206.         function of your Amiga.  The other program must be exited
  4207.         before A64 will run (See A64 AND MULTITASKING in the TECHNICAL
  4208.            section).
  4209.  
  4210. $80080000    COULD NOT TAKE: CIA B: TOD INTERRUPT
  4211.         You are running another program that is utilizing a low level
  4212.         function of your Amiga.  The other program must be exited
  4213.         before A64 will run (See A64 AND MULTITASKING in the TECHNICAL
  4214.            section).
  4215.  
  4216. $80080001    COULD NOT FREE: CIA B: TOD INTERRUPT
  4217.         Should NEVER happen.
  4218.  
  4219.  
  4220.                                                                         6-6
  4221.  
  4222.  
  4223.  
  4224. -
  4225.  
  4226.  
  4227.  
  4228. $00080002    PROGRAM HAS OVER 25 RASTER IRQs
  4229.         A64 will support up to 25 raster IRQs per screen, this is the
  4230.         equivalent of 1500 interrupts per second and we've not yet come
  4231.         across a C64 program that utilizes anywhere near this many.  If
  4232.         you get this error we would like to hear about it.
  4233.  
  4234. $00080003    PROGRAM DOING UNIMPLEMENTED RASTER IRQ AT SCAN LINE 0
  4235.         A64 will handle raster IRQs at every scan line except 0.  This
  4236.         is because of a problem with the raster IRQ handler and will be
  4237.         fixed in a future version.
  4238.  
  4239. $00090000    COULD NOT TAKE: SERIAL PORT
  4240.         Some program has exclusive use of the Amiga's serial port.
  4241.         You must make the program release the serial port before A64
  4242.         can use it (See SER PORT in the SYSTEM MENU section).
  4243.  
  4244. $00090001    RS-232 ERROR: RECEIVE BUFFER OVERRUN
  4245.         A64 is not keeping up with the data coming in over the serial
  4246.         port. This has not been a problem so we have never seen this
  4247.         error.
  4248.  
  4249. $00090002    RS-232 ERROR: RECEIVE BUFFER FULL
  4250.         A64 is not keeping up with the data coming in over the serial
  4251.         port. This has not been a problem so we have never seen this
  4252.         error.
  4253.  
  4254. $000c0000    ILLEGAL VIC MODE:
  4255.         Should NEVER happen.
  4256.  
  4257. $000d0x01    BLITTER VSIZE ERROR: VSIZE = 0
  4258. $000d0x03    Should NEVER happen.  The "x" in the error number will be the
  4259. $000d0x05    number 1-6.
  4260.  
  4261. $000d0x02    BLITTER VSIZE ERROR: VSIZE > 8
  4262. $000d0x04    Should NEVER happen.  The "x" in the error number will be the
  4263. $000d0x06    number 1-6.
  4264.  
  4265. $000e0000    COULD NOT OPEN OR WRITE: IFF OUTPUT FILE
  4266. $000e0001    For some reason A64 could not create the IFF file you've
  4267.         requested.  Make sure you've entered the filename correctly
  4268.         (See SAVE SCREEN in the TOOLS MENU section).
  4269.  
  4270. $000e0002    OUT OF MEMORY, COULD NOT ALLOCATE: IFF FILE BUFFER
  4271.         A64 does not have enough memory to perform the operation (See
  4272.         A64 AND MEMORY in the TECHNICAL section).
  4273.  
  4274. $000f0000    A64 HARDWARE INTERFACE IS NOT INSTALLED
  4275.         A64's hardware interface is not connected to the Amiga.  You
  4276.         must connect it (See INSTALLING A64's HARDWARE INTERFACE in the
  4277.         GETTING STARTED section).
  4278.  
  4279. $00100000    OUT OF MEMORY, COULD NOT ALLOCATE: CHIP RAM
  4280.         A64 does not have enough memory to perform the operation (See
  4281.         A64 AND MEMORY in the TECHNICAL section).
  4282.  
  4283.  
  4284.  
  4285.  
  4286.                                                                         6-7
  4287.  
  4288.  
  4289.  
  4290. -
  4291.  
  4292.  
  4293.  
  4294. $00100001    COULD NOT OPEN: COLOR SCREEN
  4295.         If this error occurs you are probably out of memory (See A64
  4296.         AND MEMORY in the TECHNICAL section).
  4297.  
  4298. $00100002    COULD NOT OPEN: COLOR WINDOW
  4299.         If this error occurs you are probably out of memory (See A64
  4300.         AND MEMORY in the TECHNICAL section).
  4301.  
  4302. $xxxxxxxx    PROGRAM TRYING TO EXECUTE BETWEEN OPCODES AT PC: $xxxxxxxx
  4303.         The program is executing between opcodes.  This error can be
  4304.         corrected by installing the C64 ROMs (See ROMs in the TECHNICAL
  4305.         section).
  4306.  
  4307. $xxxxxxxx    UNKNOWN OPCODE: $xx AT PC: $xxxxxxxx
  4308.         A64 has encountered an unknown opcode.  This could be caused
  4309.         by either a C64 crash or A64 trying to execute certain
  4310.         unimplemented "undefined opcodes."  Many of the 6502's
  4311.         undefined opcodes have been supported, but we lack good
  4312.         documentation on them, so when in doubt we left it out. If
  4313.         anyone out there has any documentation on the 6502's undefined
  4314.         opcodes we would greatly appreciate getting a copy so we could
  4315.         fully implement the 6502's undefined opcodes.
  4316.  
  4317. $xxxxxxxx    PC ERROR
  4318.         A64 is trying to execute at an illegal C64 address. The only
  4319.         way we know of this error occurring is if a C64 program tries to
  4320.         execute in the CHAR ROM area, a very unlikely occurrence, but
  4321.         we have learned that if something is possible on a C64, someone
  4322.         has done it. If you encounter this error we would like to hear
  4323.         about it.
  4324.  
  4325.  
  4326.  
  4327.  
  4328.  
  4329.  
  4330.  
  4331.  
  4332.  
  4333.  
  4334.  
  4335.  
  4336.  
  4337.  
  4338.  
  4339.  
  4340.  
  4341.  
  4342.  
  4343.  
  4344.  
  4345.  
  4346.  
  4347.  
  4348.  
  4349.  
  4350.  
  4351.  
  4352.                                                                         6-8
  4353.  
  4354.  
  4355.  
  4356. -
  4357.  
  4358.  
  4359.  
  4360. INCOMPATIBILITIES
  4361.  
  4362.     Alot of time has been spent trying to make A64 as compatible as possible.
  4363.     Unfortunately the only way to get 100% compatibility with a C64 is to use a
  4364.     C64.  Listed below are the things that A64 does not currently handle or has
  4365.     problems with.
  4366.  
  4367. FAST LOADERS
  4368.  
  4369.     The biggest problem with compatibility is related to disk I/O.  We all know
  4370.     how slow the 1541 disk drive is and alot of software manufactures try to
  4371.     correct this problem by writing custom disk drive routines, called FAST
  4372.     LOADERS, to load and save programs faster than the normal rate.  These
  4373.     routines are VERY time critical and must be run at 100% speed, with no
  4374.     interruptions, to function properly.  Also these routines vary from program
  4375.     to program.  A FAST LOADER that works with one program will not work with 
  4376.     another.  The only way to emulate these routines is to write a custom
  4377.     loader for each program that utilizes a FAST LOADER.  Seeing how there are
  4378.     literally hundreds of FAST LOADER programs out there it would be nearly
  4379.     impossible to emulate all of them.
  4380.  
  4381.     There is no way to tell if a program uses a FAST LOADER until you try to
  4382.     load it.  The most likely result of trying to load a program that uses one
  4383.     is the C64 program will stop and disk drive motor and or light will stay
  4384.     on.  If this happen you must reset both A64 and the disk drive to abort
  4385.     the operation (See RESET A64 in the PROJECT MENU section).
  4386.  
  4387.     Future revisions of A64 may emulate some FAST LOADERS. If you have a
  4388.     program that uses a FAST LOADER and you would like to see A64 run it, put
  4389.     the name of it on the registration form or write us a letter.  We will
  4390.     spend the time working on the must requested programs.
  4391.  
  4392. CASSETTE PORT, USER PORT and CARTRIDGE PORT
  4393.  
  4394.     Seeing how the cassette, user and cartridge ports are not present on the
  4395.     Amiga they are not supported by A64.  There is an exception to this in that
  4396.     Amiga modems are supported where C64 modems are normally connected to the
  4397.     C64 user port (See MODEMS in the SYSTEM MENU section).  Also cartridge
  4398.     programs that have been converted to run from disk should work.
  4399.  
  4400. SPRITES
  4401.  
  4402.     A64's VIC chip (graphics) emulation is the most complex aspect of A64.  It
  4403.     provides such features as: rock steady raster IRQ's at every scan line and
  4404.     spaced as close as 1 scan line apart (something a C64 sometimes has
  4405.     problems doing), up to 25 rasters IRQs per screen with each one using its
  4406.     own graphics mode, VIC bank etc.  Our VIC chip emulation even emulates
  4407.     sprites in the borders which is actually a bug in the real VIC chip.
  4408.     Unfortunately the VIC chip emulation does have its problems.  Mainly
  4409.     sprites!  The C64's sprites and the Amiga's sprites are about as compatible
  4410.     as fire and water.  Trying to get Amiga sprites to behave like C64 sprites
  4411.     is not an easy feat.  One of the biggest problems that you will notice
  4412.     almost immediately is that the sprites will flicker.  Because of size
  4413.     differences between Amiga and C64 sprites there are not enough Amiga
  4414.     sprites to emulate all of the C64's sprites at one time.  Because of this
  4415.     Amiga sprites need to be re-used, causing the flicker.  The more C64
  4416.     sprites that are used and if they are expanded horizontally the worse the
  4417.  
  4418.                                                                         6-9
  4419.  
  4420.  
  4421.  
  4422. -
  4423.  
  4424.  
  4425.  
  4426.     flickering gets.  There is no way around this problem and there will always
  4427.     be some flickering in the sprites.  There are also other problems created
  4428.     because of incompatibilities between Amiga sprites and C64 sprites.  Sprite
  4429.     collisions and sprite priorities are not 100% compatible.  Also in V1.01n
  4430.     sprite re-use in raster IRQs is not supported.  Most of the problems with
  4431.     emulating C64 sprites are caused by restrictions in the Amiga's hardware.
  4432.     It's hard to believe, but there are some things a C64 can do that an Amiga
  4433.     can't.  We do have some ideas on how to improve the sprite emulation and
  4434.     reduce the flickering and hopefully they will be added in a future release. 
  4435.  
  4436.  
  4437.  
  4438.  
  4439.  
  4440.  
  4441.  
  4442.  
  4443.  
  4444.  
  4445.  
  4446.  
  4447.  
  4448.  
  4449.  
  4450.  
  4451.  
  4452.  
  4453.  
  4454.  
  4455.  
  4456.  
  4457.  
  4458.  
  4459.  
  4460.  
  4461.  
  4462.  
  4463.  
  4464.  
  4465.  
  4466.  
  4467.  
  4468.  
  4469.  
  4470.  
  4471.  
  4472.  
  4473.  
  4474.  
  4475.  
  4476.  
  4477.  
  4478.  
  4479.  
  4480.  
  4481.  
  4482.  
  4483.  
  4484.                                                                         6-10
  4485.  
  4486.  
  4487.  
  4488. -
  4489.  
  4490.  
  4491.  
  4492. KNOWN BUGS
  4493.  
  4494.  
  4495. PAR PORT BUG
  4496.  
  4497.     Although we have painstakingly tried to make A64 bug free, a bug turned up
  4498.     during testing and was not corrected in time for this release.  This bug is
  4499.     easily avoided and we do plan on trying to correct it in a future release.
  4500.     We hope no other bugs have escaped our attention, but if you do come across
  4501.     one, please let us know so that we can try to correct it.
  4502.  
  4503.     The bug involves the PAR PORT menu option in the SYSTEM menu.  When this
  4504.     option is set to A64 and you try to access the parallel port from another
  4505.     program a GURU MEDITATION error will occur.  This bug seems to be in the
  4506.     Amiga's parallel device handler.  It appears that the parallel device
  4507.     handler is not doing the correct error handling when the parallel port is
  4508.     not available for use.  The way to avoid this bug is whenever you want to
  4509.     access the parallel port from another program besides A64 make sure the PAR
  4510.     PORT menu option is set to AMIGA.
  4511.  
  4512.     NOTE: This bug is not present for the serial port.
  4513.  
  4514.  
  4515. SCREEN SHIFTED BUG
  4516.  
  4517.     It was brought to our attention that on certain Amiga models, namely the
  4518.     A2500, the A64 screen appears shifted to the right.  This problem is
  4519.     apparent when in A64 and on the Title and About screens and is not
  4520.     apparent when in A64 Prefs.  You can spot this problem if the A64 screen
  4521.     appears shifted noticeably to the right and is not centered on your monitor
  4522.     and then when you enter A64 Prefs the C64 screens jumps to the left and
  4523.     centers itself.  This problem appears to be caused by differences in the
  4524.     Amiga's custom chips on different Amiga models and is more of a visual
  4525.     nuisance than anything else.  There is one instance when this problem can
  4526.     cause you to think A64 has crashed when it hasn't.  When viewing the About
  4527.     screen with this problem the OK gadget will appear not to function
  4528.     correctly.  This is caused by the entire screen being shifted to the right.
  4529.     If you click the right mouse button just to the left of the OK gadget, it
  4530.     will select the OK gadget and remove the About screen.  We are working on
  4531.     correcting this problem and hopefully it will be fixed in a future version.
  4532.  
  4533.  
  4534.  
  4535.  
  4536.  
  4537.  
  4538.  
  4539.  
  4540.  
  4541.  
  4542.  
  4543.  
  4544.  
  4545.  
  4546.  
  4547.  
  4548.  
  4549.  
  4550.                                                                         6-11
  4551.  
  4552.  
  4553.  
  4554. -
  4555.  
  4556.  
  4557.  
  4558. WHAT IS IN THE FUTURE
  4559.  
  4560.     We can just about guarantee at least one more revision of The A64 Package,
  4561.     there has been just too much work already done, on other features, not to
  4562.     update it.  As far as, when The A64 Package will be updated and how many
  4563.     new features are added, depends on how many people support The A64 Package,
  4564.     by sending in the license fee.  The more response we get, the more willing
  4565.     we'll be to spend the time adding new features and to get new versions of
  4566.     The A64 Package out there.
  4567.  
  4568.     The features that have been worked on (or at least given some serious
  4569.     consideration), that didn't make it into this release of The A64 Package,
  4570.     are almost too numerous to mention.  We have put together a list of some of
  4571.     the more important features that we would like to add to future versions.
  4572.     If you have any suggestions or comments about new features, we would like
  4573.     to hear about them, put them on the registration form when sending in the
  4574.     license fee.
  4575.  
  4576.         SOUND: We realize that many of you think sound support is VERY
  4577.         important and so do we.  We have a very talented programmer working
  4578.         solely on sound support and he has made excellent progress with this
  4579.         complex programming task.  He will complete the sound support in the
  4580.         very near future and it should be included with the next major release.
  4581.  
  4582.         A64MON: A64Mon is an Amiga based, C64 system monitor. A64Mon is a
  4583.         powerful C64 debugging and hacking tool, it gives you the ability to
  4584.         stop any C64 program, that A64 is running, and examine its internals.
  4585.         A64Mon is an Amiga program, so it runs totally transparent to the C64
  4586.         program that A64 is running, there is no stopping it from working.
  4587.         A64Mon has numerous features and commands that make "monitoring" a C64
  4588.         program a snap.  Some of its features include: PetASCII dump,
  4589.         disassembler, chip dumps, hex dump, edit memory, saving from and
  4590.         loading to the C64's memory map, all command output can be sent to
  4591.         Amiga disks or printers and it's all done in the Amiga environment.
  4592.         A64Mon was used extensively during the development of A64 and we found
  4593.         it an invaluable tool for finding out "What is the C64 program doing?"
  4594.         A64Mon is about 80% completed and it should be included with the next
  4595.         major release.
  4596.  
  4597.         AMIGA PRINTERS: A64 will have the ability to use Amiga printers in the
  4598.         same way it's able to use Amiga drives.
  4599.  
  4600.         AMIGA DRIVES: While the Amiga drive support is fully functional, it can
  4601.         be improved. Some of the drawbacks of Amiga drives are outlined in the
  4602.         AMIGA DRIVES section.
  4603.  
  4604.         C64 DEVICES: This one is a big one.  The A64 Package comes with some
  4605.         utility programs that allow you to transfer C64 programs to and from
  4606.         Amiga disks.  The key to these utilities is the ability to access C64
  4607.         devices directly from AmigaDOS.  By using this ability several other
  4608.         programs can be developed, like: a full featured, Amiga based, file
  4609.         transfer program and device drivers to use C64 disk drives and printers
  4610.         as Amiga devices so they can be used with ANY Amiga program.  Quite a
  4611.         bit of work has already been done in this area, but to fully develop
  4612.         these features, The A64 Package needs alot of support.
  4613.  
  4614.  
  4615.  
  4616.                                                                         7-1
  4617.  
  4618.  
  4619.  
  4620. -
  4621.  
  4622.  
  4623.  
  4624.         MODEMS: Amiga modem support is still in development and should be
  4625.         completed by the next release.
  4626.  
  4627.         INPUT DEVICES: A64 will support more C64 input devices, like paddles
  4628.         and C64 mice.  We have also considered using the Amiga's mouse to
  4629.         emulate certain C64 input devices.
  4630.  
  4631.         FAST LOADERS: We would like to support some FAST LOADERS in the future.
  4632.         A couple that we've considered are: GEOS and ISEPIC.  Let us know if
  4633.         you have others in mind.
  4634.  
  4635.         FILE REQUESTERS: Full featured file requesters in A64 Prefs.
  4636.  
  4637.         A64 PREFS SETTINGS: A64 Prefs will have more settings that allow you to
  4638.         to fine tune A64 to run a C64 program.  A64 was designed to be able to
  4639.         do many things at variable rates; like redraw the screen, handle C64
  4640.         interrupts and other things that effect the speed of A64.  In the
  4641.         future A64 Prefs will give you the ability to change these settings to
  4642.         help A64 to run faster (NOTE: Some of these were added in V1.01n).
  4643.  
  4644.         COLOR SCREEN: The A64 COLORS' screen is still in development and when
  4645.         it's  completed it will have many new features, like: UNDO, COPY, SWAP,
  4646.         SPREAD, etc.  It should be noted that the COLORS' screen is fully
  4647.         functional as is and should not contain any bugs.
  4648.  
  4649.         SPRITES: A64 fully supports the C64's sprites, but work can be done in
  4650.         a number of areas concerning them, especially their flickering.
  4651.  
  4652.         FONTS: A64 will have the ability to change, load and save C64 fonts and
  4653.         maybe the ability to convert C64 fonts to Amiga fonts.
  4654.  
  4655.         And the list could go on and on...
  4656.  
  4657.     NOTE:  Even if this list already contains the features that YOU would like
  4658.            to see added to The A64 Package, you should still let us know what
  4659.            they are.  This will help us to decide what features are more
  4660.            important to add first. 
  4661.  
  4662.  
  4663.  
  4664.  
  4665.  
  4666.  
  4667.  
  4668.  
  4669.  
  4670.  
  4671.  
  4672.  
  4673.  
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681.  
  4682.                                                                         7-2
  4683.  
  4684.  
  4685.  
  4686. -
  4687.  
  4688.  
  4689.  
  4690. VERSION CHANGES
  4691.  
  4692.  
  4693. V1.01n
  4694.  
  4695.     The changes in V1.01n from V1.00n are not major, basically the main
  4696.     difference between the two versions is that V1.01n now supports other 680x0
  4697.     microprocessors.  This version was not planned, but the majority of the
  4698.     people ordering the hardware interface requested either 68010, 68020 or
  4699.     68030 support so we felt an upgrade was needed immediately.  We are
  4700.     working on the next release which will probably be called V1.1.  In the
  4701.     next release we hope to add many of the features listed in the WHAT IS IN
  4702.     THE FUTURE section as well as some other features that have been brought
  4703.     to our attention by registered owners.  Remember fill out the registration
  4704.     form completely, we value your opinion and suggestions.
  4705.  
  4706.     Listed below is an outline of the major changes in V1.01n:
  4707.  
  4708.         1. A64 now works with other microprocessors.  It has been tested with
  4709.            the 68000, 68010, 68020 and 68030.
  4710.  
  4711.         2. The Cache utility was added.
  4712.  
  4713.         3. The Screen Refresh menu item was replaced with the Screen Refresh
  4714.            requester.
  4715.  
  4716.         4. The Rasters requester was added.
  4717.  
  4718.  
  4719.  
  4720.  
  4721.  
  4722.  
  4723.  
  4724.  
  4725.  
  4726.  
  4727.  
  4728.  
  4729.  
  4730.  
  4731.  
  4732.  
  4733.  
  4734.  
  4735.  
  4736.  
  4737.  
  4738.  
  4739.  
  4740.  
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.                                                                         8-1
  4749.  
  4750.  
  4751.  
  4752. -
  4753.  
  4754.  
  4755.  
  4756. ERROR REPORT
  4757.  
  4758.     We have supplied an ERROR REPORT that you can send to us if you are
  4759.     experiencing difficulties with running a certain C64 program on A64.  This
  4760.     error report will help us to track down problems more easily and to get
  4761.     better revisions of A64 out quickly.  We realize that the majority of the
  4762.     people using A64 will not use these error reports, but if some of you do it
  4763.     will make our job a little easier.  If it is possible, you may also send us
  4764.     a copy of the program that caused the problems.  We realize that it is not
  4765.     practical to expect anyone to do this, but if some of you do it could save
  4766.     us a great deal of time by eliminating the need to track down the program.
  4767.     Please note that QuesTronix does not endorse copyright infringement and you
  4768.     should note a programs copyright status before sending it to us.
  4769.  
  4770.  
  4771.  
  4772.  
  4773.  
  4774.  
  4775.  
  4776.  
  4777.  
  4778.  
  4779.  
  4780.  
  4781.  
  4782.  
  4783.  
  4784.  
  4785.  
  4786.  
  4787.  
  4788.  
  4789.  
  4790.  
  4791.  
  4792.  
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.  
  4799.  
  4800.  
  4801.  
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.  
  4814.                                                                           A
  4815.  
  4816.  
  4817.  
  4818. -
  4819.  
  4820. A64 ERROR REPORT                  A64 VERSION ___________________
  4821.                               (from title screen)
  4822.  
  4823. C64 PROGRAM NAME _______________________________________ VERSION ____________
  4824.  
  4825. MANUFACTURER ________________________________________________________________
  4826.  
  4827. TYPE OF PROGRAM:   GAME ___ GRAPHICS ___ UTILITIES ___ SOUND ___ BUSINESS ___ 
  4828.  
  4829.                    EDUCATION ___ OTHER (Specify) ____________________________
  4830.  
  4831. WHAT AMIGA MODEL ARE YOU USING ______________________________________________
  4832.  
  4833. HOW IS YOUR AMIGA CONFIGURED (Ex. RAM, Special boards, hard disk) ___________
  4834.  
  4835. _____________________________________________________________________________
  4836.  
  4837.  
  4838. FILL IN THE FOLLOWING INFORMATION IF APPLICABLE (It is obtained by selecting
  4839.    DEBUG when an error requester occurs).
  4840.  
  4841. INTERNAL ERROR #: $____________
  4842.  
  4843. D0: $____________   D1: $____________   D2: $____________   D3: $____________
  4844.  
  4845. D4: $____________   D5: $____________   D6: $____________   D7: $____________
  4846.  
  4847. A0: $____________   A1: $____________   A2: $____________   A3: $____________
  4848.  
  4849. A4: $____________   A5: $____________   A6: $____________   A7: $____________
  4850.  
  4851. PC: $____________   SR: $____________
  4852.  
  4853.  
  4854. PLEASE GIVE A DESCRIPTION OF THE PROBLEM (Be as specific as possible) _______
  4855.  
  4856. _____________________________________________________________________________
  4857.  
  4858. _____________________________________________________________________________
  4859.  
  4860. _____________________________________________________________________________
  4861.  
  4862. _____________________________________________________________________________
  4863.  
  4864. _____________________________________________________________________________
  4865.  
  4866. _____________________________________________________________________________
  4867.  
  4868. _____________________________________________________________________________
  4869.  
  4870. _____________________________________________________________________________
  4871.  
  4872. _____________________________________________________________________________
  4873.  
  4874. _____________________________________________________________________________
  4875.  
  4876. _____________________________________________________________________________
  4877.  
  4878. _____________________________________________________________________________
  4879.  
  4880. _____________________________________________________________________________
  4881.  
  4882.      (Please use a separate ERROR REPORT for each C64 program).
  4883.  
  4884. -
  4885.