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