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
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" []>
<refentry id='giftool.1'>
<refentryinfo><date>3 June 2012</date></refentryinfo>
<refmeta>
<refentrytitle>giftool</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="source">GIFLIB</refmiscinfo>
<refmiscinfo class="manual">GIFLIB Documentation</refmiscinfo>
</refmeta>
<refnamediv id='name'>
<refname>giftool</refname>
<refpurpose>GIF transformation tool</refpurpose>
</refnamediv>
<refsynopsisdiv id='synopsis'>
<cmdsynopsis>
<command>giftool</command>
<arg choice='opt'>-a <replaceable>aspect</replaceable></arg>
<arg choice='opt'>-b <replaceable>bgcolor</replaceable></arg>
<arg choice='opt'>-d <replaceable>delaytime</replaceable></arg>
<arg choice='opt'>-i <replaceable>interlacing</replaceable></arg>
<arg choice='opt'>-n <replaceable>imagelist</replaceable></arg>
<arg choice='opt'>-p <replaceable>left,top</replaceable></arg>
<arg choice='opt'>-s <replaceable>width,height</replaceable></arg>
<arg choice='opt'>-t <replaceable>transcolor</replaceable></arg>
<arg choice='opt'>-u <replaceable>sort-flag</replaceable></arg>
<arg choice='opt'>-x <replaceable>disposal</replaceable></arg>
<arg choice='opt'>-z <replaceable>sort-flag</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1><title>Description</title>
<para>A filter for transforming GIFS. With no options, it's an expensive
copy of a GIF in standard input to standard output. Options specify
filtering operations and are performed in the order specified on the command
line.</para>
<para>The -n option selects images, allowing the tool to act on a
subset of images in a multi-image GIF. This option takes a
comma-separated list of decimal integers which are interpreted as
1-origin image indices; these are the images that will be acted on.
If no -n option is specified, the tool will select and transform all
images.</para>
<para>The -b option takes a decimal integer argument and uses it to
set the (0-origin) screen background color index.</para>
<para>The -f option accepts a printf-style format string and
substitutes into it the values of image-descriptor and graphics-control
fields. The string is formatted and output once for each selected
image. Normal C-style escapes \b, \f, \n, \r, \t. \v, and \xNN are
interpreted; also \e produces ESC (ASCII 0x1b). The following format
cookies are substituted:</para>
<variablelist>
<varlistentry>
<term>%a</term>
<listitem><para>Pixel aspect byte.</para></listitem>
</varlistentry>
<varlistentry>
<term>%b</term>
<listitem><para>Screen background color.</para></listitem>
</varlistentry>
<varlistentry>
<term>%d</term>
<listitem><para>Image delay time</para></listitem>
</varlistentry>
<varlistentry>
<term>%h</term>
<listitem><para>Image height (y dimension)</para></listitem>
</varlistentry>
<varlistentry>
<term>%n</term>
<listitem><para>Image index</para></listitem>
</varlistentry>
<varlistentry>
<term>%p</term>
<listitem><para>Image position (as an x,y pair)</para></listitem>
</varlistentry>
<varlistentry>
<term>%s</term>
<listitem><para>Screen size (as an x,y pair)</para></listitem>
</varlistentry>
<varlistentry>
<term>%t</term>
<listitem><para>Image transparent-color index</para></listitem>
</varlistentry>
<varlistentry>
<term>%u</term>
<listitem><para>Image user-input flag (boolean)</para></listitem>
</varlistentry>
<varlistentry>
<term>%v</term>
<listitem><para>GIF version string</para></listitem>
</varlistentry>
<varlistentry>
<term>%w</term>
<listitem><para>Image width (x dimension)</para></listitem>
</varlistentry>
<varlistentry>
<term>%x</term>
<listitem><para>Image GIF89 disposal mode</para></listitem>
</varlistentry>
<varlistentry>
<term>%z</term>
<listitem><para>Image's color table sort flag (boolean,
false if no local color map)</para></listitem>
</varlistentry>
</variablelist>
<para>Boolean substitutions may take a prefix to modify how they are
displayed:</para>
<variablelist>
<varlistentry>
<term>1</term>
<listitem><para>"1" or "0"</para></listitem>
</varlistentry>
<varlistentry>
<term>o</term>
<listitem><para>"on" or "off"</para></listitem>
</varlistentry>
<varlistentry>
<term>t</term>
<listitem><para>"t" or "f"</para></listitem>
</varlistentry>
<varlistentry>
<term>y</term>
<listitem><para>"yes" or "no"</para></listitem>
</varlistentry>
</variablelist>
<para>Thus, for example, "%oz" displays image sort flags using the
strings "on" and "off". The default with no prefix is numeric.</para>
<para>The -a option takes an unsigned decimal integer argument and
uses it to set the aspect-ratio bye in the logical screen descriptor
block.</para>
<para>The -b option takes an unsigned decimal integer argument and
uses it to set the background color index in the logical screen
descriptor block.</para>
<para>The -d option takes a decimal integer argument and uses it to set a delay
time, in hundredths of a second, on selected images.</para>
<para>The -i option sets or clears interlaccing in selected images. Acceptable arguments are "1", "0", "yes", "no", "on", "off", "t", "f"</para>
<para>The -p option takes a (0-origin) x,y coordinate-pair and sets it
as the preferred upper-left-corner coordinates of selected
images.</para>
<para>The -s option takes a (0-origin) x,y coordinate-pair and sets it
as the expected display screen size.</para>
<para>The -t option takes a decimal integer argument and uses it to set the
(0-origin) index of the transparency color in selected images.</para>
<para>The -u option sets or clears the user-input flag in selected
images. Acceptable arguments are "1", "0", "yes", "no", "on", "off",
"t", "f".</para>
<para>The -x option takes a decimal integer argument and uses it to set the
GIF89 disposal mode in selected images.</para>
<para>The -z option sets or clears the color-table sort flag in
selected images. Acceptable arguments are "1", "0", "yes", "no",
"on", "off", "t", "f".</para>
<para>Note that the -a, -b, -p, -s, and -z options are included to
complete the ability to modify all fields defined in the GIF standard,
but should have no effect on how an image renders on browsers or
modern viewers.</para>
</refsect1>
<refsect1><title>Author</title>
<para>Eric S. Raymond.</para>
</refsect1>
</refentry>
|
