root / ImageMagick / branches / ImageMagick-6.3.5 / www / animate.html

Revision 8064, 24.9 kB (checked in by cristy, 14 months ago)
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
4<head>
5  <style type="text/css" media="screen,projection"><!--
6    @import url("../www/magick.css");
7  //--></style>
8  <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
9  <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
10  <title>ImageMagick: Command-line Tools: Animate</title>
11  <meta http-equiv="Content-Language" content="en-US"/>
12  <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
13  <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
14  <meta name="Generator" content="PHP"/>
15  <meta name="Keywords" content="command-line, tools:, animate, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand"/>
16  <meta name="Description" content="ImageMagick® is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a variety of formats (about 100) including GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick to translate, flip, mirror, rotate, scale, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.  ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you can freely use, copy, modify, and distribute. Its license is compatible with the GPL. It runs on all major operating systems.  The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: MagickCore (C), MagickWand (C), ChMagick (Ch), Magick++ (C++), JMagick (Java), L-Magick (Lisp), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images automagically and dynamically."/>
17  <meta name="Rating" content="GENERAL"/>
18  <meta name="Robots" content="INDEX, FOLLOW"/>
19  <meta name="Generator" content="ImageMagick Studio LLC"/>
20  <meta name="Author" content="ImageMagick Studio LLC"/>
21  <meta name="Revisit-after" content="2 DAYS"/>
22  <meta name="Resource-type" content="document"/>
23  <meta name="Copyright" content="Copyright (c) 1999-2007 ImageMagick Studio LLC"/>
24  <meta name="Distribution" content="Global"/>
25  <link rel="shortcut icon" href="../images/wand.ico"  type="images/vnd.microsoft.icon"/>
26</head>
27
28<body id="www-imagemagick-org">
29  <table id="titlebar" style="width: 100%;background-color: #f5f5f5" cellpadding="0" cellspacing="0" border="0" summary="ImageMagick">
30    <tbody>
31      <tr valign="top">
32        <td align="left"><a href="../index.html"><img id="titlebar-west" src="../images/script.png" alt="[ImageMagick]" width="350" height="60" border="0" vspace="28" name="titlebar-west"/></a></td>
33        <td align="left"><a href="https://secure.networkredux.com/affiliate/idevaffiliate.html?id=146" target="1690740615"><img id="titlebar-west" src="../images/networkredux.png" alt="[sponsor]" border="0" vspace="45" name="titlebar-west"/></a></td>
34        <td width="99%"><br /></td>
35        <td style="background-color: white" align="right"><a href="../index.html"><img src="../images/sprite.jpg" alt="" width="114" height="118" border="0" name="titlebar-east"/></a></td>
36        <td style="background-color: white" align="right"><a href="../index.html"><img id="titlebar-east" src="../images/logo.jpg" alt="" width="114" height="118" border="0" name="titlebar-east"/></a></td>
37      </tr>
38    </tbody>
39  </table>
40
41  <table style="width: 100%" border="0" cellpadding="0" cellspacing="0" summary="">
42  <tbody>
43
44    <tr valign="top" style="height: 100%;">
45      <td id="menu" width="1%" height="100%">
46      <p><a href="#main">Skip to page contents</a></p>
47      <span>[</span>
48      <a href="../index.html">About ImageMagick</a>
49      <a href="../www/command-line-tools.html">Command-line Tools</a>
50      <a href="../www/command-line-processing.html" class="sub">Processing</a>
51      <a href="../www/command-line-options.html" class="sub">Options</a>
52      <a href="http://www.imagemagick.org/Usage/" target="75161215" class="sub">Usage</a>
53      <a href="../www/api.html">Program Interfaces</a>
54      <a href="../www/magick-wand.html" class="sub">MagickWand</a>
55      <a href="../www/magick-core.html" class="sub">MagickCore</a>
56      <a href="../www/perl-magick.html" class="sub">PerlMagick</a>
57      <a href="../Magick++/" target="1398944346" class="sub">Magick++</a>
58      <a href="../www/architecture.html">Architecture</a>
59  <span>]</span><br /><span>[</span>
60      <a href="../www/install-source.html">Install from Source</a>
61      <a href="../www/install-source.html#unix" class="sub">Unix</a>
62      <a href="../www/install-source.html#windows" class="sub">Windows</a>
63      <a href="../www/binary-releases.html">Binary Releases</a>
64      <a href="../www/binary-releases.html#unix" class="sub">Unix</a>
65      <a href="../www/binary-releases.html#macosx" class="sub">Mac OS X</a>
66      <a href="../www/binary-releases.html#windows" class="sub">Windows</a>
67      <a href="../www/resources.html">Resources</a>
68  <span>]</span><br /><span>[</span>
69      <a href="../www/download.html">Download</a>
70  <span>]</span><br /><span>[</span>
71      <a href="../www/sitemap.html">Site Map</a>
72                        <a href="../www/links.html" class="sub">Links</a>
73  <span>]</span><br /><br /><span>[</span>
74      <a href="../www/sponsors.html">Sponsors</a>
75  <a href="http://www.wischmop-shop.de" class="sponsor" target="sponsor">Wischmop</a><!-- 200805080004+ -->
76      <span>]</span>
77      </td>
78
79      <td id="main" valign="top">
80<p class="navigation-index">[<a href="#usage">Example Usage</a> &bull; <a href="#options">Option Summary</a>]</p>
81
82<p>Use the <kbd>animate</kbd> program to animate an image sequence on any X server.   See <a href="../www/command-line-processing.html">Command Line Processing</a> for advice on how to structure your <kbd>animate</kbd> command or see below for example usages of the command.</p>
83
84<div style="margin: auto;">
85  <h2><a name="usage"></a>Example Usage</h2>
86</div>
87
88<p>We list a few examples of the <kbd>animate</kbd> command here to illustrate its usefulness and ease of use.  To get started, lets animate an image sequence in the GIF format:</p>
89
90<pre class="text">
91  animate movie.gif
92</pre>
93
94<p>To animate a directory of JPEG images, use:</p>
95
96<pre class="text">
97  animate *.jpg
98</pre>
99
100<p>You can find additional examples of using <kbd>animate</kbd> in <a href="http://www-106.ibm.com/developerworks/library/l-graf/?ca=dnt-428" target="575455310">Graphics from the Command Line</a>.  Further discussion is available in  <a href="http://www-106.ibm.com/developerworks/library/l-graf2/?ca=dgr-lnxw15GraphicsLine" target="1931536495">More Graphics from the Command Line</a> and <a href="http://www.imagemagick.org/Usage/" target="1146606689">Examples of ImageMagick Usage</a>.</p>
101
102<div style="margin: auto;">
103  <h2><a name="options"></a>Option Summary</h2>
104</div>
105
106<p>The <kbd>animate</kbd> command recognizes these options.  Click on an option to get more details about how that option works.</p>
107
108<table id="table" cellpadding="2" cellspacing="0" style="width: 93%">
109  <tbody>
110  <tr>
111    <th align="left">Option</th>
112    <th align="left">Description</th>
113  </tr>
114
115  <tr>
116    <td valign="top"><a href="../www/command-line-options.html#alpha" target="magick-options">-alpha</a></td>
117    <td valign="top">activate, deactivate, reset, or set the alpha channel</td>
118  </tr>
119
120  <tr>
121    <td valign="top"><a href="../www/command-line-options.html#antialias" target="magick-options">-antialias</a></td>
122    <td valign="top">remove pixel-aliasing</td>
123  </tr>
124
125  <tr>
126    <td valign="top"><a href="../www/command-line-options.html#authenticate" target="magick-options">-authenticate <em class="option">value</em></a></td>
127    <td valign="top">decrypt image with this password</td>
128  </tr>
129
130  <tr>
131    <td valign="top"><a href="../www/command-line-options.html#backdrop" target="magick-options">-backdrop</a></td>
132    <td valign="top">background color</td>
133  </tr>
134
135  <tr>
136    <td valign="top"><a href="../www/command-line-options.html#background" target="magick-options">-background <em class="option">color</em></a></td>
137    <td valign="top">background color</td>
138  </tr>
139
140  <tr>
141    <td valign="top"><a href="../www/command-line-options.html#border" target="magick-options">-border <em class="option">geometry</em></a></td>
142    <td valign="top">surround image with a border of color</td>
143  </tr>
144
145  <tr>
146    <td valign="top"><a href="../www/command-line-options.html#bordercolor" target="magick-options">-bordercolor <em class="option">color</em></a></td>
147    <td valign="top">border color</td>
148  </tr>
149
150  <tr>
151    <td valign="top"><a href="../www/command-line-options.html#channel" target="magick-options">-channel <em class="option">type</em></a></td>
152    <td valign="top">apply option to select image channels</td>
153  </tr>
154
155  <tr>
156    <td valign="top"><a href="../www/command-line-options.html#clip" target="magick-options">-clip</a></td>
157    <td valign="top">clip along the first path from the 8BIM profile</td>
158  </tr>
159
160  <tr>
161    <td valign="top"><a href="../www/command-line-options.html#clip-path" target="magick-options">-clip-path <em class="option">id</em></a></td>
162    <td valign="top">clip along a named path from the 8BIM profile</td>
163  </tr>
164
165  <tr>
166    <td valign="top"><a href="../www/command-line-options.html#coalesce" target="magick-options">-coalesce</a></td>
167    <td valign="top">merge a sequence of images</td>
168  </tr>
169
170  <tr>
171    <td valign="top"><a href="../www/command-line-options.html#colormap" target="magick-options">-colormap <em class="option">type</em></a></td>
172    <td valign="top">Shared or Private</td>
173  </tr>
174
175  <tr>
176    <td valign="top"><a href="../www/command-line-options.html#colors" target="magick-options">-colors <em class="option">value</em></a></td>
177    <td valign="top">preferred number of colors in the image</td>
178  </tr>
179
180  <tr>
181    <td valign="top"><a href="../www/command-line-options.html#colorspace" target="magick-options">-colorspace <em class="option">type</em></a></td>
182    <td valign="top">set image colorspace</td>
183  </tr>
184
185  <tr>
186    <td valign="top"><a href="../www/command-line-options.html#comment" target="magick-options">-comment <em class="option">string</em></a></td>
187    <td valign="top">annotate image with comment</td>
188  </tr>
189
190  <tr>
191    <td valign="top"><a href="../www/command-line-options.html#compress" target="magick-options">-compress <em class="option">type</em></a></td>
192    <td valign="top">image compression type</td>
193  </tr>
194
195  <tr>
196    <td valign="top"><a href="../www/command-line-options.html#contrast" target="magick-options">-contrast</a></td>
197    <td valign="top">enhance or reduce the image contrast</td>
198  </tr>
199
200  <tr>
201    <td valign="top"><a href="../www/command-line-options.html#crop" target="magick-options">-crop <em class="option">geometry</em></a></td>
202    <td valign="top">preferred size and location of the cropped image</td>
203  </tr>
204
205  <tr>
206    <td valign="top"><a href="../www/command-line-options.html#debug" target="magick-options">-debug <em class="option">events</em></a></td>
207    <td valign="top">animate copious debugging information</td>
208  </tr>
209
210  <tr>
211    <td valign="top"><a href="../www/command-line-options.html#define" target="magick-options">-define <em class="option">format:option</em></a></td>
212    <td valign="top">define one or more image format options</td>
213  </tr>
214
215  <tr>
216    <td valign="top"><a href="../www/command-line-options.html#delay" target="magick-options">-delay <em class="option">value</em></a></td>
217    <td valign="top">animate the next image after pausing</td>
218  </tr>
219
220  <tr>
221    <td valign="top"><a href="../www/command-line-options.html#density" target="magick-options">-density <em class="option">geometry</em></a></td>
222    <td valign="top">horizontal and vertical density of the image</td>
223  </tr>
224
225  <tr>
226    <td valign="top"><a href="../www/command-line-options.html#depth" target="magick-options">-depth <em class="option">value</em></a></td>
227    <td valign="top">image depth</td>
228  </tr>
229
230  <tr>
231    <td valign="top"><a href="../www/command-line-options.html#despeckle" target="magick-options">-despeckle</a></td>
232    <td valign="top">reduce the speckles within an image</td>
233  </tr>
234
235  <tr>
236    <td valign="top"><a href="../www/command-line-options.html#animate" target="magick-options">-display <em class="option">server</em></a></td>
237    <td valign="top">get image or font from this X server</td>
238  </tr>
239
240  <tr>
241    <td valign="top"><a href="../www/command-line-options.html#dispose" target="magick-options">-dispose <em class="option">method</em></a></td>
242    <td valign="top">GIF disposal method</td>
243  </tr>
244
245  <tr>
246    <td valign="top"><a href="../www/command-line-options.html#dither" target="magick-options">-dither</a></td>
247    <td valign="top">apply Floyd/Steinberg error diffusion to image</td>
248  </tr>
249
250  <tr>
251    <td valign="top"><a href="../www/command-line-options.html#edge" target="magick-options">-edge <em class="option">radius</em></a></td>
252    <td valign="top">apply a filter to detect edges in the image</td>
253  </tr>
254
255  <tr>
256    <td valign="top"><a href="../www/command-line-options.html#endian" target="magick-options">-endian <em class="option">type</em></a></td>
257    <td valign="top">endianness (MSB or LSB) of the image</td>
258  </tr>
259
260  <tr>
261    <td valign="top"><a href="../www/command-line-options.html#enhance" target="magick-options">-enhance</a></td>
262    <td valign="top">apply a digital filter to enhance a noisy image</td>
263  </tr>
264
265  <tr>
266    <td valign="top"><a href="../www/command-line-options.html#extract" target="magick-options">-extract <em class="option">geometry</em></a></td>
267    <td valign="top">extract area from image</td>
268  </tr>
269
270  <tr>
271    <td valign="top"><a href="../www/command-line-options.html#filter" target="magick-options">-filter <em class="option">type</em></a></td>
272    <td valign="top">use this filter when resizing an image</td>
273  </tr>
274
275  <tr>
276    <td valign="top"><a href="../www/command-line-options.html#flatten" target="magick-options">-flatten</a></td>
277    <td valign="top">flatten a sequence of images</td>
278  </tr>
279
280  <tr>
281    <td valign="top"><a href="../www/command-line-options.html#flip" target="magick-options">-flip</a></td>
282    <td valign="top">flip image in the vertical direction</td>
283  </tr>
284
285  <tr>
286    <td valign="top"><a href="../www/command-line-options.html#flop" target="magick-options">-flop</a></td>
287    <td valign="top">flop image in the horizontal direction</td>
288  </tr>
289
290  <tr>
291    <td valign="top"><a href="../www/command-line-options.html#frame" target="magick-options">-frame <em class="option">geometry</em></a></td>
292    <td valign="top">surround image with an ornamental border</td>
293  </tr>
294
295  <tr>
296    <td valign="top"><a href="../www/command-line-options.html#gamma" target="magick-options">-gamma <em class="option">value</em></a></td>
297    <td valign="top">level of gamma correction</td>
298  </tr>
299
300  <tr>
301    <td valign="top"><a href="../www/command-line-options.html#geometry" target="magick-options">-geometry <em class="option">geometry</em></a></td>
302    <td valign="top">preferred size or location of the image</td>
303  </tr>
304
305  <tr>
306    <td valign="top"><a href="../www/command-line-options.html#help" target="magick-options">-help</a></td>
307    <td valign="top">print program options</td>
308  </tr>
309
310  <tr>
311    <td valign="top"><a href="../www/command-line-options.html#identify" target="magick-options">-identify</a></td>
312    <td valign="top">identify the format and characteristics of the image</td>
313  </tr>
314
315  <tr>
316    <td valign="top"><a href="../www/command-line-options.html#immutable" target="magick-options">-immutable <em class="option">type</em></a></td>
317    <td valign="top">prohibit image edits</td>
318  </tr>
319
320  <tr>
321    <td valign="top"><a href="../www/command-line-options.html#interlace" target="magick-options">-interlace <em class="option">type</em></a></td>
322    <td valign="top">type of image interlacing scheme</td>
323  </tr>
324
325  <tr>
326    <td valign="top"><a href="../www/command-line-options.html#interpolate">-interpolate <em class="option">method</em></a></td>
327    <td valign="top">pixel color interpolation method</td>
328  </tr>
329
330  <tr>
331    <td valign="top"><a href="../www/command-line-options.html#label" target="magick-options">-label <em class="option">name</em></a></td>
332    <td valign="top">assign a label to an image</td>
333  </tr>
334
335  <tr>
336    <td valign="top"><a href="../www/command-line-options.html#limit" target="magick-options">-limit <em class="option">type value</em></a></td>
337    <td valign="top">pixel cache resource limit</td>
338  </tr>
339
340  <tr>
341    <td valign="top"><a href="../www/command-line-options.html#log" target="magick-options">-log <em class="option">format</em></a></td>
342    <td valign="top">format of debugging information</td>
343  </tr>
344
345  <tr>
346    <td valign="top"><a href="../www/command-line-options.html#map" target="magick-options">-map <em class="option">filename</em></a></td>
347    <td valign="top">transform image colors to match this set of colors</td>
348  </tr>
349
350  <tr>
351    <td valign="top"><a href="../www/command-line-options.html#mattecolor" target="magick-options">-mattecolor <em class="option">color</em></a></td>
352    <td valign="top">frame color</td>
353  </tr>
354
355  <tr>
356    <td valign="top"><a href="../www/command-line-options.html#monitor" target="magick-options">-monitor</a></td>
357    <td valign="top">monitor progress</td>
358  </tr>
359
360  <tr>
361    <td valign="top"><a href="../www/command-line-options.html#monochrome" target="magick-options">-monochrome</a></td>
362    <td valign="top">transform image to black and white</td>
363  </tr>
364
365  <tr>
366    <td valign="top"><a href="../www/command-line-options.html#negate" target="magick-options">-negate</a></td>
367    <td valign="top">replace every pixel with its complementary color </td>
368  </tr>
369
370  <tr>
371    <td valign="top"><a href="../www/command-line-options.html#page" target="magick-options">-page <em class="option">geometry</em></a></td>
372    <td valign="top">size and location of an image canvas (setting)</td>
373  </tr>
374
375  <tr>
376    <td valign="top"><a href="../www/command-line-options.html#profile" target="magick-options">-profile <em class="option">filename</em></a></td>
377    <td valign="top">add, delete, or apply an image profile</td>
378  </tr>
379
380  <tr>
381    <td valign="top"><a href="../www/command-line-options.html#quantize" target="magick-options">-quantize <em class="option">colorspace</em></a></td>
382    <td valign="top">reduce image colors in this colorspace</td>
383  </tr>
384
385  <tr>
386    <td valign="top"><a href="../www/command-line-options.html#quiet" target="magick-options">-quiet</a></td>
387    <td valign="top">suppress all warning messages</td>
388  </tr>
389
390  <tr>
391    <td valign="top"><a href="../www/command-line-options.html#raise" target="magick-options">-raise <em class="option">value</em></a></td>
392    <td valign="top">lighten/darken image edges to create a 3-D effect</td>
393  </tr>
394
395  <tr>
396    <td valign="top"><a href="../www/command-line-options.html#regard-warnings" target="magick-options">-regard-warnings</a></td>
397    <td valign="top">pay attention to warning messages.</td>
398  </tr>
399
400  <tr>
401    <td valign="top"><a href="../www/command-line-options.html#remote" target="magick-options">-remote <em class="option">command</em></a></td>
402    <td valign="top">execute a command in an remote animate process</td>
403  </tr>
404
405  <tr>
406    <td valign="top"><a href="../www/command-line-options.html#resample" target="magick-options">-resample <em class="option">geometry</em></a></td>
407    <td valign="top">change the resolution of an image</td>
408  </tr>
409
410  <tr>
411    <td valign="top"><a href="../www/command-line-options.html#resize" target="magick-options">-resize <em class="option">geometry</em></a></td>
412    <td valign="top">resize the image</td>
413  </tr>
414
415  <tr>
416    <td valign="top"><a href="../www/command-line-options.html#roll" target="magick-options">-roll <em class="option">geometry</em></a></td>
417    <td valign="top">roll an image vertically or horizontally</td>
418  </tr>
419
420  <tr>
421    <td valign="top"><a href="../www/command-line-options.html#rotate" target="magick-options">-rotate <em class="option">degrees</em></a></td>
422    <td valign="top">apply Paeth rotation to the image</td>
423  </tr>
424
425  <tr>
426    <td valign="top"><a href="../www/command-line-options.html#sample" target="magick-options">-sample <em class="option">geometry</em></a></td>
427    <td valign="top">scale image with pixel sampling</td>
428  </tr>
429
430  <tr>
431    <td valign="top"><a href="../www/command-line-options.html#sampling-factor" target="magick-options">-sampling-factor <em class="option">geometry</em></a></td>
432    <td valign="top">horizontal and vertical sampling factor</td>
433  </tr>
434
435  <tr>
436    <td valign="top"><a href="../www/command-line-options.html#scene" target="magick-options">-scene <em class="option">value</em></a></td>
437    <td valign="top">image scene number</td>
438  </tr>
439
440  <tr>
441    <td valign="top"><a href="../www/command-line-options.html#segment" target="magick-options">-segment <em class="option">values</em></a></td>
442    <td valign="top">segment an image</td>
443  </tr>
444
445  <tr>
446    <td valign="top"><a href="../www/command-line-options.html#seed" target="magick-options">-seed <em class="option">value</em></a></td>
447    <td valign="top">seed a new sequence of pseudo-random numbers</td>
448  </tr>
449
450  <tr>
451    <td valign="top"><a href="../www/command-line-options.html#set" target="magick-options">-set <em class="option">attribute value</em></a></td>
452    <td valign="top">set an image attribute</td>
453  </tr>
454
455  <tr>
456    <td valign="top"><a href="../www/command-line-options.html#sharpen" target="magick-options"<