1convert(1) General Commands Manual convert(1)
2
3
4
6 convert - convert between image formats as well as resize an image,
7 blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much
8 more.
9
11 convert [input-option] input-file [output-option] output-file
12
14 The convert program is a member of the ImageMagick(1) suite of tools.
15 Use it to convert between image formats as well as resize an image,
16 blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much
17 more.
18
19 For more information about the convert command, point your browser to
20 file:///usr/share/doc/ImageMagick-6.7.8/www/convert.html or
21 http://www.imagemagick.org/script/convert.php.
22
24 Image Settings:
25 -adjoin join images into a single multi-image file
26 -affine matrix affine transform matrix
27 -alpha option activate, deactivate, reset, or set the alpha
28 channel
29 -antialias remove pixel-aliasing
30 -authenticate value decrypt image with this password
31 -attenuate value lessen (or intensify) when adding noise to an
32 image
33 -background color background color
34 -bias value add bias when convolving an image
35 -black-point-compensation
36 use black point compensation
37 -blue-primary point chromaticity blue primary point
38 -bordercolor color border color
39 -caption string assign a caption to an image
40 -cdl filename color correct with a color decision list
41 -channel type apply option to select image channels
42 -colors value preferred number of colors in the image
43 -colorspace type alternate image colorspace
44 -comment string annotate image with comment
45 -compose operator set image composite operator
46 -compress type type of pixel compression when writing the image
47 -decipher filename convert cipher pixels to plain pixels
48 -define format:option
49 define one or more image format options
50 -delay value display the next image after pausing
51 -density geometry horizontal and vertical density of the image
52 -depth value image depth
53 -direction type render text right-to-left or left-to-right
54 -display server get image or font from this X server
55 -dispose method layer disposal method
56 -dither method apply error diffusion to image
57 -encipher filename convert plain pixels to cipher pixels
58 -encoding type text encoding type
59 -endian type endianness (MSB or LSB) of the image
60 -family name render text with this font family
61 -features distance analyze image features (e.g. contrast, correla‐
62 tion)
63 -fill color color to use when filling a graphic primitive
64 -filter type use this filter when resizing an image
65 -flatten flatten a sequence of images
66 -font name render text with this font
67 -format "string" output formatted image characteristics
68 -fuzz distance colors within this distance are considered equal
69 -gravity type horizontal and vertical text placement
70 -green-primary point chromaticity green primary point
71 -intent type type of rendering intent when managing the image
72 color
73 -interlace type type of image interlacing scheme
74 -interline-spacing value
75 set the space between two text lines
76 -interpolate method pixel color interpolation method
77 -interword-spacing value
78 set the space between two words
79 -kerning value set the space between two letters
80 -label string assign a label to an image
81 -limit type value pixel cache resource limit
82 -loop iterations add Netscape loop extension to your GIF anima‐
83 tion
84 -mask filename associate a mask with the image
85 -matte store matte channel if the image has one
86 -mattecolor color frame color
87 -monitor monitor progress
88 -orient type image orientation
89 -page geometry size and location of an image canvas (setting)
90 -ping efficiently determine image attributes
91 -pointsize value font point size
92 -precision value maximum number of significant digits to print
93 -preview type image preview type
94 -quality value JPEG/MIFF/PNG compression level
95 -quiet suppress all warning messages
96 -red-primary point chromaticity red primary point
97 -regard-warnings pay attention to warning messages
98 -remap filename transform image colors to match this set of col‐
99 ors
100 -respect-parentheses settings remain in effect until parenthesis
101 boundary
102 -sampling-factor geometry
103 horizontal and vertical sampling factor
104 -scene value image scene number
105 -seed value seed a new sequence of pseudo-random numbers
106 -size geometry width and height of image
107 -statistic type geometry
108 replace each pixel with corresponding statistic
109 from the neighborhood
110 -stretch type render text with this font stretch
111 -stroke color graphic primitive stroke color
112 -strokewidth value graphic primitive stroke width
113 -style type render text with this font style
114 -support factor resize support: > 1.0 is blurry, < 1.0 is sharp
115 -synchronize synchronize image to storage device
116 -taint declare the image as modified
117 -texture filename name of texture to tile onto the image back‐
118 ground
119 -tile-offset geometry
120 tile offset
121 -treedepth value color tree depth
122 -transparent-color color
123 transparent color
124 -undercolor color annotation bounding box color
125 -units type the units of image resolution
126 -verbose print detailed information about the image
127 -view FlashPix viewing transforms
128 -virtual-pixel method
129 virtual pixel access method
130 -weight type render text with this font weight
131 -white-point point chromaticity white point
132
133 Image Operators:
134 -adaptive-blur geometry
135 adaptively blur pixels; decrease effect near
136 edges
137 -adaptive-resize geometry
138 adaptively resize image with data dependent tri‐
139 angulation
140 -adaptive-sharpen geometry
141 adaptively sharpen pixels; increase effect near
142 edges
143 -annotate geometry text
144 annotate the image with text
145 -auto-gamma automagically adjust gamma level of image
146 -auto-level automagically adjust color levels of image
147 -auto-orient automatically orient image
148 -bench iterations measure performance
149 -black-threshold value
150 force all pixels below the threshold into black
151 -blue-shift factor simulate a scene at nighttime in the moonlight
152 -blur geometry reduce image noise and reduce detail levels
153 -border geometry surround image with a border of color
154 -brightness-contrast geometry
155 improve brightness / contrast of the image
156 -charcoal radius simulate a charcoal drawing
157 -chop geometry remove pixels from the image interior
158 -clamp restrict pixel range from 0 to the quantum depth
159 -clip clip along the first path from the 8BIM profile
160 -clip-mask filename associate a clip mask with the image
161 -clip-path id clip along a named path from the 8BIM profile
162 -colorize value colorize the image with the fill color
163 -color-matrix matrix apply color correction to the image
164 -contrast enhance or reduce the image contrast
165 -contrast-stretch geometry
166 improve contrast by `stretching' the intensity
167 range
168 -convolve coefficients
169 apply a convolution kernel to the image
170 -cycle amount cycle the image colormap
171 -deskew threshold straighten an image
172 -despeckle reduce the speckles within an image
173 -distort method args
174 distort images according to given method ad args
175 -draw string annotate the image with a graphic primitive
176 -edge radius apply a filter to detect edges in the image
177 -emboss radius emboss an image
178 -enhance apply a digital filter to enhance a noisy image
179 -equalize perform histogram equalization to an image
180 -evaluate operator value
181 evaluate an arithmetic, relational, or logical
182 expression
183 -extent geometry set the image size
184 -extract geometry extract area from image
185 -fft implements the discrete Fourier transform (DFT)
186 -flip flip image vertically
187 -floodfill geometry color
188 floodfill the image with color
189 -flop flop image horizontally
190 -frame geometry surround image with an ornamental border
191 -function name apply a function to the image
192 -gamma value level of gamma correction
193 -gaussian-blur geometry
194 reduce image noise and reduce detail levels
195 -geometry geometry preferred size or location of the image
196 -identify identify the format and characteristics of the
197 image
198 -ift implements the inverse discrete Fourier trans‐
199 form (DFT)
200 -implode amount implode image pixels about the center
201 -interpolative-resize geometry
202 resize image using 'point sampled' interpolation
203 -lat geometry local adaptive thresholding
204 -layers method optimize or compare image layers
205 -level value adjust the level of image contrast
206 -level-colors color,color
207 level image with the given colors
208 -linear-stretch geometry
209 improve contrast by `stretching with saturation'
210 the intensity range
211 -liquid-rescale geometry
212 rescale image with seam-carving
213 -median geometry apply a median filter to the image
214 -mode geometry make each pixel the 'predominant color' of the
215 neighborhood
216 -modulate value vary the brightness, saturation, and hue
217 -monochrome transform image to black and white
218 -morphology method kernel
219 apply a morphology method to the image
220 -motion-blur geometry
221 simulate motion blur
222 -negate replace each pixel with its complementary color
223 -noise geometry add or reduce noise in an image
224 -normalize transform image to span the full range of colors
225 -opaque color change this color to the fill color
226 -ordered-dither NxN
227 add a noise pattern to the image with specific
228 amplitudes
229 -paint radius simulate an oil painting
230 -polaroid angle simulate a Polaroid picture
231 -posterize levels reduce the image to a limited number of color
232 levels
233 -print string interpret string and print to console
234 -profile filename add, delete, or apply an image profile
235 -quantize colorspace reduce colors in this colorspace
236 -radial-blur angle radial blur the image
237 -raise value lighten/darken image edges to create a 3-D
238 effect
239 -random-threshold low,high
240 random threshold the image
241 -region geometry apply options to a portion of the image
242 -render render vector graphics
243 -repage geometry size and location of an image canvas
244 -resample geometry change the resolution of an image
245 -resize geometry resize the image
246 -roll geometry roll an image vertically or horizontally
247 -rotate degrees apply Paeth rotation to the image
248 -sample geometry scale image with pixel sampling
249 -scale geometry scale the image
250 -segment values segment an image
251 -selective-blur geometry
252 selectively blur pixels within a contrast
253 threshold
254 -sepia-tone threshold
255 simulate a sepia-toned photo
256 -set property value set an image property
257 -shade degrees shade the image using a distant light source
258 -shadow geometry simulate an image shadow
259 -sharpen geometry sharpen the image
260 -shave geometry shave pixels from the image edges
261 -shear geometry slide one edge of the image along the X or Y
262 axis
263 -sigmoidal-contrast geometry
264 lightness rescaling using sigmoidal contrast
265 enhancement
266 -sketch geometry simulate a pencil sketch
267 -solarize threshold negate all pixels above the threshold level
268 -sparse-color method args
269 fill in a image based on a few color points
270 -splice geometry splice the background color into the image
271 -spread amount displace image pixels by a random amount
272 -strip strip image of all profiles and comments
273 -swirl degrees swirl image pixels about the center
274 -threshold value threshold the image
275 -thumbnail geometry create a thumbnail of the image
276 -tile filename tile image when filling a graphic primitive
277 -tint value tint the image with the fill color
278 -transform affine transform image
279 -transparent color make this color transparent within the image
280 -transpose flip image vertically and rotate 90 degrees
281 -transverse flop image horizontally and rotate 270 degrees
282 -trim trim image edges
283 -type type image type
284 -unique-colors discard all but one of any pixel color
285 -unsharp geometry sharpen the image
286 -vignette geometry soften the edges of the image in vignette style
287 -wave geometry alter an image along a sine wave
288 -white-threshold value
289 force all pixels above the threshold into white
290
291 Image Sequence Operators:
292 -append append an image sequence top to bottom (use
293 +append for left to right)
294 -clut apply a color lookup table to the image
295 -coalesce merge a sequence of images
296 -combine combine a sequence of images
297 -composite composite image
298 -crop geometry cut out a rectangular region of the image
299 -deconstruct break down an image sequence into constituent
300 parts
301 -evaluate-sequence operator
302 evaluate an arithmetic, relational, or logical
303 expression
304 -flatten flatten a sequence of images
305 -fx expression apply mathematical expression to an image chan‐
306 nel(s)
307 -hald-clut apply a Hald color lookup table to the image
308 -morph value morph an image sequence
309 -mosaic create a mosaic from an image sequence
310 -process arguments process the image with a custom image filter
311 -separate separate an image channel into a grayscale image
312 -smush geometry smush an image sequence together
313 -write filename write images to this file
314
315 Image Stack Operators:
316 -clone indexes clone an image
317 -delete indexes delete the image from the image sequence
318 -duplicate count,indexes
319 duplicate an image one or more times
320 -insert index insert last image into the image sequence
321 -reverse reverse image sequence
322 -swap indexes swap two images in the image sequence
323
324 Miscellaneous Options:
325 -debug events display copious debugging information
326 -help print program options
327 -log format format of debugging information
328 -list type print a list of supported option arguments
329 -version print version information
330
331 Use any setting or operator as an output-option. Only a limited number
332 of setting are input-option. They include: -antialias, -caption, -den‐
333 sity, -define, -encoding, -font, -pointsize, -size, and -texture as
334 well as any of the miscellaneous options.
335
336 By default, the image format of `file' is determined by its magic num‐
337 ber. To specify a particular image format, precede the filename with
338 an image format name and a colon (i.e. ps:image) or specify the image
339 type as the filename suffix (i.e. image.ps). Specify 'file' as '-' for
340 standard input or output.
341
343 ImageMagick(1)
344
345
347 Copyright (C) 1999-2012 ImageMagick Studio LLC. Additional copyrights
348 and licenses apply to this software, see
349 file:///usr/share/doc/ImageMagick-6.7.8/www/license.html or
350 http://www.imagemagick.org/script/license.php
351
352
353
354ImageMagick Date: 2009/01/10 01:00:00 convert(1)