home *** CD-ROM | disk | FTP | other *** search
/ PC Format 4 / Disk4.iso / A / VCAD.EXE / VGACAP.DOC < prev    next >
Text File  |  1991-02-21  |  17KB  |  369 lines
  1.          VGACAP v7.1 (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).
  25.  
  26.     You can freely distribute copies of unmodified VGACAP and charge $10
  27.     max for distribution, in lieu of recognized Users Group guidelines
  28.     (e.g., Asso. of Shareware Professionals or NY Amateur Computer Club).
  29.  
  30.  
  31.     WHAT IS VGACAP ?
  32.  
  33.     VGACAP is a resident utility that captures pictures in 320x200x256
  34.     VGA/MCGA mode, any 640x480x256 SVGA mode or any 800x600x256 SVGA mode
  35.     (e.g., Genoa GVGA, Tseng 3000/3000, Paradise/PVGA, Trident 8800/8900,
  36.     ATI, Video7, C&T 452/453, Oak, ...) supported.  VGACAP will capture and
  37.     "Bsave" 320x200x256 pictures; SVGA 640x480x256 and 800x600x256 pictures
  38.     will be saved to *.RAW file files (ie., "RAW" pixel dumps).
  39.  
  40.  
  41.     WHAT IS VGAFIL ?
  42.  
  43.     VGAFIL is a conversion program for use in a batch file (*.BAT) or as an
  44.     interactive stand-alone program; RAW and BLD/PLT files are 640x480x256
  45.     or 800x600x256 screens, or 320x200x256 screens respectively.  VGAFIL is
  46.     designed to integrate directly with VGACAD v2.0 (and up) and replace
  47.     BLD2GIF and RAW2GIF.  Moreover, VGAFIL converts and saves captured
  48.     images to 32768-color TGA (Targa 16), 256-color BMP (Windows 3.0), PCX,
  49.     GIF files or 16-color GIF files.  VGAFIL is also a utility to customize
  50.     and configure VGACAP to take advantage of specific SVGA chipset
  51.     hardcoding for FAST screen captures.
  52.  
  53.  
  54.     REQUIREMENTS
  55.  
  56.     About 512KB of memory is required for VGAFIL, although it uses about 2/3
  57.     of that; it, also, requires that the BRUN41.exe runtime module be present
  58.     in your present path; this is explained later in this manual.  You MUST
  59.     have a VGA or MCGA adaptor (at least BIOS compatible) present and an
  60.     analog monitor to use VGACAP.  VGACAP uses about 3KB of RAM.  To use
  61.     the 640x480x256 or 800x600x256 capture mode, you MUST have SVGA.
  62.  
  63.  
  64.     CONFIGURING VGACAP
  65.  
  66.     VGACAP, on default, is set for BIOS operations;  BIOS calls are 'generic'
  67.     and should work with most, if not all, SVGA cards.   However, BIOS calls
  68.     are slow.  By using the hardware configuration, VGACAP will capture
  69.     screens in 2-3 seconds compared to about 20-30 seconds for 800x600x256
  70.     screens (based on 28ms HD on 18 MHz 386sx).
  71.  
  72.     To configure VGACAP for your specific hardware type
  73.  
  74.                         VGAFIL -V <ret>
  75.                                or
  76.                         VGAFIL -C <ret>
  77.  
  78.     A menu will guide you.  Simply select the letter which corresponds to
  79.     your video card chipset.  Remember, when in doubt, return the setting
  80.     to BIOS operations.  BIOS operations does not guarantee that it will
  81.     work, generally, if your video board manufacturer took care in
  82.     writing its BIOS - it SHOULD work.
  83.  
  84.     If you are having compatibility problems with VGACAP or VGAFIL please
  85.     contact Lawrence Gozum by:
  86.  
  87.         1) E-plex at CompuServe [73437,2372]
  88.         2) E-mail at the CompuServe PICs Forum
  89.         3) Telephone (416) 923-3387
  90.         4) Mail at
  91.                         One Oriole Rd. #206
  92.                         Toronto, Ontario
  93.                         Canada M4V 2E7
  94.  
  95.  
  96.  
  97.     HOW TO USE VGACAP
  98.  
  99.     Run VGACAP before entering your painting/CAD or digitized picture
  100.     viewer.   Press <ALT-F4>, while viewing your picture in any paint/CAD
  101.     program and the screen and palette will be saved in your default drive
  102.     and directory.  If you are viewing your picture in MCGA/VGA 320x200x256
  103.     then it will be "Bsaved".  If you are NOT is MCGA/VGA 320x200x256 mode,
  104.     then VGACAP will assume you are in an SVGA mode !
  105.  
  106.                         <alt-F4> is the HOTKEY
  107.  
  108.     The first time you run the program it will save your screen and palette
  109.     to SCREEN00.BLD (.RAW) and SCREEN00.PLT respectively.  If there is an
  110.     existing SCREENxx.BLD (.RAW) or SCREENxx.PLT file, it will increment to
  111.     the next higher number.  You can use your favorite memory managers to
  112.     remove this TSR or reboot to release it from memory.
  113.  
  114.     If you are viewing in 640x480x256 SVGA mode or 800x600x256 SVGA mode,
  115.     then the SCREENxx.BLD file is changed to SCREENxx.RAW; the "Bload" header
  116.     is not included and a "RAW" contiguous pixel dump is implemented.  If you
  117.     wish, you can easily design your own utilities to read and process these
  118.     "RAW" pixel dumps; they are simple contiguous pixel dumps with file sizes
  119.     of 307,200 bytes (i.e., 640 x 480 = 307,200 pixels) for 640x480x256 SVGA
  120.     mode and 480,000 bytes for 800x600x256 SVGA mode.  The *.PLT files remain
  121.     the same.
  122.  
  123.     Note:     When in DOS or using a picture viewer (e.g., PICEM, VPIC, or
  124.               CSHOW) or application which requires a keypress to continue, it
  125.               is necessary to hit another key after hitting the 'HOTKEY'.
  126.  
  127.  
  128.     LOADING/CONVERTING SCREEN GRABS WITH VGAFIL
  129.  
  130.     If you type "VGAFIL <ret>", then you can select any filename by moving a
  131.     highlighted bar (with the arrow keys) and pressing the <return> key.
  132.     Pressing <Spc> allows you to select a different PATH, while <Esc> exits.
  133.  
  134.     A matching *.PLT file MUST exist or an error message will result.
  135.     A *.GIF or *.PCX file is created with the corresponding name.
  136.     GIF/PCX FILES WITH THE SAME NAME WILL BE OVERWRITTEN !
  137.  
  138.     On default, VGAFIL selects RAW/PLT files.  BLD/PLT files can be selected
  139.     by using the "-B" option.
  140.  
  141.                         VGAFIL -B <ret>
  142.  
  143.     On default, all captured screens are converted to GIF (87a) files.
  144.     To convert screens to 256-color PCX files, use the "-P" option.
  145.  
  146.                         VGAFIL -P <ret>
  147.  
  148.     To convert screens to 256-color BMP files for Windows 3.0, use the
  149.     "-W" option (for uncompressed Windows 3.0 "Wallpaper").
  150.  
  151.                         VGAFIL -W <ret>
  152.  
  153.     To convert screens to 32768-color TGA files for XGA, Hercules HGSC,
  154.     Targa cards (and other "high-end clones"), use the "-T" option (for
  155.     uncompressed Targa 16 bits format").
  156.  
  157.                         VGAFIL -T <ret>
  158.  
  159.  
  160.     COMMAND LINE AND BATCH FILES
  161.  
  162.     VGAFIL can be used in batch (*.BAT) files for multiple conversions.
  163.     Simply type "VGAFIL [filename] " with no extension (path optional) for
  164.     every file you want to convert in your batch file;  you can also use
  165.     this method if you want to convert a specific file from DOS.
  166.  
  167.          Examples:   VGAFIL screen00
  168.                      VGAFIL -B screen00
  169.                      VGAFIL \capture\screen99
  170.                      VGAFIL -B \capture\screen99
  171.                      VGAFIL -P \capture\screen99
  172.                      VGAFIL -W \capture\screen99
  173.                      VGAFIL -T \capture\screen99
  174.  
  175.     VGAFIL will automatically search for the RAW/PLT files or BLD/PLT files.
  176.     If no files are found or matching *.PLT file is missing, then an error
  177.     will result; the matching PLT files MUST be in the same drive/directory
  178.     or default drive/directory.
  179.  
  180.  
  181.     TEMP, MVGASCRN, NYBLSCRN, AND USERSCRN FILES
  182.  
  183.     TEMPorary files are used by VGACAD, SQZGIF, GIFPUB, EGA2VGA, ... (and
  184.     other utilities we may release).  When TEMP files are detected by
  185.     VGAFIL, you will be prompted to convert it.  It you acknowledge the
  186.     prompt, you will be presented with two options: 16-color encoding and
  187.     forcing 1:1 Aspect Ratio (these options will work ONLY for GIF files).
  188.  
  189.     MVGASCRN files are essentially similar to *.RAW files.  USERSCRN files
  190.     are created with VGACAD (v2.0 and up) and SQZGIF (v2.1 and up); these
  191.     files have unusual screen sizes and have additional support files like
  192.     TEMP files.
  193.  
  194.     NYBLSCRN (a "nybble" is half a byte or 4 bits or 16 colors) files have
  195.     special meaning for VGAFIL.  If VGAFIL detects this filename, it
  196.     immediately converts the file in TRUE 16-color format; this applies
  197.     only to GIF files.
  198.  
  199.  
  200.     16-COLOR MODE GRAB & CONVERSION
  201.  
  202.     Most 640x480x16 and 800x600x16 screens can be captured IF the BIOS
  203.     configuration is used.  Through the BIOS, your video card will
  204.     determine and execute the appropriate routine, albeit much slower.
  205.     16-color images will be saved as 256-color files with the remaining
  206.     240 colors unused UNLESS you rename the captured files to NYBLSCRN.*
  207.     and use GIF encoding (default).
  208.  
  209.     1.  Configure VGACAP (with VGAFIL to use BIOS).
  210.     2.  Load VGACAP (by "running" it).
  211.     3.  View your 16-color image in VGA 640x480x16 or SVGA 800x600x16 mode.
  212.     4.  Grab it (press alt-F4).
  213.     5.  Rename captured files to NYBLSCRN.
  214.  
  215.         eg., nename SCREEN00.* NYBLSCRN.* <ret>
  216.  
  217.     6.  Run VGAFIL and convert to GIF (ie., with NO OPTIONS ).
  218.  
  219.     Note: Using the "-P","-W" or "-T" option will encode a 16-color .PCX,
  220.           .BMP or .TGA file BUT it will be encoded and viewable as a
  221.           256-color or 32768-color image with remaining colors unused
  222.           (ie., you can still view the 16-color PCX, BMP or TGA file, BUT
  223.           only in 256-color or greater mode).
  224.        
  225.           256-color PCX compression of 16-color images is VERY poor (it is
  226.           not designed that way).  It would be better to encode 16-color
  227.           GIF files with VGAFIL then use another program (eg., VPIC) to
  228.           convert the 16-color GIF to a 16-color PCX file.
  229.        
  230.  
  231.  
  232.     THE CHAINED VGACAD ENVIRONMENT
  233.  
  234.     BRUN41.exe is a runtime module distributed under licence with Microsoft;
  235.     it can be distributed and used ONLY in connection with this program.
  236.     You can place it in any drive/directory as long as your PATH has access
  237.     to it.  VGACAD v2.0 and up integrates VGAFIL into its chained
  238.     environment; it is actually a module of VGACAD (v2.0 and up).
  239.  
  240.     The advantage of using the BRUN41.exe is an integrated system of
  241.     utilities and "sub-programs".  New releases will be modified to support
  242.     the "chained environment", with VGACAD as the integrator.  Only one copy
  243.     of BRUN41.exe is required.
  244.  
  245.  
  246.     USING SVGA SCREEN GRABS IN VGACAD (v1.6 and up)
  247.  
  248.     If you capture a 640x480x256 or 800x600x256 screen for direct editing in
  249.     VGACAD then:
  250.  
  251.     (1)  from the VSCRN Menu, create a blank 640x480 or 800x600 Virtual
  252.          Screen (whichever corresponds to captured screen);
  253.  
  254.     (2)  exit VGACAD and DO NOT DELETE the TEMP files;
  255.  
  256.     (3)  overwrite TEMP.RAW and TEMP.PLT with the selected SCREENxx.RAW
  257.          and SCREENxx.PLT files; for example, at DOS prompt type
  258.  
  259.                         "COPY screen00.* temp.*" <ret>
  260.  
  261.     (4)  run VGACAD and load TEMP.PLT at the Files Menu;
  262.  
  263.     (5)  click the VSCRN box; at the VSCRN Menu, click iSCR vDSK then OK;
  264.          you see the captured 640x480x256 or 800x600x256 image as the new
  265.          Virtual Screen.
  266.  
  267.  
  268.     REGISTRATION
  269.  
  270.     REGISTRATION OF VGACAP IS BASED ON 'PERSONAL USAGE'.  CORPORATE OR
  271.     ORGANIZATIONAL USERS *MUST* REGISTER ALL COPIES USED ON AN INDIVIDUAL
  272.     BASIS; A SPECIFIC PERSON (NAME) MUST BE EXPLICITLY ASSIGNED TO EACH
  273.     REGISTRANT WHO WILL BE PROVIDED WITH A CORRESPONDING REGISTER.OVL FILE
  274.     TO INDICATE REGISTERED USAGE.  REGISTRATION GRANTS A SPECIFIC PERSON
  275.     (NOT A JURIDICAL PERSON OR CORPORATE ENTITY) THE RIGHT TO 'USE'
  276.     VGACAP OR VGAFIL.
  277.  
  278.     ┌───────────────────────────────────────────────────────────────────┐
  279.     │ ALTHOUGH WE WILL TRY TO RESPOND TO YOUR REGISTRATION IN 2-3 WEEKS,│
  280.     │ PLEASE ALLOW UP TO 4-6 WEEKS DELAY TO PROCESS YOUR REGISTRATION.  │
  281.     └───────────────────────────────────────────────────────────────────┘
  282.  
  283.     As token of our appreciation (i.e., to registered users), we will send
  284.     you the the latest version of the VGACAD system; many of the programs
  285.     listed below do not require a graphics card.
  286.  
  287.  
  288.     GIFPUB - converts 256 color GIF/PCX files to B&W images desktop
  289.     publishing (DTP) as .PCX (Ventura, First Publisher, Publisher's
  290.     Paintbrush, WP, Pagemaker).  Variable sizing/contrast/brightness.
  291.     Includes printing on IBM/Epson, HP Laser and compatible printers.
  292.     Variable sizes. 8 pics/page and/or  Single/Double Pass printing on
  293.     dot matrix printers. Preview in CGA/HGC/EGA/VGA/EEGA/SVGA. Histogram-
  294.     equalization.  No graphics card required.
  295.  
  296.     GIFBIT - converts B&W PCX files (e.g., scanner output to 32KBx32KB !)
  297.     to grey shades for VGACAD image processing, GIFPUB redithering or
  298.     printing, or VGA2EGA conversion - it edits those "scan line jitters".
  299.     Viewing modes in MCGA/VGA/SVGA.  No graphics card required.
  300.  
  301.     SQZGIF/EGA2VGA - converts LARGE GIF/PCX pics (to 2KBx2KBx256) to
  302.     several sizes and video modes using "color averaging" to blend/smooth
  303.     "jaggies" or fast interpolation.  Variable sizing.  Also, converts
  304.     GIFs (16 colors and below) and creates up to 256 new colors; outputs
  305.     directly to GIFPUB, GIFDOT, VGACAD, MVGAVU, VGA2CGA or VGA2EGA.
  306.     No graphics card required.
  307.  
  308.     GIFHEX (formerly VGA2EGA) - converts 256-color pictures to 16-color
  309.     EGA or VGA .  Error-distributed dithering.  User support to 1024x768.
  310.     Variable sizing/RGBICMY/contrast.  EGA/MCGA/VGA required.
  311.  
  312.     MVGAVU - EGA/MCGA/EEGA/VGA/SVGA viewer for GIF and BLD/PLT files.
  313.     Smart slideshows - picks best mode.  320x400x256, 360x480x256 and
  314.     640x400x16 modes on regular VGA.  EGA posterization.  EEGA/SVGA
  315.     support.  Auto-sizing.  Contrast/Brightness.  EGA/MCGA/VGA required.
  316.  
  317.     VGACAD - extensive paint/image processing program for VGA/MCGA users
  318.     (edit GIFs up to 32KBx32KBx256 !!!); airbrushes, color and grey image
  319.     processing functions (smoothing, noise removal, shading, contrast
  320.     stretching, edge detection, ...), splines, Cut&Paste, variable sizing,
  321.     256-color gradient/pattern fills, MORE !  Full screen SuperVGA editing
  322.     and image processing function to 1024x768x256.   360x480x256 support.
  323.     MCGA/VGA required.
  324.   
  325.     VGA2CGA - converts 256 color GIFs to CGA!  See "405" colors in an
  326.     unsupported 160x100x16 CGA mode.  CGA/EGA/MCGA/VGA required.
  327.  
  328.     MAC2GIF - converts .MAC ("readmac") pictures to 5-16 grey shades or
  329.     color and saves to .GIF or BLD/PLT file.  EGA/MCGA/VGA required.
  330.  
  331.  
  332.  
  333.     WHAT'S NEXT ?
  334.  
  335.     Aside from enhancing existing releases with greater capabilities (e.g.,
  336.     expanded memory, virtual screen, SVGA functions, other graphics
  337.     formats), we are developing VGACBT (Computer-Based Training program)
  338.     and MANNEQUIN for Advertising/Fashion Design or creating your own
  339.     artistic nudes.  We will try to develop and integrate more image
  340.     processing functions for all our applications; if you have any image
  341.     processing functions you would like to see, please let us know.
  342.  
  343.     In the short term, we are developing RGBLAB.  This is a color reduction
  344.     utility to 'downsize' 24-bit or 16 Million-color pictures to 256-colors.
  345.     RAW red, green and blue files, TIFF (*.TIF), TARGA (*.TGA) and Windows
  346.     3.0 (*.BMP) files will be the main input sources.  IDTVGA dithering will
  347.     play a key role in previewing or rendering 24-bit images in SVGA
  348.     256-color modes.
  349.  
  350.     Support maverick authors like us and we will continue developing
  351.     products like nothing seen commercially - otherwise they will simply
  352.     "DIE" from lack of support !  Compare the cost/benefit ratio of any of
  353.     our products with commercial products.  You, and you alone, determine
  354.     whether it will be worthwhile to continue developing.  Support the
  355.     User-Supported (Shareware) concept.  Register your Shareware copies.
  356.     To register, send the registration form and check or money order payable
  357.     in USD to:
  358.  
  359.                                Dr. Marvin Gozum
  360.                   2 Independence Place #1105, 6th & Locust
  361.                             Philadelphia, PA 19106
  362.  
  363.  
  364.  
  365.     ───────────────────────────────────────────────────────
  366.     Graphics Interchange Format and GIF are trademarks (tm)
  367.     of CompuServe Inc. an H&R Block Company.
  368.  
  369.