1magick(1) General Commands Manual magick(1)
2
6 magick-script - scripting language that converts between image formats
7 as well as resize an image, blur, crop, despeckle, dither, draw on,
8 flip, join, re-sample, and much more.
9
11 magick-script [input-options] input-file [output-options] output-file
12
14 The magick-script program is a member of the ImageMagick(1) suite of
15 tools. Use it to convert between image formats as well as resize an
16 image, blur, crop, despeckle, dither, draw on, flip, join, re-sample,
17 and much more. Here is an example script:
18 #!/bin/env magick-script
20 -size 100x100 xc:red ( rose: -rotate -90 ) +append -write show:
21 For more information about the magick-script command, point your
23 browser to file:///usr/share/doc/ImageMagick-7/www/magick-script.html
24 or https://imagemagick.org/script/magick-script.php.
25
27 Image Settings:
28 -adjoin join images into a single multi-image file
29 -affine matrix affine transform matrix
30 -antialias remove pixel-aliasing
31 -authenticate value decrypt image with this password
32 -background color background color
33 -bias value add bias when convolving an image
34 -black-point-compensation
35 use black point compensation
36 -blue-primary point chromaticity blue primary point
37 -bordercolor color border color
38 -caption string assign a caption to an image
39 -cdl filename color correct with a color decision list
40 -colors value preferred number of colors in the image
41 -colorspace type alternate image colorspace
42 -comment string annotate image with comment
43 -compose operator set image composite operator
44 -compress type type of pixel compression when writing the image
45 -decipher filename magick cipher pixels to plain pixels
46 -define format:option
47 define one or more image format options
48 -delay centiseconds display the next image after pausing
49 -density geometry horizontal and vertical density of the image
50 -depth value image depth
51 -direction type render text right-to-left or left-to-right
52 -display server get image or font from this X server
53 -dispose method layer disposal method
54 -dither method apply error diffusion to image
55 -encipher filename magick plain pixels to cipher pixels
56 -encoding type text encoding type
57 -endian type endianness (MSB or LSB) of the image
58 -family name render text with this font family
59 -fill color color to use when filling a graphic primitive
60 -filter type use this filter when resizing an image
61 -flatten flatten a sequence of images
62 -font name render text with this font
63 -format "string" output formatted image characteristics
64 -fuzz distance colors within this distance are considered equal
65 -gravity type horizontal and vertical text placement
66 -green-primary point chromaticity green primary point
67 -intent type type of rendering intent when managing the image
68 color
69 -interlace type type of image interlacing scheme
70 -interpolate method pixel color interpolation method
71 -kerning value set the space between two letters
72 -label string assign a label to an image
73 -limit type value pixel cache resource limit
74 -loop iterations add Netscape loop extension to your GIF anima‐
75 tion
76 -mask filename associate a mask with the image
77 -matte store matte channel if the image has one
78 -mattecolor color frame color
79 -monitor monitor progress
80 -orient type image orientation
81 -origin geometry image origin
82 -page geometry size and location of an image canvas (setting)
83 -ping efficiently determine image attributes
84 -pointsize value font point size
85 -preview type image preview type
86 -quality value JPEG/MIFF/PNG compression level
87 -quiet suppress all warning messages
88 -red-primary point chromaticity red primary point
89 -regard-warnings pay attention to warning messages
90 -repage geometry size and location of an image canvas
91 -sampling-factor geometry
92 horizontal and vertical sampling factor
93 -scene value image scene number
94 -seed value seed a new sequence of pseudo-random numbers
95 -size geometry width and height of image
96 -statistic type geometry
97 replace each pixel with corresponding statistic
98 from the neighborhood
99 -stretch type render text with this font stretch
100 -stroke color graphic primitive stroke color
101 -strokewidth value graphic primitive stroke width
102 -style type render text with this font style
103 -support factor resize support: > 1.0 is blurry, < 1.0 is sharp
104 -synchronize synchronize image to storage device
105 -taint declare the image as modified
106 -texture filename name of texture to tile onto the image back‐
107 ground
108 -tile-offset geometry
109 tile offset
110 -treedepth value color tree depth
111 -transparent-color color
112 transparent color
113 -undercolor color annotation bounding box color
114 -units type the units of image resolution
115 -verbose print detailed information about the image
116 -view FlashPix viewing transforms
117 -virtual-pixel method
118 virtual pixel access method
119 -weight type render text with this font weight
120 -white-point point chromaticity white point
121 Image Operators:
123 -adaptive-blur geometry
124 adaptively blur pixels; decrease effect near
125 edges
126 -adaptive-resize geometry
127 adaptively resize image with data dependent tri‐
128 angulation
129 -adaptive-sharpen geometry
130 adaptively sharpen pixels; increase effect near
131 edges
132 -annotate geometry text
133 annotate the image with text
134 -auto-orient automatically orient image
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 -lat geometry local adaptive thresholding
182 -layers method optimize or compare image layers
183 -level value adjust the level of image contrast
184 -linear-stretch geometry
185 improve contrast by `stretching with saturation'
186 the intensity range
187 -median geometry apply a median filter to the image
188 -mode geometry make each pixel the 'predominant color' of the
189 neighborhood
190 -modulate value vary the brightness, saturation, and hue
191 -monochrome transform image to black and white
192 -morphology method kernel
193 apply a morphology method to the image
194 -motion-blur geometry
195 simulate motion blur
196 -negate replace each pixel with its complementary color
197 -noise geometry add or reduce noise in an image
198 -normalize transform image to span the full range of colors
199 -opaque color change this color to the fill color
200 -ordered-dither NxN
201 add a noise pattern to the image with specific
202 amplitudes
203 -paint radius simulate an oil painting
204 -polaroid angle simulate a Polaroid picture
205 -posterize levels reduce the image to a limited number of color
206 levels
207 -print string interpret string and print to console
208 -profile filename add, delete, or apply an image profile
209 -quantize colorspace reduce colors in this colorspace
210 -radial-blur angle radial blur the image
211 -raise value lighten/darken image edges to create a 3-D ef‐
212 fect
213 -random-threshold low,high
214 random threshold the image
215 -range-threshold values
216 perform either hard or soft thresholding within
217 some range of values in an image
218 -region geometry apply options to a portion of the image
219 -render render vector graphics
220 -resample geometry change the resolution of an image
221 -resize geometry resize the image
222 -roll geometry roll an image vertically or horizontally
223 -rotate degrees apply Paeth rotation to the image
224 -sample geometry scale image with pixel sampling
225 -scale geometry scale the image
226 -segment values segment an image
227 -selective-blur geometry
228 selectively blur pixels within a contrast
229 threshold
230 -sepia-tone threshold
231 simulate a sepia-toned photo
232 -set property value set an image property
233 -shade degrees shade the image using a distant light source
234 -shadow geometry simulate an image shadow
235 -sharpen geometry sharpen the image
236 -shave geometry shave pixels from the image edges
237 -shear geometry slide one edge of the image along the X or Y
238 axis
239 -sigmoidal-contrast geometry
240 lightness rescaling using sigmoidal contrast en‐
241 hancement
242 -sketch geometry simulate a pencil sketch
243 -solarize threshold negate all pixels above the threshold level
244 -splice geometry splice the background color into the image
245 -spread amount displace image pixels by a random amount
246 -strip strip image of all profiles and comments
247 -swirl degrees swirl image pixels about the center
248 -threshold value threshold the image
249 -thumbnail geometry create a thumbnail of the image
250 -tile filename tile image when filling a graphic primitive
251 -tint value tint the image with the fill color
252 -transform affine transform image
253 -transparent color make this color transparent within the image
254 -transpose flip image vertically and rotate 90 degrees
255 -transverse flop image horizontally and rotate 270 degrees
256 -trim trim image edges
257 -type type image type
258 -unique-colors discard all but one of any pixel color
259 -unsharp geometry sharpen the image
260 -vignette geometry soften the edges of the image in vignette style
261 -wave geometry alter an image along a sine wave
262 -white-threshold value
263 force all pixels above the threshold into white
264 Image Channel Operators:
267 -channel-extract channel-list
268 extract the channels in order
269 -channel-inject channel-list
270 inject the channels in order
271 -channel-swap channel,channel
272 swap the channels
273 Image Sequence Operators:
275 -affinity filename transform image colors to match this set of col‐
276 ors
277 -append append an image sequence top to bottom (use +ap‐
278 pend for left to right)
279 -clut apply a color lookup table to the image
280 -coalesce merge a sequence of images
281 -combine combine a sequence of images
282 -composite composite image
283 -crop geometry cut out a rectangular region of the image
284 -deconstruct break down an image sequence into constituent
285 parts
286 -evaluate-sequence operator
287 evaluate an arithmetic, relational, or logical
288 expression
289 -flatten flatten a sequence of images
290 -fx expression apply mathematical expression to an image chan‐
291 nel(s)
292 -hald-clut apply a Hald color lookup table to the image
293 -morph value morph an image sequence
294 -mosaic create a mosaic from an image sequence
295 -process arguments process the image with a custom image filter
296 -separate separate an image channel into a grayscale image
297 -smush geometry smush an image sequence together
298 -write filename write images to this file
299 Image Stack Operators:
301 -clone indexes clone an image
302 -delete indexes delete the image from the image sequence
303 -duplicate count,indexes
304 duplicate an image one or more times
305 -insert index insert last image into the image sequence
306 -swap indexes swap two images in the image sequence
307 Miscellaneous Options:
309 -debug events display copious debugging information
310 -help print program options
311 -log format format of debugging information
312 -list type print a list of supported option arguments
313 -version print version information
314 Use any setting or operator as an output-option. Only a limited number
316 of setting are input-option. They include: -antialias, -caption, -den‐
317 sity, -define, -encoding, -font, -pointsize, -size, and -texture as
318 well as any of the miscellaneous options.
319 By default, the image format of `file' is determined by its magic num‐
321 ber. To specify a particular image format, precede the filename with
322 an image format name and a colon (i.e. ps:image) or specify the image
323 type as the filename suffix (i.e. image.ps). Specify 'file' as '-' for
324 standard input or output.
325
327 ImageMagick(1)
328
331 Copyright (C) 1999 ImageMagick Studio LLC. Additional copyrights and
332 licenses apply to this software, see file:///usr/share/doc/Image‐
333 Magick-7/www/license.html or https://imagemagick.org/script/license.php
334ImageMagick Date: 2009/01/10 01:00:00 magick(1)