gifcompose - a GIF compositor

gifcompose [-v] <specfile

The gifcompose tool takes a series of text lines and interprets them as commands to do pasteup operations. Text directives may be generators, modifiers, target operations and comments.

Paste in <name>.gif Paste in the given raw-format file (no suffix supplied). Raw format is a stream of 8-bit indices into the EGA color map. Accordingly, the width and height must be specified, and the source must be exactly width times height bytes long. Paste in the given RGB-format file (no suffix supplied). Raw format is a stream of 24-bit color values. Accordingly, the width and height must be specified, and the source must be exactly 3 times width times height bytes long. Paste in the given RLE-format file (no suffix supplied). This converts the Utah Raster Kit format to GIF. Copy 8x8 monospace font, with transparent background and index 1 as foreground. If the text string contains whitespaces, they must be escaped or the string must be quoted (shell conventions). The optional suffix `foreground <n>' sets the foreground color index. The optional suffix `color <r> <g> <b>' sets the RGB color to be used for the foreground index.

Each generator operation may be followed by any combination of the following modifiers.

Place the image at the given (upper-left-hand-corner) coordinates in the pasted-up result. Clip image using the given rectange, paste it onto. Flip the image around the X axis before placing it. Flip the image around the Y axis before placing it. Rotate the image 90 degrees counterclockwise before placing it. Rotate the image 90 degrees clockwise before placing it.

Set the global screen size of the final image. Set the global screen position of the final image.

Comments or comment lines may be preceded with `#' and will be ignored.

Emit a report on each composition action to stderr as it happens.

Valid screen operations are: size & position. Allowed operators are: at, clip, xflip, yflip, left & right.

Work Directory. Work Files.

The GIFLIB distribution is Copyright (c) 1997 Eric S. Raymond

Memory required is proportional to the size of the largest pasted image.

The suffix sequence `left left' sometimes mysteriously fails to work, probably due to some restriction in gifflip.

No support for resizing or odd-angle rotations yet.

The `color' suffix of text is a no-op, because the present version of gifovly throws away color tables.

Error checking is rudimentary.

gif2bgi(1), gif2epsn(1), gif2herc(1), gif2iris(1), gif2ps(1), gif2rgb(1), gif2rle(1), gif2x11(1), gifasm(1), gifbg(1), gifburst(1), gifclip(1), gifclrmp(1), gifcolor(1), gifcomb(1), giffiltr(1), giffix(1), gifflip(1), gifhisto(1), gifinter(1), gifinto(1), gifovly(1), gifpos(1), gifrotat(1), gifrsize(1), gifspnge(1), giftext(1), gifwedge(1), icon2gif(1), raw2gif(1), rgb2gif(1), rle2gif(1), text2gif(1)

Eric S. Raymond <esr@snark.thyrsus.com>