1mogrify(1) General Commands Manual mogrify(1)
2
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
11 mogrify [options] input-file
12
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 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
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 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 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 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 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 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
381 ImageMagick(1)
382
385 Copyright (C) 1999-2019 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
389ImageMagick Date: 2009/01/10 01:00:00 mogrify(1)