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