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.6.4/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 -texture filename name of texture to tile onto the image back‐
104 ground
105 -tile-offset geometry
106 tile offset
107 -treedepth value color tree depth
108 -transparent-color color
109 transparent color
110 -undercolor color annotation bounding box color
111 -units type the units of image resolution
112 -verbose print detailed information about the image
113 -view FlashPix viewing transforms
114 -virtual-pixel method
115 virtual pixel access method
116 -weight type render text with this font weight
117 -white-point point chromaticity white point
118
119 Image Operators:
120 -adaptive-blur geometry
121 adaptively blur pixels; decrease effect near
122 edges
123 -adaptive-resize geometry
124 adaptively resize image with data dependent tri‐
125 angulation
126 -adaptive-sharpen geometry
127 adaptively sharpen pixels; increase effect near
128 edges
129 -annotate geometry text
130 annotate the image with text
131 -auto-orient automatically orient image
132 -black-threshold value
133 force all pixels below the threshold into black
134 -blur geometry reduce image noise and reduce detail levels
135 -border geometry surround image with a border of color
136 -charcoal radius simulate a charcoal drawing
137 -chop geometry remove pixels from the image interior
138 -clip clip along the first path from the 8BIM profile
139 -clip-mask filename associate a clip mask with the image
140 -clip-path id clip along a named path from the 8BIM profile
141 -colorize value colorize the image with the fill color
142 -color-matrix matrix apply color correction to the image
143 -contrast enhance or reduce the image contrast
144 -contrast-stretch geometry
145 improve contrast by `stretching' the intensity
146 range
147 -convolve coefficients
148 apply a convolution kernel to the image
149 -cycle amount cycle the image colormap
150 -despeckle reduce the speckles within an image
151 -draw string annotate the image with a graphic primitive
152 -edge radius apply a filter to detect edges in the image
153 -emboss radius emboss an image
154 -enhance apply a digital filter to enhance a noisy image
155 -equalize perform histogram equalization to an image
156 -evaluate operator value
157 evaluate an arithmetic, relational, or logical
158 expression
159 -extent geometry set the image size
160 -extract geometry extract area from image
161 -fft implements the discrete Fourier transform (DFT)
162 -flip flip image vertically
163 -floodfill geometry color
164 floodfill the image with color
165 -flop flop image horizontally
166 -frame geometry surround image with an ornamental border
167 -gamma value level of gamma correction
168 -gaussian-blur geometry
169 reduce image noise and reduce detail levels
170 -geometry geometry preferred size or location of the image
171 -ift implements the inverse discrete Fourier trans‐
172 form (DFT)
173 -help print program options
174 -identify identify the format and characteristics of the
175 image
176 -implode amount implode image pixels about the center
177 -lat geometry local adaptive thresholding
178 -layers method optimize or compare image layers
179 -level value adjust the level of image contrast
180 -linear-stretch geometry
181 improve contrast by `stretching with saturation'
182 the intensity range
183 -median radius apply a median filter to the image
184 -modulate value vary the brightness, saturation, and hue
185 -monochrome transform image to black and white
186 -motion-blur geometry
187 simulate motion blur
188 -negate replace each pixel with its complementary color
189 -noise radius add or reduce noise in an image
190 -normalize transform image to span the full range of colors
191 -opaque color change this color to the fill color
192 -ordered-dither NxN
193 add a noise pattern to the image with specific
194 amplitudes
195 -paint radius simulate an oil painting
196 -polaroid angle simulate a Polaroid picture
197 -posterize levels reduce the image to a limited number of color
198 levels
199 -print string interpret string and print to console
200 -profile filename add, delete, or apply an image profile
201 -quantize colorspace reduce colors in this colorspace
202 -radial-blur angle radial blur the image
203 -raise value lighten/darken image edges to create a 3-D
204 effect
205 -random-threshold low,high
206 random threshold the image
207 -region geometry apply options to a portion of the image
208 -render render vector graphics
209 -repage geometry size and location of an image canvas
210 -resample geometry change the resolution of an image
211 -resize geometry resize the image
212 -roll geometry roll an image vertically or horizontally
213 -rotate degrees apply Paeth rotation to the image
214 -sample geometry scale image with pixel sampling
215 -scale geometry scale the image
216 -segment values segment an image
217 -selective-blur geometry
218 selectively blur pixels within a contrast
219 threshold
220 -sepia-tone threshold
221 simulate a sepia-toned photo
222 -set property value set an image property
223 -shade degrees shade the image using a distant light source
224 -shadow geometry simulate an image shadow
225 -sharpen geometry sharpen the image
226 -shave geometry shave pixels from the image edges
227 -shear geometry slide one edge of the image along the X or Y
228 axis
229 -sigmoidal-contrast geometry
230 lightness rescaling using sigmoidal contrast
231 enhancement
232 -sketch geometry simulate a pencil sketch
233 -solarize threshold negate all pixels above the threshold level
234 -splice geometry splice the background color into the image
235 -spread amount displace image pixels by a random amount
236 -strip strip image of all profiles and comments
237 -swirl degrees swirl image pixels about the center
238 -threshold value threshold the image
239 -thumbnail geometry create a thumbnail of the image
240 -tile filename tile image when filling a graphic primitive
241 -tint value tint the image with the fill color
242 -transform affine transform image
243 -transparent color make this color transparent within the image
244 -transpose flip image vertically and rotate 90 degrees
245 -transverse flop image horizontally and rotate 270 degrees
246 -trim trim image edges
247 -type type image type
248 -unique-colors discard all but one of any pixel color
249 -unsharp geometry sharpen the image
250 -vignette geometry soften the edges of the image in vignette style
251 -wave geometry alter an image along a sine wave
252 -white-threshold value
253 force all pixels above the threshold into white
254
255 Image Sequence Operators:
256 -affinity filename transform image colors to match this set of col‐
257 ors
258 -append append an image sequence
259 -clut apply a color lookup table to the image
260 -coalesce merge a sequence of images
261 -combine combine a sequence of images
262 -composite composite image
263 -crop geometry cut out a rectangular region of the image
264 -deconstruct break down an image sequence into constituent
265 parts
266 -evaluate-sequence operator
267 evaluate an arithmetic, relational, or logical
268 expression
269 -flatten flatten a sequence of images
270 -fx expression apply mathematical expression to an image chan‐
271 nel(s)
272 -hald-clut apply a Hald color lookup table to the image
273 -morph value morph an image sequence
274 -mosaic create a mosaic from an image sequence
275 -process arguments process the image with a custom image filter
276 -separate separate an image channel into a grayscale image
277 -write filename write images to this file
278
279 Image Stack Operators:
280 -clone index clone an image
281 -delete index delete the image from the image sequence
282 -insert index insert last image into the image sequence
283 -swap indexes swap two images in the image sequence
284
285 Miscellaneous Options:
286 -debug events display copious debugging information
287 -help print program options
288 -log format format of debugging information
289 -list type print a list of supported option arguments
290 -version print version information
291
292 By default, the image format of `file' is determined by its magic num‐
293 ber. To specify a particular image format, precede the filename with
294 an image format name and a colon (i.e. ps:image) or specify the image
295 type as the filename suffix (i.e. image.ps). Specify 'file' as '-' for
296 standard input or output.
297
299 ImageMagick(1)
300
301
303 Copyright (C) 1999-2010 ImageMagick Studio LLC. Additional copyrights
304 and licenses apply to this software, see
305 file:///usr/share/doc/ImageMagick-6.6.4/www/license.html or
306 http://www.imagemagick.org/script/license.php
307
308
309
310ImageMagick Date: 2009/01/10 01:00:00 mogrify(1)