Lines Matching +full:- +full:- +full:enable +full:- +full:hdri
8 <meta charset="utf-8" />
9 <meta name="viewport" content="width=device-width, initial-scale=1" />
10 <title>ImageMagick - Command-line Options</title>
11 <meta name="application-name" content="ImageMagick" />
13 <meta name="application-url" content="https://imagemagick.org" />
15 <meta name="keywords" content="command-line, options, image processing software" />
20 <meta name="revisit-after" content="2 DAYS" />
21 <meta name="resource-type" content="document" />
22 <meta name="copyright" content="Copyright (c) 1999-2020 ImageMagick Studio LLC" />
24 <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1" />
31 <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
32 <link href="../www/command-line-options.html" rel="canonical" />
38 <nav class="navbar navbar-expand-md navbar-dark bg-dark fixed-top">
39 <div class="container-fluid">
40 …<a class="navbar-brand" href="../index.html"><img class="d-block" id="icon" alt="ImageMagick" widt…
41 …navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#magick-navbars" aria-cont…
42 <span class="navbar-toggler-icon"></span>
45 <div class="collapse navbar-collapse" id="magick-navbars">
46 <ul class="navbar-nav me-auto mb-2 mb-md-0">
47 <li class="nav-item">
48 <a class="nav-link " href="index.html">Home</a>
50 <li class="nav-item">
51 <a class="nav-link " href="download.html">Download</a>
53 <li class="nav-item">
54 <a class="nav-link " href="command-line-tools.html">Tools</a>
56 <li class="nav-item">
57 <a class="nav-link " href="command-line-processing.html">CLI</a>
59 <li class="nav-item">
60 <a class="nav-link " href="develop.html">Develop</a>
62 <li class="nav-item">
63 …<a class="nav-link" target="_blank" href="https://github.com/ImageMagick/ImageMagick/discussions">…
65 <li class="nav-item">
69 <form class="d-flex form-inline" action="../www/search.html">
70 … <input class="form-control me-2" type="text" name="q" placeholder="Search" aria-label="Search">
71 <button class="btn btn-outline-success" type="submit" name="sa">Search</button>
81 data-ad-client="ca-pub-3129977114552745"
82 data-ad-slot="6345125851"
83 data-full-width-responsive="true"
84 data-ad-format="horizontal"></ins>
92 <div class="magick-template">
93 <div class="magick-header">
94 <h1 class="text-center">Annotated List of Command-line Options</h1>
95 …-center"><a class="text-nowrap" href="command-line-options.html#adaptive-blur">-adaptive-blur</a> …
96 …s="lead magick-description">Below is list of command-line options recognized by the ImageMagick <a…
99 …<h3><a class="anchor" id="adaptive-blur"></a>-adaptive-blur <var>radius</var>[x<var>sigma</var>]</…
102 <p class="magick-description">Adaptively blur pixels, with decreasing effect near edges.</p>
108 <h3><a class="anchor" id="adaptive-resize"></a>-adaptive-resize <var>geometry</var></h3>
111 <p class="magick-description">Resize the image using data-dependent triangulation.</p>
113 …-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">…
114 option defaults to data-dependent triangulation. Use the <a
115 href="command-line-options.html#filter">-filter</a> to choose a different resampling algorithm.
117 href="command-line-options.html#gravity">-gravity</a> option has no effect.</p>
120 …<h3><a class="anchor" id="adaptive-sharpen"></a>-adaptive-sharpen <var>radius</var>[x<var>sigma</v…
123 <p class="magick-description">Adaptively sharpen pixels, with increasing effect near edges.</p>
130 <h3><a class="anchor" id="adjoin"></a>-adjoin</h3>
133 <p class="magick-description">Join images into a single multi-image file.</p>
140 adding a <a href="command-line-options.html#scene">-scene</a> number before the suffix, in order to
143 <p>Use <a href="command-line-options.html#adjoin">+adjoin</a> to force each image to be written to
147 <p>Including a C-style integer format string in the output filename will
148 automagically enable <a href="command-line-options.html#adjoin">+adjoin</a> and are used to specify
149 where the <a href="command-line-options.html#scene">-scene</a> number is placed in the filenames. T…
151 who have used the standard <code>printf()</code>' C-library function. As an
154 <pre class="highlight"><code>magick logo: rose: -morph 15 my%02dmorph.jpg
158 <a href="command-line-options.html#morph">-morph</a>), named: my00morph.jpg, my01morph.jpg,
164 <li>the output image's file format does not allow multi-image files,</li>
165 <li>the <a href="command-line-options.html#adjoin">+adjoin</a> option is given, or</li>
172 <h3><a class="anchor" id="affine"></a>-affine
176 <p class="magick-description">Set the drawing transformation matrix for combined rotating and scali…
179 href="command-line-options.html#draw">-draw</a> or <a href="command-line-options.html#transform">-t…
181 <p>The matrix entries are entered as comma-separated numeric values either in
190 <p class="text-center"><img class="img-thumbnail" alt="affine transformation" src="../images/affin…
198 <p>The transformation matrix complies with the left-handed pixel coordinate
210 <p>See <a href="command-line-options.html#transform">-transform</a>, and the <a
211 href="command-line-options.html#distort">-distort</a> method '<code>Affineprojection</code> for more
215 <pre class="highlight"><code>-affine <var>s<sub>x</sub></var>,0,0,<var>s<sub>y</sub></var>
220 <pre class="highlight"><code>-affine 1,0,0,1,<var>t<sub>x</sub></var>,<var>t<sub>y</sub></var>
223 <p>Rotate clockwise about the origin (the upper left-hand corner) by an angle
227 <pre class="highlight"><code>-affine <var>c</var>,<var>s</var>,-<var>s</var>,<var>c</var>
230 <p>The cumulative effect of a sequence of <a href="command-line-options.html#affine" >-affine</a>
231 transformations can be accomplished by instead by a single <a href="command-line-options.html#affin…
232 >-affine</a> operation using the matrix equal to the product of the matrices
235 <p>An attempt is made to detect near-singular transformation matrices. If the
239 <h3><a class="anchor" id="alpha"></a>-alpha <var>type</var></h3>
242 <p class="magick-description">Gives control of the alpha/matte channel of an image.</p>
247 <div class="pre-scrollable highlight">
249 <dt class="col-md-4">Activate</dt>
250 <dd class="col-md-8">
251 Enable the image's transparency channel. Note normally Set
256 <dt class="col-md-4">Associate</dt>
257 <dd class="col-md-8">
260 <dt class="col-md-4">Deactivate</dt>
261 <dd class="col-md-8">
265 <dt class="col-md-4">Disassociate</dt>
266 <dd class="col-md-8">
269 <dt class="col-md-4">Set</dt>
270 <dd class="col-md-8">
275 <dt class="col-md-4">Opaque</dt>
276 <dd class="col-md-8">
280 <dt class="col-md-4">Transparent</dt>
281 <dd class="col-md-8">
287 <dt class="col-md-4">Extract</dt>
288 <dd class="col-md-8">
295 <dt class="col-md-4">Copy</dt>
296 <dd class="col-md-8">
302 <dt class="col-md-4">Shape</dt>
303 <dd class="col-md-8">
309 <dt class="col-md-4">Remove</dt>
310 <dd class="col-md-8">
314 <dt class="col-md-4">Background</dt>
315 <dd class="col-md-8">
316 Set any fully-transparent pixel to the background color, while leaving
317 it fully-transparent. This can make some image file formats, such as
326 same as "<code><a href="command-line-options.html#alpha" >-alpha</a> Off</code>", the <code>
327 >-matte</code> operation was the same as "<code><a href="command-line-options.html#alpha" >-alpha</…
328 Set</code>" and not "<code><a href="command-line-options.html#alpha" >-alpha</a> On</code>". </p>
330 <div class="pre-scrollable highlight" style="margin: auto;">
332 -annotate <var>degrees</var> <var>text</var><br />
333 …-annotate <var>Xdegrees</var>x<var>Ydegrees</var> <var>text</var><br /> -annotate <var>Xdegrees</v…
336 <p class="magick-description">Annotate an image with text</p>
339 control over text annotations, use <a href="command-line-options.html#draw">-draw</a>.</p>
343 …t give the location of the text relative any <a href="command-line-options.html#gravity" >-gravity…
345 <p>Using <a href="command-line-options.html#annotate">-annotate</a> <var>degrees</var>
346 or <a href="command-line-options.html#annotate">-annotate</a> <var>degrees</var>x<var>degrees</var>…
354 <p class="text-center"><img class="img-thumbnail" alt="annotate transformation" src="../images/ann…
357 bottom-left of the text becomes the upper-left corner of the image, which is
358 probably undesirable. Adding a <a href="command-line-options.html#gravity" >-gravity</a> option in …
361 <p>Text is any UTF-8 encoded character sequence. If <var>text</var>
367 <h3><a class="anchor" id="antialias"></a>-antialias</h3>
370 <p class="magick-description">Enable/Disable of the rendering of anti-aliasing pixels when drawing …
373 drawn. Use <a href="command-line-options.html#antialias">+antialias</a> to disable the addition of
379 <h3><a class="anchor" id="append"></a>-append</h3>
382 <p class="magick-description">Join current images vertically or horizontally.</p>
385 images in sequence top-to-bottom. Use <a href="command-line-options.html#append">+append</a> to
386 stack images left-to-right. </p>
389 current <a href="command-line-options.html#background">-background</a> color setting, and their
391 href="command-line-options.html#gravity">-gravity</a> setting. </p>
395 <h3><a class="anchor" id="attenuate"></a>-attenuate <var>value</var></h3>
398 <p class="magick-description">Lessen (or intensify) when adding noise to an image.</p>
403 <h3><a class="anchor" id="authenticate"></a>-authenticate <var>password</var></h3>
406 <p class="magick-description">Decrypt a PDF with a password.</p>
412 <p>For a different encryption method, see <a href="command-line-options.html#encipher">-encipher</a>
413 and <a href="command-line-options.html#decipher">-decipher</a>. </p>
417 <h3><a class="anchor" id="auto-gamma"></a>-auto-gamma</h3>
420 <p class="magick-description">Automagically adjust gamma level of image.</p>
423 href="command-line-options.html#gamma" >-gamma</a> adjustment so that the mean color in the
428 <p>This works well for real-life images with little or no extreme dark and
433 <p>It uses the <a href="command-line-options.html#channel" >-channel</a> setting, (including the
435 values is used and modified. As the default <a href="command-line-options.html#channel"
436 >-channel</a> setting is '<var>RGB,sync</var>', channels are modified
442 <h3><a class="anchor" id="auto-level"></a>-auto-level</h3>
445 <p class="magick-description">Automagically adjust color levels of image.</p>
449 href="command-line-options.html#level" >-level</a> operator to stretch the values to the full range…
452 <p>The operator is not typically used for real-life images, image scans, or
453 JPEG format images, as a single 'out-rider' pixel can set a bad min/max values
454 for the <a href="command-line-options.html#level" >-level</a> operation. On the other hand it is t…
459 <p>The operator is very similar to the <a href="command-line-options.html#normalize">-normalize</a>…
460 href="command-line-options.html#contrast-stretch" >-contrast-stretch</a>, and <a href="command-line…
461 >-linear-stretch</a> operators, but without 'histogram binning' or 'clipping'
462 problems that these operators may have. That is <a href="command-line-options.html#auto-level"
463 >-auto-level</a> is the perfect or ideal version these operators. </p>
465 <p>It uses the <a href="command-line-options.html#channel" >-channel</a> setting, (including the
468 href="command-line-options.html#channel" >+channel</a> setting is '<var>RGB,sync</var>', the
475 <h3><a class="anchor" id="auto-orient"></a>-auto-orient</h3>
478 <p class="magick-description">Adjusts an image so that its orientation is suitable for viewing (i.e…
489 href="command-line-options.html#auto-orient" >-auto-orient</a> operator will do nothing. </p>
492 <h3><a class="anchor" id="auto-threshold"></a>-auto-threshold <var>method</var></h3>
495 <p class="magick-description">Automatically perform image thresholding.</p>
499 <div class="pre-scrollable highlight">
501 <dt class="col-md-4">Undefined</dt><dd class="col-md-8">0: No method specified (equivalent to '<co…
502 <dt class="col-md-4">Kapur</dt><dd class="col-md-8">maximum entropy thresholding.</dd>
503 <dt class="col-md-4">OTSU</dt><dd class="col-md-8">cluster-based image thresholding.</dd>
504 <dt class="col-md-4">Triangle</dt><dd class="col-md-8">a geometric thresholding method.</dd>
508 …is returned as the <kbd>auto-threshold:verbose</kbd> image property. To instead print to your devi…
511 <h3><a class="anchor" id="average"></a>-average</h3>
514 <p class="magick-description">Average a set of images.</p>
520 <h3><a class="anchor" id="backdrop"></a>-backdrop</h3>
523 <p class="magick-description">Display the image centered on a backdrop.</p>
528 described under the <a href="command-line-options.html#fill">-fill</a> option.</p>
531 <h3><a class="anchor" id="background"></a>-background <var>color</var></h3>
534 <p class="magick-description">Set the background color.</p>
537 href="command-line-options.html#fill">-fill</a> option. The default background color (if none is
541 <h3><a class="anchor" id="bench"></a>-bench <var>iterations</var></h3>
544 <p class="magick-description">Measure performance.</p>
546 <p>Repeat the entire command for the given number of <var>iterations</var> and report the user-time…
548 -duration to run the benchmark for a fixed number of seconds and -concurrent
551 <pre class="highlight"><code>-> convert logo: -resize 200% -bench 5 logo.png
564 <h3><a class="anchor" id="bias"></a>-bias <var>value</var>{<var>%</var>}</h3>
567 <p class="magick-description">Add bias when convolving an image.</p>
569 <p>This option shifts the output of <a class="text-nowrap" href="command-line-options.html#convolve…
572 <p>This is important for non-HDRI compilations of ImageMagick when dealing
578 …n using an ImageMagick with the HDRI compile-time setting, <a class="text-nowrap" href="command-li…
582 <p>See the discussion on HDRI implementations of ImageMagick on the page <a
583 href="high-dynamic-range.html" >High Dynamic-Range Images</a>. For more
584 about HDRI go the ImageMagick <a
585 href="https://legacy.imagemagick.org/Usage/basics/#hdri" >Usage</a> pages or this
591 …="anchor" id="bilateral-blur"></a>-bilateral-blur <var>width</var>{x<var>height</var>}{<var>+inten…
594 <p class="magick-description">A non-linear, edge-preserving, and noise-reducing
603 that farther colors within the pixel neighborhood (see spatial-sigma)
604 will be mixed together, resulting in larger areas of semi-equal color.</p>
608 enough (see intensity-sigma ). When the neigborhood diameter is greater
610 spatial-sigma. Otherwise, the neigborhood diameter is proportional to
611 spatial-sigma.</p>
616 <h3><a class="anchor" id="black-point-compensation"></a>-black-point-compensation</h3>
619 <p class="magick-description">Use black point compensation.</p>
622 …<h3><a class="anchor" id="black-threshold"></a>-black-threshold <var>value</var>{<var>%</var>}</h3>
625 <p class="magick-description">Force to black all pixels below the threshold while leaving all pixel…
629 …="text-nowrap" href="command-line-options.html#channel">-channel</a> value. See <a class="text-now…
633 <h3><a class="anchor" id="blend"></a>-blend <var>geometry</var></h3>
636 <p class="magick-description">Blend an image into another by the given absolute value or percent.</…
642 <code>-blend 30%</code> merges 30% of the 'source' image with 70% of the
643 'destination' image. Thus it is equivalent to <code>-blend 30x70%</code>.</p>
647 <h3><a class="anchor" id="blue-primary"></a>-blue-primary <var>x</var>,<var>y</var></h3>
650 <p class="magick-description">Set the blue chromaticity primary point.</p>
653 <h3><a class="anchor" id="blue-shift"></a>-blue-shift <var>factor</var></h3>
656 <p class="magick-description">Simulate a scene at nighttime in the moonlight. Start with a factor …
661 …<h3><a class="anchor" id="blur"></a>-blur <var>radius</var><br />-blur <var>radius</var>{x<var>sig…
664 <p class="magick-description">Reduce image noise and reduce detail levels.</p>
669 <p class="text-center"><img class="img-thumbnail" alt="gaussian distribution" width="243px" height=…
686 <p>This option differs from <a href="command-line-options.html#gaussian-blur">-gaussian-blur</a> si…
688 we apply a single-dimensional Gaussian matrix in the horizontal direction,
691 <p>The <a href="command-line-options.html#virtual-pixel">-virtual-pixel</a> setting will determine …
697 <h3><a class="anchor" id="border"></a>-border <var>geometry</var></h3>
700 <p class="magick-description">Surround the image with a border of color. </p>
703 <var>geometry</var> argument. See <a href="command-line-processing.html#geometry">Image Geometry</…
706 <p>As of IM 6.7.8-8, the <var>geometry</var> arguments behave as follows:</p>
708 <div class="pre-scrollable highlight">
710 <dt class="col-md-4"><var>value</var></dt>
711 <dd class="col-md-8">value is added to both left/right and top/bottom</dd>
712 <dt class="col-md-4"><var>value-x</var><code>x</code></dt>
713 <dd class="col-md-8">value-x is added only to left/right and top/bottom are unchanged</dd>
714 <dt class="col-md-4"><code>x</code><var>value-y</var></dt>
715 <dd class="col-md-8">value-y is added only to top/bottom and left/right are unchanged</dd>
716 <dt class="col-md-4"><var>value-x</var><code>x</code><var>value-y</var></dt>
717 <dd class="col-md-8">value-x is added to left/right and value-y added to top/bottom</dd>
718 <dt class="col-md-4"><var>value-x</var><code>x</code>0</dt>
719 <dd class="col-md-8">value-x is added only to left/right and top/bottom are unchanged</dd>
720 <dt class="col-md-4">0<code>x</code><var>value-y</var></dt>
721 <dd class="col-md-8">value-y is added only to top/bottom and left/right are unchanged</dd>
722 <dt class="col-md-4"><var>value</var>%</dt>
723 <dd class="col-md-8">value % of width is added to left/right and value % of height is added to top/…
724 <dt class="col-md-4"><var>value-x</var><code>x</code>%</dt>
725 <dd class="col-md-8">value-x % of width is added to left/right and to top/bottom</dd>
726 <dt class="col-md-4">x<var>value-y</var>%</dt>
727 <dd class="col-md-8">value-y % of height is added to top/bottom and to left/right</dd>
728 <dt class="col-md-4"><var>value-x</var>%<code>x</code><var>value-y</var>%</dt>
729 <dd class="col-md-8">value-x % of width is added to left/right and value-y % of height is added to …
730 <dt class="col-md-4"><var>value-x</var>%<code>x</code>0%</dt>
731 <dd class="col-md-8">value-x % of width is added to left/right and top/bottom are unchanged</dd>
732 <dt class="col-md-4">0%<code>x</code><var>value-y</var>%</dt>
733 <dd class="col-md-8">value-y % of height is added to top/bottom and left/right are unchanged</dd>
738 href="command-line-options.html#bordercolor">-bordercolor</a> setting.</p>
740 <p>The <a href="command-line-options.html#border">-border</a> operation is affected by the current …
741 href="command-line-options.html#compose">-compose</a> setting and assumes that this is using the de…
743 size colors by the current <a href="command-line-options.html#bordercolor">-bordercolor</a> before
746 be replaced by the current <a href="command-line-options.html#bordercolor">-bordercolor</a> setting…
747 <p>See also the <a href="command-line-options.html#frame">-frame</a> option, which has more
751 <h3><a class="anchor" id="bordercolor"></a>-bordercolor <var>color</var></h3>
754 <p class="magick-description">Set the border color.</p>
756 …specified using the format described under the <a href="command-line-options.html#fill">-fill</a> …
758 <p>The default border color is <code>#DFDFDF</code>, <span style="background-color: #dfdfdf;">this …
761 <h3><a class="anchor" id="borderwidth"></a>-borderwidth <var>geometry</var> </h3>
764 <p class="magick-description">Set the border width.</p>
767 …<h3><a class="anchor" id="brightness-contrast"></a>-brightness-contrast <var>brightness</var><br /…
770 <p class="magick-description">Adjust the brightness and/or contrast of the image.</p>
774 The range of values is -100 to +100 on each. Positive values increase the
779 <p>You may also use <a href="command-line-options.html#fill">-channel</a> to control which channels…
785 using <a href="command-line-options.html#fill">-function polynomial "slope,offset"</a>.</p>
787 <p>The slope varies from 0 at contrast=-100 to almost vertical at
788 contrast=+100. For brightness=0 and contrast=-100, the result are totally
796 <p>The offset varies from -0.5 at brightness=-100 to 0 at brightness=0 to +0.5
798 totally white. Similarly, when contrast=0 and brightness=-100, the result is
801 <p>As the range of values for the arguments are -100 to +100, adding the '%'
805 <h3><a class="anchor" id="cache"></a>-cache <var>threshold</var></h3>
808 <p class="magick-description">(This option has been replaced by the <a href='command-line-options.h…
811 …hor" id="canny"></a>-canny <var>radius</var><br/>-canny <var>radius</var>{x<var>sigma</var>}{<var>…
814 <p class="magick-description">Canny edge detector uses a multi-stage algorithm to detect a wide ran…
816 …-canny 0x1+10%+30%) with {<var>+lower-percent</var>} < {<var>+upper-percent</var>}. If {<var>+u…
819 <h3><a class="anchor" id="caption"></a>-caption <var>string</var></h3>
822 <p class="magick-description">Assign a caption to an image.</p>
824 <p>This option sets the caption meta-data of an image read in after this
826 "<code><a href="command-line-options.html#set">-set</a> caption</code>". </p>
837 <p>Caption meta-data is not visible on the image itself. To do that use the
838 <a href="command-line-options.html#annotate">-annotate</a> or <a href="command-line-options.html#dr…
843 <pre class="highlight"><code>-caption "%m:%f %wx%h" bird.miff
852 <h3><a class="anchor" id="cdl"></a>-cdl <var>filename</var></h3>
855 <p class="magick-description">Color correct with a color decision list.</p>
859 <pre class="highlight"><code><?xml version="1.0" encoding="UTF-8"?>
864 <Offset> 0.4 -0.5 0.6 </Offset>
875 <h3><a class="anchor" id="channel"></a>-channel <var>type</var></h3>
878 <p class="magick-description">Specify those image color channels to which subsequent operators are …
886 <p>The channels above can also be specified as a comma-separated list or can be
904 <code>-channel Red,Blue</code>
905 <code>-channel R,B</code>
906 <code>-channel RB</code>
907 <code>-channel 0,2</code>
912 but generally any operators that are generally 'grey-scale' image operators,
917 operators that understand this flag should perform: cross-channel
918 synchronization of the channels. If not specified, then most grey-scale
920 channel (as specified by the rest of the <a href="command-line-options.html#channel">-channel</a>
923 <p>For example for operators such as <a href="command-line-options.html#auto-level">-auto-level</a>…
924 <a href="command-line-options.html#auto-gamma">-auto-gamma</a> the color channels are modified
925 together in exactly the same way so that colors will remain in-sync. Without
929 <p>The <a href="command-line-options.html#morphology">-morphology</a> '<code>Convolve</code>' method
930 and the <a href="command-line-options.html#compose">-compose</a> mathematical methods, also underst…
933 processing with the understanding that fully-transparent colors should not
937 treats transparency as special, unless the <a href="command-line-options.html#channel">-channel</a>
943 <p>To print a complete list of channel types, use <a href="command-line-options.html#list">-list
946 <p>By default, ImageMagick sets <a href="command-line-options.html#channel">-channel</a> to the val…
951 href="command-line-options.html#channel" >+channel</a> will reset the value back to this default. <…
953 <p>Options that are affected by the <a href="command-line-options.html#channel" >-channel</a> setti…
956 <a href="command-line-options.html#auto-gamma">-auto-gamma</a>,
957 <a href="command-line-options.html#auto-level">-auto-level</a>,
958 <a href="command-line-options.html#black-threshold">-black-threshold</a>,
959 <a href="command-line-options.html#blur">-blur</a>,
960 <a href="command-line-options.html#clamp">-clamp</a>,
961 <a href="command-line-options.html#clut">-clut</a>,
962 <a href="command-line-options.html#combine">-combine</a>,
963 <a href="command-line-options.html#composite">-composite</a> (Mathematical compose methods only),
964 <a href="command-line-options.html#convolve">-convolve</a>,
965 <a href="command-line-options.html#contrast-stretch">-contrast-stretch</a>,
966 <a href="command-line-options.html#evaluate">-evaluate</a>,
967 <a href="command-line-options.html#function">-function</a>,
968 <a href="command-line-options.html#fx">-fx</a>,
969 <a href="command-line-options.html#gaussian-blur">-gaussian-blur</a>,
970 <a href="command-line-options.html#hald-clut">-hald-clut</a>,
971 <a href="command-line-options.html#motion-blur">-motion-blur</a>,
972 <a href="command-line-options.html#morphology">-morphology</a>,
973 <a href="command-line-options.html#negate">-negate</a>,
974 <a href="command-line-options.html#normalize">-normalize</a>,
975 <a href="command-line-options.html#ordered-dither">-ordered-dither</a>,
976 <a href="command-line-options.html#radial-blur">-radial-blur</a>,
977 <a href="command-line-options.html#random-threshold">-random-threshold</a>,
978 <a href="command-line-options.html#range-threshold">-range-threshold</a>,
979 <a href="command-line-options.html#separate">-separate</a>,
980 <a href="command-line-options.html#threshold">-threshold</a>, and
981 <a href="command-line-options.html#white-threshold">-white-threshold</a>.
984 <p>Warning, some operators behave differently when the <a href="command-line-options.html#channel"
986 href="command-line-options.html#channel" >-channel</a> setting (including the equivalent of the
990 <p>For example <a href="command-line-options.html#threshold">-threshold</a> will by default graysca…
991 the image before thresholding, if no <a href="command-line-options.html#channel" >-channel</a> sett…
994 <p>Also some operators such as <a href="command-line-options.html#blur">-blur</a>, <a
995 href="command-line-options.html#gaussian-blur">-gaussian-blur</a>, will modify their handling of the
997 href="command-line-options.html#channel" >-channel</a>. Generally this done to ensure that
998 fully-transparent colors are treated as being fully-transparent, and thus any
1000 resulting in 'halo' effects. The newer <a href="command-line-options.html#morphology">-morphology</…
1006 alpha channel present, and the <a href="command-line-options.html#channel" >-channel</a> setting te…
1008 href="command-line-options.html#clut">-clut</a> operator is a good example of this. </p>
1011 <h3><a class="anchor" id="channel-fx"></a>-channel-fx <var>expression</var></h3>
1014 <p class="magick-description">Exchange, extract, or copy one or more image channels.</p>
1028 <pre class="highlight"><code>-channel-fx "red; green; blue"
1034 <pre class="highlight"><code>magick wizard.png mask.pgm -channel-fx '| gray=>alpha' wizard-alpha.png
1037 <pre class="highlight"><code>magick wizard.png mask.pgm -channel-fx '| gray=>read-mask' wizard-mask…
1040 <p>Add <code>-debug pixel</code> prior to the <code>-channel-fx</code> option to track the channel …
1043 <h3><a class="anchor" id="charcoal"></a>-charcoal <var>factor</var></h3>
1046 <p class="magick-description">Simulate a charcoal drawing.</p>
1049 <h3><a class="anchor" id="chop"></a>-chop <var>geometry</var></h3>
1052 <p class="magick-description">Remove pixels from the interior of an image.</p>
1054 <p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details abou…
1059 a <a href="command-line-options.html#gravity">-gravity</a> setting, if present.</p>
1061 <p>The <a href="command-line-options.html#chop">-chop</a> option removes entire rows and columns,
1065 typically used with as <a href="command-line-options.html#gravity">-gravity</a> setting and zero
1067 href="command-line-options.html#shave" >-shave</a> which removes equal numbers of pixels from oppos…
1070 <p>Using <a href="command-line-options.html#chop">-chop</a> effectively undoes the results of a <a
1071 …f="command-line-options.html#splice">-splice</a> that was given the same <var>geometry</var> and <…
1074 …3><a class="anchor" id="clahe"></a>-clahe <var>width</var>x<var>height</var>{%}{+}<var>number-bins…
1077 <p class="magick-description">Contrast limited adaptive histogram equalization.</p>
1078 …-bins</var> is the number of histogram bins per tile (min 2, max 65536). The number of histogram …
1082 <h3><a class="anchor" id="clamp"></a>-clamp</h3>
1085 <p class="magick-description">Set each pixel whose value is below zero to zero and any the pixel wh…
1088 <h3><a class="anchor" id="clip"></a>-clip</h3>
1091 <p class="magick-description">Apply the clipping path if one is present.</p>
1097 <pre class="highlight"><code>magick cockatoo.tif -clip -negate negated.tif
1102 <p>The <a href="command-line-options.html#clip">-clip</a> feature requires SVG support. If the SVG
1105 <p>Use <a href="command-line-options.html#clip">+clip</a> to disable clipping for subsequent operat…
1108 <h3><a class="anchor" id="clip-mask"></a>-clip-mask</h3>
1111 <p class="magick-description">Clip the image as defined by this mask.</p>
1119 a rectangular <a href="command-line-options.html#region" >-region</a>, or using the negative of the
1120 mask (third) image in a three image <a href="command-line-options.html#composite" >-composite</a>,
1123 <p>Use <a href="command-line-options.html#clip-mask">+clip-mask</a> to disable clipping for subsequ…
1126 <h3><a class="anchor" id="clip-path"></a>-clip-path <var>id</var></h3>
1129 <p class="magick-description">Clip along a named path from the 8BIM profile.</p>
1131 <p>This is identical to <a href="command-line-options.html#clip">-clip</a> except choose a specific…
1133 <p>Use <a href="command-line-options.html#clip-path">+clip-path</a> to disable clipping for subsequ…
1136 <h3><a class="anchor" id="clone"></a>-clone <var>index(s)</var></h3>
1139 <p class="magick-description">Make a clone of an image (or images).</p>
1154 <p>The <a href="command-line-options.html#clone">+clone</a> will simply make a copy of the last ima…
1159 <h3><a class="anchor" id="clut"></a>-clut</h3>
1162 <p class="magick-description">Replace the channel values in the first image using each correspondin…
1168 top-left to bottom-right corners.</p>
1171 href="command-line-options.html#interpolate">-interpolate</a> setting, which is especially handy fo…
1174 '<code>catrom</code>'. Catom can return a useful second-order continuity.</p>
1179 <p>Only the channel values defined by the <a href="command-line-options.html#channel">-channel</a>
1181 href="command-line-options.html#channel">-channel</a> setting is <code>RGB</code>, this means that
1183 href="command-line-options.html#channel">-channel</a> setting is modified. When the alpha channel is
1184 set, it is treated by the <a href="command-line-options.html#clut" >-clut</a> operator in the same …
1189 transparency (i.e. <a href="command-line-options.html#alpha" >-alpha</a> is turned 'off') but the <a
1190 href="command-line-options.html#channel">-channel</a> setting includes alpha replacement, then it is
1197 <p>See also <a href="command-line-options.html#hald-clut" >-hald-clut</a> which replaces colors
1203 <h3><a class="anchor" id="coalesce"></a>-coalesce</h3>
1206 <p class="magick-description">Fully define the look of each frame of an GIF animation sequence, to …
1209 its <a href="command-line-options.html#dispose">-dispose</a> meta-data, to reproduce the look of
1216 <p>The animation can be re-optimized after processing using
1217 the <a href="command-line-options.html#layers">-layers</a> method '<code>optimize</code>', although
1223 <h3><a class="anchor" id="colorize"></a>-colorize <var>value</var></h3>
1226 …-description">Colorize the image by an amount specified by <var>value</var> using the color specif…
1230 a comma-delimited list of colorization
1231 values (e.g., <code>-colorize 0,0,50</code>).</p>
1234 <h3><a class="anchor" id="colormap"></a>-colormap <var>type</var></h3>
1237 <p class="magick-description">Define the colormap type.</p>
1243 to <a href="command-line-options.html#visual">-visual</a> for more details. By default,
1252 <h3><a class="anchor" id="colors"></a>-colors <var>value</var></h3>
1255 <p class="magick-description">Set the preferred number of colors in the image.</p>
1268 <h3><a class="anchor" id="color-matrix"></a>-color-matrix <var>matrix</var></h3>
1271 <p class="magick-description">Apply color correction to the image.</p>
1274 and various other effects. Although variable-sized transformation matrices
1282 <pre class="highlight"><code>magick kittens.jpg -color-matrix \
1283 " 1.5 0.0 0.0 0.0, 0.0, -0.157 \
1284 0.0 1.5 0.0 0.0, 0.0, -0.157 \
1285 0.0 0.0 1.5 0.0, 0.0, -0.157 \
1291 <h3><a class="anchor" id="colorspace"></a>-colorspace <var>value</var></h3>
1294 <p class="magick-description">Set the image colorspace.</p>
1309 <p>To print a complete list of colorspaces, use <a href="command-line-options.html#list">-list colo…
1311 … RGB, CMYK, or grayscale colorspaces, use the <a href="command-line-options.html#profile">-profile…
1313 <div class="pre-scrollable highlight">
1314 <table class="table table-sm table-hover">
1332 …middle">B=distance along axis from bottom upward; B=max(R,G,B); <var>intensity-like</var></td></tr>
1334 …<tr><th valign="middle">HSL — Hue, Saturation, Lightness; like a double cone end-to-end with peaks…
1337 …ong axis from bottom upward; L=0.5*max(R,G,B) + 0.5*min(R,G,B); <var>intensity-like</var></td></tr>
1357 … <tr><td valign="middle">I1=0.33333*R+0.33334*G+0.33333*B; <var>intensity-like</var></td></tr>
1365 … <tr><td valign="middle">Y=0.2988390*R+0.5868110*G+0.1143500*B; <var>intensity-like</var></td></tr>
1366 …<tr><td valign="middle">Cb=(−0.168736*R-0.331264*G+0.500000*B)*(<var>QuantumRange</var>+1)/2</td><…
1373 … <tr><td valign="middle">Y=0.212656*R+0.715158*G+0.072186*B; <var>intensity-like</var></td></tr>
1377 …<tr><td valign="middle">if R ≤ .0.0031308 then Rs=R/12.92 else Rs=1.055 R ^ (1.0 / 2.4) - 0.055</t…
1378 …<tr><td valign="middle">if G ≤ .0.0031308 then Gs=B/12.92 else Gs=1.055 R ^ (1.0 / 2.4) - 0.055</t…
1379 …<tr><td valign="middle">if B ≤ .0.0031308 then Bs=B/12.92 else Bs=1.055 R ^ (1.0 / 2.4) - 0.055</t…
1387 …=(0.298839*R+0.586811*G+0.114350*B) (with complicated scaling); <var>intensity-like</var></td></tr>
1392 … <tr><td valign="middle">Y=0.2988390*R+0.5868110*G+0.1143500*B; <var>intensity-like</var></td></tr>
1397 … <tr><td valign="middle">Y=0.298839*R+0.586811*G+0.114350*B; <var>intensity-like</var></td></tr>
1402 … <tr><td valign="middle">Y=0.2988390*R+0.5868110*G+0.1143500*B; <var>intensity-like</var></td></tr>
1407 … <tr><td valign="middle">Y=0.298839*R+0.586811*G+0.114350*B; <var>intensity-like</var></td></tr>
1413 <p>Note the scRGB colorspace requires HDRI support otherwise it behaves just like linear RGB.</p>
1415 <p>Use the <code>Undefined</code> colorspace to identify multi-spectral images.</p>
1418 …<h3><a class="anchor" id="color-threshold"></a>-color-threshold <var>start-color</var>-<var>stop-c…
1424 <h3><a class="anchor" id="combine"></a>-combine</h3>
1428 <p class="magick-description">Combine one or more images into a single image.</p>
1430 <p>The channels (previously set by <a href="command-line-options.html#channel">-channel</a>) of the
1432 sequence, in order. For the default -channel setting of <code>RGB</code>, this
1437 href="command-line-options.html#separate">-separate</a>, so long as the channel settings are the sa…
1441 <pre class="highlight"><code>magick original.png -channel RGB -separate sepimage.png
1442 convert sepimage-0.png sepimage-1.png sepimage-2.png -channel RGB \
1443 -combine imagecopy.png
1447 <h3><a class="anchor" id="comment"></a>-comment <var>string</var></h3>
1450 <p class="magick-description">Embed a comment in an image.</p>
1452 <p>This option sets the comment meta-data of an image read in after this
1454 "<code><a href="command-line-options.html#set">-set</a> comment</code>". </p>
1465 <p>Comment meta-data are not visible on the image itself. To do that use the
1466 <a href="command-line-options.html#annotate">-annotate</a> or <a href="command-line-options.html#dr…
1471 <pre class="highlight"><code>-comment "%m:%f %wx%h" bird.miff
1479 <h3><a class="anchor" id="compare"></a>-compare</h3>
1482 <p class="magick-description">Mathematically and visually annotate the difference between an image …
1486 <pre class="highlight"><code>magick image.png reference.png -metric RMSE -compare \ <br/> differenc…
1491 <pre class="highlight"><code>magick image.png reference.png -metric RMSE -compare -format \
1496 <h3><a class="anchor" id="complex"></a>-complex <var>operator</var></h3>
1499 <p class="magick-description">Perform complex mathematics on an image sequence</p>
1506 magnitude-phase
1508 real-imaginary
1512 …e <code>divide</code> operator SNR with <code><a href="command-line-options.html#define">-define</…
1515 <h3><a class="anchor" id="compose"></a>-compose <var>operator</var></h3>
1518 <p class="magick-description">Set the type of image composition.</p>
1525 <a href="command-line-options.html#composite">-compare</a>,
1526 <a href="command-line-options.html#composite">-composite</a>,
1527 <a href="command-line-options.html#layers">-layers</a> composite,
1528 <a href="command-line-options.html#flatten">-flatten</a>,
1529 <a href="command-line-options.html#mosaic">-mosaic</a>,
1530 <a href="command-line-options.html#layers">-layers</a> merge,
1531 <a href="command-line-options.html#border">-border</a>,
1532 <a href="command-line-options.html#frame">-frame</a>,
1533 and <a href="command-line-options.html#extent">-extent</a>. </p>
1540 <h3><a class="anchor" id="composite"></a>-composite</h3>
1543 <p class="magick-description">Perform alpha composition on two images and an optional mask</p>
1546 according to the current <a href="command-line-options.html#compose">-compose</a> setting. The loca…
1548 href="command-line-options.html#gravity" >-gravity</a>, and <a href="command-line-options.html#geom…
1554 mask is used to provide a separate Y-displacement image instead. </p>
1556 <p>If a <a href="command-line-options.html#compose">-compose</a> method requires extra numerical
1558 href="command-line-options.html#set">-set</a> '<code>option:compose:args</code>'
1561 <p>Some <a href="command-line-options.html#compose">-compose</a> methods can modify the 'destinatio…
1562 …y default. You can enable this by setting the define: <a href="command-line-options.html#define">…
1564 …mit values outside this range with this option: <a href="command-line-options.html#set">-set</a> '…
1568 <h3><a class="anchor" id="compress"></a>-compress <var>type</var></h3>
1571 <p class="magick-description">Use pixel compression specified by <var>type</var> when writing the i…
1579 <p>To print a complete list of compression types, use <a href="command-line-options.html#list">-list
1582 <p>Specify <a href="command-line-options.html#compress">+compress</a> to store the binary image in …
1588 read by LZW decoders. This may result in larger-than-expected GIF files.</p>
1603 <p>Use the <a href="command-line-options.html#quality">-quality</a> option to set the compression l…
1605 Use the <a href="command-line-options.html#sampling-factor">-sampling-factor</a> option to set the
1606 sampling factor to be used by JPEG, MPEG, and YUV encoders for down-sampling
1610 …<h3><a class="anchor" id="connected-components"></a>-connected-components <var>connectivity</var><…
1613 <p class="magick-description"><a href="../www/connected-components.html">connected-components</a> l…
1615 <p>Use <code><a href="command-line-options.html#define" >-define</a> connected-components:verbose=t…
1618 <h3><a class="anchor" id="contrast"></a>-contrast</h3>
1621 <p class="magick-description">Enhance or reduce the image contrast.</p>
1624 darker elements of the image. Use <a href="command-line-options.html#contrast">-contrast</a> to enh…
1625 the image or <a href="command-line-options.html#contrast">+contrast</a> to reduce the image
1630 <pre class="highlight"><code>magick rose: -contrast -contrast rose_c2.png
1634 …anchor" id="contrast-stretch"></a>-contrast-stretch <var>black-point</var><br />-contrast-stretch …
1637 <p class="magick-description">Increase the contrast in an image by <var>stretching</var> the range …
1639 …tretch, black-out at most <var>black-point</var> pixels and white-out at most <var>white-point</va…
1640 <var >black-point %</var> pixels and white-out at most <var>white-point %</var> pixels.</p>
1642 <p>Prior to ImageMagick 6.4.7-0, <a href="command-line-options.html#contrast-stretch"
1643 >-contrast-stretch</a> will black-out at most <var>black-point</var> pixels and white-out at most <…
1644 …s white-point</var> pixels. Or, if percent is used, black-out at most <var>black-point %</var> pix…
1646 <p>Note that <code>-contrast-stretch 0</code> will modify the image such that
1647 …retched to 0 and <var>QuantumRange</var>, respectively, without any loss of data due to burn-out or
1648 clipping at either end. This is not the same as <a href="command-line-options.html#normalize"
1649 >-normalize</a>, which is equivalent to <code>-contrast-stretch 0.15x0.05%</code> (or
1650 prior to ImageMagick 6.4.7-0, <code>-contrast-stretch 2%x99%</code>).</p>
1657 preserve color integrity, when the default <a href="command-line-options.html#channel" >+channel</a>
1658 setting is in use. Specifying any other <a href="command-line-options.html#channel" >-channel</a>
1661 <p>See also <a href="command-line-options.html#auto-level" >-auto-level</a> for a 'perfect'
1664 <p>This operator is under review for re-development. </p>
1668 <h3><a class="anchor" id="convolve"></a>-convolve <var>kernel</var></h3>
1671 <p class="magick-description">Convolve an image with a user-supplied convolution kernel.</p>
1674 a comma-separated list of integers (with no spaces), ordered left-to right,
1675 starting with the top row. Presently, only odd-dimensioned kernels are
1679 …xt-nowrap" href="command-line-options.html#convolve">-convolve</a> operator supports the <a class=…
1680 positive and negative results are relative to a user-specified bias value.
1681 This is important for non-HDRI compilations of ImageMagick when dealing with
1687 …n using an ImageMagick with the HDRI compile-time setting, <a class="text-nowrap" href="command-li…
1689 See the discussion on HDRI implementations of ImageMagick on the page <a
1690 href="high-dynamic-range.html">High
1691 Dynamic-Range Images</a>. For more about HDRI go the ImageMagick <a
1692 href="https://legacy.imagemagick.org/Usage/basics/#hdri">Usage</a> pages or this
1698 <h3><a class="anchor" id="copy"></a>-copy <var>geometry</var> <var>offset</var></h3>
1701 <p class="magick-description">Copy pixels from one area of an image to another.</p>
1704 <h3><a class="anchor" id="crop"></a>-crop <var>geometry</var>{<var>@</var>}{<var>!</var>}</h3>
1707 <p class="magick-description">Cut out one or more rectangular regions of the image.</p>
1709 <p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details abou…
1715 amount to be removed, use <a href="command-line-options.html#shave">-shave</a> instead.</p>
1721 left corner of the image. If the <a href="command-line-options.html#gravity">-gravity</a> option is
1725 href="command-line-options.html#gravity">-gravity</a> option is present with <code>SouthWest</code>,
1746 <p>It might be necessary to <a href="command-line-options.html#repage" >+repage</a> the image prior…
1748 upper-left corner of the visible image.
1750 Similarly you may want to use <a href="command-line-options.html#repage" >+repage</a> after croppin…
1756 <h3><a class="anchor" id="cycle"></a>-cycle <var>amount</var></h3>
1759 <p class="magick-description">Displace image colormap by amount.</p>
1766 <h3><a class="anchor" id="debug"></a>-debug <var>events</var></h3>
1769 <p class="magick-description">Enable debug printout.</p>
1773 a comma-separated list consisting of one or more of the following domains:
1783 <pre class="highlight"><code>magick -debug "Cache,Blob" rose: rose.png
1789 <p>To print the complete list of debug methods, use <a href="command-line-options.html#list">-list
1792 <p>Use the <a href="command-line-options.html#log">-log</a> option to specify the format for debugg…
1795 <p>Use <a href="command-line-options.html#debug">+debug</a> to turn off all logging.</p>
1799 environment variable are the same as for the <a href="command-line-options.html#debug">-debug</a>
1804 <h3><a class="anchor" id="decipher"></a>-decipher <var>filename</var></h3>
1807 … class="magick-description">Decipher and restore pixels that were previously transformed by <a hre…
1816 <h3><a class="anchor" id="deconstruct"></a>-deconstruct</h3>
1819 <p class="magick-description">Find areas that has changed between images </p>
1822 href="command-line-options.html#coalesce">-coalesce</a>, replace the second and later images, with
1830 <p>This option is actually equivalent to the <a href="command-line-options.html#layers">-layers</a>
1831 method '<code>compare-any</code>'. </p>
1835 <h3><a class="anchor" id="define"></a>-define <var>key</var>{<var>=value</var>}<var>...</var></h3>
1838 <p class="magick-description">Add specific global settings generally used to control coders and ima…
1844 href="command-line-options.html#verbose" >-verbose</a> information ("<code>info:</code>" output for…
1847 <p>If <var>value</var> is missing for a definition, an empty-valued
1849 options. Use <a href="command-line-options.html#define">+define key</a> to remove definitions
1850 previously created. Use <a href="command-line-options.html#define">+define "*"</a> to remove all
1854 href="command-line-options.html#set" >-set "option:<var>key</var>" "<var>value</var>"</a> option, w…
1857 <p>The <var>option</var> and <var>key</var> are case-independent (they are
1859 is case-dependent.</p>
1865 <pre class="highlight"><code>magick bilevel.tif -define ps:imagemask eps3:stencil.ps
1872 <pre class="highlight"><code>-define registry:temporary-path=/data/tmp
1876 …<h3><a class="anchor" id="delay"></a>-delay <var>ticks</var> <br />-delay <var>ticks</var>x<var>ti…
1879 <p class="magick-description">Display the next image after pausing.</p>
1882 <var>ticks/ticks-per-second</var> seconds must expire before the display of the
1884 sequence. The default ticks-per-second is 100.</p>
1897 <h3><a class="anchor" id="delete"></a>-delete <var>indexes</var></h3>
1900 <p class="magick-description">Delete the images specified by index, from the image sequence.</p>
1903 0. Negative indexes are relative to the end of the sequence, for example, -1
1905 a dash (e.g. 0-4). Separate indexes with a comma (e.g. 0,2). Use
1906 <code>+delete</code> to delete the last image in the current image sequence. Use <code>-delete 0--1…
1910 …<h3><a class="anchor" id="density"></a>-density <var>width</var><br />-density <var>width</var>x<v…
1913 <p class="magick-description">Set the horizontal and vertical resolution of an image for rendering …
1920 href="command-line-options.html#units">-units</a> option may be used to select dots per centimeter
1937 <p>The <a href="command-line-options.html#density">-density</a> option sets an <var>attribute</var>…
1941 resolution, use the <a href="command-line-options.html#resample">-resample</a> option.</p>
1944 <h3><a class="anchor" id="depth"></a>-depth <var>value</var></h3>
1947 <p class="magick-description">Depth of the image.</p>
1953 <p>Use <a href="command-line-options.html#depth">+depth</a> to return depth to its default value.</…
1956 <h3><a class="anchor" id="descend"></a>-descend</h3>
1959 <p class="magick-description">Obtain image by descending window hierarchy.</p>
1962 <h3><a class="anchor" id="deskew"></a>-deskew <var>threshold{%}</var></h3>
1965 <p class="magick-description">Straighten an image. A threshold of 40% works for most images.</p>
1967 <p>Use <a href="command-line-options.html#set">-set</a> <code>option:deskew:auto-crop
1971 <h3><a class="anchor" id="despeckle"></a>-despeckle</h3>
1974 <p class="magick-description">Reduce the speckles within an image.</p>
1977 <h3><a class="anchor" id="direction"></a>-direction <var>type</var></h3>
1980 <p class="magick-description">Render text right-to-left or left-to-right. Requires the <a href="ht…
1983 …anchor" id="displace"></a>-displace <var>horizontal-scale</var>{%}{!}<br />-displace <var>horizont…
1986 <p class="magick-description">Shift image pixels as defined by a displacement map.</p>
2018 these flags were added as of IM v6.5.3-5.</p>
2032 <p>Alternatively rather than supplying two separate images, as of IM v6.4.4-0,
2037 <p>As of IM v6.5.3-5 any alpha channel in the overlay image is used as a
2043 <h3><a class="anchor" id="display"></a>-display <var>host:display[.screen]</var></h3>
2046 <p class="magick-description">Specifies the X server to contact.</p>
2052 <h3><a class="anchor" id="dispose"></a>-dispose <var>method</var></h3>
2055 <p class="magick-description">Define the GIF disposal image setting for images that are being creat…
2064 <div class="pre-scrollable highlight">
2066 <dt class="col-md-4">Undefined</dt><dd class="col-md-8">0: No disposal specified (equivalent to '<…
2067 <dt class="col-md-4">None</dt><dd class="col-md-8">1: Do not dispose, just overlay next frame imag…
2068 <dt class="col-md-4">Background</dt><dd class="col-md-8">2: Clear the frame area with the backgrou…
2069 <dt class="col-md-4">Previous</dt><dd class="col-md-8">3: Clear to the image prior to this frames …
2076 <p>To print a complete list of dispose methods, use <a href="command-line-options.html#list">-list …
2078 <p>Use <a href="command-line-options.html#dispose" >+dispose</a>, turn off the setting and prevent
2081 <p>Use <a href="command-line-options.html#set">-set</a> '<code>dispose</code>' method to set the im…
2085 …<h3><a class="anchor" id="dissimilarity-threshold"></a>-dissimilarity-threshold <var>value</var></…
2088 <p class="magick-description">Maximum RMSE for subimage match (default 0.2).</p>
2092 …<h3><a class="anchor" id="dissolve"></a>-dissolve <var>src_percent</var>[x<var>dst_percent</var>]<…
2095 <p class="magick-description">Dissolve an image into another by the given percent.</p>
2108 <h3><a class="anchor" id="distort"></a>-distort <var>method arguments</var></h3>
2111 <p class="magick-description">Distort an image, using the given <var>method</var> and its required …
2119 <div class="pre-scrollable highlight">
2120 <table class="table table-sm table-hover">
2134 background (IE 2-dimensional animations). <br/>
2140 <dt class="col-md-4">2:</dt><dd class="col-md-8"><var>Scale Angle</var></dd>
2141 <dt class="col-md-4">3:</dt><dd class="col-md-8"><var>X,Y Angle</var></dd>
2142 <dt class="col-md-4">4:</dt><dd class="col-md-8"><var>X,Y Scale Angle</var></dd>
2143 <dt class="col-md-4">5:</dt> <dd class="col-md-8"><var>X,Y ScaleX,ScaleY Angle</var></dd>
2144 … <dt class="col-md-4">6:</dt> <dd class="col-md-8"><var>X,Y Scale Angle NewX,NewY</var></dd>
2145 …<dt class="col-md-4">7:</dt> <dd class="col-md-8"><var>X,Y ScaleX,ScaleY Angle NewX,NewY</var>…
2167 be a floating point non-integer translation). <br/>
2177 …estricts the distortion to 4 arguments (S, R, Tx, Ty) with Sy = Sx and Ry = -Rx so that the distor…
2185 pre-calculated coefficients forming a set of Affine Equations to map
2188 <p class="text-center"><var>
2194 See <a href="command-line-options.html#affine" >-affine</a> setting for more detail, and
2201 … href="command-line-options.html#verbose" >-verbose</a> setting with those other variants. </td>
2220 … which will be colored using the <a href="command-line-options.html#mattecolor" >-mattecolor</a>
2243 is anti-aliased, and the 'sky' color may be set using the
2244 <a href="command-line-options.html#mattecolor" >-mattecolor</a> setting. </td>
2251 pre-calculated coefficients. You can get these coefficients by looking
2252 at the <a href="command-line-options.html#verbose" >-verbose</a> output of a
2263 control points needed. Order 1 is the same as -distort Affine. Order 1.5 is the
2264 same as -distort BilinearReverse. Typical use is for a 2nd order distortion.
2275 <dt class="col-md-4">arc_angle</dt>
2276 <dd class="col-md-8">The angle over which to arc the image side-to-side</dd>
2277 <dt class="col-md-4">rotate_angle</dt>
2278 <dd class="col-md-8">Angle to rotate resulting image from vertical center</dd>
2279 <dt class="col-md-4">top_radius</dt>
2280 <dd class="col-md-8">Set top edge of source image at this radius</dd>
2281 <dt class="col-md-4">bottom_radius </dt>
2282 <dd class="col-md-8">Set bottom edge to this radius (radial scaling)</dd>
2286 (as if using <a href="command-line-options.html#distort" >+distort</a>) while attempting to
2307 center to the center of the image, and the angles going from -180 (top)
2312 '-1' will use the distance from the center to the furthest
2317 … If the plus form of distort (<a href="command-line-options.html#distort" >+distort</a>) is used
2332 <var>Rmax</var> setting of '-1' (maximum center to corner
2335 reverse the distortion re-producing the original.
2340 form of 'super-sampling' image processing technique be used to produce
2350 Dersch</a>, perform a barrel or pin-cushion distortion appropriate to
2354 <p class="text-center">Arguments: <var>A B C</var> [ <var>D</var> [
2360 <p class="text-center">Rsrc = r * ( <var>A</var>*r<sup>3</sup> + <var>B</var>*r<sup>2</sup> +
2378 <p class="text-center">Rsrc = r / ( <var>A</var>*r<sup>3</sup> + <var>B</var>*r<sup>2</sup> +
2381 distortion, just a different barrel-like radial distortion method.
2404 … href="command-line-options.html#displace" >-displace</a>) for source image color look-up using
2405 … the <a href="command-line-options.html#sparse-color" >-sparse-color</a> method of the same name.
2413 <p>To print a complete list of distortion methods, use <a href="command-line-options.html#list">-li…
2422 <p class="text-center"><var>
2434 perspective distortion of the built-in "rose:" image. Note how spaces were
2438 <pre class="highlight"><code>magick rose: -virtual-pixel black \
2439 -distort Perspective '0,0,0,0 0,45,0,45 69,0,60,10 69,45,60,35' \
2456 resampling <a href="command-line-options.html#filter" >-filter</a>, using a special technique known…
2462 <pre class="highlight"><code>magick -size 90x90 pattern:checkerboard -normalize -virtual-pixel tile…
2463 -distort perspective '0,0,5,45 89,0,45,46 0,89,0,89 89,89,89,89' \
2470 resampling, by specifying the special <a href="command-line-options.html#filter" >-filter</a> setti…
2471 '<code>point</code>' (recommended if you plan to use super-sampling instead).
2475 example, <a href="command-line-options.html#distort" >-distort</a> will use the current <a
2476 href="command-line-options.html#mattecolor" >-mattecolor</a> setting for these pixels. If you do not
2483 the plus form of the operator (<a href="command-line-options.html#distort" >+distort</a>) the opera…
2486 may need to be removed using <a href="command-line-options.html#repage" >+repage</a>, to remove if …
2489 <p>Setting <a href="command-line-options.html#verbose" >-verbose</a> setting, will cause <a
2490 href="command-line-options.html#distort" >-distort</a> to attempt to output the internal coefficien…
2491 and the <a href="command-line-options.html#fx" >-fx</a> equivalent to the distortion, for expert st…
2494 <p>You can alternatively specify a special "<code><a href="command-line-options.html#define"
2495 >-define</a> distort:viewport={geometry_string}</code>" setting which will
2499 <p>Setting a "<code><a href="command-line-options.html#define" >-define</a>
2502 distorted image. This can be used either for 'super-sampling' the image for
2504 appropriate viewport changes, or post-distort cropping and resizing). </p>
2506 <p>Setting "<code><a href="command-line-options.html#define" >-define</a> resample:verbose=1</code>"
2513 <h3><a class="anchor" id="distribute-cache"></a>-distribute-cache <var>port</var></h3>
2516 <p class="magick-description">Launch a distributed pixel cache server. </p>
2519 <h3><a class="anchor" id="dither"></a>-dither <var>method</var></h3>
2522 <p class="magick-description">Apply a Riemersma or Floyd-Steinberg error diffusion dither to
2533 setting, <a href="command-line-options.html#dither">+dither</a>. This will also render PostScript
2539 <p>The color reduction operators <a href="command-line-options.html#colors">-colors</a>, <a
2540 href="command-line-options.html#monochrome">-monochrome</a>, <a href="command-line-options.html#rem…
2541 href="command-line-options.html#posterize">-posterize</a>, apply dithering to images using the redu…
2547 <p>Alternatively you can use <a href="command-line-options.html#random-threshold">-random-threshold…
2549 href="command-line-options.html#ordered-dither">-ordered-dither</a> to apply threshold mapped dither
2551 …<a href="command-line-options.html#define" >-define</a> dither:diffusion-amount=35%</code>, for ex…
2555 <h3><a class="anchor" id="draw"></a>-draw <var>string</var></h3>
2558 <p class="magick-description">Annotate an image with one or more graphic primitives.</p>
2566 <div class="pre-scrollable highlight">
2568 <dt class="col-md-4">point</dt><dd class="col-md-8"> x,y</dd>
2569 <dt class="col-md-4">line</dt><dd class="col-md-8"> x0,y0 x1,y1</dd>
2570 <dt class="col-md-4">rectangle</dt><dd class="col-md-8"> x0,y0 x1,y1</dd>
2571 <dt class="col-md-4">roundRectangle</dt><dd class="col-md-8"> x0,y0 x1,y1 wc,hc</dd>
2572 <dt class="col-md-4">arc</dt><dd class="col-md-8"> x0,y0 x1,y1 a0,a1</dd>
2573 <dt class="col-md-4">ellipse</dt><dd class="col-md-8"> x0,y0 rx,ry a0,a1</dd>
2574 <dt class="col-md-4">circle</dt><dd class="col-md-8"> x0,y0 x1,y1</dd>
2575 <dt class="col-md-4">polyline</dt><dd class="col-md-8"> x0,y0 ... xn,yn</dd>
2576 <dt class="col-md-4">polygon</dt><dd class="col-md-8"> x0,y0 ... xn,yn</dd>
2577 <dt class="col-md-4">bezier</dt><dd class="col-md-8"> x0,y0 ... xn,yn</dd>
2578 <dt class="col-md-4">path</dt><dd class="col-md-8">specification </dd>
2579 <dt class="col-md-4">image</dt><dd class="col-md-8"> operator x0,y0 w,h filename</dd>
2586 <dt class="col-md-4">text</dt><dd class="col-md-8">x0,y0 string</dd>
2591 <dt class="col-md-4">gravity</dt><dd class="col-md-8">NorthWest, North, NorthEast, West, Center, Ea…
2596 href="command-line-options.html#gravity">-gravity</a> command-line option, except that it is limite…
2597 scope to the <a href="command-line-options.html#draw">-draw</a> option in which it appears.</p>
2601 <div class="pre-scrollable highlight">
2603 <dt class="col-md-4">rotate</dt><dd class="col-md-8">degrees</dd>
2604 <dt class="col-md-4">translate</dt><dd class="col-md-8">dx,dy</dd>
2605 <dt class="col-md-4">scale</dt><dd class="col-md-8">sx,sy</dd>
2606 <dt class="col-md-4">skewX</dt><dd class="col-md-8">degrees</dd>
2607 <dt class="col-md-4">skewY</dt><dd class="col-md-8">degrees</dd>
2613 <div class="pre-scrollable highlight">
2615 <dt class="col-md-4">color</dt><dd class="col-md-8">x0,y0 method</dd>
2616 <dt class="col-md-4">matte</dt><dd class="col-md-8">x0,y0 method</dd>
2621 href="command-line-options.html#fill">-fill</a> setting. For unfilled shapes, use <a
2622 href="command-line-options.html#fill">-fill none</a>. You can optionally control the stroke (the
2623 "outline" of a shape) with the <a href="command-line-options.html#stroke">-stroke</a> and <a
2624 href="command-line-options.html#strokewidth">-strokewidth</a> settings.</p>
2629 primitive is not affected by <a href="command-line-options.html#stroke">-stroke</a> or <a
2630 href="command-line-options.html#strokewidth">-strokewidth</a>.)</p>
2652 center point, the horizontal and vertical "radii" (the <var>semi-axes</var> of
2660 href="command-line-options.html#stroke">-stroke</a> setting is <code>none</code> (the default), then
2669 <pre class="highlight"><code>-draw 'circle 100,100 150,150'
2683 <code>path</code> primitive or to draw multiple four-point bezier segments with
2686 <pre class="highlight"><code>-draw 'bezier 20,50 45,100 45,0 70,50'
2687 -draw 'bezier 70,50 95,100 95,0 120,50'
2703 <pre class="highlight"><code>-draw 'image SrcOver 100,100 225,225 image.jpg'
2712 arguments cannot be used at present with the <code>-draw image</code> option.
2722 <pre class="highlight"><code>-draw "text 100,100 'Works like magick!'"</code></pre>
2724 <p>See the <a href="command-line-options.html#annotate">-annotate</a> option for another convenient…
2730 <pre class="highlight"><code>-draw "rotate 45 text 10,10 'Works like magick!'"</code></pre>
2741 from the initial affine matrix defined by the <a href="command-line-options.html#affine">-affine</a>
2742 option. Transformations are cumulative within the <a href="command-line-options.html#draw">-draw</a>
2744 by the appearance of another <a href="command-line-options.html#affine">-affine</a> option. If anot…
2745 <a href="command-line-options.html#draw">-draw</a> option appears, the current affine matrix is
2749 fill color (see <a href="command-line-options.html#fill">-fill</a>). Follow the pixel coordinate wi…
2775 href="command-line-options.html#bordercolor">-bordercolor</a>). Finally <code>reset</code> changes …
2779 …f="command-line-options.html#fill">-fill</a>, <a href="command-line-options.html#font">-font</a>, …
2781 these options <var>before</var> the <a href="command-line-options.html#draw">-draw</a> option.</p>
2786 <p>Drawing primitives conform to the <a href="magick-vector-graphics.html" >Magick
2792 <h3><a class="anchor" id="duplicate"></a>-duplicate <var>count,indexes</var></h3>
2795 <p class="magick-description">Duplicate an image one or more times.</p>
2799 sequence, for example, -1 represents the last image of the sequence. Specify
2800 a range of images with a dash (e.g. 0-4). Separate indexes with a comma (e.g.
2805 <h3><a class="anchor" id="edge"></a>-edge <var>radius</var></h3>
2808 <p class="magick-description">Detect edges within an image.</p>
2811 <h3><a class="anchor" id="emboss"></a>-emboss <var>radius</var></h3>
2814 <p class="magick-description">Emboss an image.</p>
2817 <h3><a class="anchor" id="encipher"></a>-encipher <var>filename</var></h3>
2820 <p class="magick-description">Encipher pixels for later deciphering by <a href="command-line-option…
2830 <h3><a class="anchor" id="encoding"></a>-encoding <var>type</var></h3>
2833 <p class="magick-description">Specify the text encoding.</p>
2846 <h3><a class="anchor" id="endian"></a>-endian <var>type</var></h3>
2849 <p class="magick-description">Specify endianness (<code>MSB</code> or <code>LSB</code>) of the imag…
2851 <p>To print a complete list of endian types, use the <a href="command-line-options.html#list">-list…
2853 <p>Use <a href="command-line-options.html#endian">+endian</a> to revert to unspecified endianness.<…
2857 <h3><a class="anchor" id="enhance"></a>-enhance</h3>
2860 <p class="magick-description">Apply a digital filter to enhance a noisy image.</p>
2864 <h3><a class="anchor" id="equalize"></a>-equalize</h3>
2867 <p class="magick-description">Perform histogram equalization on the image channel-by-channel.</p>
2871 equalize the appropriate intensity-like channel, then convert back to RGB.</p>
2873 <p>For example using HSL, we have: ... <code>-colorspace HSL -channel lightness
2874 -equalize -colorspace sRGB</code> ...</p>
2878 channel. Here we have ... <code>-colorspace OHTA -channel red -equalize
2879 -colorspace sRGB</code> ...</p>
2882 <h3><a class="anchor" id="evaluate"></a>-evaluate <var>operator value</var></h3>
2885 <p class="magick-description">Alter channel pixels by evaluating an arithmetic, relational, or logi…
2887 <p>(See the <a href="command-line-options.html#function" >-function</a> operator for some
2888 multi-parameter functions. See the <a href="command-line-options.html#fx" >-fx</a> operator if more
2895 (installation-dependent) value <var>QuantumRange</var>. (If
2899 <div class="pre-scrollable highlight">
2900 <table class="table table-sm table-hover">
2917 <tr><td>Exp </td> <td>base-e exponential function</td></tr>
2918 <tr><td>Exponential </td> <td>base-e exponential function</td></tr>
2939 <tr><td>Gaussian-noise</td><td> </td></tr>
2940 <tr><td>Impulse-noise</td><td> </td></tr>
2941 <tr><td>Laplacian-noise</td><td> </td></tr>
2942 …<tr><td>Multiplicative-noise</td> <td>(These are equivalent to the corresponding <a href="com…
2944 <tr><td>Uniform-noise</td><td> </td></tr>
2956 href="command-line-options.html#channel" >-channel</a> in the image. If necessary, the results of t…
2960 semi-transparent. Append the percent symbol '<code>%</code>' to specify a value
2963 <p>To print a complete list of <a href="command-line-options.html#evaluate">-evaluate</a> operators…
2964 <a href="command-line-options.html#list">-list evaluate</a>.</p>
2968 href="command-line-options.html#level" >-level</a> or the <a href="command-line-options.html#level"…
2970 Please note, however, that <a href="command-line-options.html#level" >-level</a> treats transparenc…
2971 'matte' values (0 = opaque), while <a href="command-line-options.html#level" >-evaluate</a> works w…
2974 <p><code>AddModulus</code> has been added as of ImageMagick 6.4.8-4 and provides
2979 <p><code>Exp or Exponential</code> has been added as of ImageMagick 6.6.5-1 and
2982 function. Non-negative values will always produce results larger unity and
2986 <p class="text-center">
2990 <p> If the input image is squared, for example, using <a href="command-line-options.html#-function"
2991 >-function polynomial "2 0 0"</a>, then a decaying Gaussian function will be
2994 <p><code>Log</code> has been added as of ImageMagick 6.4.2-1 and works on
2999 <p class="text-center">
3003 <p><code>Pow</code> has been added as of ImageMagick 6.4.1-9, and works on
3005 href="command-line-options.html#gamma" >-gamma</a> operator. For example, <b>-gamma 2</b> is equiva…
3006 to <b>-evaluate pow 0.5</b>, i.e., a 'square root' function. The value used
3007 with <a href="command-line-options.html#gamma" >-gamma</a> is simply the reciprocal of the value us…
3010 <p><code>Cosine</code> and <code>Sine</code> was added as of IM v6.4.8-8 and
3019 <p class="text-center">
3023 <p>See also the <a href="command-line-options.html#function" >-function</a> operator, which is a
3024 multi-value version of evaluate. </p>
3027 <h3><a class="anchor" id="evaluate-sequence"></a>-evaluate-sequence <var>operator</var></h3>
3030 …-description">Alter channel pixels by evaluating an arithmetic, relational, or logical expression …
3033 href="command-line-options.html#evaluate-sequence">-evaluate-sequence</a> operators, use <a
3034 href="command-line-options.html#list">-list evaluate</a>.</p>
3037 <h3><a class="anchor" id="extent"></a>-extent <var>geometry</var></h3>
3040 <p class="magick-description">Set the image size and offset.</p>
3044 specification or precede with a <a href="command-line-options.html#gravity">-gravity</a> setting. …
3045 specify how to compose the image with the background, use <a href="command-line-options.html#compos…
3046 >-compose</a>.</p>
3052 <pre class="highlight"><code>magick input.jpg -resize 800x600 -background black -compose Copy \
3053 -gravity center -extent 800x600 -quality 92 output.jpg
3056 <p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details abou…
3059 <h3><a class="anchor" id="extract"></a>-extract <var>geometry</var></h3>
3062 <p class="magick-description">Extract the specified area from image.</p>
3067 <pre class="highlight"><code>magick -size 16000x16000 -depth 8 -extract 640x480+1280+960 \
3069 convert -size 16000x16000 -depth 8 'image.rgb[640x480+1280+960]' \
3075 <pre class="highlight"><code>magick -size 16000x16000 -depth 8 -extract 640x480 \
3082 <pre class="highlight"><code>magick -size 16000x16000 -depth 8 -resize 640x480 image.rgb image.png
3085 <p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details abou…
3088 <h3><a class="anchor" id="family"></a>-family <var>fontFamily</var></h3>
3091 <p class="magick-description">Set a font family for text.</p>
3096 "Courier" might be used if "System" is requested but not found). Note, the family can be a CSS-styl…
3099 <a href="../www/command-line-options.html#font">-font</a>,
3100 <a href="../www/command-line-options.html#pointsize">-pointsize</a>,
3101 <a href="../www/command-line-options.html#stretch">-stretch</a>,
3102 <a href="../www/command-line-options.html#style">-style</a>,
3103 and <a href="../www/command-line-options.html#weight">-weight</a>. </p>
3106 <h3><a class="anchor" id="features"></a>-features <var>distance</var></h3>
3109 <p class="magick-description">Display (co-occurrence matrix) texture measure features for each chan…
3121 <h3><a class="anchor" id="fft"></a>-fft</h3>
3124 <p class="magick-description">Implements the forward discrete Fourier transform (DFT).</p>
3126 <p>This option is new as of ImageMagick 6.5.4-3 (and now working for Windows
3127 users in ImageMagick 6.6.0-9). It transforms an image from the normal
3139 output result will have two components. It is either a two-frame image or two
3141 multi-frame images. The reason that we get a dual output result is because the
3144 into a two-component image representation. The first component is the
3152 formats, except PNG support multi-frame images. So for example,</p>
3154 <pre class="highlight"><code>magick image.png -fft fft_image.miff
3160 <pre class="highlight"><code>magick image.png -fft fft_image.png
3163 <p>generates a magnitude image as <code>fft_image-0.png</code> and a phase image
3164 as <code>fft_image-1.png</code>. If you prefer this representation, then you can
3166 href="command-line-options.html#adjoin">+adjoin</a> following -fft in the command line.</p>
3168 <p>The input image can be any size, but if not square and even-dimensioned, it
3173 href="command-line-options.html#virtual-pixel">-virtual-pixel</a> setting.</p>
3176 [0, <var>QuantumRange</var>], so that HDRI need not be enabled.
3178 dynamic range. (The first few releases had non-HDRI scaled but HDRI not
3186 <pre class="highlight"><code>magick fft_image.miff[0] -contrast-stretch 0 \
3187 -evaluate log 1000 fft_image_spectrum.png"
3190 <p>where either <a href="command-line-options.html#contrast-stretch">-contrast-stretch</a> 0 or <a
3191 href="command-line-options.html#auto-level">-auto-level</a> is used to scale the image to full dyna…
3192 range, first. The argument to the <a href="command-line-options.html#evaluate">-evaluate</a> log
3198 use <a href="command-line-options.html#fft">-fft</a>.</p>
3200 <p>Use <a href="command-line-options.html#fft">+fft</a> to produce two output images that are the r…
3204 this requires that IM be configured with HDRI enabled. In this case, you must
3208 MIFF or TIF, one should add <code>-define quantum:format=32</code>, to allow those image
3209 types to work properly in HDRI mode without clipping.</p>
3212 href="command-line-options.html#fft">+fft</a> are also square, even dimensioned images due to the s…
3216 <p>See the discussion on HDRI implementations of ImageMagick on the page <a
3217 href="high-dynamic-range.html" >High Dynamic-Range Images</a>. For more
3218 about HDRI go the ImageMagick <a
3219 href="https://legacy.imagemagick.org/Usage/basics/#hdri" >Usage</a> pages, <a
3225 …s normalized (and the IFT is not). Use "<code><a href="command-line-options.html#define" >-define<…
3229 <h3><a class="anchor" id="fill"></a>-fill <var>color</var></h3>
3232 <p class="magick-description">Color to use when filling a graphic primitive.</p>
3243 <pre class="highlight"><code>-fill blue
3244 -fill "#ddddff"
3245 -fill "rgb(255,255,255)"
3248 <p>See <a href="command-line-options.html#draw">-draw</a> for further details.</p>
3250 <p>To print a complete list of color names, use the <a href="command-line-options.html#list">-list …
3253 <h3><a class="anchor" id="filter"></a>-filter <var>type</var></h3>
3256 <p class="magick-description">Use this <var>type</var> of filter when resizing or distorting an ima…
3259 operations such as <a href="command-line-options.html#resize">-resize</a> and <a href="command-line…
3260 >-distort</a>. For example you can use a simple resize filter such as:</p>
3268 <p>Use <code>-define filter:lobes={2,3,4}</code> to specify the support size for filtering for the …
3277 function that the <a href="command-line-options.html#filter" >-filter</a> setting defines. That is
3286 <p>Also one special self-windowing filter is also provided
3287 <code>Lagrange</code>, which will automagically re-adjust its function depending
3295 <p>To print a complete list of resize filters, use the <a href="command-line-options.html#list">-li…
3299 use of these expert settings (see also <a href="command-line-options.html#define" >-define</a> and …
3300 href="command-line-options.html#set" >-set</a>):-</p>
3302 <div class="pre-scrollable highlight">
3303 <table class="table table-sm table-hover">
3305 <td>-define filter:blur=<var>factor</var></td>
3308 Gaussian-like filters simple filters, or you may not get the expected
3313 <td>-define filter:support=<var>radius</var></td>
3324 <td>-define filter:lobes=<var>count</var></td>
3332 <td>-define filter:sigma=<var>value</var></td>
3342 <td>-define filter:b=<var>b-spline_factor</var></td>
3346 <td>-define filter:c=<var>keys_alpha_factor</var></td>
3350 are defined, the other is set so as to generate a 'Cubic-Keys' filter.
3352 Mitchell-Netravali.</td>
3356 <td>-define filter:kaiser-beta=<var>value</var></td>
3360 Before ImageMagick v6.7.6-10, this option was known as "filter:alpha", (an
3367 <td>-define filter:kaiser-alpha=<var>value</var></td>
3368 <td>This value when multiplied by 'PI' is equivalent to "kaiser-beta", and
3374 <td>-define filter:filter=<var>filter_function</var></td>
3384 <td>-define filter:window=<var>filter_function</var></td>
3395 <td>-define filter:win-support=<var>radius</var></td>
3397 (or self-windowing Lagrange filter) to act is if the support window is
3404 <td>-define filter:verbose=<var>1</var></td>
3420 -filter sinc \
3421 -set filter:window=jinc \
3422 -set filter:lobes=8 \
3423 -resize 150% image.jpg"
3426 <p>Or a raw un-windowed Sinc filter with 4 lobes:</p>
3429 -set filter:filter=sinc \
3430 -set filter:lobes=4 \
3431 -resize 150% image.jpg"
3438 <pre class="highlight"><code>magick null: -define filter:filter=Box \
3439 -define filter:window=Welch \
3440 -define filter:support=1.0 \
3441 -define filter:verbose=1 \
3442 -resize 2 null: > window_welch.dat
3456 <h3><a class="anchor" id="flatten"></a>-flatten</h3>
3459 <p class="magick-description">This is a simple alias for the <a href="command-line-options.html#lay…
3463 <h3><a class="anchor" id="flip"></a>-flip</h3>
3466 <p class="magick-description">Create a <var>mirror image</var></p>
3469 upside-down. </p>
3473 …<h3><a class="anchor" id="floodfill"></a>-floodfill {<var>+-</var>}<var>x</var>{<var>+-</var>}<var…
3476 <p class="magick-description">Floodfill the image with color at the specified offset.</p>
3479 Any color that matches within <a href="command-line-options.html#fuzz" >-fuzz</a> color distance of…
3481 will be replaced with the current <a href="command-line-options.html#fill" >-fill</a> color. </p>
3484 <var>color</var> (according to <a href="command-line-options.html#fuzz" >-fuzz</a>), then no
3487 <p>This operator works more like the <a href="command-line-options.html#opaque" >-opaque</a> option…
3489 point'. For this form of flood fill, look at <a href="command-line-options.html#draw" >-draw</a> a…
3494 <h3><a class="anchor" id="flop"></a>-flop</h3>
3497 <p class="magick-description">Create a <var>mirror image</var>.</p>
3504 <h3><a class="anchor" id="font"></a>-font <var>name</var></h3>
3507 <p class="magick-description">Set the font to use when annotating images with text, or creating lab…
3509 <p>To print a complete list of fonts, use the <a href="command-line-options.html#list">-list font</…
3512 <p>In addition to the fonts specified by the above pre-defined list, you can
3518 href="command-line-options.html#family">-family</a>, <a href="command-line-options.html#stretch">-s…
3519 href="command-line-options.html#style">-style</a>, and <a href="command-line-options.html#weight">-…
3523 <h3><a class="anchor" id="foreground"></a>-foreground <var>color</var></h3>
3526 <p class="magick-description">Define the foreground color for menus.", "display</p>
3529 href="command-line-options.html#fill">-fill</a> option.</p>
3534 <h3><a class="anchor" id="format"></a>-format <var>type</var></h3>
3537 <p class="magick-description">The image format type.</p>
3542 href="command-line-options.html#list">-list format</a>.</p>
3546 the image format type specified with <a href="command-line-options.html#format">-format</a>. For
3552 <h3><a class="anchor" id="format_identify_"></a>-format <var>string</var></h3>
3555 <p class="magick-description">Output formatted image characteristics.</p>
3562 <h3><a class="anchor" id="frame"></a>-frame <var>geometry</var></h3>
3565 <p class="magick-description">Surround the image with a border or beveled frame.</p>
3567 <p>The color of the border is specified with the <a href="command-line-options.html#mattecolor"
3568 >-mattecolor</a> command line option. </p>
3570 <p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details abou…
3579 <p>The <a href="command-line-options.html#frame">-frame</a> option is affected by the current <a
3580 href="command-line-options.html#compose">-compose</a> setting and assumes that this is using the de…
3582 size with the current <a href="command-line-options.html#bordercolor">-bordercolor</a> setting, and…
3584 href="command-line-options.html#mattecolor">-mattecolor</a>. The original image is then overlaid o…
3587 href="command-line-options.html#bordercolor">-bordercolor</a> setting.</p>
3590 affected by the <a href="command-line-options.html#gravity">-gravity</a> option.</p>
3594 <h3><a class="anchor" id="frame_import_"></a>-frame</h3>
3597 <p class="magick-description">Include the X window frame in the imported image. </p>
3599 <h3><a class="anchor" id="function"></a>-function <var>function</var> <var>parameters</var></h3>
3602 <p class="magick-description">Apply a function to channel values.</p>
3606 href="command-line-options.html#channel">-channel</a> in the image. See <a
3607 href="command-line-options.html#evaluate">-evaluate</a> for details concerning how the results of t…
3610 <p>This is can be considered a multi-argument version of the <a
3611 href="command-line-options.html#evaluate">-evaluate</a> operator. (Added in
3614 <p>Here, <var>parameters</var> is a comma-separated list of
3623 <p>To print a complete list of <a href="command-line-options.html#function">-function</a> operators,
3624 use <a href="command-line-options.html#list">-list function</a>. Descriptions follow.</p>
3626 <div class="pre-scrollable highlight">
3628 <dt class="col-md-4">Polynomial</dt>
3629 …<dd class="col-md-8"><p>The <code>Polynomial</code> function takes an arbitrary number of paramete…
3633 <pre class="highlight"><code>-function Polynomial <var>a</var><sub><var>n</var></sub>,<var>a</var><…
3638 …up><var>n</var></sup> + <var>a</var><sub><var>n</var>-1</sub> <b><var>u</var></b><sup><var>n</var>…
3646 polynomials) of the <a href="command-line-options.html#evaluate">-evaluate</a> operator. The <a
3647 href="command-line-options.html#level">-level</a> operator also affects channels linearly. Some
3650 <div class="pre-scrollable highlight">
3651 <table class="table table-sm table-hover">
3653 <td>-evaluate Set <var>value</var> </td>
3654 <td>-function Polynomial <var>value</var></td>
3658 <td>-evaluate Add <var>value</var> </td>
3659 <td>-function Polynomial 1,<var>value</var></td>
3662 <td>-evaluate Subtract <var>value</var> </td>
3663 <td>-function Polynomial 1,−<var>value</var></td>
3666 <td>-evaluate Multiply <var>value</var> </td>
3667 <td>-function Polynomial <var>value</var>,0</td>
3671 <td>-function Polynomial A,B</td>
3672 <td>(Reduce contrast. Here, A=(white-black)/100 and B=black/100.)</td>
3682 <dt class="col-md-4">Sinusoid</dt>
3683 <dd class="col-md-8">
3688 <pre class="highlight"><code>-function <code>Sinusoid</code> <var>freq</var>,[<var>phase</var>,[<va…
3703 <pre class="highlight"><code>-function Sinusoid 3,-90,.2,.7
3710 <code>Cos</code> of the <a href="command-line-options.html#evaluate">-evaluate</a> operator by allo…
3713 <div class="pre-scrollable highlight">
3714 <table class="table table-sm table-hover">
3716 <td>-evaluate Sin <var>freq</var> </td>
3717 <td>-function Sinusoid <var>freq</var>,0 </td>
3720 <td>-evaluate Cos <var>freq</var> </td>
3721 <td>-function Sinusoid <var>freq</var>,90 </td>
3726 <dt class="col-md-4">ArcSin</dt>
3727 <dd class="col-md-8">
3733 <pre class="highlight"><code>-function <code>ArcSin</code> <var>width</var>,[<var>center</var>,[<va…
3740 …<code><var>range</var>/π * asin( 2/<var>width</var> * ( <b><var>u</var></b> - <var>center</var> ) …
3744 <dt class="col-md-4">ArcTan</dt>
3745 <dd class="col-md-8">
3750 <pre class="highlight"><code>-function <code>ArcTan</code> <var>slope</var>,[<var>center</var>,[<va…
3756 …<code><var>range</var>/π * atan( <var>slope</var>*π * ( <b><var>u</var></b> - <var>center</var> ) …
3765 <h3><a class="anchor" id="fuzz"></a>-fuzz <var>distance</var>{<var>%</var>}</h3>
3768 <p class="magick-description">Colors within this <var>distance</var> are considered equal.</p>
3773 image with <a href="command-line-options.html#trim">-trim</a> but the image was scanned and the tar…
3781 <p>Use <a href="command-line-options.html#fuzz" >+fuzz</a> to reset the fuzz value to 0.</p>
3785 <h3><a class="anchor" id="fx"></a>-fx <var>expression</var></h3>
3788 <p class="magick-description">Apply a mathematical expression to an image or image channels.</p>
3800 <h3><a class="anchor" id="gamma"></a>-gamma <var>value</var></h3>
3803 <p class="magick-description">Level of gamma correction.</p>
3813 <p>Gamma adjusts the image's channel values pixel-by-pixel according to
3818 <p>Use <a href="command-line-options.html#gamma">+gamma <var>value</var></a> to set the
3830 …t gamma adjustments are also available via the <a href="command-line-options.html#level">-level</a…
3833 …<h3><a class="anchor" id="gaussian-blur"></a>-gaussian-blur <var>radius</var><br />-gaussian-blur …
3836 <p class="magick-description">Blur the image with a Gaussian operator.</p>
3841 <p class="text-center"><img class="img-thumbnail" alt="gaussian distribution" width="243px" height=…
3858 <p>This differs from the faster <a href="command-line-options.html#blur">-blur</a> operator in that…
3859 full 2-dimensional convolution is used to generate the weighted average of the
3862 <p>The <a href="command-line-options.html#virtual-pixel">-virtual-pixel</a> setting will determine …
3868 <h3><a class="anchor" id="geometry"></a>-geometry <var>geometry</var></h3>
3871 <p class="magick-description">Set the preferred size and location of the image.</p>
3873 <p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details abou…
3876 <h3><a class="anchor" id="gravity"></a>-gravity <var>type</var></h3>
3879 <p class="magick-description">Sets the current gravity suggestion for various other settings and op…
3884 href="command-line-options.html#list">-list gravity</a> to get a complete list of <a
3885 href="command-line-options.html#gravity">-gravity</a> settings available in your ImageMagick
3891 href="command-line-options.html#draw">-draw</a> for more details about graphic primitives. Only the
3892 text primitive of <a href="command-line-options.html#draw">-draw</a> is affected by the <a
3893 href="command-line-options.html#gravity">-gravity</a> option.</p>
3895 <p>The <a href="command-line-options.html#gravity">-gravity</a> option is also used in concert with…
3896 <a href="command-line-options.html#geometry">-geometry</a> setting and other settings or options th…
3898 href="command-line-options.html#crop">-crop</a> option. </p>
3900 <p>If a <a href="command-line-options.html#gravity">-gravity</a> setting occurs before another opti…
3903 by the <a href="command-line-options.html#gravity">-gravity</a> argument. Thus, in the following
3905 200x100. The offset specified by the argument to <a href="command-line-options.html#region">-region…
3906 is (−40,+20). The argument to <a href="command-line-options.html#gravity">-gravity</a> is
3910 that point. (In addition, the <a href="command-line-options.html#gravity">-gravity</a> affects the
3912 coordinate (60,70). (See <a href="command-line-processing.html#geometry">Image Geometry</a> for com…
3914 <pre class="highlight"><code>magick image.png -gravity Center -region 10x10-40+20 \
3915 -negate output.png
3919 href="command-line-options.html#gravity">-gravity</a> gives the direction that the image gravitates
3923 href="command-line-options.html#gravity">-gravity</a> gives the direction that an image gravitates
3926 <p>Use <a href="command-line-options.html#gravity">+gravity</a> to return gravity to its default va…
3930 <h3><a class="anchor" id="grayscale"></a>-grayscale <var>method</var></h3>
3933 <p class="magick-description">Convert image to grayscale.</p>
3935 <p>This will use one of the <a href="command-line-options.html#intensity" >-intensity</a> methods to
3940 <pre class="highlight"><code>magick in.png -grayscale Rec709Luminance out.png
3946 <code>magick in.png -colorspace RGB -colorspace Gray out.png</code>
3948 <code>magick in.png -colorspace LinearGray out.png</code>
3951 <p>Similarly, to convert an image to (non-linear) Rec709Luma grayscale, type:</p>
3953 <pre class="highlight"><code>magick in.png -grayscale Rec709Luma out.png
3958 <pre class="highlight"><code>magick in.png -colorspace Gray out.png
3966 <p>While this operation uses an <a href="command-line-options.html#intensity" >-intensity</a> metho…
3967 it does not use or set the <a href="command-line-options.html#intensity" >-intensity</a> setting, so
3972 <h3><a class="anchor" id="green-primary"></a>-green-primary <var>x,y</var></h3>
3975 <p class="magick-description">Green chromaticity primary point.</p>
3979 <h3><a class="anchor" id="hald-clut"></a>-hald-clut</h3>
3982 <p class="magick-description">Apply a Hald color lookup table to the image.</p>
3984 <p>A Hald color lookup table is a 3-dimensional color cube mapped to 2
3989 <pre class="highlight"><code>magick image.png hald.png -hald-clut transform.png
3999 href="command-line-options.html#channel" >-channel</a> setting affected, nor can it adjust or modif…
4002 <p>See also <a href="command-line-options.html#clut" >-clut</a> which provides color value replacem…
4009 <h3><a class="anchor" id="help"></a>-help</h3>
4012 <p class="magick-description">Print usage instructions.</p>
4015 <h3><a class="anchor" id="highlight-color"></a>-highlight-color <var>color</var></h3>
4018 <p class="magick-description">When comparing images, emphasize pixel differences with this color.</…
4021 …<h3><a class="anchor" id="hough-lines"></a>-hough-lines <var>width</var>x<var>height</var>{<var>+t…
4024 <p class="magick-description">Identify straight lines in the image (e.g. -hough-lines 9x9+195).</p>
4032 <p>Use <code><a href="command-line-options.html#background" >-background</a></code> to specify the …
4034 <p>Use <code><a href="command-line-options.html#fill" >-fill</a></code> to specify the color of the…
4036 … <code><a href="command-line-options.html#stroke" >-stroke</a></code> and <code><a href="command-l…
4040 <p>Use <code><a href="command-line-options.html#define" >-define</a> hough-lines:accumulator=true</…
4043 <h3><a class="anchor" id="iconGeometry"></a>-iconGeometry <var>geometry</var></h3>
4046 <p class="magick-description">Specify the icon geometry.</p>
4049 manner as the <a href="command-line-options.html#geometry">-geometry</a> option, using X11 style to
4052 <p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details abou…
4055 <h3><a class="anchor" id="iconic"></a>-iconic</h3>
4058 <p class="magick-description">Start in icon mode in X Windows", 'animate', 'display</p>
4061 <h3><a class="anchor" id="identify"></a>-identify</h3>
4064 <p class="magick-description">Identify the format and characteristics of the image.</p>
4071 <p>If <a href="command-line-options.html#colors">-colors</a> is also specified, the total unique co…
4076 <p>If <a href="command-line-options.html#verbose">-verbose</a> precedes this option, copious
4081 <h3><a class="anchor" id="ift"></a>-ift</h3>
4084 <p class="magick-description">Implements the inverse discrete Fourier transform (DFT).</p>
4086 <p>This option is new as of ImageMagick 6.5.4-3 (and now working for Windows
4087 users in ImageMagick 6.6.0-9). It transforms a pair of magnitude and phase
4095 the <a href="command-line-options.html#fft">-fft</a>, one would use either</p>
4097 <pre class="highlight"><code>magick fft_image.miff -ift fft_image_ift.png
4102 <pre class="highlight"><code>magick fft_image-0.png fft_image-1.png -ift fft_image_ift.png
4106 the original image, prior to the <a href="command-line-options.html#fft">-fft</a> or <a
4107 href="command-line-options.html#fft">+fft</a>, was not square or even dimensioned. Any padding is at
4111 use <a href="command-line-options.html#ift">-ift</a>.</p>
4113 <p>Use <a href="command-line-options.html#ift">+ift</a> (with HDRI enabled) to transform a pair of …
4117 …s not normalized (and the FFT is). Use "<code><a href="command-line-options.html#define" >-define<…
4120 <h3><a class="anchor" id="immutable"></a>-immutable</h3>
4123 <p class="magick-description">Make image immutable.</p>
4126 <h3><a class="anchor" id="implode"></a>-implode <var>factor</var></h3>
4129 <p class="magick-description">Implode image pixels about the center.</p>
4132 <h3><a class="anchor" id="insert"></a>-insert <var>index</var></h3>
4135 <p class="magick-description">Insert the last image into the image sequence.</p>
4140 <code>-insert -1</code> will result in no change to the image sequence.</p>
4142 <p>The <code>+insert</code> option is equivalent to <code>-insert -1</code>. In
4147 <h3><a class="anchor" id="intensity"></a>-intensity <var>method</var></h3>
4150 <p class="magick-description">Method to generate intensity value from pixel.</p>
4155 …ula is used, which is the same formula used when converting images to <code>-colorspace gray</code…
4158 the pixel values to linear-RGB or non-linear sRGB colorspace before
4161 <div class="pre-scrollable highlight">
4163 <dt class="col-md-4">Rec601Luma</dt><dd class="col-md-8"> 0.298839R' + 0.586811G'+ 0.114350B'<…
4164 <dt class="col-md-4">Rec601Luminance</dt><dd class="col-md-8"> 0.298839R + 0.586811G + 0.114350B</d…
4165 <dt class="col-md-4">Rec709Luma</dt><dd class="col-md-8"> 0.212656R' + 0.715158G' + 0.072186B'…
4166 <dt class="col-md-4">Rec709Luminance</dt><dd class="col-md-8"> 0.212656R + 0.715158G + 0.072186B</d…
4167 <dt class="col-md-4">Brightness</dt><dd class="col-md-8"> max(R', G', B')</dd>
4168 <dt class="col-md-4">Lightness</dt><dd class="col-md-8"> (min(R', G', B') + max(R', G', B')) …
4172 <p>Note that the above R,G,B values is the image's linear-RGB values, while
4173 R',G',B' are sRGB non-linear values. </p>
4179 <div class="pre-scrollable highlight">
4181 <dt class="col-md-4">Average</dt><dd class="col-md-8">(R' + G' + B') / 3.0</dd>
4182 <dt class="col-md-4">MS</dt><dd class="col-md-8">(R'^2 + G'^2 + B'^2) / 3.0</dd>
4183 <dt class="col-md-4">RMS</dt><dd class="col-md-8">sqrt( (R'^2 + G'^2 + B'^2) / 3.0 )</dd>
4188 grayscale difference image between two color images (using <a href="command-line-options.html#compo…
4189 >-compose</a> '<code>Difference</code>' composition. </p>
4195 href="command-line-options.html#fuzz" >-fuzz</a> factor color compare setting. </p>
4197 <p>See also <a href="command-line-options.html#grayscale" >-grayscale</a> which applies one of the …
4199 href="command-line-options.html#intensity" >-intensity</a> setting.</p>
4201 <p>The <a href="command-line-options.html#colorspace" >-colorspace gray</a> image conversion also u…
4203 appropriate sRGB or linear-RGB colorspace before appling the above
4206 … possible pixel intensity setting methods, use <a href="command-line-options.html#list">-list inte…
4208 <p>Operators affected by the <a href="command-line-options.html#intensity" >-intensity</a> setting …
4210 <pre class="highlight"><code>-adaptive-blur
4211 -adaptive-sharpen
4212 -black-threshold
4213 -clut (when mapping greyscale CLUT image to alpha channel if set by -channels)
4214 -colors for gray colorspace
4215 -compose {LightenIntensity, DarkenIntensity, CopyOpacity, CopyBlack}
4216 -contrast-stretch
4217 -distort {ErodeIntensity, DilateIntensity}
4218 -normalize
4219 -random-threshold
4220 -range-threshold
4221 -selective-blur
4222 -shade
4223 -threshold
4224 -tint
4225 -white-threshold
4229 <h3><a class="anchor" id="intent"></a>-intent <var>type</var></h3>
4232 <p class="magick-description">Use this type of rendering intent when managing the image color.</p>
4235 <a href="command-line-options.html#profile">-profile</a>). Choose from these intents: <code>Absolu…
4240 <p>To print a complete list of rendering intents, use <a href="command-line-options.html#list">-lis…
4243 <h3><a class="anchor" id="interlace"></a>-interlace <var>type</var></h3>
4246 <p class="magick-description">The type of interlacing scheme.</p>
4274 <p>To print a complete list of interlacing schemes, use <a href="command-line-options.html#list">-l…
4278 <h3><a class="anchor" id="interpolate"></a>-interpolate <var>type</var></h3>
4281 <p class="magick-description">Set the pixel color interpolation method to use when looking up a col…
4283 <p>When looking up the color of a pixel using a non-integer floating point
4289 <div class="pre-scrollable highlight">
4291 <dt class="col-md-4">average</dt>
4292 <dd class="col-md-8">The average color of the surrounding four pixels</dd>
4293 <dt class="col-md-4">average4</dt>
4294 <dd class="col-md-8">The average color of the surrounding four pixels</dd>
4295 <dt class="col-md-4">average9</dt>
4296 <dd class="col-md-8">The average color of the surrounding nine pixels</dd>
4297 <dt class="col-md-4">average16</dt>
4298 <dd class="col-md-8">The average color of the surrounding sixteen pixels</dd>
4299 <dt class="col-md-4">background</dt>
4300 <dd class="col-md-8"> </dd>
4301 <dt class="col-md-4">bilinear</dt>
4302 <dd class="col-md-8">A double linear interpolation of pixels (the default)</dd>
4303 <dt class="col-md-4">blend</dt>
4304 <dd class="col-md-8"> </dd>
4305 <dt class="col-md-4">catrom</dt>
4306 <dd class="col-md-8">Fitted bicubic-spines of surrounding 16 pixels</dd>
4307 <dt class="col-md-4">integer</dt>
4308 <dd class="col-md-8">The color of the top-left pixel (floor function)</dd>
4309 <dt class="col-md-4">mesh</dt>
4310 <dd class="col-md-8">Divide area into two flat triangular interpolations</dd>
4311 <dt class="col-md-4">nearest-neighbor</dt>
4312 <dd class="col-md-8">The nearest pixel to the lookup point (rounded function)</dd>
4313 <dt class="col-md-4">spline</dt>
4314 <dd class="col-md-8">Direct spline curves (colors are blurred)</dd>
4318 <p>This most important for distortion operators such as <a href="command-line-options.html#distort"
4319 >-distort</a>, <a href="command-line-options.html#implode" >-implode</a>, <a href="command-line-opt…
4320 >-transform</a> and <a href="command-line-options.html#fx" >-fx</a>. </p>
4322 … a complete list of interpolation methods, use <a href="command-line-options.html#list">-list inte…
4324 <p>See also <a href="command-line-options.html#virtual-pixel" >-virtual-pixel</a>, for control of t…
4329 <h3><a class="anchor" id="interline-spacing"></a>-interline-spacing <var>value</var></h3>
4332 <p class="magick-description">The space between two text lines.</p>
4335 <h3><a class="anchor" id="interword-spacing"></a>-interword-spacing <var>value</var></h3>
4338 <p class="magick-description">The space between two words.</p>
4341 <h3><a class="anchor" id="kerning"></a>-kerning <var>value</var></h3>
4344 <p class="magick-description">The space between two letters.</p>
4347 …<h3><a class="anchor" id="kmeans"></a>-kmeans <var>colors</var>{x<var>iterations</var>}{+<var>tole…
4350 …-description">Kmeans (iterative) color reduction (e.g. <code>-kmeans 5x100+0.01</code>). Colors is…
4353 …<h3><a class="anchor" id="kuwahara"></a>-kuwahara <var>radius</var><br />-kuwahara <var>radius</va…
4356 <p class="magick-description">Edge preserving noise reduction filter.</p>
4358 …atically from the <var >radius</var> as <var >sigma</var>=<var >radius</var>-0.5. The <var >sigma<…
4362 <h3><a class="anchor" id="label"></a>-label <var>name</var></h3>
4365 <p class="magick-description">Assign a label to an image.</p>
4368 or created. You can use the <a href="command-line-options.html#set" >-set</a> operation to re-assi…
4382 <pre class="highlight"><code>-label "%m:%f %wx%h" bird.miff
4387 is read in. If a <a href="command-line-options.html#label">+label</a> option was used instead, any
4393 visible on the image itself, use the <a href="command-line-options.html#draw">-draw</a> option, or
4402 …<h3><a class="anchor" id="lat"></a>-lat <var>width</var><br />-lat <var>width</var>x<var>height</v…
4405 <p class="magick-description">Perform local adaptive threshold.</p>
4420 <h3><a class="anchor" id="layers"></a>-layers <var>method</var></h3>
4423 <p class="magick-description">Handle multiple images forming a set of image layers or animation fra…
4427 animation, or a fully-'coalesced' animation sequence. </p>
4429 <div class="pre-scrollable highlight">
4430 <table class="table table-sm table-hover">
4438 <td>compare-any</td>
4441 href="command-line-options.html#dispose" >-dispose</a> methods are taken into account. </td>
4444 <tr><td></td><td>This exactly the same as the <a href="command-line-options.html#deconstruct"
4445 >-deconstruct</a> operator, and does not preserve animations normal
4451 <td>compare-clear</td>
4452 <td>As '<code>compare-any</code>' but crop to the bounds of any
4458 <td>compare-overlay</td>
4459 <td>As '<code>compare-any</code>' but crop to pixels that add
4464 …<tr><td></td><td>This can be used with the <a href="command-line-options.html#compose" >-compose</…
4465 composition method '<code>change-mask</code>', to reduce the image to
4471 <td>Equivalent to a call to the <a href="command-line-options.html#coalesce"
4472 >-coalesce</a> operator. Apply the layer disposal methods set in the
4475 'film strip'-like animation. </td>
4489 <td>The <a href="command-line-options.html#geometry" >-geometry</a> offset is adjusted according
4490 to <a href="command-line-options.html#gravity" >-gravity</a> in accordance of the virtual
4492 … href="command-line-options.html#composite" >-composite</a> operation, the canvas offset is also
4498 list it is. In this case it is the image meta-data of the list which
4507 the next sub-frame image is overlaid. That is the 'dispose' image that
4508 results from the application of the GIF <a href="command-line-options.html#dispose"
4509 >-dispose</a> method. This allows you to check what
4517 … canvas using the current <a href="command-line-options.html#background" >-background</a> color,
4518 and <a href="command-line-options.html#compose" >-compose</a> each image in turn onto that
4547 Following this operation method with <a href="command-line-options.html#repage" >+repage</a>
4554 <tr><td></td><td>See also 'trim-bounds' below which is closely related but
4564 become clipped by the top and left edges. See 'merge' or 'trim-bounds'
4580 apply both the '<code>optimize-frame</code>', and
4581 '<code>optimize-transparency</code>' methods but may be expanded to
4586 <td>optimize-frame</td>
4600 <td>optimize-plus</td>
4601 <td>As '<code>optimize-frame</code>' but attempt to improve the
4608 '<code>optimize-frame</code>' technique. </td>
4614 better than the normal '<code>optimize-frame</code>' technique. For some
4620 <td>optimize-transparency</td>
4621 <td>Given a GIF animation, replace any pixel in the sub-frame
4623 … animation by more than the current <a href="command-line-options.html#fuzz" >-fuzz</a> factor.
4634 <td>remove-dups</td>
4642 smaller sub-animations. The duplicate frames could also have been
4647 <td>remove-zero</td>
4660 <td>trim-bounds</td>
4673 <a href="command-line-options.html#repage" >+repage</a> option, except that all the images
4675 'trim-bounds' you will get the same result. </td>
4682 <p>To print a complete list of layer types, use <a href="command-line-options.html#list">-list laye…
4684 <p>The operators <a href="command-line-options.html#coalesce" >-coalesce</a>, <a href="command-line…
4685 >-deconstruct</a>, <a href="command-line-options.html#flatten" >-flatten</a>, and <a href="command-…
4686 >-mosaic</a> are only aliases for the above methods and may be depreciated in
4687 the future. Also see <a href="command-line-options.html#page" >-page</a>, <a href="command-line-…
4688 >-repage</a> operators, the <a href="command-line-options.html#compose" >-compose</a> setting, and …
4689 GIF <a href="command-line-options.html#dispose" >-dispose</a> and <a href="command-line-options.ht…
4694 …<h3><a class="anchor" id="level"></a>-level <var>black_point</var>{,<var>white_point</var>}{<var>%…
4697 <p class="magick-description">Adjust the level of image channels.</p>
4699 <p>Given one, two or three values delimited with commas: black-point,
4700 white-point, gamma (for example: 10,250,1.0 or 2%,98%,0.5). The black and
4702 100%; if the white point is omitted it is set to (<var>QuantumRange</var> - black_point), so as to …
4705 href="command-line-options.html#gamma">-gamma</a> adjustment of the values. If it is omitted, the
4708 <p>In normal usage (<code>-level</code>) the image values are stretched so that
4714 <p>From ImageMagick v6.4.1-9 using the plus form of the operator
4719 de-contrast, or compress the channel values within the image. The
4720 '<code>gamma</code>' is adjusted before the level adjustment to de-contrast the
4723 <p>Only the channels defined by the current <a href="command-line-options.html#channel">-channel</a>
4732 …<h3><a class="anchor" id="level-colors"></a>-level-colors {<var>black_color</var>}{,}{<var>white_c…
4735 <p class="magick-description">Adjust the level of an image using the provided dash separated colors…
4737 <p>This function is exactly like <a href="command-line-options.html#level">-level</a>, except that …
4740 described under the <a href="command-line-options.html#fill">-fill</a> option). </p>
4742 <p>This effectively means the colors provided to <code>-level-colors</code>
4747 <p>On the other hand the plus form of the operator (<code>+level-colors</code>)
4749 respectively, resulting in a gradient (de-contrasting) tint of the image to
4757 threshold the images around that color (- form) or set all colors to that
4762 <h3><a class="anchor" id="limit"></a>-limit <var>type value</var></h3>
4765 <p class="magick-description">Set the pixel cache resource limit.</p>
4780 <pre class="highlight"><code>-limit memory 32MiB -limit map 64MiB
4783 <p>Use <a href="command-line-options.html#list">-list resource</a> to list the current limits. For …
4785 <pre class="highlight"><code>-> identify -list resource
4800 of three resource categories: in-memory pool, memory-mapped files pool, and
4801 …pool (in that order) depending on the <a class="text-nowrap" href="command-line-options.html#limit…
4812 is memory-mapped. However, if the allocation request exceeds the
4830 <pre class="highlight"><code>-limit area 10MB
4840 <pre class="highlight"><code>-limit area 10MB -limit disk 500MB
4845 <p>In addition to command-line resource limit option, resources can be set
4854 <p> Inquisitive users can try adding <a href="command-line-options.html#debug">-debug cache</a> to
4866 …ss="anchor" id="linear-stretch"></a>-linear-stretch <var>black-point</var><br />-linear-stretch <v…
4869 <p class="magick-description">Linear with saturation stretch.</p>
4871 <p>This is very similar to <a href="command-line-options.html#contrast-stretch" >-contrast-stretch<…
4874 href="command-line-options.html#level" >-level</a> operator.</p>
4880 <p>note however that a <a href="command-line-options.html#linear-stretch" >-linear-stretch</a> of
4884 <p>See also <a href="command-line-options.html#auto-level" >-auto-level</a> for a 'perfect'
4887 <p>This operator is under review for re-development. </p>
4891 <h3><a class="anchor" id="linewidth"></a>-linewidth</h3>
4894 <p class="magick-description">The line width for subsequent draw operations.</p>
4897 <h3><a class="anchor" id="liquid-rescale"></a>-liquid-rescale <var>geometry</var></h3>
4900 <p class="magick-description">Rescale image with seam-carving.</p>
4902 <p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details abou…
4905 <h3><a class="anchor" id="list"></a>-list <var>type</var></h3>
4908 <p class="magick-description">Print a list of supported arguments for various options or settings. …
4910 <pre class="pre-scrollable highlight"><code>
4983 <p>These lists vary depending on your version of ImageMagick. Use "<code>-list
4984 list</code>" to get a complete listing of all the "<code>-list</code>" arguments
4987 <pre class="highlight"><code>magick identify -list list
4991 <h3><a class="anchor" id="log"></a>-log <var>string</var></h3>
4994 <p class="magick-description">Specify format for debug log.</p>
4997 href="command-line-options.html#debug">-debug</a> option is active.</p>
5002 <div class="pre-scrollable highlight">
5004 <dt class="col-md-4">%d</dt><dd class="col-md-8">domain</dd>
5005 <dt class="col-md-4">%e</dt><dd class="col-md-8">event</dd>
5006 <dt class="col-md-4">%f</dt><dd class="col-md-8">function</dd>
5007 <dt class="col-md-4">%l</dt><dd class="col-md-8">line</dd>
5008 <dt class="col-md-4">%m</dt><dd class="col-md-8">module</dd>
5009 <dt class="col-md-4">%p</dt><dd class="col-md-8">process ID</dd>
5010 <dt class="col-md-4">%r</dt><dd class="col-md-8">real CPU time</dd>
5011 <dt class="col-md-4">%t</dt><dd class="col-md-8">wall clock time</dd>
5012 <dt class="col-md-4">%u</dt><dd class="col-md-8">user CPU time</dd>
5013 <dt class="col-md-4">%%</dt><dd class="col-md-8">percent sign</dd>
5014 <dt class="col-md-4">\n</dt><dd class="col-md-8">newline</dd>
5015 <dt class="col-md-4">\r</dt><dd class="col-md-8">carriage return</dd>
5021 <pre class="highlight"><code>magick -debug coder -log "%u %m:%l %e" in.gif out.png
5027 <h3><a class="anchor" id="loop"></a>-loop <var>iterations</var></h3>
5030 <p class="magick-description">Add Netscape loop extension to your GIF animation.</p>
5037 <h3><a class="anchor" id="lowlight-color"></a>-lowlight-color <var>color</var></h3>
5040 <p class="magick-description">When comparing images, de-emphasize pixel differences with this color…
5043 <h3><a class="anchor" id="magnify"></a>-magnify</h3>
5046 …class="magick-description">Double or triple the size of the image with pixel art scaling. Specify …
5050 <h3><a class="anchor" id="map"></a>-map <var>type</var></h3>
5053 <p class="magick-description">Display image using this <var>type</var>.</p>
5068 <code>top-to-bottom</code> order until one is located. See <var>xstdcmap(1)</var> for one way of cr…
5072 <h3><a class="anchor" id="map_stream_"></a>-map <var>components</var></h3>
5075 <p class="magick-description">Pixel map.</p>
5079 <div class="pre-scrollable highlight">
5081 <dt class="col-md-4">r</dt><dd class="col-md-8"> red pixel component</dd>
5082 <dt class="col-md-4">g</dt><dd class="col-md-8"> green pixel component</dd>
5083 <dt class="col-md-4">b</dt><dd class="col-md-8"> blue pixel component</dd>
5084 <dt class="col-md-4">a</dt><dd class="col-md-8"> alpha pixel component (0 is transparent)</dd>
5085 <dt class="col-md-4">o</dt><dd class="col-md-8"> opacity pixel component (0 is opaque)</dd>
5086 <dt class="col-md-4">i</dt><dd class="col-md-8"> grayscale intensity pixel component</dd>
5087 <dt class="col-md-4">c</dt><dd class="col-md-8"> cyan pixel component</dd>
5088 <dt class="col-md-4">m</dt><dd class="col-md-8"> magenta pixel component</dd>
5089 <dt class="col-md-4">y</dt><dd class="col-md-8"> yellow pixel component</dd>
5090 <dt class="col-md-4">k</dt><dd class="col-md-8"> black pixel component</dd>
5091 <dt class="col-md-4">p</dt><dd class="col-md-8"> pad component (always 0)</dd>
5100 <h3><a class="anchor" id="mattecolor"></a>-mattecolor <var>color</var></h3>
5103 <p class="magick-description">Specify the color to be used with the <a href="command-line-options.h…
5105 …specified using the format described under the <a href="command-line-options.html#fill">-fill</a> …
5108 style="background-color: #bdbdbd;">this shade of gray</span>.</p>
5111 <h3><a class="anchor" id="maximum"></a>-maximum</h3>
5114 <p class="magick-description">Return the maximum intensity of an image sequence.</p>
5118 <p>This is legacy option from the <a href="command-line-options.html#statistic" >method</a> of the …
5122 <h3><a class="anchor" id="median"></a>-median <var>geometry</var></h3>
5125 <p class="magick-description">Apply a median filter to the image.</p>
5129 <p>This is legacy option from the <a href="command-line-options.html#statistic" >method</a> of the …
5133 …<h3><a class="anchor" id="mean-shift"></a>-mean-shift <var>width</var>x<var>height</var>{<var>+dis…
5136 <p class="magick-description">Image noise removal and color reduction/segmentation (e.g. -mean-shif…
5140 …e pixel and excludes those that are outside the <var>radius=sqrt((width-1)(height-1)/4)</var> surr…
5143 <h3><a class="anchor" id="metric"></a>-metric <var>type</var></h3>
5146 <p class="magick-description">Output to STDERR a measure of the differences between images accordin…
5150 <div class="pre-scrollable highlight">
5152 <dt class="col-md-4">AE</dt><dd class="col-md-8"> absolute error count, number of different pixe…
5153 <dt class="col-md-4">DSSIM</dt><dd class="col-md-8"> structural dissimilarity index</dd>
5154 <dt class="col-md-4">FUZZ</dt><dd class="col-md-8"> mean color distance</dd>
5155 <dt class="col-md-4">MAE</dt><dd class="col-md-8"> mean absolute error (normalized), average chan…
5156 <dt class="col-md-4">MEPP</dt><dd class="col-md-8"> mean error per pixel (normalized mean error, n…
5157 <dt class="col-md-4">MSE</dt><dd class="col-md-8"> mean error squared, average of the channel err…
5158 <dt class="col-md-4">NCC</dt><dd class="col-md-8"> normalized cross correlation</dd>
5159 <dt class="col-md-4">PAE</dt><dd class="col-md-8"> peak absolute (normalized peak absolute)</dd>
5160 …ass="col-md-4">PHASH</dt><dd class="col-md-8"> perceptual hash for the sRGB and HCLp colorspaces. …
5161 <dt class="col-md-4">PSNR</dt><dd class="col-md-8"> peak signal to noise ratio</dd>
5162 <dt class="col-md-4">RMSE</dt><dd class="col-md-8"> root mean squared (normalized root mean square…
5163 <dt class="col-md-4">SSIM</dt><dd class="col-md-8"> structural similarity index</dd>
5168 with the <a href="command-line-options.html#fuzz" >-fuzz</a> factor (ignore pixels which
5170 size of the <a href="command-line-options.html#fuzz" >-fuzz</a> factor needed to make all pixels
5179 <code>-define compare:ssim-radius</code>, <code>-define compare:ssim-sigma</code>,
5180 <code>-define compare:ssim-k1</code>, and <code>-define compare:ssim-k2</code>.</p>
5182 <p>To print a complete list of metrics, use the <a href="command-line-options.html#list">-list
5187 <h3><a class="anchor" id="minimum"></a>-minimum</h3>
5190 <p class="magick-description">Return the minimum intensity of an image sequence.</p>
5194 <p>This is legacy option from the <a href="command-line-options.html#statistic" >method</a> of the …
5200 <h3><a class="anchor" id="mode"></a>-mode <var>geometry</var></h3>
5203 <p class="magick-description">Make each pixel the \'predominant color\' of the neighborhood.'</p>
5206 <h3>-mode <var>value</var></h3>
5209 <p class="magick-description">Mode of operation.</p>
5214 <p>Use the <a href="command-line-options.html#list" >-list</a> option with a '<code>Mode</code>' ar…
5215 for a list of <a href="command-line-options.html#mode" >-mode</a> arguments available in your
5220 …<h3><a class="anchor" id="modulate"></a>-modulate <var>brightness</var>[,<var>saturation</var>,<va…
5223 <p class="magick-description">Vary the <var>brightness</var>, <var>saturation</var>, and <var>hue</…
5230 twice as bright. To invert its meaning <a href="command-line-options.html#negate">-negate</a> the i…
5239 a counter-clockwise rotation of 90, mapping red shades to purple, and so on.
5246 href="command-line-options.html#modulate">-modulate 120,90</a>.</p>
5248 <p>Use <a href="command-line-options.html#set">-set</a> attribute of '<code
5252 <pre class="highlight"><code>magick image.png -set option:modulate:colorspace hsb -modulate 120,90 …
5256 <h3><a class="anchor" id="moments"></a>-moments</h3>
5259 <p class="magick-description">Report image moments and perceptual hash.</p>
5263 <h3><a class="anchor" id="monitor"></a>-monitor</h3>
5266 <p class="magick-description">Monitor progress.</p>
5270 <h3><a class="anchor" id="monochrome"></a>-monochrome</h3>
5273 <p class="magick-description">Transform the image to black and white.</p>
5276 <h3><a class="anchor" id="morph"></a>-morph <var>frames</var></h3>
5279 <p class="magick-description">Morphs an image sequence.</p>
5284 href="command-line-options.html#blend">-blend</a> composition. The <var>frames</var>
5289 <h3><a class="anchor" id="morphology"></a>-morphology</h3>
5290 <h3>-morphology <var>method</var> <var>kernel</var></h3>
5293 <p class="magick-description">Apply a morphology method to the image.</p>
5299 <h3><a class="anchor" id="mosaic"></a>-mosaic</h3>
5302 <p class="magick-description">An simple alias for the <a href="command-line-options.html#layers" >-…
5306 …<h3><a class="anchor" id="motion-blur"></a>-motion-blur <var>radius</var><br />-motion-blur <var>r…
5309 <p class="magick-description">Simulate motion blur.</p>
5318 <p>The <a href="command-line-options.html#virtual-pixel">-virtual-pixel</a> setting will determine …
5323 <h3><a class="anchor" id="name"></a>-name</h3>
5326 <p class="magick-description">Name an image.</p>
5328 <h3><a class="anchor" id="negate"></a>-negate</h3>
5331 <p class="magick-description">Replace each pixel with its complementary color.</p>
5334 black, yellow becomes blue, etc. Use <a href="command-line-options.html#negate">+negate</a> to only
5338 <h3><a class="anchor" id="noise"></a>-noise <var>geometry</var><br/>
5342 <p class="magick-description">Add or reduce noise in an image.</p>
5351 <p>Use <code><a href="command-line-options.html#noise">-noise</a> <var>radius</var></code> to
5353 to using a <code><a href="command-line-options.html#statistic" >-statistic</a> NonPeak</code> opera…
5356 <p>Use <a href="command-line-options.html#noise">+noise</a> followed by a noise <var>type</var> to …
5369 href="command-line-options.html#attenuate" >-attenuate</a></code> setting. If unset the value is
5374 <p>To print a complete list of noises, use the <a href="command-line-options.html#list">-list noise…
5376 <p>Also see the <a href="command-line-options.html#evaluate">-evaluate</a> noise functions that all…
5382 <h3><a class="anchor" id="normalize"></a>-normalize</h3>
5385 <p class="magick-description">Increase the contrast in an image by <var>stretching</var> the range …
5388 values. While doing so, black-out at most <var>2%</var> of the pixels and
5389 white-out at most <var>1%</var> of the pixels.</p>
5391 <p>Note that as of ImageMagick 6.4.7-0, <a href="command-line-options.html#normalize" >-normalize</…
5392 is equivalent to <a href="command-line-options.html#contrast-stretch" >-contrast-stretch 2%x1%</a>.
5393 (Before this version, it was equivalent to <a href="command-line-options.html#contrast-stretch"
5394 >-contrast-stretch 2%x99%</a>).</p>
5397 preserve color integrity, when the default <a href="command-line-options.html#channel" >+channel</a>
5398 setting is in use. Specifying any other <a href="command-line-options.html#channel" >-channel</a>
5401 <p>See <a href="command-line-options.html#contrast-stretch" >-contrast-stretch</a> for more detail…
5402 Also see <a href="command-line-options.html#auto-level" >-auto-level</a> for a 'perfect' normalizat…
5405 <p>This operator is under review for re-development. </p>
5409 <h3><a class="anchor" id="opaque"></a>-opaque <var>color</var></h3>
5412 <p class="magick-description">Change this color to the fill color within the image.</p>
5415 described under the <a href="command-line-options.html#fill" >-fill</a> option. The <a href="comma…
5416 >-fuzz</a> setting can be used to match and replace colors similar to the one
5419 <p>Use <a href="command-line-options.html#opaque">+opaque</a> to paint any pixel that does not match
5422 <p>The <a href="command-line-options.html#transparent">-transparent</a> operator is exactly the sa…
5423 as <a href="command-line-options.html#opaque" >-opaque</a> but replaces the matching color with
5424 transparency rather than the current <a href="command-line-options.html#fill">-fill</a> color setti…
5426 channel enabled, as per "<code><a href="command-line-options.html#alpha" >-alpha</a> set</code>", f…
5428 href="command-line-options.html#channel">-channel</a> to enable alpha channel handling. </p>
5432 …<h3><a class="anchor" id="ordered-dither"></a>-ordered-dither <var>threshold_map</var>{,<var>level…
5435 <p class="magick-description">Dither the image using a pre-defined ordered dither <var>threshold m…
5440 <pre class="pre-scrollable highlight"><code>
5441 threshold 1x1 Threshold 1x1 (non-dither)
5464 href="command-line-options.html#posterize" >-posterize</a> to reduce an image to basic primary colo…
5469 white, and mid-tone colors into a checkerboard pattern of black and white.
5478 <a href="command-line-options.html#list" >-list threshold</a> option.</p>
5485 on/off boolean effects, without anti-aliasing to make the circles smooth
5491 <h3><a class="anchor" id="orient"></a>-orient <var>image orientation</var></h3>
5494 <p class="magick-description">Specify orientation of a digital camera image.</p>
5498 <pre class="highlight"><code>bottom-left right-top
5499 bottom-right top-left
5500 left-bottom top-right
5501 left-top undefined
5502 right-bottom
5505 <p>To print a complete list of orientations, use the <a href="command-line-options.html#list" >-list
5510 <h3><a class="anchor" id="page"></a>-page <var>geometry</var><br/>
5511 -page <var>media</var>[<var>offset</var>][{<var>^!<></var>}]<br/>
5516 <p class="magick-description">Set the size and location of an image on the larger virtual canvas.</…
5518 <p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details abou…
5522 href="command-line-options.html#page">-page</a> <code>Letter+43+43</code>).</p>
5526 <pre class="highlight"><code>magick xc: -format "%[papersize:a4]" info:</code></pre>
5528 <p>This option is also used to place subimages when writing to a multi-image
5531 and are not affected by the <a href="command-line-options.html#gravity">-gravity</a> option. To
5532 …ion a GIF or MNG image, use <a href="command-line-options.html#page">-page</a><var>{+-}x{+-}y</var…
5533 file, a <a href="command-line-options.html#page">-page</a> option appearing ahead of the first imag…
5541 href="command-line-options.html#geometry">-geometry</a> but positioned relative to the <var>lower
5542 left-hand corner</var> of the page by {+-}<code>x</code><var>offset</var>{+-}<code>y</code> <var>of…
5543 href="command-line-options.html#page">-page 612x792</a>, for example, to center the image within the
5545 page. The default gravity for the <a href="command-line-options.html#page">-page</a> option is <var…
5546 corner of the page, unless the <a href="command-line-options.html#gravity">-gravity</a> option is
5551 <p>This option is used in concert with <a href="command-line-options.html#density">-density</a>.</p>
5553 <p>Use <a href="command-line-options.html#page">+page</a> to remove the page settings for an image.…
5556 <h3><a class="anchor" id="paint"></a>-paint <var>radius</var></h3>
5559 <p class="magick-description">Simulate an oil painting.</p>
5565 <h3><a class="anchor" id="path"></a>-path <var>path</var></h3></div>
5567 <p class="magick-description">Write images to this path on disk.</p>
5570 <h3><a class="anchor" id="pause_animate_"></a>-pause <var>seconds</var></h3>
5573 <p class="magick-description">Pause between animation loops</p>
5578 <h3><a class="anchor" id="pause_import_"></a>-pause <var>seconds</var></h3>
5581 <p class="magick-description">Pause between snapshots.</p>
5586 <h3><a class="anchor" id="perceptible"></a>-perceptible <var>epsilon</var></h3>
5589 <p class="magick-description">Set each pixel whose value is less than |<var>epsilon</var>| to <var>…
5592 <h3><a class="anchor" id="ping"></a>-ping</h3>
5595 <p class="magick-description">Efficiently determine these image characteristics: image number, the …
5598 <h3><a class="anchor" id="pointsize"></a>-pointsize <var>value</var></h3>
5601 <p class="magick-description">Pointsize of the PostScript, OPTION1, or TrueType font.</p>
5604 <h3><a class="anchor" id="polaroid"></a>-polaroid <var>angle</var></h3>
5607 <p class="magick-description">Simulate a Polaroid picture.</p>
5609 <p>Use <code>+polaroid</code> to rotate the image at a random angle between -15 and +15 degrees.</p>
5612 <h3><a class="anchor" id="poly"></a>-poly <var>"wt,exp ..."</var></h3>
5615 <p class="magick-description">Combines multiple images according to a weighted sum of polynomials; …
5617 …lly be fractions between -1 and 1. But the sum of weights should be 1 or at least between 0 and 1 …
5625 …r of images), then this is equivalent to <a href="command-line-options.html#profile">-evaluate-seq…
5635 <h3><a class="anchor" id="posterize"></a>-posterize <var>levels</var></h3>
5638 <p class="magick-description">Reduce the image to a limited number of color levels per channel.</p>
5644 <h3><a class="anchor" id="precision"></a>-precision <var>value</var></h3>
5647 <p class="magick-description">Set the maximum number of significant digits to be printed.</p>
5650 <h3><a class="anchor" id="preview"></a>-preview <var>type</var></h3>
5653 <p class="magick-description">Image preview type.</p>
5656 <code>magick file.png -preview Gamma Preview:gamma.png</code>). Choose from
5659 <pre class="pre-scrollable highlight"><code>
5691 <p>To print a complete list of previews, use the <a href="command-line-options.html#list">-list pre…
5696 <h3><a class="anchor" id="print"></a>-print <var>string</var></h3>
5699 <p class="magick-description">Interpret string and print to console.</p>
5702 <h3><a class="anchor" id="process"></a>-process <var>command</var></h3>
5705 <p class="magick-description">Process the image with a custom image filter.</p>
5713 <h3><a class="anchor" id="profile"></a>-profile <var>filename</var><br/>
5717 <p class="magick-description">Manage ICM, IPTC, or generic profiles in an image.</p>
5719 <p>Using <a href="command-line-options.html#profile">-profile</a> <var>filename</var> adds an
5723 <p>Use <a href="command-line-options.html#profile">+profile <var>profile_name</var></a> to
5729 <p>Use <code>magick identify -verbose</code> to find out which profiles are in the
5730 image file. Use <a href="command-line-options.html#strip">-strip</a> to remove all profiles (and
5733 <p>To extract a profile, the <a href="command-line-options.html#profile">-profile</a> option is not
5739 …code>-define precision:highres-transform=true</code> to increase the transform precision. Note, t…
5746 href="command-line-options.html#profile">-profile</a> is an "operator" (as opposed to a "setting") …
5748 command-line. For instance, in the following example, if the original image is
5749 CMYK with profile, a CMYK-CMYK-RGB conversion results.</p>
5751 <pre class="highlight"><code>magick CMYK.tif -profile "CMYK.icc" -profile "RGB.icc" RGB.tiff
5760 <h3><a class="anchor" id="quality"></a>-quality <var>value</var></h3>
5763 <p class="magick-description">JPEG/MIFF/PNG compression level.</p>
5770 Use the <a href="command-line-options.html#sampling-factor">-sampling-factor</a> option to specify …
5773 <p>For the JPEG-2000 image format, quality is mapped using a non-linear
5775 non-linear equation is intended to loosely approximate the quality provided by
5776 the JPEG v1 format. The default quality value 100, a request for non-lossy
5780 compression level (quality / 10) and filter-type (quality % 10). The default
5785 <p>For compression level 0 (quality value less than 10), the Huffman-only
5789 <p>If filter-type is 4 or less, the specified PNG filter-type is used for
5792 <div class="pre-scrollable highlight">
5794 <dt class="col-md-4">0</dt><dd class="col-md-8">none</dd>
5795 <dt class="col-md-4">1</dt><dd class="col-md-8">sub</dd>
5796 <dt class="col-md-4">2</dt><dd class="col-md-8">up</dd>
5797 <dt class="col-md-4">3</dt><dd class="col-md-8">average</dd>
5798 <dt class="col-md-4">4</dt><dd class="col-md-8">Paeth</dd>
5802 <p>If filter-type is 5, adaptive filtering is used when quality is greater
5806 <p>If filter-type is 6, adaptive filtering
5807 with <var>minimum-sum-of-absolute-values</var> is used.</p>
5809 <p>Only if the output is MNG, if filter-type is 7, the LOCO color
5811 with <var>minimum-sum-of-absolute-values</var> are used.</p>
5813 <p>If the filter-type is 8 the zlib Z_RLE compression strategy (or the
5817 <p>If the filter-type is 9 the zlib Z_RLE compression strategy (or the
5825 can be obtained using the -quality option. For more precise control,
5826 you can use the PNG:compression-level=N, PNG:compression-strategy=N, and
5827 PNG:compression-filter=N defines, respectively, instead.
5828 See <a href="command-line-options.html#define">-define</a>. Values from the defines take precedence
5829 over values from the -quality option.</p>
5834 <p>For the MIFF and TIFF image formats, quality/10 is the <a href="command-line-options.html#compre…
5839 <h3><a class="anchor" id="quantize"></a>-quantize <var>colorspace</var></h3>
5842 <p class="magick-description">Reduce colors using this colorspace.</p>
5846 href="command-line-options.html#colors" >-colors</a>, Note that color reduction also happens
5847 automatically when saving images to color-limited image file formats, such as
5852 <h3><a class="anchor" id="quiet"></a>-quiet</h3>
5855 <p class="magick-description">Suppress all warning messages. Error messages are still reported.</p>
5858 <h3><a class="anchor" id="radial-blur"></a>-radial-blur <var>angle</var></h3>
5861 <p class="magick-description">Blur around the center of the image.</p>
5864 such actually mis-named. </p>
5866 <p>The <a href="command-line-options.html#virtual-pixel">-virtual-pixel</a> setting will determine …
5872 <h3><a class="anchor" id="raise"></a>-raise <var>thickness</var></h3>
5875 <p class="magick-description">Lighten or darken image edges.</p>
5877 <p>This will create a 3-D effect. Use <a href="command-line-options.html#raise">-raise</a> to create
5878 a raised effect, otherwise use <a href="command-line-options.html#raise">+raise</a>. </p>
5880 <p>Unlike the similar <a href="command-line-options.html#frame">-frame</a> option, <a
5881 href="command-line-options.html#raise">-raise</a> does not alter the dimensions of the image.</p>
5884 …<h3><a class="anchor" id="random-threshold"></a>-random-threshold <var>low</var>x<var>high</var></…
5887 <p class="magick-description">Apply a random threshold to the image.</p>
5890 …lass="anchor" id="range-threshold"></a>-range-threshold <var>low-black</var>,<var>low-white</var>,…
5893 <p class="magick-description">Perform either hard or soft thresholding within some range of values …
5896 <h3><a class="anchor" id="read-mask"></a>-read-mask
5900 <p class="magick-description">Prevent updates to image pixels specified by the mask.</p>
5906 <p>Use <a href="command-line-options.html#read-mask">+read-mask</a> to remove the mask from images.…
5908 <p>Also see <a href="command-line-options.html#clip-mask">-clip-mask</a> which work in the same way,
5912 <h3><a class="anchor" id="red-primary"></a>-red-primary <var>x,y</var></h3>
5915 <p class="magick-description">Set the red chromaticity primary point.</p>
5918 <h3><a class="anchor" id="regard-warnings"></a>-regard-warnings</h3>
5921 <p class="magick-description">Pay attention to warning messages.</p>
5927 <h3><a class="anchor" id="remap"></a>-remap <var>filename</var></h3>
5930 <p class="magick-description">Reduce the number of colors in an image to the colors used by this im…
5932 <p>If the <a href="command-line-options.html#dither">-dither</a> setting is enabled (the default) t…
5936 <p>As a side effect of applying a <a href="command-line-options.html#remap">-remap</a> of colors ac…
5942 <p>Use <a href="command-line-options.html#remap">+remap</a> to reduce all images in the current ima…
5945 reducing those images using <a href="command-line-options.html#colors">-colors</a> with a 256 color
5946 limit, then <a href="command-line-options.html#remap">-remap</a> those colors over the original lis…
5950 href="command-line-options.html#remap">+remap</a> should not perform any color reduction or ditheri…
5953 href="command-line-options.html#colors">-colors</a> or <a href="command-line-options.html#ordered-d…
5956 <p>Note, the remap image colormap has at most 8-bits of precision. Deeper color maps are automagica…
5959 <h3><a class="anchor" id="region"></a>-region <var>geometry</var></h3>
5962 <p class="magick-description">Set a region in which subsequent operations apply.</p>
5965 in the same manner as in <a href="command-line-options.html#crop">-crop</a>.</p>
5967 <p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details abou…
5972 <h3><a class="anchor" id="remote"></a>-remote</h3>
5975 <p class="magick-description">Perform a remote operation.</p>
5980 running simultaneously, use the <a href="command-line-options.html#window"> window</a> option to
5984 <h3><a class="anchor" id="render"></a>-render</h3>
5987 <p class="magick-description">Render vector operations.</p>
5989 <p>Use <a href="command-line-options.html#render">+render</a> to turn off rendering vector operatio…
5993 <h3><a class="anchor" id="repage"></a>-repage <var>geometry</var></h3>
5996 <p class="magick-description">Adjust the canvas and offset information of the image.</p>
5998 <p>This option is like <a href="command-line-options.html#page">-page</a> but acts as an image oper…
6002 <p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details abou…
6012 <p>Use <a href="command-line-options.html#repage">+repage</a> to completely remove/reset the virtual
6013 canvas meta-data from the images. </p>
6015 <p>The <a href="command-line-options.html#set">-set</a> '<code>page</code>' option can be used to
6016 directly assign virtual canvas meta-data. </p>
6020 <h3><a class="anchor" id="resample"></a>-resample <var>horizontal</var>x<var>vertical</var></h3>
6023 <p class="magick-description">Resample image to specified horizontal and vertical resolution.</p>
6032 href="command-line-options.html#density">-density</a> on the command line prior to specifying the
6041 <h3><a class="anchor" id="resize"></a>-resize <var>geometry</var></h3>
6044 <p class="magick-description">Resize an image.</p>
6046 <p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details abou…
6047 ignored, and the <a href="command-line-options.html#gravity">-gravity</a> option has no effect.</p>
6049 <p>If the <a href="command-line-options.html#filter">-filter</a> option
6050 or <code>-define filter:option=value</code> precedes the <a
6051 href="command-line-options.html#resize">-resize</a> option, the image is resized with the specified
6054 <p>Many image processing algorithms assume your image is in a linear-light
6055 coding. If your image is gamma-corrected, you can remove the nonlinear gamma
6058 <pre class="highlight"><code>magick portrait.jpg -gamma .45455 -resize 25% -gamma 2.2 \
6059 -quality 92 passport.jpg
6062 …ease of ImageMagick is HDRI-enabled. To eliminate them, add <a href="command-line-options.html#cl…
6065 <h3><a class="anchor" id="respect-parentheses"></a>-respect-parentheses</h3>
6068 <p class="magick-description">Settings remain in effect until parenthesis boundary.</p>
6071 <h3><a class="anchor" id="reverse"></a>-reverse</h3>
6074 <p class="magick-description">Reverse the order of images in the current image list.</p>
6078 …<h3><a class="anchor" id="roll"></a>-roll {<var>+-</var>}<var>x</var>{<var>+-</var>}<var>y</var></…
6081 <p class="magick-description">Roll an image vertically or horizontally by the amount given.</p>
6083 <p>A negative <var>x</var> offset rolls the image right-to-left.
6084 A negative <var>y</var> offset rolls the image bottom-to-top.</p>
6088 …<h3><a class="anchor" id="rotate"></a>-rotate <var>degrees</var>{<var><</var>}{<var>></var>}…
6091 <p class="magick-description">Apply Paeth image rotation (using shear operations) to the image.</p>
6095 than the height. For example, if you specify <code>-rotate "-90>"</code> and
6097 640x480, it is rotated by -90 degrees. If you use <code>></code> or
6104 <p>See also the <a href="command-line-options.html#distort">-distort</a> operator and specifically …
6109 <h3><a class="anchor" id="sample"></a>-sample <var>geometry</var></h3>
6112 <p class="magick-description">Minify / magnify the image with pixel subsampling and pixel replicati…
6116 minifying, pixels are sub-sampled (i.e., some rows and columns are skipped
6119 <p>The results are thus equivalent to using <a href="command-line-options.html#resize">-resize</a> …
6120 a <a href="command-line-options.html#filter">-filter</a> setting of <code>point</code> (nearest
6121 neighbor), though <a href="command-line-options.html#sample">-sample</a> is a lot faster, as it
6123 the current <a href="command-line-options.html#filter">-filter</a> setting. </p>
6125 <p>The key feature of the <a href="command-line-options.html#sample">-sample</a> is that no new col…
6128 <p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details abou…
6129 ignored, unlike <a href="command-line-options.html#resize">-resize</a>. </p>
6132 <p>The actual sampling point is the middle of the sub-region being sampled.
6134 top-left-middle if image has even dimensions). However the <a
6135 href="command-line-options.html#define">-define</a> '<code>sample:offset</code>' can be set to modi…
6136 this position some other location within each sub-region being sampled, as
6140 to '<code>0</code>' for top-left, '<code>100</code>' for bottom-right, or with
6141 separate X and Y offsets such as '<code>0x50</code>' for left-middle edge of
6142 sampling sub-region.</p>
6146 …<h3><a class="anchor" id="sampling-factor"></a>-sampling-factor <var>horizontal-factor</var>x<var>…
6149 <p class="magick-description">Sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encod…
6154 writing the M2V (MPEG-2) format, use <a
6155 href="command-line-options.html#sampling-factor">-sampling-factor 2x1</a> or <a
6156 href="command-line-options.html#sampling-factor">-sampling-factor 4:2:2</a> to specify the 4:2:2
6160 <h3><a class="anchor" id="scale"></a>-scale <var>geometry</var></h3>
6163 <p class="magick-description">Minify / magnify the image with pixel block averaging and pixel repli…
6168 <p>The results are thus equivalent to using <a href="command-line-options.html#resize">-resize</a> …
6169 a <a href="command-line-options.html#filter">-filter</a> setting of <code>box</code>. Though it is…
6171 completely ignores the current <a href="command-line-options.html#filter">-filter</a> setting. </p>
6182 <h3><a class="anchor" id="scene"></a>-scene <var>value</var></h3>
6185 <p class="magick-description">Set scene number.</p>
6190 <h3><a class="anchor" id="screen"></a>-screen</h3>
6193 <p class="magick-description">Specify the screen to capture.</p>
6202 <h3><a class="anchor" id="seed"></a>-seed</h3>
6205 <p class="magick-description">Seed a new sequence of pseudo-random numbers</p>
6208 …<h3><a class="anchor" id="segment"></a>-segment <var>cluster-threshold</var>x<var>smoothing-thresh…
6211 <p class="magick-description">Segment the colors of an image.</p>
6214 identifying units that are homogeneous with the fuzzy c-means technique. This
6223 <p>If the <a href="command-line-options.html#verbose">-verbose</a> setting is defined, a detailed r…
6228 …<h3><a class="anchor" id="selective-blur"></a>-selective-blur <var>radius</var><br />-selective-bl…
6231 <p class="magick-description">Selectively blur pixels within a contrast threshold.</p>
6237 <h3><a class="anchor" id="separate"></a>-separate</h3>
6240 …s="magick-description">Separate an image channel into a grayscale image. Specify the channel with…
6243 <h3><a class="anchor" id="sepia-tone"></a>-sepia-tone <var>percent-threshold</var></h3>
6246 <p class="magick-description">Simulate a sepia-toned photo.</p>
6248 <p>Specify <var>threshold</var> as the percent threshold of the intensity (0 - 99.9%).</p>
6258 <h3><a class="anchor" id="set"></a>-set <var>key value</var></h3>
6262 <p class="magick-description">Sets image attributes and properties for images in the current image …
6265 in the current image sequence. Using the <a href="command-line-options.html#set">+set</a> form of …
6269 <p>For example, it will modify specific well known image meta-data
6271 href="command-line-options.html#delay" >-delay</a>, <a href="command-line-options.html#dispose" >-d…
6272 href="command-line-options.html#page" >-page</a>, <a href="command-line-options.html#colorspace" >-…
6278 'property' string. Such settings are listed in <a href="command-line-options.html#verbose"
6279 >-verbose</a> information ("<code>info:</code>" output format) as "Properties".
6283 using the options <a href="command-line-options.html#comment" >-comment</a>, <a href="command-line-…
6284 >-label</a>, <a href="command-line-options.html#caption" >-caption</a>. These options actually assi…
6288 <pre class="highlight"><code>-> convert rose: -set comment 'Rose is a rose is a rose is a rose' ros…
6289 identify -format %c rose.jpg
6296 <pre class="highlight"><code>-> convert rose: -set origsize '%wx%h' -resize 50% \
6297 -format 'Old size = %[origsize] New size = %wx%h' info:
6305 <p>The <a href="command-line-options.html#repage">-repage</a> operator will also allow you to modify
6307 see <a href="command-line-options.html#repage">-page</a>). However it is designed to provide a fin…
6308 control of the sub-parts of this 'attribute'. The <a href="command-line-options.html#set">-set page…
6315 <pre class="highlight"><code>magick image.psd -set profile ISOcoated_v2_eci.icc image-icc.psd
6322 <pre class="highlight"><code>magick rose: -set filename:mysize '%wx%h' 'rose_%[filename:mysize].png'
6327 href="command-line-options.html#define" >-define</a> option. As such settings are global in scope, …
6332 <pre class="highlight"><code>magick rose: -set option:rosesize '%wx%h' -delete 0 \
6343 <p>The <a href="command-line-options.html#set">-set profile</a> option can also be used to inject
6344 previously-formatted ancillary chunks into the output PNG file, using
6348 <pre class="highlight"><code>magick in.png -set profile PNG-chunk-x:<filename> out.png
6363 <pre class="highlight"><code>magick in.png -set profile PNG-chunk-b01:file01 \
6364 -profile PNG-chunk-b02:file02 out.png
6368 <h3><a class="anchor" id="shade"></a>-shade <var>azimuth</var>x<var>elevation</var></h3>
6371 <p class="magick-description">Shade the image using a distant light source.</p>
6374 the position of the light source. Use <a href="command-line-options.html#shade">+shade</a> to return
6378 … class="anchor" id="shadow"></a>-shadow <var>percent-opacity</var>{x<var>sigma</var>}{<var>+-</var…
6381 <p class="magick-description">Simulate an image shadow.</p>
6385 id="shared-memory"></a>-shared-memory</h3>
6388 <p class="magick-description">Use shared memory.</p>
6392 and the display must support the <var>MIT-SHM</var> extension.
6396 …<h3><a class="anchor" id="sharpen"></a>-sharpen <var>radius</var><br />-sharpen <var>radius</var>{…
6399 <p class="magick-description">Sharpen the image.</p>
6404 <h3><a class="anchor" id="shave"></a>-shave <var>geometry</var></h3>
6407 <p class="magick-description">Shave pixels from the image edges.</p>
6414 <p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details abou…
6417 <h3><a class="anchor" id="shear"></a>-shear <var>Xdegrees</var>[x<var>Ydegrees</var>]</h3>
6420 <p class="magick-description">Shear the image along the x-axis and/or y-axis.</p>
6426 <p>Shearing slides one edge of an image along the x-axis or y-axis (i.e.,
6430 negative y-axis), sliding the top edge to the right when 0°<<var>Xdegrees</var><90° and to th…
6431 positive x-axis), sliding the right edge down when 0°<<var>Ydegrees</var><90° and up when 90°…
6434 defined by the <a href="command-line-options.html#fill">-background</a> option. The color is specif…
6435 using the format described under the <a href="command-line-options.html#fill">-fill</a> option.</p>
6442 <pre class="highlight"><code>magick logo: -shear 20x0 -shear 0x60 logo-sheared.png
6443 convert logo: -shear 0x60 -shear 20x0 logo-sheared.png
6450 <pre class="highlight"><code>magick logo: -shear 20x60 logo-sheared.png
6454 …<h3><a class="anchor" id="sigmoidal-contrast"></a>-sigmoidal-contrast <var>contrast</var>x<var>mid…
6457 <p class="magick-description">Increase the contrast without saturating highlights or shadows.</p>
6465 <p>The <var>mid-point</var> indicates where the maximum change
6467 middle-gray; 100% is black). </p>
6469 <p>By default the image contrast is increased, use <var>+sigmoidal-contrast</var> to decrease the c…
6472 a gamma adjustment), you would use <var>-sigmoidal-contrast
6473 {brightness}x0%</var> to increase brightness and <var>+sigmoidal-contrast {brightness}x0%</var> to …
6474 Note the use of '0' fo rthe mid-point of the sigmoidal curve. </p>
6478 effects) of a true threshold, but with tapered gray-levels around the threshold
6479 <var>mid-point</var>. </p>
6482 <h3><a class="anchor" id="silent"></a>-silent</h3>
6487 <p class="magick-description">Operate silently. This option is only used
6491 <h3><a class="anchor" id="similarity-threshold"></a>-similarity-threshold <var>value</var></h3>
6494 <p class="magick-description">Minimum RMSE for subimage match.</p>
6496 …ff, then the search will proceed to completion or as limited by <var>-dissimilarity-threshold</var…
6499 …<h3><a class="anchor" id="size"></a>-size <var>width</var>[x<var>height</var>][<var>+offset</var>]…
6502 <p class="magick-description">Set the width and height of the image.</p>
6507 href="command-line-options.html#size">-size</a> with an offset to skip any header information in the
6508 image or tell the number of colors in a <code>MAP</code> image file, (e.g. -size
6521 …<h3><a class="anchor" id="sketch"></a>-sketch <var>radius</var><br />-sketch <var>radius</var>{x<v…
6524 <p class="magick-description">Simulate a pencil sketch.</p>
6531 <h3><a class="anchor" id="smush"></a>-smush <var>offset</var></h3>
6534 <p class="magick-description">Appends an image sequence together ignoring transparency.</p>
6536 …-line-options.html#append">-append</a>, joining the images in the sequence top-to-bottom (<a href=…
6540 …-line-options.html#smush">-smush</a> respects <a href="command-line-options.html#gravity">-gravity…
6542 <p>For zero offset and transparent images, the non-transparent parts of the two images will be alig…
6545 <h3><a class="anchor" id="snaps"></a>-snaps <var>value</var></h3>
6548 <p class="magick-description">Set the number of screen snapshots.</p>
6553 <h3><a class="anchor" id="solarize"></a>-solarize <var>percent-threshold</var></h3>
6556 <p class="magick-description">Negate all pixels above the threshold level.</p>
6558 <p>Specify <var>factor</var> as the percent threshold of the intensity (0 - 99.9%).</p>
6564 <h3><a class="anchor" id="sort-pixels"></a>-sort-pixels</h3>
6567 <p class="magick-description">sorts pixels within each scanline in ascending order of intensity.</p>
6570 …<h3><a class="anchor" id="sparse-color"></a>-sparse-color <var>method</var> '<var>x</var>,<var>y<…
6573 <p class="magick-description"> color the given image using the specified points of color, and filli…
6576 <div class="pre-scrollable highlight">
6578 <dt class="col-md-4">barycentric</dt>
6579 <dd class="col-md-8">three point triangle of color given 3 points.
6583 <dt class="col-md-4">bilinear</dt>
6584 <dd class="col-md-8">Like barycentric but for 4 points. Less than 4 points
6586 <dt class="col-md-4">voronoi</dt>
6587 <dd class="col-md-8">Simply map each pixel to the to nearest color point
6589 <dt class="col-md-4">manhattan</dt>
6590 …<dd class="col-md-8">Like voronoi, but resulting polygonal 'cells' are mapped to a fixed coordinat…
6591 <dt class="col-md-4">shepards</dt>
6592 <dd class="col-md-8">Colors points biased on the ratio of inverse distance
6595 <dt class="col-md-4">inverse</dt>
6596 <dd class="col-md-8">Colors points biased on the ratio of inverse distance.
6604 canvas (<a href="command-line-options.html#page" >-page</a> or <a href="command-line-options.html#r…
6609 <p>Only the color channels defined by the <a href="command-line-options.html#channel" >-channel</a>…
6625 <h3><a class="anchor" id="splice"></a>-splice <var>geometry</var></h3>
6628 <p class="magick-description">Splice the current background color into the image.</p>
6631 href="command-line-options.html#background">-background</a> color into the given image according to…
6632 …-line-options.html#gravity">-gravity</a> geometry setting. See <a href="command-line-processing.h…
6638 href="command-line-options.html#gravity">-gravity</a> setting will add rows and columns to the edge…
6640 href="command-line-options.html#splice">-splice</a> is most commonly used for. </p>
6643 href="command-line-options.html#gravity">-gravity</a> is later used with <a href="command-line-opti…
6647 <h3><a class="anchor" id="spread"></a>-spread <var>amount</var></h3>
6650 <p class="magick-description">Displace image pixels by a random amount.</p>
6656 <p>The lookup is controlled by the <a href="command-line-options.html#interpolate">-interpolate</a>…
6659 <h3><a class="anchor" id="statistic"></a>-statistic <var>type</var> <var>geometry</var></h3>
6662 <p class="magick-description">Replace each pixel with corresponding statistic from the neighborhood…
6666 <div class="pre-scrollable highlight">
6668 <dt class="col-md-4">Gradient</dt><dd class="col-md-8">maximum difference (max - min) value in neig…
6669 <dt class="col-md-4">Maximum</dt><dd class="col-md-8">maximum value per channel in neighborhood</dd>
6670 <dt class="col-md-4">Minimum</dt><dd class="col-md-8">minimum value per channel in neighborhood</dd>
6671 <dt class="col-md-4">Mean</dt><dd class="col-md-8">average value per channel in neighborhood</dd>
6672 <dt class="col-md-4">Median</dt><dd class="col-md-8">median value per channel in neighborhood</dd>
6673 <dt class="col-md-4">Mode</dt><dd class="col-md-8">mode (most frequent) value per channel in neighb…
6674 <dt class="col-md-4">Nonpeak</dt><dd class="col-md-8">value just before or after the median value p…
6675 <dt class="col-md-4">RMS</dt><dd class="col-md-8">root mean square value per channel in neighborhoo…
6676 <dt class="col-md-4">StandardDeviation</dt><dd class="col-md-8"> standard deviation value per chann…
6681 <h3><a class="anchor" id="stegano"></a>-stegano <var>offset</var></h3>
6684 <p class="magick-description">Hide watermark within an image.</p>
6688 this information to recover the steganographic image (e.g. display -size
6692 <h3><a class="anchor" id="stereo"></a>-stereo <var>+x</var>{<var>+y</var>}</h3>
6695 <p class="magick-description">Composite two images to create a red / cyan stereo anaglyph.</p>
6697 …e. The right side (first image) is saved as the green and blue channels. Red-green stereo glasses …
6700 <h3><a class="anchor" id="storage-type"></a>-storage-type <var>type</var></h3>
6703 <p class="magick-description">Pixel storage type. Here are the valid types:</p>
6705 <div class="pre-scrollable highlight">
6707 <dt class="col-md-4">char</dt><dd class="col-md-8">unsigned characters</dd>
6708 <dt class="col-md-4">double</dt><dd class="col-md-8">doubles</dd>
6709 <dt class="col-md-4">float</dt><dd class="col-md-8">floats</dd>
6710 <dt class="col-md-4">integer</dt><dd class="col-md-8">integers</dd>
6711 <dt class="col-md-4">long</dt><dd class="col-md-8">longs</dd>
6712 <dt class="col-md-4">quantum</dt><dd class="col-md-8">pixels in the native depth of your ImageMagic…
6713 <dt class="col-md-4">short</dt><dd class="col-md-8">unsigned shorts</dd>
6721 <h3><a class="anchor" id="stretch"></a>-stretch <var>fontStretch</var></h3>
6724 <p class="magick-description">Set a type of stretch style for fonts.</p>
6741 <p>To print a complete list of stretch types, use <a href="command-line-options.html#list">-list
6745 href="command-line-options.html#font">-font</a>, <a href="command-line-options.html#family">-family…
6746 href="command-line-options.html#style">-style</a>, and <a href="command-line-options.html#weight">-…
6749 <h3><a class="anchor" id="strip"></a>-strip</h3>
6752 <p class="magick-description">Strip the image of any profiles, comments or these PNG chunks: bKGD,c…
6755 <h3><a class="anchor" id="stroke"></a>-stroke <var>color</var></h3>
6758 <p class="magick-description">Color to use when stroking a graphic primitive.</p>
6760 …specified using the format described under the <a href="command-line-options.html#fill">-fill</a> …
6762 <p>See <a href="command-line-options.html#draw">-draw</a> for further details.</p>
6765 <h3><a class="anchor" id="strokewidth"></a>-strokewidth <var>value</var></h3>
6768 <p class="magick-description">Set the stroke width.</p>
6770 <p>See <a href="command-line-options.html#draw">-draw</a> for further details.</p>
6773 <h3><a class="anchor" id="style"></a>-style <var>fontStyle</var></h3>
6776 <p class="magick-description">Set a font style for text.</p>
6789 href="command-line-options.html#font">-font</a>, <a href="command-line-options.html#family">-family…
6790 href="command-line-options.html#stretch">-stretch</a>, and <a href="command-line-options.html#weigh…
6793 <h3><a class="anchor" id="subimage-search"></a>-subimage-search</h3>
6796 <p class="magick-description">Search for subimage.</p>
6803 <p>The "match-score" image is smaller containing a pixel for ever possible
6804 position of the top-left corner of the given sub-image. that is its size will
6805 be the size of the larger_image - sub_image + 1. The brightest location in
6811 <p>Note that the search will try to compare the sub-image at every possible
6813 sub-image the faster this search is. </p>
6817 <h3><a class="anchor" id="swap"></a>-swap <var>index,index</var></h3>
6820 <p class="magick-description">Swap the positions of two images in the image sequence.</p>
6822 <p>For example, <a href="command-line-options.html#swap">-swap 0,2</a> swaps the first and the third
6823 images in the current image sequence. Use <a href="command-line-options.html#swap">+swap</a> to swi…
6827 <h3><a class="anchor" id="swirl"></a>-swirl <var>degrees</var></h3>
6830 <p class="magick-description">Swirl image pixels about the center.</p>
6835 <h3><a class="anchor" id="synchronize"></a>-synchronize</h3>
6838 <p class="magick-description">Synchronize image to storage device.</p>
6846 <h3><a class="anchor" id="taint"></a>-taint</h3>
6849 <p class="magick-description">Mark the image as modified.</p>
6852 <h3><a class="anchor" id="text-font"></a>-text-font <var>name</var></h3>
6855 <p class="magick-description">Font for writing fixed-width text.</p>
6865 <h3><a class="anchor" id="texture"></a>-texture <var>filename</var></h3>
6868 <p class="magick-description">Name of texture to tile onto the image background.</p>
6871 <h3><a class="anchor" id="threshold"></a>-threshold <var>value</var>{<var>%</var>}</h3>
6874 <!-- {<var>green,blue,opacity</var>}
6877 a bi-level image. If the opacity threshold is omitted, OpaqueOpacity is used
6879 -->
6881 <p class="magick-description">Apply simultaneous black/white threshold to the image.</p>
6883 …ecifically, those channels set using <a class="text-nowrap" href="command-line-options.html#channe…
6900 <pre class="highlight"><code>magick in.png -channel red -threshold 50% out.png
6904 generate an all-black and an all-white image with the same dimensions as the
6908 <pre class="highlight"><code>magick in.png -channel RGB -threshold 100% black.png
6909 convert in.png -channel RGB -threshold -1 white.png
6912 …-nowrap" href="command-line-options.html#black-threshold">-black-threshold</a> and <a class="text-…
6916 <h3><a class="anchor" id="thumbnail"></a>-thumbnail <var>geometry</var></h3>
6919 <p class="magick-description">Create a thumbnail of the image.</p>
6921 <p>This is similar to <a href="command-line-options.html#resize">-resize</a>, except it is optimized
6924 href="command-line-options.html#strip">-strip</a> just before of after this option.</p>
6926 <p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details abou…
6929 <h3><a class="anchor" id="tile"></a>-tile <var>filename</var></h3>
6932 <p class="magick-description">Set the tile image used for filling a subsequent graphic primitive.</…
6935 <h3>-tile <var>geometry</var></h3>
6938 <p class="magick-description">Specify the layout of images.</p>
6940 <p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details abou…
6943 <h3>-tile</h3>
6946 <p class="magick-description">Specifies that a subsequent composite operation is repeated across an…
6949 …<h3><a class="anchor" id="tile-offset"></a>-tile-offset {<var>+-</var>}<var>x</var>{<var>+-</var>}…
6952 <p class="magick-description">Specify the offset for tile images, relative to the background image …
6954 <p>This should be set before the tiling image is set by <a href="command-line-options.html#tile"
6955 >-tile</a> or <a href="command-line-options.html#texture" >-texture</a>, or directly applied for
6959 <p>Internally ImageMagick does a <a href="command-line-options.html#roll" >-roll</a> of the tile im…
6963 <h3><a class="anchor" id="tint"></a>-tint <var>value</var></h3>
6966 <p class="magick-description">Tint the image with the fill color.</p>
6971 white red, yellow, will not be affected by -tint. Only mid-range colors such
6975 <h3><a class="anchor" id="title"></a>-title <var>string</var></h3>
6978 <p class="magick-description">Assign a title to displayed image.", "animate", "display", "montage</…
6984 under the <a href="command-line-options.html#format">-format</a> option.</p>
6988 <pre class="highlight"><code>-title "%m:%f %wx%h"
6996 <h3><a class="anchor" id="transform"></a>-transform</h3>
6999 <p class="magick-description">Transform the image.</p>
7001 …ies the transformation matrix from a previous <a href="command-line-options.html#affine">-affine</…
7003 <pre class="highlight"><code>magick -affine 2,2,-2,2,0,0 -transform bird.ppm bird.jpg
7008 href="command-line-options.html#distort">-distort</a> '<code>AffineProjection</code>' method. </p>
7012 <h3><a class="anchor" id="transparent"></a>-transparent <var>color</var></h3>
7015 <p class="magick-description">Make this color transparent within the image.</p>
7018 described under the <a href="command-line-options.html#fill">-fill</a> option. The <a href="command…
7019 >-fuzz</a> setting can be used to match and replace colors similar to the one
7022 <p>Use <a href="command-line-options.html#transparent" >+transparent</a> to invert the pixels matc…
7023 that is make all non-matching colors transparent. </p>
7025 <p>The <a href="command-line-options.html#opaque">-opaque</a> operator is exactly the same as <a
7026 href="command-line-options.html#transparent" >-transparent</a> but replaces the matching color with…
7027 current <a href="command-line-options.html#fill">-fill</a> color setting, rather than transparent.
7028 However the <a href="command-line-options.html#transparent" >-transparent</a> operator also ensures
7029 that the image has an alpha channel enabled, as per "<code><a href="command-line-options.html#alpha"
7030 >-alpha</a> set</code>", and does not require you to modify the <a
7031 href="command-line-options.html#channel">-channel</a> to enable alpha channel handling. </p>
7034 used for color-mapped image formats, such as GIF. For that use <a
7035 href="command-line-options.html#transparent-color" >-transparent-color</a> </p>
7039 <h3><a class="anchor" id="transparent-color"></a>-transparent-color <var>color</var></h3>
7042 <p class="magick-description">Set the transparent color.</p>
7048 href="command-line-options.html#transparent">-transparent</a> to make an opaque color transparent.<…
7061 <h3><a class="anchor" id="transpose"></a>-transpose</h3>
7064 <p class="magick-description">Mirror the image along the top-left to bottom-right diagonal.</p>
7066 …ically transposes the pixel array. It is equivalent to the sequence <code>-flip -rotate 90</code>.
7070 <h3><a class="anchor" id="transverse"></a>-transverse</h3>
7073 …p class="magick-description">Mirror the image along the images bottom-left top-right diagonal. Eq…
7077 <h3><a class="anchor" id="treedepth"></a>-treedepth <var>value</var></h3>
7080 <p class="magick-description">Tree depth for the color reduction algorithm.</p>
7092 <p>The <a href="command-line-options.html#colors">-colors</a> or <a href="command-line-options.html…
7097 <h3><a class="anchor" id="trim"></a>-trim</h3>
7100 <p class="magick-description">Trim an image.</p>
7103 pixels. Use <a href="command-line-options.html#fuzz">-fuzz</a> to make <a href="command-line-option…
7107 you to extract the result of the <a href="command-line-options.html#trim">-trim</a> operation from …
7108 image. Use a <a href="command-line-options.html#repage">+repage</a> to remove the virtual canvas p…
7113 <a href="command-line-options.html#crop">-crop</a> operation 'misses' the image proper. </p>
7115 <p>Use <code><a href="command-line-options.html#define">-define</a> trim:percent-background=0%</cod…
7118 50% means an edge can contain up to 50% pixels that are background per the fuzz-factor.</p>
7120 …-line-options.html#define">-define</a> trim:edges={north,east,south,west}</code> separated by comm…
7122 <p>Use <code><a href="command-line-options.html#background">-background</a> <em>background-color</e…
7126 <h3><a class="anchor" id="type"></a>-type <var>type</var></h3>
7129 <p class="magick-description">The image type.</p> <p>Choose from: <code>Bilevel</code>,
7136 href="command-line-options.html#type">-type</a> option can be used to override this behavior. For
7140 <pre class="highlight"><code>magick bird.png -type TrueColor bird.jpg
7143 <p>Similarly, use <a href="command-line-options.html#type">-type TrueColorAlpha</a> to force the
7147 <p>Use <a href="command-line-options.html#type">-type optimize</a> to ensure the image is written i…
7150 <h3><a class="anchor" id="undercolor"></a>-undercolor <var>color</var></h3>
7153 <p class="magick-description">Set the color of the annotation bounding box.</p>
7155 …specified using the format described under the <a href="command-line-options.html#fill">-fill</a> …
7157 <p>See <a href="command-line-options.html#draw">-draw</a> for further details.</p>
7161 <h3><a class="anchor" id="update"></a>-update <var>seconds</var></h3>
7164 <p class="magick-description">Detect when image file is modified and redisplay.</p>
7167 displayed is over-written. <code>display</code> will automagically detect that
7173 <h3><a class="anchor" id="unique-colors"></a>-unique-colors</h3>
7176 <p class="magick-description">Discard all but one of any pixel color.</p>
7180 <h3><a class="anchor" id="units"></a>-units <var>type</var></h3>
7183 <p class="magick-description">The units of image resolution.</p>
7187 with the <a href="command-line-options.html#density">-density</a> option.</p>
7191 …<h3><a class="anchor" id="unsharp"></a>-unsharp <var>radius</var><br />-unsharp <var>radius</var>{…
7194 <p class="magick-description">Sharpen the image with an unsharp mask operator.</p>
7196 <p>The <a href="command-line-options.html#unsharp">-unsharp</a> option sharpens an image. The image…
7203 <div class="pre-scrollable highlight">
7205 <dt class="col-md-4">radius</dt>
7206 <dd class="col-md-8">The radius of the Gaussian, in pixels, not counting the center pixel (default…
7207 <dt class="col-md-4">sigma</dt>
7208 <dd class="col-md-8">The standard deviation of the Gaussian, in pixels (default 1.0).</dd>
7209 <dt class="col-md-4">gain</dt>
7210 <dd class="col-md-8">The fraction of the difference between the original and the blur image that is…
7211 <dt class="col-md-4">threshold</dt>
7212 <dd class="col-md-8">The threshold, as a fraction of <var>QuantumRange</var>, needed to apply the d…
7217 <h3><a class="anchor" id="verbose"></a>-verbose</h3>
7220 …ss="magick-description">Print detailed information about the image when this option precedes the <…
7224 <h3><a class="anchor" id="version"></a>-version</h3>
7227 <p class="magick-description">Print ImageMagick version string and exit.</p>
7231 <h3><a class="anchor" id="view"></a>-view <var>string</var></h3>
7234 <p class="magick-description">FlashPix viewing parameters.</p>
7238 …<a class="anchor" id="vignette"></a>-vignette <var>radius</var>{x<var>sigma</var>}{<var>+-</var>}<…
7241 <p class="magick-description">Soften the edges of the image in vignette style.</p>
7246 <h3><a class="anchor" id="virtual-pixel"></a>-virtual-pixel <var>method</var></h3>
7249 <p class="magick-description">Specify contents of <var>virtual pixels</var>.</p>
7258 <div class="pre-scrollable highlight">
7260 <dt class="col-md-4">background</dt><dd class="col-md-8">the area surrounding the image is the back…
7261 <dt class="col-md-4">black</dt><dd class="col-md-8">the area surrounding the image is black</dd>
7262 <dt class="col-md-4">checker-tile</dt><dd class="col-md-8">alternate squares with image and backgro…
7263 <dt class="col-md-4">dither</dt><dd class="col-md-8">non-random 32x32 dithered pattern</dd>
7264 <dt class="col-md-4">edge</dt><dd class="col-md-8">extend the edge pixel toward infinity</dd>
7265 <dt class="col-md-4">gray</dt><dd class="col-md-8">the area surrounding the image is gray</dd>
7266 <dt class="col-md-4">horizontal-tile</dt><dd class="col-md-8">horizontally tile the image, backgrou…
7267 <dt class="col-md-4">horizontal-tile-edge</dt><dd class="col-md-8">horizontally tile the image and …
7268 <dt class="col-md-4">mirror</dt><dd class="col-md-8">mirror tile the image</dd>
7269 <dt class="col-md-4">random</dt><dd class="col-md-8">choose a random pixel from the image</dd>
7270 <dt class="col-md-4">tile</dt><dd class="col-md-8">tile the image (default)</dd>
7271 <dt class="col-md-4">transparent</dt><dd class="col-md-8">the area surrounding the image is transpa…
7272 <dt class="col-md-4">vertical-tile</dt><dd class="col-md-8">vertically tile the image, sides are ba…
7273 <dt class="col-md-4">vertical-tile-edge</dt><dd class="col-md-8">vertically tile the image and repl…
7274 <dt class="col-md-4">white</dt><dd class="col-md-8">the area surrounding the image is white</dd>
7280 <p>This most important for distortion operators such as <a href="command-line-options.html#distort"
7281 >-distort</a>, <a href="command-line-options.html#implode" >-implode</a>, and <a href="command-line…
7283 image proper, such as <a href="command-line-options.html#convolve">-convolve</a>, <a
7284 href="command-line-options.html#blur">-blur</a>, and <a href="command-line-options.html#sharpen">-s…
7287 href="command-line-options.html#list">-list virtual-pixel</a> option.</p>
7291 <h3><a class="anchor" id="visual"></a>-visual <var>type</var></h3>
7294 <p class="magick-description">Animate images using this X visual type.", 'animate', 'display'</p>
7310 …<h3><a class="anchor" id="watermark"></a>-watermark <var>brightness</var>x<var>saturation</var></h…
7313 <p class="magick-description">Watermark an image using the given percentages of brightness and satu…
7323 …<h3><a class="anchor" id="wave"></a>-wave <var>amplitude</var><br />-wave <var>amplitude</var>x<va…
7326 <p class="magick-description">Shear the columns of an image into a sine wave.</p>
7329 …<h3><a class="anchor" id="wavelet-denoise"></a>-wavelet-denoise <var>threshold</var><br />-wavelet…
7332 <p class="magick-description">Removes noise from the image using a wavelet transform. The threshol…
7335 <h3><a class="anchor" id="weight"></a>-weight <var>fontWeight</var></h3>
7338 <p class="magick-description">Set a font weight for text.</p>
7344 <div class="pre-scrollable highlight">
7346 <dt class="col-md-4">Thin </dt>
7347 <dd class="col-md-8">Same as <var>fontWeight</var> = 100.</dd>
7348 <dt class="col-md-4">ExtraLight </dt>
7349 <dd class="col-md-8">Same as <var>fontWeight</var> = 200.</dd>
7350 <dt class="col-md-4">Light </dt>
7351 <dd class="col-md-8">Same as <var>fontWeight</var> = 300.</dd>
7352 <dt class="col-md-4">Normal </dt>
7353 <dd class="col-md-8">Same as <var>fontWeight</var> = 400.</dd>
7354 <dt class="col-md-4">Medium </dt>
7355 <dd class="col-md-8">Same as <var>fontWeight</var> = 500.</dd>
7356 <dt class="col-md-4">DemiBold </dt>
7357 <dd class="col-md-8">Same as <var>fontWeight</var> = 600.</dd>
7358 <dt class="col-md-4">Bold </dt>
7359 <dd class="col-md-8">Same as <var>fontWeight</var> = 700.</dd>
7360 <dt class="col-md-4">ExtraBold </dt>
7361 <dd class="col-md-8">Same as <var>fontWeight</var> = 800.</dd>
7362 <dt class="col-md-4">Heavy </dt>
7363 <dd class="col-md-8">Same as <var>fontWeight</var> = 900.</dd>
7368 <p>To print a complete list of weight types, use <a href="command-line-options.html#list">-list wei…
7371 href="command-line-options.html#font">-font</a>, <a href="command-line-options.html#family">-family…
7372 href="command-line-options.html#stretch">-stretch</a>, and <a href="command-line-options.html#style…
7375 <h3><a class="anchor" id="white-balance"></a>-white-balance</h3>
7378 <p>Use <kbd>-define white-balance:vibrance=<em>value{%}</em></kdb> to change the color vibrance of …
7381 <h3><a class="anchor" id="white-point"></a>-white-point <var>x,y</var></h3>
7384 <p class="magick-description">Chromaticity white point.</p>
7387 …<h3><a class="anchor" id="white-threshold"></a>-white-threshold <var>value</var>{<var>%</var>}</h3>
7390 <p class="magick-description">Force to white all pixels above the threshold while leaving all pixel…
7394 …="text-nowrap" href="command-line-options.html#channel">-channel</a> value. See <a class="text-now…
7397 <h3><a class="anchor" id="window"></a>-window <var>id</var></h3>
7400 <p class="magick-description">Make the image the background of a window.", 'animate', 'display'</p>
7406 <code>backdrop</code> or <a href="command-line-options.html#geometry">-resize</a> are specified, the
7412 href="command-line-options.html#colors">-colors</a> to reduce the number of colors.</p>
7415 <h3><a class="anchor" id="window-group"></a>-window-group</h3>
7418 <p class="magick-description">Specify the window group.</p>
7421 <h3><a class="anchor" id="write"></a>-write <var>filename</var></h3>
7424 <p class="magick-description">Write an image sequence.</p>
7426 …-line-options.html#write">-write</a> <var>filename</var> option is written out, and processing con…
7428 <p>Use <a href="command-line-options.html#compress">-compress</a> to specify the type of image comp…
7431 <h3><a class="anchor" id="write-mask"></a>-write-mask <var>filename</var></h3>
7434 <p class="magick-description">Prevent updates to image pixels specified by the mask.</p>
7440 <p>Use <a href="command-line-options.html#write-mask">+write-mask</a> to remove the mask from image…
7442 <p>Also see <a href="command-line-options.html#clip-mask">-clip-mask</a> which work in the same way,
7447 </main><!-- /.container -->
7448 <footer class="magick-footer">
7449 <div class="container-fluid">
7450 <a href="security-policy.html">Security</a> •
7453 …<a href="command-line-options.html#"><img class="d-inline" id="wand" alt="And Now a Touch of Magic…
7463 …-label="GitHub"><svg xmlns="http://www.w3.org/2000/svg" class="navbar-nav-svg" viewBox="0 0 512 49…
7464 …-label="Twitter"><svg xmlns="http://www.w3.org/2000/svg" class="navbar-nav-svg" viewBox="0 0 512 4…
7466 <small>© 1999-2021 ImageMagick Studio LLC</small>
7470 <!-- Javascript assets -->
7474 <!-- Magick Cache 13th February 2021 11:48 -->