home *** CD-ROM | disk | FTP | other *** search
/ Amiga ACS 1998 #4 / amigaacscoverdisc1998-041998.iso / utilities / shareware / graphics / whirlgif / doc / whirlgif.doc < prev    next >
Encoding:
Text File  |  1996-11-01  |  2.5 KB  |  81 lines
  1. WhirlGIF 2.01
  2.  
  3. whirlgif is a quick program that reads a series of GIF files, and produces
  4. a single gif file composed of those images.
  5.  
  6. Usage:
  7.     whirlgif [-v] [-trans index ] [-time delay] [-o outfile]
  8.          [-loop] [-i incfile] file1 [ -time delay] file2
  9.  
  10. options:
  11.         -v           verbose mode    
  12.         -loop [count]    add the Netscape 'loop' extension.
  13.         -time delay    inter-frame timing.
  14.         -disp [method]    Set disposal method, see below
  15.         -trans index    set the colormap index 'index' to be transparent
  16.         -o outfile    write the results to 'outfile'
  17.         -i incfile    read a list of names from 'incfile'
  18.  
  19. TIPS
  20.  
  21. If you don't specify an output file, the GIF will be sent to stdout. This is
  22. a good thing if you're using this in a CGI script, a very bad thing if you
  23. run this from a terminal and forget to redirect stdout.
  24.  
  25. The output file (if any) and -loop _MUST_ be specified before any gif images.
  26.  
  27. You can specify several delay statements on the command line to change
  28. the delay between images in the middle of an animation, e.g.
  29.  
  30.     whirlgif -time 5 a.gif b.gif c.gif -time 100 d.gif -time 5 e.gif f.gif
  31.  
  32. Although it's generally considered to be evil, you can also specify
  33. several transparency statements on the command line, to change the transparent
  34. color in the middle of an animation. This may cause problems for some programs.
  35.  
  36. DISPOSAL METHODS
  37. The disposal method determines how the program displaying the image should
  38. treat the image after it's displayed, before writing the next image.
  39.  
  40. There are currently four possible options:
  41.  
  42.     none    No disposal specified. The default.
  43.     not    Do not dispose. The next image will overlay this one.
  44.     
  45.     back    Restore to background color.  Fill the image's space with
  46.                 the previous background color. May cause flicker.
  47.  
  48.     prev    Restore to previous, restores the data from the previous frame.
  49.  
  50.  
  51.  
  52. BUGS
  53.  
  54.    + should be able to specify delay in an 'incfile' list (see next bug).
  55.  
  56.    + Does not handle filenames starting with a - (hypen), except in 'incfile'.
  57.  
  58.    + Needs better documentation.
  59.  
  60.  
  61. TODO
  62.  
  63.    + Only save colormaps that are different from preceeding ones.
  64.  
  65.    + have an option that compares current image with previous and then
  66.      only save the smallest rectangle that encompasses changes. I need sample
  67.      code- the most efficient algorithms are patented?
  68.  
  69.    + option for luma sorting of colormaps
  70.  
  71.    + define extension block in order to have frame lists.
  72.  
  73. This program is available from http://www.msg.net/utility/whirlgif/
  74.  
  75. --------------------------
  76. Kevin Kadow    kadokev@msg.net
  77.  
  78. Based on 'txtmerge' written by:
  79. Mark Podlipec    podlipec@wellfleet.com
  80.  
  81.