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