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