home *** CD-ROM | disk | FTP | other *** search
/ Compu-Fix / Compu-Fix.iso / misc / palet / vpt.man < prev   
Encoding:
Text File  |  1993-03-01  |  11.3 KB  |  274 lines
  1.  
  2.                ┌───────────────────────────────────────────┐
  3.                │ VIDEO GRAPHICS ARRAY - PALETTE TOOL V3.01 │
  4.                └───────────────────────────────────────────┘
  5.  
  6.        (C) Copyright 1988 by clySmic software.  All rights reserved.
  7.  
  8.      
  9.      I. INTRODUCTION
  10.  
  11.      This program allows VGA (PS/2 Model 50, 60 or 80) or Display
  12.      Adapter/2 or 100% compatible VGA clone owners to:
  13.  
  14.      ■    View the quarter-million color palette they've been hearing
  15.           about,
  16.  
  17.      ■    Set any attribute (0 - 15) to any color,
  18.  
  19.      ■    Have the colors "stick" with most programs,
  20.  
  21.      ■    Load and save their favorite settings in palette files, and
  22.  
  23.      ■    Use the program in a command-line mode.
  24.  
  25.  
  26.      II. FILES INCLUDED
  27.  
  28.      ■ VPT.EXE................The VGA Palette Tool.
  29.      ■ VPT.MAN................This documentation.
  30.      ■ LOCK.COM...............A small TSR that locks EGA and VGA
  31.                               palette registers (optional).
  32.      ■ TSTPATN.EXE............A television test pattern to judge
  33.                               colors with.
  34.      
  35.      
  36.      III. INTERACTIVE MODE
  37.  
  38.      Command: VPT
  39.  
  40.      VPT operates in text mode and allows setting of any or all of the
  41.      sixteen attributes available in text mode.  There are three
  42.      sliders (one each for Red, Green, and Blue), each of which can
  43.      assume any of 64 values (0 through 63).  The current values are
  44.      displayed next to the sliders on the right side of the screen.
  45.  
  46.      Key(s)                   Action
  47.      -----------------        ----------------------------------------
  48.  
  49.      Left/Right Arrows        Moves the R,G, or B slider between 0 and
  50.                               63 to control the intensity of the R, G,
  51.                               or B signal.
  52.  
  53.      Control Left/Right       As above, but moves five positions
  54.                               instead of one.
  55.  
  56.      PageUp/PageDown          Selects an attribute between 0 and 15 to
  57.                               work with.
  58.  
  59.      B                        Backdrop mode.  This makes the current
  60.                               attribute the background and places text
  61.                               with all sixteen attributes on the
  62.                               screen so you can see the combinations.
  63.                               Any key exits this mode.
  64.  
  65.      D                        Loads the default, boot-up colors.
  66.  
  67.      L                        Loads the colors from a file of your
  68.                               choice, if no file is specified, STD.VPT
  69.                               is assumed.  You don't need to add the
  70.                               .VPT extension.
  71.  
  72.      S                        Saves the colors to a file of your
  73.                               choice, if no file is specified, STD.VPT
  74.                               is assumed.  Note: all .VPT files are
  75.                               saved to the directory VPT is found in,
  76.                               NOT the current directory (unless
  77.                               VPT.EXE is there!)
  78.  
  79.      O                        Sets the overscan (border) color to the
  80.                               current attribute.  NO guarantees are
  81.                               made about the "stickyness" of this
  82.                               setting.
  83.  
  84.      End                      Exits VPT.
  85.  
  86.      Keys Used While Loading or Saving a File:
  87.  
  88.      Backspace                Erases the last character in the file
  89.                               name.
  90.  
  91.      Ctrl-Backspace           Erases all the characters in the file
  92.                               name.
  93.  
  94.      
  95.      IV. COMMAND-LINE MODE
  96.  
  97.      Command: VPT [option]
  98.  
  99.      Where [option] is one of the following (capitalization does not
  100.      matter):
  101.  
  102.      /L[filename]             This loads the specified file, if there
  103.                               is one.  If there isn't, you will get an
  104.                               error message.  If [filename] is not
  105.                               specified, STD.VPT will be assumed.
  106.  
  107.      /C[filename]             Like /L above, but does an ANSI clear
  108.                               screen afterwards and displays no
  109.                               messages.
  110.  
  111.      /D                       This loads the default palette.  These
  112.                               are the colors assigned by IBM and are
  113.                               the ones you would see if you didn't use
  114.                               VPT.
  115.  
  116.      /X                       This resets the "palette load on mode
  117.                               change" option to true (see TECHNICAL
  118.                               INFORMATION, below, for an explanation).
  119.  
  120.      /?                       Presents a help list recapping your
  121.                               options.
  122.  
  123.      Any other option will generate an error message.
  124.  
  125.      The main reason for command-line mode is to include VPT in batch
  126.      files.  First you would run VPT interactively, find the colors
  127.      you like, save them in the STD.VPT file, then include a line like
  128.      the following:
  129.  
  130.      VPT /L
  131.  
  132.      in your batch file.  This will load your saved colors when you
  133.      run the batch file.  VPT.EXE should be placed in a directory on
  134.      your PATH.  If you don't wish to see the informational messages
  135.      produced by VPT in command-line mode, you can redirect the output
  136.      to the null device (a.k.a. the bit bucket) as follows:
  137.  
  138.      VPT /L >NUL:
  139.  
  140.      Note that error messages *cannot* be redirected and will still be
  141.      seen.
  142.  
  143.      
  144.      V. MORE EXAMPLES
  145.  
  146.      VPT /L123PAL             Loads the palette file 123PAL.VPT.  This
  147.                               assumes you created such a file using
  148.                               the interactive mode of VPT.
  149.  
  150.      VPT /C                   Loads STD.VPT and clears the screen.
  151.  
  152.      VPT /?                   Brings forth help.
  153.  
  154.      
  155.      VI. TECHNICAL INFORMATION
  156.  
  157.      ■ GENERAL
  158.  
  159.      VPT works by making BIOS calls that manipulate the DAC (digital
  160.      to analog converter) color registers; each register (there are
  161.      256, to allow for the 300x200x256 mode) contains 18 bits, 6 each
  162.      for Red, Green, and Blue.  Each RGB value can go from 0 to 63,
  163.      all the combinations makes for 262,144 possible colors.  You can
  164.      show up to sixteen of these at a time in the text modes, each of
  165.      the sixteen "attributes" can be any color (or all the same color)
  166.      out of the quarter-million.
  167.  
  168.      ■ MODE SETS
  169.  
  170.      Normally BIOS resets the EGA and DAC color registers whenever a
  171.      mode set is done.  VPT makes its colors stick across a mode
  172.      change by using the "Default Palette Loading During Mode Set"
  173.      BIOS call to disable this action.  If, for some reason, you
  174.      desire to return this to its default, boot-up condition, use VPT
  175.      /X.  Then a subsequent mode change, like MODE CO80, will cause
  176.      the default conditions to prevail.
  177.  
  178.      ■ REGISTERS, REGISTERS EVERYWHERE
  179.  
  180.      The DAC color registers are mapped through the EGA palette
  181.      registers, so, for instance, the attribute "Brown" (6) maps to
  182.      the color $14 on an EGA (out of its 64 possible colors); on the
  183.      VGA, DAC color register $14 contains $2A,$15,$00 for the R, G,
  184.      and B values (these are all default values).
  185.  
  186.      In order to not to be foiled by EGA-aware programs, VPT resets
  187.      the EGA palette registers to their default values each time it is
  188.      run.  If a program remaps the EGA registers, and then counts on a
  189.      mode set to return them to normal when it exits, the registers
  190.      will *stay* remapped because of the disabling of the "palette
  191.      load on mode set".  Simply type VPT /C (for instance) and it will
  192.      remap the EGA registers to their default values.
  193.  
  194.      Note that EGA-aware programs will still use their own colors
  195.      while the program is running, VPT doesn't prevent that.
  196.  
  197.      ■ PALETTE FILES
  198.  
  199.      The saved palette files have an extension of .VPT which you NEVER
  200.      need to type when using VPT.
  201.  
  202.      For DOS 3.x users, they are stored in the same directory that VPT
  203.      is run from.  For instance, say VPT is stored in the C:\BIN
  204.      directory, that directory is on your PATH, and you are in
  205.      C:\ZUUL.  The palette file will be stored in C:\BIN.  For DOS 2.x
  206.      users, the file will be stored in the root directory.  DOS 1.x
  207.      users are quite out of luck, why do one have advanced video but
  208.      DOS 1.x anyway?
  209.  
  210.      VPT attempts to check for a valid palette file by not loading any
  211.      files that aren't exactly 49 bytes long.  You will get a 'bad
  212.      .VPT file' message.  If a file is 49 bytes long and has a .VPT
  213.      extension but *isn't* a VPT palette file, it will get loaded
  214.      anyway.  The colors should be interesting.
  215.  
  216.      ■ REFERENCES
  217.  
  218.      VPT was written based on technical information from IBM's Display
  219.      Adapter/2 Technical Reference.  There is very little discussion
  220.      of some aspects of the VGA, but all the BIOS calls are there
  221.      (even if they're not explained well).  If anyone has any other
  222.      sources of tech info (especially about the MCGA) please let me
  223.      know.
  224.  
  225.  
  226.      VII. CAVEATS
  227.  
  228.      I don't believe VPT will run correctly on the MCGA in the Models
  229.      25 and 30.  I only have Model 50s and 60s to test it on, but
  230.      since part of the program relies on mapping through the EGA
  231.      palette registers (which the MCGA doesn't have), I don't see how
  232.      it could work.  I also am not sure if the VGA detection routine
  233.      in VPT would think the MCGA is a valid VGA or not.  EGA-aware and
  234.      VGA-aware programs still will run with their own colors, all
  235.      (okay, almost all, who knows what's out there?) other programs
  236.      will use the colors VPT sets.
  237.  
  238.      If you want to "lock" the colors you set against any programs
  239.      that try to change them using BIOS, set your colors, then run the
  240.      TSR program LOCK.COM included in this package.  This program can
  241.      be removed and re-run by using a TSR control package like
  242.      TurboPower's excellent MARK and RELEASE (available on CompuServe
  243.      and probably everywhere else).
  244.  
  245.      VPT uses only BIOS calls and should run on the *real* VGA clones
  246.      that are now just becoming available; however, the pseudo-VGAs
  247.      (really EGAs with 640x480 mode) won't run it - they still have
  248.      only 64 colors total (and will cause grief down the road for
  249.      their buyers, I suspect).  Any test results are welcomed.
  250.  
  251.      
  252.      VIII. ENHANCEMENTS
  253.  
  254.      I would like to add MCGA support in a future release.  I am also
  255.      working on a TSR that would load the EGA registers with the
  256.      default values upon a mode change.  This would prevent the
  257.      situation when you are using an EGA aware program that exit by
  258.      doing a mode change and assumes that will reset the EGA.  With
  259.      VPT loaded it won't and one has to type something like VPT /C
  260.      afterwards to clean up the colors.  All suggestions are welcome.
  261.  
  262.  
  263.      IX. ALL THAT LEGAL BROUHAHA
  264.  
  265.      The program is copyrighted by clySmic software, but may be copied
  266.      and posted on BBS systems, as long as it is not altered, it is
  267.      credited to clySmic, and all files are kept together.
  268.  
  269.  
  270.  
  271.                                                        -- Ralph Smith,
  272.                                                       clySmic software
  273.                                                          CIS 76156,164
  274.