1mogrify(1) General Commands Manual mogrify(1)
2
3
4
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
20 For more information about the mogrify command, point your browser to
21 file:///usr/share/doc/ImageMagick-6.7.8/www/mogrify.html or
22 http://www.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 -intent type type of rendering intent when managing the image
74 color
75 -interlace type type of image interlacing scheme
76 -interline-spacing value set the space between two text lines
77 -interpolate method pixel color interpolation method
78 -interword-spacing value set the space between two words
79 -kerning value set the space between two letters
80 -label string assign a label to an image
81 -limit type value pixel cache resource limit
82 -loop iterations add Netscape loop extension to your GIF anima‐
83 tion
84 -mask filename associate a mask with the image
85 -matte store matte channel if the image has one
86 -mattecolor color frame color
87 -monitor monitor progress
88 -morphology method kernel
89 apply a morphology method to the image
90 -orient type image orientation
91 -page geometry size and location of an image canvas (setting)
92 -path path write images to this path on disk
93 -ping efficiently determine image attributes
94 -pointsize value font point size
95 -precision value maximum number of significant digits to print
96 -preview type image preview type
97 -quality value JPEG/MIFF/PNG compression level
98 -quiet suppress all warning messages
99 -red-primary point chromaticity red primary point
100 -regard-warnings pay attention to warning messages
101 -remap filename transform image colors to match this set of col‐
102 ors
103 -respect-parentheses settings remain in effect until parenthesis
104 boundary
105 -sampling-factor geometry
106 horizontal and vertical sampling factor
107 -scene value image scene number
108 -seed value seed a new sequence of pseudo-random numbers
109 -size geometry width and height of image
110 -stretch type render text with this font stretch
111 -stroke color graphic primitive stroke color
112 -strokewidth value graphic primitive stroke width
113 -style type render text with this font style
114 -synchronize synchronize image to storage device
115 -taint declare the image as modified
116 -texture filename name of texture to tile onto the image back‐
117 ground
118 -tile-offset geometry
119 tile offset
120 -treedepth value color tree depth
121 -transparent-color color
122 transparent color
123 -undercolor color annotation bounding box color
124 -units type the units of image resolution
125 -verbose print detailed information about the image
126 -view FlashPix viewing transforms
127 -virtual-pixel method
128 virtual pixel access method
129 -weight type render text with this font weight
130 -white-point point chromaticity white point
131
132 Image Operators:
133 -adaptive-blur geometry
134 adaptively blur pixels; decrease effect near
135 edges
136 -adaptive-resize geometry
137 adaptively resize image with data dependent tri‐
138 angulation
139 -adaptive-sharpen geometry
140 adaptively sharpen pixels; increase effect near
141 edges
142 -alpha option on, activate, off, deactivate, set, opaque, copy
143 transparent, extract, background, or shape
144 -annotate geometry text
145 annotate the image with text
146 -auto-gamma automagically adjust gamma level of image
147 -auto-level automagically adjust color levels of image
148 -auto-orient automagically orient (rotate) image
149 -bench iterations measure performance
150 -black-threshold value
151 force all pixels below the threshold into black
152 -blue-shift simulate a scene at nighttime in the moonlight
153 -blur geometry reduce image noise and reduce detail levels
154 -border geometry surround image with a border of color
155 -bordercolor color border color
156 -brightness-contrast geometry
157 improve brightness / contrast of the image
158 -cdl filename color correct with a color decision list
159 -charcoal radius simulate a charcoal drawing
160 -chop geometry remove pixels from the image interior
161 -clamp restrict pixel range from 0 to the quantum depth
162 -clip clip along the first path from the 8BIM profile
163 -clip-mask filename associate a clip mask with the image
164 -clip-path id clip along a named path from the 8BIM profile
165 -colorize value colorize the image with the fill color
166 -color-matrix matrix apply color correction to the image
167 -contrast enhance or reduce the image contrast
168 -contrast-stretch geometry
169 improve contrast by `stretching' the intensity
170 range
171 -convolve coefficients
172 apply a convolution kernel to the image
173 -cycle amount cycle the image colormap
174 -decipher filename convert cipher pixels to plain pixels
175 -deskew threshold straighten an image
176 -despeckle reduce the speckles within an image
177 -distort method args
178 distort images according to given method ad args
179 -draw string annotate the image with a graphic primitive
180 -edge radius apply a filter to detect edges in the image
181 -encipher filename convert plain pixels to cipher pixels
182 -emboss radius emboss an image
183 -enhance apply a digital filter to enhance a noisy image
184 -equalize perform histogram equalization to an image
185 -evaluate operator value
186 evaluate an arithmetic, relational, or logical
187 expression
188 -extent geometry set the image size
189 -extract geometry extract area from image
190 -features distance analyze image features (e.g. contrast, correla‐
191 tion)
192 -fft implements the discrete Fourier transform (DFT)
193 -flip flip image vertically
194 -floodfill geometry color
195 floodfill the image with color
196 -flop flop image horizontally
197 -frame geometry surround image with an ornamental border
198 -function name parameters
199 apply function over image values
200 -gamma value level of gamma correction
201 -gaussian-blur geometry
202 reduce image noise and reduce detail levels
203 -geometry geometry preferred size or location of the image
204 -help print program options
205 -identify identify the format and characteristics of the
206 image
207 -ift implements the inverse discrete Fourier trans‐
208 form (DFT)
209 -implode amount implode image pixels about the center
210 -lat geometry local adaptive thresholding
211 -layers method optimize, merge, or compare image layers
212 -level value adjust the level of image contrast
213 -level-colors color,color
214 level image with the given colors
215 -linear-stretch geometry
216 improve contrast by `stretching with saturation'
217 the intensity range
218 -liquid-rescale geometry
219 rescale image with seam-carving
220 -median geometry apply a median filter to the image
221 -mode geometry make each pixel the 'predominant color' of the
222 neighborhood
223 -modulate value vary the brightness, saturation, and hue
224 -monochrome transform image to black and white
225 -morphology method kernel
226 apply a morphology method to the image
227 -motion-blur geometry
228 simulate motion blur
229 -negate replace each pixel with its complementary color
230 -noise geometry add or reduce noise in an image
231 -normalize transform image to span the full range of colors
232 -opaque color change this color to the fill color
233 -ordered-dither NxN
234 add a noise pattern to the image with specific
235 amplitudes
236 -paint radius simulate an oil painting
237 -polaroid angle simulate a Polaroid picture
238 -posterize levels reduce the image to a limited number of color
239 levels
240 -print string interpret string and print to console
241 -profile filename add, delete, or apply an image profile
242 -quantize colorspace reduce colors in this colorspace
243 -radial-blur angle radial blur the image
244 -raise value lighten/darken image edges to create a 3-D
245 effect
246 -random-threshold low,high
247 random threshold the image
248 -region geometry apply options to a portion of the image
249 -render render vector graphics
250 -repage geometry size and location of an image canvas
251 -resample geometry change the resolution of an image
252 -resize geometry resize the image
253 -roll geometry roll an image vertically or horizontally
254 -rotate degrees apply Paeth rotation to the image
255 -sample geometry scale image with pixel sampling
256 -scale geometry scale the image
257 -segment values segment an image
258 -selective-blur geometry
259 selectively blur pixels within a contrast
260 threshold
261 -sepia-tone threshold
262 simulate a sepia-toned photo
263 -set property value set an image property
264 -shade degrees shade the image using a distant light source
265 -shadow geometry simulate an image shadow
266 -sharpen geometry sharpen the image
267 -shave geometry shave pixels from the image edges
268 -shear geometry slide one edge of the image along the X or Y
269 axis
270 -sigmoidal-contrast geometry
271 lightness rescaling using sigmoidal contrast
272 enhancement
273 -sketch geometry simulate a pencil sketch
274 -solarize threshold negate all pixels above the threshold level
275 -sparse-color method args
276 fill in a image based on a few color points
277 -splice geometry splice the background color into the image
278 -spread amount displace image pixels by a random amount
279 -statistic type geometry
280 replace each pixel with corresponding statistic
281 from the neighborhood
282 -strip strip image of all profiles and comments
283 -swirl degrees swirl image pixels about the center
284 -threshold value threshold the image
285 -thumbnail geometry create a thumbnail of the image
286 -tile filename tile image when filling a graphic primitive
287 -tint value tint the image with the fill color
288 -transform affine transform image
289 -transparent color make this color transparent within the image
290 -transpose flip image vertically and rotate 90 degrees
291 -transverse flop image horizontally and rotate 270 degrees
292 -trim trim image edges
293 -type type image type
294 -unique-colors discard all but one of any pixel color
295 -unsharp geometry sharpen the image
296 -vignette geometry soften the edges of the image in vignette style
297 -wave geometry alter an image along a sine wave
298 -white-threshold value
299 force all pixels above the threshold into white
300
301 Image Sequence Operators:
302 -affinity filename transform image colors to match this set of col‐
303 ors
304 -append append an image sequence top to botto (use
305 +append for left to right)
306 -clut apply a color lookup table to the image
307 -coalesce merge a sequence of images
308 -combine combine a sequence of images
309 -composite composite image
310 -crop geometry cut out a rectangular region of the image
311 -deconstruct break down an image sequence into constituent
312 parts
313 -evaluate-sequence operator
314 evaluate an arithmetic, relational, or logical
315 expression
316 -flatten flatten a sequence of images
317 -fx expression apply mathematical expression to an image chan‐
318 nel(s)
319 -hald-clut apply a Hald color lookup table to the image
320 -morph value morph an image sequence
321 -mosaic create a mosaic from an image sequence
322 -process arguments process the image with a custom image filter
323 -separate separate an image channel into a grayscale image
324 -smush geometry smush an image sequence together
325 -write filename write images to this file
326
327 Image Stack Operators:
328 -delete indexes delete the image from the image sequence
329 -duplicate count,indexes
330 duplicate an image one or more times
331 -insert index insert last image into the image sequence
332 -reverse reverse image sequence
333 -swap indexes swap two images in the image sequence
334
335 Miscellaneous Options:
336 -debug events display copious debugging information
337 -help print program options
338 -log format format of debugging information
339 -list type print a list of supported option arguments
340 -version print version information
341
342 By default, the image format of `file' is determined by its magic num‐
343 ber. To specify a particular image format, precede the filename with
344 an image format name and a colon (i.e. ps:image) or specify the image
345 type as the filename suffix (i.e. image.ps). Specify 'file' as '-' for
346 standard input or output.
347
349 ImageMagick(1)
350
351
353 Copyright (C) 1999-2012 ImageMagick Studio LLC. Additional copyrights
354 and licenses apply to this software, see
355 file:///usr/share/doc/ImageMagick-6.7.8/www/license.html or
356 http://www.imagemagick.org/script/license.php
357
358
359
360ImageMagick Date: 2009/01/10 01:00:00 mogrify(1)