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

NAME

6       magick  -  convert  between  image  formats as well as resize an image,
7       blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much
8       more.
9

SYNOPSIS

11       magick [input-options] input-file [output-options] output-file
12

OVERVIEW

14       The  magick  program  is a member of the ImageMagick(1) suite of tools.
15       Use it to convert between image formats as well  as  resize  an  image,
16       blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much
17       more.
18
19       For more information about the magick command, point  your  browser  to
20       file:///usr/share/doc/ImageMagick-7/www/magick.html  or  https://image
21       magick.org/script/magick.php.
22

DESCRIPTION

24       Image Settings:
25         -adjoin              join images into a single multi-image file
26         -affine matrix       affine transform matrix
27         -antialias           remove pixel-aliasing
28         -authenticate value  decrypt image with this password
29         -background color    background color
30         -bias value          add bias when convolving an image
31         -black-point-compensation
32                              use black point compensation
33         -blue-primary point  chromaticity blue primary point
34         -bordercolor color   border color
35         -caption string      assign a caption to an image
36         -cdl filename        color correct with a color decision list
37         -colors value        preferred number of colors in the image
38         -colorspace type     alternate image colorspace
39         -comment string      annotate image with comment
40         -compose operator    set image composite operator
41         -compress type       type of pixel compression when writing the image
42         -decipher filename   magick cipher pixels to plain pixels
43         -define format:option
44                              define one or more image format options
45         -delay centiseconds  display the next image after pausing
46         -density geometry    horizontal and vertical density of the image
47         -depth value         image depth
48         -direction type      render text right-to-left or left-to-right
49         -display server      get image or font from this X server
50         -dispose method      layer disposal method
51         -dither method       apply error diffusion to image
52         -encipher filename   magick plain pixels to cipher pixels
53         -encoding type       text encoding type
54         -endian type         endianness (MSB or LSB) of the image
55         -family name         render text with this font family
56         -fill color          color to use when filling a graphic primitive
57         -filter type         use this filter when resizing an image
58         -flatten             flatten a sequence of images
59         -font name           render text with this font
60         -format "string"     output formatted image characteristics
61         -fuzz distance       colors within this distance are considered equal
62         -gravity type        horizontal and vertical text placement
63         -green-primary point chromaticity green primary point
64         -intent type         type of rendering intent when managing the image
65       color
66         -interlace type      type of image interlacing scheme
67         -interpolate method  pixel color interpolation method
68         -kerning value       set the space between two letters
69         -label string        assign a label to an image
70         -limit type value    pixel cache resource limit
71         -loop  iterations      add Netscape loop extension to your GIF anima‐
72       tion
73         -mask filename       associate a mask with the image
74         -matte               store matte channel if the image has one
75         -mattecolor color    frame color
76         -monitor             monitor progress
77         -orient type         image orientation
78         -origin geometry     image origin
79         -page geometry       size and location of an image canvas (setting)
80         -ping                efficiently determine image attributes
81         -pointsize value     font point size
82         -preview type        image preview type
83         -quality value       JPEG/MIFF/PNG compression level
84         -quiet               suppress all warning messages
85         -red-primary point   chromaticity red primary point
86         -regard-warnings     pay attention to warning messages
87         -repage geometry     size and location of an image canvas
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         -statistic type geometry
94                              replace each pixel with corresponding  statistic
95       from the neighborhood
96         -stretch type        render text with this font stretch
97         -stroke color        graphic primitive stroke color
98         -strokewidth value   graphic primitive stroke width
99         -style type          render text with this font style
100         -support factor      resize support: > 1.0 is blurry, < 1.0 is sharp
101         -synchronize         synchronize image to storage device
102         -taint               declare the image as modified
103         -texture  filename     name  of  texture to tile onto the image back‐
104       ground
105         -tile-offset geometry
106                              tile offset
107         -treedepth value     color tree depth
108         -transparent-color color
109                              transparent color
110         -undercolor color    annotation bounding box color
111         -units type          the units of image resolution
112         -verbose             print detailed information about the image
113         -view                FlashPix viewing transforms
114         -virtual-pixel method
115                              virtual pixel access method
116         -weight type         render text with this font weight
117         -white-point point   chromaticity white point
118
119       Image Operators:
120         -adaptive-blur geometry
121                              adaptively blur  pixels;  decrease  effect  near
122       edges
123         -adaptive-resize geometry
124                              adaptively resize image with data dependent tri‐
125       angulation
126         -adaptive-sharpen geometry
127                              adaptively sharpen pixels; increase effect  near
128       edges
129         -annotate geometry text
130                              annotate the image with text
131         -auto-orient         automatically orient image
132         -bilateral-blur geometry
133                               non-linear, edge-preserving, and noise-reducing
134       smoothing filter
135         -black-threshold value
136                              force all pixels below the threshold into black
137         -blur geometry       reduce image noise and reduce detail levels
138         -border geometry     surround image with a border of color
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         -clip                clip along the first path from the 8BIM profile
143         -clip-mask filename  associate a clip mask with the image
144         -clip-path id        clip along a named path from the 8BIM profile
145         -colorize value      colorize the image with the fill color
146         -color-matrix matrix apply color correction to the image
147         -contrast            enhance or reduce the image contrast
148         -contrast-stretch geometry
149                              improve contrast by `stretching'  the  intensity
150       range
151         -convolve coefficients
152                              apply a convolution kernel to the image
153         -cycle amount        cycle the image colormap
154         -despeckle           reduce the speckles within an image
155         -draw string         annotate the image with a graphic primitive
156         -edge radius         apply a filter to detect edges in the image
157         -emboss radius       emboss an image
158         -enhance             apply a digital filter to enhance a noisy image
159         -equalize            perform histogram equalization to an image
160         -evaluate operator value
161                              evaluate  an  arithmetic, relational, or logical
162       expression
163         -extent geometry     set the image size
164         -extract geometry    extract area from image
165         -fft                 implements the discrete Fourier transform (DFT)
166         -flip                flip image vertically
167         -floodfill geometry color
168                              floodfill the image with color
169         -flop                flop image horizontally
170         -frame geometry      surround image with an ornamental border
171         -function name       apply a function to the image
172         -gamma value         level of gamma correction
173         -gaussian-blur geometry
174                              reduce image noise and reduce detail levels
175         -geometry geometry   preferred size or location of the image
176         -identify            identify the format and characteristics  of  the
177       image
178         -ift                  implements  the inverse discrete Fourier trans‐
179       form (DFT)
180         -implode amount      implode image pixels about the center
181         -integral            calculate the sum of values  (pixel  values)  in
182       the image
183         -lat geometry        local adaptive thresholding
184         -layers method       optimize or compare image layers
185         -level value         adjust the level of image contrast
186         -linear-stretch geometry
187                              improve contrast by `stretching with saturation'
188       the intensity range
189         -median geometry     apply a median filter to the image
190         -mode geometry       make each pixel the 'predominant color'  of  the
191       neighborhood
192         -modulate value      vary the brightness, saturation, and hue
193         -monochrome          transform image to black and white
194         -morphology method kernel
195                              apply a morphology method to the image
196         -motion-blur geometry
197                              simulate motion blur
198         -negate              replace each pixel with its complementary color
199         -noise geometry      add or reduce noise in an image
200         -normalize           transform image to span the full range of colors
201         -opaque color        change this color to the fill color
202         -ordered-dither NxN
203                              add  a  noise pattern to the image with specific
204       amplitudes
205         -paint radius        simulate an oil painting
206         -polaroid angle      simulate a Polaroid picture
207         -posterize levels    reduce the image to a limited  number  of  color
208       levels
209         -print string        interpret string and print to console
210         -profile filename    add, delete, or apply an image profile
211         -quantize colorspace reduce colors in this colorspace
212         -radial-blur angle   radial blur the image
213         -raise  value          lighten/darken image edges to create a 3-D ef‐
214       fect
215         -random-threshold low,high
216                              random threshold the image
217         -range-threshold values
218                              perform either hard or soft thresholding  within
219       some range of values in an image
220         -region geometry     apply options to a portion of the image
221         -render              render vector graphics
222         -resample geometry   change the resolution of an image
223         -resize geometry     resize the image
224         -roll geometry       roll an image vertically or horizontally
225         -rotate degrees      apply Paeth rotation to the image
226         -sample geometry     scale image with pixel sampling
227         -scale geometry      scale the image
228         -segment values      segment an image
229         -selective-blur geometry
230                              selectively   blur   pixels  within  a  contrast
231       threshold
232         -sepia-tone threshold
233                              simulate a sepia-toned photo
234         -set property value  set an image property
235         -shade degrees       shade the image using a distant light source
236         -shadow geometry     simulate an image shadow
237         -sharpen geometry    sharpen the image
238         -shave geometry      shave pixels from the image edges
239         -shear geometry      slide one edge of the image along  the  X  or  Y
240       axis
241         -sigmoidal-contrast geometry
242                              lightness rescaling using sigmoidal contrast en‐
243       hancement
244         -sketch geometry     simulate a pencil sketch
245         -solarize threshold  negate all pixels above the threshold level
246         -sort-pixels         sort each scanline in ascending order of  inten‐
247       sity
248         -splice geometry     splice the background color into the image
249         -spread amount       displace image pixels by a random amount
250         -strip               strip image of all profiles and comments
251         -swirl degrees       swirl image pixels about the center
252         -threshold value     threshold the image
253         -thumbnail geometry  create a thumbnail of the image
254         -tile filename       tile image when filling a graphic primitive
255         -tint value          tint the image with the fill color
256         -transform           affine transform image
257         -transparent color   make this color transparent within the image
258         -transpose           flip image vertically and rotate 90 degrees
259         -transverse          flop image horizontally and rotate 270 degrees
260         -trim                trim image edges
261         -type type           image type
262         -unique-colors       discard all but one of any pixel color
263         -unsharp geometry    sharpen the image
264         -vignette geometry   soften the edges of the image in vignette style
265         -wave geometry       alter an image along a sine wave
266         -white-threshold value
267                              force all pixels above the threshold into white
268
269
270       Image Channel Operators:
271         -channel-extract channel-list
272                               extract the channels in order
273         -channel-inject channel-list
274                               inject the channels in order
275         -channel-swap channel,channel
276                               swap the channels
277
278       Image Sequence Operators:
279         -affinity filename   transform image colors to match this set of col‐
280       ors
281         -append              append an image sequence top to bottom (use +ap‐
282       pend for left to right)
283         -clut                apply a color lookup table to the image
284         -coalesce            merge a sequence of images
285         -combine             combine a sequence of images
286         -composite           composite image
287         -crop geometry       cut out a rectangular region of the image
288         -deconstruct          break  down  an image sequence into constituent
289       parts
290         -evaluate-sequence operator
291                              evaluate an arithmetic, relational,  or  logical
292       expression
293         -flatten             flatten a sequence of images
294         -fx  expression       apply mathematical expression to an image chan‐
295       nel(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         -process arguments   process the image with a custom image filter
300         -separate            separate an image channel into a grayscale image
301         -smush geometry      smush an image sequence together
302         -write filename      write images to this file
303
304       Image Stack Operators:
305         -clone indexes       clone an image
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         -swap indexes        swap two images in the image sequence
311
312       Miscellaneous Options:
313         -debug events        display copious debugging information
314         -help                print program options
315         -log format          format of debugging information
316         -list type           print a list of supported option arguments
317         -version             print version information
318
319       Use any setting or operator as an output-option.  Only a limited number
320       of setting are  input-option. They include: -antialias, -caption, -den‐
321       sity, -define, -encoding, -font, -pointsize,  -size,  and  -texture  as
322       well as any of the miscellaneous options.
323
324       By  default, the image format of `file' is determined by its magic num‐
325       ber.  To specify a particular image format, precede the  filename  with
326       an  image  format name and a colon (i.e. ps:image) or specify the image
327       type as the filename suffix (i.e. image.ps).  Specify 'file' as '-' for
328       standard input or output.
329

SEE ALSO

331       ImageMagick(1)
332
333
335       Copyright  (C)  1999  ImageMagick Studio LLC. Additional copyrights and
336       licenses  apply  to  this  software,  see  file:///usr/share/doc/Image‐
337       Magick-7/www/license.html or https://imagemagick.org/script/license.php
338
339
340
341ImageMagick                Date: 2009/01/10 01:00:00                 magick(1)
Impressum