home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 2 / ctrom_ii_b.zip / ctrom_ii_b / PROGRAM / ASSEMBLE / MODEX104 / PALEDIT / PALEDIT.DOC < prev    next >
Text File  |  1993-05-14  |  7KB  |  167 lines
  1.  
  2. PALEDIT - A Simple VGA 256 Color Palette Editor
  3.  
  4.  
  5. PALEDIT is distributed with MODEXnnn.ZIP, the general purpose MODE X
  6. Library for VGA Graphics.
  7.  
  8. WHAT YOU NEED TO RUN PALEDIT:
  9.  
  10.     * A Vga Monitor
  11.     * A Microsoft Compatible Mouse
  12.  
  13.     A Mouse is most definitely required, as the keyboard is used for
  14.     nothing except entering file names.
  15.  
  16. FILES NEEDED IN THE CURRENT DIRECTORY:
  17.  
  18.     PALEDIT.EXE  - The Palette Editor Program
  19.     CHARSETS.CS  - The Palette Editor's Internal Fonts
  20.     MOUSEIMG.CS  - The Palette Editor's Mouse Pointer
  21.  
  22. SAMPLE PALETTE FILE THAT SHOULD BE INCLUDED:
  23.  
  24.      RGB.PAL   - A Simple Palette with Reds, Greens, and Blues
  25.      PRIME.PAL    - A Simple Palette
  26.      GAMECOLR.PAL - A Bright Palette from a Game of mine.
  27.  
  28. WHAT IT EDITS:
  29.  
  30.      The VGA DAC Registers, all 256 of them.
  31.  
  32. HOW IT WORKS/FEATURES:
  33.  
  34.     PALEDIT allows the user to see the entire VGA Palette of 256 colors
  35.     and select and modify the RED, GREEN, and BLUE values of any individual
  36.     color (DAC) register.  The entire group of 256 colors can be saved to
  37.     a disk file for later retrieval.
  38.  
  39.     Individual "SLIDERS" show the current RED, GREEN, and BLUE color
  40.     components of the current color and allow them to be changed.
  41.  
  42.     The Following operations can be performed.
  43.  
  44.     * Raise, Lower, and set the RED, GREEN, or BLUE components.
  45.     * Copy the current RGB values to another Color (DAC) Register
  46.     * Brighten the selected color
  47.     * Darken and selected color
  48.     * Reset the selected color to its original state
  49.     * Blend an entire range of colors, creating a smooth
  50.       Transition from one color to another
  51.     * Optionally Lock out the first 16 colors to prevent
  52.       Accidental Modification
  53.  
  54. DESCRIPTION OF OBJECTS/FEATURES FROM THE TOP DOWN:
  55.  
  56.     COLOR SLIDERS:  In the upper left of the screen there are
  57.         Three Rectangular Boxes: One for each primary color:
  58.         RED, GREEN, and BLUE.  Each Box has an arrow at each
  59.         end, and a scale bar in the middle, connecting the two
  60.         arrows.  The scale bar is much like a thermometer,
  61.         indicating how much of that color is in the selected
  62.         color.  To the right of each Box, the name of the color
  63.         is indicated, along with the content color in the form
  64.         of a number from 0 to 63; where 0 means none of that
  65.         color goes into making the selected color, and 63 means
  66.         that the selected color is saturated with that color.
  67.  
  68.         Clicking the mouse on the slider's left arrow box will
  69.         decrease the amount of that primary color in the selected
  70.         color.  Holding the mouse button down will reduce the
  71.         color value all the way to 0.
  72.  
  73.         Clicking the mouse on the slider's right arrow box will
  74.         increase the amount of that primary color in the selected
  75.         color.  Holding the mouse button down will increase the
  76.         color value all the way to 63.
  77.  
  78.         Clicking the mouse on the scale bar will set the amount
  79.         of that primary color to the value the represents that
  80.         position on the slider.
  81.  
  82.     LOCK Button:  Clicking the button toggles the lockout of the
  83.         first 16 colors.  When they are locked out, they can not
  84.         be modified, and when selected the word "LOCKED" will
  85.         appear below the color # on the Color Information Display.
  86.  
  87.     LOAD Button:  Clicking this button will load the Palette file
  88.         that is named in the Palette File name box.  If no name is
  89.         given or no such file exists, then nothing will be loaded.
  90.  
  91.     SAVE Button: Clicking this button will save the current Palette
  92.         in a file using the name given in the Palette File Name Box.
  93.         If a Valid name is not provided, nothing will be saved.
  94.  
  95.     QUIT Button: Clicking this button will return you to DOS.
  96.         Nothing is saved, and no confirmation is given.
  97.  
  98.  
  99.     Color Information Display:  This Box is on the left side of the
  100.         Screen, below the Color Sliders.  It shows the number of the
  101.         currently selected color (from 0 to 255) and indicates if
  102.         that color is locked.  To the right of this box is a big
  103.         square showing the current color.
  104.  
  105.     LIGHTER Button:  Clicking this button will make the selected
  106.         color brighter.
  107.  
  108.     DARKER Button:  Clicking this button will make the selected
  109.         color darker.
  110.  
  111.     RESET Button:  Clicking this button will restore the selected
  112.         color to the value it had when it was first selected.
  113.  
  114.     BLEND Button:  Clicking this button will let you Blend a range
  115.         of colors together.  One end of the range of colors is the
  116.         currently selected color.  After Clicking the BLEND button.
  117.         You must click on the color at the other end of the range
  118.         in the Palette Display Box.  All of the colors in between
  119.         those two colors will be changed to represent a gradual
  120.         transition from the color at one end to the color at the
  121.         other end.
  122.  
  123.     PALETTE FILE NAME BOX:  This Text Box is used to enter the name
  124.         of a Palette file to load or the name to save the current
  125.         Palette as.  Just click on the Box, and it will change color
  126.         and a flashing cursor will appear.  Now you type in a filename
  127.         or edit the existing filename.  Press <RETURN> or click
  128.         outside the text box to end editing.
  129.  
  130.     PALETTE DISPLAY BOX:  This Box shows all 256 colors in an array
  131.         of 32 by 8 color blocks.  The Currently Selected Color will
  132.         have a Box around it.  Clicking on a color with the Left
  133.         Mouse button will make that color the new currently selected
  134.         color.  Clicking on a color with the Right Mouse Button will
  135.         copy the color value from the old selected color to it, before
  136.         it is made the new selected color.
  137.  
  138.     Message Bar:  At the very bottom of the screen, this Bar will display
  139.         information and messages for various functions.
  140.  
  141. PALETTE FILE FORMAT:
  142.  
  143.      BINARY image, in order of VGA DAC (Color) Number.  3 Bytes Per
  144.      Color, 256 Colors.  768 Bytes total.  The Files will be exactly
  145.      768 bytes in size.
  146.  
  147.     COLOR:
  148.         RED:    1 BYTE
  149.         GREEN: 1 BYTE
  150.         BLUE:   1 BYTE
  151.  
  152.     PALETTE:  Array (0 to 255) of COLOR
  153.  
  154. COMMENTS, QUESTIONS, BUG REPORTS, etc:
  155.  
  156.     Send the to the Author:  Matt Pritchard
  157.  
  158.     Through the 80xxx Fidonet Echo or
  159.  
  160.     Matt Pritchard
  161.     P.O. Box 140264
  162.     Irving, TX  75014
  163.  
  164. CREDITS:
  165.  
  166.     This Palette Editor was written in QuickBASIC 4.5
  167.