home *** CD-ROM | disk | FTP | other *** search
/ CD Shareware Masterblend / cdsharewaremasterblend.iso / graf-cad / vpicgraf / vpic.doc < prev    next >
Text File  |  1991-08-30  |  52KB  |  1,023 lines
  1.                          VPIC USERS MANUAL
  2.                A Picture File Viewing/Conversion Program
  3.         (C) Copyright 1990 Bob Montgomery, All Rights Reserved
  4.                         by Bob Montgomery
  5.                           CIS 73357,3140
  6.  
  7. INTRODUCTION
  8. Background
  9.  
  10. The original program was called VGIF, reflecting its ability to view only GIF
  11. files. When the program evolved to include other paint file formats, its name
  12. was changed to VPIC. VPIC ver 4.0 and up implements all of the GIF89a features.
  13. See the revision history in Appendix A for latest additions and bug fixes.
  14.  
  15. Print VPIC.TXT at 17 chars/inch and 8 lines/inch for a handy reference card.
  16. Look at the section titled 'How Vpic Operates' for an explanation of the
  17. differences between VPIC and other viewers, and the advantages and
  18. disadvantages of both types.
  19.  
  20. IMPORTANT: VPIC requires DOS 2.0 or up to run from current directory, or DOS 3.0
  21. up to run from anywhere. You must configure VPIC for your graphics board using
  22. CVPIC or CONFIG (unless you have an Orchid Designer VGA with 512 K). The WHICHVGA
  23. program will try to identify your VGA chip and amount of display memory.
  24. See CONFIG.DOC.
  25.  
  26. The Graphics Interchange Format (GIF) is a Service Mark owned by Compuserve
  27. Incorporated. For further information, please contact:
  28.     Compuserve incorporated, Graphics Technology Department,
  29.     5000 Arlington Center Boulevard, Columbus, Ohio 43220, USA
  30.  
  31. GENERAL FEATURES
  32. VPIC is a file viewer for EGA, MCGA, VGA and SuperVGA, and has the following
  33. features:
  34.   *  Views the following file formats in EGA, MCGA, VGA, or SuperVGA:
  35.      1. Dr. Halo CUT files (with PAL if present). Not Dr. Halo PIC files, which
  36.         are display adapter specific.
  37.      2. GIF87a and GIF89a files; saves to GIF87a format only since GIF89a stuff
  38.         is mainly animation and text handling enhancements. Saves up to 2 pages
  39.         of comments for GIF89a files.
  40.      3. Deluxe Paint LBM (or IFF) files, regular and enhanced.
  41.      4. MAC files, display only.
  42.      5. Pictor/PC Paint PIC files.
  43.      6. ZSoft PCX files (including 256 color files).
  44.      7. ColorRIX/EGA Paint SCx files, uncompressed only. RIX wont tell anyone
  45.         his compression algorythm, so compressed files can't be done. Use
  46.         RIXLATE to uncompress SCx files that are compressed.
  47.      8. Targa 8 thru 32 TGA files, comressed or uncompressed. Also uncompresses
  48.         Targa files that are compressed (e option while viewing). Now supports
  49.         the Tseng ET-4000 HiColor card in 16 bit color, but file conversion
  50.         options don't work from viewing screen.
  51.      9. Binary Image Files (BIF) from B&W image capture boards.
  52.     10. Microsoft Windows 3.0 Bitmap BMP files, compressed or uncompressed. The
  53.         compression algorythm is inefficient, so for pictures without much
  54.         repetition, uncompressed files are generrally smaller than compressed
  55.         files.
  56.  
  57.   *  Saves current image to any of the above formats (except MAC, FRA, BIF, and
  58.      IFF) in the current mode (EGA, MCGA, or VGA). Also uncompresses TGA files,
  59.      and converts a color picture to a 64 grey shade image (in VGA mode).
  60.  
  61.   *  Saves current image to GIF in regular, interlaced, inverted, mirrored,
  62.      or rotated 90 degrees CW or CCW. Great for scans.
  63.  
  64.   *  Configurable for display boards using the Ahead, ATI, C&T, Everex, Genoa,
  65.      Headland, Oak, Paradise, Trident (TVGA8800BS/CS & TVGA8900), Tseng(ET-3000 &
  66.      ET-4000), Video 7, Western Digital, or Zymos VGA chips (see configuring
  67.      VPIC below). The CONFIG program semi-automates the configuration process.
  68.      If your display board implements the VESA standard (thru BIOS or a TSR),
  69.      this will be autodetected and used regardless of the configuration; the
  70.      only drawback to VESA is you can't scroll down quite as far.
  71.  
  72.   *  /R option allows an application program to show a file and regain control
  73.      without changing the screen mode.
  74.  
  75.   *  Viewing mode can be manually selected or auto selected from menu.
  76.  
  77.   *  Allows you to specifiy a new path from the menu with the [F9] key. Also
  78.      updates menu when files are added or deleted.
  79.  
  80.   *  Very fast GIF decoding.
  81.  
  82.   MENU FEATURES:
  83.   *  Mark/unmark files for viewing with [SPACEBAR].
  84.   *  Menu text color setable in configuration file.
  85.   *  [F1] gives help.
  86.   *  [F2] shows marked files like a slideshow.
  87.   *  [F3] gives file size and colors.
  88.   *  [F4] toggles between EGA and VGA mode.
  89.   *  [F5/F6] decrease/increase default resolution.
  90.   *  [F7] Locks current resolution, or selects auto resolution mode.
  91.   *  [F8] Makes multiple GIF images pause for a keypress.
  92.   *  [F9] prompts for new path.
  93.   *  [F10] shows current path for files.
  94.   *  Shows marked files singly or like a slide show.
  95.   *  Handles up to 500 files using mouse or keyboard.
  96.  
  97.   MOUSE SUPPORT
  98.   * All the above functions are now controllable by the mouse. Click on the
  99.     resolution bar, bottom 2 lines of commands, or files. For the menu screen,
  100.     the left button is the same as enter, and the right button is the same as
  101.     the spacebar. While decoding, the right button aborts; while viewing, the
  102.     left button returns to the menu.
  103. ==============================================================================
  104.   VIEWING FEATURES
  105.   *  Help while viewing with / or ? key.
  106.   *  Shows filename while decoding, and [ESC] aborts decoding.
  107.   *  Allows deleting a file (with query) with the [Alt-X] key.
  108.   *  Allows adjustment of picture color and VGA contrast and brightness.
  109.   *  Allows saving the current image as a GIF (many options), PC Paint or
  110.      Pictor, ZSoft PCX, ColoRIX or EGA Paint, Targa 16, Dr. Halo CUT, and
  111.      Deluxe Paint II formats in EGA, MCGA, or VGA.
  112. =============================================================================
  113. RUNNING VPIC
  114. Command Format: vpic [[path]filespec][/a][/b][/c][/e][/h][/mN][/r][/v][/w]
  115.                      [/xN][/yN][/z][/?].
  116.   *  The default path is the current directory, and the default extensions are
  117.      CUT, GIF, IFF, LBM, MAC, PIC, PCX, SCx, and TGA.
  118.   *  The /a option starts VPIC in Auto resolution select mode.
  119.   *  The /b option causes VPIC to beep after displaying a file except in slide
  120.      mode or /r.
  121.   *  The /c option gives the current configuration; see 6 below.
  122.   *  The /e option forces EGA mode, to use extended 16 color modes; see 5 below.
  123.   *  The /h option allows the viewing of hidden files.
  124.   *  The /mN locks the video mode to N where N is defined when you run CONFIG,
  125.      and in 3 below.
  126.   *  The /r option returns control to a calling program leaving picture on the
  127.      screen; see 4 below. Calling program must reset text mode (mode co80).
  128.   *  The /v option disables the auto VESA detection and uses the config file
  129.      info.
  130.   *  The /w option wait for a keypress after each image in a multi_image GIF
  131.      file.
  132.   *  The /xN option gives a left margin of N pixels (ie /x20 gives a 20 pixel
  133.      left margin).
  134.   *  The /yN option gives a top margin of N pixels.
  135.   *  The /z option inhibits printing the filename of each file.
  136.   *  The /? option gives a help screen.
  137.   *  If filespec is a filename, the single file will be shown (the default
  138.      extension is GIF).
  139.   *  If path\filespec is a directory, a menu of all viewable files in that
  140.      directory will appear. Otherwise all files meeting the filespec will
  141.      appear. For example, [vpic d:\pics\*.pcx] would give a menu of all PCX
  142.      files in the PICS directory of drive D, while [vpic d:\pics] would give a
  143.      menu of all viewable files in the PICS directory of drive D.
  144.   Options and filespec may be entered in any order. All options except /r, /c,
  145.   and /? work in menu and single file mode. The /r option only works in single
  146.   file mode.
  147.  EXAMPLES OF VPIC COMMANDS
  148.     1. VPIC [path\]filename[.ext] shows the file specified. The default path is
  149.        the current directory, and the default extension is GIF.
  150.  
  151.     2. VPIC [path\][filespec] to get a menu of all files in the specified path
  152.        meeting filespec (may contain wildcards). The default path is the c