home *** CD-ROM | disk | FTP | other *** search
/ 1st Canadian Shareware Disc / 1st_Canadian_Shareware_Disc_1991.ISO / graphics / vgaimg11 / vgaimage.doc next >
Text File  |  1989-05-15  |  14KB  |  309 lines
  1. VGAIMAGE    Version 1.1    5/15/89
  2.  
  3.   By: Hoke Johnson
  4.  
  5. VGAIMAGE is a shareware image viewer/maker program for the IBM PC.  It is
  6. optimized for use with VGA cards and monitors but allows viewing of Gif images
  7. on EGA monitors but currently is really only good for 16 color EGA Gif
  8. pictures.  VgaImage was created to provide many additional image viewing
  9. features which I haven't been able to find in other image viewing programs.
  10. This is the second release of VGAIMAGE and it currently supports GIF and TIFF
  11. file formats.
  12.  
  13. NEW FEATURES:
  14.  
  15.   Improved Gif writing speed
  16.  
  17.   Support for Paradise VGA boards in 640x400 mode
  18.  
  19.   Relaxed memory requirements for display of large Gif files
  20.  
  21.   Improved Tiff Tag handling, will try and view image even if there are
  22.   unknown Tags.
  23.  
  24.   Handling of 8-bit per pixel Tiff files
  25.  
  26. FEATURES:
  27.  
  28.   Gif and Tiff file viewing
  29.  
  30.   Conversion of Halftoned and 16 level Tiff files to 64 level Gif files
  31.   Conversion of 256 level Tiff files to 256 level Gif files
  32.  
  33.   High Resolution VGA Support for Tseng VGA boards (Orchid Designer VGA)
  34.   and Paradise VGA boards (Viewing only for Paradise VGA boards)
  35.  
  36.   Zoom mode support for Tseng Labs VGA boards
  37.  
  38.   16 level Gray Scale display of Gif files on normal VGA boards at 640x480
  39.  
  40.   16 level Gray Scale display of Gif files on Tseng Labs boards at 1024x768
  41.  
  42.   50% size reduction on large Gif files to fit them on small 320x200 screen
  43.     and ability to write them as reduced size Gif files
  44.  
  45.   Gif and Tiff header display
  46.  
  47.   Brightness controls
  48.  
  49.   Smooth Vertical scrolling of large images
  50.  
  51.   Setting of the number of bits of resolution to be used for the RGB primaries
  52.     (Between 1 and 6 bits of resolution)
  53.  
  54. STARTUP PARAMETERS:
  55.  
  56.   Usage: vgaimage [GCType]
  57.  
  58.   Where GCType is: one of the following graphic card types:
  59.     EGA, SUPEREGA, VGA, DESIGNERVGA, PARADVGA
  60.  
  61.   Graphic card type can also be changed once the program is running
  62.  
  63. HARDWARE REQUIREMENTS:
  64.  
  65.   IBM PC with at least 256K memory and a VGA or EGA graphics card and
  66.   suitable monitor.  The graphics card should also have at least 256K
  67.   of memory.  This version has been improved to utilize less memory for
  68.   displaying large GIF files than was required by the previous versions.
  69.  
  70.   This program works best with the Tseng labs chip set as is on the Orchid
  71.   Designer VGA board and a multi-sync monitor,  it also works well with
  72.   Paradise VGA boards as well as with the standard VGA but doesn't have the
  73.   high resolution 640x480 and 256 colors, only the normal 320x200x256 of the
  74.   standard VGA.
  75.  
  76. COMMANDS TO SELECT IMAGE FILES AND DISPLAY MODES
  77.  
  78.   Once program is started, a list of available files for viewing is
  79.   displayed for selection.  Change the highlighted file by using the
  80.   cursor arrow keys as well as the home and end keys.  With desired
  81.   file selected press the enter key to view the selected file,  when
  82.   done viewing press the enter key again to return to file selection
  83.   mode.  Currently the first 120 files in the current directory are
  84.   available for viewing.
  85.  
  86.   F1 - Help Screen
  87.  
  88.   I  - Changes the input file type for viewing.  Currently GIF and TIFF are
  89.        supported
  90.  
  91.   O  - Changes the output file type to be written during a write command.
  92.        Currently only GIF is supported.
  93.  
  94.   F9 - Change directory.  Press F9 and then respond with the desired new
  95.        directory followed by a Carriage Return.
  96.  
  97.   D  - Change the display type.  Pressing the D key sequences through all
  98.        the currently supported Graphic Card types.
  99.  
  100.   H  - Causes the file header contents to be displayed prior to the image
  101.        being displayed.  Header remains displayed until a CR is entered.
  102.  
  103.   L  - Causes the display program to shrink the displayed image by 50% in
  104.        both the horizontal and vertical directions.  This mode is only
  105.        enabled in VGA 320x200 mode.
  106.  
  107.   E  - Changes to a 16 level gray scale display mode for Gif files.  For
  108.        normal IBM VGA type boards this gives a 640x480 display with 16
  109.        levels of gray.  With Designer VGA boards (Tseng Labs)it is possible to
  110.        switch between 640x480 and 1024x768 modes at 16 levels of gray by using
  111.        the F8 key.
  112.  
  113.   F8 - High Resolution Lock mode.  This is only usable with the Designer
  114.        VGA type boards.  This gives 800x600 and 256 colors without the
  115.        E key pressed and 1024x768 and 16 levels of gray with the E key
  116.        pressed.  (A multisync monitor is also required)
  117.  
  118.   F10 or ESC are used to exit from VGAIMAGE.
  119.  
  120.   S  - Sets internal special flag which allows a modified Orchid Designer
  121.        VGA board to display 800x600x256 mode properly.  Normally this setting
  122.        should be left alone (ie OFF), if anyone is interested, write me for
  123.        details.
  124.  
  125.   G  - In Gif view mode this key selects the number of bits of resolution
  126.        for each primary color to use when viewing.  In Tiff view mode this
  127.        key is used to select the number of levels of gray to use when the
  128.        Tiff file is displayed.  This value can be 2, 16, 64 or 256.  Not
  129.        all Tiff files can be viewed in all possible levels of gray output.
  130.  
  131.        The supported Tiff renderings are:
  132.  
  133.            2 level Tiff to   2 level display
  134.            2 level Tiff to  64 level display
  135.           16 level Tiff to  16 level display
  136.           16 level Tiff to  64 level display
  137.          256 level Tiff to 256 level display
  138.  
  139. COMMANDS WHILE IMAGE IS BEING VIEWED
  140.  
  141.   B  - Changes image to BW equivalent picture
  142.  
  143.   C  - Restores original color picture
  144.  
  145.   T  - Decreases the number of bits of resolution for each primary. Values
  146.        supported are 1 to 6 bits of resolution.  This can be used to get a
  147.        rough idea on the amount of resolution that a given image has by
  148.        starting out at the maximum and reducing until you can see a
  149.        deterioration in the image quality.
  150.  
  151.   G  - Complement to the T command,  increases the number of bits of
  152.        resolution for each primary.
  153.  
  154.   +  - Increase the brightness of the displayed image.
  155.  
  156.  (-) - Decrease the brightness of the displayed image.
  157.  
  158.   0  - Restore image to its original brightness (Zero key)
  159.  
  160.   W  - Writes the currently displayed image in the specified outfile format.
  161.        Currently only GIF is supported.  The actual image can be larger than
  162.        the display screen,  for instance 640x819 for the Designer VGA card.
  163.        The writing speed has been improved by a factor of approximately 10
  164.        times over the previous version.  Large files can be output in GIF
  165.        format in a minute or two on an AT machine.  The output filename of the
  166.        new file is the same as the first filename with the new extension if we
  167.        are converting from one file type to another.  If the intended new
  168.        filename already exists,  a new filename is used which has the last
  169.        letter of the filename "incremented".  Writing is currently not
  170.        possible in 640x400x256 Paradise VGA mode or in any of the EGA modes
  171.        including the 16 level gray mode invoked by the E key.
  172.  
  173.   Z  - Turns Zoom mode on and off for Tseng boards (Designer VGA)
  174.  
  175.   <  - Decrease Zoom factor (actually the "," key)
  176.  
  177.   >  - Increase Zoom factor (actually the "." key)
  178.  
  179.        While in Zoom mode you can scroll around the picture by using the
  180.        Home, PGup, PGdn, and cursor arrow keys.
  181.  
  182.   M  - Smooth vertical scrolling of images which are larger than the
  183.        display screen.  This is usable on Designer VGA boards with Gif images
  184.        with a Height greater than 480 and on normal VGA boards when using the
  185.        16 gray level mode and files with a height greater than 480.
  186.  
  187. NOTES ON VIEWING TIFF FILES AND MAKING GIF FILES FROM TIFF FILES
  188.  
  189.   Black and White Tiff files can be viewed and converted into Gif files.  Tiff
  190.   file support is currently only available for VGA type boards.  Tiff files
  191.   with 1 bit per pixel, 4 bits per pixel and 8 bits per pixel are supported.
  192.  
  193.   When viewing Tiff files with 1 bit per pixel, and Tiff Gray Levels set to
  194.   64, VGAIMAGE converts to an image with 64 levels of gray.  In doing so the
  195.   pixel width and height of the original Tiff Image is reduced by a factor of
  196.   eight.  For instance a 1 bit per pixel Tiff image with a width of 4800
  197.   pixels and a height of 6400 pixels will reduce to an image with a width of
  198.   600 pixels by a height of 800 pixels where each pixel has six bits per
  199.   pixel.  It is also possible to view Tiff images without the conversion to 6
  200.   bits per pixel by setting the Tiff Gray Levels to 1 by pressing the G key.
  201.   Currently it is not possible to make a valid Gif file when there is only one
  202.   bit per pixel.
  203.  
  204.   When viewing Tiff files with 4 bits per pixel, VGAIMAGE can display an image
  205.   with either 16 or 64 levels of gray.  The Tiff Gray Levels setting controls
  206.   which mode is used (G key).  When viewing Tiff files with 4 bits per pixel
  207.   and 64 levels of gray displayed, the height and width of the image is
  208.   reduced by a factor of 2, thus a 1200 x 960 image will reduce to 600 x 480.
  209.  
  210.   VGAIMAGE has been tested with a few 256 level Tiff files but none from
  211.   scanned photos,  this type of Tiff file should produce the best results.
  212.   The 6 bit limitation of the VGA card causes the displayed image to be of
  213.   only 64 levels but the full resolution is maintained when creating an
  214.   output GIF file.  (If the 256 level Tiff file is brightened or darkened
  215.   prior to saving as a GIF then the gray scal levels will be rounded off to
  216.   6 bits or 64 gray levels in the palette)
  217.  
  218.   VGAIMAGE has been tested with Tiff files created by HP Scanning Gallery and
  219.   with Tiff files created by HALO DPE.  Best image results are achieved by
  220.   using HP Scanning Gallery,  using the Fatting Dither setting,  setting the
  221.   brightness setting to Lighten and a custom resolution of 600 dots per inch.
  222.   This allows a normal A size sheet of paper to be scanned and produces an
  223.   image of approximately 600 x 800 with 64 levels of gray.  Normally it is
  224.   necessary to brighten the image by pressing the "+" key approximately 6 to
  225.   10 times prior to saving the image as a Gif file.  The Tiff files produced
  226.   using this method vary from 2.5 to 4.4 Megabytes but can be compressed using
  227.   one of the available "archiving" utilities to produce files < 1.2 Mbytes
  228.   which allows them to be stored on 1.2 M floppies and thus moved between
  229.   machines.  Images can be produced using the 16 levels of gray however I have
  230.   found that the images are usually darker and need to be brightened so much
  231.   that you loose image quality.  The 16 levels of gray would probably do well
  232.   on a picture that was very bright to start with.
  233.  
  234. SHAREWARE:
  235.  
  236.   VGAIMAGE is user supported software.  VGAIMAGE is made available for a
  237.   free ten day trial period.  If you find VGAIMAGE useful,  you may license
  238.   the program for non-commercial use on one machine by sending $15.00 to:
  239.  
  240.               Hoke Johnson
  241.               P.O. Box 35602
  242.               Monte Sereno, CA 95030
  243.  
  244.   All other rights reserved.
  245.  
  246.   VGAIMAGE may not be modified in any way by anyone other than the author.
  247.   VGAIMAGE may be freely distributed to others only in its complete and
  248.   unmodified form with no fee charged other than postage, media or
  249.   duplication charges.
  250.  
  251.   Regardless of how your copy of VGAIMAGE was obtained,  it is requested
  252.   that you comply with the above licensing agreement.
  253.  
  254.   All warranties are disclaimed,  including damage to hardware and/or
  255.   software from use of this product.
  256.  
  257. FUTURE ENHANCEMENTS
  258.  
  259.   The following are some of the planned future enhancements:
  260.  
  261.   -Better error checking during GIF decoding
  262.  
  263.   -PCX file format support
  264.  
  265.   -Support for more types of TIFF files (64 gray level)
  266.  
  267.   -Better TIFF support of standard VGA board (16 gray level support at
  268.      640x480 resolution)
  269.  
  270.   -Support for more types of high resolution VGA boards
  271.  
  272.   -Tiff to Gif conversion without going through the Video display ram,
  273.    this will allow image conversion on a fast machine which doesn't have
  274.    a VGA card or on the machine connected to the scanner that doesn't
  275.    have a VGA card.
  276.  
  277. FEEDBACK AND COMMENTS
  278.  
  279.   I welcome your comments, you can contact me by mail
  280.  
  281.               Hoke Johnson
  282.               P.O. Box 35602
  283.               Monte Sereno, CA 95030
  284.  
  285.   For now,  I do not plan on trying to support compressed Tiff files since
  286.   the packages I have seen have the option of specifying whether the output
  287.   Tiff file is compressed or not and the compression efficiency is not that
  288.   good anyway.
  289.  
  290. CHANGES:
  291.  
  292. VGAIMAGE Version 1.0,  03/27/89 - Initial Release
  293.  
  294. VGAIMAGE Version 1.1,  05/15/89
  295.  
  296.   - Fixed problem which didn't sort directory listing properly when there
  297.     were only two files to be displayed
  298.   - Enhanced GIF output routine to produce maximally compressed files and
  299.     improved speed drastically by using hashing and improving the disk
  300.     i/o routines.
  301.   - Added support for displaying 640x400x256 colors on the Paradise VGA
  302.     board.
  303.   - Decreased the amount of memory required for displaying very large GIF
  304.     files.
  305.   - Added additional Tiff Tag handling and allowed program to attempt to
  306.     display image even if there are some unhandled tags.  A list of
  307.     unhandled tags is also listed when the Header display is enabled.
  308.   - Added support for 256 level Tiff files
  309.