home *** CD-ROM | disk | FTP | other *** search
/ Graphics 16,000 / graphics-16000.iso / msdos / viewers / mvgavu51 / mvgavu.doc < prev    next >
Text File  |  1991-09-24  |  34KB  |  727 lines
  1.             MVGAVU (c) Copr. 1989-91 Lawrence Gozum & Marvin Gozum
  2.             ──────────────────────────────────────────────────────
  3.  
  4.                                  User Manual
  5.  
  6.  
  7.     DISCLAIMER
  8.  
  9.     This product is distributed AS IS.  The authors specifically disclaim all
  10.     warranties ,expressed or implied, including ,but not limited to, implied
  11.     warranties of merchantability and fitness for a particular purpose with
  12.     respect to defects in the diskette and documentation, and program license
  13.     granted herein, in particular, and without limiting operation of the
  14.     program license with respect to any particular application use or
  15.     purpose.  In no event shall the authors be liable for any loss of profit
  16.     or any other commercial damage including but not limited to special,
  17.     incidental, consequential or other damages.
  18.  
  19.  
  20.     LICENSING AGREEMENT
  21.  
  22.     You may use this program for a 10 DAY TRIAL PERIOD.  Should you find this
  23.     program useful, you MUST register it; you will then be provided with the
  24.     latest releases of the VGACAD system see last section of this manual).
  25.  
  26.     Freely distribute unmodified MVGAVU copies provided you charge $10 max.
  27.     for distribution, in lieu of recognized Users Group guidelines (eg., ASP).
  28.  
  29.  
  30.     WHAT IS MVGAVU ?
  31.  
  32.     MVGAVU is a GIF decoder/viewer/slideshow utility and component of VGACAD.
  33.     MVGAVU handles GIFs up to 2KBx2KBx256 and shows the whole picture w/out
  34.     scrolling; it also features a UNIQUE 256-color rendering scheme in
  35.     16-color EGA/VGA/SVGA modes for viewing multiple/animated images.  As a
  36.     versatile slideshow, it automatically determines the BEST viewing mode.
  37.  
  38.     You can also view PCX (Zsoft/PCPaintbrush) support for 2-color, 16-color
  39.     and 256-color image files.
  40.  
  41.     MVGAVU supports TARGA file (16/24/32 bits) viewing through unique
  42.     16/256-color rendering schemes to view all those THOUSANDS of "colors"
  43.     in ALL modes supported.  BMP (Windows 3.x) 16-color, 256-color and
  44.     24-bit (16.7 Million color) image files are also supported.
  45.  
  46.     New! HiColor Mode support added to see those 16/24/32-bit Targa and
  47.     24-bit BMP files in 640x480x32K (eg., ATI VGA Wonder XL) and/or
  48.     800x600x32K! with Tseng 4000 cards w/ Sierra DAC
  49.  
  50.              eg. Cardinal VGA732
  51.              Diamond SpeedSTAR HiColor
  52.              Focus 2 the Max VGA4000
  53.              Micro-Labs Ultimate VGA/HiColor
  54.              Orchid Prodesigner IIs
  55.              SOTA Lightning VGA
  56.              STB PowerGraph Ergo-VGA HiColor
  57.              United Ultra Image HiColor
  58.  
  59.  
  60.     REQUIREMENTS
  61.  
  62.     MVGAVU requires a PS/2 or EGA/MCGA/VGA/SVGA video card.  512KB of
  63.     RAM is required, although it uses less than that.  The BRUN41.exe
  64.     runtime module MUST be present in your DOS path.
  65.  
  66.  
  67.     CONFIGURING MVGAVU
  68.  
  69.     BEFORE DOING ANYTHING, configure MVGAVU by selecting (C)ard; MVGAVU
  70.     is initially set for "VGA or PS/2 Model 50".  If the "VESA" setup was
  71.     configured previously, you MUST configure MVGAVU by typing
  72.  
  73.                         "MVGAVU -C" <ret>.
  74.  
  75.     A list of Video card "types", based on their chipset family, are
  76.     presented.  Enter the number that matches your card.  When selecting
  77.     SVGA cards, check your manual or manufacturer for the chipset (e.g.,
  78.     ATI, Tseng, Paradise, Video7, Oak, etc..); when in doubt, select
  79.     choices 253, 254 or 255.  You will also be asked to specify the amount
  80.     of video RAM present and, if ATI or Tseng4000 chipsets are selected,
  81.     HiColor capability option.  BE SURE THAT MVGAVU.EXE IS LOCATED IN YOUR
  82.     DEFAULT DRIVE/PATH TO ENSURE HARCODED CONFIGURATION.
  83.  
  84.     Trident TVGA card users that have the supposedly rare 'BR versions'
  85.     will notice that the bank switching will be erroneous.  We tried to
  86.     accomodate this version but ended up compromising the more popular
  87.     TVGA 8800 and 8900 versions <sorry>.
  88.  
  89.     The Trident 1024x768x256 mode is not supported at this time since it
  90.     uses a very peculiar, card specific, bank switching methodology (ie.,
  91.     it conflicts with SVGA display conventions).  Video mode support is
  92.     limited to 800x600x256 or 1024x768x16, if available.
  93.  
  94.     Some Everex 678 (w/ Trident chip) have experienced compatibility
  95.     problems.  If the 1024x768x16 mode works but fails in all other modes,
  96.     then you may have a defective card.  Try using the VESA setting
  97.     described below; if that fails then you really have a problem card.
  98.  
  99.  
  100.     LAUNCHING MVGAVU AS A DOS APPLICATION UNDER WINDOWS 3.X
  101.  
  102.     HERCULES STATION CARD USERS SHOULD NOT USE THIS OPTION.
  103.     ======================================================
  104.  
  105.     Before implementing the following steps, please ensure that the
  106.     BRUN41.EXE file has access to your PATH or has been copied into the
  107.     \WINDOWS\SYSTEM sub-directory.
  108.  
  109.     1.  If you don't have a PROGRAM GROUP for DOS applications then
  110.  
  111.     1.1.    Click "File" under the Program Manager window.
  112.     1.2.    Select "New".
  113.     1.3.    Select "Program Group".
  114.     1.4.    Click "OK".
  115.     1.5.    Enter a DESCRIPTION for this "Program Group"
  116.         (eg., "DOS Apps")
  117.     1.6.    Click "OK".
  118.  
  119.     2.  Click (activate) your "DOS Apps" window.
  120.     3.  Click "File" under the Program Manager window.
  121.     4.  Select "New".
  122.     5.  Select "Program Item".
  123.     6.  Click "OK".
  124.     7.  Enter the full pathname of MVGAVU at COMMAND LINE and include
  125.     any Command Line processing option (if desired) discussed at a
  126.     latter section of this manual.
  127.  
  128.     eg., If MVGAVU.EXE is located under the \VGACAD directory then
  129.          enter "\VGACAD\MVGAVU" at the COMMAND LINE.
  130.  
  131.          If you wanted the AutoMode processing option to be activated
  132.          to select video modes up to 1024x768x256 then you would enter
  133.          "\VGACAD\MVGAVU -m" at the COMMAND LINE.
  134.  
  135.     NOTE: You can also use the BROWSE function of this window to
  136.           select MVGAVU instead of actually typing it in at the
  137.           COMMAND LINE.
  138.  
  139.     8.  If you wish, "Change Icon" - "DOS" icon is preferred though.
  140.     9.  Click OK.
  141.  
  142.  
  143.     VESA IMPLEMENTATION
  144.  
  145.     MVGAVU now supports the VESA (Video Electronics Standards Association)
  146.     application interface.  By selecting VESA (ie., card "18"), virtually
  147.     all SVGA modes supported by your card can be utilized and integrated
  148.     with all of MVGAVU's processing options.  VESA mode support includes:
  149.  
  150.             800x600x16
  151.             640x400x256
  152.             640x480x256
  153.             800x600x256
  154.             1KBx768x16
  155.             1KBx768x256
  156.  
  157.     VESA support requires you to load a card-specific resident program
  158.     before VESA can be used.  An error message - "VESA not detected!"
  159.     will result if VESA has not been previously loaded.
  160.  
  161.     Under certain circumstances, MVGAVU will reject a VESA mode; it will not
  162.     become available if it conflicts with "common" SVGA implementation.  Any
  163.     mode that requires two windows ("bank switching methods") to read and
  164.     write to video memory or uses a window other than A000 hex will be
  165.     rejected (eg., Trident 8900 1024x768x256 mode).
  166.  
  167.     The old ATI SVGA 1024x768x16 mode (trigerred via mode 65 hex) is not
  168.     supported via VESA - it is supported and hardcoded if you select the
  169.     ATI card instead of VESA.  With the new ATI cards you can have ALL
  170.     VESA modes or hardcoded modes up to 1024x768x256.
  171.  
  172.  
  173.     LOADING PICTURES INTO MVGAVU
  174.  
  175.     MVGAVU accepts [G]IF, [T]arga, [W]indows (BMP), PCX (PC Paintbrush) or
  176.     [B]ASIC (BLD+PLT) file types.  Select any filename by moving a high-
  177.     lighted bar (with arrow keys) and pressing <return> key.  If you have
  178.     more than 184 files, the columns of files listed will scroll when either
  179.     margin of the screen is reached.  <Home> moves to the first file while
  180.     <End> moves to the last file.  <PgDn> shows the next 184 files while
  181.     <PgUp> shows the previous.  <Spc> allows changes to the PATH, while
  182.     <Esc> exits.  BLD files MUST have a corresponding *.PLT file or a error
  183.     message will follow.
  184.  
  185.  
  186.     COMPATIBILITY
  187.  
  188.     The BRUN41.exe runtime module HATES 'Shadow RAM' (eg., putting your
  189.     VIDEO BIOS in low or high RAM); it 'hangs' (at least on our 386 SX).
  190.     If MVGAVU 'locks-up' at start-up then you have this problem too;
  191.     disable 'Shadow RAM' (eg., via CMOS set-up) and it should work.
  192.  
  193.     There are several COMMAND LINE OPTIONS that are NOT available from the
  194.     MVGAVU Expert Menu.  All other processing options described in a latter
  195.     section of this manual can be invoked despite these option settings.
  196.  
  197.             MVGAVU -H <ret>
  198.  
  199.     "-H" HiColor Enable.  If this command is invoked from the command line,
  200.     HiColor (32KB-color) modes will be made available at the Expert Menu
  201.     when Targa 16/24/32 or BMP 24-bit files are detected.  If HiColor modes
  202.     are not setup during configuration then it can be accessed this way.
  203.     No verification of HiColor capability is done, CHECK YOUR CARD'S MANUAL
  204.     TO SEE IF IT SUPPORTS IT!
  205.  
  206.     Note: HiColor modes and the CEG/Edsun DAC modes are totally different;
  207.       the former is a "true" 32KB color mode while the latter is a
  208.       peculiar "anti-aliasing"/smoothing mode which is NOT supported
  209.       by MVGAVU at this time.
  210.  
  211.  
  212.                         MVGAVU -D <ret>
  213.  
  214.     "-D" Disable Auto-Expanded Memory usage.  Expanded memory is required
  215.     for those GIF89a "crashers" that require MASSIVE amounts of memory to
  216.     restore a screen.  The LIM 4.0 EMS spec is required to use expanded
  217.     memory, if your EMS driver does not conform then unpredictable results
  218.     will happen such as getting strange colors in restored areas.  Disable
  219.     Auto-EMS usage to allocate 96KB of low RAM for screen storage; this
  220.     should work with most GIF 89a images that conform to Jim Burton's
  221.     "Rules for GIF89a MIGs". 
  222.    
  223.  
  224.                         MVGAVU -E <ret>
  225.  
  226.     "-E" EGA only mode forces EGA 640x350x16 to be the ONLY mode to be
  227.     selected by the user or MVGAVU during automatic mode selection (ie.,
  228.     hitting <return> key.
  229.  
  230.     If you are having compatibility problems (particularly SVGA mode and/or
  231.     bank switching) with MVGAVU please contact Lawrence Gozum [73437,2372]
  232.     via CompuServe's
  233.  
  234.                   E-Mail
  235.                 or
  236.                 PICs Forum
  237.  
  238.  
  239.     VIEWING TARGA FILES IN MVGAVU v5.1
  240.  
  241.     o Only UNCOMPRESSED, UNMAPPED Targa (16/24/32 bit) files are supported.
  242.     o TARGA files must be <= 2048x2048.
  243.     o With ANY 256-color modes, 32768 color "pairs" are matched/rendered.
  244.     o With any 16-color mode, the 32768 color "pairs" method is used, then
  245.       a 256-to-16 color algorithm is applied, unless the image requires
  246.       drastic resizing/image aspect ration correction on the Y-axis, then a
  247.       posterized 256-color alogorithm is used instead of the SVGA 32768
  248.       color "pairs" method.
  249.     o Slideshows are disabled.
  250.     o AutoCentering is disabled.
  251.     o HercGS 640x480x32K mode replaces 640x480x256 mode when TARGA files
  252.       are selected; saving the screen in this mode is disabled.
  253.     o HercGS 512x480x16M mode is made available when Targa 24/32 files
  254.       are detected; saving the screen in this mode is disabled.
  255.     o HiColor 640x480x32KB or 800x600x32KB modes (eg., Diamond Speedstar,
  256.       and ATI VGA Wonder XL) are made available when Targa files are
  257.       detected; saving the screen in these modes is disabled.
  258.  
  259.  
  260.     Note: TGA files are best viewed with "Fix Aspect 1:1" or "Fix Aspect TGA"
  261.       In 256-color modes, view TGA files with the highest mode possible
  262.       (eg., 1KBx768x256) or use the grey processing option for maximum
  263.       detail; processing options are discussed in latter section.
  264.  
  265.  
  266.     VIEWING BMP (Windows 3.x) FILES WITH MVGAVU v5.1
  267.  
  268.     o Only UNCOMPRESSED 16-color, 256-color and 24-bit (16.7 MB color)
  269.       files are supported.
  270.     o BMP files must be <= 2048x2048.
  271.     o Slideshows are disabled.
  272.     o AutoCentering is disabled.
  273.     o BMP files are best viewed with "Fix Aspect 1:1" processing option
  274.       discussed in latter section.
  275.     o HiColor 640x480x32KB or 800x600x32KB modes (eg., Diamond SpeedSTAR,
  276.       and ATI VGA Wonder XL) are made available when 24-bit BMP files are
  277.       detected; saving the screen in these modes is disabled.
  278.  
  279.  
  280.     VIEWING PCX FILES WITH MVGAVU v5.1
  281.  
  282.     o Only RLE 2-color, 16-color and 256-color image files are supported
  283.       (essentially covers ALL PCX files except CGA 4-color image files).
  284.     o PCX files must be <= 2048x2048.
  285.     o Slideshows are disabled.
  286.     o AutoCentering is disabled.
  287.  
  288.  
  289.     SELECTING VIDEO MODES
  290.  
  291.     On default MVGAVU is set to AutoMode with "Expert Menu:OFF"; after
  292.     selecting a file, MVGAVU will immediately show the image.  Pressing
  293.     <return> after picking a GIF file triggers automatic mode selection.
  294.     MVGAVU selects the BEST video mode, based on your video card
  295.     configuration.  Pressing <Esc> aborts viewing and lets you reselect
  296.     a new file.
  297.  
  298.     Set "Expert Menu:ON" at the opening menu if you want to use processing
  299.     options or to select specific video modes for viewing.
  300.  
  301.  
  302.     HiColor modes
  303.  
  304.     640x480x32KB or 800x600x32KB modes (eg., Diamond Speedstar, and ATI VGA
  305.     Wonder XL) are supported by MVGAVU.  HiColor modes are made available
  306.     at the Expert Menu ONLY when Targa 16/24/32-bit or BMP 24-bit files are
  307.     detected.  Automode support is not included at this time, due to downward
  308.     compatibility reasons.  CHECK YOUR CARD'S MANUAL TO VERIFY AVAILABILITY !
  309.  
  310.      *  If HiColor capabilty is not configured at the start then
  311.         invoke the "-H" command line option (ie., "MVGAVU -H");
  312.  
  313.     To view images in HiColor modes,
  314.  
  315.     (1) turn Expert Menu ON;
  316.     (2) pick a Targa 16/24/32-bit or BMP 24-bit file;
  317.     (3) select mode (eg., [H]iColor 640x480x32K) at the Expert Menu.
  318.  
  319.  
  320.     Unsupported MVGA (Medium-resolution VGA) modes
  321.  
  322.     The 320x400x256 mode is the safest since it uses minimal VGA register
  323.     modification and is safely within tolerances of PS/2 monitors; it should
  324.     run on any "register-compatible" VGA card.  It has an interesting aspect
  325.     ratio - double the vertical resolution of MCGA/VGA 320x200x256; many
  326.     Amiga, Atari and MacII GIFs have this aspect ratio; viewing GIFs in this
  327.     mode replicates "what the originator saw".  If the 320x400x256 mode
  328.     fails, your card is BIOS-COMPATIBLE ONLY !
  329.  
  330.     The 360x480x256 mode pushes generic VGA cards to its theoretical limits!
  331.     With 270% more resolution, view 640x480x256 GIFs with more detail and
  332.     less "jaggies".  If the 360x480x256 mode fails, your card is not as
  333.     "register-compatible" as it claims to be.
  334.  
  335.     The 640x400x256 Tseng SVGA was created to view 320x200x256 GIFs more
  336.     clearly due to 400% more resolution - aside from adding the missing
  337.     mode to its SVGA repertoire.  Amiga, Atari and MacII GIFs use this
  338.     aspect ratio multiple and look as close as possible to "what the
  339.     originator saw" with it.
  340.  
  341.     View Jovian VIA scans (320x240x256 GIFs) in 640x480x256 or 800x600x256;
  342.     these GIFs have the same aspect ratio and have the same effect as
  343.     viewing 320x200x256 GIFs in the 640x400x256 mode.
  344.  
  345.  
  346.     Preset SVGA modes
  347.  
  348.     MVGAVU has hardcoded support for many SVGA chipsets based on your video
  349.     card configuration.  SVGA MODES ARE NOT VERIFIED; YOUR VIDEO RAM AND
  350.     CHIPSET LIMITS YOUR CHOICES; CHECK YOUR MANUAL !!!
  351.  
  352.  
  353.     SVGA/EEGA User modes
  354.  
  355.     SVGA/EEGA User modes are made available ONLY when HiColor modes are
  356.     disabled.  Only one or the other are made available.
  357.  
  358.     To use User modes, press [U]ser Mode.  On default, this mode is set to
  359.     EGA 640x200x16.  To set your own modes specify the Screen Width, Screen
  360.     Height, colors (16 or 256), Video Mode, and Chip type (9=EEGA).  Several
  361.     *.CFG files are included; copy a special video mode (e.g., 512x480x256)
  362.     to MVGAVU.CFG and it will be invoked when you use the "U" option.  CHECK
  363.     YOUR CARD'S MANUAL TO DETERMINE IF IT SUPPORTS IT!
  364.  
  365.     To set a 256 or 16 color mode, press [R]evise.  Once edited, it is saved
  366.     and recalled anytime.  Type the video mode in decimal (e.g. 255) or hex
  367.     (e.g. &HFF); HEX ENTRIES *MUST* BE PRECEDED BY THE "&H" CHARACTERS.
  368.     16-COLOR MODES (UP TO 800x600 EXCEPT EVEREX & VIDEO7 MODES) MUST ALWAYS
  369.     USE "9" (for EEGA) SINCE IT WILL TELL MVGAVU TO USE THE HARDCODED
  370.     STANDARD PROCEDURE.  FOR MODES ABOVE 800x600 (e.g. 1024x768), YOU MUST
  371.     USE THE CORRECT CHIPSET (eg., ATI, PARADISE, TSENG, VIDEO7, ...).
  372.  
  373.  
  374.     EGA/EEGA/VGA 16-Color Modes
  375.  
  376.     If a GIF or BMP or PCX file has more than 16 colors (e.g, 256) then a
  377.     unique 16-color rendering method will implemented (eg., 640x350x16).
  378.     Viewing 1024x768x256 GIFs in 1024x768x16 will yield more detail than
  379.     viewing in interpolated 640x480x256.
  380.  
  381.  
  382.     PROCESSING OPTIONS
  383.  
  384.     There are SEVEN (7) processing options:
  385.  
  386.                         Safety w/ MIGs
  387.                         Normal w/ MIGs
  388.                         OneMeg w/ MIGs
  389.                         Fit to Screen
  390.                         Fix Aspect 1:1
  391.             Fix Aspect TGA
  392.             Fix Aspect 5:6
  393.  
  394.     The first six options can be triggered from the command line.
  395.  
  396.     "Normal w/ MIGs" - this is the optimal processing option.  Multiple
  397.     Image Graphics/GIFs (87a and 89a) will be rendered.  Depending on your
  398.     card configuration, when using automatic mode selection (ie., <return>)
  399.     or command line viewing, the best video mode will be selected; this will
  400.     include 800x600x256 and 1024x768x16 modes, if available.
  401.  
  402.     Note: Old Paradise cards excluded 800x600x256 and 1024x768x16 modes;
  403.       USE ONLY THE "Safety w/ MIGs" OPTION BELOW IF YOU HAVE THE
  404.       OLD PARADISE CARDS.
  405.  
  406.     "Safety w/ MIGs" - this option is the DEFAULT; it is similar to "Normal
  407.     w/ MIGs" but excludes the 800x600 and 1024x768 modes, even if they are
  408.     available to ensure that fixed-frequency monitors, with 640x480 as its
  409.     max, will not be affected.  Moreover, setting this option will avoid
  410.     calling the 800x600 or 1024x768 modes which is excluded by some video
  411.     cards (eg., old Paradise cards and some Trident cards).
  412.  
  413.     "OneMeg w/ MIGs" - this is essentially similar to the "Normal w/ MIGs"
  414.     option but includes the 1024x768x256 mode, if available.
  415.  
  416.     Note: The processing options (above) will call the "Fit to Screen"
  417.       processing option (below) if the image exceeds screen parameters.
  418.       The AutoMode <return> key is disabled with the following options.
  419.  
  420.     "Fit to Screen" - this option decodes the FIRST image and fits that
  421.     image to maximum screen dimensions.  This is useful for resizing images
  422.     and subsequently saving/encoding them with the [tab] option described in
  423.     a latter section of this manual.
  424.  
  425.     "Fix Aspect 1:1" - with this option, certain GIFs that have the same
  426.     screen and image descriptors (e.g.CARMEN2) will be corrected for
  427.     accurate rendering (otherwise they will seem distorted).  "1:1" aspect
  428.     assumes originator was using a "square" aspect ratio.  If you have 100
  429.     pixels on all sides of a square, the square should appear as a SQUARE on
  430.     your monitor, not some rectangle.  320x240(Jovian VIA), 640x480, 800x600
  431.     and 1024x768 modes should have "square" aspect ratios.  Use this option
  432.     to fix such GIFs (e.g., SYLVIA.GIF, PAULINA.GIF, FMAID.GIF, ... ).
  433.     BMP FILES ARE BEST VIEWED WITH THIS PROCESSING OPTION SINCE THERE IS
  434.     NO IMAGE/SCREEN DIFFERENTIATION.
  435.  
  436.     "Fix Aspect 5:6" - this option is similar to the 1:1 processing option
  437.     but assumes that the originator was using a 320x200 or 640x400 screen
  438.     aspect ratio (eg., Amiga, Atari or MacII).  AutoMode <return> key is
  439.     disabled.
  440.  
  441.     Note: Almost all SVGA cards, due to monitor and "clock" contraints
  442.       tend to implement the 800x600x256 mode with a 5:6 rather than
  443.       a 1:1 aspect ratio.
  444.  
  445.     "Fix Aspect TGA" - this mode is intended for viewing TARGA (*.TGA) files
  446.     which typically originate from a 512x480 screen.  If the image looks
  447.     "too fat" then use the "Fix Aspect 1:1" processing option.
  448.  
  449.  
  450.     GREY CONVERSION
  451.  
  452.     If you require grey images for desktop publishing (DTP) applications,
  453.     then use MVGAVU's grey processing option at the Expert Menu.  By simply
  454.     pressing the [G]rey Option, all images will be converted to grey shades.
  455.  
  456.     Viewing TARGA images with the option is particularly useful if you
  457.     want to see a LOT of detail, albeit without color.  If you view TARGA
  458.     images with this option and subsequently save it, you can process the
  459.     file for DTP or printing with GIFPUB !  The palette contrast and
  460.     brightness functions will work with this option, making it an ideal
  461.     preprocessor for DTP.
  462.  
  463.  
  464.     ADJUSTING THE VIDEO MODE
  465.  
  466.     This feature is disabled when using extended Hercules Graphics Station
  467.     or HiColor (32KB color) video modes.
  468.  
  469.     WARNING: TO USE THIS FEATURE YOU *MUST* HAVE A REGISTER-COMPATIBLE VGA
  470.     CARD AND MULTIFREQUENCY MONITOR. DEPENDING ON SOPHISTICATION OF YOUR
  471.     HARDWARE, MINOR ADJUSTMENTS TO VIDEO MODES MAY TOTALLY DISRUPT THE VIDEO
  472.     SYNCING PROCESS, BE PREPARED TO PRESS THE "*" KEY TO RESET IF SYNC
  473.     SIGNALS ARE UNFAVORABLY DISRUPTED.
  474.  
  475.     Some video modes (e.g., 800x600) have distorted aspect ratios (i.e.,
  476.     supposed to have 1:1 aspect ratios but isn't).  To correct this, you can
  477.     (1) compress the image vertically/horizontally or (2) offset the image
  478.     on your monitor as if you were adjusting the vertical and horizontal
  479.     scanning controls of your monitor.  If you set your monitor for
  480.     1024x768x16, you will normally find that modes such as 960x720x16 tend
  481.     to be distorted.
  482.  
  483.     There is a growing amateur interest in VIDEO GRAPHICS via 'GENLOCK'
  484.     add-on cards (e.g., Jovian VIN, Willow VGA-TV).  By adjusting the video
  485.     mode you can control the aspect ratio and overall image size sent to your
  486.     TV or video tape.  320x200 and 640x400 modes tend to send images that are
  487.     smaller than the total TV/Video image; centering may be required.  With
  488.     640x480 or greater modes, the image may tend to be larger or distorted;
  489.     aspect ratio, image size and location adjustments may be required to
  490.     match 'real' video images with your computer graphic images.
  491.  
  492.     After an image is displayed, press "[A]djust Monitor.  The following key
  493.     options will be activated; this feature can be invoked in any video mode.
  494.  
  495.     [->]  move image right               [ - ] compress horizontal aspect
  496.     [<-]  move image left                [ + ] decompress horizontal aspect
  497.     [dn]  move image down                [Ins] compress vertical aspect
  498.     [up]  move image up                  [Del] decompress vertical aspect
  499.                                          [ * ] RESET ADJUSTMENTS
  500.                                          [Esc] exit
  501.  
  502.  
  503.     ADJUSTING CONTRAST & BRIGHTNESS
  504.  
  505.     This feature is disabled when using extended Hercules Graphics Station
  506.     or HiColor (32KB color) video modes.
  507.  
  508.     If you view in any mode except EGA, you can adjust contrast, brightness,
  509.     and color level.  Virtually ALL palette modifications can be emulated
  510.     with these "knobs".  Moreover, you can add or substract individual
  511.     quanta of red, green or blue components.
  512.  
  513.     Make sure your NUMLOCK key is OFF !
  514.  
  515.     [Esc] or any other key (e.g., [return] or [spc]) will exit.
  516.  
  517.     [->]  increase brightness            [+] increase color level
  518.     [<-]  decrease brightness            [-] decrease color level
  519.     [dn]  increase contrast              [*] reset palette
  520.     [up]  decrease contrast              [A] Adjust Monitor
  521.  
  522.     The following keys are CASE SENSITIVE.
  523.  
  524.     [R]   increase RED level             [r] decrease RED level
  525.     [G]   increase GRN level             [g] decrease GRN level
  526.     [B]   increase BLU level             [b] decrease BLU level
  527.  
  528.     With VGACAD you can import the adjusted palette in your edited picture
  529.     by pressing [backspace] key.  When editing a SVGA GIF via VSCRN (i.e.,
  530.     "virtual screen"); eNCODe that GIF and view it with MVGAVU; adjust the
  531.     palette, press [backspace] then exit to import that palette. 
  532.  
  533.  
  534.     SAVING RESIZED MVGA/SVGA GIFs OR MIGS (Multiple Image Graphics/GIFs)
  535.  
  536.     You can 'downsize' (squeeze) SVGA GIFs (e.g., 640x480x256) or expand
  537.     small GIFs (e.g., 320x200x256) to 320x400x256 or 360x480x256.  Downsize
  538.     SVGA GIFs for fast-decoding or enlarge small GIFs for enhanced image
  539.     processing with VGACAD or reduce odd SVGA GIFs (e.g., DGNLDY) to smaller
  540.     SVGA modes (e.g., 640x400x256).  View your GIF with any video mode and
  541.     press the [tab] key.
  542.  
  543.     MVGASCRN.RAW and MVGASCRN.PLT files will be created for GIF, PCX or BMP
  544.     (Windows 3.x) encoding with VGAFIL.  NYBLSCRN.RAW and NYBLSCRN.PLT files
  545.     will be created for 16-color GIF encoding with VGAFIL.  Subsequent saves
  546.     overwrite these files; encode with VGAFIL (which can be found in the
  547.     *.ZIP files of VGACAD (v2.0 and up) or VGACAP (v6.0 and up), and rename
  548.     immediately to preserve them.
  549.  
  550.     MIGs are usually several 'overlayed' images which simulate animation. 
  551.     MVGAVU supports GIF MIGs.  Since MIGs tend to change what you initially
  552.     see from what you see at the end of the GIF, you may want to save the
  553.     final rendered image rather than the first one for editing with VGACAD
  554.     or conversion to another image format or mode.  Simply save the final
  555.     rendered image as you would a resized image (ie., using the [tab] key)
  556.     and convert it with VGAFIL.  VGAFIL supports GIF, PCX, TGA (Targa 16)
  557.     and BMP (Windows 3.x) encoding to edit the image with any program that
  558.     supports those file formats.
  559.  
  560.  
  561.     GIF SLIDESHOWS
  562.  
  563.     Up to 4096 GIFs can be viewed in a slideshow.  Move the cursor to select
  564.     files and press [+] key to mark or [-] to unmark.  After selecting files
  565.     press [S]how to start and you will be presented with transition options.
  566.     You can adjust the "delay" factor between each "slide" by adding pauses
  567.     up to 30 seconds and use one of the various transition effects.  During
  568.     the show, press any key (three to four times) while the show is running
  569.     to exit.  MVGAVU selects optimal video modes based on your video card
  570.     configuration and command line processing option selected.
  571.  
  572.  
  573.     COMMAND LINE VIEWING & BATCH PRESENTATIONS
  574.  
  575.     MVGAVU can be used in batch (*.BAT) files for presentations.  In Command
  576.     Line mode, only your picture is displayed and pressing any key (except
  577.     [tab], [backspace], [A]djust Monitor and Color/Picture adjustment keys)
  578.     after its display will end the program.  No menus or prompts interfere.
  579.  
  580.     Type "MVGAVU ?" for help or type
  581.  
  582.            "MVGAVU [processing option] filename <ret>"
  583.  
  584.             -S  Safety w/ MIGs (default)
  585.             -N  Normal w/ MIGs
  586.             -M  OneMeg w/ MIGs
  587.             -E  EGA    w/ MIGs
  588.             -F  Fit to Screen
  589.             -A  Fix Aspect 1:1
  590.             -T  Fix Aspect TGA
  591.  
  592.     with no extension and optional path (e.g.,MVGAVU \gif\wett).  GIFs are
  593.     viewed via automatic mode selection; the range of video modes selected
  594.     from and how the graphic is rendered depends on your video card
  595.     configuration and processing option selected.
  596.  
  597.     MVGAVU searches for the first matching *.GIF, then it searches for a
  598.     *.TGA file then, then a *.BMP file, then a *.PCX file, and lastly a
  599.     *.BLD file (which can be viewed only in MCGA 320x200x256 mode and must
  600.     have matching *.PLT files in the same drive/directory).
  601.  
  602.  
  603.     THE CHAINED VGACAD ENVIRONMENT
  604.  
  605.     BRUN41.exe is a runtime module distributed under licence with Microsoft
  606.     in connection with this program.  Place it with MVGAVU or anywhere your
  607.     DOS PATH has access to.  MVGAVU is a part of VGACAD.  ONLY ONE COPY OF
  608.     BRUN41.EXE IS REQUIRED.
  609.  
  610.                                                          
  611.     REGISTRATION
  612.  
  613.     REGISTRATION OF MVGAVU IS BASED ON 'PERSONAL USAGE'.  CORPORATE OR
  614.     ORGANIZATIONAL USERS *MUST* REGISTER ALL COPIES USED ON AN INDIVIDUAL
  615.     BASIS; A SPECIFIC PERSON (NAME) MUST BE EXPLICITLY ASSIGNED TO EACH
  616.     REGISTRANT WHO WILL BE PROVIDED WITH A CORRESPONDING REGISTER.OVL FILE TO
  617.     INDICATE REGISTERED USAGE.  REGISTRATION GRANTS A SPECIFIC PERSON (NOT A
  618.     JURIDICAL PERSON OR CORPORATE ENTITY) THE RIGHT TO 'USE' MVGAVU.
  619.  
  620.     ┌───────────────────────────────────────────────────────────────────┐
  621.     │ ALTHOUGH WE WILL TRY TO RESPOND TO YOUR REGISTRATION IN 2-3 WEEKS,│
  622.     │ PLEASE ALLOW UP TO 4-6 WEEKS DELAY TO PROCESS YOUR REGISTRATION.  │
  623.     └───────────────────────────────────────────────────────────────────┘
  624.  
  625.     As token of our appreciation (i.e., to registered users), we will send
  626.     you the the latest version of the VGACAD system; many of the programs
  627.     listed below do not require a graphics card.
  628.  
  629.     GIFPUB - converts 256 color GIF/PCX files to B&W images desktop
  630.     publishing (DTP) as .PCX (Ventura, First Publisher, Publisher's
  631.     Paintbrush, WP, Pagemaker).  Variable sizing/contrast/brightness.
  632.     Includes printing on IBM/Epson, HP Laser and compatible printers.
  633.     Variable sizes. 8 pics/page and/or  Single/Double Pass printing on
  634.     dot matrix printers. Preview in CGA/HGC/EGA/VGA/EEGA/SVGA. Histogram-
  635.     equalization.  No graphics card required.
  636.  
  637.     GIFBIT - converts B&W PCX files (e.g., scanner output to 32KBx32KB !)
  638.     to grey shades for VGACAD image processing, GIFPUB redithering or
  639.     printing, or VGA2EGA conversion - it edits those "scan line jitters".
  640.     Viewing modes in MCGA/VGA/SVGA.  No graphics card required.
  641.  
  642.     SQZGIF/EGA2VGA - converts LARGE GIF/PCX pics (to 2KBx2KBx256) to
  643.     several sizes and video modes using "color averaging" to blend/smooth
  644.     "jaggies" or fast interpolation.  Variable sizing.  Also, converts
  645.     GIFs (16 colors and below) and creates up to 256 new colors; outputs
  646.     directly to GIFPUB, GIFDOT, VGACAD, MVGAVU, VGA2CGA or VGA2EGA.
  647.     No graphics card required.
  648.  
  649.     GIFHEX (formerly VGA2EGA) - converts 256-color pictures to 16-color
  650.     EGA or VGA .  Error-distributed dithering.  User support to 1024x768.
  651.     Variable sizing/RGBICMY/contrast.  EGA/MCGA/VGA required.
  652.  
  653.     MVGAVU - latest version.
  654.  
  655.     VGACAD - extensive paint/image processing program for VGA/MCGA users
  656.     (edit GIFs up to 32KBx32KBx256 !!!); airbrushes, color and grey image
  657.     processing functions (smoothing, noise removal, shading, contrast
  658.     stretching, edge detection, ...), splines, Cut&Paste, variable sizing,
  659.     256-color gradient/pattern fills, MORE !  Full screen SuperVGA editing
  660.     and image processing function to 1024x768x256.   360x480x256 support.
  661.     MCGA/VGA required.
  662.  
  663.     VGA2CGA - converts 256 color GIFs to CGA!  See "405" colors in an
  664.     unsupported 160x100x16 CGA mode.  CGA/EGA/MCGA/VGA required.
  665.  
  666.     MAC2GIF - converts .MAC ("readmac") pictures to 5-16 grey shades or
  667.     color and saves to .GIF or BLD/PLT file.  EGA/MCGA/VGA required.
  668.  
  669.     VGACAP - resident utility to capture 256-color MCGA/VGA or SVGA images.
  670.     FAST 640x480x256/16 or 800x600x256/16 and 1024x768x256/16 screen grabs.
  671.  
  672.     VGAFIL - GIF, PCX, BMP (Windows 3.x) and TGA (Targa 16) encoding
  673.     utility.  Accepts ALL RAW file formats used by our utilites as well as
  674.     BLD/PLT files.  This utility replaces RAW2GIF, RAW2PCX and BLD2GIF.
  675.  
  676.  
  677.     WHAT'S NEXT ?
  678.  
  679.     Aside from enhancing existing releases with greater capabilities (e.g.,
  680.     expanded memory, virtual screen, SVGA functions, other graphics
  681.     formats), we are developing VGACBT (Computer-Based Training program)
  682.     and MANNEQUIN for Advertising/Fashion Design or creating your own
  683.     artistic nudes.  We will try to develop and integrate more image
  684.     processing functions for all our applications; if you have any image
  685.     processing functions you would like to see, please let us know.
  686.  
  687.     In the short term, we are developing RGBLAB.  This is a color reduction
  688.     utility to 'downsize' 24-bit or 16 Million-color pictures to 256-colors.
  689.     RAW red, green and blue files, TIFF (*.TIF), TARGA (*.TGA) and Windows
  690.     3.x (*.BMP) files will be the main input sources.  IDTVGA dithering will
  691.     play a key role in previewing or rendering 24-bit images in SVGA
  692.     256-color modes.
  693.  
  694.     Support maverick authors like us and we will continue developing
  695.     products like nothing seen commercially - otherwise they will simply
  696.     "DIE" from lack of support !  Compare the cost/benefit ratio of any of
  697.     our products with commercial products.  You, and you alone, determine
  698.     whether it will be worthwhile to continue developing.  Support the
  699.     User-Supported (Shareware) concept.  Register your Shareware copies.
  700.     To register, send the registration form and check or money order payable
  701.     in USD to:
  702.  
  703.                                Dr. Marvin Gozum
  704.                   2 Independence Place #1105, 6th & Locust
  705.                             Philadelphia, PA 19106
  706.  
  707.  
  708.  
  709.     ACKNOWLEDGEMENT
  710.  
  711.     We would like to thank John Bridges for releasing VGAKIT.ARC which
  712.     included source code for 'bank switching' the Tseng, Paradise, Trident,
  713.     Everex, C&T, ATI, Oak chipsets and source for the popular 360x480x256
  714.     mode.  We would like to thank Mike Abrash for publishing source code (in
  715.     Programmer's Journal) for the 320x400x256 mode.  Seminal variants have
  716.     been developed based on their evolving work into MVGAVU.  We are grateful
  717.     to Don Babcock, for QBASM's GIF adaptations of Tom Pfau's Public Domain
  718.     LZW source (in LZW.ARC) for QB4 linking, which provided invaluable
  719.     guidance in resolving QB4 memory allocation problems.  Thanks a meg -
  720.     John, Mike, Don and Tom !
  721.  
  722.  
  723.     ───────────────────────────────────────────────────────
  724.     Graphics Interchange Format and GIF are trademarks (tm)
  725.     of CompuServe Inc. an H&R Block Company.
  726.  
  727.