home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / gfx / coppercontrol-1.0.lha / CopperControl-1.0 / CC-ED.doc < prev    next >
Text File  |  1993-11-29  |  38KB  |  812 lines

  1.  
  2. _______________________________________________________________________________
  3. -------------------------------------------------------------------------------
  4.     ____ ____ ____ ____ ____ ____    ____ ____ __  __ _____ ____  ____ __    
  5.    /\___\\___\\___\\___\\___\\___\  /\___\\___\\_\/\_\\____\\___\ \___\\_\   
  6.   / / __//   // _ // _ // __//__ / / / __//   //  \/ //_  _//__ / /   // /_  
  7.  / / /\ / / // __// __// __//   / / / /\ / / // /\  // / / /   / / / // /__\ 
  8.  \/___//___//_/ \/_/ \/___//_/\_\ \/___//___//_/\/_/ \/_/\/_/\_\/___//_____/ 
  9.  
  10.                -=*  THE EDITOR  *=-
  11. _______________________________________________________________________________
  12. -------------------------------------------------------------------------------
  13.  
  14.          Version 1.0, Every OS compatible (tested on 1.3, 2.0+, 3.0)
  15.  
  16.                       SHAREWARE ©1993 by Nadir Boussoukaia
  17.  
  18.  
  19.  
  20.                   >>>  AUTHOR  <<<             >>>  DISTRIBUTOR  <<<
  21.  Write to:  /--------------------------\   /----------------------------\
  22.             |     Nadir Boussoukaia    |   |        SILICONE-DP         |
  23.             |   1 Rue Des Romanesques  |   |     5 Bld des Arceaux      |
  24.             | 13015 Marseille (France) |   | 34000 Montpellier (France) |
  25.             \--------------------------/   \----------------------------/
  26.              ---> comments/Hellos           ---> Purchasing the program:
  27.                  suggestions/Bugs report        30 French Francs per disk
  28.                  Demos swapping                 (compensed shareware).
  29.  
  30.  
  31.  
  32.         ==================================================
  33.          ANY SERIOUS JOB PROPOSITION IS WARMLY WELCOMED.
  34.         ==================================================
  35.  
  36. -------------------------------------------------------------------------------
  37. Introduction
  38. -------------------------------------------------------------------------------
  39. Copper Control Editor (Let's call it CC-ED) is a general purpose copperlist
  40. editor, with practically no limitation (ie more than one color per rasterline
  41. allowed). With it you can edit and save copperlists for your machine-code
  42. programs or anything like. 
  43.  
  44. Another interesting feature is that you can save copperlists for Copper
  45. Control: That small program (3844 bytes) gives you the possibility to use your
  46. own copperlist instead of ANY NUMBER of colors, in any Intuition Screen, like
  47. Workbench screen for example. See other doc.
  48.  
  49. CC-ED offers a user friendly DeluxePaint style editor, with a lot of features
  50. originals for this kind of program (like UNDO).
  51. It has been made in the optics of a total simplicity and functionality in use,
  52. in order that non-specialists could use it with no headaches ( You will find NO
  53. esoteric function or message !).
  54. However, it enforces no restrictions, so coders can use it and have at their
  55. disposal practically all COPPER possibilities.
  56.  
  57. A French or German version could be available.
  58.  
  59. Features
  60. --------
  61. - Copper Control done in short & fast assembly
  62. - The editor CC-ED done in AMOS 1.3 (maybe a 2.0 version in C)
  63. - Intuitive interface (Hope so!)
  64. - You can choose the color register of the copperlist
  65. - More than one color per line possible (every 8 pixels)
  66. - Possibility of multi-color register copperlists
  67. - Copperlists also saved as RAW or ASCII files for coders
  68. - Colors tables generated as RAW and ASCII files too
  69.  
  70. Non-Features
  71. ------------
  72. - AGA support (not yet ?) 
  73. - 100% bug free ! (let's talk only 99%...)
  74.  
  75. -------------------------------------------------------------------------------
  76. Disclaimer
  77. -------------------------------------------------------------------------------
  78. THIS PROGRAM IS PROVIDED ON AN `AS IS' BASIS, NO WARRANTIES ARE MADE, EITHER
  79. EXPRESSED OR IMPLIED. SO THE AUTHOR DOES NOT ASSUME ANY RESPONSIBILITY OR
  80. LIABILITY, AND ALL USE OF THIS PROGRAM IS AT YOUR OWN RISK.
  81.  
  82. -------------------------------------------------------------------------------
  83. Distribution & ShareWare Donation
  84. -------------------------------------------------------------------------------
  85. This product is SHAREWARE: Using it assumes that you have already payed the
  86. small CONTRIBUTION FEE of 30 French Francs (about 6$). Otherwise, it has been
  87. fixed very low, so you have no excuse: You should do it now (You'll find the
  88. distributor's adress at the beginning of text).
  89.  
  90. After that, You could use it like you want, including in commercial
  91. productions, with reserve that it's not the principal object.
  92.  
  93. The future of this product depends on you. If you support me I'll continue
  94. working on it and improve it. I have also some other projects in mind.
  95. But everything depends on my moral...   And my moral depends on my wallet.
  96.  
  97. -------------------------------------------------------------------------------
  98. Installation 
  99. -------------------------------------------------------------------------------
  100. Copper Control Editor may be placed anywhere you want.
  101. It looks for an optionnal configuration file in current directory (in Workbench
  102. this will be the same directory than CC-ED) or in S:
  103. Note that This file is OPTIONNALLY needed. CC-ED needs no file, except for one
  104. library: I removed the use of `Mathtrans.Library', but I wasn't able to remove
  105. the use of `Diskfont.Library'. Though I only set ROM fonts, AMOS uses this
  106. library. So it must be in your LIBS:
  107.  
  108. CC-ED has been compiled for Workbench, but It can be run either from CLI or
  109. Workbench. From CLI you should use a `Run >NIL:' to keep hand.
  110.  
  111. -------------------------------------------------------------------------------
  112. Using Copper Control Editor
  113. -------------------------------------------------------------------------------
  114. Preliminary: I call `Color Register' one of the 32 memory cells used to stock
  115.              colors of the palette.
  116.  
  117. Once program loaded, you can see on your screen:
  118.  - A pannel with quite a lot of gadgets,
  119.  - A cursor composed with two sprites on the left black screen,
  120.  - Your beautiful pinky mousepointer.
  121.  
  122. You can move the cursor with:
  123.  - Keyboard:    Arrows up & down on main edit. You can speed up the move with
  124.         shift keys (there's a different step for each shift key).
  125.         Arrows left & right when you edit a line. Shift keys are used
  126.         here to go directly to the beginning or the end of the edited
  127.         line.
  128. - Mouse:    Just click wherever you want to place the cursor.
  129.         If you hold down mouse button on top or bottom of screen then
  130.         copperlist smoothly scrolls.
  131. - Slider:    Grab the slider bar and move it up and down to go where you
  132.         want. If you don't click on the bar then there will be just
  133.         a small jump.
  134.  
  135. The program philosophy is that everything must be as simple and intuitive as
  136. possible. There are three ways of modifying the edited copperlist:
  137.  - With Cursor functions:
  138.             Most are in the `Current Line' pannel,like for example
  139.             modify color, Edit, Delete, Insert..
  140.  - With Block functions:
  141.             Such as Spread, Paste, Clr, Roll. Most are in `Block'
  142.             pannel. The using is quite logical: You first specify
  143.             the function limits then click on the function gadget
  144.             you want to use.
  145.  - With MousePointer functions:
  146.             Currently they're only two, Pick Color and Smooth. You
  147.             first click on gadget, then use it as long as needed.
  148.             To exit, click right mousebutton or simply go to
  149.             functions pannel.
  150.  
  151.  
  152. Copper Control Editor allows you to display only one color per rasterline on
  153. main screen, for speed (making use of AMOS functions) and for simplicity in
  154. coding as much as in using. Imagine for example with spread function: when we
  155. are spreading on a few lines, How could we simply determine if we take care of
  156. the inside of any line or not ?
  157. For those reasons I decided to separate vertical and horizontal edition of the
  158. copperlist. So by using the EDIT LINE function, you can edit horizontally and
  159. display far more colors per line (usually 44 !).
  160. You will also have to use this in combination with TEST function to see the
  161. real result (see below for details).
  162.  
  163. You can use the MIX feature to have multi-registers copperlists (this means
  164. copperlists on color00 plus color01 plus color03 for example).
  165. I will totally explain its using below.
  166.  
  167. Practically all functions have keyboard shortcut.
  168. If you press the HELP key, you will change the cursor color. Test it !
  169.  
  170. You must know that the