composite.html revision 1454be7db7a897f42cd40e4165f945d77196a6f8
1
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 
3  "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
4<html version="-//W3C//DTD XHTML 1.1//EN"
5      xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
6      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
7      xsi:schemaLocation="http://www.w3.org/1999/xhtml
8                          http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">
9<head>
10  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
11  <meta name="google-site-verification" content="MxsMq6bdLOx0KSuz1MY6yG9ZTIJ7_7DVRfl5NCAT5Yg"/>
12  <title>ImageMagick: Command-line Tools: Composite</title>
13  <meta http-equiv="Content-Language" content="en-US"/>
14  <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
15  <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
16  <meta name="Application-name" content="ImageMagick"/>
17  <meta name="Description" content="Use ImageMagick to convert, edit, or compose bitmap images in a variety of formats.  In addition resize, rotate, shear, distort and transform images automagically."/>
18  <meta name="Application-url" content="http://www.imagemagick.org"/>
19  <meta name="Generator" content="PHP"/>
20  <meta name="Keywords" content="command-line, tools:, composite, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Image, Processing, Automagically"/>
21  <meta name="Rating" content="GENERAL"/>
22  <meta name="Robots" content="INDEX, FOLLOW"/>
23  <meta name="Generator" content="ImageMagick Studio LLC"/>
24  <meta name="Author" content="ImageMagick Studio LLC"/>
25  <meta name="Revisit-after" content="2 DAYS"/>
26  <meta name="Resource-type" content="document"/>
27  <meta name="Copyright" content="Copyright (c) 1999-2012 ImageMagick Studio LLC"/>
28  <meta name="Distribution" content="Global"/>
29  <link rel="icon" href="/images/wand.png"/>
30  <link rel="shortcut icon" href="/images/wand.ico"  type="images/x-icon"/>
31  <link rel="canonical" href="http://www.imagemagick.org" />
32  <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
33  <link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />
34  <link rel="stylesheet" type="text/css" href="http://www.imagemagick.org/fancybox/jquery.fancybox-1.3.4.css" media="screen" />
35  <style type="text/css" media="all">
36    @import url("/www/magick.css");
37  </style>
38  <script type="text/javascript" src="https://apis.google.com/js/plusone.js"></script>
39  <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.1/jquery.min.js"></script>
40  <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.fancybox-1.3.4.pack.js"></script>
41  <script type="text/javascript">
42    $(document).ready(function() {
43      $("a[href$=.jpg],a[href$=.png],a[href$=.gif]").fancybox({
44        'transitionIn'  : 'elastic',
45        'transitionOut' : 'elastic',
46        'overlayShow'   : false,
47        'opacity'       : true
48      });
49    });
50  </script>
51</head>
52
53<body id="www-imagemagick-org">
54<div class="titlebar">
55<div style="margin: 17px auto; float: left;">
56  <script type="text/javascript">
57  <!--
58    google_ad_client = "pub-3129977114552745";
59    google_ad_slot = "5439289906";
60    google_ad_width = 728;
61    google_ad_height = 90;
62  //-->
63  </script>
64  <script type="text/javascript"
65    src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
66  </script>
67</div>
68<a href="http://www.imagemagick.org/discourse-server/">
69  <img src="/images/logo.jpg"
70  alt="ImageMagick Logo"
71  style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
72<a href="/index.html">
73  <img src="/images/sprite.jpg"
74  alt="ImageMagick Sprite"
75  style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
76</div>
77
78<div class="westbar">
79
80<div class="menu">
81  <a title="About ImageMagick" href="/index.html">About ImageMagick</a>
82</div>
83<div class="menu">
84  <a title="Binary Releases" href="/www/binary-releases.html">Binary Releases</a>
85</div>
86<div class="sub">
87    <a title="Binary Release: Unix" href="/www/binary-releases.html#unix">Unix</a>
88</div>
89<div class="sub">
90    <a title="Binary Release: MacOS X" href="/www/binary-releases.html#macosx">Mac OS X</a>
91</div>
92<div class="sub">
93    <a title="Binary Release: iOS" href="/www/binary-releases.html#iOS">iOS</a>
94</div>
95<div class="sub">
96    <a title="Binary Release: Windows" href="/www/binary-releases.html#windows">Windows</a>
97</div>
98<div class="sep"></div>
99<div class="menu">
100  <a title="Command-line Tools" href="/www/command-line-tools.html">Command-line Tools</a>
101</div>
102<div class="sub">
103    <a title="Command-line Tools: Processing" href="/www/command-line-processing.html">Processing</a>
104</div>
105<div class="sub">
106    <a title="Command-line Tools: Options" href="/www/command-line-options.html">Options</a>
107</div>
108<div class="sub">
109    <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
110</div>
111<div class="menu">
112  <a title="Program Interfaces" href="/www/api.html">Program Interfaces</a>
113</div>
114<div class="sub">
115    <a title="Program Interface: MagickWand" href="/www/magick-wand.html">MagickWand</a>
116</div>
117<div class="sub">
118    <a title="Program Interface: MagickCore" href="/www/magick-core.html">MagickCore</a>
119</div>
120<div class="sub">
121    <a title="Program Interface: PerlMagick" href="/www/perl-magick.html">PerlMagick</a>
122</div>
123<div class="sub">
124    <a title="Program Interface: Magick++" href="/www/magick++.html">Magick++</a>
125</div>
126<div class="sep"></div>
127<div  class="menu">
128   <a title="Install from Source" href="/www/install-source.html">Install from Source</a>
129</div>
130<div class="sub">
131    <a title="Install from Source: Unix" href="/www/install-source.html#unix">Unix</a>
132</div>
133<div class="sub">
134    <a title="Install from Source: Windows" href="/www/install-source.html#windows">Windows</a>
135 </div>
136<div class="menu">
137  <a title="Resources" href="/www/resources.html">Resources</a>
138</div>
139<div class="menu">
140  <a title="Architecture" href="/www/architecture.html">Architecture</a>
141</div>
142<div class="menu">
143  <a title="Download" href="/www/download.html">Download</a>
144</div>
145<div class="sep"></div>
146<div class="menu">
147  <a title="Search" href="/www/search.html">Search</a>
148</div>
149<div class="sep"></div>
150<div class="menu">
151  <a title="Site Map" href="/www/sitemap.html">Site Map</a>
152</div>
153<div  class="sub">
154  <a title="Site Map: Links" href="/www/links.html">Links</a>
155</div>
156<div class="sep"></div>
157<div  class="menu">
158  <a rel="follow" title="Sponsors" href="/www/sponsors.html">Sponsors:</a>
159
160<a href="http://www.networkredux.com">
161  <img src="/images/networkredux.png" width="140" height="31" alt="[sponsor]"
162  style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a>
163<div class="sponsbox">
164<div  class="sponsor">
165  <a rel="follow" title="Sponsor: Autoteile" href="http://www.q11-shop.de">Autoteile</a><!-- 201205010540s suvalj -->
166</div>
167<div  class="sponsor">
168  <a rel="follow" title="Sponsor: Web Hosting" href="http://www.micfo.com">Web Hosting</a><!-- 209901010090s golestan -->
169</div>
170<div  class="sponsor">
171  <a rel="follow" title="Sponsor: Search engine optimisation" href="http://www.seomoves.com.au">Search engine optimisation</a><!-- 201110010090s jen@seo lowprofilelinks -->
172</div>
173<div  class="sponsor">
174  <a rel="follow" title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
175</div>
176<div  class="sponsor">
177  <a rel="follow" title="Sponsor: Web Hosting Deals" href="http://www.webhostingdeals.org">Web Hosting Deals</a><!-- 201111010270 chee.hoa darin -->
178</div>
179<div  class="sponsor">
180  <a rel="follow" title="Sponsor: Autos part" href="http://www.pkwteile.de/autoteile">Autos part</a><!-- 201112010090s jr@pkwte... -->
181</div>
182<div  class="sponsor">
183  <a rel="follow" title="Sponsor: Web Hosting Reviews" href="http://www.webhostingsecretrevealed.com">Web Hosting Secret Revealed</a><!-- 201204010540 iamchee jerry -->
184</div>
185<div  class="sponsor">
186  <a rel="follow" title="Sponsor: Web Hosting Break" href="http://www.webhostingbreak.com">Web Hosting Break</a><!-- 201109010090 ian@ian-m... -->
187</div>
188<div  class="sponsor">
189  <a rel="follow" title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201303011500 r.leo -->
190</div>
191<div  class="sponsor">
192  <a rel="follow" title="Sponsor: Website Hosting" href="http://www.hostreviewgeeks.com">Website Hosting</a><!-- 201110010090 alexanian media -->
193</div>
194<div  class="sponsor">
195  <a rel="follow" title="Sponsor: Hotel München" href="http://www.messehotel-erb-muenchen.de">Hotel München</a><!-- 201111010450 cerb -->
196</div>
197<div  class="sponsor">
198  <a rel="follow" title="Sponsor: Best Web Hosting" href="http://webhostinggeeks.com">Best Web Hosting</a><!-- 201110010720 -->
199</div>
200<div  class="sponsor">
201  <a rel="follow" title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
202</div>
203<div  class="sponsor">
204  <a rel="follow" title="Sponsor: Web Hosting Ratings" href="http://webhostingrating.com">Web Hosting Ratings</a><!-- 201110010720 -->
205</div>
206<div  class="sponsor">
207   <a rel="follow" title="Sponsor: Notebook Reparatur" href="http://www.notebook-reparaturen-berlin.de">Notebook Reparatur</a><!-- 2011120100300 atlas.multimedia-->
208</div>
209</div>
210</div>
211</div>
212
213<div class="eastbar">
214  <div class="g-plusone" data-size="standard" data-count="false"></div>
215</div>
216
217<div class="main">
218
219<h1>ImageMagick Composite Command-line Tool</h1>
220<p class="navigation-index">[<a href="#usage">Example Usage</a> &bull; <a href="#options">Option Summary</a>]</p>
221
222<p>Use the <kbd>composite</kbd> program to overlap one image over another.  See <a href="/www/command-line-processing.html">Command Line Processing</a> for advice on how to structure your <kbd>composite</kbd> command or see below for example usages of the command.</p>
223
224<div style="margin: auto;">
225  <h2><a id="usage"></a>Example Usage</h2>
226</div>
227
228<p>We list a few examples of the <kbd>composite</kbd> command here to illustrate its usefulness and ease of use.  To get started, lets overlay a smiley face over a rose:</p>
229
230<p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>composite -gravity center smile.gif  rose: rose-over.png</span></p>
231<div class="image">
232<p>
233  <a href="/images/smile.gif"><img src="/images/smile.gif" width="48" height="48" alt="smile" /></a>
234  <img src="/images/over.gif" width="56" height="46" alt="over" />
235  <a href="/images/rose.jpg"><img src="/images/rose.jpg" width="70" height="46" alt="rose" /></a>
236  <img style="margin-top:13px; margin-bottom:13px;" src="/images/right.gif" width="20" height="20" alt="==>" />
237  <a href="/images/rose-over.png"><img src="/images/rose-over.png" width="70" height="46" alt="rose" /></a>
238</p>
239</div>
240
241<p>You can create three-dimensional effect with the <em>Atop</em>:</p>
242
243<p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>convert -size 70x70 canvas:none -fill red -draw 'circle 35,35 10,30' red-circle.png</span><span class='crtout'></span><span class="crtprompt"> $magick&gt; </span><span class='crtin'>convert -size 70x70 canvas:none -draw 'circle 35,35 35,20' -negate \ <br/>
244  -channel A -gaussian-blur 0x8 white-highlight.png</span><span class='crtout'></span><span class="crtprompt"> $magick&gt; </span><span class='crtin'>composite -compose atop -geometry -13-17 white-highlight.png red-circle.png red-ball.png</span></p>
245
246<div class="image">
247<p>
248  <a href="/images/white-highlight.png"><img src="/images/white-highlight.png" width="70" height="70" alt="white highlight" /></a>
249  <img src="/images/atop.gif" width="56" height="70" alt="atop" />
250  <a href="/images/red-circle.png"><img src="/images/red-circle.png" width="70" height="70" alt="red circle" /></a>
251  <img style="margin-top:25px; margin-bottom:25px;" src="/images/right.gif" width="20" height="20" alt="==>" />
252  <a href="/images/red-ball.png"><img src="/images/red-ball.png" width="70" height="70" alt="red ball" /></a>
253</p>
254</div>
255
256<p>You can find additional examples of using <kbd>composite</kbd> in <a href="http://www.imagemagick.org/Usage/">Examples of ImageMagick Usage</a>.  You can find out more about them and the mathematics by looking at <a href="http://www.w3.org/TR/SVG12/rendering.html">SVG Alpha Compositing</a></p>
257
258<div style="margin: auto;">
259  <h2><a id="options"></a>Option Summary</h2>
260</div>
261
262<p>The <kbd>composite</kbd> command recognizes these options.  Click on an option to get more details about how that option works.</p>
263
264<table class="doc">
265  <tbody>
266  <tr>
267    <th align="left">Option</th>
268    <th align="left">Description</th>
269  </tr>
270
271  <tr>
272    <td valign="top"><a href="/www/command-line-options.html#affine">-affine <em class="option">matrix</em></a></td>
273    <td valign="top">affine transform matrix</td>
274  </tr>
275
276  <tr>
277    <td valign="top"><a href="/www/command-line-options.html#alpha">-alpha</a></td>
278    <td valign="top">on, activate, off, deactivate, set, opaque, copy",
279transparent, extract, background, or shape the alpha channel</td>
280  </tr>
281
282  <tr>
283    <td valign="top"><a href="/www/command-line-options.html#authenticate">-authenticate <em class="option">value</em></a></td>
284    <td valign="top">decrypt image with this password</td>
285  </tr>
286
287  <tr>
288    <td valign="top"><a href="/www/command-line-options.html#blend">-blend <em class="option">geometry</em></a></td>
289    <td valign="top">blend images</td>
290  </tr>
291
292  <tr>
293    <td valign="top"><a href="/www/command-line-options.html#blue-primary">-blue-primary <em class="option">point</em></a></td>
294    <td valign="top">chromaticity blue primary point</td>
295  </tr>
296
297
298  <tr>
299    <td valign="top"><a href="/www/command-line-options.html#border">-border <em class="option">geometry</em></a></td>
300    <td valign="top">surround image with a border of color</td>
301  </tr>
302
303  <tr>
304    <td valign="top"><a href="/www/command-line-options.html#bordercolor">-bordercolor <em class="option">color</em></a></td>
305    <td valign="top">border color</td>
306  </tr>
307
308  <tr>
309    <td valign="top"><a href="/www/command-line-options.html#channel">-channel <em class="option">type</em></a></td>
310    <td valign="top">apply option to select image channels</td>
311  </tr>
312
313  <tr>
314    <td valign="top"><a href="/www/command-line-options.html#colors">-colors <em class="option">value</em></a></td>
315    <td valign="top">preferred number of colors in the image</td>
316  </tr>
317
318  <tr>
319    <td valign="top"><a href="/www/command-line-options.html#colorspace">-colorspace <em class="option">type</em></a></td>
320    <td valign="top">set image colorspace</td>
321  </tr>
322
323  <tr>
324    <td valign="top"><a href="/www/command-line-options.html#comment">-comment <em class="option">string</em></a></td>
325    <td valign="top">annotate image with comment</td>
326  </tr>
327
328  <tr>
329    <td valign="top"><a href="/www/command-line-options.html#compose">-compose <em class="option">operator</em></a></td>
330    <td valign="top">set image composite operator</td>
331  </tr>
332
333  <tr>
334    <td valign="top"><a href="/www/command-line-options.html#compress">-compress <em class="option">type</em></a></td>
335    <td valign="top">image compression type</td>
336  </tr>
337
338  <tr>
339    <td valign="top"><a href="/www/command-line-options.html#debug">-debug <em class="option">events</em></a></td>
340    <td valign="top">display copious debugging information</td>
341  </tr>
342
343  <tr>
344    <td valign="top"><a href="/www/command-line-options.html#decipher">-decipher <em class="option">filename</em></a></td>
345    <td valign="top">convert cipher pixels to plain</td>
346  </tr>
347
348  <tr>
349    <td valign="top"><a href="/www/command-line-options.html#define">-define <em class="option">format:option</em></a></td>
350    <td valign="top">define one or more image format options</td>
351  </tr>
352
353  <tr>
354    <td valign="top"><a href="/www/command-line-options.html#density">-density <em class="option">geometry</em></a></td>
355    <td valign="top">horizontal and vertical density of the image</td>
356  </tr>
357
358  <tr>
359    <td valign="top"><a href="/www/command-line-options.html#depth">-depth <em class="option">value</em></a></td>
360    <td valign="top">image depth</td>
361  </tr>
362
363  <tr>
364    <td valign="top"><a href="/www/command-line-options.html#displace">-displace <em class="option">geometry</em></a></td>
365    <td valign="top">shift image pixels defined by a displacement map</td>
366  </tr>
367
368  <tr>
369    <td valign="top"><a href="/www/command-line-options.html#dissolve">-dissolve <em class="option">value</em></a></td>
370    <td valign="top">dissolve the two images a given percent</td>
371  </tr>
372
373  <tr>
374    <td valign="top"><a href="/www/command-line-options.html#dither">-dither  <em class="option">method</em></a></td>
375    <td valign="top">apply error diffusion to image</td>
376  </tr>
377
378  <tr>
379    <td valign="top"><a href="/www/command-line-options.html#encipher">-encipher <em class="option">filename</em></a></td>
380    <td valign="top">convert plain pixels to cipher pixels</td>
381  </tr>
382
383  <tr>
384    <td valign="top"><a href="/www/command-line-options.html#encoding">-encoding <em class="option">type</em></a></td>
385    <td valign="top">text encoding type</td>
386  </tr>
387
388  <tr>
389    <td valign="top"><a href="/www/command-line-options.html#endian">-endian <em class="option">type</em></a></td>
390    <td valign="top">endianness (MSB or LSB) of the image</td>
391  </tr>
392
393  <tr>
394    <td valign="top"><a href="/www/command-line-options.html#extract">-extract <em class="option">geometry</em></a></td>
395    <td valign="top">extract area from image</td>
396  </tr>
397
398  <tr>
399    <td valign="top"><a href="/www/command-line-options.html#filter">-filter <em class="option">type</em></a></td>
400    <td valign="top">use this filter when resizing an image</td>
401  </tr>
402
403  <tr>
404    <td valign="top"><a href="/www/command-line-options.html#font">-font <em class="option">name</em></a></td>
405    <td valign="top">render text with this font</td>
406  </tr>
407
408  <tr>
409    <td valign="top"><a href="/www/command-line-options.html#geometry">-geometry <em class="option">geometry</em></a></td>
410    <td valign="top">preferred size or location of the image</td>
411  </tr>
412
413  <tr>
414    <td valign="top"><a href="/www/command-line-options.html#gravity">-gravity <em class="option">type</em></a></td>
415    <td valign="top">horizontal and vertical text placement</td>
416  </tr>
417
418  <tr>
419    <td valign="top"><a href="/www/command-line-options.html#green-primary">-green-primary <em class="option">point</em></a></td>
420    <td valign="top">chromaticity green primary point</td>
421  </tr>
422
423  <tr>
424    <td valign="top"><a href="/www/command-line-options.html#help">-help</a></td>
425    <td valign="top">print program options</td>
426  </tr>
427
428  <tr>
429    <td valign="top"><a href="/www/command-line-options.html#identify">-identify</a></td>
430    <td valign="top">identify the format and characteristics of the image</td>
431  </tr>
432
433  <tr>
434    <td valign="top"><a href="/www/command-line-options.html#interlace">-interlace <em class="option">type</em></a></td>
435    <td valign="top">type of image interlacing scheme</td>
436  </tr>
437
438  <tr>
439    <td valign="top"><a href="/www/command-line-options.html#interpolate">-interpolate <em class="option">method</em></a></td>
440    <td valign="top">pixel color interpolation method</td>
441  </tr>
442
443  <tr>
444    <td valign="top"><a href="/www/command-line-options.html#label">-label <em class="option">string</em></a></td>
445    <td valign="top">assign a label to an image</td>
446  </tr>
447
448  <tr>
449    <td valign="top"><a href="/www/command-line-options.html#level">-level <em class="option">value</em></a></td>
450    <td valign="top">adjust the level of image contrast</td>
451  </tr>
452
453  <tr>
454    <td valign="top"><a href="/www/command-line-options.html#limit">-limit <em class="option">type value</em></a></td>
455    <td valign="top">pixel cache resource limit</td>
456  </tr>
457
458  <tr>
459    <td valign="top"><a href="/www/command-line-options.html#log">-log <em class="option">format</em></a></td>
460    <td valign="top">format of debugging information</td>
461  </tr>
462
463  <tr>
464    <td valign="top"><a href="/www/command-line-options.html#monitor">-monitor</a></td>
465    <td valign="top">monitor progress</td>
466  </tr>
467
468  <tr>
469    <td valign="top"><a href="/www/command-line-options.html#monochrome">-monochrome</a></td>
470    <td valign="top">transform image to black and white</td>
471  </tr>
472
473  <tr>
474    <td valign="top"><a href="/www/command-line-options.html#negate">-negate</a></td>
475    <td valign="top">replace each pixel with its complementary color </td>
476  </tr>
477
478  <tr>
479    <td valign="top"><a href="/www/command-line-options.html#page">-page <em class="option">geometry</em></a></td>
480    <td valign="top">size and location of an image canvas (setting)</td>
481  </tr>
482
483  <tr>
484    <td valign="top"><a href="/www/command-line-options.html#pointsize">-pointsize <em class="option">value</em></a></td>
485    <td valign="top">font point size</td>
486  </tr>
487
488  <tr>
489    <td valign="top"><a href="/www/command-line-options.html#profile">-profile <em class="option">filename</em></a></td>
490    <td valign="top">add, delete, or apply an image profile</td>
491  </tr>
492
493  <tr>
494    <td valign="top"><a href="/www/command-line-options.html#quality">-quality <em class="option">value</em></a></td>
495    <td valign="top">JPEG/MIFF/PNG compression level</td>
496  </tr>
497
498  <tr>
499    <td valign="top"><a href="/www/command-line-options.html#quantize">-quantize <em class="option">colorspace</em></a></td>
500    <td valign="top">reduce image colors in this colorspace</td>
501  </tr>
502
503  <tr>
504    <td valign="top"><a href="/www/command-line-options.html#quiet">-quiet</a></td>
505    <td valign="top">suppress all warning messages</td>
506  </tr>
507
508  <tr>
509    <td valign="top"><a href="/www/command-line-options.html#red-primary">-red-primary <em class="option">point</em></a></td>
510    <td valign="top">chromaticity red primary point</td>
511  </tr>
512
513  <tr>
514    <td valign="top"><a href="/www/command-line-options.html#regard-warnings">-regard-warnings</a></td>
515    <td valign="top">pay attention to warning messages.</td>
516  </tr>
517
518  <tr>
519    <td valign="top"><a href="/www/command-line-options.html#respect-parentheses">-respect-parentheses</a></td>
520    <td valign="top">settings remain in effect until parenthesis boundary.</td>
521  </tr>
522
523  <tr>
524    <td valign="top"><a href="/www/command-line-options.html#rotate">-rotate <em class="option">degrees</em></a></td>
525    <td valign="top">apply Paeth rotation to the image</td>
526  </tr>
527
528  <tr>
529    <td valign="top"><a href="/www/command-line-options.html#sampling-factor">-sampling-factor <em class="option">geometry</em></a></td>
530    <td valign="top">horizontal and vertical sampling factor</td>
531  </tr>
532
533  <tr>
534    <td valign="top"><a href="/www/command-line-options.html#scene">-scene <em class="option">value</em></a></td>
535    <td valign="top">image scene number</td>
536  </tr>
537
538  <tr>
539    <td valign="top"><a href="/www/command-line-options.html#seed">-seed <em class="option">value</em></a></td>
540    <td valign="top">seed a new sequence of pseudo-random numbers</td>
541  </tr>
542
543  <tr>
544    <td valign="top"><a href="/www/command-line-options.html#set">-set <em class="option">attribute value</em></a></td>
545    <td valign="top">set an image attribute</td>
546  </tr>
547
548  <tr>
549    <td valign="top"><a href="/www/command-line-options.html#sharpen">-sharpen <em class="option">geometry</em></a></td>
550    <td valign="top">sharpen the image</td>
551  </tr>
552
553  <tr>
554    <td valign="top"><a href="/www/command-line-options.html#shave">-shave <em class="option">geometry</em></a></td>
555    <td valign="top">shave pixels from the image edges</td>
556  </tr>
557
558  <tr>
559    <td valign="top"><a href="/www/command-line-options.html#size">-size <em class="option">geometry</em></a></td>
560    <td valign="top">width and height of image</td>
561  </tr>
562
563  <tr>
564    <td valign="top"><a href="/www/command-line-options.html#stegano">-stegano <em>offset</em></a></td>
565    <td valign="top">hide watermark within an image</td>
566  </tr>
567
568  <tr>
569    <td valign="top"><a href="/www/command-line-options.html#stereo">-stereo <em class="option">geometry</em></a></td>
570    <td valign="top">combine two image to create a stereo anaglyph</td>
571  </tr>
572
573  <tr>
574    <td valign="top"><a href="/www/command-line-options.html#strip">-strip</a></td>
575    <td valign="top">strip image of all profiles and comments</td>
576  </tr>
577
578  <tr>
579    <td valign="top"><a href="/www/command-line-options.html#swap">-swap <em class="option">indexes</em></a></td>
580    <td valign="top">swap two images in the image sequence</td>
581  </tr>
582
583  <tr>
584    <td valign="top"><a href="/www/command-line-options.html#synchronize">-synchronize</a></td>
585    <td valign="top">synchronize image to storage device</td>
586  </tr>
587
588  <tr>
589    <td valign="top"><a href="/www/command-line-options.html#taint">-taint</a></td>
590    <td valign="top">mark the image as modified</td>
591  </tr>
592
593  <tr>
594    <td valign="top"><a href="/www/command-line-options.html#thumbnail">-thumbnail <em class="option">geometry</em></a></td>
595    <td valign="top">create a thumbnail of the image</td>
596  </tr>
597
598  <tr>
599    <td valign="top"><a href="/www/command-line-options.html#tile">-tile</a></td>
600    <td valign="top">repeat composite operation across and down image</td>
601  </tr>
602
603  <tr>
604    <td valign="top"><a href="/www/command-line-options.html#transform">-transform</a></td>
605    <td valign="top">affine transform image</td>
606  </tr>
607
608  <tr>
609    <td valign="top"><a href="/www/command-line-options.html#transparent-color">-transparent-color <em class="option">color</em></a></td>
610    <td valign="top">transparent color</td>
611  </tr>
612
613  <tr>
614    <td valign="top"><a href="/www/command-line-options.html#treedepth">-treedepth <em class="option">value</em></a></td>
615    <td valign="top">color tree depth</td>
616  </tr>
617
618  <tr>
619    <td valign="top"><a href="/www/command-line-options.html#type">-type <em class="option">type</em></a></td>
620    <td valign="top">image type</td>
621  </tr>
622
623  <tr>
624    <td valign="top"><a href="/www/command-line-options.html#units">-units <em class="option">type</em></a></td>
625    <td valign="top">the units of image resolution</td>
626  </tr>
627
628  <tr>
629    <td valign="top"><a href="/www/command-line-options.html#unsharp">-unsharp <em class="option">geometry</em></a></td>
630    <td valign="top">sharpen the image</td>
631  </tr>
632
633  <tr>
634    <td valign="top"><a href="/www/command-line-options.html#verbose">-verbose</a></td>
635    <td valign="top">print detailed information about the image</td>
636  </tr>
637
638  <tr>
639    <td valign="top"><a href="/www/command-line-options.html#version">-version</a></td>
640    <td valign="top">print version information</td>
641  </tr>
642
643  <tr>
644    <td valign="top"><a href="/www/command-line-options.html#virtual-pixel">-virtual-pixel <em class="option">method</em></a></td>
645    <td valign="top">access method for pixels outside the boundaries of the image</td>
646  </tr>
647
648  <tr>
649    <td valign="top"><a href="/www/command-line-options.html#watermark">-watermark <em class="option">geometry</em></a></td>
650    <td valign="top">percent brightness and saturation of a watermark</td>
651  </tr>
652
653  <tr>
654    <td valign="top"><a href="/www/command-line-options.html#white-point">-white-point <em class="option">point</em></a></td>
655    <td valign="top">chromaticity white point</td>
656  </tr>
657
658  <tr>
659    <td valign="top"><a href="/www/command-line-options.html#white-threshold">-white-threshold <em class="option">value</em></a></td>
660    <td valign="top">force all pixels above the threshold into white</td>
661  </tr>
662
663  <tr>
664    <td valign="top"><a href="/www/command-line-options.html#write">-write <em class="option">filename</em></a></td>
665    <td valign="top">write images to this file</td>
666  </tr>
667
668  </tbody>
669</table>
670
671</div>
672
673<div id="linkbar">
674    <span id="linkbar-west">&nbsp;</span>
675    <span id="linkbar-center">
676      <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
677      <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
678    </span>
679    <span id="linkbar-east">&nbsp;</span>
680  </div>
681  <div class="footer">
682    <span id="footer-west">&copy; 1999-2012 ImageMagick Studio LLC</span>
683    <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
684  </div>
685  <div style="clear: both; margin: 0; width: 100%; "></div>
686  <script type="text/javascript">
687    var _gaq = _gaq || [];
688    _gaq.push(['_setAccount', 'UA-17690367-1']);
689    _gaq.push(['_trackPageview']);
690
691    (function() {
692      var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
693      ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
694      var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
695    })();
696  </script>
697</body>
698</html>
699