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