home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / new / biz / dbase / bbaseiii / colortool.doc < prev    next >
Text File  |  1994-02-27  |  13KB  |  239 lines
  1. @DOCUMENT "ColorTool.doc"
  2. @NODE MAIN "  ColorTool Documentation"
  3.         
  4.                                ColorTool.doc
  5.                                =============
  6.  
  7.          The following is part of the file taken from Fred Fish's
  8.                  "AmigaLibDisk257:ColorReq/Color.DOC".
  9.         You should read the whole thing, it's really quite humorous.
  10.  
  11.  
  12.                        * * *  START OF EXCERPT  * * *
  13.  
  14.    What now follows is the ColorTool document for the end user.
  15.  
  16.     Before using the dissidents ColorTool, the file "color.library" must be
  17. copied to the libs drawer of your boot (WorkBench) disk.
  18.  
  19.     The dissidents ColorTool allows you to adjust all of the Amiga's colors
  20. in a very straight-forward way. It is a window filled with several gadgets.
  21. At the top are (up to) 32 color "boxes" representing the current colors. One
  22. of the color boxes will have a border around it. This indicates that the box
  23. is the active one. To make another color box the active one, you simply move
  24. the mouse pointer over the desired box, and click the right mouse button.
  25. The border will move to that color box, making that box the active one.
  26.     Note that color box #1 appears to be invisible because it is the same
  27. color as the background of the ColorTool window. If you click around the top
  28. left corner of the window where a box "looks" like it might fit, you should
  29. see the border surround this "invisible" color box. Initially, color box #2
  30. is the active one. Because the border is the same color as this box, the
  31. border seems to blend into the box, resulting in what appears to be a color
  32. box larger than the others. If you select another box, note that color box
  33. #2 is really the same size as the others.
  34.     Below and to the right of the color boxes are 3 sliders. These sliders
  35. adjust the amount of red, green, and blue in the active color box. To the
  36. left of each slider is a letter followed by a number. The letter indicates
  37. which color component the slider alters: R for red, G for green, and B for
  38. blue. The number is that component's intensity. This ranges from 0 to 15.
  39. For example, you might see the following combination next to the sliders.
  40.  
  41.     R15
  42.  
  43.     G3
  44.  
  45.     B0
  46.  
  47. This means that the active color box has a lot of red in it, a little green,
  48. and no blue. To your eye, the resulting color box should be some shade of
  49. red. As you move a slider knob, you will see the active box's color change.
  50. Also, you will notice that the number to the left of the slider changes.
  51.    When you select a new color box, the sliders are automatically adjusted
  52. to display the amount of red, green, and blue in that color box.
  53.    By selecting color boxes, and moving the 3 sliders, you can adjust all of
  54. the colors in the current screen, observing the resulting changes as the
  55. sliders move.
  56.    There are several other gadgets below the color box. They are labeled
  57. Default, Cancel, Save, Undo, Copy, and Spread.
  58.    The Undo gadget is used to reverse the last change which you made to the
  59. color boxes. If you move a slider, then decide that you don't like the
  60. resulting change to the active color box, you can restore the color by
  61. clicking the right mouse button on the word "Undo". You can even undo the
  62. Undo. By clicking on "Undo" again, you should see that the results you just
  63. canceled are back. This feature is useful for comparing a changed box to the
  64. original box to determine whether you really like the change.
  65.    The Copy gadget is used to copy the current color box to another box.
  66. Make sure that the color box you wish to copy has the border around it (e.g.
  67. it is the active box). Then, move the mouse pointer over the word "Copy" and
  68. click the right button. The mouse pointer will turn into the word "TO". This
  69. means that ColorTool now expects you to select a box where you want this color
  70. "TO" be copied. When you select a new color box, its color will change to the
  71. copied box, and this new box will be made the active one (e.g. the border
  72. will move to the new box.) If you don't like the results, you can Undo this.
  73. If you mistakenly click on "Copy" and see the "TO" pointer, simply click on
  74. the same box that is now active to abort the Copy procedure.
  75.    The Spread gadget allows you to pick two color boxes, a start and end box,
  76. and have ColorTool alter all of the color boxes inbetween so that they are
  77. various "shades" of the start and end boxes. Select a start box by clicking
  78. on it, then click on the word "Spread". The "TO" mouse pointer will now
  79. appear. Choose a color box for the end, and click on it. All of the boxes
  80. inbetween will change to a smooth variety of shades from start to end. If
  81. you don't like the results, "Undo" them.  If you click on "Spread" by
  82. accident, just click on the same box that is now active to abort the Spread.
  83.    The Default gadget restores ALL of the color boxes to the same colors as
  84. when the ColorTool window first appeared. This is different than the Undo,
  85. which simply restores only the last change. Use Default when you want to
  86. restore the initial palette and start anew.
  87.  
  88.   NOTE: Since the Default gadget can be configured differently by each
  89.         application, some programs may not restore the initial palette,
  90.         but instead change all of the color boxes to preset values.
  91.  
  92.    The Save and Cancel gadgets are used to exit the ColorTool. When you have
  93. finished altering the colors, click on one of these gadgets.
  94.   The Save gadget will exit the ColorTool, implementing all of the color
  95. adjustments you made to the current screen.
  96.   The Cancel gadget will exit, but all of your adjustments will be discarded
  97. and the screen will appear exactly as it did before the ColorTool appeared.
  98.    The ColorTool gadgets are initially drawn in the colors of the first two
  99. color boxes. In fact, color box #2 is the foreground color (e.g. the color
  100. that all of the gadgets appear to be). Sometimes, when color box #1 and #2
  101. are almost the same color, the ColorTool gadgets can barely be seen. If this
  102. condition occurs, by using the Function keys, you can change the color of
  103. the gadgets without altering the palette. Press each of the 10 Function keys
  104. on your keyboard, one at a time, until the ColorTool gadgets can be seen
  105. well. One of the function keys should yield a serviceable result. If not,
  106. hold down the ALT key, and press each of the 10 keys again. If you still
  107. cannot see the ColorTool gadgets clearly, hold down the CTRL key and press
  108. the w key. This will alter the first two color boxes (changing them to black
  109. and white respectively). You can then make changes to the other color boxes,
  110. and afterwards restore the first two by pressing CTRL and w again.
  111.    Some people prefer to describe a color in terms of Hue, Saturation, and
  112. Value instead of by its red, green, and blue components. By clicking in the
  113. area where the R, G, and B intensities are displayed (e.g. the letters and
  114. numbers), the sliders will change to Hue, Saturation, and Value sliders.
  115. Note that the R, G, and B will change to H, S, and V. Also, the numbers will
  116. represent the value for the sliders. (Though these values are really meaning-
  117. less for HSV, they are included for reference.) Generally speaking, the Hue
  118. slider chooses the color (frequency). As you move the Hue slider you should
  119. see the color box change from red to green to blue. The Saturation determines
  120. the amount of "pigmentation" of the color. If you set Hue to 0 and saturation
  121. to 15, then you should see a definite shade of red. As Saturation goes to 0,
  122. you will notice that the "red" seems to disappear from the color box, leaving
  123. some shade of black, white, or grey. The Value slider determines the bright-
  124. ness of the color. A Value of 0 will most certainly give a very dark, black-
  125. ish color whereas a Value of 15 will give a very bright color. When Satura-
  126. tion is 0, the Hue setting becomes meaningless because you have no "pigment"
  127. in the color. Now, moving the value knob will give you all of the black,
  128. white, and grey shades. For this special case, "--" is displayed for the
  129. Hue value, and the slider knob is forced to maximum right position to remind
  130. you that this color box is in "black and white" mode. To better understand
  131. the intuitive approach of HSV, try the following exam