2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
\r
3 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
\r
4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
\r
6 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
\r
7 <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U="/>
\r
8 <title>ImageMagick: Command-line Tools: Convert</title/>
9 <meta http-equiv="Content-Language" content="en-US"/>
10 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
11 <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
12 <meta name="Application-name" content="ImageMagick"/>
13 <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."/>
14 <meta name="Application-url" content="http://www.imagemagick.org"/>
15 <meta name="Generator" content="PHP"/>
16 <meta name="Keywords" content="command-line, tools:, convert, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
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-2010 ImageMagick Studio LLC"/>
24 <meta name="Distribution" content="Global"/>
25 <link rel="icon" href="../images/wand.png" sizes="32x32"/>
26 <link rel="shortcut icon" href="../images/wand.ico" type="images/x-icon"/>
27 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
\r
28 <style type="text/css" media="all">
\r
29 @import url("../www/magick.css");
\r
33 <body id="www-imagemagick-org">
\r
34 <div class="titlebar">
\r
35 <a href="../index.html">
\r
36 <img src="../images/script.png" alt="[ImageMagick]"
\r
37 style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
\r
38 <a href="http://www.networkredux.com">
\r
39 <img src="../images/networkredux.png" alt="[sponsor]"
\r
40 style="margin: 45px auto; border: 0px; float: left;" /></a>
\r
41 <a href="http://www.imagemagick.org/discourse-server/">
\r
42 <img src="../images/logo.jpg" alt=""
\r
43 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
\r
44 <a href="../index.html">
\r
45 <img src="../images/sprite.jpg" alt=""
\r
46 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
\r
49 <div class="westbar">
\r
52 <a title="About ImageMagick" href="../index.html">About ImageMagick</a>
54 <div class="sep"></div>
\r
56 <a title="Binary Releases" href="../www/binary-releases.html">Binary Releases</a>
59 <a title="Binary Release: Unix" href="../www/binary-releases.html#unix">Unix</a>
62 <a title="Binary Release: MacOS X" href="../www/binary-releases.html#macosx">Mac OS X</a>
65 <a title="Binary Release: Windows" href="../www/binary-releases.html#windows">Windows</a>
67 <div class="sep"></div>
\r
69 <a title="Command-line Tools" href="../www/command-line-tools.html">Command-line Tools</a>
72 <a title="Command-line Tools: Processing" href="../www/command-line-processing.html">Processing</a>
75 <a title="Command-line Tools: Options" href="../www/command-line-options.html">Options</a>
78 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
81 <a title="Program Interfaces" href="../www/api.html">Program Interfaces</a>
84 <a title="Program Interface: MagickWand" href="../www/magick-wand.html">MagickWand</a>
87 <a title="Program Interface: MagickCore" href="../www/magick-core.html">MagickCore</a>
90 <a title="Program Interface: PerlMagick" href="../www/perl-magick.html">PerlMagick</a>
93 <a title="Program Interface: Magick++" href="../Magick++/">Magick++</a>
95 <div class="sep"></div>
\r
97 <a title="Install from Source" href="../www/install-source.html">Install from Source</a>
100 <a title="Install from Source: Unix" href="../www/install-source.html#unix">Unix</a>
103 <a title="Install from Source: Windows" href="../www/install-source.html#windows">Windows</a>
106 <a title="Resources" href="../www/resources.html">Resources</a>
109 <a title="Architecture" href="../www/architecture.html">Architecture</a>
112 <a title="Download" href="../www/download.html">Download</a>
114 <div class="sep"></div>
\r
116 <a title="Search" href="http://www.imagemagick.org/script/search.php">Search</a>
118 <div class="sep"></div>
\r
120 <a title="Site Map"href="../www/sitemap.html">Site Map</a>
123 <a title="Site Map: Links"href="../www/links.html">Links</a>
125 <div class="sep"></div>
\r
127 <a title="Sponsors" href="../www/sponsors.html">Sponsors:</a>
129 <div class="sponsbox">
130 <div class="sponsor">
131 <a title="Sponsor: Free Catalogs" href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 20120801000600 -->
133 <div class="sponsor">
134 <a title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
136 <div class="sponsor">
137 <a title="Sponsor: Image Converter" href="http://www.batchphoto.com">Image Converter</a><!-- 201103010900 Bits Coffee-->
139 <div class="sponsor">
140 <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
142 <div class="sponsor">
143 <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
145 <div class="sponsor">
146 <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
148 <div class="sponsor">
149 <a title="Sponsor: Diamonds are a Girls Best Friend" href="http://www.schmuck.org">Diamonds are a Girls Best Friend</a><!-- 201101010600 Peterssen-->
155 <div class="eastbar">
\r
156 <script type="text/javascript">
\r
158 google_ad_client = "pub-3129977114552745";
\r
159 google_ad_slot = "0574824969";
\r
160 google_ad_width = 160;
\r
161 google_ad_height = 600;
\r
164 <script type="text/javascript"
\r
165 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
\r
171 <p class="navigation-index">[<a href="#usage">Example Usage</a> • <a href="#options">Option Summary</a>]</p>
173 <div class="doc-section">
174 <p>Use the <kbd>convert</kbd> program to convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. See <a href="../www/command-line-processing.html">Command Line Processing</a> for advice on how to structure your <kbd>convert</kbd> command or see below for example usages of the command.</p>
177 <h2><a name="usage"></a>Example Usage</h2>
178 <div class="doc-section">
180 <p>We list a few examples of the <kbd>convert</kbd> command here to illustrate its usefulness and ease of use. To get started, lets convert an image in the JPEG format to PNG:</p>
182 <p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert rose.jpg rose.png</span></p>
183 <p>Next, we reduce the image size before it is written to the PNG format:</p>
185 <p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert rose.jpg -resize 50% rose.png</span></p>
187 <a href="../images/rose.jpg">
188 <img src="../images/rose.jpg" width="70" height="46" alt="rose" />
190 <img style="margin-top:13px; margin-bottom:13px;" src="../images/right.gif" width="20" height="20" alt="==>" />
191 <a href="../images/rose.png">
192 <img style="margin-top:11px; margin-bottom:12px;" src="../images/rose.png" width="35" height="23" alt="rose" />
196 <p>You can combine multiple image-processing operations to produce complex results:</p>
198 <p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert -size 320x85 xc:transparent -font Bookman-DemiItalic -pointsize 72 \ <br/>
199 -draw "text 25,60 'Magick'" -channel RGBA -blur 0x6 -fill darkred -stroke magenta \ <br/>
200 -draw "text 20,55 'Magick'" fuzzy-magick.png</span></p>
202 <a href="../images/fuzzy-magick.png"><img src="../images/fuzzy-magick.png" width="320" height="85" alt="fuzzy-magick" /></a>
205 <p>You can find additional examples of using <kbd>convert</kbd> in <a href="http://www.imagemagick.org/Usage/">Examples of ImageMagick Usage</a>.</p>
209 <h2><a name="options"></a>Option Summary</h2>
210 <div class="doc-section">
212 <p>The <kbd>convert</kbd> command recognizes these options. Click on an option to get more details about how that option works.</p>
217 <th align="left">Option</th>
218 <th align="left">Description</th>
222 <td valign="top"><a href="../www/command-line-options.html#adaptive-blur">-adaptive-blur <em class="option">geometry</em></a></td>
223 <td valign="top">adaptively blur pixels; decrease effect near edges</td>
227 <td valign="top"><a href="../www/command-line-options.html#adaptive-resize">-adaptive-resize <em class="option">geometry</em></a></td>
228 <td valign="top">adaptively resize image with data dependent triangulation.</td>
232 <td valign="top"><a href="../www/command-line-options.html#adaptive-sharpen">-adaptive-sharpen <em class="option">geometry</em></a></td>
233 <td valign="top">adaptively sharpen pixels; increase effect near edges</td>
237 <td valign="top"><a href="../www/command-line-options.html#adjoin">-adjoin</a></td>
238 <td valign="top">join images into a single multi-image file</td>
242 <td valign="top"><a href="../www/command-line-options.html#affine">-affine <em class="option">matrix</em></a></td>
243 <td valign="top">affine transform matrix</td>
247 <td valign="top"><a href="../www/command-line-options.html#alpha">-alpha</a></td>
248 <td valign="top">on, activate, off, deactivate, set, opaque, copy",
249 transparent, extract, background, or shape the alpha channel</td>
253 <td valign="top"><a href="../www/command-line-options.html#annotate">-annotate <em class="option">geometry text</em></a></td>
254 <td valign="top">annotate the image with text</td>
258 <td valign="top"><a href="../www/command-line-options.html#antialias">-antialias</a></td>
259 <td valign="top">remove pixel-aliasing</td>
263 <td valign="top"><a href="../www/command-line-options.html#append">-append</a></td>
264 <td valign="top">append an image sequence</td>
268 <td valign="top"><a href="../www/command-line-options.html#authenticate">-authenticate <em class="option">value</em></a></td>
269 <td valign="top">decipher image with this password</td>
273 <td valign="top"><a href="../www/command-line-options.html#auto-gamma">-auto-gamma</a></td>
274 <td valign="top">automagically adjust gamma level of image</td>
278 <td valign="top"><a href="../www/command-line-options.html#auto-level">-auto-level</a></td>
279 <td valign="top">automagically adjust color levels of image</td>
283 <td valign="top"><a href="../www/command-line-options.html#auto-orient">-auto-orient</a></td>
284 <td valign="top">automagically orient image</td>
288 <td valign="top"><a href="../www/command-line-options.html#background">-background <em class="option">color</em></a></td>
289 <td valign="top">background color</td>
293 <td valign="top"><a href="../www/command-line-options.html#bench">-bench <em class="option">iterations</em></a></td>
294 <td valign="top">measure performance</td>
298 <td valign="top"><a href="../www/command-line-options.html#bias">-bias <em class="option">value</em></a></td>
299 <td valign="top">add bias when convolving an image</td>
303 <td valign="top"><a href="../www/command-line-options.html#black-threshold">-black-threshold <em class="option">value</em></a></td>
304 <td valign="top">force all pixels below the threshold into black</td>
308 <td valign="top"><a href="../www/command-line-options.html#blue-primary">-blue-primary <em class="option">point</em></a></td>
309 <td valign="top">chromaticity blue primary point</td>
313 <td valign="top"><a href="../www/command-line-options.html#blue-shift">-blue-shift <em class="option">factor</em></a></td>
314 <td valign="top">simulate a scene at nighttime in the moonlight</td>
318 <td valign="top"><a href="../www/command-line-options.html#blur">-blur <em class="option">geometry</em></a></td>
319 <td valign="top">reduce image noise and reduce detail levels</td>
323 <td valign="top"><a href="../www/command-line-options.html#border">-border <em class="option">geometry</em></a></td>
324 <td valign="top">surround image with a border of color</td>
328 <td valign="top"><a href="../www/command-line-options.html#bordercolor">-bordercolor <em class="option">color</em></a></td>
329 <td valign="top">border color</td>
333 <td valign="top"><a href="../www/command-line-options.html#brightness-contrast">-brightness-contrast <em class="option">geometry</em></a></td>
334 <td valign="top">improve brightness / contrast of the image</td>
338 <td valign="top"><a href="../www/command-line-options.html#caption">-caption <em class="option">string</em></a></td>
339 <td valign="top">assign a caption to an image</td>
343 <td valign="top"><a href="../www/command-line-options.html#cdl">-cdl <em class="option">filename</em></a></td>
344 <td valign="top">color correct with a color decision list</td>
348 <td valign="top"><a href="../www/command-line-options.html#channel">-channel <em class="option">type</em></a></td>
349 <td valign="top">apply option to select image channels</td>
353 <td valign="top"><a href="../www/command-line-options.html#charcoal">-charcoal <em class="option">radius</em></a></td>
354 <td valign="top">simulate a charcoal drawing</td>
358 <td valign="top"><a href="../www/command-line-options.html#chop">-chop <em class="option">geometry</em></a></td>
359 <td valign="top">remove pixels from the image interior</td>
363 <td valign="top"><a href="../www/command-line-options.html#clamp">-clamp</a></td>
364 <td valign="top">restrict colors from 0 to the quantum depth</td>
368 <td valign="top"><a href="../www/command-line-options.html#clip">-clip</a></td>
369 <td valign="top">clip along the first path from the 8BIM profile</td>
373 <td valign="top"><a href="../www/command-line-options.html#clip-mask">-clip-mask</a> <em class="option">filename</em></td>
374 <td valign="top">associate clip mask with the image</td>
378 <td valign="top"><a href="../www/command-line-options.html#clip-path">-clip-path <em class="option">id</em></a></td>
379 <td valign="top">clip along a named path from the 8BIM profile</td>
383 <td valign="top"><a href="../www/command-line-options.html#clone">-clone <em class="option">index</em></a></td>
384 <td valign="top">clone an image</td>
388 <td valign="top"><a href="../www/command-line-options.html#clut">-clut</a></td>
389 <td valign="top">apply a color lookup table to the image</td>
393 <td valign="top"><a href="../www/command-line-options.html#contrast-stretch">-contrast-stretch <em class="option">geometry</em></a></td>
394 <td valign="top">improve the contrast in an image by `stretching' the range of intensity value</td>
398 <td valign="top"><a href="../www/command-line-options.html#coalesce">-coalesce</a></td>
399 <td valign="top">merge a sequence of images</td>
403 <td valign="top"><a href="../www/command-line-options.html#colorize">-colorize <em class="option">value</em></a></td>
404 <td valign="top">colorize the image with the fill color</td>
408 <td valign="top"><a href="../www/command-line-options.html#color-matrix">-color-matrix <em class="option">matrix</em></a></td>
409 <td valign="top">apply color correction to the image.</td>
413 <td valign="top"><a href="../www/command-line-options.html#colors">-colors <em class="option">value</em></a></td>
414 <td valign="top">preferred number of colors in the image</td>
418 <td valign="top"><a href="../www/command-line-options.html#colorspace">-colorspace <em class="option">type</em></a></td>
419 <td valign="top">set image colorspace</td>
423 <td valign="top"><a href="../www/command-line-options.html#combine">-combine</a></td>
424 <td valign="top">combine a sequence of images</td>
428 <td valign="top"><a href="../www/command-line-options.html#comment">-comment <em class="option">string</em></a></td>
429 <td valign="top">annotate image with comment</td>
433 <td valign="top"><a href="../www/command-line-options.html#compose">-compose <em class="option">operator</em></a></td>
434 <td valign="top">set image composite operator</td>
438 <td valign="top"><a href="../www/command-line-options.html#composite">-composite</a></td>
439 <td valign="top">composite image</td>
443 <td valign="top"><a href="../www/command-line-options.html#compress">-compress <em class="option">type</em></a></td>
444 <td valign="top">image compression type</td>
448 <td valign="top"><a href="../www/command-line-options.html#contrast">-contrast</a></td>
449 <td valign="top">enhance or reduce the image contrast</td>
453 <td valign="top"><a href="../www/command-line-options.html#convolve">-convolve <em class="option">coefficients</em></a></td>
454 <td valign="top">apply a convolution kernel to the image</td>
458 <td valign="top"><a href="../www/command-line-options.html#crop">-crop <em class="option">geometry</em></a></td>
459 <td valign="top">crop the image</td>
463 <td valign="top"><a href="../www/command-line-options.html#cycle">-cycle <em class="option">amount</em></a></td>
464 <td valign="top">cycle the image colormap</td>
468 <td valign="top"><a href="../www/command-line-options.html#decipher">-decipher <em class="option">filename</em></a></td>
469 <td valign="top">convert cipher pixels to plain</td>
473 <td valign="top"><a href="../www/command-line-options.html#debug">-debug <em class="option">events</em></a></td>
474 <td valign="top">display copious debugging information</td>
478 <td valign="top"><a href="../www/command-line-options.html#define">-define <em class="option">format:option</em></a></td>
479 <td valign="top">define one or more image format options</td>
483 <td valign="top"><a href="../www/command-line-options.html#deconstruct">-deconstruct</a></td>
484 <td valign="top">break down an image sequence into constituent parts</td>
488 <td valign="top"><a href="../www/command-line-options.html#delay">-delay <em class="option">value</em></a></td>
489 <td valign="top">display the next image after pausing</td>
493 <td valign="top"><a href="../www/command-line-options.html#delete">-delete <em class="option">index</em></a></td>
494 <td valign="top">delete the image from the image sequence</td>
498 <td valign="top"><a href="../www/command-line-options.html#density">-density <em class="option">geometry</em></a></td>
499 <td valign="top">horizontal and vertical density of the image</td>
503 <td valign="top"><a href="../www/command-line-options.html#depth">-depth <em class="option">value</em></a></td>
504 <td valign="top">image depth</td>
508 <td valign="top"><a href="../www/command-line-options.html#despeckle">-despeckle</a></td>
509 <td valign="top">reduce the speckles within an image</td>
513 <td valign="top"><a href="../www/command-line-options.html#direction">-direction <em class="option">type</em></a></td>
514 <td valign="top">render text right-to-left or left-to-right</td>
518 <td valign="top"><a href="../www/command-line-options.html#display">-display <em class="option">server</em></a></td>
519 <td valign="top">get image or font from this X server</td>
523 <td valign="top"><a href="../www/command-line-options.html#dispose">-dispose <em class="option">method</em></a></td>
524 <td valign="top">layer disposal method</td>
528 <td valign="top"><a href="../www/command-line-options.html#distort">-distort <em class="option">type coefficients</em></a></td>
529 <td valign="top">distort image</td>
533 <td valign="top"><a href="../www/command-line-options.html#dither">-dither <em class="option">method</em></a></td>
534 <td valign="top">apply error diffusion to image</td>
538 <td valign="top"><a href="../www/command-line-options.html#draw">-draw <em class="option">string</em></a></td>
539 <td valign="top">annotate the image with a graphic primitive</td>
543 <td valign="top"><a href="../www/command-line-options.html#edge">-edge <em class="option">radius</em></a></td>
544 <td valign="top">apply a filter to detect edges in the image</td>
548 <td valign="top"><a href="../www/command-line-options.html#emboss">-emboss <em class="option">radius</em></a></td>
549 <td valign="top">emboss an image</td>
553 <td valign="top"><a href="../www/command-line-options.html#encipher">-encipher <em class="option">filename</em></a></td>
554 <td valign="top">convert plain pixels to cipher pixels</td>
558 <td valign="top"><a href="../www/command-line-options.html#encoding">-encoding <em class="option">type</em></a></td>
559 <td valign="top">text encoding type</td>
563 <td valign="top"><a href="../www/command-line-options.html#endian">-endian <em class="option">type</em></a></td>
564 <td valign="top">endianness (MSB or LSB) of the image</td>
568 <td valign="top"><a href="../www/command-line-options.html#enhance">-enhance</a></td>
569 <td valign="top">apply a digital filter to enhance a noisy image</td>
573 <td valign="top"><a href="../www/command-line-options.html#equalize">-equalize</a></td>
574 <td valign="top">perform histogram equalization to an image</td>
578 <td valign="top"><a href="../www/command-line-options.html#evaluate">-evaluate <em class="option">operator value</em></a></td>
579 <td valign="top">evaluate an arithmetic, relational, or logical expression</td>
583 <td valign="top"><a href="../www/command-line-options.html#evaluate-sequence">-evaluate-sequence <em class="option">operator</em></a></td>
584 <td valign="top">evaluate an arithmetic, relational, or logical expression for an image sequence</td>
588 <td valign="top"><a href="../www/command-line-options.html#extent">-extent <em class="option">geometry</em></a></td>
589 <td valign="top">set the image size</td>
593 <td valign="top"><a href="../www/command-line-options.html#extract">-extract <em class="option">geometry</em></a></td>
594 <td valign="top">extract area from image</td>
598 <td valign="top"><a href="../www/command-line-options.html#family">-family <em class="option">name</em></a></td>
599 <td valign="top">render text with this font family</td>
603 <td valign="top"><a href="../www/command-line-options.html#fft">-fft</a></td>
604 <td valign="top">implments the discrete Fourier transform (DFT)</td>
608 <td valign="top"><a href="../www/command-line-options.html#fill">-fill <em class="option">color</em></a></td>
609 <td valign="top">color to use when filling a graphic primitive</td>
613 <td valign="top"><a href="../www/command-line-options.html#filter">-filter <em class="option">type</em></a></td>
614 <td valign="top">use this filter when resizing an image</td>
618 <td valign="top"><a href="../www/command-line-options.html#flatten">-flatten</a></td>
619 <td valign="top">flatten a sequence of images</td>
623 <td valign="top"><a href="../www/command-line-options.html#flip">-flip</a></td>
624 <td valign="top">flip image in the vertical direction</td>
628 <td valign="top"><a href="../www/command-line-options.html#floodfill">-floodfill <em class="option">geometry color</em></a></td>
629 <td valign="top">floodfill the image with color</td>
633 <td valign="top"><a href="../www/command-line-options.html#flop">-flop</a></td>
634 <td valign="top">flop image in the horizontal direction</td>
638 <td valign="top"><a href="../www/command-line-options.html#font">-font <em class="option">name</em></a></td>
639 <td valign="top">render text with this font</td>
643 <td valign="top"><a href="../www/command-line-options.html#format_identify_">-format <em class="option">string</em></a></td>
644 <td valign="top">output formatted image characteristics</td>
648 <td valign="top"><a href="../www/command-line-options.html#frame">-frame <em class="option">geometry</em></a></td>
649 <td valign="top">surround image with an ornamental border</td>
653 <td valign="top"><a href="../www/command-line-options.html#function">-function <em class="option">name</em></a></td>
654 <td valign="top">apply a function to the image</td>
658 <td valign="top"><a href="../www/command-line-options.html#fuzz">-fuzz <em class="option">distance</em></a></td>
659 <td valign="top">colors within this distance are considered equal</td>
663 <td valign="top"><a href="../www/command-line-options.html#fx">-fx <em class="option">expression</em></a></td>
664 <td valign="top">apply mathematical expression to an image channel(s)</td>
668 <td valign="top"><a href="../www/command-line-options.html#gamma">-gamma <em class="option">value</em></a></td>
669 <td valign="top">level of gamma correction</td>
673 <td valign="top"><a href="../www/command-line-options.html#gaussian-blur">-gaussian-blur <em class="option">geometry</em></a></td>
674 <td valign="top">reduce image noise and reduce detail levels</td>
678 <td valign="top"><a href="../www/command-line-options.html#geometry">-geometry <em class="option">geometry</em></a></td>
679 <td valign="top">preferred size or location of the image</td>
683 <td valign="top"><a href="../www/command-line-options.html#gravity">-gravity <em class="option">type</em></a></td>
684 <td valign="top">horizontal and vertical text placement</td>
688 <td valign="top"><a href="../www/command-line-options.html#green-primary">-green-primary <em class="option">point</em></a></td>
689 <td valign="top">chromaticity green primary point</td>
693 <td valign="top"><a href="../www/command-line-options.html#help">-help</a></td>
694 <td valign="top">print program options</td>
698 <td valign="top"><a href="../www/command-line-options.html#identify">-identify</a></td>
699 <td valign="top">identify the format and characteristics of the image</td>
703 <td valign="top"><a href="../www/command-line-options.html#ift">-ift</a></td>
704 <td valign="top">implements the inverse discrete Fourier transform (DFT)</td>
708 <td valign="top"><a href="../www/command-line-options.html#implode">-implode <em class="option">amount</em></a></td>
709 <td valign="top">implode image pixels about the center</td>
713 <td valign="top"><a href="../www/command-line-options.html#insert">-insert <em class="option">index</em></a></td>
714 <td valign="top">insert last image into the image sequence</td>
718 <td valign="top"><a href="../www/command-line-options.html#intent">-intent <em class="option">type</em></a></td>
719 <td valign="top">type of rendering intent when managing the image color</td>
723 <td valign="top"><a href="../www/command-line-options.html#interlace">-interlace <em class="option">type</em></a></td>
724 <td valign="top">type of image interlacing scheme</td>
728 <td valign="top"><a href="../www/command-line-options.html#interline-spacing">-interline-spacing <em class="option">value</em></a></td>
729 <td valign="top">the space between two text lines</td>
733 <td valign="top"><a href="../www/command-line-options.html#interpolate">-interpolate <em class="option">method</em></a></td>
734 <td valign="top">pixel color interpolation method</td>
738 <td valign="top"><a href="../www/command-line-options.html#interword-spacing">-interword-spacing <em class="option">value</em></a></td>
739 <td valign="top">the space between two words</td>
743 <td valign="top"><a href="../www/command-line-options.html#kerning">-kerning <em class="option">value</em></a></td>
744 <td valign="top">the space between two characters</td>
748 <td valign="top"><a href="../www/command-line-options.html#label">-label <em class="option">string</em></a></td>
749 <td valign="top">assign a label to an image</td>
753 <td valign="top"><a href="../www/command-line-options.html#lat">-lat <em class="option">geometry</em></a></td>
754 <td valign="top">local adaptive thresholding</td>
758 <td valign="top"><a href="../www/command-line-options.html#layers">-layers <em class="option">method</em></a></td>
759 <td valign="top">optimize or compare image layers</td>
763 <td valign="top"><a href="../www/command-line-options.html#level">-level <em class="option">value</em></a></td>
764 <td valign="top">adjust the level of image contrast</td>
768 <td valign="top"><a href="../www/command-line-options.html#limit">-limit <em class="option">type value</em></a></td>
769 <td valign="top">pixel cache resource limit</td>
773 <td valign="top"><a href="../www/command-line-options.html#linear-stretch">-linear-stretch <em class="option">geometry</em></a></td>
774 <td valign="top">linear with saturation histogram stretch</td>
778 <td valign="top"><a href="../www/command-line-options.html#liquid-rescale">-liquid-rescale <em class="option">geometry</em></a></td>
779 <td valign="top">rescale image with seam-carving</td>
783 <td valign="top"><a href="../www/command-line-options.html#log">-log <em class="option">format</em></a></td>
784 <td valign="top">format of debugging information</td>
788 <td valign="top"><a href="../www/command-line-options.html#loop">-loop <em class="option">iterations</em></a></td>
789 <td valign="top">add Netscape loop extension to your GIF animation</td>
793 <td valign="top"><a href="../www/command-line-options.html#mask">-mask <em class="option">filename</em></a></td>
794 <td valign="top">associate a mask with the image</td>
798 <td valign="top"><a href="../www/command-line-options.html#mattecolor">-mattecolor <em class="option">color</em></a></td>
799 <td valign="top">frame color</td>
803 <td valign="top"><a href="../www/command-line-options.html#median">-median <em class="option">radius</em></a></td>
804 <td valign="top">apply a median filter to the image</td>
808 <td valign="top"><a href="../www/command-line-options.html#modulate">-modulate <em class="option">value</em></a></td>
809 <td valign="top">vary the brightness, saturation, and hue</td>
813 <td valign="top"><a href="../www/command-line-options.html#monitor">-monitor</a></td>
814 <td valign="top">monitor progress</td>
818 <td valign="top"><a href="../www/command-line-options.html#monochrome">-monochrome</a></td>
819 <td valign="top">transform image to black and white</td>
823 <td valign="top"><a href="../www/command-line-options.html#morph">-morph <em class="option">value</em></a></td>
824 <td valign="top">morph an image sequence</td>
828 <td valign="top"><a href="../www/command-line-options.html#morphology">-morphology <em class="option">method</em></a> <em class="option">kernel</em></td>
829 <td valign="top">apply a morphology method to the image</td>
833 <td valign="top"><a href="../www/command-line-options.html#motion-blur">-motion-blur <em class="option">geometry</em></a></td>
834 <td valign="top">simulate motion blur</td>
838 <td valign="top"><a href="../www/command-line-options.html#negate">-negate</a></td>
839 <td valign="top">replace each pixel with its complementary color </td>
843 <td valign="top"><a href="../www/command-line-options.html#noise">-noise <em class="option">radius</em></a></td>
844 <td valign="top">add or reduce noise in an image</td>
848 <td valign="top"><a href="../www/command-line-options.html#normalize">-normalize</a></td>
849 <td valign="top">transform image to span the full range of colors</td>
853 <td valign="top"><a href="../www/command-line-options.html#opaque">-opaque <em class="option">color</em></a></td>
854 <td valign="top">change this color to the fill color</td>
858 <td valign="top"><a href="../www/command-line-options.html#ordered-dither">-ordered-dither <em class="option">NxN</em></a></td>
859 <td valign="top">ordered dither the image</td>
863 <td valign="top"><a href="../www/command-line-options.html#orient">-orient <em class="option">type</em></a></td>
864 <td valign="top">image orientation</td>
868 <td valign="top"><a href="../www/command-line-options.html#page">-page <em class="option">geometry</em></a></td>
869 <td valign="top">size and location of an image canvas (setting)</td>
873 <td valign="top"><a href="../www/command-line-options.html#paint">-paint <em class="option">radius</em></a></td>
874 <td valign="top">simulate an oil painting</td>
878 <td valign="top"><a href="../www/command-line-options.html#ping">-ping</a></td>
879 <td valign="top">efficiently determine image attributes</td>
883 <td valign="top"><a href="../www/command-line-options.html#pointsize">-pointsize <em class="option">value</em></a></td>
884 <td valign="top">font point size</td>
888 <td valign="top"><a href="../www/command-line-options.html#polaroid">-polaroid <em class="option">angle</em></a></td>
889 <td valign="top">simulate a Polaroid picture</td>
893 <td valign="top"><a href="../www/command-line-options.html#posterize">-posterize <em class="option">levels</em></a></td>
894 <td valign="top">reduce the image to a limited number of color levels</td>
898 <td valign="top"><a href="../www/command-line-options.html#precision">-precision <em class="option">value</em></a></td>
899 <td valign="top">set the maximum number of significant digits to be printed</td>
903 <td valign="top"><a href="../www/command-line-options.html#preview">-preview <em class="option">type</em></a></td>
904 <td valign="top">image preview type</td>
908 <td valign="top"><a href="../www/command-line-options.html#print">-print <em class="option">string</em></a></td>
909 <td valign="top">interpret string and print to console</td>
913 <td valign="top"><a href="../www/command-line-options.html#process">-process <em class="option">image-filter</em></a></td>
914 <td valign="top">process the image with a custom image filter</td>
918 <td valign="top"><a href="../www/command-line-options.html#profile">-profile <em class="option">filename</em></a></td>
919 <td valign="top">add, delete, or apply an image profile</td>
923 <td valign="top"><a href="../www/command-line-options.html#quality">-quality <em class="option">value</em></a></td>
924 <td valign="top">JPEG/MIFF/PNG compression level</td>
928 <td valign="top"><a href="../www/command-line-options.html#quantize">-quantize <em class="option">colorspace</em></a></td>
929 <td valign="top">reduce image colors in this colorspace</td>
933 <td valign="top"><a href="../www/command-line-options.html#quiet">-quiet</a></td>
934 <td valign="top">suppress all warning messages</td>
938 <td valign="top"><a href="../www/command-line-options.html#radial-blur">-radial-blur <em class="option">angle</em></a></td>
939 <td valign="top">radial blur the image</td>
943 <td valign="top"><a href="../www/command-line-options.html#raise">-raise <em class="option">value</em></a></td>
944 <td valign="top">lighten/darken image edges to create a 3-D effect</td>
948 <td valign="top"><a href="../www/command-line-options.html#random-threshold">-random-threshold <em class="option">low,high</em></a></td>
949 <td valign="top">random threshold the image</td>
953 <td valign="top"><a href="../www/command-line-options.html#red-primary">-red-primary <em class="option">point</em></a></td>
954 <td valign="top">chromaticity red primary point</td>
958 <td valign="top"><a href="../www/command-line-options.html#regard-warnings">-regard-warnings</a></td>
959 <td valign="top">pay attention to warning messages.</td>
963 <td valign="top"><a href="../www/command-line-options.html#region">-region <em class="option">geometry</em></a></td>
964 <td valign="top">apply options to a portion of the image</td>
968 <td valign="top"><a href="../www/command-line-options.html#remap">-remap <em class="option">filename</em></a></td>
969 <td valign="top">transform image colors to match this set of colors</td>
973 <td valign="top"><a href="../www/command-line-options.html#render">-render</a></td>
974 <td valign="top">render vector graphics</td>
978 <td valign="top"><a href="../www/command-line-options.html#repage">-repage <em class="option">geometry</em></a></td>
979 <td valign="top">size and location of an image canvas</td>
983 <td valign="top"><a href="../www/command-line-options.html#resample">-resample <em class="option">geometry</em></a></td>
984 <td valign="top">change the resolution of an image</td>
988 <td valign="top"><a href="../www/command-line-options.html#resize">-resize <em class="option">geometry</em></a></td>
989 <td valign="top">resize the image</td>
993 <td valign="top"><a href="../www/command-line-options.html#respect-parentheses">-respect-parentheses</a></td>
994 <td valign="top">settings remain in effect until parenthesis boundary.</td>
998 <td valign="top"><a href="../www/command-line-options.html#roll">-roll <em class="option">geometry</em></a></td>
999 <td valign="top">roll an image vertically or horizontally</td>
1003 <td valign="top"><a href="../www/command-line-options.html#rotate">-rotate <em class="option">degrees</em></a></td>
1004 <td valign="top">apply Paeth rotation to the image</td>
1008 <td valign="top"><a href="../www/command-line-options.html#sample">-sample <em class="option">geometry</em></a></td>
1009 <td valign="top">scale image with pixel sampling</td>
1013 <td valign="top"><a href="../www/command-line-options.html#sampling-factor">-sampling-factor <em class="option">geometry</em></a></td>
1014 <td valign="top">horizontal and vertical sampling factor</td>
1018 <td valign="top"><a href="../www/command-line-options.html#scale">-scale <em class="option">geometry</em></a></td>
1019 <td valign="top">scale the image</td>
1023 <td valign="top"><a href="../www/command-line-options.html#scene">-scene <em class="option">value</em></a></td>
1024 <td valign="top">image scene number</td>
1028 <td valign="top"><a href="../www/command-line-options.html#seed">-seed <em class="option">value</em></a></td>
1029 <td valign="top">seed a new sequence of pseudo-random numbers</td>
1033 <td valign="top"><a href="../www/command-line-options.html#segment">-segment <em class="option">values</em></a></td>
1034 <td valign="top">segment an image</td>
1038 <td valign="top"><a href="../www/command-line-options.html#threshold">-selective-blur <em class="option">geometry</em></a></td>
1039 <td valign="top">selectively blur pixels within a contrast threshold</td>
1043 <td valign="top"><a href="../www/command-line-options.html#separate">-separate</a></td>
1044 <td valign="top">separate an image channel into a grayscale image</td>
1048 <td valign="top"><a href="../www/command-line-options.html#sepia-tone">-sepia-tone <em class="option">threshold</em></a></td>
1049 <td valign="top">simulate a sepia-toned photo</td>
1053 <td valign="top"><a href="../www/command-line-options.html#set">-set <em class="option">attribute value</em></a></td>
1054 <td valign="top">set an image attribute</td>
1058 <td valign="top"><a href="../www/command-line-options.html#shade">-shade <em class="option">degrees</em></a></td>
1059 <td valign="top">shade the image using a distant light source</td>
1063 <td valign="top"><a href="../www/command-line-options.html#shadow">-shadow <em class="option">geometry</em></a></td>
1064 <td valign="top">simulate an image shadow</td>
1068 <td valign="top"><a href="../www/command-line-options.html#sharpen">-sharpen <em class="option">geometry</em></a></td>
1069 <td valign="top">sharpen the image</td>
1073 <td valign="top"><a href="../www/command-line-options.html#shave">-shave <em class="option">geometry</em></a></td>
1074 <td valign="top">shave pixels from the image edges</td>
1078 <td valign="top"><a href="../www/command-line-options.html#shear">-shear <em class="option">geometry</em></a></td>
1079 <td valign="top">slide one edge of the image along the X or Y axis</td>
1083 <td valign="top"><a href="../www/command-line-options.html#sigmoidal">-sigmoidal-contrast <em class="option">geometry</em></a></td>
1084 <td valign="top">increase the contrast without saturating highlights or shadows</td>
1088 <td valign="top"><a href="../www/command-line-options.html#size">-size <em class="option">geometry</em></a></td>
1089 <td valign="top">width and height of image</td>
1093 <td valign="top"><a href="../www/command-line-options.html#sketch">-sketch <em class="option">geometry</em></a></td>
1094 <td valign="top">simulate a pencil sketch</td>
1098 <td valign="top"><a href="../www/command-line-options.html#solarize">-solarize <em class="option">threshold</em></a></td>
1099 <td valign="top">negate all pixels above the threshold level</td>
1103 <td valign="top"><a href="../www/command-line-options.html#splice">-splice <em class="option">geometry</em></a></td>
1104 <td valign="top">splice the background color into the image</td>
1108 <td valign="top"><a href="../www/command-line-options.html#spread">-spread <em class="option">radius</em></a></td>
1109 <td valign="top">displace image pixels by a random amount</td>
1113 <td valign="top"><a href="../www/command-line-options.html#strip">-strip</a></td>
1114 <td valign="top">strip image of all profiles and comments</td>
1118 <td valign="top"><a href="../www/command-line-options.html#stroke">-stroke <em class="option">color</em></a></td>
1119 <td valign="top">graphic primitive stroke color</td>
1123 <td valign="top"><a href="../www/command-line-options.html#strokewidth">-strokewidth <em class="option">value</em></a></td>
1124 <td valign="top">graphic primitive stroke width</td>
1128 <td valign="top"><a href="../www/command-line-options.html#stretch">-stretch <em class="option">type</em></a></td>
1129 <td valign="top">render text with this font stretch</td>
1133 <td valign="top"><a href="../www/command-line-options.html#style">-style <em class="option">type</em></a></td>
1134 <td valign="top">render text with this font style</td>
1138 <td valign="top"><a href="../www/command-line-options.html#swap">-swap <em class="option">indexes</em></a></td>
1139 <td valign="top">swap two images in the image sequence</td>
1143 <td valign="top"><a href="../www/command-line-options.html#swirl">-swirl <em class="option">degrees</em></a></td>
1144 <td valign="top">swirl image pixels about the center</td>
1148 <td valign="top"><a href="../www/command-line-options.html#synchronize">-synchronize</a></td>
1149 <td valign="top">synchronize image to storage device</td>
1153 <td valign="top"><a href="../www/command-line-options.html#taint">-taint</a></td>
1154 <td valign="top">mark the image as modified</td>
1158 <td valign="top"><a href="../www/command-line-options.html#texture">-texture <em class="option">filename</em></a></td>
1159 <td valign="top">name of texture to tile onto the image background</td>
1163 <td valign="top"><a href="../www/command-line-options.html#threshold">-threshold <em class="option">value</em></a></td>
1164 <td valign="top">threshold the image</td>
1168 <td valign="top"><a href="../www/command-line-options.html#thumbnail">-thumbnail <em class="option">geometry</em></a></td>
1169 <td valign="top">create a thumbnail of the image</td>
1173 <td valign="top"><a href="../www/command-line-options.html#tile">-tile <em class="option">filename</em></a></td>
1174 <td valign="top">tile image when filling a graphic primitive</td>
1178 <td valign="top"><a href="../www/command-line-options.html#tile-offset">-tile-offset <em class="option">geometry</em></a></td>
1179 <td valign="top">set the image tile offset</td>
1183 <td valign="top"><a href="../www/command-line-options.html#tint">-tint <em class="option">value</em></a></td>
1184 <td valign="top">tint the image with the fill color</td>
1188 <td valign="top"><a href="../www/command-line-options.html#transform">-transform</a></td>
1189 <td valign="top">affine transform image</td>
1193 <td valign="top"><a href="../www/command-line-options.html#transparent">-transparent <em class="option">color</em></a></td>
1194 <td valign="top">make this color transparent within the image</td>
1198 <td valign="top"><a href="../www/command-line-options.html#transparent-color">-transparent-color <em class="option">color</em></a></td>
1199 <td valign="top">transparent color</td>
1203 <td valign="top"><a href="../www/command-line-options.html#transpose">-transpose</a></td>
1204 <td valign="top">flip image in the vertical direction and rotate 90 degrees</td>
1208 <td valign="top"><a href="../www/command-line-options.html#transverse">-transverse</a></td>
1209 <td valign="top">flop image in the horizontal direction and rotate 270 degrees</td>
1213 <td valign="top"><a href="../www/command-line-options.html#treedepth">-treedepth <em class="option">value</em></a></td>
1214 <td valign="top">color tree depth</td>
1218 <td valign="top"><a href="../www/command-line-options.html#trim">-trim</a></td>
1219 <td valign="top">trim image edges</td>
1223 <td valign="top"><a href="../www/command-line-options.html#type">-type <em class="option">type</em></a></td>
1224 <td valign="top">image type</td>
1228 <td valign="top"><a href="../www/command-line-options.html#undercolor">-undercolor <em class="option">color</em></a></td>
1229 <td valign="top">annotation bounding box color</td>
1233 <td valign="top"><a href="../www/command-line-options.html#unique-colors">-unique-colors</a></td>
1234 <td valign="top">discard all but one of any pixel color.</td>
1238 <td valign="top"><a href="../www/command-line-options.html#units">-units <em class="option">type</em></a></td>
1239 <td valign="top">the units of image resolution</td>
1243 <td valign="top"><a href="../www/command-line-options.html#unsharp">-unsharp <em class="option">geometry</em></a></td>
1244 <td valign="top">sharpen the image</td>
1248 <td valign="top"><a href="../www/command-line-options.html#verbose">-verbose</a></td>
1249 <td valign="top">print detailed information about the image</td>
1253 <td valign="top"><a href="../www/command-line-options.html#version">-version</a></td>
1254 <td valign="top">print version information</td>
1258 <td valign="top"><a href="../www/command-line-options.html#view">-view</a></td>
1259 <td valign="top">FlashPix viewing transforms</td>
1263 <td valign="top"><a href="../www/command-line-options.html#vignette">-vignette <em class="option">geometry</em></a></td>
1264 <td valign="top">soften the edges of the image in vignette style</td>
1268 <td valign="top"><a href="../www/command-line-options.html#virtual-pixel">-virtual-pixel <em class="option">method</em></a></td>
1269 <td valign="top">access method for pixels outside the boundaries of the image</td>
1273 <td valign="top"><a href="../www/command-line-options.html#wave">-wave <em class="option">geometry</em></a></td>
1274 <td valign="top">alter an image along a sine wave</td>
1278 <td valign="top"><a href="../www/command-line-options.html#weight">-weight <em class="option">type</em></a></td>
1279 <td valign="top">render text with this font weight</td>
1283 <td valign="top"><a href="../www/command-line-options.html#white-point">-white-point <em class="option">point</em></a></td>
1284 <td valign="top">chromaticity white point</td>
1288 <td valign="top"><a href="../www/command-line-options.html#white-threshold">-white-threshold <em class="option">value</em></a></td>
1289 <td valign="top">force all pixels above the threshold into white</td>
1293 <td valign="top"><a href="../www/command-line-options.html#write">-write <em class="option">filename</em></a></td>
1294 <td valign="top">write images to this file</td>
1304 <div id="linkbar">
\r
1305 <span id="linkbar-west"> </span>
\r
1306 <span id="linkbar-center">
\r
1307 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> •
\r
1308 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
\r
1310 <span id="linkbar-east"> </span>
\r
1312 <div class="footer">
\r
1313 <span id="footer-west">© 1999-2010 ImageMagick Studio LLC</span>
\r
1314 <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
\r
1316 <div style="clear: both; margin: 0; width: 100%; "></div>
\r
1317 <script type="text/javascript">
\r
1318 var _gaq = _gaq || [];
\r
1319 _gaq.push(['_setAccount', 'UA-17690367-1']);
\r
1320 _gaq.push(['_trackPageview']);
\r
1323 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
\r
1324 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
\r
1325 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
\r