home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / GRAFIK / TOOLS / VGACAP / VGACAP.DOC < prev    next >
Text File  |  1993-12-01  |  21KB  |  485 lines
  1.        VGACAP (c) Copr. 1987-91 Lawrence Gozum & Marvin Gozum
  2.        ───────────────────────────────────────────────────────
  3.  
  4.                                  User Manual
  5.  
  6.     DISCLAIMER
  7.  
  8.     This product is distributed AS IS.  The authors specifically disclaim
  9.     all warranties ,expressed or implied, including ,but not limited to,
  10.     implied warranties of merchantability and fitness for a particular
  11.     purpose with respect to defects in the diskette and documentation, and
  12.     program license granted herein, in particular, and without limiting
  13.     operation of the program license with respect to any particular
  14.     application use or purpose.  In no event shall the authors be liable
  15.     for any loss of profit or any other commercial damage including but
  16.     not limited to special, incidental, consequential or other damages.
  17.  
  18.  
  19.     LICENSING AGREEMENT
  20.  
  21.     You may use this program for a 10 DAY TRIAL PERIOD.  Should you find
  22.     this program useful, you MUST register it; you will then be provided
  23.     with the latest releases of the VGACAD system see last section of this
  24.     manual).  Freely distribute UNMODIFIED copies of VGACAP*.ZIP and charge
  25.     $10 max for distribution, in lieu of recognized Users Group guidelines
  26.     (e.g., Asso. of Shareware Professionals or NY Amateur Computer Club).
  27.  
  28.  
  29.     WHAT IS VGACAP ?
  30.  
  31.     VGACAP is a resident utility that captures pictures in
  32.  
  33.         MCGA 320x200x256
  34.          VGA 640x480x16
  35.         SVGA 640x480x256
  36.         SVGA 800x600x16
  37.         SVGA 800x600x256
  38.         SVGA 1KBx768x16
  39.             and
  40.         SVGA 1KBx768x256
  41.  
  42.     VGACAP will capture and "Bsave" 320x200x256 pictures; all others are
  43.     saved to *.RAW file files (ie., "RAW" pixel dumps).
  44.  
  45.  
  46.     WHAT IS VGAFIL ?
  47.  
  48.     VGAFIL is a conversion program for use in a batch file (*.BAT) or as an
  49.     interactive stand-alone program; BLD/PLT files are 320x200x256 screens,
  50.     all others are RAW/PLT files.  VGAFIL is designed to integrate directly
  51.     with VGACAD v2.0 (and up) and replace BLD2GIF and RAW2GIF.  Moreover,
  52.     VGAFIL converts and saves captured images to 32768-color TGA (Targa 16),
  53.     256-color BMP (Windows 3.x), PCX, GIF files or 16-color GIF files.
  54.     VGAFIL is also a utility to customize and configure VGACAP to take
  55.     advantage of specific SVGA chipset hardcoding for FAST screen captures.
  56.  
  57.  
  58.     VGACAP and VGAFIL can be viewed as a generic conversion utility system
  59.     since almost any MCGA/VGA/SVGA image from (320x200 to 1024x768) that can
  60.     be viewed, can be converted to/from GIF, PCX, BMP or TGA format !  If you
  61.     can view files using 'less popular formats', you can capture and convert
  62.     them like so ...
  63.  
  64.    'LESS POPULAR'
  65.     FILE FORMATS (input)
  66.  
  67.      EFS  \
  68.      WIPS  \
  69.      SFP    \
  70.      PIG     \
  71.      RAS      \ YOUR   -->  SVGA
  72.      ISF      / VIEWER --> SCREEN
  73.      PDA     /               |        CAPTURED      VGAFIL
  74.      DEGAS  /              VGACAP --> RAW FILES --> UTILITY
  75.      GEM   /                                           |
  76.      ETC  /                                            |
  77.                          'MORE POPULAR'
  78.                           FILE FORMATS (output)
  79.  
  80.                               GIF
  81.                               PCX
  82.                               BMP (Windows 3.x)
  83.                               TGA (Targa)
  84.  
  85.  
  86.  
  87.     REQUIREMENTS
  88.  
  89.     About 512KB of memory is required for VGAFIL, although it uses about 2/3
  90.     of that; it, also, requires that the BRUN41.exe runtime module be present
  91.     in your present path; this is explained later in this manual.  You MUST
  92.     have a VGA or MCGA adaptor (at least BIOS compatible) present and an
  93.     analog monitor to use VGACAP.  VGACAP uses about 4KB of RAM.  To use
  94.     the VGA 640x480x16 or ANY SVGA mode, you MUST have VGA or SVGA.
  95.  
  96.  
  97.     COMPATIBILITY
  98.  
  99.     The BRUN41.exe runtime module HATES 'Shadow RAM' (ie., putting your
  100.     VIDEO BIOS in low or high RAM); it 'hangs' (at least on our 386 SX).
  101.     If VGAFIL 'locks-up' at start-up then you have this problem too;
  102.     disable 'Shadow RAM' (eg., via CMOS set-up) and it should work.
  103.  
  104.     Trident TVGA card users that have the supposedly rare 'BR versions'
  105.     will notice that the bank switching will be erroneous.  We tried to
  106.     accomodate this version but ended up compromising the more popular
  107.     TVGA 8800 and 8900 versions <sorry>.   The Trident 1024x768x256 grabs
  108.     are not supported at this time since it uses a very peculiar, card
  109.     specific, bank switching methodology (ie., it conflicts with SVGA
  110.     display conventions); screen grabs are limited 800x600x256 or
  111.     1024x768x16, if available.
  112.  
  113.     ATI SVGA card users CANNOT capture 1024x768x16 screens if they are
  114.     trigerred via mode 65 (hex) since this is the old packed mode that
  115.     is inconsistent with SVGA 16-color display conventions.  ATI users
  116.     MUST view 1024x768x16 screens via mode 55 (hex), the planar mode,
  117.     to grab them.
  118.  
  119.     If you grab a screen from an application that "simulates" the SVGA
  120.     640x480x256 mode and get 1/4th of the screen or get four 1/4ths of
  121.     the screen then you grabbed from the unsupported 360x480x256 mode
  122.     NOT a real SVGA 640x480x256 screen; you must configure that application
  123.     for a TRUE 640x480x256 SVGA mode if your card supports it.
  124.  
  125.     If you create CUSTOM colors in your Windows 3.x environment, the
  126.     BMP encoding algorithm may not work as well as it should; it will do
  127.     its best with the Windows 3.x default color palette.
  128.  
  129.     If you are having compatibility problems with VGACAP (particularly SVGA
  130.     bank switching) or VGAFIL encoding, please contact Lawrence Gozum
  131.     [73437,2372] via CompuServe's
  132.  
  133.                   E-Mail
  134.                 or
  135.                 PICs Forum
  136.  
  137.  
  138.  
  139.  
  140.     CONFIGURING VGACAP
  141.  
  142.     VGACAP, on default, is set for BIOS operations;  BIOS calls are 'generic'
  143.     and should work with most, if not all, SVGA cards.   However, BIOS calls
  144.     are slow.  By using the hardware configuration, VGACAP will capture
  145.     screens in 2-3 seconds compared to about 20-30 seconds for 800x600x256
  146.     screens (based on 28ms HD on 16 MHz 386sx).
  147.  
  148.     To configure VGACAP for your specific hardware type
  149.  
  150.                         VGAFIL -V <ret>
  151.                                or
  152.                         VGAFIL -C <ret>
  153.  
  154.     A menu will guide you.  Simply select the letter which corresponds to
  155.     your video card chipset.  Remember, when in doubt, return the setting
  156.     to BIOS operations.  BIOS operations does not guarantee that it will
  157.     work, generally, if your video board manufacturer took care in
  158.     writing its BIOS - it SHOULD work.  BIOS grabs are limited to a
  159.     maximum of 800x600x256/16 resolution, if available.
  160.  
  161.  
  162.     HOW TO USE VGACAP
  163.  
  164.     Run VGACAP before entering your painting/CAD or digitized picture
  165.     viewer.   Press <ALT-F4>, while viewing your picture in any paint/CAD
  166.     program and the screen and palette will be saved in your default drive
  167.     and directory.  If you are viewing your picture in MCGA/VGA 320x200x256
  168.     then it will be "Bsaved".  If you are NOT is MCGA/VGA 320x200x256 mode,
  169.     then VGACAP will assume you are in an SVGA mode !  Since 800x600x16,
  170.     1024x768x16 and 1024x768x256 modes cannot be reliably differentiated,
  171.     capturing screens in those modes require pressing different HOTKEYS.
  172.  
  173.     <alt-F4> is the HOTKEY for  MCGA 320x200x256
  174.                      VGA 640x480x16
  175.                     SVGA 640x480x256
  176.                        and
  177.                     SVGA 800x600x256
  178.  
  179.     <alt-F6>  is the HOTKEY for SVGA 800x600x16
  180.  
  181.     <alt-F7>  is the HOTKEY for SVGA 1KBx768x16
  182.  
  183.     <alt-F10> is the HOTKEY for SVGA 1KBx768x256
  184.  
  185.     You'll note that we tried to keep the "hotkeys" as easy as possible
  186.     to remember.
  187.  
  188.         <alt-F4>  '4' all the common modes
  189.  
  190.         <alt-F6>  for 800x600x16
  191.                   *
  192.  
  193.         <alt-F7>  for 1024x768x16
  194.                    *
  195.  
  196.         <alt-F10> for 1024x768x256
  197.                   **
  198.  
  199.     Note: Some applications (eg., Windows) will NOT allow "hotkeys" and
  200.       will not allow screen captures.
  201.  
  202.  
  203.     The first time you run the program it will save your screen and palette
  204.     to SCREEN00.BLD (.RAW) and SCREEN00.PLT respectively.  If there is an
  205.     existing SCREENxx.BLD (.RAW) or SCREENxx.PLT file, it will increment to
  206.     the next higher number.  You can use your favorite memory managers to
  207.     remove this TSR or reboot to release it from memory.
  208.  
  209.     Note: Other programs, such as VGTIZE (Oculus-20 video grabbing
  210.       software) alters the video mode to the extent that garbage
  211.       results in files.
  212.  
  213.     If you are viewing in MCGA 320x200x256 then a SCREENxx.BLD and *.PLT
  214.     file is saved.  SCREENxx.RAW files are saved in all other cases; the
  215.     "Bload" header is not included and a "RAW" contiguous pixel dump is
  216.     implemented.  If you wish, you can easily design your own utilities to
  217.     read and process these "RAW" pixel dumps; they are simple contiguous
  218.     pixel dumps (eg. 307,200 bytes = 640 x 480 pixels for VGA 640x480x16
  219.     or SVGA 640x480x256 screens).  The *.PLT files remain the same.
  220.  
  221.     Note: When in DOS or using a picture viewer or application which
  222.       requires a keypress to continue, it is necessary to hit
  223.       another key after hitting the 'HOTKEY'.
  224.  
  225.  
  226.     LOADING/CONVERTING SCREEN GRABS WITH VGAFIL
  227.  
  228.     If you type "VGAFIL <ret>", then you can select any filename by moving a
  229.     highlighted bar (with the arrow keys) and pressing the <return> key.
  230.     Pressing <Spc> allows you to select a different PATH, while <Esc> exits.
  231.  
  232.     A matching *.PLT file MUST exist or an error message will result.
  233.     A *.GIF or *.PCX file is created with the corresponding name.
  234.     GIF/PCX FILES WITH THE SAME NAME WILL BE OVERWRITTEN !
  235.  
  236.     On default, VGAFIL selects RAW/PLT files.  BLD/PLT files can be selected
  237.     by using the "-B" option.
  238.  
  239.                         VGAFIL -B <ret>
  240.  
  241.     On default, all captured screens are converted to GIF (87a) files.
  242.     To convert screens to 256-color PCX files, use the "-P" option.
  243.  
  244.                         VGAFIL -P <ret>
  245.  
  246.     To convert screens to 256-color BMP files for Windows 3.x, use the
  247.     "-W" option (for uncompressed Windows 3.x "Wallpaper").  A special
  248.     color palette procesing option is applied to reduce "hot spots" when
  249.     Windows alters and remaps the image to fit Windows color scheme.
  250.  
  251.                         VGAFIL -W <ret>
  252.  
  253.     To convert screens to 32768-color TGA files for XGA, Hercules GS,
  254.     Targa cards (and other "high-end clones"), use the "-T" option (for
  255.     uncompressed Targa-16 format").
  256.  
  257.             VGAFIL -T <ret>
  258.  
  259.     To convert screens to 16-color GIF files, use the "-H" (ie., "Hex)
  260.     option.  USE THIS OPTION ONLY WHEN YOU ARE SURE YOU ARE ENCODING
  261.     16-COLOR IMAGE GRABS OR THE PROGRAM WILL HANG !!!
  262.  
  263.             VGAFIL -H <ret>
  264.  
  265.  
  266.  
  267.     COMMAND LINE AND BATCH FILES
  268.  
  269.     VGAFIL can be used in batch (*.BAT) files for multiple conversions.
  270.     Simply type "VGAFIL [filename] " with no extension (path optional) for
  271.     every file you want to convert in your batch file;  you can also use
  272.     this method if you want to convert a specific file from DOS.
  273.  
  274.          Examples:   VGAFIL screen00
  275.                      VGAFIL -B screen00
  276.                      VGAFIL \capture\screen99
  277.                      VGAFIL -B \capture\screen99
  278.                      VGAFIL -P \capture\screen99
  279.                      VGAFIL -W \capture\screen99
  280.              VGAFIL -T \capture\screen99
  281.              VGAFIL -H \capture\screen99
  282.  
  283.     VGAFIL will automatically search for the RAW/PLT files or BLD/PLT files.
  284.     If no files are found or matching *.PLT file is missing, then an error
  285.     will result; the matching PLT files MUST be in the same drive/directory
  286.     or default drive/directory.
  287.  
  288.  
  289.     TEMP, MVGASCRN, NYBLSCRN, AND USERSCRN FILES
  290.  
  291.     TEMPorary files are used by VGACAD, SQZGIF, GIFPUB, ... (and other
  292.     utilities we may release).  When TEMP files are detected by VGAFIL, you
  293.     will be prompted to convert it.  If you acknowledge the prompt, you will
  294.     be presented with two options: 16-color encoding and forcing 1:1 Aspect
  295.     Ratio (these options will work ONLY for GIF files).
  296.  
  297.     MVGASCRN files are essentially similar to *.RAW files.  USERSCRN files
  298.     are created with VGACAD (v2.0 and up) and SQZGIF (v2.1 and up); these
  299.     files have unusual screen sizes and have additional support files like
  300.     TEMP files.
  301.  
  302.     NYBLSCRN (a "nybble" is half a byte or 4 bits or 16 colors) files have
  303.     special meaning for VGAFIL.  If VGAFIL detects this filename, it
  304.     immediately converts the file in TRUE 16-color format; this applies
  305.     only to GIF files.
  306.  
  307.  
  308.     16-COLOR MODE GRAB & CONVERSION
  309.  
  310.     All VGA 640x480x16 screens will be grabbed regardless of the hardcoded
  311.     hardware setting of VGACAP.
  312.  
  313.     SVGA 800x600x16 screens can also be captured in two ways:
  314.  
  315.     1) With the <alt-F4> 'hotkey', if and only if the BIOS configuration
  316.        is used, since your video card will determine and execute the
  317.        appropriate routine, albeit much slower.
  318.  
  319.     2) With the <alt-F6> 'hotkey', using FAST direct memory read
  320.        routines (actually more dependable than BIOS in some respects).
  321.  
  322.     16-color images will be saved as 256-color files with the remaining
  323.     240 colors unused UNLESS
  324.  
  325.         you rename the captured files to NYBLSCRN.*
  326.         and use GIF encoding (default)
  327.  
  328.         or
  329.  
  330.         use the "-H" option.
  331.  
  332.  
  333.     Note: Using the "-P","-W" or "-T" option will encode a 16-color .PCX,
  334.           .BMP or .TGA file BUT it will be encoded and viewable as a
  335.           256-color or 32768-color image with remaining colors unused
  336.           (ie., you can still view the 16-color PCX, BMP or TGA file, BUT
  337.           only in 256-color or greater mode).
  338.        
  339.           256-color PCX compression of 16-color images is VERY poor (it is
  340.           not designed that way).  It would be better to encode 16-color
  341.           GIF files with VGAFIL then use another program (eg., VPIC) to
  342.           convert the 16-color GIF to a 16-color PCX file.
  343.        
  344.  
  345.  
  346.     THE CHAINED VGACAD ENVIRONMENT
  347.  
  348.     BRUN41.exe is a runtime module distributed under licence with Microsoft;
  349.     it can be distributed and used ONLY in connection with this program.
  350.     You can place it in any drive/directory as long as your PATH has access
  351.     to it.  VGACAD v2.0 and up integrates VGAFIL into its chained
  352.     environment; it is actually a module of VGACAD (v2.0 and up).
  353.  
  354.     The advantage of using the BRUN41.exe is an integrated system of
  355.     utilities and "sub-programs".  New releases will be modified to support
  356.     the "chained environment", with VGACAD as the integrator.  Only one copy
  357.     of BRUN41.exe is required.
  358.  
  359.  
  360.     USING SVGA SCREEN GRABS IN VGACAD
  361.  
  362.     If you capture a 640x480x256 or 800x600x256 screen for direct editing in
  363.     VGACAD then:
  364.  
  365.     (1)  from the VSCRN Menu, create a blank 640x480 or 800x600 Virtual
  366.          Screen (whichever corresponds to captured screen);
  367.  
  368.     (2)  exit VGACAD and DO NOT DELETE the TEMP files;
  369.  
  370.     (3)  overwrite TEMP.RAW and TEMP.PLT with the selected SCREENxx.RAW
  371.          and SCREENxx.PLT files; for example, at DOS prompt type
  372.  
  373.                         "COPY screen00.* temp.*" <ret>
  374.  
  375.     (4)  run VGACAD and load TEMP.PLT at the Files Menu;
  376.  
  377.     (5)  click the VSCRN box; at the VSCRN Menu, click iSCR vDSK then OK;
  378.          you see the captured 640x480x256 or 800x600x256 image as the new
  379.          Virtual Screen.
  380.  
  381.  
  382.     REGISTRATION
  383.  
  384.     REGISTRATION OF VGACAP IS BASED ON 'PERSONAL USAGE'.  CORPORATE OR
  385.     ORGANIZATIONAL USERS *MUST* REGISTER ALL COPIES USED ON AN INDIVIDUAL
  386.     BASIS; A SPECIFIC PERSON (NAME) MUST BE EXPLICITLY ASSIGNED TO EACH
  387.     REGISTRANT WHO WILL BE PROVIDED WITH A CORRESPONDING REGISTER.OVL FILE
  388.     TO INDICATE REGISTERED USAGE.  REGISTRATION GRANTS A SPECIFIC PERSON
  389.     (NOT A JURIDICAL PERSON OR CORPORATE ENTITY) THE RIGHT TO 'USE'
  390.     VGACAP OR VGAFIL.
  391.  
  392.     ┌───────────────────────────────────────────────────────────────────┐
  393.     │ ALTHOUGH WE WILL TRY TO RESPOND TO YOUR REGISTRATION IN 2-3 WEEKS,│
  394.     │ PLEASE ALLOW UP TO 4-6 WEEKS DELAY TO PROCESS YOUR REGISTRATION.  │
  395.     └───────────────────────────────────────────────────────────────────┘
  396.  
  397.     As token of our appreciation (i.e., to registered users), we will send
  398.     you the the latest version of the VGACAD system; many of the programs
  399.     listed below do not require a graphics card.
  400.  
  401.  
  402.     GIFPUB - converts 256 color GIF/PCX files to B&W images desktop
  403.     publishing (DTP) as .PCX (Ventura, First Publisher, Publisher's
  404.     Paintbrush, WP, Pagemaker).  Variable sizing/contrast/brightness.
  405.     Includes printing on IBM/Epson, HP Laser and compatible printers.
  406.     Variable sizes. 8 pics/page and/or  Single/Double Pass printing on
  407.     dot matrix printers. Preview in CGA/HGC/EGA/VGA/EEGA/SVGA. Histogram-
  408.     equalization.  No graphics card required.
  409.  
  410.     GIFBIT - converts B&W PCX files (e.g., scanner output to 32KBx32KB !)
  411.     to grey shades for VGACAD image processing, GIFPUB redithering or
  412.     printing, or VGA2EGA conversion - it edits those "scan line jitters".
  413.     Viewing modes in MCGA/VGA/SVGA.  No graphics card required.
  414.  
  415.     SQZGIF/EGA2VGA - converts LARGE GIF/PCX pics (to 2KBx2KBx256) to
  416.     several sizes and video modes using "color averaging" to blend/smooth
  417.     "jaggies" or fast interpolation.  Variable sizing.  Also, converts
  418.     GIFs (16 colors and below) and creates up to 256 new colors; outputs
  419.     directly to GIFPUB, GIFDOT, VGACAD, MVGAVU, VGA2CGA or VGA2EGA.
  420.     No graphics card required.
  421.  
  422.     GIFHEX (formerly VGA2EGA) - converts 256-color pictures to 16-color
  423.     EGA or VGA .  Error-distributed dithering.  User support to 1024x768.
  424.     Variable sizing/RGBICMY/contrast.  EGA/MCGA/VGA required.
  425.  
  426.     MVGAVU - EGA/MCGA/EEGA/VGA/SVGA viewer for GIF, TGA (Targa 16/24/32),
  427.     BMP (Windows 3.0) and BLD/PLT files.  A unique SVGA 32K-color rendering
  428.     is used in viewing 24-bit BMP files or TGA files in 16/256-color modes.
  429.     4096 file selection.  Smart slideshows - picks best mode.  320x400x256
  430.     and 360x480x256 modes.  GIF 89a support.  AutoSize/AutoCenter/AutoAspect.
  431.     RGB/Color/Contrast/Brightness and Monitor adjust.  1:1, 5:6 and TGA aspect
  432.     ratio correction.  EGA/MCGA/VGA required.
  433.  
  434.     VGACAD - extensive paint/image processing program for VGA/MCGA users
  435.     (edit GIFs up to 32KBx32KBx256 !!!); airbrushes, color and grey image
  436.     processing functions (smoothing, noise removal, shading, contrast
  437.     stretching, edge detection, ...), splines, Cut&Paste, variable sizing,
  438.     256-color gradient/pattern fills, MORE !  Full screen SuperVGA editing
  439.     and image processing function to 1024x768x256.   360x480x256 support.
  440.     MCGA/VGA required.
  441.   
  442.     VGA2CGA - converts 256 color GIFs to CGA!  See "405" colors in an
  443.     unsupported 160x100x16 CGA mode.  CGA/EGA/MCGA/VGA required.
  444.  
  445.     MAC2GIF - converts .MAC ("readmac") pictures to 5-16 grey shades or
  446.     color and saves to .GIF or BLD/PLT file.  EGA/MCGA/VGA required.
  447.  
  448.  
  449.     WHAT'S NEXT ?
  450.  
  451.     Aside from enhancing existing releases with greater capabilities (e.g.,
  452.     expanded memory, virtual screen, SVGA functions, other graphics
  453.     formats), we are developing VGACBT (Computer-Based Training program)
  454.     and a specialized application for Advertising/Fashion Design or creating
  455.     your own artistic nudes.  We will try to develop and integrate more image
  456.     processing functions for all our applications; if you have any image
  457.     processing functions you would like to see, please let us know.
  458.  
  459.     In the short term, we are developing RGBLAB.  This is a color reduction
  460.     utility to 'downsize' 24-bit or 16 Million-color pictures to 256-colors.
  461.     RAW red, green and blue files, TIFF (*.TIF), TARGA (*.TGA) and Windows
  462.     3.x (*.BMP) files will be the main input sources.  IDTVGA dithering will
  463.     play a key role in previewing or rendering 24-bit images in SVGA
  464.     256-color modes.
  465.  
  466.     Support maverick authors like us and we will continue developing
  467.     products like nothing seen commercially - otherwise they will simply
  468.     "DIE" from lack of support !  Compare the cost/benefit ratio of any of
  469.     our products with commercial products.  You, and you alone, determine
  470.     whether it will be worthwhile to continue developing.  Support the
  471.     User-Supported (Shareware) concept.  Register your Shareware copies.
  472.     To register, send the registration form and check or money order payable
  473.     in USD to:
  474.  
  475.                                Dr. Marvin Gozum
  476.                   2 Independence Place #1105, 6th & Locust
  477.                             Philadelphia, PA 19106
  478.  
  479.  
  480.  
  481.     ───────────────────────────────────────────────────────
  482.     Graphics Interchange Format and GIF are trademarks (tm)
  483.     of CompuServe Inc. an H&R Block Company.
  484.  
  485.