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