blob: 7e5623238e2f3d9963e44e5790f7f25b2fc5ec47 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
<!doctype HTML public "-//W3O//DTD W3 HTML 2.0//EN">
<HTML>
<HEAD>
<TITLE>gifcompose</TITLE>
<link rev=made href=mailto:esr@snark.thyrsus.com>
</HEAD>
<BODY>
Go to <a href="index.html">index page</a>.
<CENTER><H1>gifcompose</H1></CENTER>
The gifcompose program uses the GIFLIB utility tools to support a minilanguage
for describing GIF pasteup sequences.<P>
<H1>Usage:</H1>
<pre>
gifcompose [-v] <specfile
</pre>
<H1>Specification Syntax</H1>
The gifcompose tool takes a series of text lines and interprets them as
commands to do pasteup operations. The commands are:<P>
<CENTER><H2>Generators</H2></CENTER>
<DL>
<DT><CODE>gif <name></CODE><DD>
Paste in <name>.gif<P>
<DT><CODE>raw <name> <width> <height></CODE><DD>
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.<P>
<DT><CODE>rgb <name> <width> <height></CODE><DD>
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.<P>
<DT><CODE>rle <name></CODE><DD>
Paste in the given RLE-format file (no suffix supplied). This converts
the Utah Raster Kit format to GIF.<P>
<DT><CODE>text <text> [foreground <index>] [color <r> <g> <b>]</CODE><DD>
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).<P>
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.<P>
</DL>
Each generator operation may be followed by any combination of the
following suffixes:
<CENTER><H2>Modifiers</H2></CENTER>
<DT><CODE>at <x> <y></CODE><DD>
Place the image at the given (upper-left-hand-corner) coordinates
in the pasted-up result.<P>
<DT><CODE>clip <name> <top-x> <top-y> <bottom-x> <bottom-y></CODE><DD>
Clip image using the given rectange, paste it onto.<P>
<DT><CODE>xflip</CODE><DD>
Flip the image around the X axis before placing it.<P>
<DT><CODE>yflip</CODE><DD>
Flip the image around the Y axis before placing it.<P>
<DT><CODE>left</CODE><DD>
Rotate the image 90 degrees counterclockwise before placing it.<P>
<DT><CODE>right</CODE><DD>
Rotate the image 90 degrees clockwise before placing it.<P>
<CENTER><H2>Target Operations</H2></CENTER>
<DT><CODE>screen size <x-size> <y-size></CODE><DD>
Set the global screen size of the final image.<P>
<DT><CODE>screen position <x> <y></CODE><DD>
Set the global screen position of the final image.<P>
<CENTER><H2>Comments</H2></CENTER>
Comments or comment lines may be preceded with `#' and will be ignored.<P>
<H1>Memory required:</H1>
Proportional to the size of the largest pasted image.<P>
<H1>Options:</H1>
<DL>
<DT> [-v]
<DD> Emit a report on each composition action to stderr as it happens.
</DL>
<H1>Bugs:</H1>
The suffix sequence `left left' sometimes mysteriously fails to work,
probably due to some restriction in <a href="gifflip.html">gifflip</a>.<P>
No support for resizing or odd-angle rotations yet.<P>
The `color' suffix of text is a no-op, because the present version of
<a href="gifovly.html">gifovly</a> throws away color tables.<P>
Error checking is rudimentary.<P>
<H1>Author:</H1>
Eric S. Raymond <esr@snark.thyrsus.com>
<HR>
<ADDRESS>Eric S. Raymond <A HREF="mailto:esr@thyrsus.com"><esr@snark.thyrsus.com></A></ADDRESS>
</BODY>
</HTML>
|