NWE Help: Graphics: Gifsicle: More Help

NWE Home :: Help :: Graphics :: Gifsicle

We've covered the most commonly used parts of Gifsicle here. But it can do a lot more. You can find out more about gifsicle on the very odd gifsicle web site.

Here is the gifsicle usage statement (you get this if you mess up a gifsicle command).

`Gifsicle' manipulates GIF images. Its most common uses include combining
single images into animations, adding transparency, optimizing animations for
space, and printing information about GIFs.

Usage: gifsicle [OPTION | FILE | FRAME]...

Mode options: at most one, before any filenames.
  -m, --merge                   Merge mode: combine inputs, write stdout.
  -b, --batch                   Batch mode: modify inputs, write back to
                                same filenames.
  -e, --explode                 Explode mode: write N files for each input,
                                one per frame, to `input.frame-number'.
  -E, --explode-by-name         Explode mode, but write `input.name'.

General options: Also --no-OPTION for info and verbose.
  -I, --info                    Print info about input GIFs. Two -I's means
                                normal output is not suppressed.
      --color-info, --cinfo     --info plus colormap details.
      --extension-info, --xinfo --info plus extension details.
  -v, --verbose                 Prints progress information.
  -h, --help                    Print this message and exit.
      --version                 Print version number and exit.
  -o, --output FILE             Write output to FILE.
  -w, --no-warnings             Don't report warnings.

Frame selections:               #num, #num1-num2, #num1-, #name

Frame change options:
  --delete FRAMES               Delete FRAMES from input.
  --insert-before FRAME GIFS    Insert GIFS before FRAMES in input.
  --append GIFS                 Append GIFS to input.
  --replace FRAMES GIFS         Replace FRAMES with GIFS in input.
  --done                        Done with frame changes.

Image options: Also --no-OPTION and --same-OPTION.
  -B, --background COL          Makes COL the background color.
      --crop X,Y+WxH, --crop X,Y-X2,Y2
                                Crops the image.
      --flip-horizontal, --flip-vertical
                                Flips the image.
  -i, --interlace               Turns on interlacing.
  -S, --logical-screen WxH      Sets logical screen to WxH.
  -p, --position X,Y            Sets frame position to (X,Y).
      --rotate-90, --rotate-180, --rotate-270, --no-rotate
                                Rotates the image.
  -t, --transparent COL         Makes COL transparent.

Extension options: Also --no-OPTION and --same-OPTION.
  -x, --app-extension N D       Adds an app extension named N with data D.
  -c, --comment TEXT            Adds a comment before the next frame.
      --extension N D           Adds an extension number N with data D.
  -n, --name TEXT               Sets next frame's name.

Animation options: Also --no-OPTION and --same-OPTION.
  -d, --delay TIME              Sets frame delay to TIME (in 1/100sec).
  -D, --disposal METHOD         Sets frame disposal to METHOD.
  -l, --loopcount[=N]           Sets loop extension to N (default forever).
  -O, -optimize[=LEV]           Optimize output GIFs.
  -U, --unoptimize              Unoptimize input GIFs.

Whole-GIF options: Also --no-OPTION.
      --change-color COL1 COL2  Changes COL1 to COL2 throughout.
  -k, --colors N                Reduces the number of colors to N.
      --color-method METHOD     Set method for choosing reduced colors.
  -f, --dither                  Dither image after changing colormap.
      --resize WxH              Resizes the output GIF to WxH.
      --scale XFACTOR[xYFACTOR] Scales the output GIF by XFACTORxYFACTOR.
      --transform-colormap CMD  Transform each output colormap by shell CMD.
      --use-colormap CMAP       Set output GIF's colormap to CMAP, which can
                                be `web', `gray', `bw', or a GIF file.

Report bugs to <eddietwo@lcs.mit.edu>.
Too much information? Try `gifsicle --help | more'.