1mogrify(1)                  General Commands Manual                 mogrify(1)
2
3
4

NAME

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

SYNOPSIS

11       mogrify [options] input-file
12

OVERVIEW

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.3.2/www/mogrify.html             or
22       http://www.imagemagick.org/script/mogrify.php.
23

DESCRIPTION

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         -channel type        apply option to select image channels
38         -colors value        preferred number of colors in the image
39         -colorspace type     alternate image colorspace
40         -comment string      annotate image with comment
41         -compose operator    set image composite operator
42         -compress type       type of pixel compression when writing the image
43         -debug events        display copious debugging information
44         -define format:option
45                              define one or more image format options
46         -delay value         display the next image after pausing
47         -density geometry    horizontal and vertical density of the image
48         -depth value         image depth
49         -display server      get image or font from this X server
50         -dispose method      GIF disposal method
51         -dither              apply Floyd/Steinberg error diffusion to image
52         -encoding type       text encoding type
53         -endian type         endianness (MSB or LSB) of the image
54         -family name         render text with this font family
55         -fill color          color to use when filling a graphic primitive
56         -filter type         use this filter when resizing an image
57         -font name           render text with this font
58         -format type         image format type
59         -fuzz distance       colors within this distance are considered equal
60         -gravity type        horizontal and vertical text placement
61         -green-primary point chromaticity green primary point
62         -intent type         type of rendering intent when managing the image
63       color
64         -interlace type      type of image interlacing scheme
65         -interpolate method  pixel color interpolation method
66         -label string        assign a label to an image
67         -limit type value    pixel cache resource limit
68         -log format          format of debugging information
69         -loop iterations     add Netscape loop extension to your  GIF  anima‐
70       tion
71         -mask filename       associate a mask with the image
72         -matte               store matte channel if the image has one
73         -mattecolor color    frame color
74         -monitor             monitor progress
75         -orient type         image orientation
76         -origin geometry     image origin
77         -page geometry       size and location of an image canvas (setting)
78         -path path           write images to this path on disk
79         -ping                efficiently determine image attributes
80         -pointsize value     font point size
81         -preview type        image preview type
82         -quality value       JPEG/MIFF/PNG compression level
83         -quiet               suppress all error or warning messages
84         -red-primary point   chromaticity red primary point
85         -regard-warnings     pay attention to warning messages
86         -sampling-factor geometry
87                              horizontal and vertical sampling factor
88         -scene value         image scene number
89         -seed value          pseudo-random number generator seed value
90         -size geometry       width and height of image
91         -stretch type        render text with this font stretch
92         -stroke color        graphic primitive stroke color
93         -strokewidth value   graphic primitive stroke width
94         -style type          render text with this font style
95         -support factor      resize support: > 1.0 is blurry, < 1.0 is sharp
96         -texture  filename     name  of  texture to tile onto the image back‐
97       ground
98         -treedepth value     color tree depth
99         -transparent-color color
100                              transparent color
101         -undercolor color    annotation bounding box color
102         -units type          the units of image resolution
103         -verbose             print detailed information about the image
104         -view                FlashPix viewing transforms
105         -virtual-pixel method
106                              virtual pixel access method
107         -weight type         render text with this font weight
108         -white-point point   chromaticity white point
109
110       Image Operators:
111         -adaptive-blur geometry
112                              adaptively blur  pixels;  decrease  effect  near
113       edges
114         -adaptive-resize geometry
115                              adaptively resize image with data dependent tri‐
116       angulation
117         -adaptive-sharpen geometry
118                              adaptively sharpen pixels; increase effect  near
119       edges
120         -annotate geometry text
121                              annotate the image with text
122         -auto-orient         automatically orient image
123         -black-threshold value
124                              force all pixels below the threshold into black
125         -blur geometry       reduce image noise and reduce detail levels
126         -border geometry     surround image with a border of color
127         -charcoal radius     simulate a charcoal drawing
128         -chop geometry       remove pixels from the image interior
129         -clip                clip along the first path from the 8BIM profile
130         -clip-mask filename  associate a clip mask with the image
131         -clip-path id        clip along a named path from the 8BIM profile
132         -colorize value      colorize the image with the fill color
133         -contrast            enhance or reduce the image contrast
134         -contrast-stretch geometry
135                              improve  contrast  by `stretching' the intensity
136       range
137         -convolve coefficients
138                              apply a convolution kernel to the image
139         -cycle amount        cycle the image colormap
140         -despeckle           reduce the speckles within an image
141         -draw string         annotate the image with a graphic primitive
142         -edge radius         apply a filter to detect edges in the image
143         -emboss radius       emboss an image
144         -enhance             apply a digital filter to enhance a noisy image
145         -equalize            perform histogram equalization to an image
146         -evaluate operator value
147                              evaluate an arithmetic, relational,  or  logical
148       expression
149         -extent geometry     set the image size
150         -extract geometry    extract area from image
151         -flip                flip image vertically
152         -floodfill geometry color
153                              floodfill the image with color
154         -flop                flop image horizontally
155         -frame geometry      surround image with an ornamental border
156         -gamma value         level of gamma correction
157         -gaussian-blur geometry
158                              reduce image noise and reduce detail levels
159         -geometry geometry   perferred size or location of the image
160         -help                print program options
161         -identify             identify  the format and characteristics of the
162       image
163         -implode amount      implode image pixels about the center
164         -lat geometry        local adaptive thresholding
165         -layers method       optimize or compare image layers
166         -level value         adjust the level of image contrast
167         -linear-stretch geometry
168                              improve contrast by `stretching with saturation'
169       the intensity range
170         -median radius       apply a median filter to the image
171         -modulate value      vary the brightness, saturation, and hue
172         -monochrome          transform image to black and white
173         -motion-blur geometry
174                              simulate motion blur
175         -negate              replace every pixel with its complementary color
176         -noise radius        add or reduce noise in an image
177         -normalize           transform image to span the full range of colors
178         -opaque color        change this color to the fill color
179         -ordered-dither NxN
180                              add  a  noise pattern to the image with specific
181       amplitudes
182         -paint radius        simulate an oil painting
183         -polaroid angle      simulate a Polaroid picture
184         -posterize levels    reduce the image to a limited  number  of  color
185       levels
186         -print string        interpret string and print to console
187         -profile filename    add, delete, or apply an image profile
188         -quantize colorspace reduce colors in this colorspace
189         -radial-blur angle   radial blur the image
190         -raise  value          lighten/darken  image  edges  to  create a 3-D
191       effect
192         -random-threshold low,high
193                              random threshold the image
194         -recolor matrix      translate, scale, shear, or rotate image colors
195         -region geometry     apply options to a portion of the image
196         -render              render vector graphics
197         -repage geometry     size and location of an image canvas
198         -resample geometry   change the resolution of an image
199         -resize geometry     resize the image
200         -roll geometry       roll an image vertically or horizontally
201         -rotate degrees      apply Paeth rotation to the image
202         -sample geometry     scale image with pixel sampling
203         -scale geometry      scale the image
204         -segment values      segment an image
205         -sepia-tone threshold
206                              simulate a sepia-toned photo
207         -set property value  set an image property
208         -shade degrees       shade the image using a distant light source
209         -shadow geometry     simulate an image shadow
210         -sharpen geometry    sharpen the image
211         -shave geometry      shave pixels from the image edges
212         -shear geometry      slide one edge of the image along  the  X  or  Y
213       axis
214         -sigmoidal-contrast geometry
215                              lightness  rescaling  using  sigmoidal  contrast
216       enhancement
217         -sketch geometry     simulate a pencil sketch
218         -solarize threshold  negate all pixels above the threshold level
219         -splice geometry     splice the background color into the image
220         -spread amount       displace image pixels by a random amount
221         -strip               strip image of all profiles and comments
222         -swirl degrees       swirl image pixels about the center
223         -threshold value     threshold the image
224         -thumbnail geometry  create a thumbnail of the image
225         -tile filename       tile image when filling a graphic primitive
226         -tint value          tint the image with the fill color
227         -transform           affine transform image
228         -transparent color   make this color transparent within the image
229         -transpose           flip image vertically and rotate 90 degrees
230         -transverse          flop image horizontally and rotate 270 degrees
231         -trim                trim image edges
232         -type type           image type
233         -unique-colors       discard all but one of any pixel color
234         -unsharp geometry    sharpen the image
235         -version             print version information
236         -vignette geometry   soften the edges of the image in vignette style
237         -wave geometry       alter an image along a sine wave
238         -white-threshold value
239                              force all pixels above the threshold into white
240
241       By default, the image format of `file' is determined by its magic  num‐
242       ber.   To  specify a particular image format, precede the filename with
243       an image format name and a colon (i.e. ps:image) or specify  the  image
244       type as the filename suffix (i.e. image.ps).  Specify 'file' as '-' for
245       standard input or output.
246

SEE-ALSO

248       ImageMagick(1)
249
250
252       Copyright (C) 1999-2006 ImageMagick Studio LLC.  Additional  copyrights
253       and       licenses      apply      to      this      software,      see
254       file:///usr/share/doc/ImageMagick-6.3.2/www/license.php              or
255       http://www.imagemagick.org/script/license.php
256
257
258
259ImageMagick                Date: 2005/03/01 01:00:00                mogrify(1)
Impressum