1convert(1)                  General Commands Manual                 convert(1)
2
3
4

NAME

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

SYNOPSIS

11       convert [input-option] input-file [output-option] output-file
12

OVERVIEW

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/www/convert.html                 or
21       http://imagemagick.org/script/convert.php.
22

DESCRIPTION

24       Image Settings:
25         -adjoin              join images into a single multi-image file
26         -affine matrix       affine transform matrix
27         -alpha option        activate, deactivate, reset, or  set  the  alpha
28       channel
29         -antialias           remove pixel-aliasing
30         -authenticate value  decrypt image with this password
31         -attenuate  value      lessen  (or intensify) when adding noise to an
32       image
33         -background color    background color
34         -bias value          add bias when convolving an image
35         -black-point-compensation
36                              use black point compensation
37         -blue-primary point  chromaticity blue primary point
38         -bordercolor color   border color
39         -caption string      assign a caption to an image
40         -cdl filename        color correct with a color decision list
41         -channel type        apply option to select image channels
42         -clip                clip along the first path from the 8BIM profile
43         -clip-mask filename  associate a clip mask with the image
44         -clip-path id        clip along a named path from the 8BIM profile
45         -colors value        preferred number of colors in the image
46         -colorspace type     alternate image colorspace
47         -comment string      annotate image with comment
48         -compose operator    set image composite operator
49         -compress type       type of pixel compression when writing the image
50         -decipher filename   convert cipher pixels to plain pixels
51         -define format:option
52                              define one or more image format options
53         -delay value         display the next image after pausing
54         -density geometry    horizontal and vertical density of the image
55         -depth value         image depth
56         -direction type      render text right-to-left or left-to-right
57         -display server      get image or font from this X server
58         -dispose method      layer disposal method
59         -dither method       apply error diffusion to image
60         -encipher filename   convert plain pixels to cipher pixels
61         -encoding type       text encoding type
62         -endian type         endianness (MSB or LSB) of the image
63         -family name         render text with this font family
64         -features distance   analyze image features (e.g. contrast,  correla‐
65       tion)
66         -fill color          color to use when filling a graphic primitive
67         -filter type         use this filter when resizing an image
68         -flatten             flatten a sequence of images
69         -font name           render text with this font
70         -format "string"     output formatted image characteristics
71         -fuzz distance       colors within this distance are considered equal
72         -gravity type        horizontal and vertical text placement
73         -green-primary point chromaticity green primary point
74         -intensity method    method to generate intensity value from pixel
75         -intent type         type of rendering intent when managing the image
76       color
77         -interlace type      type of image interlacing scheme
78         -interline-spacing value
79                              set the space between two text lines
80         -interpolate method  pixel color interpolation method
81         -interword-spacing value
82                              set the space between two words
83         -kerning value       set the space between two letters
84         -label string        assign a label to an image
85         -limit type value    pixel cache resource limit
86         -loop iterations     add Netscape loop extension to your  GIF  anima‐
87       tion
88         -mask filename       associate a mask with the image
89         -matte               store matte channel if the image has one
90         -mattecolor color    frame color
91         -metric  type          measure  differences  between images with this
92       metric
93         -moments             report image moments
94         -monitor             monitor progress
95         -orient type         image orientation
96         -page geometry       size and location of an image canvas (setting)
97         -ping                efficiently determine image attributes
98         -pointsize value     font point size
99         -precision value     maximum number of significant digits to print
100         -preview type        image preview type
101         -quality value       JPEG/MIFF/PNG compression level
102         -quiet               suppress all warning messages
103         -red-primary point   chromaticity red primary point
104         -regard-warnings     pay attention to warning messages
105         -remap filename      transform image colors to match this set of col‐
106       ors
107         -repage geometry     size and location of an image canvas
108         -respect-parentheses  settings  remain  in  effect  until parenthesis
109       boundary
110         -sampling-factor geometry
111                              horizontal and vertical sampling factor
112         -scene value         image scene number
113         -seed value          seed a new sequence of pseudo-random numbers
114         -size geometry       width and height of image
115         -statistic type geometry
116                              replace each pixel with corresponding  statistic
117       from the neighborhood
118         -stretch type        render text with this font stretch
119         -stroke color        graphic primitive stroke color
120         -strokewidth value   graphic primitive stroke width
121         -style type          render text with this font style
122         -support factor      resize support: > 1.0 is blurry, < 1.0 is sharp
123         -synchronize         synchronize image to storage device
124         -taint               declare the image as modified
125         -texture  filename     name  of  texture to tile onto the image back‐
126       ground
127         -tile-offset geometry
128                              tile offset
129         -treedepth value     color tree depth
130         -transparent-color color
131                              transparent color
132         -undercolor color    annotation bounding box color
133         -units type          the units of image resolution
134         -verbose             print detailed information about the image
135         -view                FlashPix viewing transforms
136         -virtual-pixel method
137                              virtual pixel access method
138         -weight type         render text with this font weight
139         -white-point point   chromaticity white point
140
141       Image Operators:
142         -adaptive-blur geometry
143                              adaptively blur  pixels;  decrease  effect  near
144       edges
145         -adaptive-resize geometry
146                              adaptively resize image with data dependent tri‐
147       angulation
148         -adaptive-sharpen geometry
149                              adaptively sharpen pixels; increase effect  near
150       edges
151         -annotate geometry text
152                              annotate the image with text
153         -auto-gamma          automagically adjust gamma level of image
154         -auto-level          automagically adjust color levels of image
155         -auto-orient         automatically orient image
156         -bench iterations    measure performance
157         -black-threshold value
158                              force all pixels below the threshold into black
159         -blue-shift factor   simulate a scene at nighttime in the moonlight
160         -blur geometry       reduce image noise and reduce detail levels
161         -border geometry     surround image with a border of color
162         -brightness-contrast geometry
163                               improve brightness / contrast of the image
164         -canny geometry      detect edges in the image
165         -charcoal radius     simulate a charcoal drawing
166         -chop geometry       remove pixels from the image interior
167         -clamp               keep pixel values in range (0-QuantumRange)
168         -clip                clip along the first path from the 8BIM profile
169         -clip-mask filename  associate a clip mask with the image
170         -clip-path id        clip along a named path from the 8BIM profile
171         -colorize value      colorize the image with the fill color
172         -color-matrix matrix apply color correction to the image
173         -connected-component connectivity
174                              connected-components uniquely labeled
175         -contrast            enhance or reduce the image contrast
176         -contrast-stretch geometry
177                              improve  contrast  by `stretching' the intensity
178       range
179         -convolve coefficients
180                              apply a convolution kernel to the image
181         -cycle amount        cycle the image colormap
182         -deskew threshold    straighten an image
183         -despeckle           reduce the speckles within an image
184         -distort method args
185                               distort images according to  given  method  and
186       args
187         -draw string         annotate the image with a graphic primitive
188         -edge radius         apply a filter to detect edges in the image
189         -emboss radius       emboss an image
190         -enhance             apply a digital filter to enhance a noisy image
191         -equalize            perform histogram equalization to an image
192         -evaluate operator value
193                              evaluate  an  arithmetic, relational, or logical
194       expression
195         -extent geometry     set the image size
196         -extract geometry    extract area from image
197         -fft                 implements the discrete Fourier transform (DFT)
198         -flip                flip image vertically
199         -floodfill geometry color
200                              floodfill the image with color
201         -flop                flop image horizontally
202         -frame geometry      surround image with an ornamental border
203         -function name       apply a function to the image
204         -gamma value         level of gamma correction
205         -gaussian-blur geometry
206                              reduce image noise and reduce detail levels
207         -geometry geometry   preferred size or location of the image
208         -grayscale method    convert image to grayscale
209         -hough-lines geometry
210                              identify lines in the image
211         -identify            identify the format and characteristics  of  the
212       image
213         -ift                  implements  the inverse discrete Fourier trans‐
214       form (DFT)
215         -implode amount      implode image pixels about the center
216         -interpolative-resize geometry
217                               resize image using 'point  sampled'  interpola‐
218       tion
219         -lat geometry        local adaptive thresholding
220         -layers method       optimize or compare image layers
221         -level value         adjust the level of image contrast
222         -level-colors color,color
223                              level image with the given colors
224         -linear-stretch geometry
225                              improve contrast by `stretching with saturation'
226       the intensity range
227         -liquid-rescale geometry
228                               rescale image with seam-carving
229         -magnify             double the size of  the  image  with  pixel  art
230       scaling
231         -mean-shift  geometry  delineate  arbitrarily  shaped clusters in the
232       image
233         -median geometry     apply a median filter to the image
234         -mode geometry       make each pixel the 'predominant color'  of  the
235       neighborhood
236         -modulate value      vary the brightness, saturation, and hue
237         -monochrome          transform image to black and white
238         -morphology method kernel
239                              apply a morphology method to the image
240         -motion-blur geometry
241                              simulate motion blur
242         -negate              replace each pixel with its complementary color
243         -noise geometry      add or reduce noise in an image
244         -normalize           transform image to span the full range of colors
245         -opaque color        change this color to the fill color
246         -ordered-dither NxN
247                              add  a  noise pattern to the image with specific
248       amplitudes
249         -paint radius        simulate an oil painting
250         -perceptible epsilon
251                              pixel value less than |epsilon|  become  epsilon
252       or -epsilon
253         -polaroid angle      simulate a Polaroid picture
254         -posterize  levels     reduce  the image to a limited number of color
255       levels
256         -print string        interpret string and print to console
257         -profile filename    add, delete, or apply an image profile
258         -quantize colorspace reduce colors in this colorspace
259         -radial-blur angle   radial blur the image
260         -raise value         lighten/darken  image  edges  to  create  a  3-D
261       effect
262         -random-threshold low,high
263                              random threshold the image
264         -region geometry     apply options to a portion of the image
265         -render              render vector graphics
266         -resample geometry   change the resolution of an image
267         -resize geometry     resize the image
268         -roll geometry       roll an image vertically or horizontally
269         -rotate degrees      apply Paeth rotation to the image
270         -sample geometry     scale image with pixel sampling
271         -scale geometry      scale the image
272         -segment values      segment an image
273         -selective-blur geometry
274                              selectively   blur   pixels  within  a  contrast
275       threshold
276         -sepia-tone threshold
277                              simulate a sepia-toned photo
278         -set property value  set an image property
279         -shade degrees       shade the image using a distant light source
280         -shadow geometry     simulate an image shadow
281         -sharpen geometry    sharpen the image
282         -shave geometry      shave pixels from the image edges
283         -shear geometry      slide one edge of the image along  the  X  or  Y
284       axis
285         -sigmoidal-contrast geometry
286                              lightness  rescaling  using  sigmoidal  contrast
287       enhancement
288         -sketch geometry     simulate a pencil sketch
289         -solarize threshold  negate all pixels above the threshold level
290         -sparse-color method args
291                               fill in a image based on a few color points
292         -splice geometry     splice the background color into the image
293         -spread amount       displace image pixels by a random amount
294         -strip               strip image of all profiles and comments
295         -swirl degrees       swirl image pixels about the center
296         -threshold value     threshold the image
297         -thumbnail geometry  create a thumbnail of the image
298         -tile filename       tile image when filling a graphic primitive
299         -tint value          tint the image with the fill color
300         -transform           affine transform image
301         -transparent color   make this color transparent within the image
302         -transpose           flip image vertically and rotate 90 degrees
303         -transverse          flop image horizontally and rotate 270 degrees
304         -trim                trim image edges
305         -type type           image type
306         -unique-colors       discard all but one of any pixel color
307         -unsharp geometry    sharpen the image
308         -vignette geometry   soften the edges of the image in vignette style
309         -wave geometry       alter an image along a sine wave
310         -wavelet-denoise threshold
311                               removes noise from the image  using  a  wavelet
312       transform
313         -white-threshold value
314                              force all pixels above the threshold into white
315
316       Image Sequence Operators:
317         -append               append  an  image  sequence  top to bottom (use
318       +append for left to right)
319         -clut                apply a color lookup table to the image
320         -coalesce            merge a sequence of images
321         -combine             combine a sequence of images
322         -compare             mathematically and visually annotate the differ‐
323       ence between an image and its reconstruction
324         -complex operator    perform complex mathematics on an image sequence
325         -composite           composite image
326         -copy geometry offset,
327                              copy pixels from one area of an image to another
328         -crop geometry       cut out a rectangular region of the image
329         -deconstruct          break  down  an image sequence into constituent
330       parts
331         -evaluate-sequence operator
332                              evaluate an arithmetic, relational,  or  logical
333       expression
334         -flatten             flatten a sequence of images
335         -fx  expression       apply mathematical expression to an image chan‐
336       nel(s)
337         -hald-clut           apply a Hald color lookup table to the image
338         -morph value         morph an image sequence
339         -mosaic              create a mosaic from an image sequence
340         -poly terms          build a polynomial from the image  sequence  and
341       the corresponding terms (coefficients and degree pairs)
342         -process arguments   process the image with a custom image filter
343         -separate            separate an image channel into a grayscale image
344         -smush geometry      smush an image sequence together
345         -write filename      write images to this file
346
347       Image Stack Operators:
348         -clone indexes       clone an image
349         -delete indexes      delete the image from the image sequence
350         -duplicate count,indexes
351                              duplicate an image one or more times
352         -insert index        insert last image into the image sequence
353         -reverse             reverse image sequence
354         -swap indexes        swap two images in the image sequence
355
356       Miscellaneous Options:
357         -debug events        display copious debugging information
358         -distribute-cache port
359                              distributed  pixel  cache  spanning  one or more
360       servers
361         -help                print program options
362         -log format          format of debugging information
363         -list type           print a list of supported option arguments
364         -version             print version information
365
366       Use any setting or operator as an output-option.  Only a limited number
367       of setting are  input-option. They include: -antialias, -caption, -den‐
368       sity, -define, -encoding, -font, -pointsize,  -size,  and  -texture  as
369       well as any of the miscellaneous options.
370
371       By  default, the image format of `file' is determined by its magic num‐
372       ber.  To specify a particular image format, precede the  filename  with
373       an  image  format name and a colon (i.e. ps:image) or specify the image
374       type as the filename suffix (i.e. image.ps).  Specify 'file' as '-' for
375       standard input or output.
376

SEE ALSO

378       ImageMagick(1)
379
380
382       Copyright  (C)  1999-2019 ImageMagick Studio LLC. Additional copyrights
383       and      licenses      apply      to      this      software,       see
384       file:///usr/share/doc/ImageMagick-6/www/license.html                 or
385       http://imagemagick.org/script/license.php
386
387
388
389ImageMagick                Date: 2009/01/10 01:00:00                convert(1)
Impressum