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