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