Home | History | Annotate | Download | only in www 
      1 
      2 
      3 
      4 
      5 <!DOCTYPE html>
      6 <html lang="en">
      7 <head>
      8   <meta charset="utf-8"  />
      9   <meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1,shrink-to-fit=no"  />
     10   <title>Command-line Tools: Animate @ ImageMagick</title>
     11   <meta name="application-name" content="ImageMagick" />
     12   <meta name="description" content="Use ImageMagick to create, edit, compose, or convert bitmap images. You can resize your image, crop it, change its shades and colors, add captions, among other operations." />
     13   <meta name="application-url" content="https://imagemagick.org" />
     14   <meta name="generator" content="PHP" />
     15   <meta name="keywords" content="command-line, tools:, animate, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert" />
     16   <meta name="rating" content="GENERAL" />
     17   <meta name="robots" content="INDEX, FOLLOW" />
     18   <meta name="generator" content="ImageMagick Studio LLC" />
     19   <meta name="author" content="ImageMagick Studio LLC" />
     20   <meta name="revisit-after" content="2 DAYS" />
     21   <meta name="resource-type" content="document" />
     22   <meta name="copyright" content="Copyright (c) 1999-2019 ImageMagick Studio LLC" />
     23   <meta name="distribution" content="Global" />
     24   <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1" />
     25   <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
     26   <link href="animate.html" rel="canonical" />
     27   <link href="../images/wand.png" rel="icon" />
     28   <link href="../images/wand.ico" rel="shortcut icon" />
     29   <link href="assets/magick.css" rel="stylesheet" />
     30 </head>
     31 <body>
     32   <header>
     33   <nav class="navbar navbar-expand-md navbar-dark fixed-top bg-dark">
     34     <a class="navbar-brand" href="../"><img class="d-block" id="icon" alt="ImageMagick" width="32" height="32" src="../images/wand.ico"/></a>
     35     <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarsMagick" aria-controls="navbarsMagick" aria-expanded="false" aria-label="Toggle navigation">
     36       <span class="navbar-toggler-icon"></span>
     37     </button>
     38 
     39     <div class="navbar-collapse collapse" id="navbarsMagick" style="">
     40     <ul class="navbar-nav mr-auto">
     41       <li class="nav-item ">
     42         <a class="nav-link" href="api/quantize.html">Home <span class="sr-only">(current)</span></a>
     43       </li>
     44       <li class="nav-item ">
     45         <a class="nav-link" href="../www/download.html">Download</a>
     46       </li>
     47       <li class="nav-item ">
     48         <a class="nav-link" href="../www/command-line-tools.html">Tools</a>
     49       </li>
     50       <li class="nav-item ">
     51         <a class="nav-link" href="../www/command-line-processing.html">Command-line</a>
     52       </li>
     53       <li class="nav-item ">
     54         <a class="nav-link" href="../www/resources.html">Resources</a>
     55       </li>
     56       <li class="nav-item ">
     57         <a class="nav-link" href="../www/develop.html">Develop</a>
     58       </li>
     59       <li class="nav-item">
     60         <a class="nav-link" target="_blank" href="https://imagemagick.org/discourse-server/">Community</a>
     61       </li>
     62     </ul>
     63     <form class="form-inline my-2 my-lg-0" action="https://imagemagick.org/script/search.php">
     64       <input class="form-control mr-sm-2" type="text" name="q" placeholder="Search" aria-label="Search">
     65       <button class="btn btn-outline-success my-2 my-sm-0" type="submit" name="sa">Search</button>
     66     </form>
     67     </div>
     68   </nav>
     69   <div class="container">
     70    <script async="async" src="https://localhost/pagead/js/adsbygoogle.js"></script>    <ins class="adsbygoogle"
     71          style="display:block"
     72          data-ad-client="ca-pub-3129977114552745"
     73          data-ad-slot="6345125851"
     74          data-ad-format="auto"></ins>
     75     <script>
     76       (adsbygoogle = window.adsbygoogle || []).push({});
     77     </script>
     78 
     79   </div>
     80   </header>
     81   <main class="container">
     82     <div class="magick-template">
     83 <div class="magick-header">
     84 <p class="text-center"><a href="animate.html#usage">Example Usage</a>  <a href="animate.html#options">Option Summary</a></p>
     85 
     86 <p class="lead magick-description">Use the <code>animate</code> 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 <code>animate</code> command or see below for example usages of the command.</p>
     87 
     88 <h2><a class="anchor" id="usage"></a>Example Usage</h2>
     89 
     90 <p>We list a few examples of the <code>animate</code> command here to illustrate its usefulness and ease of use.  To get started, lets animate an image sequence in the GIF format:</p>
     91 
     92 <pre class="highlight"><code>magick animate movie.gif
     93 </code></pre>
     94 
     95 <p>To animate a directory of JPEG images, use:</p>
     96 
     97 <pre class="highlight"><code>magick animate *.jpg
     98 </code></pre>
     99 
    100 <p>You can find additional examples of using <code>animate</code> in <a href="../Usage/basics/#animate">Examples of ImageMagick Usage</a>.</p>
    101 
    102 
    103 <h2><a class="anchor" id="options"></a>Option Summary</h2>
    104 
    105 <p>The <code>animate</code> command recognizes these options.  Click on an option to get more details about how that option works.</p>
    106 
    107 <table class="table table-sm table-striped">
    108   <tbody>
    109   <tr>
    110     <th align="left">Option</th>
    111     <th align="left">Description</th>
    112   </tr>
    113 
    114   <tr>
    115     <td><a href="../www/command-line-options.html#alpha">-alpha</a></td>
    116     <td>on, activate, off, deactivate, set, opaque, copy",
    117 transparent, extract, background, or shape the alpha channel</td>
    118   </tr>
    119 
    120   <tr>
    121     <td><a href="../www/command-line-options.html#antialias">-antialias</a></td>
    122     <td>remove pixel-aliasing</td>
    123   </tr>
    124 
    125   <tr>
    126     <td><a href="../www/command-line-options.html#authenticate">-authenticate <var>value</var></a></td>
    127     <td>decrypt image with this password</td>
    128   </tr>
    129 
    130   <tr>
    131     <td><a href="../www/command-line-options.html#backdrop">-backdrop</a></td>
    132     <td>background color</td>
    133   </tr>
    134 
    135   <tr>
    136     <td><a href="../www/command-line-options.html#background">-background <var>color</var></a></td>
    137     <td>background color</td>
    138   </tr>
    139 
    140   <tr>
    141     <td><a href="../www/command-line-options.html#border">-border <var>geometry</var></a></td>
    142     <td>surround image with a border of color</td>
    143   </tr>
    144 
    145   <tr>
    146     <td><a href="../www/command-line-options.html#bordercolor">-bordercolor <var>color</var></a></td>
    147     <td>border color</td>
    148   </tr>
    149 
    150   <tr>
    151     <td><a href="../www/command-line-options.html#channel">-channel <var>type</var></a></td>
    152     <td>apply option to select image channels</td>
    153   </tr>
    154 
    155   <tr>
    156     <td><a href="../www/command-line-options.html#clip">-clip</a></td>
    157     <td>clip along the first path from the 8BIM profile</td>
    158   </tr>
    159 
    160   <tr>
    161     <td><a href="../www/command-line-options.html#clip-path">-clip-path <var>id</var></a></td>
    162     <td>clip along a named path from the 8BIM profile</td>
    163   </tr>
    164 
    165   <tr>
    166     <td><a href="../www/command-line-options.html#coalesce">-coalesce</a></td>
    167     <td>merge a sequence of images</td>
    168   </tr>
    169 
    170   <tr>
    171     <td><a href="../www/command-line-options.html#colormap">-colormap <var>type</var></a></td>
    172     <td>Shared or Private</td>
    173   </tr>
    174 
    175   <tr>
    176     <td><a href="../www/command-line-options.html#colors">-colors <var>value</var></a></td>
    177     <td>preferred number of colors in the image</td>
    178   </tr>
    179 
    180   <tr>
    181     <td><a href="../www/command-line-options.html#colorspace">-colorspace <var>type</var></a></td>
    182     <td>set image colorspace</td>
    183   </tr>
    184 
    185   <tr>
    186     <td><a href="../www/command-line-options.html#comment">-comment <var>string</var></a></td>
    187     <td>annotate image with comment</td>
    188   </tr>
    189 
    190   <tr>
    191     <td><a href="../www/command-line-options.html#compress">-compress <var>type</var></a></td>
    192     <td>image compression type</td>
    193   </tr>
    194 
    195   <tr>
    196     <td><a href="../www/command-line-options.html#contrast">-contrast</a></td>
    197     <td>enhance or reduce the image contrast</td>
    198   </tr>
    199 
    200   <tr>
    201     <td><a href="../www/command-line-options.html#crop">-crop <var>geometry</var></a></td>
    202     <td>preferred size and location of the cropped image</td>
    203   </tr>
    204 
    205   <tr>
    206     <td><a href="../www/command-line-options.html#debug">-debug <var>events</var></a></td>
    207     <td>animate copious debugging information</td>
    208   </tr>
    209 
    210   <tr>
    211     <td><a href="../www/command-line-options.html#decipher">-decipher <var>filename</var></a></td>
    212     <td>convert cipher pixels to plain</td>
    213   </tr>
    214 
    215   <tr>
    216     <td><a href="../www/command-line-options.html#define">-define <var>format:option</var></a></td>
    217     <td>define one or more image format options</td>
    218   </tr>
    219 
    220   <tr>
    221     <td><a href="../www/command-line-options.html#delay">-delay <var>value</var></a></td>
    222     <td>animate the next image after pausing</td>
    223   </tr>
    224 
    225   <tr>
    226     <td><a href="../www/command-line-options.html#density">-density <var>geometry</var></a></td>
    227     <td>horizontal and vertical density of the image</td>
    228   </tr>
    229 
    230   <tr>
    231     <td><a href="../www/command-line-options.html#depth">-depth <var>value</var></a></td>
    232     <td>image depth</td>
    233   </tr>
    234 
    235   <tr>
    236     <td><a href="../www/command-line-options.html#despeckle">-despeckle</a></td>
    237     <td>reduce the speckles within an image</td>
    238   </tr>
    239 
    240   <tr>
    241     <td><a href="../www/command-line-options.html#animate">-display <var>server</var></a></td>
    242     <td>get image or font from this X server</td>
    243   </tr>
    244 
    245   <tr>
    246     <td><a href="../www/command-line-options.html#dispose">-dispose <var>method</var></a></td>
    247     <td>layer disposal method</td>
    248   </tr>
    249 
    250   <tr>
    251     <td><a href="../www/command-line-options.html#dither">-dither  <var>method</var></a></td>
    252     <td>apply error diffusion to image</td>
    253   </tr>
    254 
    255   <tr>
    256     <td><a href="../www/command-line-options.html#edge">-edge <var>radius</var></a></td>
    257     <td>apply a filter to detect edges in the image</td>
    258   </tr>
    259 
    260   <tr>
    261     <td><a href="../www/command-line-options.html#endian">-endian <var>type</var></a></td>
    262     <td>endianness (MSB or LSB) of the image</td>
    263   </tr>
    264 
    265   <tr>
    266     <td><a href="../www/command-line-options.html#enhance">-enhance</a></td>
    267     <td>apply a digital filter to enhance a noisy image</td>
    268   </tr>
    269 
    270   <tr>
    271     <td><a href="../www/command-line-options.html#extract">-extract <var>geometry</var></a></td>
    272     <td>extract area from image</td>
    273   </tr>
    274 
    275   <tr>
    276     <td><a href="../www/command-line-options.html#filter">-filter <var>type</var></a></td>
    277     <td>use this filter when resizing an image</td>
    278   </tr>
    279 
    280   <tr>
    281     <td><a href="../www/command-line-options.html#flatten">-flatten</a></td>
    282     <td>flatten a sequence of images</td>
    283   </tr>
    284 
    285   <tr>
    286     <td><a href="../www/command-line-options.html#flip">-flip</a></td>
    287     <td>flip image in the vertical direction</td>
    288   </tr>
    289 
    290   <tr>
    291     <td><a href="../www/command-line-options.html#flop">-flop</a></td>
    292     <td>flop image in the horizontal direction</td>
    293   </tr>
    294 
    295   <tr>
    296     <td><a href="../www/command-line-options.html#frame">-frame <var>geometry</var></a></td>
    297     <td>surround image with an ornamental border</td>
    298   </tr>
    299 
    300   <tr>
    301     <td><a href="../www/command-line-options.html#gamma">-gamma <var>value</var></a></td>
    302     <td>level of gamma correction</td>
    303   </tr>
    304 
    305   <tr>
    306     <td><a href="../www/command-line-options.html#geometry">-geometry <var>geometry</var></a></td>
    307     <td>preferred size or location of the image</td>
    308   </tr>
    309 
    310   <tr>
    311     <td><a href="../www/command-line-options.html#gravity">-gravity <var>geometry</var></a></td>
    312     <td>horizontal and vertical backdrop placement</td>
    313   </tr>
    314 
    315   <tr>
    316     <td><a href="../www/command-line-options.html#help">-help</a></td>
    317     <td>print program options</td>
    318   </tr>
    319 
    320   <tr>
    321     <td><a href="../www/command-line-options.html#identify">-identify</a></td>
    322     <td>identify the format and characteristics of the image</td>
    323   </tr>
    324 
    325   <tr>
    326     <td><a href="../www/command-line-options.html#immutable">-immutable <var>type</var></a></td>
    327     <td>prohibit image edits</td>
    328   </tr>
    329 
    330   <tr>
    331     <td><a href="../www/command-line-options.html#interlace">-interlace <var>type</var></a></td>
    332     <td>type of image interlacing scheme</td>
    333   </tr>
    334 
    335   <tr>
    336     <td><a href="../www/command-line-options.html#interpolate">-interpolate <var>method</var></a></td>
    337     <td>pixel color interpolation method</td>
    338   </tr>
    339 
    340   <tr>
    341     <td><a href="../www/command-line-options.html#label">-label <var>name</var></a></td>
    342     <td>assign a label to an image</td>
    343   </tr>
    344 
    345   <tr>
    346     <td><a href="../www/command-line-options.html#limit">-limit <var>type value</var></a></td>
    347     <td>pixel cache resource limit</td>
    348   </tr>
    349 
    350   <tr>
    351     <td><a href="../www/command-line-options.html#log">-log <var>format</var></a></td>
    352     <td>format of debugging information</td>
    353   </tr>
    354 
    355   <tr>
    356     <td><a href="../www/command-line-options.html#map">-map <var>filename</var></a></td>
    357     <td>transform image colors to match this set of colors</td>
    358   </tr>
    359 
    360   <tr>
    361     <td><a href="../www/command-line-options.html#mattecolor">-mattecolor <var>color</var></a></td>
    362     <td>frame color</td>
    363   </tr>
    364 
    365   <tr>
    366     <td><a href="../www/command-line-options.html#monitor">-monitor</a></td>
    367     <td>monitor progress</td>
    368   </tr>
    369 
    370   <tr>
    371     <td><a href="../www/command-line-options.html#monochrome">-monochrome</a></td>
    372     <td>transform image to black and white</td>
    373   </tr>
    374 
    375   <tr>
    376     <td><a href="../www/command-line-options.html#negate">-negate</a></td>
    377     <td>replace each pixel with its complementary color </td>
    378   </tr>
    379 
    380   <tr>
    381     <td><a href="../www/command-line-options.html#page">-page <var>geometry</var></a></td>
    382     <td>size and location of an image canvas (setting)</td>
    383   </tr>
    384 
    385   <tr>
    386     <td><a href="../www/command-line-options.html#profile">-profile <var>filename</var></a></td>
    387     <td>add, delete, or apply an image profile</td>
    388   </tr>
    389 
    390   <tr>
    391     <td><a href="../www/command-line-options.html#quantize">-quantize <var>colorspace</var></a></td>
    392     <td>reduce image colors in this colorspace</td>
    393   </tr>
    394 
    395   <tr>
    396     <td><a href="../www/command-line-options.html#quiet">-quiet</a></td>
    397     <td>suppress all warning messages</td>
    398   </tr>
    399 
    400   <tr>
    401     <td><a href="../www/command-line-options.html#raise">-raise <var>value</var></a></td>
    402     <td>lighten/darken image edges to create a 3-D effect</td>
    403   </tr>
    404 
    405   <tr>
    406     <td><a href="../www/command-line-options.html#regard-warnings">-regard-warnings</a></td>
    407     <td>pay attention to warning messages.</td>
    408   </tr>
    409 
    410   <tr>
    411     <td><a href="../www/command-line-options.html#remote">-remote <var>command</var></a></td>
    412     <td>execute a command in an remote animate process</td>
    413   </tr>
    414 
    415   <tr>
    416     <td><a href="../www/command-line-options.html#resample">-resample <var>geometry</var></a></td>
    417     <td>change the resolution of an image</td>
    418   </tr>
    419 
    420   <tr>
    421     <td><a href="../www/command-line-options.html#resize">-resize <var>geometry</var></a></td>
    422     <td>resize the image</td>
    423   </tr>
    424 
    425   <tr>
    426     <td><a href="../www/command-line-options.html#respect-parentheses">-respect-parentheses</a></td>
    427     <td>settings remain in effect until parenthesis boundary.</td>
    428   </tr>
    429 
    430   <tr>
    431     <td><a href="../www/command-line-options.html#roll">-roll <var>geometry</var></a></td>
    432     <td>roll an image vertically or horizontally</td>
    433   </tr>
    434 
    435   <tr>
    436     <td><a href="../www/command-line-options.html#rotate">-rotate <var>degrees</var></a></td>
    437     <td>apply Paeth rotation to the image</td>
    438   </tr>
    439 
    440   <tr>
    441     <td><a href="../www/command-line-options.html#sample">-sample <var>geometry</var></a></td>
    442     <td>scale image with pixel sampling</td>
    443   </tr>
    444 
    445   <tr>
    446     <td><a href="../www/command-line-options.html#sampling-factor">-sampling-factor <var>geometry</var></a></td>
    447     <td>horizontal and vertical sampling factor</td>
    448   </tr>
    449 
    450   <tr>
    451     <td><a href="../www/command-line-options.html#scene">-scene <var>value</var></a></td>
    452     <td>image scene number</td>
    453   </tr>
    454 
    455   <tr>
    456     <td><a href="../www/command-line-options.html#segment">-segment <var>values</var></a></td>
    457     <td>segment an image</td>
    458   </tr>
    459 
    460   <tr>
    461     <td><a href="../www/command-line-options.html#seed">-seed <var>value</var></a></td>
    462     <td>seed a new sequence of pseudo-random numbers</td>
    463   </tr>
    464 
    465   <tr>
    466     <td><a href="../www/command-line-options.html#set">-set <var>attribute value</var></a></td>
    467     <td>set an image attribute</td>
    468   </tr>
    469 
    470   <tr>
    471     <td><a href="../www/command-line-options.html#sharpen">-sharpen <var>geometry</var></a></td>
    472     <td>sharpen the image</td>
    473   </tr>
    474 
    475   <tr>
    476     <td><a href="../www/command-line-options.html#size">-size <var>geometry</var></a></td>
    477     <td>width and height of image</td>
    478   </tr>
    479 
    480   <tr>
    481     <td><a href="../www/command-line-options.html#strip">-strip</a></td>
    482     <td>strip image of all profiles and comments</td>
    483   </tr>
    484 
    485   <tr>
    486     <td><a href="../www/command-line-options.html#thumbnail">-thumbnail <var>geometry</var></a></td>
    487     <td>create a thumbnail of the image</td>
    488   </tr>
    489 
    490   <tr>
    491     <td><a href="../www/command-line-options.html#transparent-color">-transparent-color <var>color</var></a></td>
    492     <td>transparent color</td>
    493   </tr>
    494 
    495   <tr>
    496     <td><a href="../www/command-line-options.html#trim">-trim</a></td>
    497     <td>trim image edges</td>
    498   </tr>
    499 
    500   <tr>
    501     <td><a href="../www/command-line-options.html#update">-update <var>seconds</var></a></td>
    502     <td>detect when image file is modified and reanimate</td>
    503   </tr>
    504 
    505   <tr>
    506     <td><a href="../www/command-line-options.html#verbose">-verbose</a></td>
    507     <td>print detailed information about the image</td>
    508   </tr>
    509 
    510   <tr>
    511     <td><a href="../www/command-line-options.html#version">-version</a></td>
    512     <td>print version information</td>
    513   </tr>
    514 
    515   <tr>
    516     <td><a href="../www/command-line-options.html#virtual-pixel">-virtual-pixel <var>method</var></a></td>
    517     <td>access method for pixels outside the boundaries of the image</td>
    518   </tr>
    519 
    520   <tr>
    521     <td><a href="../www/command-line-options.html#visual">-visual</a></td>
    522     <td>animate image using this visual type</td>
    523   </tr>
    524 
    525   <tr>
    526     <td><a href="../www/command-line-options.html#write">-window <var>id</var></a></td>
    527     <td>animate images to background of this window</td>
    528   </tr>
    529 
    530   <tr>
    531     <td><a href="../www/command-line-options.html#write">-window-group <var>id</var></a></td>
    532     <td>exit program when this window id is destroyed</td>
    533   </tr>
    534 
    535   </tbody>
    536 </table>
    537 </div>
    538     </div>
    539   </main><!-- /.container -->
    540   <footer class="magick-footer">
    541     <p><a href="../www/security-policy.html">Security</a> 
    542     <a href="../www/architecture.html">Architecture</a> 
    543     <a href="../www/links.html">Related</a> 
    544      <a href="../www/sitemap.html">Sitemap</a>
    545        
    546     <a href="animate.html#"><img class="d-inline" id="wand" alt="And Now a Touch of Magick" width="16" height="16" src="../images/wand.ico"/></a>
    547        
    548     <a href="http://pgp.mit.edu/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> 
    549     <a href="../www/support.html">Donate</a> 
    550     <a href="../www/https://imagemagick.org/script/contact.php">Contact Us</a>
    551     <br/>
    552     <small> 1999-2019 ImageMagick Studio LLC</small></p>
    553   </footer>
    554 
    555   <!-- Javascript assets -->
    556   <script src="assets/magick.js" crossorigin="anonymous"></script>
    557   <script>window.jQuery || document.write('<script src="https://localhost/ajax/libs/jquery/3.3.1/jquery.min.js"><\/script>')</script>
    558 </body>
    559 </html>
    560