root / ImageMagick / trunk / www / convert.html

Revision 12114, 51.4 kB (checked in by cristy, 30 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: Convert</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:, convert, 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="503977226"><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="950100676"><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="1116504349" 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="475641647" 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.nationalrelocation.com/real-estate/" class="sponsor" target="sponsor">Real Estate</a><!-- 200902010250 -->
79      <br />
80      <a href="http://www.posters555.com" class="sponsor" target="sponsor">Poster</a><!-- 200903010800 -->
81      <br />
82      <a href="http://www.iceposter.com" class="sponsor" target="sponsor">Posters</a><!-- 200812010200 -->
83      <br />
84      <a href="http://meta-preisvergleich.de" class="sponsor" target="sponsor">Preisvergleich</a><!-- 200810010120 -->
85      <br />
86      <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 -->
87      </fieldset>
88      <span>]</span>
89      </font>
90      </td>
91
92      <td id="main" valign="top">
93<p class="navigation-index">[<a href="#usage">Example Usage</a> &bull; <a href="#options">Option Summary</a>]</p>
94
95<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>
96
97<div style="margin: auto;">
98  <h2><a name="usage"></a>Example Usage</h2>
99</div>
100
101<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>
102
103<pre class="text">
104  convert rose.jpg rose.png
105</pre>
106
107<p>Next, we reduce the image size before it is written to the PNG format:</p>
108
109<pre class="text">
110  convert rose.jpg -resize 50% rose.png
111</pre>
112
113<p class="image">
114  <a href="../images/rose.jpg"><img src="../images/rose.jpg" width="70" height="46" align="middle" alt="rose" /></a>
115  <img src="../images/right.gif" width="20" height="20" align="middle" alt="==>" />
116  <a href="../images/rose.png"><img src="../images/rose.png" width="35" height="23" align="middle" alt="rose" /></a>
117</p>
118
119<p>You can combine multiple image-processing operations to produce complex results:</p>
120
121<pre class="text">
122  convert -size 320x85 xc:transparent -font Bookman-DemiItalic -pointsize 72 -draw "text 25,60 'Magick'" \
123    -channel RGBA -gaussian 0x6 -fill darkred -stroke magenta -draw "text 20,55 'Magick'" fuzzy-magick.png
124</pre>
125
126<p class="image">
127  <a href="../images/fuzzy-magick.png"><img src="../images/fuzzy-magick.png" width="320" height="85" align="middle" alt="fuzzy-magick" /></a>
128</p>
129
130<p>You can find additional examples of using <kbd>convert</kbd> in <a href="http://www.imagemagick.org/Usage/" target="173292935">Examples of ImageMagick Usage</a>.</p>
131
132<div style="margin: auto;">
133  <h2><a name="options"></a>Option Summary</h2>
134</div>
135
136<p>The <kbd>convert</kbd> command recognizes these options.  Click on an option to get more details about how that option works.</p>
137
138<table id="table" cellpadding="2" cellspacing="0" style="width: 93%">
139  <tbody>
140  <tr>
141    <th align="left">Option</th>
142    <th align="left">Description</th>
143  </tr>
144
145  <tr>
146    <td valign="top"><a href="../www/command-line-options.html#adaptive-blur" target="magick-options">-adaptive-blur <em class="option">geometry</em></a></td>
147    <td valign="top">adaptively blur pixels; decrease effect near edges</td>
148  </tr>
149
150  <tr>
151    <td valign="top"><a href="../www/command-line-options.html#adaptive-resize" target="magick-options">-adaptive-resize <em class="option">geometry</em></a></td>
152    <td valign="top">adaptively resize image with data dependent triangulation.</td>
153  </tr>
154
155  <tr>
156    <td valign="top"><a href="../www/command-line-options.html#adaptive-sharpen" target="magick-options">-adaptive-sharpen <em class="option">geometry</em></a></td>
157    <td valign="top">adaptively sharpen pixels; increase effect near edges</td>
158  </tr>
159
160  <tr>
161    <td valign="top"><a href="../www/command-line-options.html#adjoin" target="magick-options">-adjoin</a></td>
162    <td valign="top">join images into a single multi-image file</td>
163  </tr>
164
165  <tr>
166    <td valign="top"><a href="../www/command-line-options.html#affine" target="magick-options">-affine <em class="option">matrix</em></a></td>
167    <td valign="top">affine transform matrix</td>
168  </tr>
169
170  <tr>
171    <td valign="top"><a href="../www/command-line-options.html#affinity" target="magick-options">-affinity <em class="option">filename</em></a></td>
172    <td valign="top">transform image colors to match this set of colors</td>
173  </tr>
174
175  <tr>
176    <td valign="top"><a href="../www/command-line-options.html#alpha" target="magick-options">-alpha</a></td>
177    <td valign="top">activate, deactivate, reset, or set the alpha channel</td>
178  </tr>
179
180  <tr>
181    <td valign="top"><a href="../www/command-line-options.html#annotate" target="magick-options">-annotate <em class="option">geometry text</em></a></td>
182    <td valign="top">annotate the image with text</td>
183  </tr>
184
185  <tr>
186    <td valign="top"><a href="../www/command-line-options.html#antialias" target="magick-options">-antialias</a></td>
187    <td valign="top">remove pixel-aliasing</td>
188  </tr>
189
190  <tr>
191    <td valign="top"><a href="../www/command-line-options.html#append" target="magick-options">-append</a></td>
192    <td valign="top">append an image sequence</td>
193  </tr>
194
195  <tr>
196    <td valign="top"><a href="../www/command-line-options.html#authenticate" target="magick-options">-authenticate <em class="option">value</em></a></td>
197    <td valign="top">decipher image with this password</td>
198  </tr>
199
200  <tr>
201    <td valign="top"><a href="../www/command-line-options.html#average" target="magick-options">-average</a></td>
202    <td valign="top">average an image sequence</td>
203  </tr>
204
205  <tr>
206    <td valign="top"><a href="../www/command-line-options.html#background" target="magick-options">-background <em class="option">color</em></a></td>
207    <td valign="top">background color</td>
208  </tr>
209
210  <tr>
211    <td valign="top"><a href="../www/command-line-options.html#bench" target="magick-options">-bench <em class="option">iterations</em></a></td>
212    <td valign="top">measure performance</td>
213  </tr>
214
215  <tr>
216    <td valign="top"><a href="../www/command-line-options.html#bias" target="magick-options">-bias <em class="option">value</em></a></td>
217    <td valign="top">add bias when convolving an image</td>
218  </tr>
219
220  <tr>
221    <td valign="top"><a href="../www/command-line-options.html#black-threshold" target="magick-options">-black-threshold <em class="option">value</em></a></td>
222    <td valign="top">force all pixels below the threshold into black</td>
223  </tr>
224
225  <tr>
226    <td valign="top"><a href="../www/command-line-options.html#blue-primary" target="magick-options">-blue-primary <em class="option">point</em></a></td>
227    <td valign="top">chromaticity blue primary point</td>
228  </tr>
229
230  <tr>
231    <td valign="top"><a href="../www/command-line-options.html#blur" target="magick-options">-blur <em class="option">geometry</em></a></td>
232    <td valign="top">reduce image noise and reduce detail levels</td>
233  </tr>
234
235  <tr>
236    <td valign="top"><a href="../www/command-line-options.html#border" target="magick-options">-border <em class="option">geometry</em></a></td>
237    <td valign="top">surround image with a border of color</td>
238  </tr>
239
240  <tr>
241    <td valign="top"><a href="../www/command-line-options.html#bordercolor" target="magick-options">-bordercolor <em class="option">color</em></a></td>
242    <td valign="top">border color</td>
243  </tr>
244
245  <tr>
246    <td valign="top"><a href="../www/command-line-options.html#caption" target="magick-options">-caption <em class="option">string</em></a></td>
247    <td valign="top">assign a caption to an image</td>
248  </tr>
249
250  <tr>
251    <td valign="top"><a href="../www/command-line-options.html#channel" target="magick-options">-channel <em class="option">type</em></a></td>
252    <td valign="top">apply option to select image channels</td>
253  </tr>
254
255  <tr>
256    <td valign="top"><a href="../www/command-line-options.html#charcoal" target="magick-options">-charcoal <em class="option">radius</em></a></td>
257    <td valign="top">simulate a charcoal drawing</td>
258  </tr>
259
260  <tr>
261    <td valign="top"><a href="../www/command-line-options.html#chop" target="magick-options">-chop <em class="option">geometry</em></a></td>
262    <td valign="top">remove pixels from the image interior</td>
263  </tr>
264
265  <tr>
266    <td valign="top"><a href="../www/command-line-options.html#clip" target="magick-options">-clip</a></td>
267    <td valign="top">clip along the first path from the 8BIM profile</td>
268  </tr>
269
270  <tr>
271    <td valign="top"><a href="../www/command-line-options.html#clip-mask" target="magick-options">-clip-mask</a> <em class="option">filename</em></td>
272    <td valign="top">associate clip mask with the image</td>
273  </tr>
274
275  <tr>
276    <td valign="top"><a href="../www/command-line-options.html#clip-path" target="magick-options">-clip-path <em class="option">id</em></a></td>
277    <td valign="top">clip along a named path from the 8BIM profile</td>
278  </tr>
279
280  <tr>
281    <td valign="top"><a href="../www/command-line-options.html#clone" target="magick-options">-clone <em class="option">index</em></a></td>
282    <td valign="top">clone an image</td>
283  </tr>
284
285  <tr>
286    <td valign="top"><a href="../www/command-line-options.html#clut" target="magick-options">-clut</a></td>
287    <td valign="top">apply a color lookup table to the image</td>
288  </tr>
289
290  <tr>
291    <td valign="top"><a href="../www/command-line-options.html#contrast-stretch" target="magick-options">-contrast-stretch <em class="option">geometry</em></a></td>
292    <td valign="top">improve the contrast in an image by `stretching' the range of intensity value</td>
293  </tr>
294
295  <tr>
296    <td valign="top"><a href="../www/command-line-options.html#coalesce" target="magick-options">-coalesce</a></td>
297    <td valign="top">merge a sequence of images</td>
298  </tr>
299
300  <tr>
301    <td valign="top"><a href="../www/command-line-options.html#colorize" target="magick-options">-colorize <em class="option">value</em></a></td>
302    <td valign="top">colorize the image with the fill color</td>
303  </tr>
304
305  <tr>
306    <td valign="top"><a href="../www/command-line-options.html#colors" target="magick-options">-colors <em class="option">value</em></a></td>
307    <td valign="top">preferred number of colors in the image</td>
308  </tr>
309
310  <tr>
311    <td valign="top"><a href="../www/command-line-options.html#colorspace" target="magick-options">-colorspace <em class="option">type</em></a></td>
312    <td valign="top">set image colorspace</td>
313  </tr>
314
315  <tr>
316    <td valign="top"><a href="../www/command-line-options.html#combine" target="magick-options">-combine</a></td>
317    <td valign="top">combine a sequence of images</td>
318  </tr>
319
320  <tr>
321    <td valign="top"><a href="../www/command-line-options.html#comment" target="magick-options">-comment <em class="option">string</em></a></td>
322    <td valign="top">annotate image with comment</td>
323  </tr>
324
325  <tr>
326    <td valign="top"><a href="../www/command-line-options.html#compose" target="magick-options">-compose <em class="option">operator</em></a></td>
327    <td valign="top">set image composite operator</td>
328  </tr>
329
330  <tr>
331    <td valign="top"><a href="../www/command-line-options.html#composite" target="magick-options">-composite</a></td>
332    <td valign="top">composite image</td>
333  </tr>
334
335  <tr>
336    <td valign="top"><a href="../www/command-line-options.html#compress" target="magick-options">-compress <em class="option">type</em></a></td>
337    <td valign="top">image compression type</td>
338  </tr>
339
340  <tr>
341    <td valign="top"><a href="../www/command-line-options.html#contrast" target="magick-options">-contrast</a></td>
342    <td valign="top">enhance or reduce the image contrast</td>
343  </tr>
344
345  <tr>
346    <td valign="top"><a href="../www/command-line-options.html#convolve" target="magick-options">-convolve <em class="option">coefficients</em></a></td>
347    <td valign="top">apply a convolution kernel to the image</td>
348  </tr>
349
350  <tr>
351    <td valign="top"><a href="../www/command-line-options.html#crop" target="magick-options">-crop <em class="option">geometry</em></a></td>
352    <td valign="top">crop the image</td>
353  </tr>
354
355  <tr>
356    <td valign="top"><a href="../www/command-line-options.html#cycle" target="magick-options">-cycle <em class="option">amount</em></a></td>
357    <td valign="top">cycle the image colormap</td>
358  </tr>
359
360  <tr>
361    <td valign="top"><a href="../www/command-line-options.html#decipher" target="magick-options">-decipher <em class="option">filename</em></a></td>
362    <td valign="top">convert cipher pixels to plain</td>
363  </tr>
364
365  <tr>
366    <td valign="top"><a href="../www/command-line-options.html#debug" target="magick-options">-debug <em class="option">events</em></a></td>
367    <td valign="top">display copious debugging information</td>
368  </tr>
369
370  <tr>
371    <td valign="top"><a href="../www/command-line-options.html#define" target="magick-options">-define <em class="option">format:option</em></a></td>
372    <td valign="top">define one or more image format options</td>
373  </tr>
374
375  <tr>
376    <td valign="top"><a href="../www/command-line-options.html#deconstruct" target="magick-options">-deconstruct</a></td>
377    <td valign="top">break down an image sequence into constituent parts</td>
378  </tr>
379
380  <tr>
381    <td valign="top"><a href="../www/command-line-options.html#delay" target="magick-options">-delay <em class="option">value</em></a></td>
382    <td valign="top">display the next image after pausing</td>
383  </tr>
384
385  <tr>
386    <td valign="top"><a href="../www/command-line-options.html#delete" target="magick-options">-delete <em class="option">index</em></a></td>
387    <td valign="top">delete the image from the image sequence</td>
388  </tr>
389
390  <tr>
391    <td valign="top"><a href="../www/command-line-options.html#density" target="magick-options">-density <em class="option">geometry</em></a></td>
392    <td valign="top">horizontal and vertical density of the image</td>
393  </tr>
394
395  <tr>
396    <td valign="top"><a href="../www/command-line-options.html#depth" target="magick-options">-depth <em class="option">value</em></a></td>
397    <td valign="top">image depth</td>
398  </tr>
399
400  <tr>
401    <td valign="top"><a href="../www/command-line-options.html#despeckle" target="magick-options">-despeckle</a></td>
402    <td valign="top">reduce the speckles within an image</td>
403  </tr>
404
405  <tr>
406    <td valign="top"><a href="../www/command-line-options.html#display" target="magick-options">-display <em class="option">server</em></a></td>
407    <td valign="top">get image or font from this X server</td>
408  </tr>
409
410  <tr>
411    <td valign="top"><a href="../www/command-line-options.html#dispose" target="magick-options">-dispose <em class="option">method</em></a></td>
412    <td valign="top">layer disposal method</td>
413  </tr>
414
415  <tr>
416    <td valign="top"><a href="../www/command-line-options.html#distort" target="magick-options">-distort <em class="option">type coefficients</em></a></td>
417    <td valign="top">distort image</td>
418  </tr>
419
420  <tr>
421    <td valign="top"><a href="../www/command-line-options.html#dither" target="magick-options">-dither  <em class="option">method</em></a></td>
422    <td valign="top">apply error diffusion to image</td>
423  </tr>
424
425  <tr>
426    <td valign="top"><a href="../www/command-line-options.html#draw" target="magick-options">-draw <em class="option">string</em></a></td>
427    <td valign="top">annotate the image with a graphic primitive</td>
428  </tr>
429
430  <tr>
431    <td valign="top"><a href="../www/command-line-options.html#edge" target="magick-options">-edge <em class="option">radius</em></a></td>
432    <td valign="top">apply a filter to detect edges in the image</td>
433  </tr>
434
435  <tr>
436    <td valign="top"><a href="../www/command-line-options.html#emboss" target="magick-options">-emboss <em class="option">radius</em></a></td>
437    <td valign="top">emboss an image</td>
438  </tr>
439
440  <tr>
441    <td valign="top"><a href="../www/command-line-options.html#encipher" target="magick-options">-encipher <em class="option">filename</em></a></td>
442    <td valign="top">convert plain pixels to cipher pixels</td>
443  </tr>
444
445  <tr>
446    <td valign="top"><a href="../www/command-line-options.html#encoding" target="magick-options">-encoding <em class="option">type</em></a></td>
447    <td valign="top">text encoding type</td>
448  </tr>
449
450  <tr>
451    <td valign="top"><a href="../www/command-line-options.html#endian" target="magick-options">-endian <em class="option">type</em></a>