home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Graphics / graphics-16000.iso / msdos / viewers / vpic48 / config.doc < prev    next >
Text File  |  1992-02-25  |  9KB  |  159 lines
  1.  
  2.  
  3.  
  4.  
  5.     CONFIGURING VPIC
  6.  
  7.     VPIC must be configured to run correctly with your display board.  The  con-
  8.     figuration process tells VPIC:
  9.         1. The title you want for the menu.
  10.         2. What VGA chip you have, so it can use the proper bank switching  rou-
  11.            tine.
  12.         3. How much memory you have (in 64K banks).
  13.         4. The menu color you want (background:foreground).
  14.         5. How to set the various modes you want to use.
  15.  
  16.     If you aren't sure which VGA chip your board uses,  you  can  run  WHICHVGA,
  17.     which will try to identify your VGA chip and the amount of memory you  have.
  18.     Also check for a list of some of the VGA boards each  chip  was used  on. If
  19.     this doesn't work, you can remove the display board and look  at  the  label
  20.     on the large chip with leads coming out all four sides. Sometimes,  you  can
  21.     tell without removing the board by using DEBUG (or Turbo Debugger, Codeview,
  22.     or any debugger) and 'dumping' the contents of display  BIOS.  To  do  this,
  23.     enter DEBUG at the DOS prompt and you  will  get  a  -  prompt.  Then  enter
  24.     dC000:0 to display the first part of display BIOS. To  dump  more  of  BIOS,
  25.     juts enter d. You may recognize the chip manufacturers name  here,  such  as
  26.     ATI, Trident, Tseng, Paradise, etc. To exit DEBUG, just enter q.
  27.  
  28.     If WHICHVGA comes back with VESA, that means that your  board  supports  the
  29.     VESA standard, which offers a standard interface for VPIC to  your  SuperVGA
  30.     display adapter. It defines the SuperVGA extended modes that your card  will
  31.     do, and has a standard interface for setting the mode  and  bank  switching,
  32.     etc. You  may  have  received  a  VESA  `Terminate and Stay Resident'  (TSR)
  33.     program with your VGA board. If so, you are encouraged to use it,  since  it
  34.     more or less guarantees that VPIC will work with your display card. The only
  35.     disadvantage of VESA is concerned with scrolling the VGA screen, since there
  36.     is no standard interface for setting the top of screen beyond 16 bits  (line
  37.     81 at 800x600x256, line 102 at 640x480x256, or  line  204  at  320x200x256).
  38.     This version of VPIC automatically reads the VESA  info  from  your  display
  39.     BIOS, and uses the VESA interface. If you enter VPIC  with  the  /v  option,
  40.     VESA info is ignored and VPIC uses the  configuration  file  info;  this  is
  41.     helpful when VESA returns info VPIC isn't expecting or no  info  on  certain
  42.     modes.
  43.  
  44.  
  45.  
  46.  
  47.     The current VPIC config file VGA chips and the VGA chip manufacturers are:
  48.     VGA Chip    Manufacturer/version        Comments
  49.     =================================================================
  50.     AHEADA     Ahead ver A             Older Ahead cards.
  51.     AHEADB     Ahead ver B             Ahead VGA Wizard/Deluxe.
  52.     ATIOLD     ATI, 1024x768x16 mode 65h   ATI ver 1 chip, VGAWonder.
  53.     ATINEW     ATI, 1024x768x16 mode 55h   ATI ver 2 up chip, VGAWonder+.
  54.     CIRRUS     Cirrus CL-GD 500/600    MaxLogic MaxVGA boards NOT SUPPORTED YET.
  55.     CHIPSTECH  Chips & Technology 82C452   Cardinal, Older Boca.
  56.     EVEREX     Original Everex chip
  57.     EVBIOS     Everex 673, etc         Has bank switching built into BIOS.
  58.     GENOA      Genoa (Sim ET 3000)     5300/6300 = 256K, others = 512K.
  59.     HEADLAND   Headland HT-208         Used on VGA-1024i.
  60.     OAK        Oak
  61.     PARADISE   Paradise                Older Paradise cards.
  62.     S3         S3 GUI Accelerator      Used on Orchid Fahr 1280, Diamond Stealth
  63.     TRI88BR    Trident TVGA 8800BR     Used on older Trident boards, 128K banks.
  64.     TRI88CS    Trident TVGA 8800CS     Used on older Trident boards (Maxxon)
  65.     TRI89      Trident TVGA 8900       Latest Trident VGA chip, 1M memory avail.
  66.     TS3000     Tseng ET 3000           Used on early Genoa, Orchid, others.
  67.     TS4000     Tseng ET 4000           Recent Orchid, STB, other, 1M memory.
  68.     TS4000HI   Tseng ET 4000 HiColor   Does 32K colors to 800x600, 1M memory.
  69.     WD90C      Western Digital WD90C00  Recent Paradise cards, same operation.
  70.     VIDEO7     Video 7                 Earlier Video 7 boards, BIOS bank switch.
  71.     ZYMOS      Zymos Poach 51          True Tech HiRes and others.
  72.     VESA       VESA Standard           For boards which have VESA in BIOS.
  73.  
  74.     As new chips become available, they will be added to this list. Run WHICHVGA
  75.     to find your VGA chip (works most of the time), and then run CONFIG and find
  76.     a CFG file using that VGA chip. Check that the modes agree with the graphics
  77.     modes in your manual (16 and 256 color modes only); if they match your  card
  78.     exactly, use that CFG file by pressing ENTER. If not, copy the closest  file
  79.     to a new filename with extension CFG and change the modes to agree with your
  80.     manual. Make the title and menu color whatever you like  (see  CONFIGURATION
  81.     FILE FORMAT). Then  rerun  CONFIG,  pick  that  file,  and  press  ENTER  to
  82.     configure VPIC. There are numerous configuration files which come with VPIC,
  83.     but there are so many boards out there that I can't list all of them.
  84.  
  85.     MENU CONFIGURATION
  86.     To configure VPIC, make sure that VPIC, CVPIC,  CONFIG,  and  all  the  .CFG
  87.     files are in the current directory. By running the CONFIG program, VPIC  can
  88.     be configured from a menu. CONFIG lists all the configuration files (with  a
  89.     .cfg extension) in the current directory, and shows you the contents of each
  90.     as you move around the list using the cursor keys. ESCape aborts the  CONFIG
  91.     program without changing VPIC, and ENTER configures VPIC for the highlighted
  92.     file. Pressing a letter key jumps to next filename starting with that letter
  93.     (or number).
  94.  
  95.     MANUAL CONFIGURATION
  96.     You can use CVPIC to configure VPIC manually by entering:
  97.          CVPIC config_file[.ext]
  98.     where the default extension is .cfg and  config_file  is  the  configuration
  99.     file you want to use.
  100.  
  101.  
  102.  
  103.  
  104.     CONFIGURATION FILE (.CFG) FORMAT
  105.     CVPIC ignores leading spaces and blank lines in the file, and all characters
  106.     after a semicolon are considered comments and ignored. The .CFG file contains
  107.     the following lines, which can be up to 150 characters in length each:
  108.  
  109.         1. Board name, which will appear in the VPIC menu. This is user  define-
  110.            able, and could be something like 'Joe's VGA Board'.
  111.  
  112.         2. VGA CHIP should be one of the names supported  by  VPIC;  see  above.
  113.            Upper or lower case is OK.
  114.  
  115.         3. The number of 64K banks of display ram usable  for  pictures  (1  for
  116.            standard VGA (no extended modes), 4 for 256K, 8 for 512K, 16 for 1M).
  117.  
  118.         4. Menu text color. A number whose value is  background*16 + foreground.
  119.            The allowable background colors are  0  thru  7,  and  the  allowable
  120.            foreground colors are 0 thru 15. This number is easiest to figure  if
  121.            entered in hex (prefixed by 0x); then the 1st digit is the background
  122.            color (0-7) and the 2nd digit is  the  foreground  color  (0-F).  The
  123.            digits correspond to black (0), blue (1),  green (2),  aqua (3),  red
  124.            (4), violet (5), brown (6), and white (7), and  the  digits  8-F  are
  125.            intensified versions of the 0-7. For example, 0x3E would tell VPIC to
  126.            use bright yellow text on an aqua background. CONFIG gives the  value
  127.            in hex, and the corresponding foreground-background colors.
  128.  
  129.         5 thru n. The following lines describe the modes supported by the board.
  130.           Each line is of the form: F1 F2 AX BX CX DX W H C G P where:
  131.             *  F1 = 0 for 16 color modes, 1 for 256 color modes,  2  for  Sierra
  132.                DAC modes.
  133.             *  F2 = 0 for EGA (640x350x16) with 64 colors to choose from, and  1
  134.                for all others modes (which have 256,000 colors to choose from).
  135.             *  AX,BX,CX,DX  register values used to set this mode. Preceding the
  136.                numbers by 0x indicates hex; ie., 0x10 = 16.
  137.             *  W, H, C  are width, height, colors in this mode.
  138.           Additional Information if known
  139.             *  G is the bank granularity in Kbytes; for instance,  the  Paradise
  140.                has 4K banks.
  141.             *  P is the number of color planes; usually 1 for  256  color  modes
  142.                and 4 for 16 color modes. However, the ATI in 1024x768x16 and the
  143.                S3 in 800x600x16 and 1024x768x16 uses 1 plane and 2 pixels/byte.
  144.  
  145.           The modes amy be entered in any order, but listing all  the  VGA  (256
  146.           color) modes followed by the EGA (16 color)  modes,  followed  by  the
  147.           Sierra DAC modes makes sense, and the mode numbers can  be  determined
  148.           by looking at the configuration file.
  149.  
  150.           For specifying the mode N from the command line (/mN option for VPIC), the
  151.           mode numbers increase with increasing resolution and can be found from
  152.           the menu screen as follows:
  153.             *  The 256 color modes are numbered 1 thru 10 starting at 320x200.
  154.             *  The 16 color modes are numbered 11 thru 20 starting at 640x350.
  155.           If you are configured with the Sierra DAC, Targa's will be automatically
  156.           shown in 32K colors if you pick a resolution supported  by  the  board
  157.           for the Sierra DAC.
  158.  
  159.