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-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-6.6.4/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 -stretch type render text with this font stretch
94 -stroke color graphic primitive stroke color
95 -strokewidth value graphic primitive stroke width
96 -style type render text with this font style
97 -support factor resize support: > 1.0 is blurry, < 1.0 is sharp
98 -texture filename name of texture to tile onto the image back‐
99 ground
100 -tile-offset geometry
101 tile offset
102 -treedepth value color tree depth
103 -transparent-color color
104 transparent color
105 -undercolor color annotation bounding box color
106 -units type the units of image resolution
107 -verbose print detailed information about the image
108 -view FlashPix viewing transforms
109 -virtual-pixel method
110 virtual pixel access method
111 -weight type render text with this font weight
112 -white-point point chromaticity white point
113 Image Operators:
115 -adaptive-blur geometry
116 adaptively blur pixels; decrease effect near
117 edges
118 -adaptive-resize geometry
119 adaptively resize image with data dependent tri‐
120 angulation
121 -adaptive-sharpen geometry
122 adaptively sharpen pixels; increase effect near
123 edges
124 -annotate geometry text
125 annotate the image with text
126 -auto-orient automatically orient image
127 -black-threshold value
128 force all pixels below the threshold into black
129 -blur geometry reduce image noise and reduce detail levels
130 -border geometry surround image with a border of color
131 -charcoal radius simulate a charcoal drawing
132 -chop geometry remove pixels from the image interior
133 -clip clip along the first path from the 8BIM profile
134 -clip-mask filename associate a clip mask with the image
135 -clip-path id clip along a named path from the 8BIM profile
136 -colorize value colorize the image with the fill color
137 -color-matrix matrix apply color correction to the image
138 -contrast enhance or reduce the image contrast
139 -contrast-stretch geometry
140 improve contrast by `stretching' the intensity
141 range
142 -convolve coefficients
143 apply a convolution kernel to the image
144 -cycle amount cycle the image colormap
145 -despeckle reduce the speckles within an image
146 -draw string annotate the image with a graphic primitive
147 -edge radius apply a filter to detect edges in the image
148 -emboss radius emboss an image
149 -enhance apply a digital filter to enhance a noisy image
150 -equalize perform histogram equalization to an image
151 -evaluate operator value
152 evaluate an arithmetic, relational, or logical
153 expression
154 -extent geometry set the image size
155 -extract geometry extract area from image
156 -fft implements the discrete Fourier transform (DFT)
157 -flip flip image vertically
158 -floodfill geometry color
159 floodfill the image with color
160 -flop flop image horizontally
161 -frame geometry surround image with an ornamental border
162 -function name apply a function to the image
163 -gamma value level of gamma correction
164 -gaussian-blur geometry
165 reduce image noise and reduce detail levels
166 -geometry geometry preferred size or location of the image
167 -identify identify the format and characteristics of the
168 image
169 -ift implements the inverse discrete Fourier trans‐
170 form (DFT)
171 -implode amount implode image pixels about the center
172 -lat geometry local adaptive thresholding
173 -layers method optimize or compare image layers
174 -level value adjust the level of image contrast
175 -linear-stretch geometry
176 improve contrast by `stretching with saturation'
177 the intensity range
178 -median radius apply a median filter to the image
179 -modulate value vary the brightness, saturation, and hue
180 -monochrome transform image to black and white
181 -morphology method kernel
182 apply a morphology method to the image
183 -motion-blur geometry
184 simulate motion blur
185 -negate replace each pixel with its complementary color
186 -noise radius add or reduce noise in an image
187 -normalize transform image to span the full range of colors
188 -opaque color change this color to the fill color
189 -ordered-dither NxN
190 add a noise pattern to the image with specific
191 amplitudes
192 -paint radius simulate an oil painting
193 -polaroid angle simulate a Polaroid picture
194 -posterize levels reduce the image to a limited number of color
195 levels
196 -print string interpret string and print to console
197 -profile filename add, delete, or apply an image profile
198 -quantize colorspace reduce colors in this colorspace
199 -radial-blur angle radial blur the image
200 -raise value lighten/darken image edges to create a 3-D
201 effect
202 -random-threshold low,high
203 random threshold the image
204 -region geometry apply options to a portion of the image
205 -render render vector graphics
206 -repage geometry size and location of an image canvas
207 -resample geometry change the resolution of an image
208 -resize geometry resize the image
209 -roll geometry roll an image vertically or horizontally
210 -rotate degrees apply Paeth rotation to the image
211 -sample geometry scale image with pixel sampling
212 -scale geometry scale the image
213 -segment values segment an image
214 -selective-blur geometry
215 selectively blur pixels within a contrast
216 threshold
217 -sepia-tone threshold
218 simulate a sepia-toned photo
219 -set property value set an image property
220 -shade degrees shade the image using a distant light source
221 -shadow geometry simulate an image shadow
222 -sharpen geometry sharpen the image
223 -shave geometry shave pixels from the image edges
224 -shear geometry slide one edge of the image along the X or Y
225 axis
226 -sigmoidal-contrast geometry
227 lightness rescaling using sigmoidal contrast
228 enhancement
229 -sketch geometry simulate a pencil sketch
230 -solarize threshold negate all pixels above the threshold level
231 -splice geometry splice the background color into the image
232 -spread amount displace image pixels by a random amount
233 -strip strip image of all profiles and comments
234 -swirl degrees swirl image pixels about the center
235 -threshold value threshold the image
236 -thumbnail geometry create a thumbnail of the image
237 -tile filename tile image when filling a graphic primitive
238 -tint value tint the image with the fill color
239 -transform affine transform image
240 -transparent color make this color transparent within the image
241 -transpose flip image vertically and rotate 90 degrees
242 -transverse flop image horizontally and rotate 270 degrees
243 -trim trim image edges
244 -type type image type
245 -unique-colors discard all but one of any pixel color
246 -unsharp geometry sharpen the image
247 -vignette geometry soften the edges of the image in vignette style
248 -wave geometry alter an image along a sine wave
249 -white-threshold value
250 force all pixels above the threshold into white
251 Image Sequence Operators:
253 -affinity filename transform image colors to match this set of col‐
254 ors
255 -append append an image sequence
256 -clut apply a color lookup table to the image
257 -coalesce merge a sequence of images
258 -combine combine a sequence of images
259 -composite composite image
260 -crop geometry cut out a rectangular region of the image
261 -deconstruct break down an image sequence into constituent
262 parts
263 -evaluate-sequence operator
264 evaluate an arithmetic, relational, or logical
265 expression
266 -flatten flatten a sequence of images
267 -fx expression apply mathematical expression to an image chan‐
268 nel(s)
269 -hald-clut apply a Hald color lookup table to the image
270 -morph value morph an image sequence
271 -mosaic create a mosaic from an image sequence
272 -process arguments process the image with a custom image filter
273 -separate separate an image channel into a grayscale image
274 -write filename write images to this file
275 Image Stack Operators:
277 -clone index clone an image
278 -delete index delete the image from the image sequence
279 -insert index insert last image into the image sequence
280 -swap indexes swap two images in the image sequence
281 Miscellaneous Options:
283 -debug events display copious debugging information
284 -help print program options
285 -log format format of debugging information
286 -list type print a list of supported option arguments
287 -version print version information
288 By default, the image format of `file' is determined by its magic num‐
290 ber. To specify a particular image format, precede the filename with
291 an image format name and a colon (i.e. ps:image) or specify the image
292 type as the filename suffix (i.e. image.ps). Specify 'file' as '-' for
293 standard input or output.
294
296 ImageMagick(1)
297
300 Copyright (C) 1999-2010 ImageMagick Studio LLC. Additional copyrights
301 and licenses apply to this software, see
302 file:///usr/share/doc/ImageMagick-6.6.4/www/license.html or
303 http://www.imagemagick.org/script/license.php
304ImageMagick Date: 2009/01/10 01:00:00 convert(1)