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