home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR5 / DESKGIF.ZIP / GIFDESK.DOC next >
Text File  |  1992-11-21  |  11KB  |  220 lines
  1.           GIFDESK.DOC - some notes on GIFDESK.EXE 4.3
  2.  (released November, 1992 - 24th anniversary of "The Beatles" aka White Album)
  3.  
  4. GIFDESK is a utility to view many of your GIFs at one time on a VGA system.
  5. Examples of how to use GIFDESK:
  6.     GIFDESK *.gif
  7.     GIFDESK f:\pics\s*.gif p*.gif
  8.  
  9. Run GIFDESK alone to get a quick-reference to it's usage.
  10.  
  11. Remember, you need at least a VGA to use GIFDESK!  All of the Super VGA
  12. modes require at least 512k video memory. If you have only 256k, you
  13. may need to override the autodetect by setting GIFDESK=VGA at DOS prompt.
  14. ------------------------------------------------------------------------------
  15. NEW THIS VERSION:
  16.     - HiColor Support. Really makes improvement.
  17.       will use 640x480x32k and 800x600x32k from VESA driver.
  18.       (These are modes 0x110 and 0x113 on the Speedstar 24x VESA driver)
  19. ------------------------------------------------------------------------------
  20. Display:  GIFs are displayed by GIFDESK in several arrangements.  The
  21. maximum number of GIFs shown at one time is 80 (if you have a 1024x768
  22. mode on your SVGA).  GIFDESK can also show 1 GIF at a time (in color if
  23. you have a hi-res 256 color mode on your SVGA).  The display layout can
  24. be changed by hitting the SPACEBAR.  This will cycle through the various
  25. GIF arrangements.  Also, the F1,F2,F3 and F4 keys will switch directly
  26. to a particular layout.  (Notice that F1=1x1, F2=2x2, etc).  If you are
  27. using an SVGA that supports an 640x480, 800x600 and/or 1024x768 mode you
  28. can switch to a higher resolution using the + key.  Switch to lower
  29. resolution with the - key.  The following table lists the various
  30. configurations:
  31.  
  32. Video Mode                              GIF Arrangemant
  33.               F1 Key         F2 Key       F3 Key       F4 Key
  34. ------------------    -------------  -----------  -----------  ------------
  35. 640x480x16            1x1 16-Grey    2x2 16-Grey  3x3 16-Grey  6x5  16-Grey
  36. 640x480x256 (SVGA)    1x1 256/64     2x2 256/64   3x3 256/64   6x5  256/64
  37. 640x480x32k (SVGA)    1x1 32k        2x2 32k      3x3 32k      6x5  32k
  38. 800x600x16  (SVGA)    1x1 256/64     2x2 256/64   4x4 256/64   8x6  256/64
  39. 800x600x256 (SVGA)    1x1 256/64     2x2 256/64   4x4 256/64   8x6  256/64
  40. 800x600x32k (SVGA)    1x1 32k        2x2 32k      4x4 32k      8x6  32k
  41. 1024x768x16 (SVGA)    1x1 256/64     2x2 256/64   5x5 256/64   10x8 256/64
  42. 1024x768x256(SVGA)    1x1 256/64     2x2 256/64   5x5 256/64   10x8 256/64
  43.  
  44. (256/64 is 256 colour or 64 grey - toggle between these with F10)
  45.  
  46. Notes:
  47.     1) GIFDESK should be able to handle GIF's up to 4096x4096 in size.
  48.     2) Writing a GIF file (via . key) may take a while.  As it is being
  49.        done, a white dot will scan the screen for top to bottom.  At
  50.        completion, a two tone sound will occur if successful.
  51.     3) Printing a screen (via F9 key) may take a while. At completion
  52.        a tone will occur.
  53.  
  54. Super VGA's:
  55. If you have a super VGA that supports 640x480x256 or better (you need 512K),
  56. GIFDESK should use the appropriate driver for your card.  The signon screen
  57. lists the type of card that GIFDESK detected.  If this is incorrect, you can
  58. override this autoselection with the environment variable GIFDESK. Set the
  59. environment variable GIFDESK to the correct card name according to the following
  60. table:
  61.  
  62.   Card(s)                          GIFDESK Environment Variable
  63.   =====================================================================
  64.   ATI VGA Wonder                   ATI
  65.   ---------------------------------------------------------------------
  66.   Chips & Technologies, Cardinal   C&T
  67.   Boca Research 1024 VGA
  68.   ---------------------------------------------------------------------
  69.   Everex Viewpoint                 EVEREX
  70.   ---------------------------------------------------------------------
  71.   Paradise, AST, Compaq, Dell      PARADISE
  72.   Western Digital
  73.   ---------------------------------------------------------------------
  74.   Tseng, Genoa, STB, Orchid        TSENG
  75.   Quadram, Sota, Willow
  76.   ---------------------------------------------------------------------
  77.   Trident, Logix, ZyMOS            TRIDENT
  78.   TrueTech
  79.   ---------------------------------------------------------------------
  80.   Video 7, Headland                VIDEO7
  81.   ---------------------------------------------------------------------
  82.   Generic VGA                      VGA
  83.   ---------------------------------------------------------------------
  84.   Tseng 4000, Sigma                TSENG4K
  85.   ---------------------------------------------------------------------
  86.   Genoa 6400/6600                  GENOA
  87.   ---------------------------------------------------------------------
  88.   V.E.S.A Driver                   VESA
  89.   ---------------------------------------------------------------------
  90.   Ahead Wizard Deluxe              AHEADB (older cards AHEADA)
  91.   ---------------------------------------------------------------------
  92.   Tecmar ADGM                      TECMAR (no auto-detect)
  93.   ---------------------------------------------------------------------
  94.   Trident 8900                     TRIDENT89 (no auto-detect)
  95.   ---------------------------------------------------------------------
  96.   Disk File image GIFDESK.DAT      FILE (no auto-detect)
  97.  
  98. Example:
  99.     If you have an AST VGA card (with 512k!) use the following command:
  100.     c:>SET GIFDESK=PARADISE
  101.  
  102. Notes: 1) The startup screen will notify you of the driver GIFDESK is using.
  103.       (the drivers are built into GIFDESK)
  104.        2) Several of the SVGA cards have not been tested...comments???
  105.       (Everex, Dell, Tecmar)
  106.  
  107.  
  108. Keys in GIFDESK:
  109.    "PgDn/PgUp" . .Next/Previous screen
  110.    "Esc" . . . . .Exit to DOS
  111.    "Space" . . . .Toggle Resolution (2x2->1x1->6x5->3x3->2x2...)
  112.    "Tab" . . . . .Skip to Next Pic
  113.    "." . . . . . .Write screen to GIF file
  114.    "Home". . . . .Go to first screen
  115.    "End" . . . . .Go to last screen
  116.    "+" . . . . . .Increase Resolution (SVGA only) (640x480->800x600->1024x768)
  117.    "-" . . . . . .Decrease Resolution (SVGA only) (1024x768->800x600->640x480)
  118.    "F9". . . . . .Print to LaserJet on LPT1
  119.    "F10. . . . . .Toggle between grey and colour mode (SVGA only)
  120.    "F1,F2,F3,F4. .Change directly to 1x1,2x2 etc.
  121.    any other . . .Skip to GIF file with name starting with character
  122.  
  123. Examples:
  124.    Key    Result
  125.    ===    ===========================================
  126.     .     Writes GIF file (named GIFDSKnn.GIF)
  127.     c     Skips to first GIF file starting with c (e.g. CHEAPSEX.GIF)
  128.     7       "   "    "    "   "      "      "   7 (e.g. 7HEAVEN.GIF)
  129.    end    Displays last set of GIF's (e.g ZAGNUT.GIF, ZIGGY.GIF, ...)
  130.    esc    Exit the wonderful world of GIFDESK
  131.  
  132. -------------------------------------------------------------------------------
  133. COMMAND FILE:
  134.     If the file GIFDESK.CMD is present in the current directory,
  135.     GIFDESK will read its commands from it. The file contains ASCII
  136.     commands that tell GIFDESK what to do next. This may be useful
  137.     to someone incorporating GIFDESK into an automatic GIF catalog
  138.     generator for BBS use.
  139.     SAMPLE.CMD contains a sample of a command file, along with a list of
  140.     available commands. To use it:
  141.         1) copy SAMPLE.CMD to GIFDESK.CMD
  142.         2) run GIFDESK... e.g. "GIFDESK *.gif"
  143.         3) watch it happen (its like a slide show)
  144.  
  145. -------------------------------------------------------------------------------
  146. FILE DRIVER:
  147.     This driver is activated by setting GIFDESK=FILE. No graphics
  148.     card is necessary; pixel operations are simulated by reading
  149.     and writing a disk file (GIFDESK.DAT). Printing is not
  150.     supported with this driver. Disk space of 768 kbytes is
  151.     required for the GIFDESK.DAT file. Normal keystrokes or Command
  152.     mode can be used (via the GIFDESK.CMD file, see SAMPLE.CMD).
  153.     Status information is directed to the screen during processing,
  154.     and can be redirected at command time:
  155.         C:>GIFDESK *.gif >lpt1
  156.     Note that this driver is slower than real hardware, and certain
  157.     operations (e.g. clearing the screen) may take a few seconds
  158.     and be disk intensive. GIF89a extensions are not supported for
  159.     this driver.
  160. ----------------------------------------------------------------------------
  161. COMMAND LINE OPTIONS:
  162.     -Vcard    forces use of card type video.         e.g. -VTSENG
  163.     -Rres     sets initial arrangement. 1=1x1, etc.  e.g. -R3
  164.     @file     read file names from "file"            e.g. @C:\biglist
  165. ----------------------------------------------------------------------------
  166. HiColor Notes:
  167.     GIF files currently support 8 bits per gun (red,green,blue),
  168.     256 triplets per image. This "palette" works well when displaying 1
  169.     image on a 256 color VGA screen even though VGA only has 6 bits per
  170.     gun. HiColor doesn't have a palette. It allows 32768 different colors
  171.     to be displayed all at once. When displaying one GIF file this isn't
  172.     an improvement as now the limit is 5 bits per gun. But when displaying
  173.     more than one GIF (like GIFDESK does) HiColor provides a great improve-
  174.     ment over normal VGA and Super-VGA. Now each picture can get its entire
  175.     set of colors without having to "share" with other pictures on the
  176.     same screen.
  177.     When you save a GIF file from a HiColor screen you will notice the file
  178.     (when redisplayed) is not up to par with the original screen. This is
  179.     due to the GIF file format limitation of 256 colors per image. Maybe
  180.     I'll add support for a different format save later like TIFF, JPEG,
  181.     or PCX.
  182. ----------------------------------------------------------------------------
  183.  
  184. Version History:
  185.     1.0 - Initial release, worked...kinda slow...
  186.     1.1 - Faster.
  187.       Allows keys during GIF decode.
  188.       Shows resolution even in 6x5 format.
  189.     2.0 - Super VGA support, promo screen, 1x1,2x2 format, better sizing!,
  190.       Writes GIF's!, 1st character key->filename, much more!
  191.     3.0 - Autodetect of SVGA.  Colour-colour-colour!!! (on SVGA, GIFDESK now
  192.       shows GIFs in colour in all modes.  Can still force to grey with
  193.       F10).  Fixed 640x480x256 for C&T, Paradise, Trident, & Video 7.
  194.     3.1 - Some intermediate beta releases
  195.     3.2 - Tseng 4000 support, clear screen routine changed, vertical
  196.       interrupt detection modified.
  197.     3.2a- GIF89a support, bank 0 preset fix for certain TSENG based
  198.       cards.
  199.     4.0 - Rewritten video drivers. Printing to LaserJet. VESA, Genoa,
  200.       Ahead, Tecmar, Trident 8900 added. Command file support. 16
  201.       color palette bug fix. FILE driver. More than 256 files quick
  202.       key bug fix. Better color selection per picture. Better
  203.       alphabetic file sorting. Full GIF89a support added.
  204.     4.1 - Fix of bug in file name generation after saving 10 GIF files.
  205.       Fix of bug in palette fix after lots of files displayed.
  206.       Fix of bug of lost error message upon exit.
  207.     4.2 - Addition of command line options (-V, -R, and @file). Addition of
  208.       several script commands.
  209.     4.3 - Addition of HiColor (32k) via VESA support. Tested on Diamond
  210.       Speedstar 24X card. Fixed minor printing bug.
  211.  
  212. GIF is a trademark of CompuServe Inc.
  213.  
  214. Have comments, suggestions, fan mail, hate mail, GIF pictures?
  215.     Jay Wherley
  216.     2291 Grand Teton Blvd.
  217.     Melbourne, FL 32935
  218.     (407) 242-5296 9-5 M-F
  219.  
  220. Finally, GIFDESK Was free, Is free, Always free.