]> granicus.if.org Git - imagemagick/blob - utilities/mogrify.1.in
Added missing calls to xmlFreeDoc to fix memory leak reported in #1766.
[imagemagick] / utilities / mogrify.1.in
1 .TH mogrify 1 "Date: 2009/01/10 01:00:00" "ImageMagick"
2 .SH NAME
3 mogrify \- resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. Mogrify overwrites the original image file, whereas, convert(1) writes to a different image file.
4 .SH SYNOPSIS
5 .TP
6 \fBmogrify\fP [\fIoptions\fP] \fIinput-file\fP 
7 .SH OVERVIEW
8 The \fBmogrify\fP program is a member of the ImageMagick(1) suite of tools.  Use it to resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. This tool is similar to convert(1) except the original image file is overwritten with any changes you request.
9
10 For more information about the mogrify command, point your browser to file://@DOCUMENTATION_PATH@/www/mogrify.html or http://imagemagick.org/script/mogrify.php.
11 .SH DESCRIPTION
12 Image Settings:
13   \-adjoin              join images into a single multi-image file
14   \-affine matrix       affine transform matrix
15   \-antialias           remove pixel-aliasing
16   \-authenticate value  decrypt image with this password
17   \-attenuate value     lessen (or intensify) when adding noise to an image
18   \-background color    background color
19   \-bias value          add bias when convolving an image
20   \-black-point-compensation
21                        use black point compensation
22   \-blue-primary point  chromaticity blue primary point
23   \-bordercolor color   border color
24   \-caption string      assign a caption to an image
25   \-cdl filename        color correct with a color decision list
26   \-colors value        preferred number of colors in the image
27   \-colorspace type     alternate image colorspace
28   \-comment string      annotate image with comment
29   \-compose operator    set image composite operator
30   \-compress type       type of pixel compression when writing the image
31   \-decipher filename   convert cipher pixels to plain pixels
32   \-define format:option
33                        define one or more image format options
34   \-delay value         display the next image after pausing
35   \-density geometry    horizontal and vertical density of the image
36   \-depth value         image depth
37   \-direction type      render text right-to-left or left-to-right
38   \-display server      get image or font from this X server
39   \-dispose method      layer disposal method
40   \-dither method       apply error diffusion to image
41   \-encipher filename   convert plain pixels to cipher pixels
42   \-encoding type       text encoding type
43   \-endian type         endianness (MSB or LSB) of the image
44   \-family name         render text with this font family
45   \-features distance   analyze image features (e.g. contrast, correlation)
46   \-fill color          color to use when filling a graphic primitive
47   \-filter type         use this filter when resizing an image
48   \-flatten             flatten a sequence of images
49   \-font name           render text with this font
50   \-format type         image format type
51   \-function name       apply a function to the image
52   \-fuzz distance       colors within this distance are considered equal
53   \-gravity type        horizontal and vertical text placement
54   \-green-primary point chromaticity green primary point
55   \-intensity method    method to generate intensity value from pixel
56   \-intent type         type of rendering intent when managing the image color
57   \-interlace type      type of image interlacing scheme
58   \-interline-spacing   value set the space between two text lines
59   \-interpolate method  pixel color interpolation method
60   \-interword-spacing   value set the space between two words
61   \-kerning value       set the space between two letters
62   \-label string        assign a label to an image
63   \-limit type value    pixel cache resource limit
64   \-loop iterations     add Netscape loop extension to your GIF animation
65   \-matte               store matte channel if the image has one
66   \-mattecolor color    frame color
67   \-metric type         measure differences between images with this metric
68   \-monitor             monitor progress
69   \-morphology method kernel
70                        apply a morphology method to the image
71   \-orient type         image orientation
72   \-page geometry       size and location of an image canvas (setting)
73   \-path path           write images to this path on disk
74   \-perceptible epsilon
75                        pixel value less than |epsilon| become epsilon or -epsilon
76   \-ping                efficiently determine image attributes
77   \-pointsize value     font point size
78   \-precision value     maximum number of significant digits to print
79   \-preview type        image preview type
80   \-quality value       JPEG/MIFF/PNG compression level
81   \-quiet               suppress all warning messages
82   \-read-mask filename  associate a read mask with the image
83   \-red-primary point   chromaticity red primary point
84   \-regard-warnings     pay attention to warning messages
85   \-remap filename      transform image colors to match this set of colors
86   \-repage geometry     size and location of an image canvas
87   \-respect-parentheses settings remain in effect until parenthesis boundary
88   \-sampling-factor geometry
89                        horizontal and vertical sampling factor
90   \-scene value         image scene number
91   \-seed value          seed a new sequence of pseudo-random numbers
92   \-size geometry       width and height of image
93   \-stretch type        render text with this font stretch
94   \-stroke color        graphic primitive stroke color
95   \-strokewidth value   graphic primitive stroke width
96   \-style type          render text with this font style
97   \-synchronize         synchronize image to storage device
98   \-taint               declare the image as modified
99   \-texture filename    name of texture to tile onto the image background
100   \-tile-offset geometry
101                        tile offset
102   \-treedepth value     color tree depth
103   \-transparent-color color
104                        transparent color
105   \-undercolor color    annotation bounding box color
106   \-units type          the units of image resolution
107   \-verbose             print detailed information about the image
108   \-virtual-pixel method
109                        virtual pixel access method
110   \-weight type         render text with this font weight
111   \-white-point point   chromaticity white point
112   \-write-mask filename associate a write mask with the image
113
114 Image Operators:
115   \-adaptive-blur geometry
116                        adaptively blur pixels; decrease effect near edges
117   \-adaptive-resize geometry
118                        adaptively resize image with data dependent triangulation
119   \-adaptive-sharpen geometry
120                        adaptively sharpen pixels; increase effect near edges
121   \-alpha option        on, activate, off, deactivate, set, opaque, copy
122                        transparent, extract, background, or shape
123   \-annotate geometry text
124                        annotate the image with text
125   \-auto-gamma          automagically adjust gamma level of image
126   \-auto-level          automagically adjust color levels of image
127   \-auto-orient         automatically orient image
128   \-auto-threshold method
129                        automatically perform image thresholding
130   \-bench iterations    measure performance
131   \-black-threshold value
132                        force all pixels below the threshold into black
133   \-blue-shift          simulate a scene at nighttime in the moonlight
134   \-blur geometry       reduce image noise and reduce detail levels
135   \-border geometry     surround image with a border of color
136   \-brightness-contrast geometry
137                        improve brightness / contrast of the image
138   \-canny geometry      detect edges in the image
139   \-channel mask        set the image channel mask
140   \-charcoal radius     simulate a charcoal drawing
141   \-chop geometry       remove pixels from the image interior
142   \-clahe geometry      contrast limited adaptive histogram equalization 
143   \-clamp               keep pixel values in range (0-QuantumRange)
144   \-clip                clip along the first path from the 8BIM profile
145   \-clip-mask filename  associate a clip mask with the image
146   \-clip-path id        clip along a named path from the 8BIM profile
147   \-colorize value      colorize the image with the fill color
148   \-color-matrix matrix apply color correction to the image
149   \-connected-component connectivity
150                        connected-components uniquely labeled
151   \-contrast            enhance or reduce the image contrast
152   \-contrast-stretch geometry
153                        improve contrast by `stretching' the intensity range
154   \-convolve coefficients
155                        apply a convolution kernel to the image
156   \-cycle amount        cycle the image colormap
157   \-deskew threshold    straighten an image
158   \-despeckle           reduce the speckles within an image
159   \-distort method args
160                        distort images according to given method and args
161   \-draw string         annotate the image with a graphic primitive
162   \-edge radius         apply a filter to detect edges in the image
163   \-emboss radius       emboss an image
164   \-enhance             apply a digital filter to enhance a noisy image
165   \-equalize            perform histogram equalization to an image
166   \-evaluate operator value
167                        evaluate an arithmetic, relational, or logical expression
168   \-extent geometry     set the image size
169   \-extract geometry    extract area from image
170   \-fft                 implements the discrete Fourier transform (DFT)
171   \-flip                flip image vertically
172   \-floodfill geometry color
173                        floodfill the image with color
174   \-flop                flop image horizontally
175   \-frame geometry      surround image with an ornamental border
176   \-gamma value         level of gamma correction
177   \-gaussian-blur geometry
178                        reduce image noise and reduce detail levels
179   \-geometry geometry   preferred size or location of the image
180   \-grayscale method    convert image to grayscale
181   \-help                print program options
182   \-hough-lines geometry
183                        identify lines in the image
184   \-identify            identify the format and characteristics of the image
185   \-ift                 implements the inverse discrete Fourier transform (DFT)
186   \-implode amount      implode image pixels about the center
187   \-interpolative-resize geometry
188                        resize image using interpolation
189   \-lat geometry        local adaptive thresholding
190   \-layers method       optimize or compare image layers
191   \-level value         adjust the level of image contrast
192   \-level-colors color,color
193                        level image with the given colors
194   \-linear-stretch geometry
195                        improve contrast by `stretching with saturation' the intensity range
196   \-liquid-rescale geometry
197                        rescale image with seam-carving
198   \-magnify             double the size of the image with pixel art scaling
199   \-mean-shift geometry delineate arbitrarily shaped clusters in the image
200   \-median geometry     apply a median filter to the image
201   \-mode geometry       make each pixel the 'predominant color' of the neighborhood
202   \-modulate value      vary the brightness, saturation, and hue
203   \-monochrome          transform image to black and white
204   \-motion-blur geometry
205                        simulate motion blur
206   \-negate              replace each pixel with its complementary color 
207   \-noise geometry      add or reduce noise in an image
208   \-normalize           transform image to span the full range of colors
209   \-opaque color        change this color to the fill color
210   \-ordered-dither NxN
211                        add a noise pattern to the image with specific amplitudes
212   \-paint radius        simulate an oil painting
213   \-polaroid angle      simulate a Polaroid picture
214   \-posterize levels    reduce the image to a limited number of color levels
215   \-print string        interpret string and print to console
216   \-profile filename    add, delete, or apply an image profile
217   \-quantize colorspace reduce colors in this colorspace
218   \-radial-blur angle   radial blur the image
219   \-raise value         lighten/darken image edges to create a 3-D effect
220   \-random-threshold low,high
221                        random threshold the image
222   \-range-threshold values
223                        perform either hard or soft thresholding within some range of values in an image
224   \-region geometry     apply options to a portion of the image
225   \-render              render vector graphics
226   \-resample geometry   change the resolution of an image
227   \-resize geometry     resize the image
228   \-roll geometry       roll an image vertically or horizontally
229   \-rotate degrees      apply Paeth rotation to the image
230   \-sample geometry     scale image with pixel sampling
231   \-scale geometry      scale the image
232   \-segment values      segment an image
233   \-selective-blur geometry
234                        selectively blur pixels within a contrast threshold
235   \-sepia-tone threshold
236                        simulate a sepia-toned photo
237   \-set property value  set an image property
238   \-shade degrees       shade the image using a distant light source
239   \-shadow geometry     simulate an image shadow
240   \-sharpen geometry    sharpen the image
241   \-shave geometry      shave pixels from the image edges
242   \-shear geometry      slide one edge of the image along the X or Y axis
243   \-sigmoidal-contrast geometry
244                        lightness rescaling using sigmoidal contrast enhancement
245   \-sketch geometry     simulate a pencil sketch
246   \-solarize threshold  negate all pixels above the threshold level
247   \-sparse-color method args
248                        fill in a image based on a few color points
249   \-splice geometry     splice the background color into the image
250   \-spread amount       displace image pixels by a random amount
251   \-statistic type geometry
252                        replace each pixel with corresponding statistic from the neighborhood
253   \-strip               strip image of all profiles and comments
254   \-swirl degrees       swirl image pixels about the center
255   \-threshold value     threshold the image
256   \-thumbnail geometry  create a thumbnail of the image
257   \-tile filename       tile image when filling a graphic primitive
258   \-tint value          tint the image with the fill color
259   \-transform           affine transform image
260   \-transparent color   make this color transparent within the image
261   \-transpose           flip image vertically and rotate 90 degrees
262   \-transverse          flop image horizontally and rotate 270 degrees
263   \-trim                trim image edges
264   \-type type           image type
265   \-unique-colors       discard all but one of any pixel color
266   \-unsharp geometry    sharpen the image
267   \-vignette geometry   soften the edges of the image in vignette style
268   \-wave geometry       alter an image along a sine wave
269   \-wavelet-denoise threshold
270                         removes noise from the image using a wavelet transform
271   \-white-threshold value
272                        force all pixels above the threshold into white
273
274 Image Channel Operators:
275   \-channel-fx expression
276                        exchange, extract, or transfer one or more image channels
277   \-separate            separate an image channel into a grayscale image
278
279 Image Sequence Operators:
280   \-affinity filename   transform image colors to match this set of colors
281   \-append              append an image sequence top to botto (use +append for left to right)
282   \-clut                apply a color lookup table to the image
283   \-coalesce            merge a sequence of images
284   \-combine             combine a sequence of images
285   \-compare             mathematically and visually annotate the difference between an image and its reconstruction
286   \-complex operator    perform complex mathematics on an image sequence
287   \-composite           composite image
288   \-copy geometry offset,
289                        copy pixels from one area of an image to another
290   \-crop geometry       cut out a rectangular region of the image
291   \-deconstruct         break down an image sequence into constituent parts
292   \-evaluate-sequence operator
293                        evaluate an arithmetic, relational, or logical expression
294   \-flatten             flatten a sequence of images
295   \-fx expression       apply mathematical expression to an image channel(s)
296   \-hald-clut           apply a Hald color lookup table to the image
297   \-morph value         morph an image sequence
298   \-mosaic              create a mosaic from an image sequence
299   \-poly terms          build a polynomial from the image sequence and the corresponding terms (coefficients and degree pairs)
300   \-process arguments   process the image with a custom image filter
301   \-separate            separate an image channel into a grayscale image
302   \-smush geometry      smush an image sequence together
303   \-write filename      write images to this file
304
305 Image Stack Operators:
306   \-delete indexes      delete the image from the image sequence
307   \-duplicate count,indexes
308                        duplicate an image one or more times
309   \-insert index        insert last image into the image sequence
310   \-reverse             reverse image sequence
311   \-swap indexes        swap two images in the image sequence
312
313 Miscellaneous Options:
314   \-debug events        display copious debugging information
315   \-distribute-cache port
316                        distributed pixel cache spanning one or more servers
317   \-help                print program options
318   \-log format          format of debugging information
319   \-list type           print a list of supported option arguments
320   \-version             print version information
321
322 By default, the image format of `file' is determined by its magic number.  To specify a particular image format, precede the filename with an image format name and a colon (i.e. ps:image) or specify the image type as the filename suffix (i.e. image.ps).  Specify 'file' as '-' for standard input or output.
323 .SH SEE ALSO
324 ImageMagick(1)
325
326 .SH COPYRIGHT
327
328 \fBCopyright (C) 1999-2019 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file://@DOCUMENTATION_PATH@/www/license.html or http://imagemagick.org/script/license.php\fP