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

NAME

6       mogrify  -  resize  an  image,  blur, crop, despeckle, dither, draw on,
7       flip, join, re-sample, and much more. Mogrify overwrites  the  original
8       image file, whereas, convert(1) writes to a different image file.
9

SYNOPSIS

11       mogrify [options] input-file
12

OVERVIEW

14       The  mogrify  program is a member of the ImageMagick(1) suite of tools.
15       Use it to resize an image, blur,  crop,  despeckle,  dither,  draw  on,
16       flip,  join,  re-sample,  and  much  more. This tool is similar to con‐
17       vert(1) except the original image file is overwritten with any  changes
18       you request.
19
20       For  more  information about the mogrify command, point your browser to
21       file:///usr/share/doc/ImageMagick-6/www/mogrify.html                 or
22       http://imagemagick.org/script/mogrify.php.
23

DESCRIPTION

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

SEE ALSO

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