home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / workbench / coppertoy2 / coppertoy2.doc < prev    next >
Text File  |  1995-02-27  |  4KB  |  122 lines
  1.                  []------------------------------------------[]
  2.                   |                                          |
  3.                   |  CopperToy 2.0  Released in May of 1992  |
  4.                   |       From the coders at Epsilon!        |
  5.                   |          Steve "SubZero" Frank           |
  6.                   |           Jesse "Haze" Michael           |
  7.                   |       Ian "Dancing Fool" Romanick        |
  8.                   |                                          |
  9.                  []------------------------------------------[]
  10.  
  11. What is "CopperToy"?
  12.  
  13. CopperToy is the utility that allows programmers to create raster bars very
  14. easily! It allows you to save, load, and edit copper lists with a variety of
  15. tools.
  16.  
  17. Edit
  18. ~~~~
  19.      -> :      By pressing the right arrow the red, green, and blue values
  20.             will be incremented by one.
  21.  
  22.      <- :    By pressing the left arrow the red, green, and blue values will
  23.         be decremented by one.
  24.  
  25.      F1 :    Pressing F1 will increment the red value.
  26.  
  27.      F2 :    F2 causes the red value to be decremented.
  28.  
  29.       F3,F4 :    Works just like the F1, F2 pair, but for the green value.
  30.  
  31.       F5,F6 :    Just like F1 and F2, but for the blue value.
  32.  
  33.        <SP> :    Pressing the <SPACE> bar, or the left mouse button, causes the
  34.         raster that the mouse points at to be made the current color.
  35.  
  36.     RMB :    Pressing the right mouse button causes the current raster to be
  37.         set to black. ($0000)
  38.  
  39.       Up,Dn :    Pressing the up or down arrows causes the pointer to move up or
  40.                 down, respectively.
  41.  
  42.       C :    Pressing 'C' causes the current copper list to be cleared
  43.         totally!
  44.     
  45.       E :    The 'E' key causes you to exit the program.
  46.  
  47. Save
  48. ~~~~
  49.     When you press 'S' you will be returned to the WorkBench screen and
  50.     presented with a file requester.  Select the path/file where you want
  51.     your copper list to be saved.  After that you will be asked which color
  52.     register you want your list saved in.  (For programmers intending to
  53.         use the copper lists in their assembler programs, color 0 refers to 
  54.         hardware register $180, color 1 refers to $182, etc.) 
  55.         For programmer's reference, the copper lists are stored in the
  56.         following format:
  57.  
  58.             <beam position> ,$fffe
  59.             <selected color>,<color>
  60.             <beam position> ,$fffe
  61.             <selected color>,<color>
  62.             etc.
  63.  
  64.     Note:  The list DOES NOT end with a $fffffffe (end of c-list),
  65.         therefore you must supply your own.  The file is binary.
  66.  
  67. Load
  68. ~~~~
  69.     The 'L' activates a file requester that prompts you for the name of the
  70.     file you wish to load.
  71.  
  72. Special Notes
  73. ~~~~~~~~~~~~~
  74.     Under the current release of CopperToy you must have both the reqtools
  75.     library (V37) and the explode library (V6) in your libs: directory.
  76.  
  77.     CopperToy MAY CRASH if you perform disk i/o (save/load) and attempt
  78.     repeated i/o (save/load again) without giving it enough time to finish
  79.     the first.
  80.  
  81. Distribution
  82. ~~~~~~~~~~~~
  83.     This software is freely distributable so long as the archive remains
  84.     complete.  The acrhive should contain the following:
  85.  
  86.             CopperToy2.0
  87.             CopperToy2.DOC
  88.             HISTORY
  89.             Example1.COP
  90.             Example2.COP
  91.             libs/reqtools.library
  92.             libs/explode.library
  93.  
  94.     CopperToy 2.0 is shareware, so if you like it send us $5 and we will
  95.     send you any new revisions as they are made.  The programmers may be
  96.     contaced on the following boards:
  97.  
  98.             Key 880 - The BBS for the Amiga Programmer
  99.             (503)524-0670 (2400B, 8N1)
  100.  
  101.             Disk Jockey - The World Release HQ For Epsilon
  102.             (503)636-4947 (2400B, 8N1)
  103.             (503)697-4303 (9600B, V32)
  104.             (503)697-4304 (9600B, HST)
  105.  
  106.     Or on Internet at:
  107.  
  108.             SubZero      - stevenf@cryo.raim.com
  109.             Dancing Fool - idr@rigel.cs.pdx.edu
  110.             Haze         - jmichael@pdaxes.techbook.com
  111.  
  112.     Or VIA U.S. (snail) mail at:
  113.  
  114.             Epsilon
  115.             c/o Israel Hsu
  116.             7040 S.W. Gable Park Rd.
  117.             Portland, OR
  118.                 97225
  119.             U.S.A
  120.  
  121.     We hope you enjoy our program.
  122.