home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / crm_demo / palmastr / pm_help.doc < prev   
Text File  |  1993-02-19  |  44KB  |  1,142 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.                    The Ultimate Color Handling Utility
  25.         Works in any mode ranging from Monochrome to True Color
  26.    Features Smooth Shading, Cut & Paste  Color  Clips,  Swap, Copy,
  27.    Rainbow,  Save & Load,  Color & Greyscale Conversion, Palette or
  28.    Profile Operation with multiple Undo Functions, Gamma Correction
  29.                         and Color Level Adjust
  30.   
  31.    - D E M O   V E R S I O N -
  32.  
  33.        Runs on all Atari computer systems with 512 KB and more. 
  34.              Minimum screen resolution required: 320x200.
  35.              
  36.    Copyright (c) 1993 by Cybercube Research Limited, Toronto Canada
  37.  
  38. ========================================================================
  39.  
  40.                                | 1.
  41.                       OVERVIEW |
  42.                  ______________|
  43.  
  44.  
  45. The PALMASTR.ACC or PALMASTR.PRG is an interactive color handling utility
  46. originally designed to  facilitate all color controlling functions of the CyReL
  47. SUNRISE M16-1280 High Resolution True Color Graphics Cards for the Mega STE and
  48. TT030.
  49.  
  50. This newly released demo version now runs on ANY Atari machine and allows the
  51. operation in all of these modes: monochrome, 4 colors, 16 colors, 256 colors,
  52. Falcon High Color Modes and even in the dazzling True Color Modes of the CyReL
  53. M16-1280 Graphics Cards.
  54.  
  55. The program provides  on-line help functions to familiarize the user with all
  56. menu functions and features available.
  57.  
  58. Although the utility was designed for high resolution displays, this version
  59. now also runs on small screens like 320x200. A special screen layout is used
  60. whenever the resolution drops below a certain threshold. Some features are not
  61. available in modes with less than 16 colors.
  62.  
  63. The CyReL Palette Master makes extensive use of icons and sub-menus to present
  64. all the options. We recommend you install the accompaning PALMASTR.PRG as an
  65. *.ACC program on your boot drive, reset your machine, then load the following
  66. tutorial text into any text editor or word-processor that allows the use of
  67. accessories. This method will allow you to go through the tutorial while
  68. experimenting with all the features presented.
  69.  
  70. Have fun!
  71.  
  72.  
  73.                                | 2.
  74.                        GETTING |
  75.                        STARTED |
  76.                  ______________|
  77.  
  78.  
  79. Whenever you start the Palette Master Program or Accessory, the first menu you
  80. will see is the Main Menu. It contains these major function blocks:
  81.  
  82.         =  the Palette or Color Bar
  83.          
  84.         =  the Palette or Profile Box
  85.          
  86.         =  the Menu Box
  87.          
  88.         =  the Action Box
  89.          
  90.         =  RGB Color Sliders and Color Index Field
  91.         
  92.         =  and the Control Buttons
  93.          
  94. Let us first examine these major blocks before we are going to use them more
  95. extensively.
  96.  
  97.  
  98.  
  99.                      MAIN MENU | 3.
  100.                                |
  101.                  The COLOR BAR |
  102.                  ______________|
  103.  
  104.  
  105. This bar which is located to the right or underneath the Palette/Profile Box
  106. shows all colors momentarily available to the GEM operating system. It allows
  107. the user to 'pick' any color displayed here and edit it in any way he sees fit.
  108. Further it gives the user a good indication how color transitions and fades
  109. will look like.
  110.          
  111.          
  112.                      MAIN MENU | 4.
  113.                                |
  114.                   The PALETTE/ |
  115.                   PROFILE BOX  |
  116.                  ______________|
  117.  
  118.  
  119. This is the main color editing and selection window. It provides an easy access
  120. to all the available color registers. Simply click on any displayed shade and
  121. this color will be selected for all further editing functions.
  122.  
  123.  
  124.          
  125.                      MAIN MENU | 5.
  126.                                |
  127.                   The MENU BOX |
  128.                  ______________|
  129.                  
  130.  
  131. The Menu Box can always be found on right side of the Palette/Profile Box. It
  132. contains ten icons which represent all major functions that the CyReL Palette
  133. Master Utility offers. To select a function, simply click on its symbol in the
  134. menu box, then proceed as prompted.
  135.  
  136.  
  137.                      MAIN MENU | 6.
  138.                                |
  139.                 The ACTION BOX |
  140.                  ______________|
  141.  
  142.  
  143. This text window in the lower left hand corner always shows you the next
  144. required action. Simply follow the instructions displayed here to complete the
  145. desired functions.
  146.  
  147.  
  148.                      MAIN MENU | 7.
  149.                                |
  150.                The RGB SLIDERS |
  151.                  and the INDEX |
  152.                  ______________|
  153.  
  154.  
  155. The RGB Sliders offer an easy way to manipulate the color components of the
  156. currently selected register. Simply click on the left arrow or right arrow to
  157. decrease or increase the color components. Click on the R,G or B box and drag
  158. it for faster control. Clicking on the red, green or blue bar increments or
  159. decrements the color components in steps of five. To enter a specific value,
  160. simply click on the corresponding value box itself. A new menu will appear and
  161. prompts you to input the intended color value. The color components can always
  162. be specified with an value ranging from 0 (no color) to 1000 (full color). See
  163. below for a full description of the value input menu.
  164.  
  165. Beneath the Menu Box you will find the Color Index Field. It offers an
  166. alternative way to select any color register. Click on the index field and a
  167. new menu will appear. Input the desired color register number directly, then
  168. press enter or click on the OK button.
  169.  
  170.  
  171.                      MAIN MENU | 8.
  172.                                |
  173.            The Control Buttons |
  174.                  ______________|
  175.  
  176.  
  177. The Main Menu shows four control buttons:
  178.  
  179. OK Button: leaves the Palette Master Utility and retains all color
  180.            changes and color edits performed so far. The closer
  181.            button in the Palette Master window has the same effect.
  182.            
  183. Cancel 
  184. Button:    After requesting confirmation to abort the Palette Master
  185.            Utility, all color edits and changes will be lost and
  186.            the original state of the color palette will be restored.
  187.            
  188. HELP
  189. Button:    Enters the on-line help page menus. See below.
  190.  
  191. Ink Jar
  192. Button:    Shows the infobox and copyright message.
  193.  
  194.  
  195.  
  196.                      MAIN MENU | 9.
  197.                                |
  198.                   The Palette/ |
  199.                  Profile Modes |
  200.                  ______________|
  201.  
  202.  
  203. The Palette Master Utility offers two main modes of operation. Palette Mode and
  204. Profile Mode. 
  205.  
  206. In the Palette Mode, the Palette Box shows a number of colored blocks
  207. indicating the total number of color registers available and their actual
  208. state. The current color register is marked by a small white or black square.
  209.  
  210. In the Profile Mode, the Palette Box displays all color registers using a line
  211. or 'profile' to describe the actual state. The state will be displayed by three
  212. individual lines, one red, one green and one in blue representing the
  213. corresponding color components. The current color register is marked by a
  214. dotted line.
  215.  
  216. The user can switch between these two modes at any time either by pressing
  217. ALTERNATE-P or by clicking on the red [COLOR:] box right besides the Color
  218. Index Field and selecting the required mode in the menu that appears next.
  219.  
  220.  
  221.                      MAIN MENU | 10.
  222.                                |
  223.                      Using the |
  224.                          Block |
  225.                      Functions |
  226.                  ______________|
  227.  
  228.  
  229. Most functions available in the main menu require you to specify TWO color
  230. registers. They will either be used as first and second color (as for the color
  231. swap function) or the first and last color (as for the color blend function).
  232. Therefore you should always follow the instructions displayed in the Action Box
  233. and remember the following simple rule:
  234.  
  235.       1. select the required function from the Menu Box
  236.       
  237.       2. select the first or starting color
  238.       
  239.       3. select the last or end color (if necessary).
  240.  
  241.  
  242.                      MAIN MENU | 11.
  243.                                |
  244.                         How to |
  245.                          Abort |
  246.                      Functions |
  247.                  ______________|
  248.  
  249.  
  250. All functions can be aborted at ANY time. Simply select a new function from the
  251. Menu Box. This will override the old selection.
  252.  
  253. All functions will terminate if you specify an invalid value or click on any
  254. function that is outside the Color Bar or Palette/ Profile Box. One exception
  255. is the Color Index Field. 
  256.  
  257.  
  258.                      MAIN MENU | 12.
  259.                                |
  260.                         How to |
  261.                            use |
  262.                           UNDO |
  263.                  ______________|
  264.  
  265.  
  266. Use the UNDO key on your keyboard to restore the last state of the current
  267. palette. Pressing the key twice will toggle the state between the altered one
  268. and the original state.
  269.  
  270. UNDO may also be used to de-select the current function in the Menu Box.
  271. Pressing UNDO during the operation of such a function will disable all
  272. processing and editing features and return the Menu Box to the inactive state.
  273.  
  274.  
  275.                      MAIN MENU | 13.
  276.                                |
  277.                         How to |
  278.                        specify |
  279.                      the Start |
  280.                        and End |
  281.                Color Registers |
  282.                  ______________|
  283.  
  284.  
  285. The first and last color for any of the menu functions can be specified in
  286. either of these ways:
  287.  
  288.       a) clicking on any of the color registers displayed in
  289.          the Color Bar
  290.          
  291.       b) clicking on any of the color registers displayed in
  292.          the Palette/Profile Box
  293.          
  294.       c) clicking on the Color Index Field and entering a new
  295.          color index.
  296.          
  297. The program also handles any of the above combinations. Therefore you can
  298. specify e.g. the starting color using the Color Index Field, while you might
  299. want to select the end color just by clicking on any of the color registers
  300. shown in the i.e. Color Bar.
  301.  
  302.  
  303.                      MAIN MENU | 14.
  304.                                |
  305.                         How to |
  306.                        enter a |
  307.                          value |
  308.                  ______________|
  309.  
  310.  
  311. Whenever you click on any of the value boxes, a new menu will appear. It
  312. contains these buttons or fields:
  313.  
  314.       1. title: it shows you for which function you are asked
  315.          to enter the value
  316.          
  317.       2. the MINimum field: simply click on this field to
  318.          rapidly input the minimum allowed value for this
  319.          function
  320.          
  321.       3. the MAXimum field: simply click on this field to
  322.          rapidly change the value to its maximum allowed
  323.          setting
  324.          
  325.       4. the ARROW LEFT icon: click on this icon to decrease
  326.          the value
  327.          
  328.       5. the ARROW RIGHT: icon: click on this icon to increase
  329.          the value
  330.          
  331.       6. the VALUE box: click on the value itself to enter
  332.          a new number directly from the keyboard. Press ESCape
  333.          to clear the input.
  334.          
  335.       7. the OK button: Press enter or click on the OK button
  336.          to accept the new value and exit this menu.
  337.          
  338.       8. the Cancel button: click on this button to leave without
  339.          updating the value.
  340.          
  341. Most values can be activated directly from the keyboard. See below for a
  342. complete list of keyboard short-cuts.
  343.  
  344.  
  345.                      MAIN MENU | 15.
  346.                                |
  347.                         How to |
  348.                        use the |
  349.                       Keyboard |
  350.                     Short-Cuts |
  351.                  ______________|
  352.  
  353.  
  354. Here is a list of all available keyboard short-cuts. They can be used at any
  355. time and have the same effect as the equivalent mouse selections:
  356.  
  357.  
  358.         ALTERNATE - B        select the Blend Function
  359.         ALTERNATE - C        select the Copy Function
  360.         ALTERNATE - D        select the Disk Operations
  361.         ALTERNATE - G        select the Gamma/Level Operations
  362.         ALTERNATE - I        select the Inverse Function
  363.         ALTERNATE - L        select the Clip Operations
  364.         ALTERNATE - M        select the Mono/Greyscale Operations
  365.         ALTERNATE - O        select the Restore Operations
  366.         ALTERNATE - P        toggle between Palette and Profile Mode
  367.         ALTERNATE - R        select the Rainbow Function
  368.         ALTERNATE - S        select the Swap Function
  369.        
  370.         CONTROL - C          select Cancel from the Main Menu / Abort
  371.         CONTROL - R          enter value for RED
  372.         CONTROL - G          enter value for GREEN
  373.         CONTROL - B          enter value for BLUE
  374.         CONTROL - I          enter value for Color Index
  375.  
  376.         ENTER or
  377.         RETURN               select OK from the Main Menu / Exit
  378.         HELP                 select HELP from the Main Menu
  379.         TAB                  rotate palette by 90 degrees and back
  380.         SHIFT RIGHT          shift color palette to the right
  381.         SHIFT LEFT           shift color palette to the left
  382.  
  383.  
  384.         CONTROL - C          select Cancel from the Main Menu / Abort
  385.         CONTROL - R          enter value for RED
  386.         CONTROL - G          enter value for GREEN
  387.         CONTROL - B          enter value for BLUE
  388.         CONTROL - I          enter value for Color Index
  389.  
  390.  
  391.                     HELP PAGES | 16.
  392.                                |
  393.                         How to |
  394.                        use the |
  395.                   ON-LINE HELP |
  396.                  ______________|
  397.  
  398. To enter the on-line help pages section, press HELP on your keyboard or click
  399. on the HELP button in the Main Menu.
  400.  
  401. The on-line help consists of six pages. Each page can be accessed through three
  402. buttons:
  403.  
  404.       a) the NEXT page button: simply click on this button or
  405.          press Enter to get to the next help page
  406.          
  407.       b) the PREVIOUS page button: click on this button to
  408.          go back one page.
  409.          
  410.       c) the Cancel button: click on this button to exit the
  411.          help page menus.
  412.  
  413.  
  414.  
  415. Next, the description of all available functions and features:
  416.  
  417.  
  418.                       COMMANDS | 17.
  419.                                |
  420.                            The |
  421.                        RAINBOW |
  422.                        Command |
  423.                  ______________|
  424.  
  425.  
  426. The Rainbow command allows the generation of a color spectrum. In order to work
  427. properly, this command needs a color span of at least 14 color registers. This
  428. is also the reason why the function is disabled in any color mode with less
  429. than 16 colors.
  430.  
  431. Simply select the first and last color register you want to INCLUDE in the
  432. rainbow. The more registers are selected for this operation, the better looking
  433. the result will be. You can reverse the direction of the rainbow by clicking on
  434. the last color first, then selecting the first color. The program will then
  435. generate the rainbow running from the last to the first color. 
  436.  
  437.  
  438.                       COMMANDS | 18.
  439.                                |
  440.                            The |
  441.                         INVERT |
  442.                        Command |
  443.                  ______________|
  444.  
  445.  
  446. Use this command to invert or reverse any span of color registers. Sometimes
  447. even dull palette configurations can reveal quite startling color combinations
  448. if you use the Invert command to change a part or the whole palette.
  449.  
  450.  
  451.                       COMMANDS | 19.
  452.                                |
  453.                            The |
  454.                          BLEND |
  455.                        Command |
  456.                  ______________|
  457.  
  458.  
  459. To generate a smooth color transition, select the starting color, then the end
  460. color. The program will then try to generate a smooth color ramp using all
  461. registers that lie in between. The more registers can be used, the smoother the
  462. fading will be.
  463.  
  464. TIP: In oder to fill a large number of color registers with the same color
  465. value, copy the value from the first register into the last register with the
  466. help of the COPY command (see below).
  467.  
  468. Then select the blend command, again specifying the same start and end
  469. registers. All registers that fall in between the start end end color will then
  470. be filled with the same value.
  471.  
  472.  
  473.                       COMMANDS | 20.
  474.                                |
  475.                            The |
  476.                           CLIP |
  477.                        Command |
  478.                  ______________|
  479.  
  480.  
  481. Working with color clips can proof to be one of the most powerful features of
  482. the Palette Master. When you click on the Clipboard symbol, a new menu will
  483. appear. Please select whether you want to CUT a new clip or PASTE an existing
  484. one. Trying to paste a clip that has not been initialized before will result in
  485. an error message.
  486.  
  487.  
  488.                  CLIP COMMANDS | 21.
  489.                                |
  490.                            The |
  491.                       CUT CLIP |
  492.                        Command |
  493.                  ______________|
  494.  
  495.  
  496. After selecting CUT CLIP, and indicating which of the clip buffers should be
  497. used, you can specify whether you want to cut the red, green and/or blue
  498. component of every color in the color clip that will be specified next. This
  499. unique feature allows you to for instance just grab i.e. the red values of a
  500. certain color clip and later, replace ONLY the red values of your destination.
  501.  
  502. Once you activated or de-activated all color components, please click on the OK
  503. box and specify the start and end color of the clip to be stored in the
  504. selected clip buffer.
  505.  
  506. Note: this demo version allows only the use of a SINGLE clip buffer. The full
  507. edition supports five simultaneous buffers.
  508.  
  509.  
  510.                  CLIP COMMANDS | 22.
  511.                                |
  512.                            The |
  513.                     PASTE CLIP |
  514.                        Command |
  515.                  ______________|
  516.  
  517.  
  518. After selecting PASTE CLIP, and specifying which of the clip buffers should be
  519. used, you will be presented with the PASTE CLIP Configuration Menu. With the
  520. help of this menu you can:
  521.  
  522.       = specify which color components should be copied to the destination and
  523.         which should be left unchanged
  524.  
  525.       = swap the color components or copy one color component into several
  526.         other color components, thus copying i.e. the green color levels into
  527.         e.g. the blue as well
  528.  
  529.       = create multiple copies of one and the same clip buffer
  530.       
  531. The flexibility of this feature is achieved with the help of the color copy
  532. matrix:
  533.  
  534. On the left you see three fields, labelled RED, GREEN and BLUE. Only those
  535. components that have been cut or grabbed will be enabled or can be selected.
  536. Even if all three color components were enabled while cutting the clip from the
  537. palette, you can now disable them individually if necessary.
  538.  
  539. On the right you can see nine fields, organized in three rows of three fields.
  540. Each row has an RED, GREEN and BLUE field, allowing you to copy the
  541. corresponding RED, GREEN or BLUE color component into itself or up to three
  542. color fields at the same time. You can also reverse the order of the color
  543. components by swapping the components against each other.
  544.  
  545. The scope of the color matrix can best be experienced through a series of
  546. experiments.
  547.  
  548. Once you activated or de-activated all color components, please click on the OK
  549. box and specify the starting location where the clip should be reinserted into
  550. the existing palette.
  551.  
  552. If you enable the MULTIPLE button, you can reuse the contents of the buffer
  553. until the MULTIPLE option is de-acitvated again or the buffer is over-written
  554. with a new color clip.
  555.  
  556. Note: this demo version allows only the use of a SINGLE clip buffer. The full
  557. edition supports five simultaneous buffers.
  558.  
  559.  
  560.                       COMMANDS | 23.
  561.                                |
  562.                            The |
  563.                           SWAP |
  564.                        Command |
  565.                  ______________|
  566.  
  567.  
  568. Use this command to exchange the color settings of two color registers. Select
  569. the first register, then select the second register which should be swapped
  570. with the first one.
  571.  
  572.  
  573.                       COMMANDS | 24.
  574.                                |
  575.                            The |
  576.                           COPY |
  577.                        Command |
  578.                  ______________|
  579.                  
  580.  
  581. To make a copy of one color register, simply click on the source register, then
  582. click on the destination.
  583.  
  584.  
  585.                       COMMANDS | 25.
  586.                                |
  587.                            The |
  588.                          GAMMA |
  589.                    Correction/ |
  590.                          LEVEL |
  591.                         Adjust |
  592.                        Command |
  593.                  ______________|
  594.  
  595.  
  596. After selecting the GAMMA function, a new menu will appear presenting these
  597. options:
  598.  
  599.  
  600.       = RED, GREEN, BLUE
  601.       
  602.       = GAMMA, LEVEL
  603.  
  604.       = OK, Cancel
  605.  
  606.  
  607. The basic function can be selected using the GAMMA/LEVEL buttons.
  608.  
  609. To choose the Gamma Correction Function, select GAMMA. To enable the Level
  610. Adjust Function, select LEVEL.
  611.  
  612. Next, configure the GAMMA/LEVEL function using the RED, GREEN and BLUE buttons.
  613. Here you can determine which color components will be affected by the
  614. GAMMA/LEVEL function. Only the selected components of the color span (to be
  615. defined next) will be updated. Everything else remains unchanged.
  616.  
  617. Note: the function will be aborted if no color component is selected or the
  618. user clicks on the Cancel button.
  619.  
  620. After clicking on the OK button, the user will be prompted to enter a
  621. GAMMA/LEVEL value.
  622.  
  623.  
  624.            GAMMA/LEVEL COMMAND | 26.
  625.                                |
  626.                            The |
  627.                          GAMMA |
  628.                          Value |
  629.                  ______________|
  630.  
  631.  
  632. Almost all picture tubes used in display devices such as monitors or TV sets do
  633. not exhibit a 'linear response'.  
  634.  
  635. What is a linear response ? Let's have a look at a rather common example: 
  636.  
  637. If you want to display a smooth transition from a very dark color to a very
  638. light color you would not get a very even shaded color fading. Instead you will
  639. get a color shading that has a large 'dark' portion and a much smaller 'light'
  640. portion. You have discovered the curved response line of your monitor tube and
  641. the need to adjust this through a function generally known as 'GAMMA
  642. Correction'. Most monitors need a gamma correction value of about  1/2.2 or
  643. 0.454. This is the default value that the Palette Master will use for the GAMMA
  644. function.
  645.  
  646. Using the GAMMA correction, almost all shadings can be shown as intended.
  647.  
  648. To test this, set the start register of your color span to black (0,0,0) and
  649. the end register to white (1000,1000,1000). The longer your color span will be,
  650. the better. Now select the BLEND command and click on the same registers again.
  651. A smooth grey shaded transition from black to white should appear. 
  652.  
  653. Now try to switch to the Profile Mode (either by pressing ALT-P or clicking on
  654. the red [COLOR:] box right besides the Color Index Field, and select the
  655. PROFILE button). You should now see a line (or better profile) describing the
  656. current state of your color palette. This line goes from the lower left corner
  657. to the upper right hand corner. Despite the fact that this line runs straight
  658. from the minimum value (black) to the maximum value (white), the color shades
  659. reproduced on your monitor are not as evenly shaded as expected. To correct
  660. this, select the GAMMA function, enable all three color components RED, GREEN
  661. and BLUE, then click on the GAMMA, then the OK button. When the program asks
  662. you to enter a value for the GAMMA function, enter: 0.454 and press enter. Now
  663. select the start and end color registers of your color span. After calculating
  664. and adjusting your colors, the color shading you will see on your monitor
  665. should be a lot more evenly distributed than before. Furthermore the profile
  666. you see should be curved instead of straight. Experiment with the GAMMA
  667. function and different values to obtain the best possible correction factor for
  668. your monitor and personal preference.
  669.  
  670. The effect of different GAMMA Correction values:
  671.  
  672.   0.1        0.454       1.0         2.0           2.2
  673.  ..|..........|...........|...........|.............|..........
  674.    |          |           |           |             |
  675. very          the         neutral,    used to       the       
  676. intensifying  'classic'   no          darken        'reverse'
  677. GAMMA         GAMMA       effect      bright        GAMMA
  678. Correction    value                   palettes      value
  679.  
  680. Remember: You can always use the UNDO function to return to the last state if
  681. you are not pleased with the results.
  682.  
  683.  
  684.            GAMMA/LEVEL COMMAND | 26.
  685.                                |
  686.                            The |
  687.                          LEVEL |
  688.                          Value |
  689.                  ______________|
  690.  
  691.  
  692. The LEVEL Function allows you to change the 'level' of an entire range of
  693. colors or color components. Example: You want to reduce the green component of
  694. all colors to half its present setting. To do this, select the GAMMA/LEVEL
  695. function, then click on the LEVEL button. Next, deselect the RED and BLUE
  696. button, leaving only the GREEN button selected. Press Enter or click on the OK
  697. button. Now enter: 0.5 as a value for the LEVEL function. Select the start,
  698. then the end color of the color span you want to change. After re-calculating
  699. the colors, the green component should be half as bright as before.
  700.  
  701. The effect of different LEVEL Adjustment values:
  702.  
  703.   0.1        0.5         1.0         2.0           3.0
  704.  ..|..........|...........|...........|.............|..........
  705.    |          |           |           |             |
  706. set color  reduce      neutral     set color     set color
  707. to near    color to                component     component
  708. 'black'    half its                to twice      to three times
  709.            value                   its value     its value
  710.  
  711. Remember: You can always use the UNDO function to return to the last state if
  712. you are not pleased with the results.
  713.  
  714.  
  715.                        COMMAND | 27.
  716.                                |
  717.                            The |
  718.                          MONO/ |
  719.                      GREYSCALE |
  720.                        Command |
  721.                  ______________|
  722.  
  723.  
  724. Very often it is necessary to convert colors into greyscale values. The Palette
  725. Master Utility offers several predefined arrangements to obtain the best
  726. possible results under various conditions.
  727.  
  728. To test its conversion benefits and weaknesses, generate a rainbow or some
  729. color fadings, then select the MONO/GREYSCALE command.
  730.  
  731. Once you clicked on the MONO icon, a menu will be displayed offering these
  732. options:
  733.  
  734.       = three sliders for your individual R, G, B conversion
  735.         factors
  736.         
  737.       = three predefined conversion settings:
  738.         3:6:1, 1:3:1 and 1:1:1
  739.         
  740.       = the OK and Cancel buttons.
  741.       
  742. The most commonly used color to grey conversion uses the weightning factors of
  743. 3:6:1. But this might sometimes result in a very weak or unacceptable
  744. translation of shades, especially blue colors tend to be misconverted.
  745. Therefore the Palette Master Utility offers two more predefined settings: 1:3:1
  746. in which the green color components again plays the dominating role and the
  747. 1:1:1 mode which uses all color components equally.
  748.  
  749. Try to use all three conversion factors or define your own to find out which
  750. ones best suit your application.
  751.  
  752. After specifying the conversion factors, select the start and end color of the
  753. color span that should be converted to greyscale.
  754.  
  755.  
  756.                        COMMAND | 28.
  757.                                |
  758.                            The |
  759.                        RESTORE |
  760.                        Command |
  761.                  ______________|
  762.  
  763.  
  764. Sometimes it is necessary to restore the colors to their original state at the
  765. beginning of the program or to the state used by the GEM operating system. To
  766. do this, select the RESTORE command from the Menu Box. Then choose INITIAL (for
  767. the setting at the beginning of the program) or DEFAULT (for the GEM setting).
  768. Specify the first and last color to be restored.
  769.  
  770.  
  771.                        COMMAND | 29.
  772.                                |
  773.                            The |
  774.                           DISK |
  775.                        Command |
  776.                  ______________|
  777.  
  778.  
  779. Use this command to either load or save a part of the current palette or the
  780. entire color palette. When prompted, select either the LOAD or SAVE operation.
  781.  
  782. Note: the LOAD and SAVE option is disabled in this demo release.
  783.  
  784.  
  785.  
  786.                   DISK COMMAND | 30.
  787.                                |
  788.                            The |
  789.                           LOAD |
  790.                        Command |
  791.                  ______________|
  792.  
  793.  
  794. If you selected the LOAD command, a file selector box will appear and you will
  795. be asked to select a CyReL M16 Palette file. These files have the extension:
  796. *.PAL . Only files with this extension and the corresponding format will be
  797. processed and loaded. Refer to the separate M16 PALette File documentation for
  798. more informations about the structure and usage of these files, or how to
  799. convert other files into M16 palette files.
  800.  
  801. Once you specified a certain M16 PALette file, you must indicate the first and
  802. last color register that should be over-written with the contents of the
  803. PALette file. If the palette file does not contain enough colors to fill the
  804. selected span, only the available colors will be loaded and over-written. If
  805. the PALette file is longer or contains more colors than needed, the excess
  806. colors will be left unused.
  807.  
  808.  
  809.                   DISK COMMAND | 30.
  810.                                |
  811.                            The |
  812.                           SAVE |
  813.                        Command |
  814.                  ______________|
  815.  
  816.  
  817. If you selected the SAVE command, you will be prompted to enter a new filename
  818. or select an existing file to store the color informations. If you selected an
  819. existing file, a warning will be displayed giving the user the option to either
  820. overwrite the old contents or select a new filename. Next, specify the start
  821. and end register to be saved. The Palette Master will then generate a file
  822. according to the M16 specifications containing the color informations of all
  823. (including start and end color) registers selected.
  824.  
  825.  
  826.                           TIPS | 31.
  827.                                |
  828.                      Reversing |
  829.                      the order |
  830.                       of color |
  831.                      registers |
  832.                  ______________|
  833.                  
  834.  
  835. To reverse the order of a number of color registers, simply use the CUT CLIP
  836. operation. Specify the last color of the color span as the FIRST color, then
  837. select the first color as the END color. Next, use the PASTE CLIP operation to
  838. paste the clip, beginning from the first color register. The registers will be
  839. inserted in the reverse order.
  840.  
  841.  
  842.                           TIPS | 32.
  843.                                |
  844.                      Saving in |
  845.                        reverse |
  846.                          order |
  847.                  ______________|
  848.  
  849.  
  850. Again, select the end color of the color span to be saved as the first color,
  851. then select the real first color as the end color. The program will then save
  852. the span in reverse order. 
  853.  
  854.  
  855.                           TIPS | 33.
  856.                                |
  857.                         Load a |
  858.                        part of |
  859.                      a palette |
  860.                           file |
  861.                  ______________|
  862.  
  863.  
  864. To load only a part of a palette file:
  865.  
  866.       1. copy entire current palette into clip
  867.  
  868.       2. load the complete palette file
  869.  
  870.       3. copy desired part into second clip
  871.  
  872.       4. restore old palette from first clip buffer
  873.  
  874.       5. copy second clip buffer to destination
  875.  
  876.  
  877.                     DISCUSSION | 34.
  878.                                |
  879.                         A word |
  880.                          about |
  881.                     Smoothness |
  882.                  ______________|
  883.                  
  884.  
  885. Smoothness of shades and fadings depends heavily on the number of available
  886. colors or hues. The original ST has only 512 colors in total. The introduction
  887. of the STE brought 4096 color shades. The Falcon offers 262,144 possible color
  888. combinations. The CyReL SUNRISE M16-1280 graphics cards feature a color palette
  889. ranger of 16,777,216 (16.7 Million) color shades.
  890.  
  891. The more color shades are available the better the program or operating system
  892. can reproduce the desired color transitions.
  893.  
  894. You can verify the accuracy or granularity of the color mapping of the
  895. operating system using the following simple test:
  896.  
  897. Select any color register and set all three color components to zero. Next, use
  898. either the red, green or blue color slider's right arrow until the value
  899. reaches 1000. Try to count the number of times the color actually changes. If
  900. you cannot detect the subtle changes anymore you got a system that can map
  901. color pretty well. On the original Atari there are only eight steps from 0 to
  902. 1000 (eight steps for red, eight for green, eight for blue = 512 colors). The
  903. CyReL M16-1280 cards offer 256 steps over the same range (256 for red, 256 for
  904. green, 256 for blue = 16.7 million).
  905.  
  906.  
  907.                     DISCUSSION | 35.
  908.                                |
  909.                         A word |
  910.                          about |
  911.                     High Color |
  912.                            and |
  913.                     True Color |
  914.                          Modes |
  915.                  ______________|
  916.          
  917.          
  918. As long as the Palette Master will be used in 2, 4, 16 or 256 color modes, the
  919. changing of a color register effects the entire screen. The modes where this
  920. effect can be noticed are called: palette based modes. Each pixel value
  921. actually represents a hardware color register number. If the content of the
  922. hardware color register is changed, the color of all pixels with this hardware
  923. color index change too. No matter where this color is used, it will reflect the
  924. new selection. Simple palette animations exploit that fact.
  925.  
  926. In High Color (16-bit/pixel) or True Color (24-bit/pixel) however, there is no
  927. change, except when a portion of the screen is redrawn in which the redefined
  928. color is used.
  929.  
  930. This is due to the fact that in these modes, the value of a pixel directly
  931. represents the actual color information being displayed. The Palette Master has
  932. been written with these special limitations in mind and will work in all the
  933. mentioned modes without any additional user inputs or modifications.
  934.  
  935.  
  936.                            HOW | 36.
  937.                             TO |
  938.                          ORDER |
  939.                           YOUR |
  940.                           COPY |
  941.                  ______________|
  942.  
  943. The  PALMASTR.PRG and PALMASTR.ACC files are being  distributed  as  a 
  944. commerial product.  A free demonstration package is available through  many 
  945. BBSs and information networks such as GEnie.
  946.  
  947. If  you find it useful  or use it regularly,  please register and  we  will 
  948. send you the the most current release of the full edition.
  949.  
  950. Please print out and fill in the provided order form.
  951.  
  952.      WHY SHOULD YOU?
  953.  
  954.           If you like the idea of 
  955.           quality commercial software packages
  956.           at shareware prices, and
  957.           if you already liked the idea of a free demo version,
  958.  
  959.           please help us to continue to support your ATARI platform.
  960.  
  961.           Further you will be entitled to discounts on future upgrades 
  962.           and we will provide you with important product information.
  963.  
  964.      SO WHY NOT?
  965.  
  966.           Just take a minute to complete and mail your order form today!
  967.  
  968.  
  969.  
  970.  
  971. PRICES
  972.  
  973. ------------------------------------------------------------------------------
  974. Order Code     Description              Quantity    Canada     U.S./Foreign
  975. ------------------------------------------------------------------------------
  976.  
  977. ACSM12         CyReL Serial Mouse
  978.                Manager & Driver           1-       Cdn $15.00   US $13.00
  979.                Release 1.02c
  980.  
  981. ACPM36         CyReL Palette Master       1-       Cdn $20.00   US $17.00
  982.                Release 3.6e
  983.  
  984. SHIPPING & HANDLING CHARGES
  985.  
  986. ------------------------------------------------------------------------------
  987. Quantity       U.S./Canada         Foreign
  988.                US$ / Cdn $           US $
  989. ------------------------------------------------------------------------------
  990.   1             $0.00               $2.50
  991.   2-5           $2.50               $5.00
  992.   5-10          $5.50              $10.00
  993.  10-over*      $10.00              $20.00
  994.  
  995. *= Contact Cybercube for more information.
  996.  
  997.  
  998. Cut along the dotted line.
  999. .......................................................................o/....
  1000.  
  1001. REGISTRATION FORM:      -Please print clearly-
  1002.  
  1003. LAST NAME:________________________ FIRST NAME: ______________________________
  1004.  
  1005. COMPANY (if applicable): ____________________________________________________
  1006.  
  1007. ADDRESS: ____________________________________________________________________
  1008.  
  1009. CITY: ______________________________  STATE/PROVINCE: _______________________
  1010.  
  1011. ZIP/POSTAL CODE: ___________________  COUNTRY: ______________________________
  1012.  
  1013. PHONE NR.: ( _____ ) _____ - _______  E-MAIL:  ______________________________
  1014.  
  1015. COMMENTS & SUGGESTIONS: _____________________________________________________
  1016.  
  1017. _____________________________________________________________________________
  1018.  
  1019. _____________________________________________________________________________
  1020.  
  1021.  
  1022.  
  1023. ORDER FORM:
  1024.  
  1025. Please read all the ordering information before signing this form.
  1026. Allow 3 to 4 weeks for delivery.
  1027.  
  1028. -----------------------------------------------------------------------------
  1029. QUANTITY | CODE |            DESCRIPTION              | UNIT PRICE |  TOTAL
  1030. ---------|------|-------------------------------------|------------|---------
  1031.          |      |                                     |            |
  1032. ---------|------|-------------------------------------|------------|---------
  1033.          |      |                                     |            |
  1034. ---------|------|-------------------------------------|------------|---------
  1035.          |      |                                     |            |
  1036. -------------------------------------------------------------------|---------
  1037.                                      Subtotal of all items ordered |
  1038.                                                                    |---------
  1039.                                       Ontario residents add 8% tax |
  1040.                                                                    |---------
  1041.                                         Canadian orders add 7% GST |
  1042.                                                                    |---------
  1043.                                      Shipping and handling charges |
  1044.                                      (See schedule above)          |---------
  1045.                                                                    |
  1046.                                                              TOTAL |
  1047.                                                                    ==========
  1048.  
  1049.  
  1050. DATE: ____ - ____ - 19____   NAME: __________________________________________
  1051.  
  1052.                         SIGNATURE: __________________________________________
  1053. Method of payment:
  1054. All orders must be prepaid. Check/Money Order in Canadian or U.S. funds only.
  1055.  
  1056.  
  1057.  
  1058. PLEASE ANSWER THE FOLLOWING QUESTIONS:
  1059.  
  1060. TYPE OF COMPUTER:        WHERE DID YOU LEARN ABOUT THIS PRODUCT:
  1061.  
  1062. [] 520, 1040             [] Magazine article/review _________________________
  1063.  
  1064. [] Mega ST               [] Magazine advertisment   _________________________
  1065.  
  1066. [] MEGA STE              [] Dealer visit ____________________________________
  1067.  
  1068. [] TT030                 [] Trade show   ____________________________________
  1069.  
  1070. [] Falcon 030            [] Network _________________________________________
  1071.  
  1072. [] Portable              [] BBS     _________________________________________
  1073.  
  1074.                          [] Personal recommendation
  1075.  
  1076.  
  1077. WHERE WILL YOU USE THIS PRODUCT:
  1078.  
  1079. [] Primarily at home       [] Primarily at work     [] Both equally
  1080.  
  1081.  
  1082. MAIN APPLICATION:
  1083.  
  1084. _____________________________________________________________________________
  1085.  
  1086. STof293/IV
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.                               Mail to:
  1093.  
  1094.                                    Cybercube Research Limited
  1095.                                    126 Grenadier Crescent
  1096.                                    Thornhill, ON, L4J 7V7, Canada
  1097.  
  1098.  
  1099. ...................................................................o/........
  1100. Cut along the dotted line.                               
  1101.  
  1102.  
  1103.  
  1104.  
  1105.                             DO | 37.
  1106.                            YOU |
  1107.                           NEED |
  1108.                           MORE |
  1109.                   INFORMATION? |
  1110.                  ______________|
  1111.  
  1112.  
  1113. If you would like to know more about our products, please contact us as shown
  1114. below and we will be glad to be of service.
  1115.  
  1116. Mail:      Cybercube Research Limited
  1117.            126 Grenadier Crescent
  1118.            Thornhill, Ontario, L4J 7V7
  1119.            Canada
  1120.  
  1121. Telephone: (416) 882 0294
  1122.  
  1123. Fax:       (416) 886 3261
  1124.  
  1125. BBS:       (416) 882 5895
  1126.  
  1127. GEnie:     CYBERCUBE
  1128.  
  1129. ============================================================================
  1130.  
  1131.  
  1132.                                | 38.
  1133.                           NOTE |
  1134.                  ______________|
  1135.  
  1136. All product names and brand names appearing in this document are registered
  1137. trademarks or trademarks of their respective holders.
  1138.  
  1139.                                                                   CM16A-293
  1140.  
  1141.  
  1142.