home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / amigalibdisks / disk939 / ianutils / colors.doc < prev    next >
Text File  |  1993-12-21  |  7KB  |  177 lines
  1. ***************************************************************************
  2.             C O L O R S   3 9 . X   D O C U M E N T A T I O N
  3. ***************************************************************************
  4.  
  5. REQUIRES:  Workbench 3.0+, mouse, ability to see color, I.Q. > 10
  6.  
  7. THE EASIEST WAY to learn this program is TO JUST RUN IT!!!  It is so easy.
  8. These docs are only for piece of mind, they will probably be totally useless
  9. to you.
  10.  
  11. Add a hotkey to this program with FKey, and it will allow you to edit the
  12. colors of any screen by pressing a button.
  13.  
  14. -------------------------------------------------------------------------
  15.  
  16. Colors 39 is simply a palette editor; a replacement for the "Colors" tool
  17. that comes with your computer.  It has a few more features, however.
  18.  
  19. * Access a potential of one million colors (with AGA chips)
  20.  
  21. * Uses new graphics.library v39 colormaps (Kickstart 3) 
  22.  
  23. * Faster, smaller, 100% assembly language
  24.  
  25. * Hue/Saturation/Intensity and Cyan/Magenta/Yellow mixing in addition to
  26.   Red/Green/Blue (now uses colorwheel.gadget for conversions)
  27.  
  28. * Copy and exchange colors easily
  29.  
  30. * Spread from one color to another smoothly and easily
  31.  
  32. * Undo feature (a must have!!)
  33.  
  34. In addition to these features, Colors still has the same features it has
  35. always:  It will open its palette editor on the front screen, and allow you
  36. to edit the colors of that screen.
  37.  
  38. -------------------------------------------------------------------------
  39.  
  40. INSTRUCTIONS
  41.  
  42. How to use......
  43.  
  44. Palette:
  45.  
  46. Click on the color you wish to edit.  (be sure to write this down :-)
  47.  
  48.  
  49. Percent Sliders:
  50.  
  51. There are 3 percentage sliders that specify the percent of each component.
  52. In RGB mode, for example, 100% red, 0% green, and 50% blue is a bright pink.
  53. I feel percentages are less cryptic for users than hexadecimal or decimal
  54. powers of two.  50% red is 50% red no matter whether red has 16 possible
  55. values, 64 possible values, or 256 possible values.  This is an easier way to
  56. learn color mixing than "9 red, 9 green, 4 blue" (which is an UGLY color by
  57. the way).  The latest version allows you to type in numbers into integer gadgets.
  58.  
  59. In HSI mode the top slider (HUE) is in degrees (0-360) around a colorwheel.
  60. 0 = Red, 120 = Green, 240 = Blue, 360 = Red again, like a circle.
  61.  
  62.  
  63. Button Gadgets:
  64.  
  65. OK:  Select when you are done and colors are OK.
  66. CANCEL:  Select if your colors are barfy and you give up trying to make
  67. them look better.  Will set them back to where you started and quit.
  68. UNDO:  Select to undo the color you are editing.  This will also undo swaps,
  69. copies, and spreads.
  70. RESET:  Reset to palette effective when program was loaded.  Note that CANCEL
  71. is the same as hitting RESET and then OK.
  72.  
  73.  
  74. Color Mode:
  75.  
  76. RGB:  Additive colors - Components are Red, Green, and Blue.
  77. CMY:  Subtractive colors - Components are Cyan, Magenta, and Yellow
  78.       This is sort of like printing ink, but there is no black component.
  79. HSI:  Hue, Saturation, and Intensity.
  80.       Hue is the color you want (RED, YELLOW, PURPLE).
  81.       Saturation is how "pure" that color is.  Low saturation has less color
  82.         (greys, pastels) and High saturation is purer color.
  83.       Brightness is how bright the color is.  Experiment with HSB, it is the
  84.         easiest mode to learn.
  85.  
  86. Edit Mode:
  87.  
  88. EDIT:  Edit current color.
  89. COPY:  Will copy the current color to a new location.  Hold SHIFT
  90.        to select a new color to copy from without copying to it.
  91. EXCHANGE:  Swap two colors.  Hold SHIFT to select a new color without
  92.            exchanging it.
  93. SPREAD:  Spread from one color to another.  Hold SHIFT when selecting a new
  94.          color if you want a new starting point but don't want to spread to it.
  95.  
  96. PLEASE SEND ME COMMENTS about this interface, I've had ideas to change it
  97. but want input from you (I have to change it to add my new features)
  98.  
  99. ----------------------------------------------------------------------------
  100.  
  101. ** Note: this program (and docs) were actually written before AGA came out
  102. with pre-release Kickstart 3.0.  Please excuse any future tense that I have
  103. not changed in the docs, like "when newer graphics chips are released" etc.
  104.  
  105. Colors actually was developed on an A3000 with ECS, but has been tested on
  106. AGA (a year after it was written).  AGA people like this program, so I'm
  107. giving it to you.
  108.  
  109. FUTURE ENHANCEMENTS:
  110.  
  111. * Global changes: the ability to adjust RGB/Contrast/Brightness of all colors
  112.   at once, perhaps only selected colors (though this would require either a
  113.   custom palette gadget or an improvemeny to gadtools.library)
  114.  
  115. * Load/save ILBM CMAP, to allow storage of palettes, use of Colors 39 as a
  116.   replacement Palette Prefs editor, and import of IFF pictures' colors.
  117.  
  118. * Ability to deactivate certain features to allow a smaller window, as well
  119.   as optional additional features,
  120.  
  121. * Menus with additional features.
  122.  
  123. * Color presets, to allow quickly setting a color to black or red, possibly
  124.   defined.  Each color may have a name, and colors could be accessed from
  125.   a listview rather than sliders if desired.
  126.  
  127. ----------------------------------------------------------------------------
  128.  
  129. * 030's rule!                                      7/17/92 1:09 PST (WA)
  130.  
  131. Till later ----
  132.             /-
  133.           ----  Ian Einman  -/-  Master of Machine Language
  134.  
  135.  
  136.  
  137.  
  138. ----------------------------------------------------------------------------
  139.  
  140. Copyright Info:
  141.  
  142. FREE to copy but...
  143.  
  144. I "retain" copyright privileges over this program in the following manner:
  145. If this program is altered (my name removed, etc.) in any way I will get mad
  146. and pursue you with packs of lawyers but as long as only the executable code
  147. is distributed AS IS....
  148.  
  149. You may give it around.  You may even include it in commercial packages as you
  150. see fit, no licence fee, although you may send me a modest contribution ($15?)
  151. and I will give you the latest version, even with your company/product name
  152. in the screen title bar:
  153.  
  154. "MegaBase v1.2 ©1994 Hard Software - Color Editor 39.14"
  155.  
  156. REGISTRATION????
  157.  
  158. Nah.  Just use this program.  If you want "service" send me money... or programs
  159. you have written.  Register me for one of your nifty programs and I'll send you
  160. a bunch of junk.  Also, if your from a different country, send me cool stamps,
  161. currency, postcards, unrecognizable objects inscribed with languages I do not
  162. understand etc. and I will be impressed and send you junk.
  163.  
  164. Have comments?  SASE envelopes will get some sort of half-cracked reply if
  165. you write to me in English.  You can write to me in another language if you
  166. want, I will drink beer then I will understand.  My answers may seem incoherent.
  167.  
  168. Anyone who sends any money will always get the latest versions of my programs.
  169. Send me lots of money and I will send you programs, and even updates later.
  170. Send me even more money and I will heal you......
  171.  
  172. Ian J. Einman
  173. P.O. Box 5711
  174. Bellingham, WA 98227
  175. U.S.A.
  176.  
  177. AAAAAAAAAAAAAAAAAAAAAAAAAAAHHHH! AAAAAAAMIGAHHHHHHHHHHHHHHH!