home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR36 / VGACON10.ZIP / VGACON.DOC next >
Text File  |  1994-01-05  |  10KB  |  312 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                 VGA Control v1.0
  12.  
  13.                                  Copyright 1994
  14.  
  15.                               All Rights Reserved
  16.  
  17.                           New-Ware Shareware Products
  18.                                8050 Camino Kiosco
  19.                               San Diego, CA 92122
  20.                                  (619) 455-6225
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                  Contents
  34.  
  35.  
  36.           1  Disclaimer  . . . . . . . . . . . . . . . . . . . . . . .  2
  37.           2  What is VGA Control?  . . . . . . . . . . . . . . . . . .  2
  38.           3  VGA Color Palette . . . . . . . . . . . . . . . . . . . .  2
  39.           4  The Main VGACon Controls  . . . . . . . . . . . . . . . .  3
  40.           5  VGACon Palette File Operations  . . . . . . . . . . . . .  3
  41.           6  Exiting VGACon  . . . . . . . . . . . . . . . . . . . . .  4
  42.           7  Using VGACon in a Batch File  . . . . . . . . . . . . . .  4
  43.           8  Usage License and Registration  . . . . . . . . . . . . .  4
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.                                        i
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.   1  Disclaimer
  86.  
  87.  
  88.        New-Ware hereby disclaims all warranties relating to this product,
  89.   whether express or implied, including without limitation any implied
  90.   warranties of merchantability or fitness for a particular purpose. New-Ware
  91.   cannot and will not be liable for any special, incidental, consequential,
  92.   indirect or similar damages due to loss of data or any other reason, even if
  93.   New-Ware or an authorized New-Ware agent has been advised of the possibility
  94.   of such damages.  In no event shall the liability for any damages ever
  95.   exceed the price paid for the license to use software, regardless of the
  96.   form and/or extent of the claim.  The user of this program bears all risk as
  97.   to the quality and performance of the software.
  98.  
  99.  
  100.   2  What is VGA Control?
  101.  
  102.  
  103.        VGA Control (hereafter known as VGACon) was originally designed as a
  104.   tool to support experimentation with manipulating the VGA color palette.  It
  105.   provides a fast, direct visual interface between the user and his/her VGA
  106.   video card.  The most important feature that VGACon provides is the
  107.   capability to save a specific color palette to a user-named disk file.  When
  108.   executed with a command line parameter that is a VGACon palette file, VGACon
  109.   will set the VGA palette accordingly.  This allows creating palette files
  110.   for various applications and using VGACON.EXE in batch files to set and
  111.   reset the VGA palette before and after running the application.
  112.  
  113.  
  114.   3  VGA Color Palette
  115.  
  116.  
  117.        The standard VGA palette consists of 16 colors numbered and named as
  118.   follows:
  119.  
  120.             0    Black               8    Dark Gray
  121.             1    Blue                9    Light Blue
  122.             2    Green               10   Light Green
  123.             3    Cyan                11   Light Cyan
  124.             4    Red                 12   Light Red
  125.             5    Magenta             13   Light Magenta
  126.             6    Brown               14   Yellow
  127.             7    Light Gray          15   White
  128.  
  129.        Each color is formed by a combination of three RGB (for Red, Green,
  130.   Blue) values and each value can vary from 0 to 63.  For example, the
  131.   standard RGB value for Magenta is 42, 0, 42 and for Light Blue is 21, 21,
  132.   63.  With VGACon you can change the RGB combination to suit your tastes.
  133.  
  134.  
  135.  
  136.                                      - 2 -
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.   4  The Main VGACon Controls
  144.  
  145.  
  146.        Operation of VGACon is simple and very straightforward.  When executed,
  147.   VGACON will first check to see if the current video system supports standard
  148.   VGA color manipulation.  If not, the program will abort with an appropriate
  149.   message.  The main VGACon display consists of a menu bar at the top, a large
  150.   interactive dialog box, and a status bar at the bottom.  A color selection
  151.   matrix (16 colors) box appears in the upper left hand corner of the dialog
  152.   box.  To the right of the color selection box there is a large box that
  153.   displays the current color and above that box is the standard color name and
  154.   palette number.
  155.  
  156.        The color selection matrix is a control through which the active color
  157.   is selected.  Use the mouse or the cursor keypad to select the desired
  158.   color.  Note that the color display box will change as the active color
  159.   changes.
  160.  
  161.        Just below the color display box are two push buttons.  The "Restore
  162.   RGB" button will restore the current color RGB to the value detected at
  163.   start-up.  The "Restore PAL" button will restore the entire VGA palette to
  164.   it's original start-up values.  So feel free to experiment without concern
  165.   that you'll have to reboot your machine to get rid of the weird colors.
  166.  
  167.        Three horizontal slider bars dominate the lower half of the dialog box.
  168.   These bars are the controls to use to change the Red, Green, or Blue values
  169.   for the palette color that is active.  Each slider control can be moved via
  170.   the keypad or mouse the full range of 0 (left) to 63 (right) and the color
  171.   display box will reflect the current RGB value for the active color as the
  172.   sliders are moved.
  173.  
  174.        Don't think that your VGA Brown really looks like brown?  Select the
  175.   Brown color from the matrix (row #2, column #3) and move the RGB sliders
  176.   until it looks like you think it should look.
  177.  
  178.  
  179.   5  VGACon Palette File Operations
  180.  
  181.  
  182.        Once you have set the VGA palette the way you want, you can save the
  183.   current palette to a file of your choice.  Either pull down the "File" menu
  184.   (Alt+F or mouse) or press F2 to activate the file save dialog.  This dialog
  185.   contains controls that allows you to specify the name and host directory of
  186.   the palette file.  You MUST use the extension of .PAL!  So if you wish to
  187.   save the current palette to a file named WP.PAL, pop up the save file
  188.   dialog, enter WP.PAL, and select "Ok" or press the "Enter" key.  Each PAL
  189.   file is 48 bytes long.
  190.  
  191.  
  192.  
  193.  
  194.                                      - 3 -
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.        You may also load a PAL file via the "File" menu or by pressing the
  202.   "F3" key.  If you wish to make a specific directory in your system active,
  203.   pull down the "File" menu and select "Directory Change" or press the "F5"
  204.   key.  This is the control to use if you need to save a palette file to a
  205.   directory on a drive that is not active.
  206.  
  207.        Remember, palette files MUST have a .PAL extension!
  208.  
  209.  
  210.   6  Exiting VGACon
  211.  
  212.  
  213.        You have the option of quitting VGACon and restoring your VGA colors to
  214.   the values they had when you executed VGACON or of quitting and retaining
  215.   the current values.  "Alt+X" ALWAYS exits immediately and restores the VGA
  216.   colors as they were at start-up.  To quit and retain the current color
  217.   settings, select the "Quit" menu and then select "Retain Changes".  VGACon
  218.   will exit to DOS and your colors will remain intact unless and until some
  219.   other program resets them.
  220.  
  221.  
  222.   7  Using VGACon in a Batch File
  223.  
  224.  
  225.        One use for this utility is to set up a specific palette for different
  226.   programs.  For example, perhaps you wish to have a different "look" when in
  227.   Word Perfect. First, use VGACon to create a "normal" PAL file.  Start the
  228.   program and immediately save the current palette to a file, perhaps named
  229.   NORMAL.PAL.  Then create the palette you wish to use in Word Perfect and
  230.   save it to a file perhaps named WP.PAL.  Create a small BAT file from which
  231.   to load and run WP as follows:
  232.  
  233.             VGACON WP.PAL
  234.             WP.EXE
  235.             VGACON NORMAL.PAL
  236.  
  237.   This strategy will work fine as long as the target application does not
  238.   itself manipulate the VGA palette.
  239.  
  240.  
  241.   8  Usage License and Registration
  242.  
  243.  
  244.        VGACon is Shareware but it is not required to register VGACon in all
  245.   cases in order to continue using it.  Individuals that use VGACon on their
  246.   personal computers at home for personal use are hereby granted a license to
  247.   continue operation without registering.  These users are, however,
  248.   encouraged to register the product by sending a contribution of any amount
  249.  
  250.  
  251.  
  252.                                      - 4 -
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.   they deem appropriate.  Those submitting individual registrations in the
  260.   amount of $10.00 or more will receive a 3 1/2" diskette containing the
  261.   latest version.
  262.        All business users, corporations, governments, and other institutions
  263.   are required to register VGACon for the fee of $10.00 within 30 days of
  264.   first evaluating the product.  If after 30 days of first running the VGACon
  265.   program, it is decided that the program is useful a registration must be
  266.   submitted or the temporary usage license is revoked.  Site licenses are
  267.   available for company use of more than one program.
  268.  
  269.        Please use the following form to register:
  270.  
  271.        Company Name:__________________________________________
  272.  
  273.        Individual Name:_______________________________________
  274.  
  275.        Address #1:____________________________________________
  276.  
  277.        Address #2:____________________________________________
  278.  
  279.        City:__________________________________________________
  280.  
  281.        State:_____________________________ Country:___________
  282.  
  283.        ZIP or Postal Code:____________________________________
  284.  
  285.        This is an individual [ ] or a company [ ] registration.
  286.  
  287.        Remitted Fee: ($10.00 if Company)______________________
  288.  
  289.        Credit Card # (MCard/Visa only):_______________________
  290.  
  291.        Exp. Date:_____________________________________________
  292.  
  293.        Signature:_____________________________________________
  294.  
  295.  
  296.        Remit To:
  297.  
  298.        New-Ware
  299.        8050 Camino Kiosco
  300.        San Diego, CA 92122
  301.        (619) 455-6225 [Voice orders]
  302.              455-5226 [BBS orders]
  303.  
  304.   Copyright 1994 by New-Ware, all rights reserved.
  305.  
  306.  
  307.  
  308.  
  309.  
  310.                                      - 5 -
  311.  
  312.