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