]> granicus.if.org Git - imagemagick/blob - utilities/magick.1.in
Added missing calls to xmlFreeDoc to fix memory leak reported in #1766.
[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 \fBmagickscript\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/magick.html or http://imagemagick.org/script/magick.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   \-repage geometry     size and location of an image canvas
74   \-sampling-factor geometry
75                        horizontal and vertical sampling factor
76   \-scene value         image scene number
77   \-seed value          seed a new sequence of pseudo-random numbers
78   \-size geometry       width and height of image
79   \-statistic type geometry
80                        replace each pixel with corresponding statistic from the neighborhood
81   \-stretch type        render text with this font stretch
82   \-stroke color        graphic primitive stroke color
83   \-strokewidth value   graphic primitive stroke width
84   \-style type          render text with this font style
85   \-support factor      resize support: > 1.0 is blurry, < 1.0 is sharp
86   \-synchronize         synchronize image to storage device
87   \-taint               declare the image as modified
88   \-texture filename    name of texture to tile onto the image background
89   \-tile-offset geometry
90                        tile offset
91   \-treedepth value     color tree depth
92   \-transparent-color color
93                        transparent color
94   \-undercolor color    annotation bounding box color
95   \-units type          the units of image resolution
96   \-verbose             print detailed information about the image
97   \-view                FlashPix viewing transforms
98   \-virtual-pixel method
99                        virtual pixel access method
100   \-weight type         render text with this font weight
101   \-white-point point   chromaticity white point
102
103 Image Operators:
104   \-adaptive-blur geometry
105                        adaptively blur pixels; decrease effect near edges
106   \-adaptive-resize geometry
107                        adaptively resize image with data dependent triangulation
108   \-adaptive-sharpen geometry
109                        adaptively sharpen pixels; increase effect near edges
110   \-annotate geometry text
111                        annotate the image with text
112   \-auto-orient         automatically orient image
113   \-black-threshold value
114                        force all pixels below the threshold into black
115   \-blur geometry       reduce image noise and reduce detail levels
116   \-border geometry     surround image with a border of color
117   \-channel mask        set the image channel mask
118   \-charcoal radius     simulate a charcoal drawing
119   \-chop geometry       remove pixels from the image interior
120   \-clip                clip along the first path from the 8BIM profile
121   \-clip-mask filename  associate a clip mask with the image
122   \-clip-path id        clip along a named path from the 8BIM profile
123   \-colorize value      colorize the image with the fill color
124   \-color-matrix matrix apply color correction to the image
125   \-contrast            enhance or reduce the image contrast
126   \-contrast-stretch geometry
127                        improve contrast by `stretching' the intensity range
128   \-convolve coefficients
129                        apply a convolution kernel to the image
130   \-cycle amount        cycle the image colormap
131   \-despeckle           reduce the speckles within an image
132   \-draw string         annotate the image with a graphic primitive
133   \-edge radius         apply a filter to detect edges in the image
134   \-emboss radius       emboss an image
135   \-enhance             apply a digital filter to enhance a noisy image
136   \-equalize            perform histogram equalization to an image
137   \-evaluate operator value
138                        evaluate an arithmetic, relational, or logical expression
139   \-extent geometry     set the image size
140   \-extract geometry    extract area from image
141   \-fft                 implements the discrete Fourier transform (DFT)
142   \-flip                flip image vertically
143   \-floodfill geometry color
144                        floodfill the image with color
145   \-flop                flop image horizontally
146   \-frame geometry      surround image with an ornamental border
147   \-function name       apply a function to the image
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   \-identify            identify the format and characteristics of the image
153   \-ift                 implements the inverse discrete Fourier transform (DFT)
154   \-implode amount      implode image pixels about the center
155   \-lat geometry        local adaptive thresholding
156   \-layers method       optimize or compare image layers
157   \-level value         adjust the level of image contrast
158   \-linear-stretch geometry
159                        improve contrast by `stretching with saturation' the intensity range
160   \-median geometry     apply a median filter to the image
161   \-mode geometry       make each pixel the 'predominant color' of the neighborhood
162   \-modulate value      vary the brightness, saturation, and hue
163   \-monochrome          transform image to black and white
164   \-morphology method kernel
165                        apply a morphology method to the image
166   \-motion-blur geometry
167                        simulate motion blur
168   \-negate              replace each pixel with its complementary color 
169   \-noise geometry      add or reduce noise in an image
170   \-normalize           transform image to span the full range of colors
171   \-opaque color        change this color to the fill color
172   \-ordered-dither NxN
173                        add a noise pattern to the image with specific amplitudes
174   \-paint radius        simulate an oil painting
175   \-polaroid angle      simulate a Polaroid picture
176   \-posterize levels    reduce the image to a limited number of color levels
177   \-print string        interpret string and print to console
178   \-profile filename    add, delete, or apply an image profile
179   \-quantize colorspace reduce colors in this colorspace
180   \-radial-blur angle   radial blur the image
181   \-raise value         lighten/darken image edges to create a 3-D effect
182   \-random-threshold low,high
183                        random threshold the image
184   \-range-threshold values
185                        perform either hard or soft thresholding within some range of values in an image
186   \-region geometry     apply options to a portion of the image
187   \-render              render vector graphics
188   \-resample geometry   change the resolution of an image
189   \-resize geometry     resize the image
190   \-roll geometry       roll an image vertically or horizontally
191   \-rotate degrees      apply Paeth rotation to the image
192   \-sample geometry     scale image with pixel sampling
193   \-scale geometry      scale the image
194   \-segment values      segment an image
195   \-selective-blur geometry
196                        selectively blur pixels within a contrast threshold
197   \-sepia-tone threshold
198                        simulate a sepia-toned photo
199   \-set property value  set an image property
200   \-shade degrees       shade the image using a distant light source
201   \-shadow geometry     simulate an image shadow
202   \-sharpen geometry    sharpen the image
203   \-shave geometry      shave pixels from the image edges
204   \-shear geometry      slide one edge of the image along the X or Y axis
205   \-sigmoidal-contrast geometry
206                        lightness rescaling using sigmoidal contrast enhancement
207   \-sketch geometry     simulate a pencil sketch
208   \-solarize threshold  negate all pixels above the threshold level
209   \-splice geometry     splice the background color into the image
210   \-spread amount       displace image pixels by a random amount
211   \-strip               strip image of all profiles and comments
212   \-swirl degrees       swirl image pixels about the center
213   \-threshold value     threshold the image
214   \-thumbnail geometry  create a thumbnail of the image
215   \-tile filename       tile image when filling a graphic primitive
216   \-tint value          tint the image with the fill color
217   \-transform           affine transform image
218   \-transparent color   make this color transparent within the image
219   \-transpose           flip image vertically and rotate 90 degrees
220   \-transverse          flop image horizontally and rotate 270 degrees
221   \-trim                trim image edges
222   \-type type           image type
223   \-unique-colors       discard all but one of any pixel color
224   \-unsharp geometry    sharpen the image
225   \-vignette geometry   soften the edges of the image in vignette style
226   \-wave geometry       alter an image along a sine wave
227   \-white-threshold value
228                        force all pixels above the threshold into white
229
230
231 Image Channel Operators:
232   \-channel-extract channel-list
233                         extract the channels in order
234   \-channel-inject channel-list
235                         inject the channels in order
236   \-channel-swap channel,channel
237                         swap the channels
238
239 Image Sequence Operators:
240   \-affinity filename   transform image colors to match this set of colors
241   \-append              append an image sequence top to bottom (use +append for left to right)
242   \-clut                apply a color lookup table to the image
243   \-coalesce            merge a sequence of images
244   \-combine             combine a sequence of images
245   \-composite           composite image
246   \-crop geometry       cut out a rectangular region of the image
247   \-deconstruct         break down an image sequence into constituent parts
248   \-evaluate-sequence operator
249                        evaluate an arithmetic, relational, or logical expression
250   \-flatten             flatten a sequence of images
251   \-fx expression       apply mathematical expression to an image channel(s)
252   \-hald-clut           apply a Hald color lookup table to the image
253   \-morph value         morph an image sequence
254   \-mosaic              create a mosaic from an image sequence
255   \-process arguments   process the image with a custom image filter
256   \-separate            separate an image channel into a grayscale image
257   \-smush geometry      smush an image sequence together
258   \-write filename      write images to this file
259
260 Image Stack Operators:
261   \-clone indexes       clone an image
262   \-delete indexes      delete the image from the image sequence
263   \-duplicate count,indexes
264                        duplicate an image one or more times
265   \-insert index        insert last image into the image sequence
266   \-swap indexes        swap two images in the image sequence
267
268 Miscellaneous Options:
269   \-debug events        display copious debugging information
270   \-help                print program options
271   \-log format          format of debugging information
272   \-list type           print a list of supported option arguments
273   \-version             print version information
274
275 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.
276
277 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.
278 .SH SEE ALSO
279 ImageMagick(1)
280
281 .SH COPYRIGHT
282 \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