home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / cis / ozpat.arc / OZPATCOL.DOC next >
Text File  |  1989-09-02  |  4KB  |  88 lines
  1.  
  2.     OZPATCOL - A color patching utility for Ozarks West Software programs
  3.                    (c)1989  Steve Sneed   CIS 71520,77
  4.                            All rights reserved
  5. -----------------------------------------------------------------------------
  6.  
  7. OZPATCOL is a utility program used to change the default colors used by the
  8. Ozarks West Software programs OZBEXT and OZRLE (and other programs.)  It
  9. modifies the colors tables stored internally in the program so that no
  10. external data/configuration files are required.  Both programs maintain
  11. two colors tables (one used for color video systems, one for monochrome);
  12. this program allows either to be modified independently of the other.
  13.  
  14. OZPATCOL works only on OZBEXT version 13.1b and later, and OZRLE version 8.8d
  15. and later.  A special "key" has been added to these revision levels of the
  16. programs; the patcher will report an error and abort if the key is not found.
  17.  
  18. A special request: if you redistribute either OZBEXT or OZRLE, please do so
  19. in "unpatched" condition - that way the new user will be able to work from
  20. the original default colors.  Thanks!
  21.  
  22. ---
  23.  
  24. Syntax: OZPATCOL [filename{.EXE}]
  25.  
  26. [Filename] is the name of the program executable to be patched.  You may pro-
  27. vide path information with the filename.  The extension is forced to .EXE.
  28.  
  29. OZPATCOL will verify the file exists and that the "key" is in the program.
  30. If either condition fails the program aborts with an appropriate error message.
  31. The program then reads in the color tables and displays its main screen.  The
  32. possible commands are:
  33.  
  34.  
  35. F1 - Edit the color tables
  36.  
  37.        This command allows you to modify any or all of the colors in the cur-
  38.        rent table.  Use the up- and down-arrow keys to move to the color to
  39.        edit; pressing [Enter] on a color skips to the next; pressing [Enter]
  40.        on the last color exits editing.  You can also press [ESC] at any time
  41.        to abort the edit, however doing so abandons all changes made.
  42.  
  43.        Colors are entered as a two-digit hexidecimal number.  You must enter
  44.        two digits.  The first digit is the background color and the second is
  45.        the foreground color.  A chart of example colors is displayed, and a
  46.        small example of the foreground and background color mix for each type
  47.        of color setting is shown next to the edit line.  Note that, while only
  48.        the "normal" background colors (0 - 7) are displayed in the chart, all
  49.        255 possible color combinations are available; adding 8 to the back-
  50.        ground value (1 becomes 9, 4 becomes B, etc.) keeps the same background
  51.        color but makes the foreground color "blink".  (For most things blinking
  52.        text is anoying, but many people like it for the error messages.)  The
  53.        chart has the background colors down the side and the foregrouund colors
  54.        along the top; to find your color number, move down the side of the
  55.        chart to the background you want, and then across that row to the column
  56.        of the foreground you want.  Put the row and column numbers together
  57.        (row first) and you have your color.
  58.  
  59.  
  60. F2 - Swap between Color and Monochrome sets
  61.  
  62.        This allows you to choose which color set you want to edit.  The patcher
  63.        looks to see what type of video hardware is installed at startup, and
  64.        then makes that video type color set the first or "default" set to
  65.        edit.  Normally you will just want to edit the one color set and exit,
  66.        but you might want to edit both (for example, if you use one copy of
  67.        the program on more than one system with different video types.)
  68.  
  69.  
  70. F10 - Save changes to program file
  71.  
  72.        Patches any changes you have made into the program file you selected on
  73.        the command line.  This does not exit the program.
  74.  
  75. ESC - Exit the patch program
  76.  
  77.        Exit OZPATCOL.  Changes are not saved; you must save first with the F10
  78.        command.
  79.  
  80. ---
  81.  
  82. Steve Sneed
  83. CIS ID 71520,77
  84. 409 San Juanico
  85. Santa Maria, CA.  93455
  86.  
  87. <eof>
  88.