home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 4: Phase Four / 17Bit_Phase_Four.iso / files / 3328.dms / 3328.adf / Docs / ShowGIF.Docs
Text File  |  1993-10-02  |  6KB  |  196 lines
  1.  
  2.                                ShowGIF V1.01
  3.                       (C) 1993 by Christophe PASSUELLO
  4.                       --------------------------------
  5.  
  6.     ShowGIF is a GIF viewer, it takes advantage of the new AGA chipset, it
  7.     allows scrolling, it support wild-card and Workench. It's always the
  8.     FASTEST GIF viewer on Amiga.
  9.  
  10.     ShowGIF can't be sold alone or in any package, but you can freely
  11.     distribuate it on PD's disks (like Fred Fish one) or on any BBS only if
  12.     complete and unmodified.
  13.  
  14.  
  15. DISCLAIMER
  16. ----------
  17.  
  18.   The author isn't responsable of any damages resulting of ShowGIF use.
  19.  
  20.  
  21. REQUIREMENTS
  22. ------------
  23.  
  24.   Before starting ShowGIF, you must be sure to have the Arp.library in your
  25.   LIBS: directory.
  26.  
  27.  
  28. PRESENTATION
  29. ------------
  30.  
  31.   ShowGIF displays pictures with more than 32 colors using gray-scale, and
  32.   using color if the picture don't have move than 32 colors. If you own a new
  33.   Amiga with AGA chipset (A1200 & A4000), display will use colors even with a
  34.   256 colors picture.
  35.  
  36.     With ShowGIF you can't specify contrast and brightness for gray-scaled
  37.   pictures, to do this check out for FastGIF II my GIF viewer with an user
  38.   interface (Saving to IFF with registered version).
  39.  
  40.   There is still some little problems with AGA chipset: when you use hires
  41.   switch during display the image may looks strange, these little problems
  42.   will be fixed as soon as i will receive docs about the new libraries of
  43.   WorkBench 3.0.
  44.  
  45.  
  46. FEATURES
  47. --------
  48.  
  49.   - Can be run from WorkBench or CLI.
  50.  
  51.   - Automaticly adjust screen size regarding picture size.
  52.  
  53.   - Very fast, mains routines are written using very highly optimised assembler
  54.     (twice faster than TurboGIF).
  55.  
  56.   - It should be even faster with 32 bits cards because the assembly routines
  57.     are small enough to fit in the cache. (I suggest you to set on the cache
  58.     instruction using CPU or SetCPU).
  59.  
  60.   - It displays GIF89a files.
  61.  
  62.   - It works on NTSC or PAL.
  63.  
  64.   - You can scroll picture.
  65.  
  66.   - It handles corrupted GIF files.
  67.  
  68.   - Completly multitasking.
  69.  
  70.   - Multiple wild-card for slide-show.
  71.  
  72.   - ShowGif is pure
  73.  
  74.  
  75.  
  76. RUNNING ShowGIF WITH CLI
  77. ------------------------
  78.  
  79.   ShowGif is now pure so you can, you can make it resident.
  80.  
  81.   Usage: ShowGIF <Patterns> [-aga] [-low] [-all] [-agif]
  82.  
  83.     You can specify more than one pattern in the command line.
  84.       Example: ShowGIF df0:*.gif dh0:GIFPictures/* GIF:A*
  85.     
  86.     -low      : This can you help when you are low on memory, with this option
  87.                 you can display a 640*512 picture with 512 KB CHIP and 512 KB
  88.                 FAST. (May slow down decompression).
  89.  
  90.     -aga      : Set this flag if you have a new Amiga with AGA chipset.
  91.  
  92.     -all      : With this flag, ShowGIF will scan recursivly all directories
  93.                 from the specified directory.
  94.  
  95.     -agif     : Set this flag if the GIF pictures come from Amiga. It is used
  96.                 to do a better guess of picture ratio.
  97.  
  98.    ShowGIF will display pictures one after each other, you can stop ShowGIF
  99.    with a CTRL/C.
  100.  
  101.  
  102. RUNNING ShowGIF WITH WORKBENCH
  103. ------------------------------
  104.  
  105.    Click on the icons of disks, drawers and files to view while holding down
  106.    the SHIFT key, and double-click on the ShowGIF icon.
  107.  
  108.    You can set the following Tools Types (With Info item of WorkBench menu).
  109.  
  110.     LOWMEM=ON   : This can you help when you are low on memory, with this
  111.                   option you can display a 640*512 picture with 512 KB CHIP
  112.                   and 512 KB FAST. (May slow down decompression).
  113.  
  114.     CHIPAGA=ON  : Set this flag if you have a new Amiga with AGA chipset.
  115.  
  116.     ALL=ON      : With this flag, ShowGIF will scan recursivly all directories
  117.                   from the specified directory.
  118.  
  119.     AMIGAGIF=ON : Set this flag if the GIF pictures come from Amiga. It is
  120.                   used to do a better guess of picture ratio.
  121.  
  122.    ShowGIF will display pictures one after each other, you can stop ShowGIF
  123.    with a CTRL/C.
  124.  
  125.  
  126. ONCE RUNNING
  127. ------------
  128.  
  129.    Once ShowGIF displays the picture, you can use the following keys:
  130.  
  131.      L      : switch Interlace
  132.      H      : switch Hires
  133.      O      : switch Overscan
  134.      ESC    : close the screen
  135.  
  136.     To scroll picture use cursor keys, with SHIFT scrolling will use 16 pixels
  137.     step, with ALT you to go to border of the screen. Click on right mouse
  138.     button to close the screen.
  139.  
  140.  
  141. TO DO
  142. -----
  143.  
  144.   - Double buffering ?
  145.  
  146.  
  147. AUTHOR
  148. ------
  149.  
  150.    Send me any suggestion, bugs-report, flames, donations, etc....
  151.    I'am looking for docs about the graphics.library to use 24 bits palette,
  152.    to look for avaible display mode (sources, examples, includes and LVOs),
  153.    to improve this viewer.
  154.    I'm looking also for docs about PCX, PIC and BMP or other format to write a
  155.    multi-format viewer.
  156.  
  157.    For bugs-report send informations about your config:
  158.    ShowGIF version, witch processor, version of Workbench, how many RAM you
  159.    own (CHIP & FAST), ...
  160.  
  161.  
  162.    You can contact me at the following address:
  163.  
  164.         Christophe PASSUELLO
  165.         25, Rue du Plateau
  166.         91600 SAVIGNY SUR ORGE
  167.         FRANCE
  168.  
  169.  
  170.  
  171. CREDITS
  172. -------
  173.  
  174.   * ShowGIF use the great Arp.library for pattern matching.
  175.   * GIF Format is Copyright (c) CompuServe Incorporated.
  176.   * Thanks to Thierry Andeol and Arto Ikola for beta-testing and suggestions.
  177.  
  178.  
  179. HISTORY
  180. -------
  181.  
  182.  - RELEASE V1.00
  183.  
  184.       First release.
  185.  
  186.  
  187.  - RELEASE V1.01    (Jun 21 1993)
  188.  
  189.       ShowGif is now pure.
  190.       Best AGA support (64 bits aligned bitmap width, 24 bits palette).
  191.       AppIcon for workbench 2.x
  192.       Small bugs fixed.
  193.  
  194.  
  195.                 ---------- Enjoy GIF on Amiga ---------- 
  196.