home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / GLEN / VGIFPIC1.ZIP / VGIF.DOC < prev    next >
Text File  |  1988-05-26  |  13KB  |  240 lines
  1. VGIF.EXE ver 3.2 by Bob Montgomery [CIS 73357,3140]           5-26-88
  2. See revision history for new items. Now supports standard VGA and Orchid
  3. extended VGA. Don't know what it will do with other VGA cards in extended mode.
  4.  
  5. This is a GIF file viewer for VGA/EGA with the following features:
  6.   *  Now supports VGA and extended VGA for boards with the Tseng VGA chips.
  7.   *  Determines equipment and uses VGA where possible.
  8.   *  Very fast GIF decoding.
  9.   *  Menu driven for selecting file(s) to view; returns with cursor at last
  10.           position.
  11.   *  Shows specified files like a slide show for EGA.
  12.   *  /R option allows an application program to show a file and regain control.
  13.   *  Creates PC Paint, ZSoft, Dr. Halo, or EGA PAint file from current pic for EGA.
  14.   *  Gives much better color rendition.
  15.   *  Now allows creation of full size PC Paint, ZSoft, Dr. Halo (.CUT and .PIC)
  16.      and EGA Paint files in EGA mode.
  17.   *  VGIF got smarter; don't need # to spec a directory.
  18.   *  Now handles up to 500 files.
  19.  
  20. The commands are:
  21. 1. vgif [path\]filename[.ext] [/r] to show a single file. The default path is 
  22.      the current directory, and the default extension is GIF.
  23.      The /r option shows the file and then returns to DOS (or a calling appli-
  24.      cation program) with the picture still on the screen in EGA mode (mode 16).
  25.      It is not necessary to change video mode between viewing each file, but it
  26.      is up to the calling program to reset text mode (mode 3) after all viewing 
  27.      is done.
  28.  
  29. 2. vgif [.ext] to get a menu of up to 80 files in current dir with extension ext.
  30.      The default extension is GIF. This is handy if you have some pictures that
  31.      you don't want to come up in the normal menu; ie, adult and nude pics can
  32.      be renamed to ADL extension. 
  33.  
  34. 3. vgif [path\][filespec] to get a menu of all files in the specified path
  35.      meeting filespec (may contain wildcards). The default path is the current
  36.      directory, and the default filespec is *.GIF; just entering 'vgif' will
  37.      give a menu of all GIF files in the current directory. Shows whether VGA or
  38.      EGA and VGA modes supported in upper left corner.
  39.  
  40. 4. vgif @[path\]filename[.ext]  to do a slide show from commands in filename. The
  41.      default path is the current directory, and the default extension is SLD.
  42.      The commands are placed on seperate lines, and consist of either a filename
  43.      (GIF extension assumed), or a delay (viewing time) spec of the form  d n
  44.      where n is the desired viewing time in seconds. The default viewing time is
  45.      5 seconds if no delay spec is given. Press any key to end the slide show.
  46.      Pictures that are 320 or less pixels wide are displayed double size.
  47.  
  48. 5. vgif /e forces and EGA display with VGA, so all file conversions, slide mode,
  49.      and palette revisions work; forces operation like VGIF ver 2.0.
  50.  
  51. 6. vgif ?  gives a help screen.
  52.  
  53. Commands in menu mode: * => EGA only
  54. 1.   The up, down, right, and left arrow keys move the cursor around the menu
  55.      of files. PgDn/PgUp goto next/previous page. Pressing a key goes to next
  56.      file starting with this character.
  57. 2.   Pressing the spacebar marks a file for viewing or slides, and moves to the 
  58.      next file; it will also unmark a previously marked file.
  59. 3.   Pressing enter will display the marked files in the order they were marked.
  60.      If no files were marked, pressing enter displays the file at the cursor.
  61. 4.   Pressing F3 will display the file size and colors on the next to last line.
  62. 5.   Pressing F1 will bring up the help screen; any key will return to the menu.
  63. 6. * Pressing F2 will do a slide show of marked files until a key is pressed;
  64.      doesn't work yet for VGA.
  65. 7.   Pressing ESCape ends the program and returns to DOS.
  66. 8.   Pressing Ctrl Break (or Ctrl C) will get you directly to DOS.
  67. All other keys are ignored. If errors are encountered, an error message appears
  68. on the next to last line, and disappears when the cursor is moved. 
  69. The menu title is the search spec.
  70.  
  71. Commands while viewing a file (except in slide mode):
  72. 1.   The up/down arrow keys will scroll the picture if longer than the screen.
  73.      The PgUp and PgDn keys will scroll by 10 lines.
  74. 2.   If pic is <= 1/2 the screen width, pressing 2 will give a double size image
  75.      (which may be scrollable) and pressing 1 will give the normal size again.
  76.      For VGA, the picture will be chaged only in the horizontal direction; this
  77.      will unsquash some 320x400 pics so the aspect ratio is correct.
  78. 3.   Pressing + will increase the resolution for VGA (320x200 to 640x480, etc).
  79. 4.   Pressing - will decrease the resolution for VGA; useful if 800x600 rolls.
  80. Presently, the following commands work only with EGA (or VGA with the /E option).
  81. at this time. Some will be implemented in later versions.
  82. 5. * Pressing Z will create a ZSoft (PC Paintbrush) file with the same filename
  83.      and extension PCX. The file will be a 640x350 paint file of what is
  84.      currently on the screen.
  85. 6. * Pressing G or I will create a GIF file with the same filename and extension
  86.      GIF; G is for non-interlaced, and I is for interlaced files. The GIF file
  87.      will be the same size as the current image.
  88. 7. * Pressing R will create a RIX (EGA Paint) file with the same filename and
  89.      extension SCR (or SCP if a long pic and L pressed first).
  90. 8. * Pressing H will create a Dr. Halo pic file with the same filename and
  91.      extension PIC. The file will be a 640x350 paint file of what is currently
  92.      on the screen. A palette file will be created.
  93. 9. * Pressing C will create a Dr. Halo cut file with the same filename and
  94.      extension CUT. The pic will be the same size as the GIF file is currently
  95.      on the screen. A palette file will be created.
  96. 10.  Pressing enter will return to menu or DOS, or show next file for marked
  97.      menu mode.
  98. 11.  Pressing ESCape will end the display and return to the menu.
  99. 12.* Pressing L before pressing Z, P, R, C or H will save the picture to that
  100.      file type from the top of the current screen to the end of the
  101.      picture. Thus, if viewing a 640x480 pic, and you press LP, you will
  102.      create a PC Paint pic file that is a 640x480 image. If you had
  103.      scrolled up 10 lines, it would create a 640x470 image, etc.  Pressing
  104.      S will cancel the L command. For Dr. Halo .PIC files, the L creates a
  105.      640x480 file if the GIF file was between 351 and 480 rows.
  106. 13.  The following keys control the picture tone as follows:
  107.      F1   Decrease red content of picture.
  108.      F2   Increase red content of picture.
  109.      F3   Decrease green content of picture.
  110.      F4   Increase green content of picture.
  111.      F5   Decrease blue content of picture.
  112.      F6   Increase blue content of picture.
  113.      F9   'Keep' current palette; replaces original palette.
  114.      F10  Restore original (or kept) palette.
  115.      V    Reverses the current palette; interesting effect especially for
  116.           black & white images.
  117.  
  118. All other keys are ignored. Pressing Ctrl Break (or Ctrl C) will go to DOS.
  119.  
  120. Small files are saved as 640x350 images so that paint programs will not force
  121. you to a smaller screen size. They can be saved as clippings, and then combined
  122. to produce a composite picture.
  123. ----------------------------------------------------------------------------
  124. SHAREWARE
  125.            
  126. VGIF is user supported software.  VGIF for the IBM  PC is made available for a
  127. free ten day trial period.  If you find this program useful,  you may license
  128. the  program for non-commercial use on one machine by sending $10.00 to:
  129.  
  130.      Bob Montgomery
  131.      123 Parsons Road
  132.      Longwood, Fl 32779
  133.  
  134. VGIF may be licensed for commercial use on up to 10 computers at a single site
  135. or set of contiguous sites for $50.00. A commercial site is defined as a
  136. business or individual seeking to make a profit by selling VGIF or incorporating
  137. this program in another program.
  138.  
  139. Clubs, schools,  universities and other organizations may license VGIF for
  140. $30.00 per 6 copies.
  141.  
  142. All other rights are reserved.
  143.  
  144. VGIF may not be changed or modified in any way  except by the author.  VCUT may
  145. be freely distributed for the ten day trial period as long as it remains in its
  146. complete form.  Regardless of how the  copy is  obtained, it is requested that
  147. all users comply with the licensing agreement.
  148.  
  149. All licensing registrations will  be promptly  acknowledged.  All licensees
  150. will  receive prompt  notification of product revisions and will be able to
  151. purchase updates at a nominal fee.
  152.  
  153. All  warranties  are  disclaimed,  including  damage  to hardware and/or
  154. software from use of this product.
  155.  
  156. Any suggestions or comments can be mailed directly to me, or left on
  157. the following BBS's:
  158. Compuserve
  159. Tsunami BBS, Half Moon Bay, Calif. (415) 726-2726
  160. PC Rockland, S. Nyack, NJ (914) 353-2176 [Freeboard] 300+ Meg Online
  161. -------------------------------------------------------------------------
  162. Revision history:
  163. ver 1.1   1-13-88
  164.           Added test for EGA adapter.
  165.           Fixed menu colors.
  166.           Allow ESCape from marked file viewing.
  167.           Added Ctrl Break (or Ctrl C) exit to DOS anywhere.
  168.           Added 'disk full' notification when creating picture file.
  169.           Added critical error handler for 'drive not ready' errors.
  170. ver 1.2   1-15-88
  171.           Changed name to vgif.
  172.           Slide mode now ignore the end of file mark in slide file, and any key
  173.                will now end slide mode.
  174.           Added slides to menu mode if S pressed-shows marked files as slides
  175.                until a key is pressed.
  176. ver 1.3   1-21-88
  177.           Added better error checking to GIF file decoding. Notifies if bad GIF
  178.                file.
  179.           Fixed error reporting bug in single file mode.
  180. ver 1.4   2-9-88
  181.           Added instantaneous screen update in slide mode from menu or command
  182.                (sld) file.
  183.           Added the /r option which allows an application program to call VGIF 
  184.                to view a file and then regain control.
  185. ver 1.5   3-2-88
  186.           Added Page Up and Page Down keys to scroll by 10 lines at a time.
  187.           Added a max pic height of 819 lines so EGA buffer would not overflow.
  188.           Greatly improved color reproduction for 'problem' pictures (such as
  189.               FROG, ARCHIT, PUFFIN, VEGTABLE, etc). These pictures typically
  190.               have more than 16 colors. Selected colors on basis of frequency
  191.               of use where possible.
  192.           Fixed following bugs:
  193.           1.  Line buffer would overflow into other variables if pic width
  194.               was > 640 pixels, causing strange results.
  195.           2.  Didn't recognize the end of image marker correctly. This would
  196.               cause the palette to change when the image was done.
  197. ver 1.6   3-11-88
  198.           Fixed a bug in handling multiple images. First noticed when viewing
  199.                WHIMMI.GIF.
  200.           Use same palette for multiple images, and get best color match.
  201.           Added L and S commands while viewing a picture. These allow you to
  202.                create full size paint program files.
  203.  
  204. ver 2.0   3-26-88
  205.           Added the ability to view long GIF files ( > 819 lines) without
  206.                wrapping the display.
  207.           Added the C and H (Dr. Halo) file creation option while viewing.
  208.           Added the L and S prefixes to paint program file creation commands
  209.                while viewing to save long pic files.
  210.           Added the Info and Help commands in menu mode.
  211.           Deleted the # requirement to specify a directory from the command
  212.                line. The program now looks for a directory which meets the
  213.                spec on the command line. If none is found, it assumes the spec
  214.                is for a single file.
  215.           Added F1 - F10, and V palette control keys while viewing a file.
  216.  
  217. ver 3.0   5-2-88
  218.           Added VGA capability, and support for Tseng extended VGA modes
  219.                (640x480x256 and 800x600x256).
  220.           Determines and displays available modes for your system.
  221.  
  222. ver 3.1   5-11-88
  223.           Fixed a bug in dir/file spec from command line. Now accepts
  224.                vgif d:\dir\*.gif or vgif d:*.gif, although the [\]*.gif is not
  225.                required, since this is the default filespec.
  226.           Fixed a bug in forced EGA when doing slides, where an interlaced pic
  227.                displayed at double size would have a 'venetian blind' effect.
  228.           Changed so pics larger than 320x200 are shown in 640x480 VGA; can get
  229.                800x600 by pressing + key.
  230.           Note that EGA mode on the Orchid VGA card appears squashed
  231.                vertically. This is normal, and cannot be corrected without
  232.                reprograming the parameters for mode 16, which would change
  233.                the vertical retrace frequeny, and probably cause your monitor
  234.                to roll.
  235.  
  236. ver 3.2   5-26-88
  237.           Added 500 file menu, and assy language text screen updating; now
  238.                super fast.
  239.           Fixed a bug which caused the Vega VGA card to hang up.
  240.