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