root / ImageMagick / trunk / www / mogrify.html

Revision 12661, 47.9 kB (checked in by cristy, 40 hours ago)
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
4<head>
5  <style type="text/css" media="screen,projection"><!--
6    @import url("../www/magick.css");
7  //--></style>
8  <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
9  <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
10  <title>ImageMagick: Command-line Tools: Mogrify</title>
11  <meta http-equiv="Content-Language" content="en-US"/>
12  <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
13  <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
14  <meta name="Generator" content="PHP"/>
15  <meta name="Keywords" content="command-line, tools:, mogrify, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject"/>
16  <meta name="Description" content="ImageMagick® is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a variety of formats (about 100) including GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick to translate, flip, mirror, rotate, scale, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.  ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you can freely use, copy, modify, and distribute. Its license is compatible with the GPL. It runs on all major operating systems.  The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: MagickCore (C), MagickWand (C), ChMagick (Ch), Magick++ (C++), JMagick (Java), L-Magick (Lisp), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images automagically and dynamically."/>
17  <meta name="Rating" content="GENERAL"/>
18  <meta name="Robots" content="INDEX, FOLLOW"/>
19  <meta name="Generator" content="ImageMagick Studio LLC"/>
20  <meta name="Author" content="ImageMagick Studio LLC"/>
21  <meta name="Revisit-after" content="2 DAYS"/>
22  <meta name="Resource-type" content="document"/>
23  <meta name="Copyright" content="Copyright (c) 1999-2008 ImageMagick Studio LLC"/>
24  <meta name="Distribution" content="Global"/>
25  <link rel="shortcut icon" href="../images/wand.ico"  type="images/vnd.microsoft.icon"/>
26</head>
27
28<body id="www-imagemagick-org">
29  <table id="titlebar" style="width: 100%;background-color: #f5f5f5" cellpadding="0" cellspacing="0" border="0" summary="ImageMagick">
30    <tbody>
31      <tr valign="top">
32        <td align="left"><a href="../index.html"><img id="titlebar-west" src="../images/script.png" alt="[ImageMagick]" width="350" height="60" vspace="28" name="titlebar-west"/></a></td>
33        <td align="left"><a href="https://secure.networkredux.com/affiliate/idevaffiliate.html?id=146" target="736979920"><img id="titlebar-west" src="../images/networkredux.png" alt="[sponsor]" border="0" vspace="45" name="titlebar-west"/></a></td>
34        <td width="99%"><br /> </td>
35        <td style="background-color: white" align="right"><a href="../index.html"><img src="../images/sprite.jpg" alt="" width="114" height="118" border="0" name="titlebar-east"/></a></td>
36        <td style="background-color: white" align="right"><a href="http://www.imagemagick.org/discourse-server/" target="480547545"><img id="titlebar-east" src="../images/logo.jpg" alt="" width="114" height="118" border="0" name="titlebar-east"/></a></td>
37      </tr>
38    </tbody>
39  </table>
40
41  <table style="width: 100%" border="0" cellpadding="0" cellspacing="0" summary="">
42  <tbody>
43
44    <tr valign="top" style="height: 100%;">
45      <td id="menu" width="1%" height="100%">
46      <p><a href="#main">Skip to page contents</a></p>
47      <font size="-1">
48      <span>[</span>
49      <a href="../index.html">About ImageMagick</a>
50  <span>]</span><br /><span>[</span>
51      <a href="../www/command-line-tools.html">Command-line Tools</a>
52      <a href="../www/command-line-processing.html" class="sub">Processing</a>
53      <a href="../www/command-line-options.html" class="sub">Options</a>
54      <a href="http://www.imagemagick.org/Usage/" target="573635635" class="sub">Usage</a>
55      <a href="../www/api.html">Program Interfaces</a>
56      <a href="../www/magick-wand.html" class="sub">MagickWand</a>
57      <a href="../www/magick-core.html" class="sub">MagickCore</a>
58      <a href="../www/perl-magick.html" class="sub">PerlMagick</a>
59      <a href="../www/Magick++/" target="1453729490" class="sub">Magick++</a>
60      <a href="../www/architecture.html">Architecture</a>
61  <span>]</span><br /><span>[</span>
62      <a href="../www/install-source.html">Install from Source</a>
63      <a href="../www/install-source.html#unix" class="sub">Unix</a>
64      <a href="../www/install-source.html#windows" class="sub">Windows</a>
65      <a href="../www/binary-releases.html">Binary Releases</a>
66      <a href="../www/binary-releases.html#unix" class="sub">Unix</a>
67      <a href="../www/binary-releases.html#macosx" class="sub">Mac OS X</a>
68      <a href="../www/binary-releases.html#windows" class="sub">Windows</a>
69      <a href="../www/resources.html">Resources</a>
70  <span>]</span><br /><span>[</span>
71      <a href="../www/download.html">Download</a>
72  <span>]</span><br /><span>[</span>
73      <a href="../www/sitemap.html">Site Map</a>
74                        <a href="../www/links.html" class="sub">Links</a>
75  <span>]</span><br /><span>[</span>
76      <a href="../www/sponsors.html">Sponsors:</a>
77      <fieldset>
78  <a href="http://www.trivago.de" class="sponsor" target="sponsor">Hotelpreise<br />vergleichen</a><!-- 200901160010 -->
79      <br />
80      <a href="http://meta-preisvergleich.de" class="sponsor" target="sponsor">Preisvergleich</a><!-- 200901010120 -->
81      <br />
82      <a href="http://www.checkcost.co.uk" class="sponsor" target="sponsor">Compare</a><!-- 200902010720 -->
83      <br />
84      <a href="http://www.ecostsoftware.com" class="sponsor" target="sponsor">Software</a><!-- 200902010720 -->
85      <br />
86      <a href="http://www.callerbase.com" class="sponsor" target="sponsor">Phone Number<br />Search</a><!-- 200812010040 -->
87      <br />
88      <a href="http://www.online-kredit-index.de" class="sponsor" target="sponsor">Kredit</a><!-- 200903010120 -->
89      <br />
90      <a href="http://www.posters555.com" class="sponsor" target="sponsor">Poster</a><!-- 200903010800 -->
91      <br />
92      <a href="http://www.iceposter.com" class="sponsor" target="sponsor">Posters</a><!-- 200812010200 -->
93      <br />
94      <a href="http://www.imade-art.de"><img src="../images/imade_art2.jpg" alt="[Kunst bei imade-art]" width="116" height="28" border="0" name="Kunst bei imade-art"/></a> <!-- 200811010160 -->
95      </fieldset>
96      <span>]</span>
97      </font>
98      </td>
99
100      <td id="main" valign="top">
101<p class="navigation-index">[<a href="#usage">Example Usage</a> &bull; <a href="#options">Option Summary</a>]</p>
102
103<p>Use the <kbd>mogrify</kbd> program to resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.   This tool is similiar to <a href="../www/convert.html">convert</a> except the original image file is overwritten (unless you change the file suffic with the <a href="../www/command-line-options.html#format">-format</a> option) with any changes you request.  See <a href="../www/command-line-processing.html">Command Line Processing</a> for advice on how to structure your <kbd>mogrify</kbd> command or see below for example usages of the command.</p>
104
105<div style="margin: auto;">
106  <h2><a name="usage"></a>Example Usage</h2>
107</div>
108
109<p>We list a few examples of the <kbd>mogrify</kbd> command here to illustrate its usefulness and ease of use.  To get started, lets reduce the size of our
110rose:</p>
111
112<pre class="text">
113  mogrify -resize 50% rose.jpg
114</pre>
115
116<p class="image">
117  <a href="../images/rose.jpg"><img src="../images/rose.jpg" width="70" height="46" align="middle" alt="rose" /></a>
118  <img src="../images/right.gif" width="20" height="20" align="middle" alt="==>" />
119  <a href="../images/rose.png"><img src="../images/rose.png" width="35" height="23" align="middle" alt="rose" /></a>
120</p>
121
122<p>You can resize all your JPEG images in a folder to a maximum dimension of 256x256 with this command:</p>
123
124<pre class="text">
125  mogrify -resize 256x256 *.jpg
126</pre>
127
128<p>Finally, we convert all our PNG images to the JPEG format:</p>
129
130<pre class="text">
131  mogrify -format jpg *.png
132</pre>
133
134<p>Here image files 1.png, 2.png, etc., are left untouched and files 1.jpg, 2.jpg, etc., are created.  They are copies of their respective PNG images except are stored  in the JPEG image format.</p>
135
136
137<p>You can find additional examples of using <kbd>mogrify</kbd> in <a href="http://www-106.ibm.com/developerworks/library/l-graf/?ca=dnt-428" target="194334153">Graphics from the Command Line</a>.  Further discussion is available in  <a href="http://www-106.ibm.com/developerworks/library/l-graf2/?ca=dgr-lnxw15GraphicsLine" target="1017217545">More Graphics from the Command Line</a> and <a href="http://www.imagemagick.org/Usage/" target="795516965">Examples of ImageMagick Usage</a>.</p>
138
139<div style="margin: auto;">
140  <h2><a name="options"></a>Option Summary</h2>
141</div>
142
143<p>The <kbd>mogrify</kbd> command recognizes these options.  Click on an option to get more details about how that option works.</p>
144
145<table id="table" cellpadding="2" cellspacing="0" style="width: 93%">
146  <tbody>
147  <tr>
148    <th align="left">Option</th>
149    <th align="left">Description</th>
150  </tr>
151
152  <tr>
153    <td valign="top"><a href="../www/command-line-options.html#adaptive-blur" target="magick-options">-adaptive-blur <em class="option">geometry</em></a></td>
154    <td valign="top">adaptively blur pixels; decrease effect near edges</td>
155  </tr>
156
157  <tr>
158    <td valign="top"><a href="../www/command-line-options.html#adaptive-resize" target="magick-options">-adaptive-resize <em class="option">geometry</em></a></td>
159    <td valign="top">adaptively resize image with data dependent triangulation.</td>
160  </tr>
161
162  <tr>
163    <td valign="top"><a href="../www/command-line-options.html#adaptive-sharpen" target="magick-options">-adaptive-sharpen <em class="option">geometry</em></a></td>
164    <td valign="top">adaptively sharpen pixels; increase effect near edges</td>
165  </tr>
166
167  <tr>
168    <td valign="top"><a href="../www/command-line-options.html#alpha" target="magick-options">-alpha</a></td>
169    <td valign="top">activate, deactivate, reset, or set the alpha channel</td>
170  </tr>
171
172  <tr>
173    <td valign="top"><a href="../www/command-line-options.html#affine">-affine <em class="option">matrix</em></a></td>
174    <td valign="top">affine transform matrix</td>
175  </tr>
176
177  <tr>
178    <td valign="top"><a href="../www/command-line-options.html#annotate">-annotate <em class="option">geometry text</em></a></td>
179    <td valign="top">annotate the image with text</td>
180  </tr>
181
182  <tr>
183    <td valign="top"><a href="../www/command-line-options.html#antialias">-antialias</a></td>
184    <td valign="top">remove pixel-aliasing</td>
185  </tr>
186
187  <tr>
188    <td valign="top"><a href="../www/command-line-options.html#append">-append</a></td>
189    <td valign="top">append an image sequence</td>
190  </tr>
191
192  <tr>
193    <td valign="top"><a href="../www/command-line-options.html#authenticate">-authenticate <em class="option">value</em></a></td>
194    <td valign="top">decrypt image with this password</td>
195  </tr>
196
197  <tr>
198    <td valign="top"><a href="../www/command-line-options.html#average">-average</a></td>
199    <td valign="top">average an image sequence</td>
200  </tr>
201
202  <tr>
203    <td valign="top"><a href="../www/command-line-options.html#background">-background <em class="option">color</em></a></td>
204    <td valign="top">background color</td>
205  </tr>
206
207  <tr>
208    <td valign="top"><a href="../www/command-line-options.html#bias">-bias <em class="option">value</em></a></td>
209    <td valign="top">add bias when convolving an image</td>
210  </tr>
211
212  <tr>
213    <td valign="top"><a href="../www/command-line-options.html#black-threshold">-black-threshold <em class="option">value</em></a></td>
214    <td valign="top">force all pixels below the threshold into black</td>
215  </tr>
216
217  <tr>
218    <td valign="top"><a href="../www/command-line-options.html#blue-primary">-blue-primary <em class="option">point</em></a></td>
219    <td valign="top">chromaticity blue primary point</td>
220  </tr>
221
222  <tr>
223    <td valign="top"><a href="../www/command-line-options.html#blur">-blur <em class="option">geometry</em></a></td>
224    <td valign="top">reduce image noise and reduce detail levels</td>
225  </tr>
226
227  <tr>
228    <td valign="top"><a href="../www/command-line-options.html#border">-border <em class="option">geometry</em></a></td>
229    <td valign="top">surround image with a border of color</td>
230  </tr>
231
232  <tr>
233    <td valign="top"><a href="../www/command-line-options.html#bordercolor">-bordercolor <em class="option">color</em></a></td>
234    <td valign="top">border color</td>
235  </tr>
236
237  <tr>
238    <td valign="top"><a href="../www/command-line-options.html#caption">-caption <em class="option">string</em></a></td>
239    <td valign="top">assign a caption to an image</td>
240  </tr>
241
242  <tr>
243    <td valign="top"><a href="../www/command-line-options.html#channel">-channel <em class="option">type</em></a></td>
244    <td valign="top">apply option to select image channels</td>
245  </tr>
246
247  <tr>
248    <td valign="top"><a href="../www/command-line-options.html#charcoal">-charcoal <em class="option">radius</em></a></td>
249    <td valign="top">simulate a charcoal drawing</td>
250  </tr>
251
252  <tr>
253    <td valign="top"><a href="../www/command-line-options.html#chop">-chop <em class="option">geometry</em></a></td>
254    <td valign="top">remove pixels from the image interior</td>
255  </tr>
256
257  <tr>
258    <td valign="top"><a href="../www/command-line-options.html#clip">-clip</a></td>
259    <td valign="top">clip along the first path from the 8BIM profile</td>
260  </tr>
261
262  <tr>
263    <td valign="top"><a href="../www/command-line-options.html#clip-mask">-clip-mask <em class="option">filename</em></a></td>
264    <td valign="top">associate a clip mask with the image</td>
265  </tr>
266
267  <tr>
268    <td valign="top"><a href="../www/command-line-options.html#clip-path">-clip-path <em class="option">id</em></a></td>
269    <td valign="top">clip along a named path from the 8BIM profile</td>
270  </tr>
271
272  <tr>
273    <td valign="top"><a href="../www/command-line-options.html#clone">-clone <em class="option">index</em></a></td>
274    <td valign="top">clone an image</td>
275  </tr>
276
277  <tr>
278    <td valign="top"><a href="../www/command-line-options.html#clut" target="magick-options">-clut</a></td>
279    <td valign="top">apply a color lookup table to the image</td>
280  </tr>
281
282  <tr>
283    <td valign="top"><a href="../www/command-line-options.html#coalesce">-coalesce</a></td>
284    <td valign="top">merge a sequence of images</td>
285  </tr>
286
287  <tr>
288    <td valign="top"><a href="../www/command-line-options.html#colorize">-colorize <em class="option">value</em></a></td>
289    <td valign="top">colorize the image with the fill color</td>
290  </tr>
291
292  <tr>
293    <td valign="top"><a href="../www/command-line-options.html#colors">-colors <em class="option">value</em></a></td>
294    <td valign="top">preferred number of colors in the image</td>
295  </tr>
296
297  <tr>
298    <td valign="top"><a href="../www/command-line-options.html#colorspace">-colorspace <em class="option">type</em></a></td>
299    <td valign="top">set image colorspace</td>
300  </tr>
301
302  <tr>
303    <td valign="top"><a href="../www/command-line-options.html#combine">-combine</a></td>
304    <td valign="top">combine a sequence of images</td>
305  </tr>
306
307  <tr>
308    <td valign="top"><a href="../www/command-line-options.html#comment">-comment <em class="option">string</em></a></td>
309    <td valign="top">annotate image with comment</td>
310  </tr>
311
312  <tr>
313    <td valign="top"><a href="../www/command-line-options.html#compose">-compose <em class="option">operator</em></a></td>
314    <td valign="top">set image composite operator</td>
315  </tr>
316
317  <tr>
318    <td valign="top"><a href="../www/command-line-options.html#composite">-composite</a></td>
319    <td valign="top">composite image</td>
320  </tr>
321
322  <tr>
323    <td valign="top"><a href="../www/command-line-options.html#compress">-compress <em class="option">type</em></a></td>
324    <td valign="top">image compression type</td>
325  </tr>
326
327  <tr>
328    <td valign="top"><a href="../www/command-line-options.html#contrast">-contrast</a></td>
329    <td valign="top">enhance or reduce the image contrast</td>
330  </tr>
331
332  <tr>
333    <td valign="top"><a href="../www/command-line-options.html#contrast-stretch" target="magick-options">-contrast-stretch <em class="option">geometry</em></a></td>
334    <td valign="top">improve the contrast in an image by `stretching' the range of intensity value</td>
335  </tr>
336
337  <tr>
338    <td valign="top"><a href="../www/command-line-options.html#convolve">-convolve <em class="option">coefficients</em></a></td>
339    <td valign="top">apply a convolution kernel to the image</td>
340  </tr>
341
342  <tr>
343    <td valign="top"><a href="../www/command-line-options.html#crop">-crop <em class="option">geometry</em></a></td>
344    <td valign="top">preferred size and location of the cropped image</td>
345  </tr>
346
347  <tr>
348    <td valign="top"><a href="../www/command-line-options.html#cycle">-cycle <em class="option">amount</em></a></td>
349    <td valign="top">cycle the image colormap</td>
350  </tr>
351
352  <tr>
353    <td valign="top"><a href="../www/command-line-options.html#decipher" target="magick-options">-decipher <em class="option">filename</em></a></td>
354    <td valign="top">convert cipher pixels to plain pixels</td>
355  </tr>
356
357  plaintr>
358    <td valign="top"><a href="../www/command-line-options.html#debug">-debug <em class="option">events</em></a></td>
359    <td valign="top">display copious debugging information</td>
360  </tr>
361
362  <tr>
363    <td valign="top"><a href="../www/command-line-options.html#define">-define <em class="option">format:option</em></a></td>
364    <td valign="top">define one or more image format options</td>
365  </tr>
366
367  <tr>
368    <td valign="top"><a href="../www/command-line-options.html#deconstruct">-deconstruct</a></td>
369    <td valign="top">break down an image sequence into constituent parts</td>
370  </tr>
371
372  <tr>
373    <td valign="top"><a href="../www/command-line-options.html#delay">-delay <em class="option">value</em></a></td>
374    <td valign="top">display the next image after pausing</td>
375  </tr>
376
377  <tr>
378    <td valign="top"><a href="../www/command-line-options.html#delete">-delete <em class="option">index</em></a></td>
379    <td valign="top">delete the image from the image sequence</td>
380  </tr>
381
382  <tr>
383    <td valign="top"><a href="../www/command-line-options.html#density">-density <em class="option">geometry</em></a></td>
384    <td valign="top">horizontal and vertical density of the image</td>
385  </tr>
386
387  <tr>
388    <td valign="top"><a href="../www/command-line-options.html#depth">-depth <em class="option">value</em></a></td>
389    <td valign="top">image depth</td>
390  </tr>
391
392  <tr>
393    <td valign="top"><a href="../www/command-line-options.html#despeckle">-despeckle</a></td>
394    <td valign="top">reduce the speckles within an image</td>
395  </tr>
396
397  <tr>
398    <td valign="top"><a href="../www/command-line-options.html#display">-display <em class="option">server</em></a></td>
399    <td valign="top">get image or font from this X server</td>
400  </tr>
401
402  <tr>
403    <td valign="top"><a href="../www/command-line-options.html#dispose">-dispose <em class="option">method</em></a></td>
404    <td valign="top">layer disposal method</td>
405  </tr>
406
407  <tr>
408    <td valign="top"><a href="../www/command-line-options.html#distort" target="magick-options">-distort <em class="option">type coefficients</em></a></td>
409    <td valign="top">distort image</td>
410  </tr>
411
412  <tr>
413    <td valign="top"><a href="../www/command-line-options.html#dither" target="magick-options">-dither  <em class="option">method</em></a></td>
414    <td valign="top">apply error diffusion to image</td>
415  </tr>
416
417  <tr>
418    <td valign="top"><a href="../www/command-line-options.html#draw">-draw <em class="option">string</em></a></td>
419    <td valign="top">annotate the image with a graphic primitive</td>
420  </tr>
421
422  <tr>
423    <td valign="top"><a href="../www/command-line-options.html#encipher" target="magick-options">-encipher <em class="option">filename</em></a></td>
424    <td valign="top">convert plain pixels to cipher pixels</td>
425  </tr>
426
427  <tr>
428    <td valign="top"><a href="../www/command-line-options.html#edge">-edge <em class="option">radius</em></a></td>
429    <td valign="top">apply a filter to detect edges in the image</td>
430  </tr>
431
432  <tr>
433    <td valign="top"><a href="../www/command-line-options.html#emboss">-emboss <em class="option">radius</em></a></td>
434    <td valign="top">emboss an image</td>
435  </tr>
436
437  <tr>
438    <td valign="top"><a href="../www/command-line-options.html#encoding">-encoding <em class="option">type</em></a></td>
439    <td valign="top">text encoding type</td>
440  </tr>
441
442  <tr>
443    <td valign="top"><a href="../www/command-line-options.html#endian">-endian <em class="option">type</em></a></td>
444    <td valign="top">endianness (MSB or LSB) of the image</td>
445  </tr>
446
447  <tr>
448    <td valign="top"><a href="../www/command-line-options.html#enhance">-enhance</a></td>
449    <td valign="top">apply a digital filter to enhance a noisy image</td>
450  </tr>
451
452  <tr>
453    <td valign="top"><a href="../www/command-line-options.html#equalize">-equalize</a></td>
454    <td valign="top">perform histogram equalization to an image</td>
455  </tr>
456
457  <tr>
458    <td valign="top"><a href="../www/command-line-options.html#evaluate">-evaluate <em class="option">operator value</em></a></td>
459    <td valign="top">evaluate an arithmetic, relational, or logical expression</td>
460  </tr>
461
462  <tr>
463    <td valign="top"><a href="../www/command-line-options.html#extent">-extent <em class="option">geometry</em></a></td>
464    <td valign="top">set the image size</td>
465  </tr>
466
467  <tr>
468    <td valign="top"><a href="../www/command-line-options.html#extract">-extract <em class=