home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 3 / AUCD3.iso / airport / utils / intergif5 / !InterGif / !Help < prev    next >
Text File  |  1997-02-07  |  7KB  |  185 lines
  1.  
  2.                     InterGif 5.01
  3.                     =============
  4.  
  5.         by Peter Hartley (K) All Rites Reversed
  6.     Desktop front-end adapted from one by Iain Logan
  7.  
  8. INTERGIF 5.01 is a program for making GIF images from 2-, 4-, 16- or
  9. 256-colour RiscOS sprite files, or from Draw files, or from files
  10. produced with Iota Software's (commercial) animation program The
  11. Complete Animator. It can also convert from GIFs back to sprites.
  12.  
  13.  
  14.         Get the latest version
  15.         ----------------------
  16.  
  17. The latest version of InterGif, plus more help information and full
  18. source code, is always available on the World-Wide Web at the address
  19.         http://www.ant.co.uk/~peter/software/intergif.htm
  20. It's the seventh of February, 1997, as I'm writing these words: if
  21. it's long after that that you're reading them, you might want to see
  22. if there's a later version now available.
  23.  
  24.  
  25.         Distribution
  26.         ------------
  27.  
  28. InterGif is NOT COPYRIGHTED and is NOT distributed under the GNU
  29. General Public Licence. For full information read the file
  30. !InterGif.Copying or go to the Web site.
  31.     InterGif is mine: in particular, it doesn't belong to ANT Limited.
  32. If it gets anything wrong, it's my problem, not theirs.
  33.  
  34.  
  35.         Features
  36.         --------
  37.  
  38.   o InterGif runs either on the desktop, or from the command line (so
  39.     I can produce the GIFs for my own Web pages, from the sprites
  40.     which constitute their source, using a make file!).
  41.  
  42.   o InterGif has options for the transparency and interleaving
  43.     features of GIF89a.
  44.  
  45.   o InterGif can take a sprite file (or an Animator file) containing
  46.     several frames, and produce from it an animated GIF which Netscape
  47.     2.0 or later, MSIE 3.0beta1 or later, or ANT Fresco 1.22 or later
  48.     will render as animated if it's inlined in a Web page. The
  49.     animation delay can be set individually for each frame, or for the
  50.     whole animation.
  51.  
  52.   o InterGif will reduce its input to a smaller number of colours
  53.     (unless you explicitly tell it not to) if it can get away with it,
  54.     i.e. if only that many of the colours are used anyway.
  55.     
  56.   o It will also compress only the rectangle which has changed on each
  57.     frame, so if your animation has a complex but stationary
  58.     background, the background will only get compressed once.
  59.     Deviousness and cunning are employed to minimise the final size of
  60.     the GIF: so much so that many animated GIFs I've found on the Web
  61.     have ended up smaller when run through InterGif.
  62.  
  63.   o It can also make GIF images from Draw files. It uses, for this,
  64.     the same code that is in my AADraw program (see end), which means
  65.     it produces GIFs or sprites with a 216-colour cube palette (as
  66.     used on Macintoshes and by Netscape and MSIE for Windows), *not*
  67.     the standard Acorn 256-colour palette. (For AADraw connoisseurs,
  68.     I'll add that you don't get the -b feature of that program:
  69.     InterGif always anti-aliases to white.)
  70.     
  71.  
  72.         Desktop use
  73.         -----------
  74.  
  75. Pretty straightforward. Run !InterGif; drag your sprite file, Animator
  76. file, or GIF onto the left-hand bit of the window; set any options you
  77. want in the middle bit of the window; and save your GIF or sprite file
  78. out from the right-hand bit of the window. The options are:
  79.  
  80.   o Interlaced
  81.         Produce an interlaced GIF: in other words, one which a Web
  82.     browser can render quickly at a low resolution, filling in the
  83.     details later as they arrive.
  84.  
  85.   o Looping animation
  86.         Normally an animated GIF plays through once and stops. If you
  87.     tick this option, you'll get an animated GIF that plays over and
  88.     over again. This is a Netscape extension to the GIF format, but
  89.     hopefully it will become a popular one -- both MSIE and Fresco now
  90.     support it too.
  91.  
  92.   o Join input files
  93.         This option causes InterGif to look for only one frame in the
  94.     file you give it, and then look for the next frame in another file
  95.     with the numeric part of the file incremented. For instance, you
  96.     could have three files called frame000, frame001, and frame002 and
  97.     create an three-frame animation by dragging frame000 onto the
  98.     InterGif window and choosing "Join input files".
  99.  
  100.   o Frame delay
  101.         This lets you set the frame rate, in centiseconds. The default
  102.     is 8 centiseconds per frame (12.5 frames per second). You can
  103.     change frame delays individually in Animator files in the usual
  104.     way (in Animator, press F7) or in sprite files by giving the
  105.     frames sprite names with "delay" in them: for instance, a sprite
  106.     called "037delay25" will be given a delay of 25 centiseconds.
  107.     (Anything before the word "delay" is ignored.)
  108.  
  109.   o Transparency
  110.         Choose None to get a wholly opaque GIF (no masking), Auto to
  111.     get InterGif to use the sprites' masks (or the film's background
  112.     colour); or you can specify a transparent pixel-value directly.
  113.     (Hint: to find out what pixel-value a sprite pixel has, load the
  114.     sprite into Paint, ensure its palette window is showing, click
  115.     Menu over the pixel you want, and choose "Paint->Select colour".)
  116.     
  117.   o Split output
  118.         This splits up the input file into one output file per frame.
  119.     Not, I admit, terribly useful, unless you need to import something
  120.     into an application that expects lots of one-frame GIFs -- for
  121.     instance, Sun's Java Animator applet. The names of the files are
  122.     taken from the one you give, with any numeric part incremented as
  123.     needed, so if you save a three-frame animation as frame001/gif,
  124.     you also get frame002/gif and frame003/gif.
  125.     
  126.   o Web site
  127.         Clicking on this button takes you to my Web pages on ANT
  128.     Limited's server, as described above. For this to work, you need
  129.     to be connected to the Internet, and also have a Web browser
  130.     loaded which understands ANT's URL broadcast message -- for
  131.     example, Fresco or ArcWeb. (Probably the others too, these days.)
  132.  
  133.  
  134.         Command-line use
  135.         ----------------
  136.         
  137. The !Boot file of !InterGif sets up Alias$intergif, so you no longer
  138. need to copy the intergif file into your library directory.
  139.     At its simplest, you can just type intergif and the name of your
  140. sprite or film file, and it'll be converted. Here's a full list of the
  141. options:
  142.  
  143. intergif [-i] [-loop] [-s ] [-split] [-d cs] [-t [pixel]]
  144.          [-o outfile] infile
  145.  
  146.     -i
  147.         Produce an interlaced GIF
  148.     -loop
  149.         Looping animation
  150.     -s
  151.         Produce a sprite rather than a GIF
  152.     -join
  153.         Join several input files
  154.     -split
  155.         One frame per file
  156.     -d cs
  157.         Frame delay in centiseconds
  158.     -t
  159.         Use automatic transparency (default is no transparency)
  160.     -t pixel
  161.         Use specified pixel as transparent
  162.     -o outfile
  163.         Filename for the output (default is <infile>/gif)
  164.     infile
  165.         A RiscOS sprite, Draw, Complete Animator or GIF file
  166.  
  167.  
  168.         See also
  169.         --------
  170.  
  171.     The InterGif page
  172.         http://www.ant.co.uk/~peter/software/intergif.htm
  173.     The AADraw page
  174.         http://www.ant.co.uk/~peter/software/aadraw.htm
  175.     The Complete Animator
  176.         http://www.iota.co.uk/animator/
  177.     GIF89a specification
  178.         http://asterix.seas.upenn.edu/~mayer/lzw_gif/gif89a.html
  179.     Animated GIFs for other platforms
  180.         http://www.n-vision.com/panda/gifanim/
  181.         
  182.  
  183.                                                         peter@ant.co.uk
  184.                                                         7th February 97
  185.