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