--- /dev/null
+ \r
+PALEDIT - A Simple VGA 256 Color Palette Editor\r
+ \r
+ \r
+PALEDIT is distributed with MODEXnnn.ZIP, the general purpose MODE X\r
+Library for VGA Graphics.\r
+ \r
+WHAT YOU NEED TO RUN PALEDIT:\r
+ \r
+ * A Vga Monitor\r
+ * A Microsoft Compatible Mouse\r
+ \r
+ A Mouse is most definitely required, as the keyboard is used for\r
+ nothing except entering file names.\r
+ \r
+FILES NEEDED IN THE CURRENT DIRECTORY:\r
+ \r
+ PALEDIT.EXE - The Palette Editor Program\r
+ CHARSETS.CS - The Palette Editor's Internal Fonts\r
+ MOUSEIMG.CS - The Palette Editor's Mouse Pointer\r
+ \r
+SAMPLE PALETTE FILE THAT SHOULD BE INCLUDED:\r
+ \r
+ RGB.PAL - A Simple Palette with Reds, Greens, and Blues\r
+ PRIME.PAL - A Simple Palette\r
+ GAMECOLR.PAL - A Bright Palette from a Game of mine.\r
+ \r
+WHAT IT EDITS:\r
+ \r
+ The VGA DAC Registers, all 256 of them.\r
+ \r
+HOW IT WORKS/FEATURES:\r
+ \r
+ PALEDIT allows the user to see the entire VGA Palette of 256 colors\r
+ and select and modify the RED, GREEN, and BLUE values of any individual\r
+ color (DAC) register. The entire group of 256 colors can be saved to\r
+ a disk file for later retrieval.\r
+ \r
+ Individual "SLIDERS" show the current RED, GREEN, and BLUE color\r
+ components of the current color and allow them to be changed.\r
+ \r
+ The Following operations can be performed.\r
+ \r
+ * Raise, Lower, and set the RED, GREEN, or BLUE components.\r
+ * Copy the current RGB values to another Color (DAC) Register\r
+ * Brighten the selected color\r
+ * Darken and selected color\r
+ * Reset the selected color to its original state\r
+ * Blend an entire range of colors, creating a smooth\r
+ Transition from one color to another\r
+ * Optionally Lock out the first 16 colors to prevent\r
+ Accidental Modification\r
+ \r
+DESCRIPTION OF OBJECTS/FEATURES FROM THE TOP DOWN:\r
+ \r
+ COLOR SLIDERS: In the upper left of the screen there are\r
+ Three Rectangular Boxes: One for each primary color:\r
+ RED, GREEN, and BLUE. Each Box has an arrow at each\r
+ end, and a scale bar in the middle, connecting the two\r
+ arrows. The scale bar is much like a thermometer,\r
+ indicating how much of that color is in the selected\r
+ color. To the right of each Box, the name of the color\r
+ is indicated, along with the content color in the form\r
+ of a number from 0 to 63; where 0 means none of that\r
+ color goes into making the selected color, and 63 means\r
+ that the selected color is saturated with that color.\r
+ \r
+ Clicking the mouse on the slider's left arrow box will\r
+ decrease the amount of that primary color in the selected\r
+ color. Holding the mouse button down will reduce the\r
+ color value all the way to 0.\r
+ \r
+ Clicking the mouse on the slider's right arrow box will\r
+ increase the amount of that primary color in the selected\r
+ color. Holding the mouse button down will increase the\r
+ color value all the way to 63.\r
+ \r
+ Clicking the mouse on the scale bar will set the amount\r
+ of that primary color to the value the represents that\r
+ position on the slider.\r
+ \r
+ LOCK Button: Clicking the button toggles the lockout of the\r
+ first 16 colors. When they are locked out, they can not\r
+ be modified, and when selected the word "LOCKED" will\r
+ appear below the color # on the Color Information Display.\r
+ \r
+ LOAD Button: Clicking this button will load the Palette file\r
+ that is named in the Palette File name box. If no name is\r
+ given or no such file exists, then nothing will be loaded.\r
+ \r
+ SAVE Button: Clicking this button will save the current Palette\r
+ in a file using the name given in the Palette File Name Box.\r
+ If a Valid name is not provided, nothing will be saved.\r
+ \r
+ QUIT Button: Clicking this button will return you to DOS.\r
+ Nothing is saved, and no confirmation is given.\r
+ \r
+ \r
+ Color Information Display: This Box is on the left side of the\r
+ Screen, below the Color Sliders. It shows the number of the\r
+ currently selected color (from 0 to 255) and indicates if\r
+ that color is locked. To the right of this box is a big\r
+ square showing the current color.\r
+ \r
+ LIGHTER Button: Clicking this button will make the selected\r
+ color brighter.\r
+ \r
+ DARKER Button: Clicking this button will make the selected\r
+ color darker.\r
+ \r
+ RESET Button: Clicking this button will restore the selected\r
+ color to the value it had when it was first selected.\r
+ \r
+ BLEND Button: Clicking this button will let you Blend a range\r
+ of colors together. One end of the range of colors is the\r
+ currently selected color. After Clicking the BLEND button.\r
+ You must click on the color at the other end of the range\r
+ in the Palette Display Box. All of the colors in between\r
+ those two colors will be changed to represent a gradual\r
+ transition from the color at one end to the color at the\r
+ other end.\r
+ \r
+ PALETTE FILE NAME BOX: This Text Box is used to enter the name\r
+ of a Palette file to load or the name to save the current\r
+ Palette as. Just click on the Box, and it will change color\r
+ and a flashing cursor will appear. Now you type in a filename\r
+ or edit the existing filename. Press <RETURN> or click\r
+ outside the text box to end editing.\r
+ \r
+ PALETTE DISPLAY BOX: This Box shows all 256 colors in an array\r
+ of 32 by 8 color blocks. The Currently Selected Color will\r
+ have a Box around it. Clicking on a color with the Left\r
+ Mouse button will make that color the new currently selected\r
+ color. Clicking on a color with the Right Mouse Button will\r
+ copy the color value from the old selected color to it, before\r
+ it is made the new selected color.\r
+ \r
+ Message Bar: At the very bottom of the screen, this Bar will display\r
+ information and messages for various functions.\r
+ \r
+PALETTE FILE FORMAT:\r
+ \r
+ BINARY image, in order of VGA DAC (Color) Number. 3 Bytes Per\r
+ Color, 256 Colors. 768 Bytes total. The Files will be exactly\r
+ 768 bytes in size.\r
+ \r
+ COLOR:\r
+ RED: 1 BYTE\r
+ GREEN: 1 BYTE\r
+ BLUE: 1 BYTE\r
+ \r
+ PALETTE: Array (0 to 255) of COLOR\r
+ \r
+COMMENTS, QUESTIONS, BUG REPORTS, etc:\r
+ \r
+ Send the to the Author: Matt Pritchard\r
+ \r
+ Through the 80xxx Fidonet Echo or\r
+ \r
+ Matt Pritchard\r
+ P.O. Box 140264\r
+ Irving, TX 75014\r
+ \r
+CREDITS:\r
+ \r
+ This Palette Editor was written in QuickBASIC 4.5\r