NAME
gifcompose - The gifcompose program uses the GIFLIB utility tools to
support a minilanguage for describing GIF pasteup sequences.
USAGE
gifcompose [-v] <specfile
Specification Syntax
The gifcompose tool takes a series of text lines and interprets them as
commands to do pasteup operations. The commands are:
Generators
gif <name>
Paste in <name>.gif
raw <name> <width> <height>
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.
rgb <name> <width> <height>
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.
rle <name>
Paste in the given RLE-format file (no suffix supplied). This
converts the Utah Raster Kit format to GIF.
text <text> [foreground <index>] [color <r> <g> <b>]
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 suffixes:
Modifiers
at <x> <y>
Place the image at the given (upper-left-hand-corner)
coordinates in the pasted-up result.
clip <name> <top-x> <top-y> <bottom-x> <bottom-y>
Clip image using the given rectange, paste it onto.
xflip Flip the image around the X axis before placing it.
yflip Flip the image around the Y axis before placing it.
left Rotate the image 90 degrees counterclockwise before placing it.
right Rotate the image 90 degrees clockwise before placing it.
Target Operations
screen size <x-size> <y-size>
Set the global screen size of the final image.
screen position <x> <y>
Set the global screen position of the final image.
Comments
Comments or comment lines may be preceded with ‘#’ and will be ignored.
MEMORY REQUIRED
Proportional to the size of the largest pasted image.
OPTIONS
[-v]
Emit a report on each composition action to stderr as it
happens.
BUGS
The suffix sequence ‘left left’ sometimes mysteriously fails to work,
probably due to some restriction in <a href="gifflip.html">gifflip
No support for resizing or odd-angle rotations yet.
The ‘color’ suffix of text is a no-op, because the present version of
<a href="gifovly.html">gifovly
Error checking is rudimentary.
AUTHOR
Eric S. Raymond <esr@snark.thyrsus.com>
Man page created by T.Gridel <tgridel@free.fr>, originally written by
Eric S. Raymond <esr@thyrsus.com>
giflib-tools gifcompose(1)