-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
- "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
-<html version="-//W3C//DTD XHTML 1.1//EN"
- xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://www.w3.org/1999/xhtml
- http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">
+<!DOCTYPE html>
+<html lang="en">
<head>
- <meta http-equiv="content-type" content="text/html; charset=UTF-8"/>
- <meta name=viewport content="width=device-width, initial-scale=0.3333334">
- <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4"/>
- <title>ImageMagick: Command-line Options</title>
- <meta http-equiv="content-language" content="en-US"/>
- <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
- <meta http-equiv="reply-to" content="magick-users@imagemagick.org"/>
- <meta name="application-name" content="ImageMagick"/>
- <meta name="description" content="A collection of tools and libraries to read, write, and manipulate an image in any of the more popular image formats."/>
- <meta name="application-url" content="http://www.imagemagick.org"/>
- <meta name="generator" content="PHP"/>
- <meta name="keywords" content="command-line, options, convert, edit, compose, image, pixel"/>
- <meta name="rating" content="GENERAL"/>
- <meta name="robots" content="INDEX, FOLLOW"/>
- <meta name="generator" content="ImageMagick Studio LLC"/>
- <meta name="author" content="ImageMagick Studio LLC"/>
- <meta name="revisit-after" content="2 DAYS"/>
- <meta name="resource-type" content="document"/>
- <meta name="copyright" content="Copyright (c) 1999-2012 ImageMagick Studio LLC"/>
- <meta name="distribution" content="Global"/>
- <link rel="icon" href="../images/wand.png"/>
- <link rel="shortcut icon" href="../images/wand.ico" type="images/x-icon"/>
- <link rel="canonical" href="http://www.imagemagick.org" />
- <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
-
- <!-- Add jQuery library -->
- <script type="text/javascript" src="http://localhost/ajax/libs/jquery/2.1.0/jquery.min.js"></script>
-
- <!-- Add mousewheel plugin (this is optional) -->
- <script type="text/javascript" src="http://www.imagemagick.org/fancybox/lib/jquery.mousewheel-3.0.6.pack.js"></script>
-
- <!-- Add fancyBox -->
- <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/jquery.fancybox.css?v=2.1.5" type="text/css" media="screen" />
- <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/jquery.fancybox.pack.js?v=2.1.5"></script>
-
- <!-- Optionally add helpers - button, thumbnail and/or media -->
- <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-buttons.css?v=1.0.5" type="text/css" media="screen" />
- <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-buttons.js?v=1.0.5"></script>
- <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-media.js?v=1.0.6"></script>
-
- <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-thumbs.css?v=1.0.7" type="text/css" media="screen" />
- <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-thumbs.js?v=1.0.7"></script>
-
- <script type="text/javascript">
- $(document).ready(function() {
- $(".fancybox").fancybox();
- });
- </script>
-
- <!-- ImageMagick style -->
- <style type="text/css" media="all">
- @import url("../www/magick.css");
- </style>
+ <meta charset="utf-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no" />
+ <title>Command-line Options @ ImageMagick</title>
+ <meta name="application-name" content="ImageMagick" />
+ <meta name="description" content="ImageMagick® is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves." />
+ <meta name="application-url" content="https://www.imagemagick.org" />
+ <meta name="generator" content="PHP" />
+ <meta name="keywords" content="command-line, options, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert" />
+ <meta name="rating" content="GENERAL" />
+ <meta name="robots" content="INDEX, FOLLOW" />
+ <meta name="generator" content="ImageMagick Studio LLC" />
+ <meta name="author" content="ImageMagick Studio LLC" />
+ <meta name="revisit-after" content="2 DAYS" />
+ <meta name="resource-type" content="document" />
+ <meta name="copyright" content="Copyright (c) 1999-2017 ImageMagick Studio LLC" />
+ <meta name="distribution" content="Global" />
+ <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1" />
+ <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
+ <link href="../www/command-line-options.html" rel="canonical" />
+ <link href="../images/wand.png" rel="icon" />
+ <link href="../images/wand.ico" rel="shortcut icon" />
+ <link href="assets/magick.css" rel="stylesheet" />
</head>
-
-<body id="www-imagemagick-org">
-
-<script type="text/javascript">
- (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
- (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
- m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
- })(window,document,'offline-script','//www.google-analytics.com/analytics.js','ga');
-
- ga('create', 'UA-40133312-1', 'imagemagick.org');
- ga('send', 'pageview');
-</script>
-
-<div class="titlebar">
-<div style="margin: 17px auto; float: left;">
- <script type="text/javascript">
- <!--
- google_ad_client = "pub-3129977114552745";
- google_ad_slot = "5439289906";
- google_ad_width = 728;
- google_ad_height = 90;
- //-->
- </script>
- <script type="text/javascript"
- src="http://localhost/pagead/show_ads.js">
- </script>
-</div>
-<a href="../discourse-server">
- <img src="../images/logo.jpg"
- alt="ImageMagick Logo" width="123" height="118"
- style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
-<a href="http://www.imagemagick.org/ImageMagick-7.0.0/index.html">
- <img src="../images/sprite.jpg"
- alt="ImageMagick Sprite" width="114" height="118"
- style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
-</div>
-
-<div class="westbar">
-
-<div class="menu">
- <a title="About ImageMagick" href="http://www.imagemagick.org/ImageMagick-7.0.0/index.html">About ImageMagick</a>
-</div>
-<div class="menu">
- <a title="Binary Releases" href="binary-releases.html">Binary Releases</a>
-</div>
-<div class="sub">
- <a title="Binary Release: Unix" href="binary-releases.html#unix">Unix</a>
-</div>
-<div class="sub">
- <a title="Binary Release: MacOS X" href="binary-releases.html#macosx">Mac OS X</a>
-</div>
-<div class="sub">
- <a title="Binary Release: iOS" href="binary-releases.html#iOS">iOS</a>
-</div>
-<div class="sub">
- <a title="Binary Release: Windows" href="binary-releases.html#windows">Windows</a>
-</div>
-<div class="sep"></div>
-<div class="menu">
- <a title="Command-line Tools" href="command-line-tools.html">Command-line Tools</a>
-</div>
-<div class="sub">
- <a title="Command-line Tools: Processing" href="command-line-processing.html">Processing</a>
-</div>
-<div class="sub">
- <a title="Command-line Tools: Options" href="command-line-options.html">Options</a>
-</div>
-<div class="sub">
- <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
-</div>
-<div class="menu">
- <a title="Program Interfaces" href="api.html">Program Interfaces</a>
-</div>
-<div class="sub">
- <a title="Program Interface: MagickWand" href="magick-wand.html">MagickWand</a>
-</div>
-<div class="sub">
- <a title="Program Interface: MagickCore" href="magick-core.html">MagickCore</a>
-</div>
-<div class="sub">
- <a title="Program Interface: PerlMagick" href="perl-magick.html">PerlMagick</a>
-</div>
-<div class="sub">
- <a title="Program Interface: Magick++" href="magick++.html">Magick++</a>
-</div>
-<div class="sep"></div>
-<div class="menu">
- <a title="Install from Source" href="install-source.html">Install from Source</a>
-</div>
-<div class="sub">
- <a title="Install from Source: Unix" href="install-source.html#unix">Unix</a>
-</div>
-<div class="sub">
- <a title="Install from Source: Windows" href="install-source.html#windows">Windows</a>
- </div>
-<div class="menu">
- <a title="Resources" href="resources.html">Resources</a>
-</div>
-<div class="menu">
- <a title="Architecture" href="architecture.html">Architecture</a>
-</div>
-<div class="menu">
- <a title="Download" href="download.html">Download</a>
-</div>
-<div class="sep"></div>
-<div class="menu">
- <a title="Search" href="search.html">Search</a>
-</div>
-<div class="sep"></div>
-<div class="menu">
- <a title="Site Map" href="sitemap.html">Site Map</a>
-</div>
-<div class="sub">
- <a title="Site Map: Links" href="links.html">Links</a>
-</div>
-<div class="sep"></div>
-</div>
-
-<div class="eastbar">
- <script type="text/javascript">
- /* <![CDATA[ */
- window.___gcfg = {
- lang: 'en-US'
- };
-
- (function() {
- var po = document.createElement('offline-script');
- po.type = 'text/javascript';
- po.async = true;
- po.src = 'https://apis.google.com/js/plusone.js';
- var script = document.getElementsByTagName('offline-script')[0];
- script.parentNode.insertBefore(po, script);
- })();
- var gplusone = document.getElementById("gplusone");
- gplusone.setAttribute("data-size","medium");
- gplusone.setAttribute("data-count","true");
- /* ]]> */
- </script>
- <script type="text/javascript">
- /* <![CDATA[ */
- (function() {
- var po = document.createElement('offline-script'), t = document.getElementsByTagName('offline-script')[0];
- po.type = 'text/javascript';
- po.async = true;
- po.src = 'http://api.flattr.com/js/0.6/load.js?mode=auto';
- var script = document.getElementsByTagName('offline-script')[0];
- script.parentNode.insertBefore(po, script);
- })();
- /* ]]> */
- </script>
- <div> <a class="FlattrButton" style="display:none;" rev="flattr;button:compact;" href="http://www.imagemagick.org/"></a></div>
- <noscript>
- <a href="http://flattr.com/thing/947300/Convert-Edit-And-Compose-Images" target="_blank">
- <img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr this" title="Flattr this" width="93" height="20" border="0" /></a>
- </noscript>
- <div class="g-plusone" data-size="standard" data-count="true"></div>
-</div>
-
-<div class="main">
-
-<h1>Command-line Options</h1>
-<p class="navigation-index">
-[ <a href="command-line-options.html#adaptive-blur">‑adaptive‑blur</a> <span class='bull'> • </span> <a href="command-line-options.html#adaptive-resize">‑adaptive‑resize</a> <span class='bull'> • </span> <a href="command-line-options.html#adaptive-sharpen">‑adaptive‑sharpen</a> <span class='bull'> • </span> <a href="command-line-options.html#adjoin">‑adjoin</a> <span class='bull'> • </span> <a href="command-line-options.html#affine">‑affine</a> <span class='bull'> • </span> <a href="command-line-options.html#alpha">‑alpha</a> <span class='bull'> • </span> <a href="command-line-options.html#annotate">‑annotate</a> <span class='bull'> • </span> <a href="command-line-options.html#antialias">‑antialias</a> <span class='bull'> • </span> <a href="command-line-options.html#append">‑append</a> <span class='bull'> • </span> <a href="command-line-options.html#attenuate">‑attenuate</a> <span class='bull'> • </span> <a href="command-line-options.html#authenticate">‑authenticate</a> <span class='bull'> • </span> <a href="command-line-options.html#auto-gamma">‑auto‑gamma</a> <span class='bull'> • </span> <a href="command-line-options.html#auto-level">‑auto‑level</a> <span class='bull'> • </span> <a href="command-line-options.html#auto-orient">‑auto‑orient</a> <span class='bull'> • </span> <a href="command-line-options.html#backdrop">‑backdrop</a> <span class='bull'> • </span> <a href="command-line-options.html#background">‑background</a> <span class='bull'> • </span> <a href="command-line-options.html#bench">‑bench</a> <span class='bull'> • </span> <a href="command-line-options.html#bias">‑bias</a> <span class='bull'> • </span> <a href="command-line-options.html#black-point-compensation">‑black‑point‑compensation</a> <span class='bull'> • </span> <a href="command-line-options.html#black-threshold">‑black‑threshold</a> <span class='bull'> • </span> <a href="command-line-options.html#blend">‑blend</a> <span class='bull'> • </span> <a href="command-line-options.html#blue-primary">‑blue‑primary</a> <span class='bull'> • </span> <a href="command-line-options.html#blue-shift">‑blue‑shift</a> <span class='bull'> • </span> <a href="command-line-options.html#blur">‑blur</a> <span class='bull'> • </span> <a href="command-line-options.html#border">‑border</a> <span class='bull'> • </span> <a href="command-line-options.html#bordercolor">‑bordercolor</a> <span class='bull'> • </span> <a href="command-line-options.html#borderwidth">‑borderwidth</a> <span class='bull'> • </span> <a href="command-line-options.html#brightness-contrast">‑brightness‑contrast</a> <span class='bull'> • </span> <a href="command-line-options.html#cache">‑cache</a> <span class='bull'> • </span> <a href="command-line-options.html#canny">‑canny</a> <span class='bull'> • </span> <a href="command-line-options.html#caption">‑caption</a> <span class='bull'> • </span> <a href="command-line-options.html#cdl">‑cdl</a> <span class='bull'> • </span> <a href="command-line-options.html#channel">‑channel</a> <span class='bull'> • </span> <a href="command-line-options.html#charcoal">‑charcoal</a> <span class='bull'> • </span> <a href="command-line-options.html#chop">‑chop</a> <span class='bull'> • </span> <a href="command-line-options.html#clamp">‑clamp</a> <span class='bull'> • </span> <a href="command-line-options.html#clip">‑clip</a> <span class='bull'> • </span> <a href="command-line-options.html#clip-mask">‑clip‑mask</a> <span class='bull'> • </span> <a href="command-line-options.html#clip-path">‑clip‑path</a> <span class='bull'> • </span> <a href="command-line-options.html#clone">‑clone</a> <span class='bull'> • </span> <a href="command-line-options.html#clut">‑clut</a> <span class='bull'> • </span> <a href="command-line-options.html#coalesce">‑coalesce</a> <span class='bull'> • </span> <a href="command-line-options.html#colorize">‑colorize</a> <span class='bull'> • </span> <a href="command-line-options.html#colormap">‑colormap</a> <span class='bull'> • </span> <a href="command-line-options.html#color-matrix">‑color‑matrix</a> <span class='bull'> • </span> <a href="command-line-options.html#colors">‑colors</a> <span class='bull'> • </span> <a href="command-line-options.html#colorspace">‑colorspace</a> <span class='bull'> • </span> <a href="command-line-options.html#combine">‑combine</a> <span class='bull'> • </span> <a href="command-line-options.html#comment">‑comment</a> <span class='bull'> • </span> <a href="command-line-options.html#compare">‑compare</a> <span class='bull'> • </span> <a href="command-line-options.html#complex">‑complex</a> <span class='bull'> • </span> <a href="command-line-options.html#compose">‑compose</a> <span class='bull'> • </span> <a href="command-line-options.html#composite">‑composite</a> <span class='bull'> • </span> <a href="command-line-options.html#compress">‑compress</a> <span class='bull'> • </span> <a href="command-line-options.html#connected-components">‑connected‑components</a> <span class='bull'> • </span> <a href="command-line-options.html#contrast">‑contrast</a> <span class='bull'> • </span> <a href="command-line-options.html#contrast-stretch">‑contrast‑stretch</a> <span class='bull'> • </span> <a href="command-line-options.html#convolve">‑convolve</a> <span class='bull'> • </span> <a href="command-line-options.html#crop">‑crop</a> <span class='bull'> • </span> <a href="command-line-options.html#cycle">‑cycle</a> <span class='bull'> • </span> <a href="command-line-options.html#debug">‑debug</a> <span class='bull'> • </span> <a href="command-line-options.html#decipher">‑decipher</a> <span class='bull'> • </span> <a href="command-line-options.html#deconstruct">‑deconstruct</a> <span class='bull'> • </span> <a href="command-line-options.html#define">‑define</a> <span class='bull'> • </span> <a href="command-line-options.html#delay">‑delay</a> <span class='bull'> • </span> <a href="command-line-options.html#delete">‑delete</a> <span class='bull'> • </span> <a href="command-line-options.html#density">‑density</a> <span class='bull'> • </span> <a href="command-line-options.html#depth">‑depth</a> <span class='bull'> • </span> <a href="command-line-options.html#descend">‑descend</a> <span class='bull'> • </span> <a href="command-line-options.html#deskew">‑deskew</a> <span class='bull'> • </span> <a href="command-line-options.html#despeckle">‑despeckle</a> <span class='bull'> • </span> <a href="command-line-options.html#direction">‑direction</a> <span class='bull'> • </span> <a href="command-line-options.html#displace">‑displace</a> <span class='bull'> • </span> <a href="command-line-options.html#display">‑display</a> <span class='bull'> • </span> <a href="command-line-options.html#dispose">‑dispose</a> <span class='bull'> • </span> <a href="command-line-options.html#dissimilarity-threshold">‑dissimilarity‑threshold</a> <span class='bull'> • </span> <a href="command-line-options.html#dissolve">‑dissolve</a> <span class='bull'> • </span> <a href="command-line-options.html#distort">‑distort</a> <span class='bull'> • </span> <a href="command-line-options.html#distribute-cache">‑distribute‑cache</a> <span class='bull'> • </span> <a href="command-line-options.html#dither">‑dither</a> <span class='bull'> • </span> <a href="command-line-options.html#draw">‑draw</a> <span class='bull'> • </span> <a href="command-line-options.html#duplicate">‑duplicate</a> <span class='bull'> • </span> <a href="command-line-options.html#edge">‑edge</a> <span class='bull'> • </span> <a href="command-line-options.html#emboss">‑emboss</a> <span class='bull'> • </span> <a href="command-line-options.html#encipher">‑encipher</a> <span class='bull'> • </span> <a href="command-line-options.html#encoding">‑encoding</a> <span class='bull'> • </span> <a href="command-line-options.html#endian">‑endian</a> <span class='bull'> • </span> <a href="command-line-options.html#enhance">‑enhance</a> <span class='bull'> • </span> <a href="command-line-options.html#equalize">‑equalize</a> <span class='bull'> • </span> <a href="command-line-options.html#evaluate">‑evaluate</a> <span class='bull'> • </span> <a href="command-line-options.html#evaluate-sequence">‑evaluate‑sequence</a> <span class='bull'> • </span> <a href="command-line-options.html#extent">‑extent</a> <span class='bull'> • </span> <a href="command-line-options.html#extract">‑extract</a> <span class='bull'> • </span> <a href="command-line-options.html#family">‑family</a> <span class='bull'> • </span> <a href="command-line-options.html#features">‑features</a> <span class='bull'> • </span> <a href="command-line-options.html#fft">‑fft</a> <span class='bull'> • </span> <a href="command-line-options.html#fill">‑fill</a> <span class='bull'> • </span> <a href="command-line-options.html#filter">‑filter</a> <span class='bull'> • </span> <a href="command-line-options.html#flatten">‑flatten</a> <span class='bull'> • </span> <a href="command-line-options.html#flip">‑flip</a> <span class='bull'> • </span> <a href="command-line-options.html#floodfill">‑floodfill</a> <span class='bull'> • </span> <a href="command-line-options.html#flop">‑flop</a> <span class='bull'> • </span> <a href="command-line-options.html#font">‑font</a> <span class='bull'> • </span> <a href="command-line-options.html#foreground">‑foreground</a> <span class='bull'> • </span> <a href="command-line-options.html#format">‑format</a> <span class='bull'> • </span> <a href="command-line-options.html#format_identify_">‑format[identify]</a> <span class='bull'> • </span> <a href="command-line-options.html#frame">‑frame</a> <span class='bull'> • </span> <a href="command-line-options.html#frame_import_">‑frame[import]</a> <span class='bull'> • </span> <a href="command-line-options.html#function">‑function</a> <span class='bull'> • </span> <a href="command-line-options.html#fuzz">‑fuzz</a> <span class='bull'> • </span> <a href="command-line-options.html#fx">‑fx</a> <span class='bull'> • </span> <a href="command-line-options.html#gamma">‑gamma</a> <span class='bull'> • </span> <a href="command-line-options.html#gaussian-blur">‑gaussian‑blur</a> <span class='bull'> • </span> <a href="command-line-options.html#geometry">‑geometry</a> <span class='bull'> • </span> <a href="command-line-options.html#gravity">‑gravity</a> <span class='bull'> • </span> <a href="command-line-options.html#grayscale">‑grayscale</a> <span class='bull'> • </span> <a href="command-line-options.html#green-primary">‑green‑primary</a> <span class='bull'> • </span> <a href="command-line-options.html#hald-clut">‑hald‑clut</a> <span class='bull'> • </span> <a href="command-line-options.html#help">‑help</a> <span class='bull'> • </span> <a href="command-line-options.html#highlight-color">‑highlight‑color</a> <span class='bull'> • </span> <a href="command-line-options.html#hough-lines">‑hough‑lines</a> <span class='bull'> • </span> <a href="command-line-options.html#iconGeometry">‑iconGeometry</a> <span class='bull'> • </span> <a href="command-line-options.html#iconic">‑iconic</a> <span class='bull'> • </span> <a href="command-line-options.html#identify">‑identify</a> <span class='bull'> • </span> <a href="command-line-options.html#ift">‑ift</a> <span class='bull'> • </span> <a href="command-line-options.html#immutable">‑immutable</a> <span class='bull'> • </span> <a href="command-line-options.html#implode">‑implode</a> <span class='bull'> • </span> <a href="command-line-options.html#insert">‑insert</a> <span class='bull'> • </span> <a href="command-line-options.html#intensity">‑intensity</a> <span class='bull'> • </span> <a href="command-line-options.html#intent">‑intent</a> <span class='bull'> • </span> <a href="command-line-options.html#interlace">‑interlace</a> <span class='bull'> • </span> <a href="command-line-options.html#interpolate">‑interpolate</a> <span class='bull'> • </span> <a href="command-line-options.html#interline-spacing">‑interline‑spacing</a> <span class='bull'> • </span> <a href="command-line-options.html#interword-spacing">‑interword‑spacing</a> <span class='bull'> • </span> <a href="command-line-options.html#kerning">‑kerning</a> <span class='bull'> • </span> <a href="command-line-options.html#kuwahara">‑kuwahara</a> <span class='bull'> • </span> <a href="command-line-options.html#label">‑label</a> <span class='bull'> • </span> <a href="command-line-options.html#lat">‑lat</a> <span class='bull'> • </span> <a href="command-line-options.html#layers">‑layers</a> <span class='bull'> • </span> <a href="command-line-options.html#level">‑level</a> <span class='bull'> • </span> <a href="command-line-options.html#level-colors">‑level‑colors</a> <span class='bull'> • </span> <a href="command-line-options.html#limit">‑limit</a> <span class='bull'> • </span> <a href="command-line-options.html#linear-stretch">‑linear‑stretch</a> <span class='bull'> • </span> <a href="command-line-options.html#linewidth">‑linewidth</a> <span class='bull'> • </span> <a href="command-line-options.html#liquid-rescale">‑liquid‑rescale</a> <span class='bull'> • </span> <a href="command-line-options.html#list">‑list</a> <span class='bull'> • </span> <a href="command-line-options.html#log">‑log</a> <span class='bull'> • </span> <a href="command-line-options.html#loop">‑loop</a> <span class='bull'> • </span> <a href="command-line-options.html#lowlight-color">‑lowlight‑color</a> <span class='bull'> • </span> <a href="command-line-options.html#magnify">‑magnify</a> <span class='bull'> • </span> <a href="command-line-options.html#map">‑map</a> <span class='bull'> • </span> <a href="command-line-options.html#map_stream_">‑map[stream]</a> <span class='bull'> • </span> <a href="command-line-options.html#mask">‑mask</a> <span class='bull'> • </span> <a href="command-line-options.html#mattecolor">‑mattecolor</a> <span class='bull'> • </span> <a href="command-line-options.html#median">‑median</a> <span class='bull'> • </span> <a href="command-line-options.html#mean-shift">‑mean‑shift</a> <span class='bull'> • </span> <a href="command-line-options.html#metric">‑metric</a> <span class='bull'> • </span> <a href="command-line-options.html#mode">‑mode</a> <span class='bull'> • </span> <a href="command-line-options.html#modulate">‑modulate</a> <span class='bull'> • </span> <a href="command-line-options.html#moments">‑moments</a> <span class='bull'> • </span> <a href="command-line-options.html#monitor">‑monitor</a> <span class='bull'> • </span> <a href="command-line-options.html#monochrome">‑monochrome</a> <span class='bull'> • </span> <a href="command-line-options.html#morph">‑morph</a> <span class='bull'> • </span> <a href="command-line-options.html#morphology">‑morphology</a> <span class='bull'> • </span> <a href="command-line-options.html#mosaic">‑mosaic</a> <span class='bull'> • </span> <a href="command-line-options.html#motion-blur">‑motion‑blur</a> <span class='bull'> • </span> <a href="command-line-options.html#name">‑name</a> <span class='bull'> • </span> <a href="command-line-options.html#negate">‑negate</a> <span class='bull'> • </span> <a href="command-line-options.html#noise">‑noise</a> <span class='bull'> • </span> <a href="command-line-options.html#normalize">‑normalize</a> <span class='bull'> • </span> <a href="command-line-options.html#opaque">‑opaque</a> <span class='bull'> • </span> <a href="command-line-options.html#ordered-dither">‑ordered‑dither</a> <span class='bull'> • </span> <a href="command-line-options.html#orient">‑orient</a> <span class='bull'> • </span> <a href="command-line-options.html#page">‑page</a> <span class='bull'> • </span> <a href="command-line-options.html#paint">‑paint</a> <span class='bull'> • </span> <a href="command-line-options.html#path">‑path</a> <span class='bull'> • </span> <a href="command-line-options.html#pause_animate_">‑pause[animate]</a> <span class='bull'> • </span> <a href="command-line-options.html#pause_import_">‑pause[import]</a> <span class='bull'> • </span> <a href="command-line-options.html#perceptible">‑perceptible</a> <span class='bull'> • </span> <a href="command-line-options.html#ping">‑ping</a> <span class='bull'> • </span> <a href="command-line-options.html#pointsize">‑pointsize</a> <span class='bull'> • </span> <a href="command-line-options.html#polaroid">‑polaroid</a> <span class='bull'> • </span> <a href="command-line-options.html#poly">‑poly</a> <span class='bull'> • </span> <a href="command-line-options.html#posterize">‑posterize</a> <span class='bull'> • </span> <a href="command-line-options.html#precision">‑precision</a> <span class='bull'> • </span> <a href="command-line-options.html#preview">‑preview</a> <span class='bull'> • </span> <a href="command-line-options.html#print">‑print</a> <span class='bull'> • </span> <a href="command-line-options.html#process">‑process</a> <span class='bull'> • </span> <a href="command-line-options.html#profile">‑profile</a> <span class='bull'> • </span> <a href="command-line-options.html#quality">‑quality</a> <span class='bull'> • </span> <a href="command-line-options.html#quantize">‑quantize</a> <span class='bull'> • </span> <a href="command-line-options.html#quiet">‑quiet</a> <span class='bull'> • </span> <a href="command-line-options.html#radial-blur">‑radial‑blur</a> <span class='bull'> • </span> <a href="command-line-options.html#raise">‑raise</a> <span class='bull'> • </span> <a href="command-line-options.html#random-threshold">‑random‑threshold</a> <span class='bull'> • </span> <a href="command-line-options.html#red-primary">‑red‑primary</a> <span class='bull'> • </span> <a href="command-line-options.html#regard-warnings">‑regard‑warnings</a> <span class='bull'> • </span> <a href="command-line-options.html#region">‑region</a> <span class='bull'> • </span> <a href="command-line-options.html#remap">‑remap</a> <span class='bull'> • </span> <a href="command-line-options.html#remote">‑remote</a> <span class='bull'> • </span> <a href="command-line-options.html#render">‑render</a> <span class='bull'> • </span> <a href="command-line-options.html#repage">‑repage</a> <span class='bull'> • </span> <a href="command-line-options.html#resample">‑resample</a> <span class='bull'> • </span> <a href="command-line-options.html#resize">‑resize</a> <span class='bull'> • </span> <a href="command-line-options.html#respect-parentheses">‑respect‑parentheses</a> <span class='bull'> • </span> <a href="command-line-options.html#reverse">‑reverse</a> <span class='bull'> • </span> <a href="command-line-options.html#roll">‑roll</a> <span class='bull'> • </span> <a href="command-line-options.html#rotate">‑rotate</a> <span class='bull'> • </span> <a href="command-line-options.html#sample">‑sample</a> <span class='bull'> • </span> <a href="command-line-options.html#sampling-factor">‑sampling‑factor</a> <span class='bull'> • </span> <a href="command-line-options.html#scale">‑scale</a> <span class='bull'> • </span> <a href="command-line-options.html#scene">‑scene</a> <span class='bull'> • </span> <a href="command-line-options.html#screen">‑screen</a> <span class='bull'> • </span> <a href="command-line-options.html#seed">‑seed</a> <span class='bull'> • </span> <a href="command-line-options.html#segment">‑segment</a> <span class='bull'> • </span> <a href="command-line-options.html#selective-blur">‑selective‑blur</a> <span class='bull'> • </span> <a href="command-line-options.html#separate">‑separate</a> <span class='bull'> • </span> <a href="command-line-options.html#sepia-tone">‑sepia‑tone</a> <span class='bull'> • </span> <a href="command-line-options.html#set">‑set</a> <span class='bull'> • </span> <a href="command-line-options.html#shade">‑shade</a> <span class='bull'> • </span> <a href="command-line-options.html#shadow">‑shadow</a> <span class='bull'> • </span> <a href="command-line-options.html#shared-memory">‑shared‑memory</a> <span class='bull'> • </span> <a href="command-line-options.html#sharpen">‑sharpen</a> <span class='bull'> • </span> <a href="command-line-options.html#shave">‑shave</a> <span class='bull'> • </span> <a href="command-line-options.html#shear">‑shear</a> <span class='bull'> • </span> <a href="command-line-options.html#sigmoidal-contrast">‑sigmoidal‑contrast</a> <span class='bull'> • </span> <a href="command-line-options.html#silent">‑silent</a> <span class='bull'> • </span> <a href="command-line-options.html#similarity-threshold">‑similarity‑threshold</a> <span class='bull'> • </span> <a href="command-line-options.html#size">‑size</a> <span class='bull'> • </span> <a href="command-line-options.html#sketch">‑sketch</a> <span class='bull'> • </span> <a href="command-line-options.html#smush">‑smush</a> <span class='bull'> • </span> <a href="command-line-options.html#snaps">‑snaps</a> <span class='bull'> • </span> <a href="command-line-options.html#solarize">‑solarize</a> <span class='bull'> • </span> <a href="command-line-options.html#sparse-color">‑sparse‑color</a> <span class='bull'> • </span> <a href="command-line-options.html#splice">‑splice</a> <span class='bull'> • </span> <a href="command-line-options.html#spread">‑spread</a> <span class='bull'> • </span> <a href="command-line-options.html#statistic">‑statistic</a> <span class='bull'> • </span> <a href="command-line-options.html#stegano">‑stegano</a> <span class='bull'> • </span> <a href="command-line-options.html#stereo">‑stereo</a> <span class='bull'> • </span> <a href="command-line-options.html#stretch">‑stretch</a> <span class='bull'> • </span> <a href="command-line-options.html#strip">‑strip</a> <span class='bull'> • </span> <a href="command-line-options.html#stroke">‑stroke</a> <span class='bull'> • </span> <a href="command-line-options.html#strokewidth">‑strokewidth</a> <span class='bull'> • </span> <a href="command-line-options.html#style">‑style</a> <span class='bull'> • </span> <a href="command-line-options.html#subimage-search">‑subimage‑search</a> <span class='bull'> • </span> <a href="command-line-options.html#swap">‑swap</a> <span class='bull'> • </span> <a href="command-line-options.html#swirl">‑swirl</a> <span class='bull'> • </span> <a href="command-line-options.html#synchronize">‑synchronize</a> <span class='bull'> • </span> <a href="command-line-options.html#taint">‑taint</a> <span class='bull'> • </span> <a href="command-line-options.html#text-font">‑text‑font</a> <span class='bull'> • </span> <a href="command-line-options.html#texture">‑texture</a> <span class='bull'> • </span> <a href="command-line-options.html#threshold">‑threshold</a> <span class='bull'> • </span> <a href="command-line-options.html#thumbnail">‑thumbnail</a> <span class='bull'> • </span> <a href="command-line-options.html#tile">‑tile</a> <span class='bull'> • </span> <a href="command-line-options.html#tile-offset">‑tile‑offset</a> <span class='bull'> • </span> <a href="command-line-options.html#tint">‑tint</a> <span class='bull'> • </span> <a href="command-line-options.html#title">‑title</a> <span class='bull'> • </span> <a href="command-line-options.html#transform">‑transform</a> <span class='bull'> • </span> <a href="command-line-options.html#transparent">‑transparent</a> <span class='bull'> • </span> <a href="command-line-options.html#transparent-color">‑transparent‑color</a> <span class='bull'> • </span> <a href="command-line-options.html#transpose">‑transpose</a> <span class='bull'> • </span> <a href="command-line-options.html#transverse">‑transverse</a> <span class='bull'> • </span> <a href="command-line-options.html#treedepth">‑treedepth</a> <span class='bull'> • </span> <a href="command-line-options.html#trim">‑trim</a> <span class='bull'> • </span> <a href="command-line-options.html#type">‑type</a> <span class='bull'> • </span> <a href="command-line-options.html#undercolor">‑undercolor</a> <span class='bull'> • </span> <a href="command-line-options.html#unique-colors">‑unique‑colors</a> <span class='bull'> • </span> <a href="command-line-options.html#units">‑units</a> <span class='bull'> • </span> <a href="command-line-options.html#unsharp">‑unsharp</a> <span class='bull'> • </span> <a href="command-line-options.html#update">‑update</a> <span class='bull'> • </span> <a href="command-line-options.html#verbose">‑verbose</a> <span class='bull'> • </span> <a href="command-line-options.html#version">‑version</a> <span class='bull'> • </span> <a href="command-line-options.html#view">‑view</a> <span class='bull'> • </span> <a href="command-line-options.html#vignette">‑vignette</a> <span class='bull'> • </span> <a href="command-line-options.html#virtual-pixel">‑virtual‑pixel</a> <span class='bull'> • </span> <a href="command-line-options.html#visual">‑visual</a> <span class='bull'> • </span> <a href="command-line-options.html#watermark">‑watermark</a> <span class='bull'> • </span> <a href="command-line-options.html#wave">‑wave</a> <span class='bull'> • </span> <a href="command-line-options.html#weight">‑weight</a> <span class='bull'> • </span> <a href="command-line-options.html#white-point">‑white‑point</a> <span class='bull'> • </span> <a href="command-line-options.html#white-threshold">‑white‑threshold</a> <span class='bull'> • </span> <a href="command-line-options.html#window">‑window</a> <span class='bull'> • </span> <a href="command-line-options.html#window-group">‑window‑group</a> <span class='bull'> • </span> <a href="command-line-options.html#write">‑write</a> ] </p>
-
-<div class="doc-section">
-
-<p>Below is list of command-line options recognized by the ImageMagick <a
-href="command-line-tools.html">command-line
-tools</a>. If you want a description of a particular option, click on the
-option name in the navigation bar above and you will go right to it. Unless
-otherwise noted, each option is recognized by the commands <a href="convert.html">convert</a>, <a href="mogrify.html">mogrify</a>.</p>
-
-<div style="margin: auto;">
- <h4><a id="adaptive-blur"></a>-adaptive-blur <em class="arg">radius</em>[x<em class="arg">sigma</em>]</h4>
-</div>
-
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Adaptively blur pixels, with decreasing effect near edges.</td><td style='text-align:right;'></td></tr></table>
-
-<p>A Gaussian operator of the given radius and standard deviation (<em
-class="arg">sigma</em>) is used. If <em class="arg">sigma</em> is not given it
+<body>
+ <header>
+ <nav class="navbar navbar-expand-md navbar-dark bg-dark fixed-top">
+ <a class="navbar-brand" href="../index.html"><img class="d-block" id="icon" alt="ImageMagick" width="32" height="32" src="../images/wand.ico"/></a>
+ <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarsExampleDefault" aria-controls="navbarsExampleDefault" aria-expanded="false" aria-label="Toggle navigation">
+ <span class="navbar-toggler-icon"></span>
+ </button>
+
+ <div class="navbar-collapse collapse" id="navbarsExampleDefault" style="">
+ <ul class="navbar-nav mr-auto">
+ <li class="nav-item ">
+ <a class="nav-link" href="../index.html">Home <span class="sr-only">(current)</span></a>
+ </li>
+ <li class="nav-item ">
+ <a class="nav-link" href="download.html">Download</a>
+ </li>
+ <li class="nav-item ">
+ <a class="nav-link" href="command-line-tools.html">Tools</a>
+ </li>
+ <li class="nav-item ">
+ <a class="nav-link" href="command-line-processing.html">Command-line</a>
+ </li>
+ <li class="nav-item ">
+ <a class="nav-link" href="resources.html">Resources</a>
+ </li>
+ <li class="nav-item ">
+ <a class="nav-link" href="develop.html">Develop</a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link" target="_blank" href="https://www.imagemagick.org/discourse-server/">Community</a>
+ </li>
+ </ul>
+ <form class="form-inline my-2 my-lg-0" action="https://www.imagemagick.org/script/search.php">
+ <input class="form-control mr-sm-2" type="text" name="q" placeholder="Search" aria-label="Search">
+ <button class="btn btn-outline-success my-2 my-sm-0" type="submit" name="sa">Search</button>
+ </form>
+ </div>
+ </nav>
+ <div class="container">
+ <script async="async" src="http://localhost/pagead/js/adsbygoogle.js"></script> <ins class="adsbygoogle"
+ style="display:block"
+ data-ad-client="ca-pub-3129977114552745"
+ data-ad-slot="6345125851"
+ data-ad-format="auto"></ins>
+ <script>
+ (adsbygoogle = window.adsbygoogle || []).push({});
+ </script>
+
+ </div>
+ </header>
+ <main class="container">
+ <div class="magick-template">
+<div class="magick-header">
+<p class="text-center"><a href="command-line-options.html#adaptive-blur">‑adaptive‑blur</a> • <a href="command-line-options.html#adaptive-resize">‑adaptive‑resize</a> • <a href="command-line-options.html#adaptive-sharpen">‑adaptive‑sharpen</a> • <a href="command-line-options.html#adjoin">‑adjoin</a> • <a href="command-line-options.html#affine">‑affine</a> • <a href="command-line-options.html#alpha">‑alpha</a> • <a href="command-line-options.html#annotate">‑annotate</a> • <a href="command-line-options.html#antialias">‑antialias</a> • <a href="command-line-options.html#append">‑append</a> • <a href="command-line-options.html#attenuate">‑attenuate</a> • <a href="command-line-options.html#authenticate">‑authenticate</a> • <a href="command-line-options.html#auto-gamma">‑auto‑gamma</a> • <a href="command-line-options.html#auto-level">‑auto‑level</a> • <a href="command-line-options.html#auto-orient">‑auto‑orient</a> • <a href="command-line-options.html#auto-threshold">‑auto‑threshold</a> • <a href="command-line-options.html#backdrop">‑backdrop</a> • <a href="command-line-options.html#background">‑background</a> • <a href="command-line-options.html#bench">‑bench</a> • <a href="command-line-options.html#bias">‑bias</a> • <a href="command-line-options.html#black-point-compensation">‑black‑point‑compensation</a> • <a href="command-line-options.html#black-threshold">‑black‑threshold</a> • <a href="command-line-options.html#blend">‑blend</a> • <a href="command-line-options.html#blue-primary">‑blue‑primary</a> • <a href="command-line-options.html#blue-shift">‑blue‑shift</a> • <a href="command-line-options.html#blur">‑blur</a> • <a href="command-line-options.html#border">‑border</a> • <a href="command-line-options.html#bordercolor">‑bordercolor</a> • <a href="command-line-options.html#borderwidth">‑borderwidth</a> • <a href="command-line-options.html#brightness-contrast">‑brightness‑contrast</a> • <a href="command-line-options.html#cache">‑cache</a> • <a href="command-line-options.html#canny">‑canny</a> • <a href="command-line-options.html#caption">‑caption</a> • <a href="command-line-options.html#cdl">‑cdl</a> • <a href="command-line-options.html#channel">‑channel</a> • <a href="command-line-options.html#charcoal">‑charcoal</a> • <a href="command-line-options.html#channel-fx">‑channel‑fx</a> • <a href="command-line-options.html#chop">‑chop</a> • <a href="command-line-options.html#clamp">‑clamp</a> • <a href="command-line-options.html#clip">‑clip</a> • <a href="command-line-options.html#clip-mask">‑clip‑mask</a> • <a href="command-line-options.html#clip-path">‑clip‑path</a> • <a href="command-line-options.html#clone">‑clone</a> • <a href="command-line-options.html#clut">‑clut</a> • <a href="command-line-options.html#coalesce">‑coalesce</a> • <a href="command-line-options.html#colorize">‑colorize</a> • <a href="command-line-options.html#colormap">‑colormap</a> • <a href="command-line-options.html#color-matrix">‑color‑matrix</a> • <a href="command-line-options.html#colors">‑colors</a> • <a href="command-line-options.html#colorspace">‑colorspace</a> • <a href="command-line-options.html#combine">‑combine</a> • <a href="command-line-options.html#comment">‑comment</a> • <a href="command-line-options.html#compare">‑compare</a> • <a href="command-line-options.html#complex">‑complex</a> • <a href="command-line-options.html#compose">‑compose</a> • <a href="command-line-options.html#composite">‑composite</a> • <a href="command-line-options.html#compress">‑compress</a> • <a href="command-line-options.html#connected-components">‑connected‑components</a> • <a href="command-line-options.html#contrast">‑contrast</a> • <a href="command-line-options.html#contrast-stretch">‑contrast‑stretch</a> • <a href="command-line-options.html#convolve">‑convolve</a> • <a href="command-line-options.html#copy">‑copy</a> • <a href="command-line-options.html#crop">‑crop</a> • <a href="command-line-options.html#cycle">‑cycle</a> • <a href="command-line-options.html#debug">‑debug</a> • <a href="command-line-options.html#decipher">‑decipher</a> • <a href="command-line-options.html#deconstruct">‑deconstruct</a> • <a href="command-line-options.html#define">‑define</a> • <a href="command-line-options.html#delay">‑delay</a> • <a href="command-line-options.html#delete">‑delete</a> • <a href="command-line-options.html#density">‑density</a> • <a href="command-line-options.html#depth">‑depth</a> • <a href="command-line-options.html#descend">‑descend</a> • <a href="command-line-options.html#deskew">‑deskew</a> • <a href="command-line-options.html#despeckle">‑despeckle</a> • <a href="command-line-options.html#direction">‑direction</a> • <a href="command-line-options.html#displace">‑displace</a> • <a href="command-line-options.html#display">‑display</a> • <a href="command-line-options.html#dispose">‑dispose</a> • <a href="command-line-options.html#dissimilarity-threshold">‑dissimilarity‑threshold</a> • <a href="command-line-options.html#dissolve">‑dissolve</a> • <a href="command-line-options.html#distort">‑distort</a> • <a href="command-line-options.html#distribute-cache">‑distribute‑cache</a> • <a href="command-line-options.html#dither">‑dither</a> • <a href="command-line-options.html#draw">‑draw</a> • <a href="command-line-options.html#duplicate">‑duplicate</a> • <a href="command-line-options.html#edge">‑edge</a> • <a href="command-line-options.html#emboss">‑emboss</a> • <a href="command-line-options.html#encipher">‑encipher</a> • <a href="command-line-options.html#encoding">‑encoding</a> • <a href="command-line-options.html#endian">‑endian</a> • <a href="command-line-options.html#enhance">‑enhance</a> • <a href="command-line-options.html#equalize">‑equalize</a> • <a href="command-line-options.html#evaluate">‑evaluate</a> • <a href="command-line-options.html#evaluate-sequence">‑evaluate‑sequence</a> • <a href="command-line-options.html#extent">‑extent</a> • <a href="command-line-options.html#extract">‑extract</a> • <a href="command-line-options.html#family">‑family</a> • <a href="command-line-options.html#features">‑features</a> • <a href="command-line-options.html#fft">‑fft</a> • <a href="command-line-options.html#fill">‑fill</a> • <a href="command-line-options.html#filter">‑filter</a> • <a href="command-line-options.html#flatten">‑flatten</a> • <a href="command-line-options.html#flip">‑flip</a> • <a href="command-line-options.html#floodfill">‑floodfill</a> • <a href="command-line-options.html#flop">‑flop</a> • <a href="command-line-options.html#font">‑font</a> • <a href="command-line-options.html#foreground">‑foreground</a> • <a href="command-line-options.html#format">‑format</a> • <a href="command-line-options.html#format_identify_">‑format[identify]</a> • <a href="command-line-options.html#frame">‑frame</a> • <a href="command-line-options.html#frame_import_">‑frame[import]</a> • <a href="command-line-options.html#function">‑function</a> • <a href="command-line-options.html#fuzz">‑fuzz</a> • <a href="command-line-options.html#fx">‑fx</a> • <a href="command-line-options.html#gamma">‑gamma</a> • <a href="command-line-options.html#gaussian-blur">‑gaussian‑blur</a> • <a href="command-line-options.html#geometry">‑geometry</a> • <a href="command-line-options.html#gravity">‑gravity</a> • <a href="command-line-options.html#grayscale">‑grayscale</a> • <a href="command-line-options.html#green-primary">‑green‑primary</a> • <a href="command-line-options.html#hald-clut">‑hald‑clut</a> • <a href="command-line-options.html#help">‑help</a> • <a href="command-line-options.html#highlight-color">‑highlight‑color</a> • <a href="command-line-options.html#hough-lines">‑hough‑lines</a> • <a href="command-line-options.html#iconGeometry">‑iconGeometry</a> • <a href="command-line-options.html#iconic">‑iconic</a> • <a href="command-line-options.html#identify">‑identify</a> • <a href="command-line-options.html#ift">‑ift</a> • <a href="command-line-options.html#immutable">‑immutable</a> • <a href="command-line-options.html#implode">‑implode</a> • <a href="command-line-options.html#insert">‑insert</a> • <a href="command-line-options.html#intensity">‑intensity</a> • <a href="command-line-options.html#intent">‑intent</a> • <a href="command-line-options.html#interlace">‑interlace</a> • <a href="command-line-options.html#interpolate">‑interpolate</a> • <a href="command-line-options.html#interline-spacing">‑interline‑spacing</a> • <a href="command-line-options.html#interword-spacing">‑interword‑spacing</a> • <a href="command-line-options.html#kerning">‑kerning</a> • <a href="command-line-options.html#kuwahara">‑kuwahara</a> • <a href="command-line-options.html#label">‑label</a> • <a href="command-line-options.html#lat">‑lat</a> • <a href="command-line-options.html#layers">‑layers</a> • <a href="command-line-options.html#level">‑level</a> • <a href="command-line-options.html#level-colors">‑level‑colors</a> • <a href="command-line-options.html#limit">‑limit</a> • <a href="command-line-options.html#linear-stretch">‑linear‑stretch</a> • <a href="command-line-options.html#linewidth">‑linewidth</a> • <a href="command-line-options.html#liquid-rescale">‑liquid‑rescale</a> • <a href="command-line-options.html#list">‑list</a> • <a href="command-line-options.html#log">‑log</a> • <a href="command-line-options.html#loop">‑loop</a> • <a href="command-line-options.html#lowlight-color">‑lowlight‑color</a> • <a href="command-line-options.html#magnify">‑magnify</a> • <a href="command-line-options.html#map">‑map</a> • <a href="command-line-options.html#map_stream_">‑map[stream]</a> • <a href="command-line-options.html#mattecolor">‑mattecolor</a> • <a href="command-line-options.html#median">‑median</a> • <a href="command-line-options.html#mean-shift">‑mean‑shift</a> • <a href="command-line-options.html#metric">‑metric</a> • <a href="command-line-options.html#mode">‑mode</a> • <a href="command-line-options.html#modulate">‑modulate</a> • <a href="command-line-options.html#moments">‑moments</a> • <a href="command-line-options.html#monitor">‑monitor</a> • <a href="command-line-options.html#monochrome">‑monochrome</a> • <a href="command-line-options.html#morph">‑morph</a> • <a href="command-line-options.html#morphology">‑morphology</a> • <a href="command-line-options.html#mosaic">‑mosaic</a> • <a href="command-line-options.html#motion-blur">‑motion‑blur</a> • <a href="command-line-options.html#name">‑name</a> • <a href="command-line-options.html#negate">‑negate</a> • <a href="command-line-options.html#noise">‑noise</a> • <a href="command-line-options.html#normalize">‑normalize</a> • <a href="command-line-options.html#opaque">‑opaque</a> • <a href="command-line-options.html#ordered-dither">‑ordered‑dither</a> • <a href="command-line-options.html#orient">‑orient</a> • <a href="command-line-options.html#page">‑page</a> • <a href="command-line-options.html#paint">‑paint</a> • <a href="command-line-options.html#path">‑path</a> • <a href="command-line-options.html#pause_animate_">‑pause[animate]</a> • <a href="command-line-options.html#pause_import_">‑pause[import]</a> • <a href="command-line-options.html#perceptible">‑perceptible</a> • <a href="command-line-options.html#ping">‑ping</a> • <a href="command-line-options.html#pointsize">‑pointsize</a> • <a href="command-line-options.html#polaroid">‑polaroid</a> • <a href="command-line-options.html#poly">‑poly</a> • <a href="command-line-options.html#posterize">‑posterize</a> • <a href="command-line-options.html#precision">‑precision</a> • <a href="command-line-options.html#preview">‑preview</a> • <a href="command-line-options.html#print">‑print</a> • <a href="command-line-options.html#process">‑process</a> • <a href="command-line-options.html#profile">‑profile</a> • <a href="command-line-options.html#quality">‑quality</a> • <a href="command-line-options.html#quantize">‑quantize</a> • <a href="command-line-options.html#quiet">‑quiet</a> • <a href="command-line-options.html#radial-blur">‑radial‑blur</a> • <a href="command-line-options.html#raise">‑raise</a> • <a href="command-line-options.html#random-threshold">‑random‑threshold</a> • <a href="command-line-options.html#read-mask">‑read‑mask</a> • <a href="command-line-options.html#red-primary">‑red‑primary</a> • <a href="command-line-options.html#regard-warnings">‑regard‑warnings</a> • <a href="command-line-options.html#region">‑region</a> • <a href="command-line-options.html#remap">‑remap</a> • <a href="command-line-options.html#remote">‑remote</a> • <a href="command-line-options.html#render">‑render</a> • <a href="command-line-options.html#repage">‑repage</a> • <a href="command-line-options.html#resample">‑resample</a> • <a href="command-line-options.html#resize">‑resize</a> • <a href="command-line-options.html#respect-parentheses">‑respect‑parentheses</a> • <a href="command-line-options.html#reverse">‑reverse</a> • <a href="command-line-options.html#roll">‑roll</a> • <a href="command-line-options.html#rotate">‑rotate</a> • <a href="command-line-options.html#sample">‑sample</a> • <a href="command-line-options.html#sampling-factor">‑sampling‑factor</a> • <a href="command-line-options.html#scale">‑scale</a> • <a href="command-line-options.html#scene">‑scene</a> • <a href="command-line-options.html#screen">‑screen</a> • <a href="command-line-options.html#seed">‑seed</a> • <a href="command-line-options.html#segment">‑segment</a> • <a href="command-line-options.html#selective-blur">‑selective‑blur</a> • <a href="command-line-options.html#separate">‑separate</a> • <a href="command-line-options.html#sepia-tone">‑sepia‑tone</a> • <a href="command-line-options.html#set">‑set</a> • <a href="command-line-options.html#shade">‑shade</a> • <a href="command-line-options.html#shadow">‑shadow</a> • <a href="command-line-options.html#shared-memory">‑shared‑memory</a> • <a href="command-line-options.html#sharpen">‑sharpen</a> • <a href="command-line-options.html#shave">‑shave</a> • <a href="command-line-options.html#shear">‑shear</a> • <a href="command-line-options.html#sigmoidal-contrast">‑sigmoidal‑contrast</a> • <a href="command-line-options.html#silent">‑silent</a> • <a href="command-line-options.html#similarity-threshold">‑similarity‑threshold</a> • <a href="command-line-options.html#size">‑size</a> • <a href="command-line-options.html#sketch">‑sketch</a> • <a href="command-line-options.html#smush">‑smush</a> • <a href="command-line-options.html#snaps">‑snaps</a> • <a href="command-line-options.html#solarize">‑solarize</a> • <a href="command-line-options.html#sparse-color">‑sparse‑color</a> • <a href="command-line-options.html#splice">‑splice</a> • <a href="command-line-options.html#spread">‑spread</a> • <a href="command-line-options.html#statistic">‑statistic</a> • <a href="command-line-options.html#stegano">‑stegano</a> • <a href="command-line-options.html#stereo">‑stereo</a> • <a href="command-line-options.html#storage-type">‑storage‑type</a> • <a href="command-line-options.html#stretch">‑stretch</a> • <a href="command-line-options.html#strip">‑strip</a> • <a href="command-line-options.html#stroke">‑stroke</a> • <a href="command-line-options.html#strokewidth">‑strokewidth</a> • <a href="command-line-options.html#style">‑style</a> • <a href="command-line-options.html#subimage-search">‑subimage‑search</a> • <a href="command-line-options.html#swap">‑swap</a> • <a href="command-line-options.html#swirl">‑swirl</a> • <a href="command-line-options.html#synchronize">‑synchronize</a> • <a href="command-line-options.html#taint">‑taint</a> • <a href="command-line-options.html#text-font">‑text‑font</a> • <a href="command-line-options.html#texture">‑texture</a> • <a href="command-line-options.html#threshold">‑threshold</a> • <a href="command-line-options.html#thumbnail">‑thumbnail</a> • <a href="command-line-options.html#tile">‑tile</a> • <a href="command-line-options.html#tile-offset">‑tile‑offset</a> • <a href="command-line-options.html#tint">‑tint</a> • <a href="command-line-options.html#title">‑title</a> • <a href="command-line-options.html#transform">‑transform</a> • <a href="command-line-options.html#transparent">‑transparent</a> • <a href="command-line-options.html#transparent-color">‑transparent‑color</a> • <a href="command-line-options.html#transpose">‑transpose</a> • <a href="command-line-options.html#transverse">‑transverse</a> • <a href="command-line-options.html#treedepth">‑treedepth</a> • <a href="command-line-options.html#trim">‑trim</a> • <a href="command-line-options.html#type">‑type</a> • <a href="command-line-options.html#undercolor">‑undercolor</a> • <a href="command-line-options.html#unique-colors">‑unique‑colors</a> • <a href="command-line-options.html#units">‑units</a> • <a href="command-line-options.html#unsharp">‑unsharp</a> • <a href="command-line-options.html#update">‑update</a> • <a href="command-line-options.html#verbose">‑verbose</a> • <a href="command-line-options.html#version">‑version</a> • <a href="command-line-options.html#view">‑view</a> • <a href="command-line-options.html#vignette">‑vignette</a> • <a href="command-line-options.html#virtual-pixel">‑virtual‑pixel</a> • <a href="command-line-options.html#visual">‑visual</a> • <a href="command-line-options.html#watermark">‑watermark</a> • <a href="command-line-options.html#wave">‑wave</a> • <a href="command-line-options.html#wavelet-denoise">‑wavelet‑denoise</a> • <a href="command-line-options.html#weight">‑weight</a> • <a href="command-line-options.html#white-point">‑white‑point</a> • <a href="command-line-options.html#white-threshold">‑white‑threshold</a> • <a href="command-line-options.html#window">‑window</a> • <a href="command-line-options.html#window-group">‑window‑group</a> • <a href="command-line-options.html#write">‑write</a> • <a href="command-line-options.html#write-mask">‑write‑mask</a> </p>
+<p class="lead magick-description">Below is list of command-line options recognized by the ImageMagick <a href="command-line-tools.html">command-line tools</a>. If you want a description of a particular option, click on the option name in the navigation bar above and you will go right to it. Unless otherwise noted, each option is recognized by the commands: <a href="convert.html">convert</a> and <a href="mogrify.html">mogrify</a>.</p>
+
+<div style="margin: auto;">
+ <h3><a class="anchor" id="adaptive-blur"></a>-adaptive-blur <var>radius</var>[x<var>sigma</var>]</h3>
+</div>
+
+<p class="magick-description">Adaptively blur pixels, with decreasing effect near edges.</p>
+
+<p>A Gaussian operator of the given radius and standard deviation (<var>sigma</var>) is used. If <var>sigma</var> is not given it
defaults to 1.</p>
<div style="margin: auto;">
- <h4><a id="adaptive-resize"></a>-adaptive-resize <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="adaptive-resize"></a>-adaptive-resize <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Resize the image using data-dependent triangulation.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Resize the image using data-dependent triangulation.</p>
<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. The <a href="command-line-options.html#adaptive-resize">-adaptive-resize</a>
option defaults to data-dependent triangulation. Use the <a
href="command-line-options.html#gravity">-gravity</a> option has no effect.</p>
<div style="margin: auto;">
- <h4><a id="adaptive-sharpen"></a>-adaptive-sharpen <em class="arg">radius</em>[x<em class="arg">sigma</em>]</h4>
+ <h3><a class="anchor" id="adaptive-sharpen"></a>-adaptive-sharpen <var>radius</var>[x<var>sigma</var>]</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Adaptively sharpen pixels, with increasing effect near edges.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Adaptively sharpen pixels, with increasing effect near edges.</p>
-<p>A Gaussian operator of the given radius and standard deviation (<em
-class="arg">sigma</em>) is used. If <em class="arg">sigma</em> is not given it
+<p>A Gaussian operator of the given radius and standard deviation
+(<var>sigma</var>) is used. If <var>sigma</var> is not given it
defaults to 1.</p>
<div style="margin: auto;">
- <h4><a id="adjoin"></a>-adjoin</h4>
+ <h3><a class="anchor" id="adjoin"></a>-adjoin</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Join images into a single multi-image file.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Join images into a single multi-image file.</p>
<p>This option is enabled by default. An attempt is made to save all images of
an image sequence into the given output file. However, some formats, such as
who have used the standard <code>printf()</code>' C-library function. As an
example, the command</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert logo: rose: -morph 15 my%02dmorph.jpg</span></p>
+<pre class="highlight"><code>convert logo: rose: -morph 15 my%02dmorph.jpg
+</code></pre>
+
<p>will create a sequence of 17 images (the two given plus 15 more created by
<a href="command-line-options.html#morph">-morph</a>), named: my00morph.jpg, my01morph.jpg,
my02morph.jpg, ..., my16morph.jpg. </p>
<div style="margin: auto;">
- <h4><a id="affine"></a>-affine
- <em class="arg">s<sub>x</sub></em>,<em class="arg">r<sub>x</sub></em>,<em
- class="arg">r<sub>y</sub></em>,<em class="arg">s<sub>y</sub></em>[,<em
- class="arg">t<sub>x</sub></em>,<em class="arg">t<sub>y</sub></em>]</h4>
+ <h3><a class="anchor" id="affine"></a>-affine
+ <var>s<sub>x</sub></var>,<var>r<sub>x</sub></var>,<var>r<sub>y</sub></var>,<var>s<sub>y</sub></var>[,<var>t<sub>x</sub></var>,<var>t<sub>y</sub></var>]</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the drawing transformation matrix for combined rotating and scaling.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set the drawing transformation matrix for combined rotating and scaling.</p>
<p>This option sets a transformation matrix, for use by subsequent <a
href="command-line-options.html#draw">-draw</a> or <a href="command-line-options.html#transform">-transform</a> options. </p>
<p>Internally, the transformation matrix has 3x3 elements, but three of them
are omitted from the input because they are constant. The new (transformed)
-coordinates (<em class="arg">x'</em>, <em class="arg">y'</em>) of a pixel at
-position (<em class="arg">x</em>, <em class="arg">y</em>) in the original
+coordinates (<var>x'</var>, <var>y'</var>) of a pixel at
+position (<var>x</var>, <var>y</var>) in the original
image are calculated using the following matrix equation.</p>
-<div class="eqn">
-<img alt="affine transformation" src="../images/affine.png"/>
-</div>
+<p class="text-center"><img class="img-thumbnail" alt="affine transformation" src="../images/affine.png"/> </p>
<p> The size of the resulting image is that of the smallest rectangle that
-contains the transformed source image. The parameters <em
-class="arg">t<sub>x</sub></em> and <em class="arg">t<sub>y</sub></em>
+contains the transformed source image. The parameters
+<var>t<sub>x</sub></var> and <var>t<sub>y</sub></var>
subsequently shift the image pixels so that those that are moved out of the
image area are cut off.</p>
<p>The transformation matrix complies with the left-handed pixel coordinate
-system: positive <em class="arg">x</em> and <em class="arg">y</em> directions
+system: positive <var>x</var> and <var>y</var> directions
are rightward and downward, resp.; positive rotation is clockwise.</p>
-<p> If the translation coefficients <em class="arg">t<sub>x</sub></em> and <em
-class="arg">t<sub>y</sub></em> are omitted they default to 0,0. Therefore,
+<p> If the translation coefficients <var>t<sub>x</sub></var> and
+<var>t<sub>y</sub></var> are omitted they default to 0,0. Therefore,
four parameters suffice for rotation and scaling without translation.</p>
-<p>Scaling by the factors <em class="arg">s<sub>x</sub></em> and <em
-class="arg">s<sub>y</sub></em> in the <em>x</em> and <em>y</em> directions,
+<p>Scaling by the factors <var>s<sub>x</sub></var> and
+<var>s<sub>y</sub></var> in the <var>x</var> and <var>y</var> directions,
respectively, is accomplished with the following.</p>
<p>See <a href="command-line-options.html#transform">-transform</a>, and the <a
information </p>
-<p class="crtsnip"> -affine <em class="arg">s<sub>x</sub></em>,0,0,<em
-class="arg">s<sub>y</sub></em> </p>
+<pre class="highlight"><code>-affine <var>s<sub>x</sub></var>,0,0,<var>s<sub>y</sub></var>
+</code></pre>
-<p>Translation by a displacement (<em class="arg">t<sub>x</sub></em>, <em
-class="arg">t<sub>y</sub></em>) is accomplished like so:</p>
+<p>Translation by a displacement (<var>t<sub>x</sub></var>, <var>t<sub>y</sub></var>) is accomplished like so:</p>
-<p class="crtsnip">
- -affine 1,0,0,1,<em class="arg">t<sub>x</sub></em>,<em class="arg">t<sub>y</sub></em>
-</p>
+<pre class="highlight"><code>-affine 1,0,0,1,<var>t<sub>x</sub></var>,<var>t<sub>y</sub></var>
+</code></pre>
<p>Rotate clockwise about the origin (the upper left-hand corner) by an angle
-<em>a</em> by letting <em>c</em> = cos(<em>a</em>), <em>s</em>
-= sin(<em>a</em>), and using the following.</p>
+<var>a</var> by letting <var>c</var> = cos(<var>a</var>), <var>s</var>
+= sin(<var>a</var>), and using the following.</p>
-<p class="crtsnip">
- -affine <em>c</em>,<em>s</em>,-<em>s</em>,<em>c</em>
-</p>
+<pre class="highlight"><code>-affine <var>c</var>,<var>s</var>,-<var>s</var>,<var>c</var>
+</code></pre>
<p>The cumulative effect of a sequence of <a href="command-line-options.html#affine" >-affine</a>
transformations can be accomplished by instead by a single <a href="command-line-options.html#affine"
matrix determinant has a sufficiently small absolute value it is rejected.</p>
<div style="margin: auto;">
- <h4><a id="alpha"></a>-alpha <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="alpha"></a>-alpha <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Gives control of the alpha/matte channel of an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Gives control of the alpha/matte channel of an image.</p>
<p>Used to set a flag on an image indicating whether or not to use existing alpha
-channel data, to create an alpha channel, or to perform other operations on the alpha channel. Choose the argument <em class="arg">type</em> from the list below.</p>
-
-
-<table class="doc">
- <tbody>
- <tr valign="top">
- <th align="left" style="width: 8%">type</th>
- <th align="left">Description</th>
- </tr>
+channel data, to create an alpha channel, or to perform other operations on the alpha channel. Choose the argument <var>type</var> from the list below.</p>
- <tr valign="top">
- <td valign="top"><code>Activate</code> or <code>On</code></td>
- <td valign="top">
- Enable the image's transparency channel. Note normally <code>Set</code>
+<dl class="row">
+ <dt class="col-md-4">Activate</dt>
+ <dd class="col-md-8">
+ Enable the image's transparency channel. Note normally Set
should be used instead of this, unless you specifically need to
- preserve existing (but specifically turned <code>Off</code>) transparency
- channel. </td></tr>
+ preserve existing (but specifically turned Off) transparency
+ channel. </dd>
- <tr valign="top">
- <td valign="top"><code>Associate</code></td>
- <td valign="top">
- associate the alpha channel with the image.</td></tr>
+ <dt class="col-md-4">Associate</dt>
+ <dd class="col-md-8">
+ associate the alpha channel with the image.</dd>
- <tr valign="top">
- <td valign="top"><code>Deactivate</code> or <code>Off</code></td>
- <td valign="top">
+ <dt class="col-md-4">Deactivate</dt>
+ <dd class="col-md-8">
Disables the image's transparency channel. Does not delete or change the
- existing data, just turns off the use of that data.</td></tr>
+ existing data, just turns off the use of that data.</dd>
- <tr valign="top">
- <td valign="top"><code>Disassociate</code></td>
- <td valign="top">
- disassociate the alpha channel from the image.</td></tr>
+ <dt class="col-md-4">Disassociate</dt>
+ <dd class="col-md-8">
+ disassociate the alpha channel from the image.</dd>
- <tr valign="top">
- <td valign="top"><code>Set</code></td>
- <td valign="top">
+ <dt class="col-md-4">Set</dt>
+ <dd class="col-md-8">
Activates the alpha/matte channel. If it was previously turned off
then it also resets the channel to opaque. If the image already had
- the alpha channel turned on, it will have no effect.</td></tr>
+ the alpha channel turned on, it will have no effect.</dd>
- <tr valign="top">
- <td valign="top"><code>Opaque</code></td>
- <td valign="top">
+ <dt class="col-md-4">Opaque</dt>
+ <dd class="col-md-8">
Enables the alpha/matte channel and forces it to be fully opaque.
- </td></tr>
+ </dd>
- <tr valign="top">
- <td valign="top"><code>Transparent</code></td>
- <td valign="top">
+ <dt class="col-md-4">Transparent</dt>
+ <dd class="col-md-8">
Activates the alpha/matte channel and forces it to be fully
transparent. This effectively creates a fully transparent image the
same size as the original and with all its original RGB data still
- intact, but fully transparent. </td></tr>
+ intact, but fully transparent. </dd>
- <tr valign="top">
- <td valign="top"><code>Extract</code></td>
- <td valign="top">
+ <dt class="col-md-4">Extract</dt>
+ <dd class="col-md-8">
Copies the alpha channel values into all the color channels and turns
- '<code>Off</code>' the the image's transparency, so as to generate
- a gray-scale mask of the image's shape. The alpha channel data is left
- intact just deactivated. This is the inverse of '<code>Copy</code>'.
- </td></tr>
-
- <tr valign="top">
- <td valign="top"><code>Copy</code></td>
- <td valign="top">
- Turns '<code>On</code>' the alpha/matte channel, then copies the
- gray-scale intensity of the image, into the alpha channel, converting
- a gray-scale mask into a transparent shaped mask ready to be colored
- appropriately. The color channels are not modified. </td></tr>
-
- <tr valign="top">
- <td valign="top"><code>Shape</code></td>
- <td valign="top">
- As per '<code>Copy</code>' but also colors the resulting shape mask with
+ 'Off' the the image's transparency, so as to generate
+ a grayscale mask of the image's shape. The alpha channel data is left
+ intact just deactivated. This is the inverse of 'Copy'.
+ </dd>
+
+ <dt class="col-md-4">Copy</dt>
+ <dd class="col-md-8">
+ Turns 'On' the alpha/matte channel, then copies the
+ grayscale intensity of the image, into the alpha channel, converting
+ a grayscale mask into a transparent shaped mask ready to be colored
+ appropriately. The color channels are not modified. </dd>
+
+ <dt class="col-md-4">Shape</dt>
+ <dd class="col-md-8">
+ As per 'Copy' but also colors the resulting shape mask with
the current background color. That is the RGB color channels is
replaced, with appropriate alpha shape.
- </td></tr>
+ </dd>
- <tr valign="top">
- <td valign="top"><code>Remove</code></td>
- <td valign="top">
+ <dt class="col-md-4">Remove</dt>
+ <dd class="col-md-8">
Composite the image over the background color.
- </td></tr>
+ </dd>
- <tr valign="top">
- <td valign="top"><code>Background</code></td>
- <td valign="top">
+ <dt class="col-md-4">Background</dt>
+ <dd class="col-md-8">
Set any fully-transparent pixel to the background color, while leaving
it fully-transparent. This can make some image file formats, such as
PNG, smaller as the RGB values of transparent pixels are more uniform,
and thus can compress better.
- </td></tr>
- </tbody>
-</table>
+ </dd>
+</dl>
<p>Note that while the obsolete <code>+matte</code> operation was the
same as "<code><a href="command-line-options.html#alpha" >-alpha</a> Off</code>", the <code>
>-matte</code> operation was the same as "<code><a href="command-line-options.html#alpha" >-alpha</a>
Set</code>" and not "<code><a href="command-line-options.html#alpha" >-alpha</a> On</code>". </p>
-
<div style="margin: auto;">
- <h4><a id="annotate"></a>
- -annotate <em class="arg">degrees</em> <em class="arg">text</em><br />
- -annotate <em class="arg">Xdegrees</em>x<em class="arg">Ydegrees</em> <em
- class="arg">text</em><br /> -annotate <em class="arg">Xdegrees</em>x<em
- class="arg">Ydegrees</em> {+-}<em class="arg">t<sub>x</sub></em>{+-}<em
- class="arg">t<sub>y</sub></em> <em class="arg">text</em><br /> -annotate {+-}<em class="arg">t<sub>x</sub></em>{+-}<em class="arg">t<sub>y</sub></em> <em class="arg">text</em></h4>
+ <h3><a class="anchor" id="annotate"></a>
+ -annotate <var>degrees</var> <var>text</var><br />
+ -annotate <var>Xdegrees</var>x<var>Ydegrees</var> <var>text</var><br /> -annotate <var>Xdegrees</var>x<var>Ydegrees</var> {+-}<var>t<sub>x</sub></var>{+-}<var>t<sub>y</sub></var> <var>text</var><br /> -annotate {+-}<var>t<sub>x</sub></var>{+-}<var>t<sub>y</sub></var> <var>text</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Annotate an image with text.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Annotate an image with text</p>
<p>This is a convenience for annotating an image with text. For more precise
control over text annotations, use <a href="command-line-options.html#draw">-draw</a>.</p>
-<p>The values <em class="arg">Xdegrees</em> and <em class="arg">Ydegrees</em>
-control the shears applied to the text, while <em class="arg">t<sub>x</sub></em> and <em class="arg">t<sub>y</sub></em> are offsets that give the location of the text relative any <a href="command-line-options.html#gravity" >-gravity</a> setting and defaults to the upper left corner of the image.</p>
+<p>The values <var>Xdegrees</var> and <var>Ydegrees</var>
+control the shears applied to the text, while <var>t<sub>x</sub></var> and <var>t<sub>y</sub></var> are offsets that give the location of the text relative any <a href="command-line-options.html#gravity" >-gravity</a> setting and defaults to the upper left corner of the image.</p>
+
+<p>Using <a href="command-line-options.html#annotate">-annotate</a> <var>degrees</var>
+or <a href="command-line-options.html#annotate">-annotate</a> <var>degrees</var>x<var>degrees</var> produces an unsheared rotation of the text. The
+direction of the rotation is positive, which means a clockwise rotation if <var>degrees</var> is positive. (This conforms to the usual mathematical
+convention once it is realized that the positive <var>y</var>–direction is
+conventionally considered to be <var>downward</var> for images.)</p>
-<p>Using <a href="command-line-options.html#annotate">-annotate</a> <em class="arg">degrees</em>
-or <a href="command-line-options.html#annotate">-annotate</a> <em class="arg">degrees</em>x<em
-class="arg">degrees</em> produces an unsheared rotation of the text. The
-direction of the rotation is positive, which means a clockwise rotation if <em
-class="arg">degrees</em> is positive. (This conforms to the usual mathematical
-convention once it is realized that the positive <em>y</em>–direction is
-conventionally considered to be <em>downward</em> for images.)</p>
+<p>The new (transformed) coordinates (<var>x'</var>, <var>y'</var>) of a pixel at position (<var>x</var>, <var>y</var>) in the image are calculated using the following matrix
+equation.</p>
-<p>The new (transformed) coordinates (<em class="arg">x'</em>, <em
-class="arg">y'</em>) of a pixel at position (<em class="arg">x</em>, <em
-class="arg">y</em>) in the image are calculated using the following matrix
-equation.</p> <div class="eqn"><img alt="annotate transformation" src="../images/annotate.png"/></div>
+<p class="text-center"><img class="img-thumbnail" alt="annotate transformation" src="../images/annotate.png"/></p>
-<p>If <em class="arg">t<sub>x</sub></em> and <em
-class="arg">t<sub>y</sub></em> are omitted, they default to 0. This makes the
+<p>If <var>t<sub>x</sub></var> and <var>t<sub>y</sub></var> are omitted, they default to 0. This makes the
bottom-left of the text becomes the upper-left corner of the image, which is
probably undesirable. Adding a <a href="command-line-options.html#gravity" >-gravity</a> option in this
case leads to nice results.</p>
-<p>Text is any UTF-8 encoded character sequence. If <em class="arg">text</em>
+<p>Text is any UTF-8 encoded character sequence. If <var>text</var>
is of the form '@mytext.txt', the text is read from the file
<code>mytext.txt</code>. Text in a file is taken literally; no embedded
formatting characters are recognized.</p>
<div style="margin: auto;">
- <h4><a id="antialias"></a>-antialias</h4>
+ <h3><a class="anchor" id="antialias"></a>-antialias</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Enable/Disable of the rendering of anti-aliasing pixels when
-drawing fonts and lines.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Enable/Disable of the rendering of anti-aliasing pixels when drawing fonts and lines.</p>
<p>By default, objects (e.g. text, lines, polygons, etc.) are antialiased when
drawn. Use <a href="command-line-options.html#antialias">+antialias</a> to disable the addition of
are added when drawing such objects. </p>
<div style="margin: auto;">
- <h4><a id="append"></a>-append</h4>
+ <h3><a class="anchor" id="append"></a>-append</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Join current images vertically or horizontally.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Join current images vertically or horizontally.</p>
<p>This option creates a single longer image, by joining all the current
images in sequence top-to-bottom. Use <a href="command-line-options.html#append">+append</a> to
<div style="margin: auto;">
- <h4><a id="attenuate"></a>-attenuate <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="attenuate"></a>-attenuate <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Lessen (or intensify) when adding noise to an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Lessen (or intensify) when adding noise to an image.</p>
<p>If unset the value is equivalent to 1.0, or a maximum noise addition</p>
<div style="margin: auto;">
- <h4><a id="authenticate"></a>-authenticate <em class="arg">password</em></h4>
+ <h3><a class="anchor" id="authenticate"></a>-authenticate <var>password</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Decrypt a PDF with a password.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Decrypt a PDF with a password.</p>
-<p>Use this option to supply a <em class="arg">password</em> for decrypting
+<p>Use this option to supply a <var>password</var> for decrypting
a PDF that has been encrypted using Microsoft Crypto API (MSC API). The
encrypting using the MSC API is not supported.</p>
and <a href="command-line-options.html#decipher">-decipher</a>. </p>
-
<div style="margin: auto;">
- <h4><a id="auto-gamma"></a>-auto-gamma</h4>
+ <h3><a class="anchor" id="auto-gamma"></a>-auto-gamma</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Automagically adjust gamma level of image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Automagically adjust gamma level of image.</p>
<p>This calculates the mean values of an image, then applies a calculated <a
-href="command-line-options.html#gamma" >-gamma</a> adjustment so that is the mean color exists in the
-image it will get a have a value of 50%. </p>
+href="command-line-options.html#gamma" >-gamma</a> adjustment so that the mean color in the
+image will get a value of 50%. </p>
<p>This means that any solid 'gray' image becomes 50% gray. </p>
</p>
<p>It uses the <a href="command-line-options.html#channel" >-channel</a> setting, (including the
-'<em>sync</em>' flag for channel synchronization), to determine which color
+'<var>sync</var>' flag for channel synchronization), to determine which color
values is used and modified. As the default <a href="command-line-options.html#channel"
->-channel</a> setting is '<em>RGB,sync</em>', channels are modified
+>-channel</a> setting is '<var>RGB,sync</var>', channels are modified
together by the same gamma value, preserving colors. </p>
<div style="margin: auto;">
- <h4><a id="auto-level"></a>-auto-level</h4>
+ <h3><a class="anchor" id="auto-level"></a>-auto-level</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Automagically adjust color levels of image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Automagically adjust color levels of image.</p>
<p>This is a 'perfect' image normalization operator. It finds the exact
minimum and maximum color values in the image and then applies a <a
>-auto-level</a> is the perfect or ideal version these operators. </p>
<p>It uses the <a href="command-line-options.html#channel" >-channel</a> setting, (including the
-special '<em>sync</em>' flag for channel synchronization), to determine
+special '<var>sync</var>' flag for channel synchronization), to determine
which color values are used and modified. As the default <a
-href="command-line-options.html#channel" >+channel</a> setting is '<em>RGB,sync</em>', the
-'<em>sync</em>' ensures that the color channels will are modified
+href="command-line-options.html#channel" >+channel</a> setting is '<var>RGB,sync</var>', the
+'<var>sync</var>' ensures that the color channels will are modified
together by the same gamma value, preserving colors, and ignoring
transparency. </p>
<div style="margin: auto;">
- <h4><a id="auto-orient"></a>-auto-orient</h4>
+ <h3><a class="anchor" id="auto-orient"></a>-auto-orient</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>adjusts an image so that its orientation is suitable for viewing (i.e. top-left orientation).</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">adjusts an image so that its orientation is suitable for viewing (i.e. top-left orientation).</p>
<p>This operator reads and resets the EXIF image profile setting 'Orientation'
and then performs the appropriate 90 degree rotation on the image to orient
result. If the EXIF profile was previously stripped, the <a
href="command-line-options.html#auto-orient" >-auto-orient</a> operator will do nothing. </p>
+<div style="margin: auto;">
+ <h3><a class="anchor" id="auto-threshold"></a>-auto-threshold <var>method</var></h3>
+</div>
+
+<p class="magick-description">automatically perform image thresholding.</p>
+
+<p>Here are the valid methods:</p>
+
+<dl class="row">
+<dt class="col-md-4">Undefined</dt><dd class="col-md-8">0: No method specified (equivalent to '<code>OTSU</code>').</dd>
+<dt class="col-md-4">Kapur</dt><dd class="col-md-8">maximum entropy thresholding.</dd>
+<dt class="col-md-4">OTSU</dt><dd class="col-md-8">cluster-based image thresholding.</dd>
+<dt class="col-md-4">Triangle</dt><dd class="col-md-8">a geometric thresholding method.</dd>
+</dl>
+
+<p>The computed threshold is returned as the <kbd>auto-threshold:threshold</kbd> image property.</p>
<div style="margin: auto;">
- <h4><a id="average"></a>-average</h4>
+ <h3><a class="anchor" id="average"></a>-average</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Average a set of images.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Average a set of images.</p>
<p>An error results if the images are not identically sized.</p>
<div style="margin: auto;">
- <h4><a id="backdrop"></a>-backdrop</h4>
+ <h3><a class="anchor" id="backdrop"></a>-backdrop</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Display the image centered on a backdrop.</td><td style='text-align:right;'>[<a href="animate.html">animate</a>, <a href="display.html">display</a>]</td></tr></table>
+<p class="magick-description">Display the image centered on a backdrop.</p>
<p>This backdrop covers the entire workstation screen and is useful for hiding
other X window activity while viewing the image. The color of the backdrop is
described under the <a href="command-line-options.html#fill">-fill</a> option.</p>
<div style="margin: auto;">
- <h4><a id="background"></a>-background <em class="arg">color</em></h4>
+ <h3><a class="anchor" id="background"></a>-background <var>color</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the background color.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set the background color.</p>
<p>The color is specified using the format described under the <a
href="command-line-options.html#fill">-fill</a> option. The default background color (if none is
specified or found in the image) is white.</p>
<div style="margin: auto;">
- <h4><a id="bench"></a>-bench <em class="arg">iterations</em></h4>
+ <h3><a class="anchor" id="bench"></a>-bench <var>iterations</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Measure performance.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Measure performance.</p>
-<p>Repeat the entire command for the given number of <em class="arg"
->iterations</em> and report the user-time and elapsed time. For instance,
+<p>Repeat the entire command for the given number of <var>iterations</var> and report the user-time and elapsed time. For instance,
consider the following command and its output. Modify the benchmark with the
-duration to run the benchmark for a fixed number of seconds and -concurrent
to run the benchmark in parallel (requires the OpenMP feature).</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert logo: -resize 1000% -bench 5 logo.png</span><span class='crtout'>Performance[4]: 5i 0.875657ips 6.880u 0:05.710</span></p>
-<p>In this example, 5 iterations were completed at 0.875657 iterations per
-second, using 4 threads and 6.88 seconds of the user's allotted time, for
-a total elapsed time of 5.71 seconds.</p>
+<pre class="highlight"><code>-> convert logo: -resize 200% -bench 5 logo.png
+Performance[1]: 5i 1.344ips 1.000e 3.710u 0:03.720
+Performance[2]: 5i 1.634ips 0.549e 3.890u 0:03.060
+Performance[3]: 5i 2.174ips 0.618e 3.190u 0:02.300
+Performance[4]: 5i 1.678ips 0.555e 3.810u 0:02.980
+Performance[4]: 5i 0.875657ips 6.880u 0:05.710
+</code></pre>
+
+<p>In this example, 5 iterations were completed at 2.174 iterations per
+second, using 3 threads and 3.190 seconds of the user allotted time, for
+a total elapsed time of 2.300 seconds.</p>
<div style="margin: auto;">
- <h4><a id="bias"></a>-bias <em class="arg">value</em>{<em class="arg">%</em>}</h4>
+ <h3><a class="anchor" id="bias"></a>-bias <var>value</var>{<var>%</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Add bias when convolving an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Add bias when convolving an image.</p>
<p>This option shifts the output of <a href="command-line-options.html#convolve">‑convolve</a> so that
positive and negative results are relative to the specified bias value. </p>
<p>See the discussion on HDRI implementations of ImageMagick on the page <a
href="high-dynamic-range.html" >High Dynamic-Range Images</a>. For more
about HDRI go the ImageMagick <a
-href="http://www.imagemagick.org/Usage/basics/#hdri" >Usage</a> pages or this
+href="../Usage/basics/#hdri" >Usage</a> pages or this
<a
href="http://en.wikipedia.org/wiki/High_dynamic_range_imaging">Wikipedia</a>
entry. </p>
<div style="margin: auto;">
- <h4><a id="black-point-compensation"></a>-black-point-compensation</h4>
+ <h3><a class="anchor" id="black-point-compensation"></a>-black-point-compensation</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Use black point compensation.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Use black point compensation.</p>
<div style="margin: auto;">
- <h4><a id="black-threshold"></a>-black-threshold <em class="arg">value</em>{<em class="arg">%</em>}</h4>
+ <h3><a class="anchor" id="black-threshold"></a>-black-threshold <var>value</var>{<var>%</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Force to black all pixels below the threshold while leaving all pixels at or above the threshold unchanged.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Force to black all pixels below the threshold while leaving all pixels at or above the threshold unchanged.</p>
<p> The threshold value can be given as a percentage or as an absolute integer
-value within [0, <em class="QR">QuantumRange</em>] corresponding to the
+value within [0, <var>QuantumRange</var>] corresponding to the
desired <a href="command-line-options.html#channel">‑channel</a> value. See <a href="command-line-options.html#threshold">‑threshold</a>for more details on thresholds and resulting values. </p>
<div style="margin: auto;">
- <h4><a id="blend"></a>-blend <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="blend"></a>-blend <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>blend an image into another by the given absolute value or percent.</td><td style='text-align:right;'>[<a href="composite.html">composite</a>]</td></tr></table>
+<p class="magick-description">blend an image into another by the given absolute value or percent.</p>
<p>Blend will average the images together ('plus') according to the
percentages given and each pixels transparency. If only a single percentage
<div style="margin: auto;">
- <h4><a id="blue-primary"></a>-blue-primary <em class="arg">x</em>,<em class="arg">y</em></h4>
+ <h3><a class="anchor" id="blue-primary"></a>-blue-primary <var>x</var>,<var>y</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the blue chromaticity primary point.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set the blue chromaticity primary point.</p>
<div style="margin: auto;">
- <h4><a id="blue-shift"></a>-blue-shift <em class="arg">factor</em></h4>
+ <h3><a class="anchor" id="blue-shift"></a>-blue-shift <var>factor</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>simulate a scene at nighttime in the moonlight. Start with a factor of 1.5</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">simulate a scene at nighttime in the moonlight. Start with a factor of 1.5</p>
<div style="margin: auto;">
<div style="margin: auto;">
- <h4><a id="blur"></a>-blur <em class="arg">radius</em><br />-blur <em class="arg">radius</em>x<em class="arg">sigma</em></h4>
+ <h3><a class="anchor" id="blur"></a>-blur <var>radius</var><br />-blur <var>radius</var>x<var>sigma</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Reduce image noise and reduce detail levels.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Reduce image noise and reduce detail levels.</p>
<p>Convolve the image with a Gaussian or normal distribution using the given
-<em class="arg" >Sigma</em> value. The formula is:</p>
+<var >Sigma</var> value. The formula is:</p>
-<div class="eqn"><img alt="gaussian distribution" width="243px" height="42px" src="../images/gaussian-blur.png"/>
-</div>
+<p class="text-center"><img class="img-thumbnail" alt="gaussian distribution" width="243px" height="42px" src="../images/gaussian-blur.png"/></p>
-<p>The <em class="arg" >Sigma</em> value is the important argument, and
+<p>The <var >Sigma</var> value is the important argument, and
determines the actual amount of blurring that will take place. </p>
-<p>The <em class="arg" >Radius</em> is only used to determine the size of the
+<p>The <var >Radius</var> is only used to determine the size of the
array which will hold the calculated Gaussian distribution. It should be an
integer. If not given, or set to zero, IM will calculate the largest possible
radius that will provide meaningful results for the Gaussian distribution.
</p>
-<p>The larger the <em class="arg" >Radius</em> the slower the
-operation is. However too small a <em class="arg" >Radius</em>, and sever
-aliasing effects may result. As a guideline, <em class="arg" >Radius</em>
-should be at least twice the <em class="arg" >Sigma</em> value, though three
+<p>The larger the <var >Radius</var> the slower the
+operation is. However too small a <var >Radius</var>, and severe
+aliasing effects may result. As a guideline, <var >Radius</var>
+should be at least twice the <var >Sigma</var> value, though three
times will produce a more accurate result. </p>
<p>This option differs from <a href="command-line-options.html#gaussian-blur">-gaussian-blur</a> simply
<div style="margin: auto;">
- <h4>-blur <em class="arg">Width</em>[x<em class="arg">Height</em>[+<em class="arg">Angle</em>]]</h4>
+ <h3><a class="anchor" id="border"></a>-border <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Variably blur an image according to the overlay mapping.</td><td style='text-align:right;'>[<a href="composite.html">composite</a>]</td></tr></table>
-
-<p>Each pixel in the overlaid region is replaced with an Elliptical Weighted
-Average (EWA) of the source image, scaled according to the grayscale
-mapping. </p>
-
-<p>The ellipse is weighted with sigma set to the given <em class="arg"
->Width</em> and <em class="arg" >Height</em>. The <em class="arg" >Height</em>
-defaults to the <em class="arg" >Width</em> for a normal circular Gaussian
-weighting. The <em class="arg" >Angle</em> will rotate the ellipse from
-horizontal clock-wise. </p>
-
-<p>The <a href="command-line-options.html#virtual-pixel">-virtual-pixel</a> setting will determine how
-pixels which are outside the image proper are blurred into the final result.
-</p>
+<p class="magick-description">Surround the image with a border of color. </p>
-
-<div style="margin: auto;">
- <h4><a id="border"></a>-border <em class="arg">geometry</em></h4>
-</div>
-
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Surround the image with a border of color. </td><td style='text-align:right;'></td></tr></table>
-
-<p>Set the width and height using the <em class="arg">size</em> portion of the
-<em class="arg">geometry</em> argument. See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. Offsets are
+<p>Set the width and height using the <var>size</var> portion of the
+<var>geometry</var> argument. See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. Offsets are
ignored. </p>
-<p>As of IM 6.7.8-8, the <em class="arg">geometry</em> arguments behave as follows:</p>
-
-<table id="borderTable" class="doc">
- <col width="20%"/> <col width="80%"/>
- <thead>
- <tr valign="top">
- <th style="text-align:center"><em class="arg">size</em></th>
- <th>General description</th>
- </tr>
- </thead>
- <tbody>
- <tr valign="top">
- <td><em class="arg">value</em></td>
- <td>value is added to both left/right and top/bottom</td>
- </tr>
- <tr valign="top">
- <td><em class="arg">value-x</em>x</td>
- <td>value-x is added only to left/right and top/bottom are unchanged</td>
- </tr>
- <tr valign="top">
- <td>x<em class="arg">value-y</em></td>
- <td>value-y is added only to top/bottom and left/right are unchanged</td>
- </tr>
- <tr valign="top">
- <td><em class="arg">value-x</em>x<em class="arg">value-y</em></td>
- <td>value-x is added to left/right and value-y added to top/bottom</td>
- </tr>
- <tr valign="top">
- <td><em class="arg">value-x</em>x<code>0</code></td>
- <td>value-x is added only to left/right and top/bottom are unchanged</td>
- </tr>
- <tr valign="top">
- <td><code>0</code>x<em class="arg">value-y</em></td>
- <td>value-y is added only to top/bottom and left/right are unchanged</td>
- </tr>
- <tr valign="top">
- <td> </td>
- <td> </td>
- </tr>
- <tr valign="top">
- <td><em class="arg">value</em>%</td>
- <td>value % of width is added to left/right and value % of height is added to top/bottom</td>
- </tr>
- <tr valign="top">
- <td><em class="arg">value-x</em>x%</td>
- <td>value-x % of width is added to left/right and to top/bottom</td>
- </tr>
- <tr valign="top">
- <td>x<em class="arg">value-y</em>%</td>
- <td>value-y % of height is added to top/bottom and to left/right</td>
- </tr>
- <tr valign="top">
- <td><em class="arg">value-x</em>%x<em class="arg">value-y</em>%</td>
- <td>value-x % of width is added to left/right and value-y % of height is added to top/bottom</td>
- </tr>
- <tr valign="top">
- <td><em class="arg">value-x</em>%x<code>0</code>%</td>
- <td>value-x % of width is added to left/right and top/bottom are unchanged</td>
- </tr>
- <tr valign="top">
- <td><code>0</code>%x<em class="arg">value-y</em>%</td>
- <td>value-y % of height is added to top/bottom and left/right are unchanged</td>
- </tr>
- </tbody>
- </table>
-
+<p>As of IM 6.7.8-8, the <var>geometry</var> arguments behave as follows:</p>
+
+<dl class="row">
+<dt class="col-md-4"><var>value</var></dt>
+<dd class="col-md-8">value is added to both left/right and top/bottom</dd>
+<dt class="col-md-4"><var>value-x</var><code>x</code></dt>
+<dd class="col-md-8">value-x is added only to left/right and top/bottom are unchanged</dd>
+<dt class="col-md-4"><code>x</code><var>value-y</var></dt>
+<dd class="col-md-8">value-y is added only to top/bottom and left/right are unchanged</dd>
+<dt class="col-md-4"><var>value-x</var><code>x</code><var>value-y</var></dt>
+<dd class="col-md-8">value-x is added to left/right and value-y added to top/bottom</dd>
+<dt class="col-md-4"><var>value-x</var><code>x</code>0</dt>
+<dd class="col-md-8">value-x is added only to left/right and top/bottom are unchanged</dd>
+<dt class="col-md-4">0<code>x</code><var>value-y</var></dt>
+<dd class="col-md-8">value-y is added only to top/bottom and left/right are unchanged</dd>
+<dt class="col-md-4"><var>value</var>%</dt>
+<dd class="col-md-8">value % of width is added to left/right and value % of height is added to top/bottom</dd>
+<dt class="col-md-4"><var>value-x</var><code>x</code>%</dt>
+<dd class="col-md-8">value-x % of width is added to left/right and to top/bottom</dd>
+<dt class="col-md-4">x<var>value-y</var>%</dt>
+<dd class="col-md-8">value-y % of height is added to top/bottom and to left/right</dd>
+<dt class="col-md-4"><var>value-x</var>%<code>x</code><var>value-y</var>%</dt>
+<dd class="col-md-8">value-x % of width is added to left/right and value-y % of height is added to top/bottom</dd>
+<dt class="col-md-4"><var>value-x</var>%<code>x</code>0%</dt>
+<dd class="col-md-8">value-x % of width is added to left/right and top/bottom are unchanged</dd>
+<dt class="col-md-4">0%<code>x</code><var>value-y</var>%</dt>
+<dd class="col-md-8">value-y % of height is added to top/bottom and left/right are unchanged</dd>
+</dl>
<p>Set the border color by preceding with the <a
href="command-line-options.html#bordercolor">-bordercolor</a> setting.</p>
functionality.</p>
<div style="margin: auto;">
- <h4><a id="bordercolor"></a>-bordercolor <em class="arg">color</em></h4>
+ <h3><a class="anchor" id="bordercolor"></a>-bordercolor <var>color</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the border color.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set the border color.</p>
<p>The color is specified using the format described under the <a href="command-line-options.html#fill">-fill</a> option.</p>
<p>The default border color is <code>#DFDFDF</code>, <span style="background-color: #dfdfdf;">this shade of gray</span>.</p>
<div style="margin: auto;">
- <h4><a id="borderwidth"></a>-borderwidth <em class="arg">geometry</em> </h4>
+ <h3><a class="anchor" id="borderwidth"></a>-borderwidth <var>geometry</var> </h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the border width.</td><td style='text-align:right;'>[<a href="animate.html">animate</a>, <a href="display.html">display</a>]</td></tr></table>
+<p class="magick-description">Set the border width.</p>
<div style="margin: auto;">
- <h4><a id="brightness-contrast"></a>-brightness-contrast <em class="arg">brightness</em><br />-brightness-contrast <em class="arg">brightness</em>{x<em class="arg">contrast</em>}{<em class="arg">%</em>}}</h4>
+ <h3><a class="anchor" id="brightness-contrast"></a>-brightness-contrast <var>brightness</var><br />-brightness-contrast <var>brightness</var>{x<var>contrast</var>}{<var>%</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Adjust the brightness and/or contrast of the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Adjust the brightness and/or contrast of the image.</p>
<p>Brightness and Contrast values apply changes to the input image. They are
not absolute settings. A brightness or contrast value of zero means no change.
symbol is no different than leaving it off.</p>
<div style="margin: auto;">
- <h4><a id="cache"></a>-cache <em class="arg">threshold</em></h4>
+ <h3><a class="anchor" id="cache"></a>-cache <var>threshold</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>(This option has been replaced by the <a href='command-line-options.html#limit'>-limit</a> option.)</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">(This option has been replaced by the <a href='command-line-options.html#limit'>-limit</a> option).</p>
<div style="margin: auto;">
- <h4><a id="canny"></a>-canny <em class="arg">radius</em><br />-canny <em class="arg">radius</em>x<em class="arg">sigma</em>{<em class="arg">+lower-percent</em>}{<em class="arg">+upper-percent</em>}</h4>
+ <h3><a class="anchor" id="canny"></a>-canny <var>radius</var><br/>-canny <var>radius</var>x<var>sigma</var>{<var>+lower-percent</var>}{<var>+upper-percent</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Canny edge detector uses a multi-stage algorithm to detect a wide range of edges in the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Canny edge detector uses a multi-stage algorithm to detect a wide range of edges in the image.</p>
-<p>The thresholds range from 0 to 100% (e.g. -canny 0x1+10%+30%) with {<em class="arg">+lower-percent</em>} < {<em class="arg">+upper-percent</em>}. If {<em class="arg">+upper-percent</em>} is increased but {<em class="arg">+lower-percent</em>} remains the same, lesser edge components will be detected, but their lengths will be the same. If {<em class="arg">+lower-percent</em>} is increased but {<em class="arg">+upper-percent</em>} is the same, the same number of edge components will be detected but their lengths will be shorter. The default thresholds are shown. The <em class="arg">radius</em>x<em class="arg">sigma</em> controls a gaussian blur applied to the input image to reduce noise and smooth the edges.</p>
+<p>The thresholds range from 0 to 100% (e.g. -canny 0x1+10%+30%) with {<var>+lower-percent</var>} < {<var>+upper-percent</var>}. If {<var>+upper-percent</var>} is increased but {<var>+lower-percent</var>} remains the same, lesser edge components will be detected, but their lengths will be the same. If {<var>+lower-percent</var>} is increased but {<var>+upper-percent</var>} is the same, the same number of edge components will be detected but their lengths will be shorter. The default thresholds are shown. The <var>radius</var>x<var>sigma</var> controls a gaussian blur applied to the input image to reduce noise and smooth the edges.</p>
<div style="margin: auto;">
- <h4><a id="caption"></a>-caption <em class="arg">string</em></h4>
+ <h3><a class="anchor" id="caption"></a>-caption <var>string</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Assign a caption to an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Assign a caption to an image.</p>
<p>This option sets the caption meta-data of an image read in after this
option has been given. To modify a caption of images already in memory use
Print Image Properties</a>. These attributes are expanded when the caption
is finally assigned to the individual images. </p>
-<p>If the first character of <em class="arg">string</em> is <em
-class="arg">@</em>, the image caption is read from a file titled by the
+<p>If the first character of <var>string</var> is <var>@</var>, the image caption is read from a file titled by the
remaining characters in the string. Comments read in from a file are literal;
no embedded formatting characters are recognized.</p>
<p>For example,</p>
-<p class="crtsnip">
- -caption "%m:%f %wx%h" bird.miff
-</p>
+<pre class="highlight"><code>-caption "%m:%f %wx%h" bird.miff
+</code></pre>
<p>produces an image caption of <code>MIFF:bird.miff 512x480</code> (assuming
that the image <code>bird.miff</code> has a width of 512 and a height of
<div style="margin: auto;">
- <h4><a id="cdl"></a>-cdl <em class="arg">filename</em></h4>
+ <h3><a class="anchor" id="cdl"></a>-cdl <var>filename</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>color correct with a color decision list.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">color correct with a color decision list.</p>
<p>Here is an example color correction collection:</p>
-<pre class="text">
-<?xml version="1.0" encoding="UTF-8"?>
+<pre class="highlight"><code><?xml version="1.0" encoding="UTF-8"?>
<ColorCorrectionCollection xmlns="urn:ASC:CDL:v1.2">
<ColorCorrection id="cc06668">
<SOPNode>
</SATNode>
</ColorCorrection>
</ColorCorrectionCollection>
-</pre>
+</code></pre>
<div style="margin: auto;">
- <h4><a id="channel"></a>-channel <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="channel"></a>-channel <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Specify those image color channels to which subsequent operators are limited.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Specify those image color channels to which subsequent operators are limited.</p>
<p>Choose from: <code>Red</code>, <code>Green</code>, <code>Blue</code>,
-<code>Alpha</code>, <code>Cyan</code>, <code>Magenta</code>, <code>Yellow</code>,
-<code>Black</code>, <code>Opacity</code>, <code>Index</code>, <code>RGB</code>,
-<code>RGBA</code>, <code>CMYK</code>, or <code>CMYKA</code>.</p>
+<code>Alpha</code>, <code>Gray</code>, <code>Cyan</code>, <code>Magenta</code>,
+<code>Yellow</code>, <code>Black</code>, <code>Opacity</code>,
+<code>Index</code>, <code>RGB</code>, <code>RGBA</code>, <code>CMYK</code>, or
+<code>CMYKA</code>.</p>
<p>The channels above can also be specified as a comma-separated list or can be
abbreviated as a concatenation of the letters '<code>R</code>', '<code>G</code>',
'<code>B</code>', '<code>A</code>', '<code>O</code>', '<code>C</code>',
-'<code>M</code>', '<code>Y</code>', '<code>K</code>'.
-
-For example, to only select the <code>Red</code> and <code>Blue</code> channels
-you can either use </p>
-<p class="crtsnip">
- -channel Red,Blue
-</p>
-<p>or you can use the short hand form</p>
-<p class="crtsnip">
- -channel RB
-</p>
+'<code>M</code>', '<code>Y</code>', '<code>K</code>'.</p>
+
+<p>The numerals 0 to 31 may also be used to specify channels, where 0 to 5 are: <br />
+'<code>0</code>' equals <code>Red</code> or <code>Cyan</code> <br />
+'<code>1</code>' equals <code>Green</code> or <code>Magenta</code> <br />
+'<code>2</code>' equals <code>Blue</code> or <code>Yellow</code> <br />
+'<code>3</code>' equals <code>Black</code> <br />
+'<code>4</code>' equals <code>Alpha</code> or <code>Opacity</code> <br />
+'<code>5</code>' equals <code>Index</code></p>
+
+<p>For example, to only select the <code>Red</code> and <code>Blue</code> channels
+you can use any of the following:</p>
+<pre class="highlight">
+<code>-channel Red,Blue</code>
+<code>-channel R,B</code>
+<code>-channel RB</code>
+<code>-channel 0,2</code>
+</pre>
<p>All the channels that are present in an image can be specified using the
special channel type <code>All</code>. Not all operators are 'channel capable',
<p>The <a href="command-line-options.html#morphology">-morphology</a> '<code>Convolve</code>' method
and the <a href="command-line-options.html#compose">-compose</a> mathematical methods, also understands
-the '<code>Sync</code>' flag to modify the behaviour of pixel colors according
+the '<code>Sync</code>' flag to modify the behavior of pixel colors according
to the alpha channel (if present). That is to say it will modify the image
processing with the understanding that fully-transparent colors should not
contribute to the final result. </p>
<p>To print a complete list of channel types, use <a href="command-line-options.html#list">-list
channel</a>.</p>
-<br />
-
<p>By default, ImageMagick sets <a href="command-line-options.html#channel">-channel</a> to the value
'<code>RGBK,sync</code>', which specifies that operators act on all color
channels except the transparency channel, and that all the color channels are
default). These operators have yet to be made to understand the newer 'Sync'
flag. </p>
-<p>For example <a href="command-line-options.html#threshold">-threshold</a> will by default gray-scale
+<p>For example <a href="command-line-options.html#threshold">-threshold</a> will by default grayscale
the image before thresholding, if no <a href="command-line-options.html#channel" >-channel</a> setting
has been defined. This is not 'Sync flag controlled, yet. </p>
the operator to apply the operation using alpha channels. The <a
href="command-line-options.html#clut">-clut</a> operator is a good example of this. </p>
+<div style="margin: auto;">
+ <h3><a class="anchor" id="channel-fx"></a>-channel-fx <var>expression</var></h3>
+</div>
+
+<p class="magick-description">exchange, extract, or copy one or more image channels.</p>
+
+<p>The expression consists of one or more channels, either mnemonic or numeric (e.g. red or 0, green or 1, etc.), separated by certain operation symbols as follows:</p>
+
+<pre class="highlight"><code><=> exchange two channels (e.g. red<=>blue)
+=> copy one channel to another channel (e.g. red=>green)
+= assign a constant value to a channel (e.g. red=50%)
+, write new image with channels in the specified order (e.g. red, green)
+; add a new output image for the next set of channel operations (e.g. red; green; blue)
+| move to the next input image for the source of channel data (e.g. | gray=>alpha)
+</code></pre>
+<p>For example, to create 3 grayscale images from the red, green, and blue channels of an image, use:</p>
+
+<pre class="highlight"><code>-channel-fx "red; green; blue"
+</code></pre>
+
+<p>A channel without an operation symbol implies separate (i.e, semicolon).</p>
+
+<p>Here we take an sRGB image and a grayscale image and inject the grayscale image into the alpha channel:</p>
+<pre class="highlight"><code>convert wizard.png mask.pgm -channel-fx '| gray=>alpha' wizard-alpha.png
+</code></pre>
+<p>Use a similar command to define a read mask:</p>
+<pre class="highlight"><code>convert wizard.png mask.pgm -channel-fx '| gray=>read-mask' wizard-mask.png
+</code></pre>
+
+<p>Add <code>-debug pixel</code> prior to the <code>-channel-fx</code> option to track the channel morphology.</p>
<div style="margin: auto;">
- <h4><a id="charcoal"></a>-charcoal <em class="arg">factor</em></h4>
+ <h3><a class="anchor" id="charcoal"></a>-charcoal <var>factor</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Simulate a charcoal drawing.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Simulate a charcoal drawing.</p>
<div style="margin: auto;">
- <h4><a id="chop"></a>-chop <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="chop"></a>-chop <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Remove pixels from the interior of an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Remove pixels from the interior of an image.</p>
-<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. The <em class="arg">width</em>
-and <em class="arg">height</em> given in the of the <em class="arg">size</em>
-portion of the <em class="arg">geometry</em> argument give the number of
-columns and rows to remove. The <em class="arg">offset</em> portion of
-the <em class="arg">geometry</em> argument is influenced by
+<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. The <var>width</var>
+and <var>height</var> given in the of the <var>size</var>
+portion of the <var>geometry</var> argument give the number of
+columns and rows to remove. The <var>offset</var> portion of
+the <var>geometry</var> argument is influenced by
a <a href="command-line-options.html#gravity">-gravity</a> setting, if present.</p>
<p>The <a href="command-line-options.html#chop">-chop</a> option removes entire rows and columns,
<p>While it can remove internal rows and columns of pixels, it is more
typically used with as <a href="command-line-options.html#gravity">-gravity</a> setting and zero
offsets so as to remove a single edge from an image. Compare this to <a
-href="command-line-options.html#shave" >-shave</a> which removes equal numbers of pixels from oppisite
+href="command-line-options.html#shave" >-shave</a> which removes equal numbers of pixels from opposite
sides of the image. </p>
<p>Using <a href="command-line-options.html#chop">-chop</a> effectively undoes the results of a <a
-href="command-line-options.html#splice">-splice</a> that was given the same <em
-class="arg">geometry</em> and <a href="command-line-options.html#gravity">-gravity</a> settings. </p>
+href="command-line-options.html#splice">-splice</a> that was given the same <var>geometry</var> and <a href="command-line-options.html#gravity">-gravity</a> settings. </p>
<div style="margin: auto;">
- <h4><a id="clamp"></a>-clamp</h4>
+ <h3><a class="anchor" id="clamp"></a>-clamp</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>set each pixel whose value is below zero to zero and any the pixel whose value is above the quantum range to the quantum range (e.g. 65535) otherwise the pixel value remains unchanged.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">set each pixel whose value is below zero to zero and any the pixel whose value is above the quantum range to the quantum range (e.g. 65535) otherwise the pixel value remains unchanged.</p>
<div style="margin: auto;">
- <h4><a id="clip"></a>-clip</h4>
+ <h3><a class="anchor" id="clip"></a>-clip</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Apply the clipping path if one is present.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Apply the clipping path if one is present.</p>
<p>If a clipping path is present, it is applied to subsequent operations.</p>
<p>For example, in the command</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert cockatoo.tif -clip -negate negated.tif</span></p>
+<pre class="highlight"><code>convert cockatoo.tif -clip -negate negated.tif
+</code></pre>
+
<p>only the pixels within the clipping path are negated.</p>
<p>The <a href="command-line-options.html#clip">-clip</a> feature requires SVG support. If the SVG
<p>Use <a href="command-line-options.html#clip">+clip</a> to disable clipping for subsequent operations.</p>
<div style="margin: auto;">
- <h4><a id="clip-mask"></a>-clip-mask</h4>
+ <h3><a class="anchor" id="clip-mask"></a>-clip-mask</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Clip the image as defined by this mask.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Clip the image as defined by this mask.</p>
<p>Use the alpha channel of the current image as a mask. Any areas that is
white is not modified by any of the 'image processing operators' that follow,
<p>Use <a href="command-line-options.html#clip-mask">+clip-mask</a> to disable clipping for subsequent operations.</p>
<div style="margin: auto;">
- <h4><a id="clip-path"></a>-clip-path <em class="arg">id</em></h4>
+ <h3><a class="anchor" id="clip-path"></a>-clip-path <var>id</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Clip along a named path from the 8BIM profile.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Clip along a named path from the 8BIM profile.</p>
<p>This is identical to <a href="command-line-options.html#clip">-clip</a> except choose a specific clip path in the event the image has more than one path available. </p>
<p>Use <a href="command-line-options.html#clip-path">+clip-path</a> to disable clipping for subsequent operations.</p>
<div style="margin: auto;">
- <h4><a id="clone"></a>-clone <em class="arg">index(s)</em></h4>
+ <h3><a class="anchor" id="clone"></a>-clone <var>index(s)</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>make a clone of an image (or images).</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">make a clone of an image (or images).</p>
<p>Inside parenthesis (where the operator is normally used) it will make a
clone of the images from the last 'pushed' image sequence, and adds them to
'<code>−1</code>'. </p>
<div style="margin: auto;">
- <h4><a id="clut"></a>-clut</h4>
+ <h3><a class="anchor" id="clut"></a>-clut</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Replace the channel values in the first image using each
-corresponding channel in the second image as a <b>c</b>olor
-<b>l</b>ook<b>u</b>p <b>t</b>able.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Replace the channel values in the first image using each corresponding channel in the second image as a <b>c</b>olor <b>l</b>ook<b>u</b>p <b>t</b>able.</p>
<p>The second (LUT) image is ordinarily a gradient image containing the
histogram mapping of how each channel should be modified. Typically it is a
<p>If either the image being modified, or the lookup image, contains no
transparency (i.e. <a href="command-line-options.html#alpha" >-alpha</a> is turned 'off') but the <a
href="command-line-options.html#channel">-channel</a> setting includes alpha replacement, then it is
-assumed that image represents a gray-scale gradient which is used for the
-replacement alpha values. That is you can use a gray-scale CLUT image to
-adjust a existing images alpha channel, or you can color a gray-scale image
+assumed that image represents a grayscale gradient which is used for the
+replacement alpha values. That is you can use a grayscale CLUT image to
+adjust a existing images alpha channel, or you can color a grayscale image
using colors form CLUT containing the desired colors, including transparency.
</p>
<div style="margin: auto;">
- <h4><a id="coalesce"></a>-coalesce</h4>
+ <h3><a class="anchor" id="coalesce"></a>-coalesce</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Fully define the look of each frame of an GIF animation sequence, to form a 'film strip' animation.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Fully define the look of each frame of an GIF animation sequence, to form a 'film strip' animation.</p>
<p>Overlay each image in an image sequence according to
its <a href="command-line-options.html#dispose">-dispose</a> meta-data, to reproduce the look of
<div style="margin: auto;">
- <h4><a id="colorize"></a>-colorize <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="colorize"></a>-colorize <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Colorize the image by an amount specified by <em class="arg">value</em> using the color specified by the most recent <a href="command-line-options.html#fill" >-fill</a> setting.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Colorize the image by an amount specified by <var>value</var> using the color specified by the most recent <a href="command-line-options.html#fill" >-fill</a> setting.</p>
<p>Specify the amount of colorization as a percentage. Separate colorization
values can be applied to the red, green, and blue channels of the image with
values (e.g., <code>-colorize 0,0,50</code>).</p>
<div style="margin: auto;">
- <h4><a id="colormap"></a>-colormap <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="colormap"></a>-colormap <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Define the colormap type.</td><td style='text-align:right;'>[<a href="animate.html">animate</a>, <a href="display.html">display</a>]</td></tr></table>
+<p class="magick-description">Define the colormap type.</p>
-<p>The <em class="arg">type</em> can be <code>shared</code> or <code>private</code>.</p>
+<p>The <var>type</var> can be <code>shared</code> or <code>private</code>.</p>
<p>This option only applies when the default X server visual
is <code>PseudoColor</code> or <code>GrayScale</code>. Refer
other X clients. Some image colors could be approximated,
therefore your image may look very different than intended.
If <code>private</code> is chosen, the image colors appear exactly
-as they are defined. However, other clients may go <em>technicolor</em>
+as they are defined. However, other clients may go <var>technicolor</var>
when the image colormap is installed.</p>
<div style="margin: auto;">
- <h4><a id="colors"></a>-colors <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="colors"></a>-colors <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the preferred number of colors in the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set the preferred number of colors in the image.</p>
<p>The actual number of colors in the image may be less than your request,
but never more. Note that this a color reduction option. Images with fewer
-unique colors than specified by <em class="arg">value</em> will have any
+unique colors than specified by <var>value</var> will have any
duplicate or unused colors removed. The ordering of an existing color
palette may be altered. When converting an image from color to grayscale,
it is more efficient to convert the image to the gray colorspace before
reducing the number of colors. Refer to
-the <a href="quantize.html">
+the <a href="../www/quantize.html">
color reduction algorithm</a> for more details.</p>
<div style="margin: auto;">
- <h4><a id="color-matrix"></a>-color-matrix <em class="arg">matrix</em></h4>
+ <h3><a class="anchor" id="color-matrix"></a>-color-matrix <var>matrix</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>apply color correction to the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">apply color correction to the image.</p>
<p>This option permits saturation changes, hue rotation, luminance to alpha,
and various other effects. Although variable-sized transformation matrices
<p>As an example, to add contrast to an image with offsets, try this command:</p>
-<pre class="text">
- convert kittens.jpg -color-matrix \
- " 1.5 0.0 0.0 0.0, 0.0, -0.157 \
- 0.0 1.5 0.0 0.0, 0.0, -0.157 \
- 0.0 0.0 1.5 0.0, 0.0, -0.157 \
- 0.0 0.0 0.0 1.0, 0.0, 0.0 \
- 0.0 0.0 0.0 0.0, 1.0, 0.0 \
- 0.0 0.0 0.0 0.0, 0.0, 1.0" kittens.png
-</pre>
+<pre class="highlight"><code>convert kittens.jpg -color-matrix \
+ " 1.5 0.0 0.0 0.0, 0.0, -0.157 \
+ 0.0 1.5 0.0 0.0, 0.0, -0.157 \
+ 0.0 0.0 1.5 0.0, 0.0, -0.157 \
+ 0.0 0.0 0.0 1.0, 0.0, 0.0 \
+ 0.0 0.0 0.0 0.0, 1.0, 0.0 \
+ 0.0 0.0 0.0 0.0, 0.0, 1.0" kittens.png
+</code></pre>
<div style="margin: auto;">
- <h4><a id="colorspace"></a>-colorspace <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="colorspace"></a>-colorspace <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the image colorspace.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set the image colorspace.</p>
<p>Choices are:</p>
-<pre class="text">
- CMY CMYK Gray HCL
- HCLp HSB HSI HSL
- HSV HWB Lab LCHab
- LCHuv LMS Log Luv
- OHTA Rec601YCbCr Rec709YCbCr RGB
- scRGB sRGB Transparent xyY
- XYZ YCbCr YCC YDbDr
- YIQ YPbPr YUV
-</pre>
+<pre class="highlight"><code>CMY CMYK Gray HCL
+HCLp HSB HSI HSL
+HSV HWB Lab LCHab
+LCHuv LMS Log Luv
+OHTA Rec601YCbCr Rec709YCbCr RGB
+scRGB sRGB Transparent xyY
+XYZ YCbCr YCC YDbDr
+YIQ YPbPr YUV Undefined
+</code></pre>
<p>To print a complete list of colorspaces, use <a href="command-line-options.html#list">-list colorspace</a>.</p>
<p>For a more accurate color conversion to or from the linear RGB, CMYK, or grayscale colorspaces, use the <a href="command-line-options.html#profile">-profile</a> option. Note, ImageMagick assumes the sRGB colorspace if the image format does not indicate otherwise. For colorspace conversion, the gamma function is first removed to produce linear RGB.</p>
-<table class="doc">
+<table class="table table-sm table-striped">
<caption>Conversion of RGB to Other Color Spaces</caption>
- <tr><th align="left" valign="middle">CMY</th></tr>
- <tr><td align="left" valign="middle">C=<em class="QR">QuantumRange</em>−R</td></tr>
- <tr><td align="left" valign="middle">M=<em class="QR">QuantumRange</em>−G</td></tr>
- <tr><td align="left" valign="middle">Y=<em class="QR">QuantumRange</em>−B</td></tr>
- <tr><th align="left" valign="middle">CMYK — starts with CMY from above</th></tr>
- <tr><td align="left" valign="middle">K=min(C,Y,M)</td></tr>
- <tr><td align="left" valign="middle">C=<em class="QR">QuantumRange</em>*(C−K)/(<em class="QR">QuantumRange</em>−K)</td></tr>
- <tr><td align="left" valign="middle">M=<em class="QR">QuantumRange</em>*(M−K)/(<em class="QR">QuantumRange</em>−K)</td></tr>
- <tr><td align="left" valign="middle">Y=<em class="QR">QuantumRange</em>*(Y−K)/(<em class="QR">QuantumRange</em>−K)</td></tr>
-
- <tr><th align="left" valign="middle">Gray</th></tr>
- <tr><td align="left" valign="middle">Gray = 0.298839*R+0.586811*G+0.114350*B</td></tr>
-
- <tr><th align="left" valign="middle">HSB — Hue, Saturation, Brightness; like a cone peak downward</th></tr>
- <tr><td align="left" valign="middle">H=angle around perimeter (0 to 360 deg); H=0 is red; increasing angles toward green</td></tr>
- <tr><td align="left" valign="middle">S=distance from axis outward</td></tr>
- <tr><td align="left" valign="middle">B=distance along axis from bottom upward; B=max(R,G,B); <em>intensity-like</em></td></tr>
-
- <tr><th align="left" valign="middle">HSL — Hue, Saturation, Lightness; like a double cone end-to-end with peaks at very top and bottom</th></tr>
- <tr><td align="left" valign="middle">H=angle around perimeter (0 to 360 deg); H=0 is red; increasing angles toward green</td></tr>
- <tr><td align="left" valign="middle">S=distance from axis outward</td></tr>
- <tr><td align="left" valign="middle">L=distance along axis from bottom upward; L=0.5*max(R,G,B) + 0.5*min(R,G,B); <em>intensity-like</em></td></tr>
-
- <tr><th align="left" valign="middle">HWB — Hue, Whiteness, Blackness</th></tr>
- <tr><td align="left" valign="middle">Hue (complicated equation)</td></tr>
- <tr><td align="left" valign="middle">Whiteness (complicated equation)</td></tr>
- <tr><td align="left" valign="middle">Blackness (complicated equation)</td></tr>
-
- <tr><th align="left" valign="middle">LAB</th></tr>
- <tr><td align="left" valign="middle">L (complicated equation relating X,Y,Z)</td></tr>
- <tr><td align="left" valign="middle">A (complicated equation relating X,Y,Z)</td></tr>
- <tr><td align="left" valign="middle">B (complicated equation relating X,Y,Z)</td></tr>
-
- <tr><th align="left" valign="middle">LOG</th></tr>
- <tr><td align="left" valign="middle">I1 (complicated equation involving logarithm of R)</td></tr>
- <tr><td align="left" valign="middle">I2 (complicated equation involving logarithm of G)</td></tr>
- <tr><td align="left" valign="middle">I3 (complicated equation involving logarithm of B)</td></tr>
-
- <tr><th align="left" valign="middle">OHTA — approximates principal components transformation</th></tr>
- <tr><td align="left" valign="middle">I1=0.33333*R+0.33334*G+0.33333*B; <em>intensity-like</em></td></tr>
- <tr><td align="left" valign="middle">I2=(0.50000*R+0.00000*G−0.50000*B)*(<em class="QR">QuantumRange</em>+1)/2</td></tr>
- <tr><td align="left" valign="middle">I3=(−0.25000*R+0.50000*G−0.25000*B)*(<em class="QR">QuantumRange</em>+1)/2</td></tr>
-
- <tr><th align="left" valign="middle">Rec601Luma</th></tr>
- <tr><td align="left" valign="middle">Gray = 0.298839*R+0.586811*G+0.114350*B</td></tr>
-
- <tr><th align="left" valign="middle">Rec601YCbCr</th></tr>
- <tr><td align="left" valign="middle">Y=0.2988390*R+0.5868110*G+0.1143500*B; <em>intensity-like</em></td></tr>
- <tr><td align="left" valign="middle">Cb=(−0.168736*R-0.331264*G+0.500000*B)*(<em class="QR">QuantumRange</em>+1)/2</td></tr>
- <tr><td align="left" valign="middle">Cr=(0.500000*R−0.418688*G−0.081312*B)*(<em class="QR">QuantumRange</em>+1)/2</td></tr>
-
- <tr><th align="left" valign="middle">Rec709Luma</th></tr>
- <tr><td align="left" valign="middle">Gray=0.212656*R+0.715158*G+0.072186*B</td></tr>
-
- <tr><th align="left" valign="middle">Rec709YCbCr</th></tr>
- <tr><td align="left" valign="middle">Y=0.212656*R+0.715158*G+0.072186*B; <em>intensity-like</em></td></tr>
- <tr><td align="left" valign="middle">Cb=(−0.114572*R−0.385428*G+0.500000*B)+(<em class="QR">QuantumRange</em>+1)/2</td></tr>
- <tr><td align="left" valign="middle">Cr=(0.500000*R−0.454153*G−0.045847*B)+(<em class="QR">QuantumRange</em>+1)/2</td></tr>
-
- <tr><th align="left" valign="middle">sRGB</th></tr>
- <tr><td align="left" valign="middle">if R ≤ .0.0031308 then Rs=R/12.92 else Rs=1.055 R ^ (1.0 / 2.4) ? 0.055</td></tr>
- <tr><td align="left" valign="middle">if G ≤ .0.0031308 then Gs=B/12.92 else Gs=1.055 R ^ (1.0 / 2.4) ? 0.055</td></tr>
- <tr><td align="left" valign="middle">if B ≤ .0.0031308 then Bs=B/12.92 else Bs=1.055 R ^ (1.0 / 2.4) ? 0.055</td></tr>
-
- <tr><th align="left" valign="middle">XYZ</th></tr>
- <tr><td align="left" valign="middle">X=0.4124240*R+0.3575790*G+0.1804640*B</td></tr>
- <tr><td align="left" valign="middle">Y=0.212656*R+0.715158*G+0.0721856*B</td></tr>
- <tr><td align="left" valign="middle">Z=0.0193324*R+0.1191930*G+0.9504440*B</td></tr>
-
- <tr><th align="left" valign="middle">YCC</th></tr>
- <tr><td align="left" valign="middle">Y=(0.298839*R+0.586811*G+0.114350*B) (with complicated scaling); <em>intensity-like</em></td></tr>
- <tr><td align="left" valign="middle">C1=(−0.298839*R−0.586811*G+0.88600*B) (with complicated scaling)</td></tr>
- <tr><td align="left" valign="middle">C2=(0.70100*R−0.586811*G−0.114350*B) (with complicated scaling)</td></tr>
-
- <tr><th align="left" valign="middle">YCbCr</th></tr>
- <tr><td align="left" valign="middle">Y=0.2988390*R+0.5868110*G+0.1143500*B; <em>intensity-like</em></td></tr>
- <tr><td align="left" valign="middle">Cb=(−0.168736*R−0.331264*G+0.500000*B)*(<em class="QR">QuantumRange</em>+1)/2</td></tr>
- <tr><td align="left" valign="middle">Cr=(0.500000*R−0.418688*G−0.081312*B)*(<em class="QR">QuantumRange</em>+1)/2</td></tr>
-
- <tr><th align="left" valign="middle">YIQ</th></tr>
- <tr><td align="left" valign="middle">Y=0.298839*R+0.586811*G+0.114350*B; <em>intensity-like</em></td></tr>
- <tr><td align="left" valign="middle">I=(0.59600*R−0.27400*G−0.32200*B)*(<em class="QR">QuantumRange</em>+1)/2</td></tr>
- <tr><td align="left" valign="middle">Q=(0.21100*R−0.52300*G+0.31200*B)*(<em class="QR">QuantumRange</em>+1)/2</td></tr>
-
- <tr><th align="left" valign="middle">YPbPr</th></tr>
- <tr><td align="left" valign="middle">Y=0.2988390*R+0.5868110*G+0.1143500*B; <em>intensity-like</em></td></tr>
- <tr><td align="left" valign="middle">Pb=(−0.168736*R−0.331264*G+0.500000*B)*(<em class="QR">QuantumRange</em>+1)/2</td></tr>
- <tr><td align="left" valign="middle">Pr=(0.500000*R−0.418688*G−0.081312*B)*(<em class="QR">QuantumRange</em>+1)/2</td></tr>
-
- <tr><th align="left" valign="middle">YUV</th></tr>
- <tr><td align="left" valign="middle">Y=0.298839*R+0.586811*G+0.114350*B; <em>intensity-like</em></td></tr>
- <tr><td align="left" valign="middle">U=(−0.14740*R−0.28950*G+0.43690*B)*(<em class="QR">QuantumRange</em>+1)/2</td></tr>
- <tr><td align="left" valign="middle">V=(0.61500*R−0.51500*G−0.10000*B)*(<em class="QR">QuantumRange</em>+1)/2</td></tr>
+ <tr><th valign="middle">CMY</th></tr>
+ <tr><td valign="middle">C=<var>QuantumRange</var>−R</td></tr>
+ <tr><td valign="middle">M=<var>QuantumRange</var>−G</td></tr>
+ <tr><td valign="middle">Y=<var>QuantumRange</var>−B</td></tr>
+ <tr><th valign="middle">CMYK — starts with CMY from above</th></tr>
+ <tr><td valign="middle">K=min(C,Y,M)</td></tr>
+ <tr><td valign="middle">C=<var>QuantumRange</var>*(C−K)/(<var>QuantumRange</var>−K)</td></tr>
+ <tr><td valign="middle">M=<var>QuantumRange</var>*(M−K)/(<var>QuantumRange</var>−K)</td></tr>
+ <tr><td valign="middle">Y=<var>QuantumRange</var>*(Y−K)/(<var>QuantumRange</var>−K)</td></tr>
+
+ <tr><th valign="middle">Gray</th></tr>
+ <tr><td valign="middle">Gray = 0.212656*R+0.715158*G+0.072186*B</td></tr>
+
+ <tr><th valign="middle">HSB — Hue, Saturation, Brightness; like a cone peak downward</th></tr>
+ <tr><td valign="middle">H=angle around perimeter (0 to 360 deg); H=0 is red; increasing angles toward green</td></tr>
+ <tr><td valign="middle">S=distance from axis outward</td></tr>
+ <tr><td valign="middle">B=distance along axis from bottom upward; B=max(R,G,B); <var>intensity-like</var></td></tr>
+
+ <tr><th valign="middle">HSL — Hue, Saturation, Lightness; like a double cone end-to-end with peaks at very top and bottom</th></tr>
+ <tr><td valign="middle">H=angle around perimeter (0 to 360 deg); H=0 is red; increasing angles toward green</td></tr>
+ <tr><td valign="middle">S=distance from axis outward</td></tr>
+ <tr><td valign="middle">L=distance along axis from bottom upward; L=0.5*max(R,G,B) + 0.5*min(R,G,B); <var>intensity-like</var></td></tr>
+
+ <tr><th valign="middle">HWB — Hue, Whiteness, Blackness</th></tr>
+ <tr><td valign="middle">Hue (complicated equation)</td></tr>
+ <tr><td valign="middle">Whiteness (complicated equation)</td></tr>
+ <tr><td valign="middle">Blackness (complicated equation)</td></tr>
+
+ <tr><th valign="middle">LAB</th></tr>
+ <tr><td valign="middle">L (complicated equation relating X,Y,Z)</td></tr>
+ <tr><td valign="middle">A (complicated equation relating X,Y,Z)</td></tr>
+ <tr><td valign="middle">B (complicated equation relating X,Y,Z)</td></tr>
+ <tr><th valign="middle">LinearGray</th></tr>
+ <tr><td valign="middle">LinearGray = 0.298839*R+0.586811*G+0.114350*B</td></tr>
+
+ <tr><th valign="middle">LOG</th></tr>
+ <tr><td valign="middle">I1 (complicated equation involving logarithm of R)</td></tr>
+ <tr><td valign="middle">I2 (complicated equation involving logarithm of G)</td></tr>
+ <tr><td valign="middle">I3 (complicated equation involving logarithm of B)</td></tr>
+
+ <tr><th valign="middle">OHTA — approximates principal components transformation</th></tr>
+ <tr><td valign="middle">I1=0.33333*R+0.33334*G+0.33333*B; <var>intensity-like</var></td></tr>
+ <tr><td valign="middle">I2=(0.50000*R+0.00000*G−0.50000*B)*(<var>QuantumRange</var>+1)/2</td></tr>
+ <tr><td valign="middle">I3=(−0.25000*R+0.50000*G−0.25000*B)*(<var>QuantumRange</var>+1)/2</td></tr>
+
+ <tr><th valign="middle">Rec601Luma</th></tr>
+ <tr><td valign="middle">Gray = 0.298839*R+0.586811*G+0.114350*B</td></tr>
+
+ <tr><th valign="middle">Rec601YCbCr</th></tr>
+ <tr><td valign="middle">Y=0.2988390*R+0.5868110*G+0.1143500*B; <var>intensity-like</var></td></tr>
+ <tr><td valign="middle">Cb=(−0.168736*R-0.331264*G+0.500000*B)*(<var>QuantumRange</var>+1)/2</td></tr>
+ <tr><td valign="middle">Cr=(0.500000*R−0.418688*G−0.081312*B)*(<var>QuantumRange</var>+1)/2</td></tr>
+
+ <tr><th valign="middle">Rec709Luma</th></tr>
+ <tr><td valign="middle">Gray=0.212656*R+0.715158*G+0.072186*B</td></tr>
+
+ <tr><th valign="middle">Rec709YCbCr</th></tr>
+ <tr><td valign="middle">Y=0.212656*R+0.715158*G+0.072186*B; <var>intensity-like</var></td></tr>
+ <tr><td valign="middle">Cb=(−0.114572*R−0.385428*G+0.500000*B)+(<var>QuantumRange</var>+1)/2</td></tr>
+ <tr><td valign="middle">Cr=(0.500000*R−0.454153*G−0.045847*B)+(<var>QuantumRange</var>+1)/2</td></tr>
+ <tr><th valign="middle">sRGB</th></tr>
+ <tr><td valign="middle">if R ≤ .0.0031308 then Rs=R/12.92 else Rs=1.055 R ^ (1.0 / 2.4) - 0.055</td></tr>
+ <tr><td valign="middle">if G ≤ .0.0031308 then Gs=B/12.92 else Gs=1.055 R ^ (1.0 / 2.4) - 0.055</td></tr>
+ <tr><td valign="middle">if B ≤ .0.0031308 then Bs=B/12.92 else Bs=1.055 R ^ (1.0 / 2.4) - 0.055</td></tr>
+
+ <tr><th valign="middle">XYZ</th></tr>
+ <tr><td valign="middle">X=0.4124564*R+0.3575761*G+0.1804375*B</td></tr>
+ <tr><td valign="middle">Y=0.2126729*R+0.7151522*G+0.0721750*B</td></tr>
+ <tr><td valign="middle">Z=0.0193339*R+0.1191920*G+0.9503041*B</td></tr>
+
+ <tr><th valign="middle">YCC</th></tr>
+ <tr><td valign="middle">Y=(0.298839*R+0.586811*G+0.114350*B) (with complicated scaling); <var>intensity-like</var></td></tr>
+ <tr><td valign="middle">C1=(−0.298839*R−0.586811*G+0.88600*B) (with complicated scaling)</td></tr>
+ <tr><td valign="middle">C2=(0.70100*R−0.586811*G−0.114350*B) (with complicated scaling)</td></tr>
+
+ <tr><th valign="middle">YCbCr</th></tr>
+ <tr><td valign="middle">Y=0.2988390*R+0.5868110*G+0.1143500*B; <var>intensity-like</var></td></tr>
+ <tr><td valign="middle">Cb=(−0.168736*R−0.331264*G+0.500000*B)*(<var>QuantumRange</var>+1)/2</td></tr>
+ <tr><td valign="middle">Cr=(0.500000*R−0.418688*G−0.081312*B)*(<var>QuantumRange</var>+1)/2</td></tr>
+
+ <tr><th valign="middle">YIQ</th></tr>
+ <tr><td valign="middle">Y=0.298839*R+0.586811*G+0.114350*B; <var>intensity-like</var></td></tr>
+ <tr><td valign="middle">I=(0.59600*R−0.27400*G−0.32200*B)*(<var>QuantumRange</var>+1)/2</td></tr>
+ <tr><td valign="middle">Q=(0.21100*R−0.52300*G+0.31200*B)*(<var>QuantumRange</var>+1)/2</td></tr>
+
+ <tr><th valign="middle">YPbPr</th></tr>
+ <tr><td valign="middle">Y=0.2988390*R+0.5868110*G+0.1143500*B; <var>intensity-like</var></td></tr>
+ <tr><td valign="middle">Pb=(−0.168736*R−0.331264*G+0.500000*B)*(<var>QuantumRange</var>+1)/2</td></tr>
+ <tr><td valign="middle">Pr=(0.500000*R−0.418688*G−0.081312*B)*(<var>QuantumRange</var>+1)/2</td></tr>
+
+ <tr><th valign="middle">YUV</th></tr>
+ <tr><td valign="middle">Y=0.298839*R+0.586811*G+0.114350*B; <var>intensity-like</var></td></tr>
+ <tr><td valign="middle">U=(−0.14740*R−0.28950*G+0.43690*B)*(<var>QuantumRange</var>+1)/2</td></tr>
+ <tr><td valign="middle">V=(0.61500*R−0.51500*G−0.10000*B)*(<var>QuantumRange</var>+1)/2</td></tr>
</table>
<p>Note the scRGB colorspace requires HDRI support otherwise it behaves just like linear RGB.</p>
+<p>Use the <code>Undefined</code> colorspace to identify multi-spectral images.</p>
+
<div style="margin: auto;">
- <h4><a id="combine"></a>-combine</h4>
+ <h3><a class="anchor" id="combine"></a>-combine</h3>
+ <h3>+combine <var>colorspace</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Combine one or more images into a single image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Combine one or more images into a single image.</p>
<p>The channels (previously set by <a href="command-line-options.html#channel">-channel</a>) of the
combined image are taken from the grayscale values of each image in the
Thus, in the following example, the final image should be a copy of the
original. </p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert original.png -channel RGB -separate sepimage.png</span><span class='crtout'></span><span class="crtprompt"> $magick> </span><span class='crtin'>convert sepimage-0.png sepimage-1.png sepimage-2.png -channel RGB \ <br/> -combine imagecopy.png</span></p>
+<pre class="highlight"><code>convert original.png -channel RGB -separate sepimage.png
+convert sepimage-0.png sepimage-1.png sepimage-2.png -channel RGB \
+ -combine imagecopy.png
+</code></pre>
+
<div style="margin: auto;">
- <h4><a id="comment"></a>-comment <em class="arg">string</em></h4>
+ <h3><a class="anchor" id="comment"></a>-comment <var>string</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Embed a comment in an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Embed a comment in an image.</p>
<p>This option sets the comment meta-data of an image read in after this
option has been given. To modify a comment of images already in memory use
Print Image Properties</a>. These attributes are expanded when the comment
is finally assigned to the individual images. </p>
-<p>If the first character of <em class="arg">string</em> is <em
-class="arg">@</em>, the image comment is read from a file titled by the
+<p>If the first character of <var>string</var> is <var>@</var>, the image comment is read from a file titled by the
remaining characters in the string. Comments read in from a file are literal;
no embedded formatting characters are recognized.</p>
<p>For example,</p>
-<p class="crtsnip">
- -comment "%m:%f %wx%h" bird.miff
-</p>
+<pre class="highlight"><code>-comment "%m:%f %wx%h" bird.miff
+</code></pre>
<p>produces an image comment of <code>MIFF:bird.miff 512x480</code> (assuming
that the image <code>bird.miff</code> has a width of 512 and a height of
480.</p>
<div style="margin: auto;">
- <h4><a id="compare"></a>-compare</h4>
+ <h3><a class="anchor" id="compare"></a>-compare</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>mathematically and visually annotate the difference between an image and its reconstruction</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">mathematically and visually annotate the difference between an image and its reconstruction</p>
<p>This is a convert version of "<code>compare</code>" for two same sized images. The syntax is as follows, but other metrics are allowed.</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert image.png reference.png -metric RMSE -compare \ <br/> difference.png</span></p>
+<pre class="highlight"><code>convert image.png reference.png -metric RMSE -compare \ <br/> difference.png
+</code></pre>
+
<p>To get the metric value use the string format "%[distortion]".</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert image.png reference.png -metric RMSE -compare -format \ <br/> "%[distortion]" info:</span></p>
+<pre class="highlight"><code>convert image.png reference.png -metric RMSE -compare -format \
+ "%[distortion]" info:
+</code></pre>
+
<div style="margin: auto;">
- <h4><a id="complex"></a>-complex <em class="arg">operator</em></h4>
+ <h3><a class="anchor" id="complex"></a>-complex <var>operator</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>perform complex mathematics on an image sequence</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">perform complex mathematics on an image sequence</p>
Choose from these operators:
-<pre class="text">
- add
- conjugate
- divide
- magnuitude-phase
- multiply
- real-imaginary
- subtract
-</pre>
+<pre class="highlight"><code>add
+conjugate
+divide
+magnitude-phase
+multiply
+real-imaginary
+subtract
+</code></pre>
<p>Optionally specify the <code>divide</code> operator SNR with <code><a href="command-line-options.html#define">-define</a> complex:snr=float</code>.</p>
<div style="margin: auto;">
- <h4><a id="compose"></a>-compose <em class="arg">operator</em></h4>
+ <h3><a class="anchor" id="compose"></a>-compose <var>operator</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the type of image composition.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set the type of image composition.</p>
-<p>See <a href="compose.html">Alpha Compositing</a> for
+<p>See <a href="../www/compose.html">Alpha Compositing</a> for
a detailed discussion of alpha compositing.</p>
-<p>This setting effects image processing operators that merge two (or more)
+<p>This setting affects image processing operators that merge two (or more)
images together in some way. This includes the operators,
<a href="command-line-options.html#composite">-compare</a>,
<a href="command-line-options.html#composite">-composite</a>,
<div style="margin: auto;">
- <h4><a id="composite"></a>-composite</h4>
+ <h3><a class="anchor" id="composite"></a>-composite</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Perform alpha composition on two images and an optional mask</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Perform alpha composition on two images and an optional mask</p>
<p>Take the first image 'destination' and overlay the second 'source' image
according to the current <a href="command-line-options.html#compose">-compose</a> setting. The location
of the 'source' or 'overlay' image is controlled according to <a
-href="command-line-options.html#geometry" >-geometry</a>, and <a href="command-line-options.html#geometry" >-geometry</a>
+href="command-line-options.html#gravity" >-gravity</a>, and <a href="command-line-options.html#geometry" >-geometry</a>
settings. </p>
-<p>If a third image is given this is treated as a gray-scale 'mask' image
-relative to the first 'destination' image. This mask will limit what parts of
-the destination can be modified by the image composition. However for the
-'<code>displace</code>' compose method, the mask is used to provide a separate
-Y-displacement image instead. </p>
+<p>If a third image is given this is treated as a grayscale blending 'mask' image
+relative to the first 'destination' image. This mask is blended with the
+source image. However for the '<code>displace</code>' compose method, the
+mask is used to provide a separate Y-displacement image instead. </p>
<p>If a <a href="command-line-options.html#compose">-compose</a> method requires extra numerical
arguments or flags these can be provided by setting the <a
-href="command-line-options.html#set">-set</a> '<code class="arg">option:compose:args</code>'
+href="command-line-options.html#set">-set</a> '<code>option:compose:args</code>'
appropriately for the compose method. </p>
<p>Some <a href="command-line-options.html#compose">-compose</a> methods can modify the 'destination'
image outside the overlay area. You can disable this by setting the special <a
-href="command-line-options.html#set">-set</a> '<code class="arg">option:compose:outside-overlay</code>'
+href="command-line-options.html#set">-set</a> '<code>option:compose:outside-overlay</code>'
to '<code>false</code>'. </p>
+<p>The SVG compositing specification requires that color and opacity values range between zero and QuantumRange inclusive. You can permit values outside this range with this option: <a href="command-line-options.html#set">-set</a> '<code>option:compose:clamp=false</code></p>
+
<div style="margin: auto;">
- <h4><a id="compress"></a>-compress <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="compress"></a>-compress <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Use pixel compression specified by <em class="arg">type</em> when writing the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Use pixel compression specified by <var>type</var> when writing the image.</p>
-<p>Choices are: <code class="arg">None</code>, <code class="arg">BZip</code>, <code
-class="arg">Fax</code>, <code class="arg">Group4</code>, <code
-class="arg">JPEG</code>, <code class="arg">JPEG2000</code>, <code
-class="arg">Lossless</code>, <code class="arg">LZW</code>, <code
-class="arg">RLE</code> or <code class="arg">Zip</code>.</p>
+<p>Choices are: <code>None</code>, <code>BZip</code>, <code
+>Fax</code>, <code>Group4</code>, <code
+>JPEG</code>, <code>JPEG2000</code>, <code
+>Lossless</code>, <code>LZW</code>, <code
+>RLE</code> or <code>Zip</code>.</p>
<p>To print a complete list of compression types, use <a href="command-line-options.html#list">-list
compress</a>.</p>
the chroma channels.</p>
<div style="margin: auto;">
- <h4><a id="connected-components"></a>-connected-components <em class="arg">connectivity</em></h4>
+ <h3><a class="anchor" id="connected-components"></a>-connected-components <var>connectivity</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>connected-components uniquely labeled, choose from 4 or 8 way connectivity.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description"><a href="connected-components.html">connected-components</a> labeling detects connected regions in an image, choose from 4 or 8 way connectivity.</p>
<p>Use <code><a href="command-line-options.html#define" >-define</a> connected-components:verbose=true</code> to output statistics associated with each unique label.</p>
<div style="margin: auto;">
- <h4><a id="contrast"></a>-contrast</h4>
+ <h3><a class="anchor" id="contrast"></a>-contrast</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Enhance or reduce the image contrast.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Enhance or reduce the image contrast.</p>
<p>This option enhances the intensity differences between the lighter and
darker elements of the image. Use <a href="command-line-options.html#contrast">-contrast</a> to enhance
<p>For a more pronounced effect you can repeat the option:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert rose: -contrast -contrast rose_c2.png</span></p>
+<pre class="highlight"><code>convert rose: -contrast -contrast rose_c2.png
+</code></pre>
+
<div style="margin: auto;">
- <h4><a id="contrast-stretch"></a>-contrast-stretch <em class="arg">black-point</em><br />-contrast-stretch <em class="arg">black-point</em>{x<em class="arg">white-point</em>}{<em class="arg">%</em>}}</h4>
+ <h3><a class="anchor" id="contrast-stretch"></a>-contrast-stretch <var>black-point</var><br />-contrast-stretch <var>black-point</var>{x<var>white-point</var>}{<var>%</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Increase the contrast in an image by <em>stretching</em> the range of intensity values.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Increase the contrast in an image by <var>stretching</var> the range of intensity values.</p>
-<p>While performing the stretch, black-out at most <em
-class="arg" >black-point</em> pixels and white-out at most <em
-class="arg" >white-point</em> pixels. Or, if percent is used, black-out at most
-<em class="arg" >black-point %</em> pixels and white-out at most <em
-class="arg" >white-point %</em> pixels.</p>
+<p>While performing the stretch, black-out at most <var>black-point</var> pixels and white-out at most <var>white-point</var> pixels. Or, if percent is used, black-out at most
+<var >black-point %</var> pixels and white-out at most <var>white-point %</var> pixels.</p>
<p>Prior to ImageMagick 6.4.7-0, <a href="command-line-options.html#contrast-stretch"
->-contrast-stretch</a> will black-out at most <em class="arg"
->black-point</em> pixels and white-out at most <em class="arg" >total pixels
-minus white-point</em> pixels. Or, if percent is used, black-out at most <em
-class="arg">black-point %</em> pixels and white-out at most <em class="arg"
->100% minus white-point %</em> pixels.</p>
+>-contrast-stretch</a> will black-out at most <var>black-point</var> pixels and white-out at most <var >total pixels
+minus white-point</var> pixels. Or, if percent is used, black-out at most <var>black-point %</var> pixels and white-out at most <var>100% minus white-point %</var> pixels.</p>
<p>Note that <code>-contrast-stretch 0</code> will modify the image such that
-the image's min and max values are stretched to 0 and <em class="QR"
->QuantumRange</em>, respectively, without any loss of data due to burn-out or
+the image's min and max values are stretched to 0 and <var>QuantumRange</var>, respectively, without any loss of data due to burn-out or
clipping at either end. This is not the same as <a href="command-line-options.html#normalize"
>-normalize</a>, which is equivalent to <code>-contrast-stretch 0.15x0.05%</code> (or
prior to ImageMagick 6.4.7-0, <code>-contrast-stretch 2%x99%</code>).</p>
bin to modify the image. As such some colors may be merged together when they
originally fell into the same 'bin'. </p>
-<p>All the channels are normalized in concert by the came amount so as to
+<p>All the channels are normalized in concert by the same amount so as to
preserve color integrity, when the default <a href="command-line-options.html#channel" >+channel</a>
setting is in use. Specifying any other <a href="command-line-options.html#channel" >-channel</a>
setting will normalize the RGB channels independently.</p>
<div style="margin: auto;">
- <h4><a id="convolve"></a>-convolve <em class="arg">kernel</em></h4>
+ <h3><a class="anchor" id="convolve"></a>-convolve <var>kernel</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Convolve an image with a user-supplied convolution kernel.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Convolve an image with a user-supplied convolution kernel.</p>
-<p>The <em class="arg">kernel</em> is a matrix specified as
+<p>The <var>kernel</var> is a matrix specified as
a comma-separated list of integers (with no spaces), ordered left-to right,
starting with the top row. Presently, only odd-dimensioned kernels are
-supported, and therefore the number of entries in the specified <em
-class="arg">kernel</em> must be 3<sup>2</sup>=9, 5<sup>2</sup>=25,
+supported, and therefore the number of entries in the specified <var>kernel</var> must be 3<sup>2</sup>=9, 5<sup>2</sup>=25,
7<sup>2</sup>=49, etc. </p>
<p>Note that the <a href="command-line-options.html#convolve">‑convolve</a> operator supports the <a href="command-line-options.html#bias">‑bias</a> setting. This option shifts the convolution so that
See the discussion on HDRI implementations of ImageMagick on the page <a
href="high-dynamic-range.html">High
Dynamic-Range Images</a>. For more about HDRI go the ImageMagick <a
-href="http://www.imagemagick.org/Usage/basics/#hdri">Usage</a> pages or this
+href="../Usage/basics/#hdri">Usage</a> pages or this
<a href="http://en.wikipedia.org/wiki/High_dynamic_range_imaging">Wikipedia</a>
entry. </p>
<div style="margin: auto;">
- <h4><a id="crop"></a>-crop <em class="arg">geometry</em>{<em class="arg">@</em>}{<em class="arg">!</em>}</h4>
+ <h3><a class="anchor" id="copy"></a>-copy <var>geometry</var> <var>offset</var></h3>
+</div>
+
+<p class="magick-description">copy pixels from one area of an image to another.</p>
+
+<div style="margin: auto;">
+ <h3><a class="anchor" id="crop"></a>-crop <var>geometry</var>{<var>@</var>}{<var>!</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Cut out one or more rectangular regions of the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Cut out one or more rectangular regions of the image.</p>
<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
-<p>The <em class="arg">width</em> and <em class="arg">height</em> of the <em
-class="arg">geometry</em> argument give the size of the image that remains
-after cropping, and <em class="arg">x</em> and <em class="arg">y</em> in the
-<em class="arg">offset</em> (if present) gives the location of the top left
+<p>The <var>width</var> and <var>height</var> of the <var>geometry</var> argument give the size of the image that remains
+after cropping, and <var>x</var> and <var>y</var> in the
+<var>offset</var> (if present) gives the location of the top left
corner of the cropped image with respect to the original image. To specify the
amount to be removed, use <a href="command-line-options.html#shave">-shave</a> instead.</p>
-<p>If the <em class="arg">x</em> and <em class="arg">y</em> offsets are
+<p>If the <var>x</var> and <var>y</var> offsets are
present, a single image is generated, consisting of the pixels from the
cropping region. The offsets specify the location of the upper left corner of
the cropping region measured downward and rightward with respect to the upper
<code>South</code>, or <code>SouthEast</code> gravity, the distance is measured
upward between the bottom edges.</p>
-<p>If the <em class="arg">x</em> and <em class="arg">y</em> offsets are
+<p>If the <var>x</var> and <var>y</var> offsets are
omitted, a set of tiles of the specified geometry, covering the entire input
image, is generated. The rightmost tiles and the bottom tiles are smaller if
the specified geometry extends beyond the dimensions of the input image.</p>
-<p>You can add the <em class="arg">@</em> to the geometry argument to equally divide the image into the number of tiles generated.</p>
+<p>You can add the <var>@</var> to the geometry argument to equally divide the image into the number of tiles generated.</p>
<p>By adding a exclamation character flag to the geometry argument, the
cropped images virtual canvas page size and offset is set as if the
offset.</p>
<div style="margin: auto;">
- <h4><a id="cycle"></a>-cycle <em class="arg">amount</em></h4>
+ <h3><a class="anchor" id="cycle"></a>-cycle <var>amount</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>displace image colormap by amount.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">displace image colormap by amount.</p>
-<p><em class="arg">Amount</em> defines the number of positions each
+<p><var>Amount</var> defines the number of positions each
colormap entry is shifted.</p>
<div style="margin: auto;">
- <h4><a id="debug"></a>-debug <em class="arg">events</em></h4>
+ <h3><a class="anchor" id="debug"></a>-debug <var>events</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>enable debug printout.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">enable debug printout.</p>
<p>The <code>events</code> parameter specifies which events are to be logged. It
can be either <code>None</code>, <code>All</code>, <code>Trace</code>, or
<p>For example, to log cache and blob events, use.</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert -debug "Cache,Blob" rose: rose.png</span></p>
+<pre class="highlight"><code>convert -debug "Cache,Blob" rose: rose.png
+</code></pre>
+
<p>The <code>User</code> domain is normally empty, but developers can log user
events in their private copy of ImageMagick.</p>
<div style="margin: auto;">
- <h4><a id="decipher"></a>-decipher <em class="arg">filename</em></h4>
+ <h3><a class="anchor" id="decipher"></a>-decipher <var>filename</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Decipher and restore pixels that were previously transformed by
-<a href="command-line-options.html#encipher">-encipher</a>.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Decipher and restore pixels that were previously transformed by <a href="command-line-options.html#encipher">-encipher</a>.</p>
-<p>Get the passphrase from the file specified by <em
-class="arg">filename</em>.</p>
+<p>Get the passphrase from the file specified by <var>filename</var>.</p>
<p>For more information, see the webpage, <a
-href="../cipher.html">ImageMagick: Encipher or
+href="../www/cipher.html">ImageMagick: Encipher or
Decipher an Image</a>.</p>
<div style="margin: auto;">
- <h4><a id="deconstruct"></a>-deconstruct</h4>
+ <h3><a class="anchor" id="deconstruct"></a>-deconstruct</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>find areas that has changed between images </td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">find areas that has changed between images </p>
<p>Given a sequence of images all the same size, such as produced by <a
href="command-line-options.html#coalesce">-coalesce</a>, replace the second and later images, with
<div style="margin: auto;">
- <h4><a id="define"></a>-define <em class="arg">key</em>{<em class="arg">=value</em>}<em class="arg">...</em></h4>
+ <h3><a class="anchor" id="define"></a>-define <var>key</var>{<var>=value</var>}<var>...</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>add specific global settings generally used to control
-coders and image processing operations.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">add specific global settings generally used to control coders and image processing operations.</p>
<p>This option creates one or more definitions for coders and decoders to use
while reading and writing image data. Definitions are generally used to
href="command-line-options.html#verbose" >-verbose</a> information ("<code>info:</code>" output format)
as "Artifacts". </p>
-<p>If <em class="arg">value</em> is missing for a definition, an empty-valued
+<p>If <var>value</var> is missing for a definition, an empty-valued
definition of a flag is created with that name. This used to control on/off
options. Use <a href="command-line-options.html#define">+define key</a> to remove definitions
previously created. Use <a href="command-line-options.html#define">+define "*"</a> to remove all
existing definitions.</p>
<p>The same 'artifact' settings can also be defined using the <a
-href="command-line-options.html#set" >-set "option:<em class="arg">key</em>" "<em class="arg"
->value</em>"</a> option, which also allows the use of <a href="escape.html" >Format and Print Image
+href="command-line-options.html#set" >-set "option:<var>key</var>" "<var>value</var>"</a> option, which also allows the use of <a href="escape.html" >Format and Print Image
Properties</a> in the defined value. </p>
-<p>The <em>option</em> and <em>key</em> are case-independent (they are
-converted to lowercase for use within the decoders) while the <em>value</em>
+<p>The <var>option</var> and <var>key</var> are case-independent (they are
+converted to lowercase for use within the decoders) while the <var>value</var>
is case-dependent.</p>
<p>Such settings are global in scope, and affect all images and operations. </p>
<p>The following definitions are just some of the artifacts that are
available:</p>
-<dl>
+<table class="table table-sm table-striped">
+ <tr>
+ <td>bmp3:alpha=<var>true|false</var></td>
+ <td>include any alpha channel when writing in the BMP image format.</td>
+ </tr>
-<dt>bmp:format=<em class="arg">value</em></dt>
- <dd> valid values are <em class="arg">bmp2</em>, <em class="arg">bmp3</em>,
- and <em class="arg">bmp4</em>. This option can be useful when the
+ <tr>
+ <td>bmp:format=<var>value</var></td>
+ <td> valid values are <var>bmp2</var>, <var>bmp3</var>,
+ and <var>bmp4</var>. This option can be useful when the
method of prepending "BMP2:" to the output filename is inconvenient or
- is not available, such as when using the <a href="mogrify.html">mogrify</a> utility.</dd>
-
-<dt>complex:snr=<em class="arg">value</em></dt>
- <dd>Set the divide SNR constant<a href="command-line-options.html#complex"
- >-complex</a></dd>
-
-<dt>compose:args=<em class="arg">arguments</em></dt>
- <dd>Sets certain compose argument values when using convert ... -compose ...
- -composite. See <a href="../compose.html"
- >Image Composition</a></dd>
-
-<dt>convolve:scale=<em class="arg">{kernel_scale}[!^] [,{origin_addition}] [%]</em></dt>
- <dd>Defines the kernel scaling. The special flag ! automatically scales to
- full dynamic range. The ! flag can be used in combination with a factor or
- percent. The factor or percent is then applied after the automatic scaling.
- An example is 50%!. This produces a result 50% darker than full dynamic
- range scaling. The ^ flag assures the kernel is 'zero-summing', for
+ is not available, such as when using the <a href="mogrify.html">mogrify</a> utility.</td>
+ </tr>
+
+ <tr>
+ <td>bmp:subtype=<var>RGB555|RGB565|ARGB4444|ARGB1555</var></td>
+ <td>BMP channel depth subtypes. Only support in BMP (BMP4). BMP3 and BMP2 do not
+ contain header fields to support these options.</td>
+ </tr>
+
+ <tr>
+ <td>colorspace:auto-grayscale=<var>on|off</var></td>
+ <td>prevent automatic conversion to grayscale inside coders that support
+ grayscale. This should be accompanied by -type truecolor. PNG and TIF do
+ not need this define. With PNG, just use PNG24:image. With TIF, just use
+ -type truecolor. JPG and PSD will need this define.</td>
+ </tr>
+
+ <tr>
+ <td>complex:snr=<var>value</var></td>
+ <td>Set the divide SNR constant<a href="command-line-options.html#complex">-complex</a></td>
+ </tr>
+
+ <tr>
+ <td>compose:args=<var>arguments</var></td>
+ <td>Sets certain compose argument values when using convert ... -compose ...
+ -composite. See <a href="compose.html"
+ >Image Composition</a></td>
+ </tr>
+
+ <tr>
+ <td>compose:clamp=<var>on|off</var></td>
+ <td>set each pixel whose value is below zero to zero and any the pixel
+ whose value is above the quantum range to the quantum range (e.g. 65535)
+ otherwise the pixel value remains unchanged. Define supported in
+ ImageMagick 6.9.1-3 and above.</td>
+ </tr>
+
+ <tr>
+ <td>connected-components:area-threshold=<var>value</var></td>
+ <td>Merges any region with area smaller than <var>value</var> into its surrounding region or largest neighbor.</td>
+ </tr>
+
+ <tr>
+ <td>connected-components:keep=<var>list-of-ids</var></td>
+ <td>Comma and/or hyphenated list of id values to keep in the output.
+ Supported in Imagemagick 6.9.3-0.</td>
+ </tr>
+
+ <tr>
+ <td>connected-components:mean-color=<var>true</var></td>
+ <td>Changes the output image from id values to mean color values. Supported
+ in Imagemagick 6.9.2-8.</td>
+ </tr>
+
+ <tr>
+ <td>connected-components:remove=<var>list-of-ids</var></td>
+ <td>Comma and/or hyphenated list of id values to remove from the output.
+ Supported in Imagemagick 6.9.2-9.</td>
+ </tr>
+
+ <tr>
+ <td>connected-components:verbose=<var>true</var></td>
+ <td>Lists id, bounding box, centroid, area, mean color for each region.</td>
+ </tr>
+
+ <tr>
+ <td>convolve:scale=<var>{kernel_scale}[!^] [,{origin_addition}] [%]</var></td>
+ <td>Defines the kernel scaling. The special flag ! automatically scales to
+ full dynamic range. The ! flag can be used in combination with a factor or
+ percent. The factor or percent is then applied after the automatic scaling.
+ An example is 50%!. This produces a result 50% darker than full dynamic
+ range scaling. The ^ flag assures the kernel is 'zero-summing', for
example when some values are positive and some are negative as in edge
detection kernels. The origin addition adds that value to the center
- pixel of the kernel. This produces and effect that is like adding the image
+ pixel of the kernel. This produces an effect that is like adding the image
that many times to the result of the filtered image. The typical value
is 1 so that the original image is added to the result of the convolution.
- The default is 0.</dd>
+ The default is 0.</td>
+ </tr>
-<dt>convolve:showkernel=<em class="arg">1</em></dt>
- <dd>Outputs (to 'standard error') all the information about a specified <a
- href="command-line-options.html#morphology" >-morphology convolve</a> kernel.</dd>
+ <tr>
+ <td>morphology:showKernel=<var>1</var></td>
+ <td>Outputs (to 'standard error') all the information about a specified <a
+ href="command-line-options.html#morphology" >-morphology convolve</a> kernel.</td>
+ </tr>
-<dt>dcm:display-range=<em class="arg">reset</em></dt>
- <dd>Sets the display range to the minimum and maximum pixel values for the
- DCM image format.</dd>
+ <tr>
+ <td>dcm:display-range=<var>reset</var></td>
+ <td>Sets the display range to the minimum and maximum pixel values for the
+ DCM image format.</td>
+ </tr>
-<dt>dds:cluster-fit=<em class="arg">true|false</em></dt>
- <dd>Enables the dds cluster-fit.</dd>
+ <tr>
+ <td>dds:cluster-fit=<var>true|false</var></td>
+ <td>Enables the dds cluster-fit.</td>
+ </tr>
-<dt>dds:compression=<em class="arg">dxt1|dxt5|none</em></dt>
- <dd>Sets the dds compression.</dd>
+ <tr>
+ <td>dds:compression=<var>dxt1|dxt5|none</var></td>
+ <td>Sets the dds compression.</td>
+ </tr>
-<dt>dds:mipmaps=<em class="arg">value</em></dt>
- <dd>Sets the dds number of mipmaps.</dd>
+ <tr>
+ <td>dds:mipmaps=<var>value</var></td>
+ <td>Sets the dds number of mipmaps.</td>
+ </tr>
-<dt>dds:weight-by-alpha=<em class="arg">true|false</em></dt>
- <dd>Enables the dds alpha weighting.</dd>
+ <tr>
+ <td>dds:weight-by-alpha=<var>true|false</var></td>
+ <td>Enables the dds alpha weighting.</td>
+ </tr>
-<dt>delegate:bimodel=<em class="arg">true</em></dt>
- <dd>Specifies direct conversion from Postscript to PDF.</dd>
+ <tr>
+ <td>deskew:auto-crop=<var>true</var></td>
+ <td>auto crop the image after deskewing.</td>
+ </tr>
-<dt>distort:scale=<em class="arg">value</em></dt>
- <dd>Sets the output scaling factor for use with <a href="command-line-options.html#distort"
- >-distort</a></dd>
+ <tr>
+ <td>delegate:bimodal=<var>true</var></td>
+ <td>Specifies direct conversion from Postscript to PDF.</td>
+ </tr>
-<dt>distort:viewport=<em class="arg">WxH+X+Y</em></dt>
- <dd>Sets the viewport for use with <a href="command-line-options.html#distort">-distort</a></dd>
+ <tr>
+ <td>distort:scale=<var>value</var></td>
+ <td>Sets the output scaling factor for use with <a href="command-line-options.html#distort"
+ >-distort</a></td>
+ </tr>
-<dt>dot:layout-engine=<em class="arg">value</em></dt>
- <dd>Specifies the layout engine for the DOT image format (e.g.
- <code>neato</code>).</dd>
+ <tr>
+ <td>distort:viewport=<var>WxH+X+Y</var></td>
+ <td>Sets the viewport for use with <a href="command-line-options.html#distort">-distort</a></td>
+ </tr>
+
+ <tr>
+ <td>dot:layout-engine=<var>value</var></td>
+ <td>Specifies the layout engine for the DOT image format (e.g.
+ <code>neato</code>).</td>
+ </tr>
+
+ <tr>
+ <td>exr:color-type=<var>value</var></td>
+ <td>Specifies the color type for the EXR format: RGB, RGBA, YC, YCA, Y, YA, R, G, B, A).</td>
+ </tr>
-<dt>filter:option=<em class="arg">value</em></dt>
- <dd>Set a filter option for use with <a href="command-line-options.html#resize">-resize</a>.
- See <a href="command-line-options.html#filter">-filter</a> for details.</dd>
+ <tr>
+ <td>filter:option=<var>value</var></td>
+ <td>Set a filter option for use with <a href="command-line-options.html#resize">-resize</a>.
+ See <a href="command-line-options.html#filter">-filter</a> for details.</td>
+ </tr>
-<dt>fourier:normalize=<em class="arg">inverse</em></dt>
- <dd>Sets the location for the FFT/IFT normalization as use by
+ <tr>
+ <td>fourier:normalize=<var>inverse</var></td>
+ <td>Sets the location for the FFT/IFT normalization as use by
<a href="command-line-options.html#fft">+-fft</a> and <a href="command-line-options.html#ift">+-ift</a>. The default is
- forward.</dd>
+ <var>forward</var>.</td>
+ </tr>
-<dt>icon:auto-resize</dt>
- <dd>Automatically stores multiple sizes when writing an ico image
- (requires a 256x256 input image).</dd>
+ <tr>
+ <td>h:format=<var>value</var></td>
+ <td>Set the image encoding format use when writing a C-style header.
+ <var>format</var> can be any output format supported by ImageMagick
+ except for <var>h</var> and <var>magick</var>. If this
+ option is omitted, the default is <var>GIF</var> for PseudoClass
+ images and <var>PNM</var> for DirectClass images.
+ </td>
+ </tr>
+
+ <tr>
+ <td>hough-lines:accumulator=true</td>
+ <td>Returns the accumulator image in addition to the lines image</td>
+ </tr>
+
+ <tr>
+ <td>icon:auto-resize</td>
+ <td>Automatically stores multiple sizes when writing an ico image
+ (requires a 256x256 input image).</td>
+ </tr>
+
+ <tr>
+ <td>identify:locate=<var>minimum|maximum</var></td>
+ <td>Locates the coordinates of one or more image minimum or maximum</td>
+ </tr>
+
+ <tr>
+ <td>identify:limit=<var>number</var></td>
+ <td>Locates the coordinates for the number of minima or maxima specified</td>
+ </tr>
-<dt>jp2:layer-number=<em class="arg">value</em></dt>
- <dd>Sets the maximum number of quality layers to decode. Same for JPT, JC2,
- and J2K</dd>
+ <tr>
+ <td>jp2:layer-number=<var>value</var></td>
+ <td>Sets the maximum number of quality layers to decode. Same for JPT, JC2,
+ and J2K</td>
+ </tr>
-<dt>jp2:number-resolutions=<em class="arg">value</em></dt>
- <dd>Sets the number of resolutions to encode.Same for JPT, JC2, and J2K</dd>
+ <tr>
+ <td>jp2:number-resolutions=<var>value</var></td>
+ <td>Sets the number of resolutions to encode.Same for JPT, JC2, and
+ J2K</td>
+ </tr>
-<dt>jp2:progression-order=<em class="arg">value</em></dt>
- <dd>choose from LRCP, RLCP, RPCL, PCRL or CPRL. Same for JPT, JC2, and
- J2K</dd></dd>
+ <tr>
+ <td>jp2:progression-order=<var>value</var></td>
+ <td>choose from LRCP, RLCP, RPCL, PCRL or CPRL. Same for JPT, JC2, and
+ J2K</td>
+ </tr>
-<dt>jp2:quality=<em class="arg">value,value...</em></dt>
- <dd>Sets the quality layer PSNR, given in dB. The order is from left to
+ <tr>
+ <td>jp2:quality=<var>value,value...</var></td>
+ <td>Sets the quality layer PSNR, given in dB. The order is from left to
right in ascending order. The default is a single lossless quality layer.
- Same for JPT, JC2, and J2K</dd></dd>
+ Same for JPT, JC2, and J2K</td>
+ </tr>
-<dt>jp2:rate=<em class="arg">value</em></dt>
- <dd>Specify the compression factor to use while writing JPEG-2000 files. The
- compression factor is the reciprocal of the compression ratio. The valid
- range is 0.0 to 1.0, with 1.0 indicating lossless compression. If defined,
- this value overrides the -quality setting. A quality setting of 75
- results in a rate value of 0.06641. Same for JPT, JC2, and J2K</dd></dd>
+ <tr>
+ <td>jp2:rate=<var>value</var></td>
+ <td>Specify the compression factor to use while writing JPEG-2000 files.
+ The compression factor is the reciprocal of the compression ratio. The
+ valid range is 0.0 to 1.0, with 1.0 indicating lossless compression. If
+ defined, this value overrides the -quality setting. A quality setting
+ of 75 results in a rate value of 0.06641. Same for JPT, JC2, and J2K</td>
+ </tr>
-<dt>jp2:reduce-factor=<em class="arg">value</em></dt>
- <dd>Sets the number of highest resolution levels to be discarded.Same for
- JPT, JC2, and J2K</dd></dd>
+ <tr>
+ <td>jp2:reduce-factor=<var>value</var></td>
+ <td>Sets the number of highest resolution levels to be discarded.Same for
+ JPT, JC2, and J2K</td>
+ </tr>
-<dt>jpeg:block-smoothing=<em class="arg">on|off</em></dt>
+ <tr>
+ <td>jpeg:block-smoothing=<var>on|off</var></td>
+ <td> </td>
+ </tr>
-<dt>jpeg:colors=<em class="arg">value</em></dt>
- <dd>Set the desired number of colors and let the JPEG encoder do the
- quantizing.</dd>
+ <tr>
+ <td>jpeg:colors=<var>value</var></td>
+ <td>Set the desired number of colors and let the JPEG encoder do the
+ quantizing.</td>
+ </tr>
-<dt>jpeg:dct-method=<em class="arg">value</em></dt>
- <dd>Choose from <code>default</code>, <code>fastest</code>,
- <code>float</code>, <code>ifast</code>, and <code>islow</code>.</dd>
+ <tr>
+ <td>jpeg:dct-method=<var>value</var></td>
+ <td>Choose from <code>default</code>, <code>fastest</code>,
+ <code>float</code>, <code>ifast</code>, and <code>islow</code>.</td>
+ </tr>
-<dt>jpeg:extent=<em class="arg">value</em></dt>
- <dd>Restrict the maximum JPEG file size, for example <code>-define
+ <tr>
+ <td>jpeg:extent=<var>value</var></td>
+ <td>Restrict the maximum JPEG file size, for example <code>-define
jpeg:extent=400KB</code>. The JPEG encoder will search for the highest
compression quality level that results in an output file that does not
- exceed the value. The <code>-quality</code> option is ignored if it
- is also present.</dd>
+ exceed the value. The <code>-quality</code> option also will be respected
+ starting with version 6.9.2-5. Between 6.9.1-0 and 6.9.2-4, add -quality
+ 100 in order for the jpeg:extent to work properly. Prior to 6.9.1-0, the
+ -quality setting was ignored.</td>
+ </tr>
-<dt>jpeg:fancy-upsampling=<em class="arg">on|off</em></dt>
+ <tr>
+ <td>jpeg:fancy-upsampling=<var>on|off</var></td>
+ <td> </td>
+ </tr>
-<dt>jpeg:optimize-coding=<em class="arg">on|off</em></dt>
+ <tr>
+ <td>jpeg:optimize-coding=<var>on|off</var></td>
+ <td> </td>
+ </tr>
-<dt>jpeg:q-table=<em class="arg">table</em></dt>
+ <tr>
+ <td>jpeg:q-table=<var>table</var></td>
+ <td> </td>
+ </tr>
-<dt>jpeg:sampling-factor=<em class="arg">sampling-factor-string</em></dt>
+ <tr>
+ <td>jpeg:sampling-factor=<var>sampling-factor-string</var></td>
+ <td> </td>
+ </tr>
-<dt>jpeg:size=<em class="arg">geometry</em></dt>
- <dd>Set the size hint of a JPEG image, for
+ <tr>
+ <td>jpeg:size=<var>geometry</var></td>
+ <td>Set the size hint of a JPEG image, for
example, <code>-define jpeg:size=128x128</code>.
It is most useful for increasing performance and reducing the memory
- requirements when reducing the size of a large JPEG image.</dd>
+ requirements when reducing the size of a large JPEG image.</td>
+ </tr>
-<dt>json:features</dt>
- <dd>includes features in verbose information</dd>
+ <tr>
+ <td>json:features</td>
+ <td>includes features in verbose information</td>
+ </tr>
-<dt>json:limit</dt>
+ <tr>
+ <td>json:limit</td>
+ <td> </td>
+ </tr>
-<dt>json:locate</dt>
+ <tr>
+ <td>json:locate</td>
+ <td> </td>
+ </tr>
-<dt>json:moments</dt>
- <dd>includes image moments in verbose information</dd>
+ <tr>
+ <td>json:moments</td>
+ <td>includes image moments in verbose information</td>
+ </tr>
-<dt>mng:need-cacheoff</dt>
- <dd>turn playback caching off for streaming MNG.</dd>
+ <tr>
+ <td>magick:format=<var>value</var></td>
+ <td>Set the image encoding format use when writing a C-style header.
+ This is the same as "h:format=format" described above.</td>
+ </tr>
-<dt>morphology:compose=<em class="arg">compose-method</em></dt>
- <dd>Specifies how to merge results generated by multiple<a
+ <tr>
+ <td>mng:need-cacheoff</td>
+ <td>turn playback caching off for streaming MNG.</td>
+ </tr>
+
+ <tr>
+ <td>morphology:compose=<var>compose-method</var></td>
+ <td>Specifies how to merge results generated by multiple<a
href="command-line-options.html#morphology" >-morphology</a> kernel. The default is none. One
typical value is 'lighten' as used, for example, with the sobel edge
- kernels. </dd>
+ kernels. </td>
+ </tr>
-<dt>morphology:showkernel=<em class="arg">1</em></dt>
- <dd>Outputs (to 'standard error') all the information about a generated <a
- href="command-line-options.html#morphology" >-morphology</a> kernel.</dd>
+ <tr>
+ <td>morphology:showKernel=<var>1</var></td>
+ <td>Outputs (to 'standard error') all the information about a generated <a
+ href="command-line-options.html#morphology" >-morphology</a> kernel.</td>
+ </tr>
-<dt>pcl:fit-to-page=<em class="arg">true</em></dt>
+ <tr>
+ <td>pcl:fit-to-page=<var>true</var></td>
+ </tr>
-<dt>pdf:fit-page=<em class="arg">geometry</em></dt>
- <dd> geometry specifies the scaling dimensions for resizing when the PDF is
+ <tr>
+ <td>pdf:fit-page=<var>geometry</var></td>
+ <td> geometry specifies the scaling dimensions for resizing when the PDF is
being read. The geometry is either WxH{%} or page size. No offsets are
- allowed. (introduced in IM 6.8.8-8)</dd>
+ allowed. (introduced in IM 6.8.8-8)</td>
+ </tr>
-<dt>pdf:fit-to-page=<em class="arg">true</em></dt>
+ <tr>
+ <td>pdf:fit-to-page=<var>true</var></td>
+ <td> </td>
+ </tr>
-<dt>pdf:use-cropbox=<em class="arg">true</em></dt>
+ <tr>
+ <td>pdf:use-cropbox=<var>true</var></td>
+ <td> </td>
+ </tr>
-<dt>pdf:use-trimbox=<em class="arg">true</em></dt>
+ <tr>
+ <td>pdf:use-trimbox=<var>true</var></td>
+ <td> </td>
+ </tr>
+
+ <tr>
+ <td>pdf:stop-on-error=<var>true</var></td>
+ <td> </td>
+ </tr>
+
+ <tr>
+ <td>pdf:pdf:page-direction=<var>right-to-left</var></td>
+ <td> </td>
+ </tr>
+
+ <tr>
+ <td>phash:colorspaces=<var>colorspace,colorspace,...</var></td>
+ <td>the perceptual hash defaults to the sRGB and HCLp colorspaces. When
+ using this define, you can specify up to six alternative colorspaces. (as
+ of IM 7.0.3-8)</td>
+ </tr>
+
+ <tr>
+ <td>phash:normalize=<var>true</var></td>
+ <td>normalizes the phash metric by dividing by the number of channels
+ specified by <code>-define phash:colorspaces</code> when using compare
+ -metric phash. (as of IM 7.0.3-8)</td>
+ </tr>
+
+ <tr>
+ <td>png:bit-depth=<var>value</var></td>
+ <td> </td>
+ </tr>
-<dt>png:bit-depth=<em class="arg">value</em></dt>
-<dt>png:color-type=<em class="arg">value</em></dt>
- <dd>desired bit-depth and color-type for PNG output. You can force the PNG
+ <tr>
+ <td>png:color-type=<var>value</var></td>
+ <td>desired bit-depth and color-type for PNG output. You can force the PNG
encoder to use a different bit-depth and color-type than it would have
normally selected, but only if this does not cause any loss of image
quality. Any attempt to reduce image quality is treated as an error and no
reduce the image quality prior to using the PNG encoder. Note that in
indexed PNG files, "bit-depth" refers to the number of bits per index,
which can be 1, 2, 4, or 8. In such files, the color samples always have
- 8-bit depth.</dd>
+ 8-bit depth.</td>
+ </tr>
-<dt>png:compression-filter=<em class="arg">value</em></dt>
- <dd> valid values are 0 through 9. 0-4 are the corresponding PNG filters,
+ <tr>
+ <td>png:compression-filter=<var>value</var></td>
+ <td> valid values are 0 through 9. 0-4 are the corresponding PNG filters,
5 means adaptive filtering except for images with a colormap, 6 means
adaptive filtering for all images, 7 means MNG "loco" compression, 8 means
Z_RLE strategy with adaptive filtering, and 9 means Z_RLE strategy with no
- filtering.</dd>
+ filtering.</td>
+ </tr>
-<dt>png:compression-level=<em class="arg">value</em></dt>
- <dd> valid values are 0 through 9, with 0 providing the least but fastest
- compression and 9 usually providing the best and always the slowest.</dd>
+ <tr>
+ <td>png:compression-level=<var>value</var></td>
+ <td> valid values are 0 through 9, with 0 providing the least but fastest
+ compression and 9 usually providing the best and always the slowest.</td>
+ </tr>
-<dt>png:compression-strategy=<em class="arg">value</em></dt>
- <dd> valid values are 0 through 4, meaning default, filtered, huffman_only,
+ <tr>
+ <td>png:compression-strategy=<var>value</var></td>
+ <td> valid values are 0 through 4, meaning default, filtered, huffman_only,
rle, and fixed ZLIB compression strategy. If you are using an old zlib
that does not support Z_RLE (before 1.2.0) or Z_FIXED (before 1.2.2.2),
values 3 and 4, respectively, will use the zlib default strategy
- instead.</dd>
+ instead.</td>
+ </tr>
-<dt>png:format=<em class="arg">value</em></dt>
- <dd> valid values are <em class="arg">png8</em>, <em class="arg">png24</em>,
- <em class="arg">png32</em>, <em class="arg">png48</em>,
- <em class="arg">png64</em>, and <em class="arg">png00</em>.
+ <tr>
+ <td>png:format=<var>value</var></td>
+ <td> valid values are <var>png8</var>, <var>png24</var>,
+ <var>png32</var>, <var>png48</var>,
+ <var>png64</var>, and <var>png00</var>.
This property can be useful for specifying
the specific PNG format to be used, when the usual method of prepending the
format name to the output filename is inconvenient, such as when writing
a PNG-encoded ICO file or when using <a href="mogrify.html">mogrify</a>.
- Value = <em class="arg">png8</em> reduces the number of colors to 256,
+ Value = <var>png8</var> reduces the number of colors to 256,
only one of which may be fully transparent, if necessary. The other
values do not force any reduction of quality; it is an error to request
a format that cannot represent the image data without loss (except that
it is allowed to reduce the bit-depth from 16 to 8 for all formats).
- Value = <em class="arg">png24</em> and <em class="arg">png48</em>
+ Value = <var>png24</var> and <var>png48</var>
allow transparency, only if a single color is fully transparent and that
color does not also appear in an opaque pixel; such transparency is
written in a PNG <code>tRNS</code> chunk.
- Value = <em class="arg">png00</em> causes the image to inherit its
+ Value = <var>png00</var> causes the image to inherit its
color-type and bit-depth from the input image, if the input was also
- a PNG.</dd>
+ a PNG.</td>
+ </tr>
-<dt>png:exclude-chunk=<em class="arg">value</em></dt>
+ <tr>
+ <td>png:exclude-chunk=<var>value</var></td>
-<dt>png:include-chunk=<em class="arg">value</em></dt>
- <dd>ancillary chunks to be excluded from or included in PNG output.
+ <tr>
+ <td>png:include-chunk=<var>value</var></td>
+ <td>ancillary chunks to be excluded from or included in PNG output.
- <p>The <em class="arg">value</em> can be the name of a PNG chunk-type such
- as <em class="arg">bKGD</em>, a comma-separated list of chunk-names
- (which can include the word <em class="arg">date</em>, the word
- <em class="arg">all</em>, or the word <em class="arg">none</em>).
+ <p>The <var>value</var> can be the name of a PNG chunk-type such
+ as <var>bKGD</var>, a comma-separated list of chunk-names
+ (which can include the word <var>date</var>, the word
+ <var>all</var>, or the word <var>none</var>).
Although PNG chunk-names are case-dependent, you can use all lowercase
names if you prefer.</p>
the PNG file. Because the list is processed from left to right, you
can achieve this with a single define:</p>
-<pre class="text">
- -define png:include-chunk=none,gAMA
-</pre>
+<pre class="highlight"><code>-define png:include-chunk=none,gAMA
+</code></pre>
<p>As a special case, if the <code>sRGB</code> chunk is not excluded and
the PNG encoder recognizes that the image contains the sRGB ICC profile,
<p>The <a href="command-line-options.html#strip">-strip</a> option does the equivalent of the
following for PNG output:</p>
-<pre class="text">
- -define png:exclude-chunk=EXIF,iCCP,iTXt,sRGB,tEXt,zCCP,zTXt,date
-</pre>
+<pre class="highlight"><code>-define png:exclude-chunk=EXIF,iCCP,iTXt,sRGB,tEXt,zCCP,zTXt,date
+</code></pre>
<p>The default behavior is to include all known PNG ancillary chunks
plus ImageMagick's private <code>vpAg</code> ("virtual page") chunk,
<p>You can also put <code>date</code> in the list to include or exclude
the "Date:create" and "Date:modify" text chunks that ImageMagick normally
- inserts in the output PNG.</p></dd>
+ inserts in the output PNG.</p></td>
+ </tr>
+
+ <tr>
+ <td>png:ignore-crc[=<var>true</var>]</td>
+ <td>When you know your image has no CRC or ADLER32 errors, this can speed up
+ decoding. It is also helpful in debugging bug reports from "fuzzers"</td>
+ </tr>
-<dt>png:preserve-colormap[=<em class="arg">true</em>]</dt>
- <dd>Use the existing image->colormap. Normally the PNG encoder will
+ <tr>
+ <td>png:preserve-colormap[=<var>true</var>]</td>
+ <td>Use the existing image->colormap. Normally the PNG encoder will
try to optimize the palette, eliminating unused entries and putting
the transparent colors first. If this flag is set, that behavior
- is suppressed.</dd>
+ is suppressed.</td>
+ </tr>
-<dt>png:preserve-iCCP[=<em class="arg">true</em>]</dt>
- <dd>By default, the PNG decoder and encoder examine any ICC profile
+ <tr>
+ <td>png:preserve-iCCP[=<var>true</var>]</td>
+ <td>By default, the PNG decoder and encoder examine any ICC profile
that is present, either from an <code>iCCP</code> chunk in the PNG
input or supplied via an option, and if the profile is recognized
to be the sRGB profile, converts it to the <code>sRGB</code> chunk.
profiles are recognized anyhow and converted to the <code>sRGB</code>
chunk, but are rejected if the <code>-define png:preserve-iCCP</code>
is present. Note that not all "sRGB" ICC profiles are recognized
- yet; we will add them to the list as we encounter them.</dd>
+ yet; we will add them to the list as we encounter them.</td>
+ </tr>
-<dt>png:swap-bytes[=<em class="arg">true</em>]</dt>
- <dd>The PNG specification requires that any multi-byte integers be stored in
+ <tr>
+ <td>png:swap-bytes[=<var>true</var>]</td>
+ <td>The PNG specification requires that any multi-byte integers be stored in
network byte order (MSB-LSB endian). This option allows you to
fix any invalid PNG files that have 16-bit samples stored incorrectly
in little-endian order (LSB-MSB). The "-define png:swap-bytes" option
must appear before the input filename on the commandline. The swapping
- is done during the libpng decoding operation.</dd>
+ is done during the libpng decoding operation.</td>
+ </tr>
-<dt>profile:skip=<em class="arg">name1,name2,...</em></dt>
- <dd>Skip the named profile[s] when reading the image. Use skip="*" to
+ <tr>
+ <td>profile:skip=<var>name1,name2,...</var></td>
+ <td>Skip the named profile[s] when reading the image. Use skip="*" to
skip all named profiles in the image. Many named profiles exist,
- including ICC, EXIF, APP1, IPTC, XMP, and others.</dd>
+ including ICC, EXIF, APP1, IPTC, XMP, and others.</td>
+ </tr>
-<dt>ps:imagemask</dt>
- <dd>If the ps:imagemask flag is defined, the PS3 and EPS3 coders will create
- Postscript files that render bilevel images with the Postscript imagemask
- operator instead of the image operator.</dd>
+ <tr>
+ <td>ps:imagemask</td>
+ <td>If the ps:imagemask flag is defined, the PS3 and EPS3 coders will
+ create Postscript files that render bilevel images with the Postscript
+ imagemask operator instead of the image operator.</td>
+ </tr>
+
+ <tr>
+ <td>psd:additional-info=all|selective</td>
+ <td>This option should only be used when converting from a PSD file to
+ another PSD file. This should be placed after the image is read. The two
+ options are 'all' and 'selective'. The 'selective' option will preserve
+ all additional information that is not related to the geometry of the
+ image. The 'all' option should only be used when the geometry of the
+ image has not been changed. This option is helpful when transferring
+ non-simple layers, such as adjustment layers from the input PSD file to
+ the output PSD file. If this option is not used, the additional
+ information will not be preserved. This define is available as of
+ Imagemagick version 6.9.5-8.
+</td>
+ </tr>
+
+ <tr>
+ <td>psd:alpha-unblend=off</td>
+ <td>Disables new automatic un-blending of transparency with the base image
+ for the flattened layer 0 before adding the alpha channel to the output
+ image. This define must be placed before the input psd image. (Available
+ as of IM 6.9.2.5). The automatic un-blending is new to IM 6.9.2.5 and
+ prevents the transparency from being applied twice in the output
+ image. This option should be set before reading the image.</td>
+ </tr>
+
+ <tr>
+ <td>psd:preserve-opacity-mask=true</td>
+ <td>This option should only be used when converting from a PSD file to
+ another PSD file. It will preserve the opacity mask of a layer and add it
+ back to the layer when the image is saved. Setting this to 'true' will
+ enable this feature. This define is available as of Imagemagick version
+ 6.9.5-10.
+</td>
+ </tr>
-<dt>quantum:format=<em class="arg">type</em></dt>
- <dd>Set the type to <code>floating-point</code> to specify a floating-point
+ <tr>
+ <td>preserve-timestamp=<var>{True, False}</var></td>
+ <td>Preserve file timestamp (<code>mogrify</code> only).</td>
+ </tr>
+
+ <tr>
+ <td>q-table=<var>quantization-table.xml</var></td>
+ <td>Custom JPEG quantization tables.</td>
+ </tr>
+
+ <tr>
+ <td>quantum:format=<var>type</var></td>
+ <td>Set the type to <code>floating-point</code> to specify a floating-point
format for raw files (e.g. GRAY:) or for MIFF and TIFF images in HDRI mode
to preserve negative values. If <a href="command-line-options.html#depth">-depth</a> 16 is
included, the result is a single precision floating point format.
If <a href="command-line-options.html#depth">-depth</a> 32 is included, the result is
- double precision floating point format.</dd>
+ double precision floating point format.</td>
+ </tr>
+
+ <tr>
+ <td>quantum:polarity=<var>photometric-interpretation</var></td>
+ <td>Set the photometric-interpretation of an image (typically for TIFF
+ image file format) to either <code>min-is-black</code> (default) or
+ <code>min-is-white</code>.</td>
+ </tr>
-<dt>quantum:polarity=<em class="arg">photometric-interpretation</em></dt>
- <dd>Set the photometric-interpretation of an image (typically for TIFF image
- file format) to either <code>min-is-black</code> (default) or
- <code>min-is-white</code>.</dd>
+ <tr>
+ <td>sample:offset=<var>geometry</var></td>
+ <td>Location of the sampling point within the sub-region being sampled,
+ expressed as percentages (see <a href="command-line-options.html#sample" >-sample</a>).</td>
+ </tr>
-<dt>sample:offset=<em class="arg">geometry</em></dt>
- <dd>Location of the sampling point within the sub-region being sampled,
- expressed as percentages (see <a href="command-line-options.html#sample" >-sample</a>).</dd>
+ <tr>
+ <td>morphology:showKernel=<var>1</var></td>
+ <td>Outputs (to 'standard error') all the information about a generated <a
+ href="command-line-options.html#morphology" >-morphology</a> kernel.</td>
+ </tr>
-<dt>showkernel=<em class="arg">1</em></dt>
- <dd>Outputs (to 'standard error') all the information about a generated <a
- href="command-line-options.html#morphology" >-morphology</a> kernel.</dd>
+ <tr>
+ <td>stream:buffer-size=<var>value</var></td>
+ <td>Set the stream buffer size. Select 0 for unbuffered I/O.</td>
+ </tr>
+ <tr>
+ <td>tiff:alpha=<var>associated|unassociated|unspecified</var></td>
+ <td>Specify the alpha extra samples as associated, unassociated or
+ unspecified </td>
+ </tr>
-<dt>tiff:alpha=<em class="arg">unassociated</em></dt>
- <dd>Specify the extra samples as associated or unassociated alpha</dd>
+ <tr>
+ <td>tiff:endian=<var>msb|lsb</var></td>
+ <td> </td>
+ </tr>
-<dt>tiff:endian=<em class="arg">msb|lsb</em></dt>
+ <tr>
+ <td>tiff:exif-properties=<var>true</var></td>
+ <td>Enables reading the EXIF properties.</td>
+ </tr>
-<dt>tiff:exif-properties=<em class="arg">false</em></dt>
- <dd>Skips reading the EXIF properties.</dd>
+ <tr>
+ <td>tiff:fill-order=<var>msb|lsb</var></td>
+ <td> </td>
+ </tr>
-<dt>tiff:fill-order=<em class="arg">msb|lsb</em></dt>
+ <tr>
+ <td>tiff:ignore-layers=<var>true</var></td>
+ <td>Ignores the photoshop layers.</td>
+ </tr>
-<dt>tiff:ignore-tags=<em class="arg">comma-separate-list-of-tag-IDs</em></dt>
- <dd>Allows one or more tag ID values to be ignored.</dd>
+ <tr>
+ <td>tiff:ignore-tags=<var>comma-separate-list-of-tag-IDs</var></td>
+ <td>Allows one or more tag ID values to be ignored.</td>
+ </tr>
-<dt>tiff:rows-per-strip=<em class="arg">value</em></dt>
- <dd>Sets the number of rows per strip</dd>
+ <tr>
+ <td>tiff:predictor=<var>[1, 2 or 3]</var></td>
+ <td>A mathematical operator that is applied to the image data before an encoding scheme is applied. The general idea is that subsequent pixels of an image resemble each other. Thus, substracting the information from a pixel that is already contained in previous one is likely to reduce its information density considerably and aid subsequent compression. 1 = No prediction scheme used before coding. 2 = Horizontal differencing. 3 = Floating point horizontal differencing.</td>
+ </tr>
-<dt>tiff:tile-geometry=<em class="arg">WxH</em></dt>
- <dd>Sets the tile size for pyramid tiffs. Requires the suffix
- PTIF: before the outputname</dd>
-</dl>
+ <tr>
+ <td>tiff:rows-per-strip=<var>value</var></td>
+ <td>Sets the number of rows per strip</td>
+ </tr>
+
+ <tr>
+ <td>tiff:tile-geometry=<var>WxH</var></td>
+ <td>Sets the tile size for pyramid tiffs. Requires the suffix
+ PTIF: before the outputname</td>
+ </tr>
+
+ <tr>
+ <td>type:features=<var>string</var></td>
+ <td> </td>
+ </tr>
+
+ <tr>
+ <td>type:hinting=<var>off</var></td>
+ <td> </td>
+ </tr>
+
+ <tr>
+ <td>txt:compliance=<var>css</var></td>
+ <td>The first argument of a hsl() color is integer, not percentage</td>
+ </tr>
+
+ <tr>
+ <td>x:screen=<var>true</var></td>
+ <td>Obtains the image from the root window </td>
+ </tr>
+
+ <tr>
+ <td>x:silent=<var>true</var></td>
+ <td>Turns off the beep when importing an image </td>
+ </tr>
+</table>
<p>For example, to create a postscript file that will render only the black
pixels of a bilevel image, use:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert bilevel.tif -define ps:imagemask eps3:stencil.ps</span></p>
+<pre class="highlight"><code>convert bilevel.tif -define ps:imagemask eps3:stencil.ps
+</code></pre>
+
<p>Set attributes of the image registry by prefixing the value with
<code>registry:</code>. For example, to set a temporary path to put work files,
use:</p>
-<p class="crtsnip">
--define registry:temporary-path=/data/tmp
-</p>
+<pre class="highlight"><code>-define registry:temporary-path=/data/tmp
+</code></pre>
<div style="margin: auto;">
- <h4><a id="delay"></a>-delay <em class="arg">ticks</em> <br />-delay <em class="arg">ticks</em>x<em class="arg">ticks-per-second</em> {<em class="arg"><</em>} {<em class="arg">></em>}</h4>
+ <h3><a class="anchor" id="delay"></a>-delay <var>ticks</var> <br />-delay <var>ticks</var>x<var>ticks-per-second</var> {<var><</var>} {<var>></var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>display the next image after pausing.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">display the next image after pausing.</p>
<p>This option is useful for regulating the animation of image sequences
-<em>ticks/ticks-per-second</em> seconds must expire before the display of the
+<var>ticks/ticks-per-second</var> seconds must expire before the display of the
next image. The default is no delay between each showing of the image
sequence. The default ticks-per-second is 100.</p>
-<p>Use <code>></code> to change the image delay <em>only</em> if its current
+<p>Use <code>></code> to change the image delay <var>only</var> if its current
value exceeds the given delay. <code><</code> changes the image delay
-<em>only</em> if current value is less than the given delay. For example, if
+<var>only</var> if current value is less than the given delay. For example, if
you specify <code>30></code> and the image delay is 20, the image delay does
not change. However, if the image delay is 40 or 50, the delay it is changed
to 30. Enclose the given delay in quotation marks to prevent the
<div style="margin: auto;">
- <h4><a id="delete"></a>-delete <em class="arg">indexes</em></h4>
+ <h3><a class="anchor" id="delete"></a>-delete <var>indexes</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>delete the images specified by index, from the image sequence.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">delete the images specified by index, from the image sequence.</p>
<p>Specify the image by its index in the sequence. The first image is index
0. Negative indexes are relative to the end of the sequence, for example, -1
represents the last image of the sequence. Specify a range of images with
a dash (e.g. 0-4). Separate indexes with a comma (e.g. 0,2). Use
-<code>+delete</code> to delete the last image in the current image sequence.</p>
+<code>+delete</code> to delete the last image in the current image sequence. Use <code>-delete 0--1</code> to delete the entire image sequence.</p>
<div style="margin: auto;">
- <h4><a id="density"></a>-density <em class="arg">width</em><br />-density <em class="arg">width</em>x<em class="arg">height</em></h4>
+ <h3><a class="anchor" id="density"></a>-density <var>width</var><br />-density <var>width</var>x<var>height</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the horizontal and vertical resolution of an image for
-rendering to devices.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set the horizontal and vertical resolution of an image for rendering to devices.</p>
<p>This option specifies the image resolution to store while encoding a raster
image or the canvas resolution while rendering (reading) vector formats such
its former resolution, ignoring the image resolution specified in the standard
file header.</p>
-<p>The <a href="command-line-options.html#density">-density</a> option sets an <em>attribute</em> and
+<p>The <a href="command-line-options.html#density">-density</a> option sets an <var>attribute</var> and
does not alter the underlying raster image. It may be used to adjust the
rendered size for desktop publishing purposes by adjusting the scale applied
to the pixels. To resize the image so that it is the same size at a different
resolution, use the <a href="command-line-options.html#resample">-resample</a> option.</p>
<div style="margin: auto;">
- <h4><a id="depth"></a>-depth <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="depth"></a>-depth <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>depth of the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">depth of the image.</p>
<p>This the number of bits in a color sample within a pixel. Use this option
to specify the depth of raw images whose depth is unknown such as GRAY, RGB,
or CMYK, or to change the depth of any image after it has been read.</p>
+<p>Use <a href="command-line-options.html#depth">+depth</a> to return depth to its default value.</p>
+
<div style="margin: auto;">
- <h4><a id="descend"></a>-descend</h4>
+ <h3><a class="anchor" id="descend"></a>-descend</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>obtain image by descending window hierarchy.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">obtain image by descending window hierarchy.</p>
<div style="margin: auto;">
- <h4><a id="deskew"></a>-deskew <em class="arg">threshold</em></h4>
+ <h3><a class="anchor" id="deskew"></a>-deskew <var>threshold{%}</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>straighten an image. A threshold of 40% works for most images.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">straighten an image. A threshold of 40% works for most images.</p>
<p>Use <a href="command-line-options.html#set">-set</a> <code>option:deskew:auto-crop
-<em>width</em></code> to auto crop the image. The set argument is the pixel
-width of the image background (e.g 40).</p>
+<var>true | false</var></code> to auto crop the image.</p>
<div style="margin: auto;">
- <h4><a id="despeckle"></a>-despeckle</h4>
+ <h3><a class="anchor" id="despeckle"></a>-despeckle</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>reduce the speckles within an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">reduce the speckles within an image.</p>
<div style="margin: auto;">
- <h4><a id="direction"></a>-direction <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="direction"></a>-direction <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>render text right-to-left or left-to-right.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">render text right-to-left or left-to-right. Requires the <a href="https://github.com/HOST-Oman/libraqm">RAQM</a> delegate library and <a href="https://en.wikipedia.org/wiki/Complex_text_layout">complex text layout</a>.</p>
<div style="margin: auto;">
- <h4><a id="displace"></a>-displace <em class="arg">horizontal-scale</em><br />-displace <em class="arg">horizontal-scale</em>x<em class="arg">vertical-scale</em></h4>
+ <h3><a class="anchor" id="displace"></a>-displace <var>horizontal-scale</var>{%}{!}<br />-displace <var>horizontal-scale</var>x<var>vertical-scale</var>{%}{!}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>shift image pixels as defined by a displacement map.</td><td style='text-align:right;'>[<a href="composite.html">composite</a>]</td></tr></table>
+<p class="magick-description">shift image pixels as defined by a displacement map.</p>
<p>With this option, the 'overlay' image, and optionally the 'mask' image,
is used as a displacement map, which is used to displace the lookup of
<p>Normally a single grayscale displacement map is provided, which with the
given scaling values will determine a single direction (vector) in which
displacements can occur (positively or negatively). However, if you also
-specify a third image which is normally used as a <em class="arg">mask</em>,
-the <em class="arg">composite image</em> is used for horizontal X
-displacement, while the <em class="arg">mask image</em> is used for vertical Y
+specify a third image which is normally used as a <var>mask</var>,
+the <var>composite image</var> is used for horizontal X
+displacement, while the <var>mask image</var> is used for vertical Y
displacement. This allows you to define completely different displacement
values for the X and Y directions, and allowing you to lookup any point within
-the <em class="arg">scale</em> bounds. In other words each pixel can lookup
+the <var>scale</var> bounds. In other words each pixel can lookup
any other nearby pixel, producing complex 2 dimensional displacements, rather
than a simple 1 dimensional vector displacements. </p>
<p>As of IM v6.5.3-5 any alpha channel in the overlay image is used as a
mask the transparency of the destination image. However areas outside the
-overlaid areas will not be effected. </p>
+overlaid areas will not be affected. </p>
<div style="margin: auto;">
- <h4><a id="display"></a>-display <em class="arg">host:display[.screen]</em></h4>
+ <h3><a class="anchor" id="display"></a>-display <var>host:display[.screen]</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Specifies the X server to contact.</td><td style='text-align:right;'>[<a href="animate.html">animate</a>, <a href="display.html">display</a>]</td></tr></table>
+<p class="magick-description">Specifies the X server to contact.</p>
<p>This option is used with convert for obtaining image or font from this
-X server. See <em class="arg">X(1)</em>.</p>
+X server. See <var>X(1)</var>.</p>
<div style="margin: auto;">
- <h4><a id="dispose"></a>-dispose <em class="arg">method</em></h4>
+ <h3><a class="anchor" id="dispose"></a>-dispose <var>method</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>define the GIF disposal image setting for images that are being created or read in. </td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">define the GIF disposal image setting for images that are being created or read in. </p>
<p>The layer disposal method defines the way each the displayed image is to be
modified after the current 'frame' of an animation has finished being
<p>Here are the valid methods:</p>
-<pre class="text">
- Undefined 0 No disposal specified (equivalent to '<code>none</code>').
- None 1 Do not dispose, just overlay next frame image.
- Background 2 Clear the frame area with the background color.
- Previous 3 Clear to the image prior to this frames overlay.
-</pre>
+<dl class="row">
+<dt class="col-md-4">Undefined</dt><dd class="col-md-8">0: No disposal specified (equivalent to '<code>none</code>').</dd>
+<dt class="col-md-4">None</dt><dd class="col-md-8">1: Do not dispose, just overlay next frame image.</dd>
+<dt class="col-md-4">Background</dt><dd class="col-md-8">2: Clear the frame area with the background color.</dd>
+<dt class="col-md-4">Previous</dt><dd class="col-md-8">3: Clear to the image prior to this frames overlay.</dd>
+</dl>
<p>You can also use the numbers given above, which is what the GIF format
uses internally to represent the above settings. </p>
disposal method for images already in memory.</p>
<div style="margin: auto;">
- <h4><a id="dissimilarity-threshold"></a>-dissimilarity-threshold <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="dissimilarity-threshold"></a>-dissimilarity-threshold <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>maximum RMSE for subimage match (default 0.2).</td><td style='text-align:right;'>[<a href="compare.html">compare</a>]</td></tr></table>
+<p class="magick-description">maximum RMSE for subimage match (default 0.2).</p>
<div style="margin: auto;">
- <h4><a id="dissolve"></a>-dissolve <em class="arg">src_percent</em>[x<em class="arg">dst_percent</em>]</h4>
+ <h3><a class="anchor" id="dissolve"></a>-dissolve <var>src_percent</var>[x<var>dst_percent</var>]</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>dissolve an image into another by the given percent.</td><td style='text-align:right;'>[<a href="composite.html">composite</a>]</td></tr></table>
+<p class="magick-description">dissolve an image into another by the given percent.</p>
<p>The opacity of the composite image is multiplied by the given percent, then
-it is composited 'over' the main image. If <em class="arg">src_percent</em>
+it is composited 'over' the main image. If <var>src_percent</var>
is greater than 100, start dissolving the main image so it becomes
-transparent at a value of '<code class="arg">200</code>'. If both percentages
+transparent at a value of '<code>200</code>'. If both percentages
are given, each image are dissolved to the percentages given. </p>
<p>Note that dissolve percentages do not add, two opaque images dissolved
images, you would need to use dissolve values of '50,100'. </p>
<div style="margin: auto;">
- <h4><a id="distort"></a>-distort <em class="arg">method arguments</em></h4>
+ <h3><a class="anchor" id="distort"></a>-distort <var>method arguments</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>distort an image, using the given <em class="arg">method</em> and its required <em class="arg">arguments</em>.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">distort an image, using the given <var>method</var> and its required <var>arguments</var>.</p>
-<p>The <em class="arg">arguments</em> is a single string containing a list
+<p>The <var>arguments</var> is a single string containing a list
of floating point numbers separated by commas or spaces. The number of
-and meaning of the floating point values depends on the distortion <em
-class="arg">method</em> being used. </p>
+and meaning of the floating point values depends on the distortion <var>method</var> being used. </p>
<p>Choose from these distortion types:</p>
-<table class="doc">
- <tr valign="top">
- <th align="left" style="width: 8%">Method</th>
- <th align="left">Description</th>
+<table class="table table-sm table-striped">
+ <tr>
+ <th style="width: 8%">Method</th>
+ <th>Description</th>
</tr>
- <tr valign="top">
- <td valign="top"><code>ScaleRotateTranslate</code>
- <br/>or <code>SRT</code></td>
- <td valign="top">
+ <tr>
+ <td>ScaleRotateTranslate <br/> SRT</td>
+ <td>
Distort image by first scaling and rotating about a given 'center',
before translating that 'center' to the new location, in that order. It
- is an alternative method of specifying a '<code>Affine</code>' type of
+ is an alternative method of specifying a 'Affine' type of
distortion, but without shearing effects. It also provides a good way
of rotating and displacing a smaller image for tiling onto a larger
background (IE 2-dimensional animations). <br/>
The number of arguments determine the specific meaning of each
argument for the scales, rotation, and translation operations. <br/>
- <table style="margin-left:auto; margin-right:auto;">
- <tr><td># </td><td>arguments meaning</td></tr>
- <tr><td>1:</td><td><em>Angle_of_Rotation</em></td></tr>
- <tr><td>2:</td><td><em>Scale Angle</em></td></tr>
- <tr><td>3:</td><td><em>X,Y Angle</em></td></tr>
- <tr><td>4:</td><td><em>X,Y Scale Angle</em></td></tr>
- <tr><td>5:</td>
- <td><em>X,Y ScaleX,ScaleY Angle</em></td></tr>
- <tr><td>6:</td>
- <td><em>X,Y Scale Angle NewX,NewY</em></td></tr>
- <tr><td>7:</td>
- <td><em>X,Y ScaleX,ScaleY Angle
- NewX,NewY</em></td></tr>
- </table>
+ <dl class="row">
+ <dt class="col-md-4">2:</dt><dd class="col-md-8"><var>Scale Angle</var></dd>
+ <dt class="col-md-4">3:</dt><dd class="col-md-8"><var>X,Y Angle</var></dd>
+ <dt class="col-md-4">4:</dt><dd class="col-md-8"><var>X,Y Scale Angle</var></dd>
+ <dt class="col-md-4">5:</dt> <dd class="col-md-8"><var>X,Y ScaleX,ScaleY Angle</var></dd>
+ <dt class="col-md-4">6:</dt> <dd class="col-md-8"><var>X,Y Scale Angle NewX,NewY</var></dd>
+ <dt class="col-md-4">7:</dt> <dd class="col-md-8"><var>X,Y ScaleX,ScaleY Angle NewX,NewY</var></dd>
+ </dl>
This is actually an alternative way of specifying a 2 dimensional linear
- '<code>Affine</code>' or '<code>AffineProjection</code>' distortion. </td> </tr>
+ 'Affine' or 'AffineProjection' distortion. </td> </tr>
- <tr valign="top">
- <td valign="top"><code>Affine</code></td>
- <td valign="top">
+ <tr>
+ <td>Affine</td>
+ <td>
Distort the image linearly by moving a list of at least 3 or more sets
of control points (as defined below). Ideally 3 sets or 12 floating
point values are given allowing the image to be linearly scaled,
rotated, sheared, and translated, according to those three points. See
- also the related '<code>AffineProjection</code>' and '<code>SRT</code>'
+ also the related 'AffineProjection' and 'SRT'
distortions. <br/>
More than 3 sets given control point pairs (12 numbers) is least
</tr>
- <tr valign="top">
- <td valign="top"><code>AffineProjection</code></td>
- <td valign="top">
+ <tr>
+ <td>AffineProjection</td>
+ <td>
Linearly distort an image using the given Affine Matrix of 6
pre-calculated coefficients forming a set of Affine Equations to map
the source image to the destination image.
- <div style="text-align: center"><em>
+ <p class="text-center"><var>
s<sub>x</sub>, r<sub>x</sub>,
r<sub>y</sub>, s<sub>y</sub>,
t<sub>x</sub>, t<sub>y</sub>
- </em></div>
+ </var></p>
See <a href="command-line-options.html#affine" >-affine</a> setting for more detail, and
meanings of these coefficients. <br/>
- The distortions '<code>Affine</code>' and '<code>SRT</code>' provide
+ The distortions 'Affine' and 'SRT' provide
alternative methods of defining this distortion, with ImageMagick doing
the calculations needed to generate the required coefficients. You can
see the internally generated coefficients, by using a <a
</tr>
- <tr valign="top">
- <td valign="top"><code>BilinearForward</code><br/>
- <code>BilinearReverse</code></td>
- <td valign="top">
+ <tr>
+ <td>BilinearForward<br/>
+ BilinearReverse</td>
+ <td>
Bilinear Distortion, given a minimum of 4 sets of coordinate pairs, or
16 values (see below). Not that lines may not appear straight after
distortion, though the distance between coordinates will remain
consistent. <br/>
- The '<code>BilinearForward</code>' is used to map rectangles to any
- quadrilateral, while the '<code>BilinearReverse</code>' form maps any
+ The 'BilinearForward' is used to map rectangles to any
+ quadrilateral, while the 'BilinearReverse' form maps any
quadrilateral to a rectangle, while preserving the straight line edges
in each case. <br/>
- Note that '<code>BilinearForward</code>' can generate invalid pixels
+ Note that 'BilinearForward' can generate invalid pixels
which will be colored using the <a href="command-line-options.html#mattecolor" >-mattecolor</a>
color setting. Also if the quadrilateral becomes 'flipped' the image
may disappear. <br/>
</td>
</tr>
- <tr valign="top">
- <td valign="top"><code>Perspective</code></td>
- <td valign="top">
+ <tr>
+ <td>Perspective</td>
+ <td>
Perspective distort the images, using a list of 4 or more sets of
control points (as defined below). More that 4 sets (16 numbers) of
control points provide least squares fitting for more accurate
distortions (for the purposes of image registration and panorama
- effects). Less than 4 sets will fall back to a '<code>Affine</code>'
+ effects). Less than 4 sets will fall back to a 'Affine'
linear distortion. <br/>
Perspective Distorted images ensures that straight lines remain
<a href="command-line-options.html#mattecolor" >-mattecolor</a> setting. </td>
</tr>
- <tr valign="top">
- <td valign="top"><code>PerspectiveProjection</code> </td>
- <td valign="top">
- Do a '<code>Perspective</code>' distortion biased on a set of 8
+ <tr>
+ <td>PerspectiveProjection </td>
+ <td>
+ Do a 'Perspective' distortion biased on a set of 8
pre-calculated coefficients. You can get these coefficients by looking
at the <a href="command-line-options.html#verbose" >-verbose</a> output of a
- '<code>Perspective</code>' distortion, or by calculating them yourself.
+ 'Perspective' distortion, or by calculating them yourself.
If the last two perspective scaling coefficients are zero, the
remaining 6 represents a transposed 'Affine Matrix'. </td>
</tr>
- <tr valign="top">
- <td valign="top"><code>Arc</code></td>
- <td valign="top">
+ <tr>
+ <td>Arc</td>
+ <td>
Arc the image (variation of polar mapping) over the angle given around
- a circle. <br/>
- <table width="90%" style = "margin-left: auto; margin-right: auto;">
- <tr valign="top"><td>Argument</td>
- <td>Meaning</td></tr>
- <tr valign="top"><td><em>arc_angle</em></td>
- <td>The angle over which to arc the image side-to-side</td></tr>
- <tr valign="top"><td><em>rotate_angle</em></td>
- <td>Angle to rotate resulting image from vertical center</td></tr>
- <tr valign="top"><td><em>top_radius</em></td>
- <td>Set top edge of source image at this radius</td></tr>
- <tr valign="top"><td><em>bottom_radius</em> </td>
- <td>Set bottom edge to this radius (radial scaling)</td></tr>
- </table>
+ a circle.
+
+ <dl class="row">
+ <dt class="col-md-4">arc_angle</dt>
+ <dd class="col-md-8">The angle over which to arc the image side-to-side</dd>
+ <dt class="col-md-4">rotate_angle</dt>
+ <dd class="col-md-8">Angle to rotate resulting image from vertical center</dd>
+ <dt class="col-md-4">top_radius</dt>
+ <dd class="col-md-8">Set top edge of source image at this radius</dd>
+ <dt class="col-md-4">bottom_radius </dt>
+ <dd class="col-md-8">Set bottom edge to this radius (radial scaling)</dd>
+ </dl>
The resulting image is always resized to best fit the resulting image,
(as if using <a href="command-line-options.html#distort" >+distort</a>) while attempting to
conversion. </td>
</tr>
- <tr valign="top">
- <td valign="top"><code>Polar</code></td>
- <td valign="top">
- Like '<code>Arc</code>' but do a complete Cartesian to Polar mapping of
+ <tr>
+ <td>Polar</td>
+ <td>
+ Like 'Arc' but do a complete Cartesian to Polar mapping of
the image. that is the height of the input image is mapped to the
radius limits, while the width is wrapped around between the
angle limits. <br/>
- Arguments: <em>Rmax,Rmin CenterX,CenterY, start,end_angle</em> <br/>
+ Arguments: <var>Rmax,Rmin CenterX,CenterY, start,end_angle</var> <br/>
- All arguments are optional. With <em>Rmin</em> defaulting to zero, the
+ All arguments are optional. With <var>Rmin</var> defaulting to zero, the
center to the center of the image, and the angles going from -180 (top)
- to +180 (top). If <em>Rmax</em> is given the special value of
- '<code>0</code>', the the distance from the center to the nearest edge
+ to +180 (top). If <var>Rmax</var> is given the special value of
+ '0', the the distance from the center to the nearest edge
is used for the radius of the output image, which will ensure the whole
image is visible (though scaled smaller). However a special value of
- '<code>-1</code>' will use the distance from the center to the furthest
+ '-1' will use the distance from the center to the furthest
corner, This may 'clip' the corners from the input rectangular image,
- but will generate the exact reverse of a '<code>DePolar</code>' with
+ but will generate the exact reverse of a 'DePolar' with
the same arguments. <br/>
If the plus form of distort (<a href="command-line-options.html#distort" >+distort</a>) is used
- output image center will default to <code>0,0</code> of the virtual
+ output image center will default to 0,0 of the virtual
canvas, and the image size adjusted to ensure the whole input image is
made visible in the output image on the virtual canvas. </td>
</tr>
- <tr valign="top">
- <td valign="top"><code>DePolar</code></td>
- <td valign="top">
- Uses the same arguments and meanings as a '<code>Polar</code>' distortion
+ <tr>
+ <td>DePolar</td>
+ <td>
+ Uses the same arguments and meanings as a 'Polar' distortion
but generates the reverse Polar to Cartesian distortion. <br/>
- The special <em>Rmax</em> setting of '<code>0</code>' may however clip
+ The special <var>Rmax</var> setting of '0' may however clip
the corners of the input image. However using the special
- <em>Rmax</em> setting of '<code>-1</code>' (maximum center to corner
+ <var>Rmax</var> setting of '-1' (maximum center to corner
distance) will ensure the whole distorted image is preserved in the
- generated result, so that the same argument to '<code>Polar</code>' will
+ generated result, so that the same argument to 'Polar' will
reverse the distortion re-producing the original.
Note that as this distortion requires the area resampling of a circular
</tr>
- <tr valign="top">
- <td valign="top"><code>Barrel</code></td>
- <td valign="top">
+ <tr>
+ <td>Barrel</td>
+ <td>
Given the four coefficients (A,B,C,D) as defined by <a
href="http://wiki.panotools.org/Lens_correction_model" >Helmut
Dersch</a>, perform a barrel or pin-cushion distortion appropriate to
correct radial lens distortions. That is in photographs, make straight
lines straight again. <br/>
- Arguments: <em>A B C</em> [ <em>D</em> [
- <em>X</em> , <em>Y</em> ] ] <br/>
- or <em>A<sub>x</sub> B<sub>x</sub> C<sub>x</sub> D<sub>x</sub>
- A<sub>y</sub> B<sub>y</sub> C<sub>y</sub> D<sub>y</sub></em>
- [ <em>X</em> , <em>Y</em> ] <br/>
- So that it forms the function <br/>
- Rsrc = r * ( <em>A</em>*r<sup>3</sup> + <em>B</em>*r<sup>2</sup> +
- <em>C</em>*r + <em>D</em> )<br/>
+ <p class="text-center">Arguments: <var>A B C</var> [ <var>D</var> [
+ <var>X</var> , <var>Y</var> ] ] <br/>
+ or <var>A<sub>x</sub> B<sub>x</sub> C<sub>x</sub> D<sub>x</sub>
+ A<sub>y</sub> B<sub>y</sub> C<sub>y</sub> D<sub>y</sub></var>
+ [ <var>X</var> , <var>Y</var> ] </p>
+ So that it forms the function
+ <p class="text-center">Rsrc = r * ( <var>A</var>*r<sup>3</sup> + <var>B</var>*r<sup>2</sup> +
+ <var>C</var>*r + <var>D</var> )</p>
- Where <em>X</em>,<em>Y</em> is the optional center of the distortion
+ Where <var>X</var>,<var>Y</var> is the optional center of the distortion
(defaulting to the center of the image). <br/>
The second form is typically used to distort images, rather than
correct lens distortions. <br/>
</tr>
- <tr valign="top">
- <td valign="top"><code>BarrelInverse</code></td>
- <td valign="top">
- This is very similar to '<code>Barrel</code>' with the same set of
+ <tr>
+ <td>BarrelInverse</td>
+ <td>
+ This is very similar to 'Barrel' with the same set of
arguments, and argument handling. However it uses the inverse
of the radial polynomial,
- so that it forms the function <br/>
- Rsrc = r / ( <em>A</em>*r<sup>3</sup> + <em>B</em>*r<sup>2</sup> +
- <em>C</em>*r + <em>D</em> )<br/>
- Note that this is not the reverse of the '<code>Barrel</code>'
+ so that it forms the function
+ <p class="text-center">Rsrc = r / ( <var>A</var>*r<sup>3</sup> + <var>B</var>*r<sup>2</sup> +
+ <var>C</var>*r + <var>D</var> )</p>
+ Note that this is not the reverse of the 'Barrel'
distortion, just a different barrel-like radial distortion method.
</td>
</tr>
- <tr valign="top">
- <td valign="top"><code>Shepards</code></td>
- <td valign="top">
+ <tr>
+ <td>Shepards</td>
+ <td>
Distort the given list control points (any number) using an Inverse
Squared Distance Interpolation Method (<a
href="http://en.wikipedia.org/wiki/Shepard%27s_method" >Shepards
destination image. Each set of four floating point values represent a source
image coordinate, followed immediately by the destination image coordinate.
This produces a list of values such as...</p>
-<div style="text-align: center"><em>
+<p class="text-center"><var>
U<sub>1</sub>,V<sub>1</sub> X<sub>1</sub>,Y<sub>1</sub>
U<sub>2</sub>,V<sub>2</sub> X<sub>2</sub>,Y<sub>2</sub>
U<sub>3</sub>,V<sub>3</sub> X<sub>3</sub>,Y<sub>3</sub>
...
U<sub>n</sub>,V<sub>n</sub> X<sub>n</sub>,Y<sub>n</sub>
-</em></div>
-<p>where <em>U,V</em> on the source image is mapped to <em>X,Y</em> on the
+</var></p>
+<p>where <var>U,V</var> on the source image is mapped to <var>X,Y</var> on the
destination image. </p>
<p>For example, to warp an image using '<code>perspective</code>' distortion,
used to group the 4 sets of coordinate pairs, to make it easier to read and
understand.</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>
-convert rose: -virtual-pixel black \<br/>
- -distort Perspective '0,0,0,0 0,45,0,45 69,0,60,10 69,45,60,35' \<br/>
- rose_3d_rotated.gif</span></p>
+<pre class="highlight"><code>convert rose: -virtual-pixel black \
+ -distort Perspective '0,0,0,0 0,45,0,45 69,0,60,10 69,45,60,35' \
+ rose_3d_rotated.gif"
+</code></pre>
+
<p>If more that the required number of coordinate pairs are given for
a distortion, the distortion method is 'least squares' fitted to produce the
best result for all the coordinate pairs given. If less than the ideal number
using '<code>perspective</code>' distortion. For example here we view
a infinitely tiled 'plane' all the way to the horizon. </p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>
-convert -size 90x90 pattern:checkerboard -normalize -virtual-pixel tile \<br/>
- -distort perspective '0,0,5,45 89,0,45,46 0,89,0,89 89,89,89,89' \<br/>
- checks_tiled.jpg</span></p>
+<pre class="highlight"><code>convert -size 90x90 pattern:checkerboard -normalize -virtual-pixel tile \
+ -distort perspective '0,0,5,45 89,0,45,46 0,89,0,89 89,89,89,89' \
+ checks_tiled.jpg
+</code></pre>
+
<p>Note that a infinitely tiled perspective images involving the horizon can
be very slow, because of the number of pixels that are compressed to generate
each individual pixel close to the 'horizon'. You can turn off EWA
-resampling, by specifing the special <a href="command-line-options.html#filter" >-filter</a> setting of
+resampling, by specifying the special <a href="command-line-options.html#filter" >-filter</a> setting of
'<code>point</code>' (recommended if you plan to use super-sampling instead).
</p>
distorted image space.</p>
<p>Setting a "<code><a href="command-line-options.html#define" >-define</a>
-distort:scale={scale_factor}</code>" will scale the output image (viewport or
+distort:scale=<var>scale_factor</var></code>" will scale the output image (viewport or
otherwise) by that factor without changing the viewed contents of the
distorted image. This can be used either for 'super-sampling' the image for
a higher quality result, or for panning and zooming around the image (with
<div style="margin: auto;">
- <h4><a id="distribute-cache"></a>-distribute-cache <em class="arg">port</em></h4>
+ <h3><a class="anchor" id="distribute-cache"></a>-distribute-cache <var>port</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>launch a distributed pixel cache server. </td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">launch a distributed pixel cache server. </p>
<div style="margin: auto;">
- <h4><a id="dither"></a>-dither <em class="arg">method</em></h4>
+ <h3><a class="anchor" id="dither"></a>-dither <var>method</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Apply a Riemersma or Floyd-Steinberg error diffusion dither to
+<p class="magick-description">Apply a Riemersma or Floyd-Steinberg error diffusion dither to
images when general color reduction is applied via an option, or automagically
-when saving to specific formats. This enabled by default. </td><td style='text-align:right;'></td></tr></table>
+when saving to specific formats. This enabled by default.</p>
<p>Dithering places two or more colors in neighboring pixels so that to the
eye a closer approximation of the images original color is reproduced. This
to generate purely random dither. Or use <a
href="command-line-options.html#ordered-dither">-ordered-dither</a> to apply threshold mapped dither
patterns, using uniform color maps, rather than specific color maps. </p>
+<p>Use "<code><a href="command-line-options.html#define" >-define</a> dither:diffusion-amount=35%</code>, for example, to control the amount of Floyd-Steinberg dither.</p>
<div style="margin: auto;">
- <h4><a id="draw"></a>-draw <em class="arg">string</em></h4>
+ <h3><a class="anchor" id="draw"></a>-draw <var>string</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Annotate an image with one or more graphic primitives.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Annotate an image with one or more graphic primitives.</p>
<p>Use this option to annotate or decorate an image with one or more graphic
primitives. The primitives include shapes, text, transformations, and pixel
<p>The shape primitives:</p>
-<pre class="text">
- point x,y
- line x0,y0 x1,y1
- rectangle x0,y0 x1,y1
- roundRectangle x0,y0 x1,y1 wc,hc
- arc x0,y0 x1,y1 a0,a1
- ellipse x0,y0 rx,ry a0,a1
- circle x0,y0 x1,y1
- polyline x0,y0 ... xn,yn
- polygon x0,y0 ... xn,yn
- bezier x0,y0 ... xn,yn
- path path specification
- image operator x0,y0 w,h filename
-</pre>
+<dl class="row">
+<dt class="col-md-4">point</dt><dd class="col-md-8"> x,y</dd>
+<dt class="col-md-4">line</dt><dd class="col-md-8"> x0,y0 x1,y1</dd>
+<dt class="col-md-4">rectangle</dt><dd class="col-md-8"> x0,y0 x1,y1</dd>
+<dt class="col-md-4">roundRectangle</dt><dd class="col-md-8"> x0,y0 x1,y1 wc,hc</dd>
+<dt class="col-md-4">arc</dt><dd class="col-md-8"> x0,y0 x1,y1 a0,a1</dd>
+<dt class="col-md-4">ellipse</dt><dd class="col-md-8"> x0,y0 rx,ry a0,a1</dd>
+<dt class="col-md-4">circle</dt><dd class="col-md-8"> x0,y0 x1,y1</dd>
+<dt class="col-md-4">polyline</dt><dd class="col-md-8"> x0,y0 ... xn,yn</dd>
+<dt class="col-md-4">polygon</dt><dd class="col-md-8"> x0,y0 ... xn,yn</dd>
+<dt class="col-md-4">bezier</dt><dd class="col-md-8"> x0,y0 ... xn,yn</dd>
+<dt class="col-md-4">path</dt><dd class="col-md-8">specification </dd>
+<dt class="col-md-4">image</dt><dd class="col-md-8"> operator x0,y0 w,h filename</dd>
+</dl>
<p>The text primitive:</p>
-<pre class="text">
- text x0,y0 string
-</pre>
+<dl class="row">
+<dt class="col-md-4">text</dt><dd class="col-md-8">x0,y0 string</dd>
+</dl>
<p>The text gravity primitive:</p>
-<pre class="text">
- gravity NorthWest, North, NorthEast, West, Center,
- East, SouthWest, South, or SouthEast
-</pre>
+<dl class="row">
+<dt class="col-md-4">gravity</dt><dd class="col-md-8">NorthWest, North, NorthEast, West, Center, East, SouthWest, South, or SouthEast</dd>
+</dl>
<p>The text gravity primitive only affects the placement of text and does not
interact with the other primitives. It is equivalent to using the <a
<p>The transformation primitives:</p>
-<pre class="text">
- rotate degrees
- translate dx,dy
- scale sx,sy
- skewX degrees
- skewY degrees
-</pre>
+<dl class="row">
+<dt class="col-md-4">rotate</dt><dd class="col-md-8">degrees</dd>
+<dt class="col-md-4">translate</dt><dd class="col-md-8">dx,dy</dd>
+<dt class="col-md-4">scale</dt><dd class="col-md-8">sx,sy</dd>
+<dt class="col-md-4">skewX</dt><dd class="col-md-8">degrees</dd>
+<dt class="col-md-4">skewY</dt><dd class="col-md-8">degrees</dd>
+</dl>
<p>The pixel operation primitives:</p>
-<pre class="text">
- color x0,y0 method
- matte x0,y0 method
-</pre>
+<dl class="row">
+<dt class="col-md-4">color</dt><dd class="col-md-8">x0,y0 method</dd>
+<dt class="col-md-4">matte</dt><dd class="col-md-8">x0,y0 method</dd>
+</dl>
<p>The shape primitives are drawn in the color specified by the preceding <a
href="command-line-options.html#fill">-fill</a> setting. For unfilled shapes, use <a
"outline" of a shape) with the <a href="command-line-options.html#stroke">-stroke</a> and <a
href="command-line-options.html#strokewidth">-strokewidth</a> settings.</p>
-<p>A <code>point</code> primitive is specified by a single <em>point</em> in the
+<p>A <code>point</code> primitive is specified by a single <var>point</var> in the
pixel plane, that is, by an ordered pair of integer coordinates,
-<em>x</em>,<em>y</em>. (As it involves only a single pixel, a <code>point</code>
+<var>x</var>,<var>y</var>. (As it involves only a single pixel, a <code>point</code>
primitive is not affected by <a href="command-line-options.html#stroke">-stroke</a> or <a
href="command-line-options.html#strokewidth">-strokewidth</a>.)</p>
of an ellipse is filled.</p>
<p>Use <code>ellipse</code> to draw a partial (or whole) ellipse. Give the
-center point, the horizontal and vertical "radii" (the <em>semi-axes</em> of
+center point, the horizontal and vertical "radii" (the <var>semi-axes</var> of
the ellipse) and start and end angles in degrees (e.g. 100,100 100,150
0,360).</p>
<p>The <code>polyline</code> and <code>polygon</code> primitives require three or
more points to define their perimeters. A <code>polyline</code> is simply
a <code>polygon</code> in which the final point is not stroked to the start
-point. When unfilled, this is a <em>polygonal line</em>. If the <a
+point. When unfilled, this is a <var>polygonal line</var>. If the <a
href="command-line-options.html#stroke">-stroke</a> setting is <code>none</code> (the default), then
a <code>polyline</code> is identical to a <code>polygon</code>. </p>
-<p>A <em>coordinate</em> is a pair of integers separated by a space or
+<p>A <var>coordinate</var> is a pair of integers separated by a space or
optional comma. </p>
<p>As an example, to define a circle centered at 100,100 that extends to
150,150 use:</p>
-<p class="crtsnip">
- -draw 'circle 100,100 150,150'
-</p>
+<pre class="highlight"><code>-draw 'circle 100,100 150,150'
+</code></pre>
<p>The <code>Bezier</code> primitive creates a spline curve and requires three
or points to define its shape. The first and last points are the
-<em>knots</em> and these points are attained by the curve, while any
-intermediate coordinates are <em>control points</em>. If two control points
+<var>knots</var> and these points are attained by the curve, while any
+intermediate coordinates are <var>control points</var>. If two control points
are specified, the line between each end knot and its sequentially respective
control point determines the tangent direction of the curve at that end. If
one control point is specified, the lines from the end knots to the one
<code>path</code> primitive or to draw multiple four-point bezier segments with
the start and end knots of each successive segment repeated. For example:</p>
-<p class="crtsnip">
- -draw 'bezier 20,50 45,100 45,0 70,50'
-</p>
-<p class="crtsnip">
- -draw 'bezier 70,50 95,100 95,0 120,50'
-</p>
-
+<pre class="highlight"><code>-draw 'bezier 20,50 45,100 45,0 70,50'
+-draw 'bezier 70,50 95,100 95,0 120,50'
+</code></pre>
<p>A <code>path</code> represents an outline of an object, defined in terms of
moveto (set a new current point), lineto (draw a straight line), curveto (draw
current shape by drawing a line to the last moveto) elements. Compound paths
(i.e., a path with subpaths, each consisting of a single moveto followed by
one or more line or curve operations) are possible to allow effects such as
-<em>donut holes</em> in objects. (See <a
+<var>donut holes</var> in objects. (See <a
href="http://www.w3.org/TR/SVG/paths.html">Paths</a>.)</p>
<p>Use <code>image</code> to composite an image with another image. Follow the
image keyword with the composite operator, image location, image size, and
filename:</p>
-<p class="crtsnip">
- -draw 'image SrcOver 100,100 225,225 image.jpg'
-</p>
+<pre class="highlight"><code>-draw 'image SrcOver 100,100 225,225 image.jpg'
+</code></pre>
<p>You can use 0,0 for the image size, which means to use the actual
dimensions found in the image header. Otherwise, it is scaled to the given
-dimensions. See <a href="compose.html">Alpha Compositing</a> for
+dimensions. See <a href="../www/compose.html">Alpha Compositing</a> for
a detailed discussion of alpha composition methods that are available. </p>
<p>The "special augmented compose operators" such as "dissolve" that require
<p>For example, the following annotates the image with <code>Works like
magick!</code> for an image titled <code>bird.miff</code>. </p>
-<p class="crtsnip">
- -draw "text 100,100 'Works like magick!' "
-</p>
+<pre class="highlight"><code>-draw "text 100,100 'Works like magick!' "
+</code></pre>
<p>See the <a href="command-line-options.html#annotate">-annotate</a> option for another convenient way
to annotate an image with text.</p>
<p>The <code>rotate</code> primitive rotates subsequent shape primitives and
-text primitives about the origin of the main image. If the <a
-href="command-line-options.html#region">-region</a> option precedes the <a href="command-line-options.html#draw">-draw</a>
-option, the origin for transformations is the upper left corner of the
-region.</p>
+text primitives about the origin of the main image.</p>
<p>The <code>translate</code> primitive translates subsequent shape and text
primitives.</p>
fill color (see <a href="command-line-options.html#fill">-fill</a>). Follow the pixel coordinate with
a method:</p>
-<pre class="text">
- point
- replace
- floodfill
- filltoborder
- reset
-</pre>
+<pre class="highlight"><code>point
+replace
+floodfill
+filltoborder
+reset
+</code></pre>
<p>Consider the target pixel as that specified by your coordinate. The
<code>point</code> method recolors the target pixel. The <code>replace</code>
<p>You can set the primitive color, font, and font bounding box color with <a
href="command-line-options.html#fill">-fill</a>, <a href="command-line-options.html#font">-font</a>, and <a href="command-line-options.html#box">-box</a>
respectively. Options are processed in command line order so be sure to use
-these options <em>before</em> the <a href="command-line-options.html#draw">-draw</a> option.</p>
+these options <var>before</var> the <a href="command-line-options.html#draw">-draw</a> option.</p>
<p>Strings that begin with a number must be quoted (e.g. use '1.png' rather
than 1.png).</p>
<div style="margin: auto;">
- <h4><a id="duplicate"></a>-duplicate <em class="arg">count,indexes</em></h4>
+ <h3><a class="anchor" id="duplicate"></a>-duplicate <var>count,indexes</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>duplicate an image one or more times.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">duplicate an image one or more times.</p>
<p>Specify the count and the image to duplicate by its index in the sequence.
The first image is index 0. Negative indexes are relative to the end of the
image sequence.</p>
<div style="margin: auto;">
- <h4><a id="edge"></a>-edge <em class="arg">radius</em></h4>
+ <h3><a class="anchor" id="edge"></a>-edge <var>radius</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>detect edges within an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">detect edges within an image.</p>
<div style="margin: auto;">
- <h4><a id="emboss"></a>-emboss <em class="arg">radius</em></h4>
+ <h3><a class="anchor" id="emboss"></a>-emboss <var>radius</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>emboss an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">emboss an image.</p>
<div style="margin: auto;">
- <h4><a id="encipher"></a>-encipher <em class="arg">filename</em></h4>
+ <h3><a class="anchor" id="encipher"></a>-encipher <var>filename</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Encipher pixels for later deciphering by <a href="command-line-options.html#decipher">-decipher</a>.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Encipher pixels for later deciphering by <a href="command-line-options.html#decipher">-decipher</a>.</p>
-<p>Get the passphrase from the file specified by <em class="arg"
->filename</em>.</p>
+<p>Get the passphrase from the file specified by <var>filename</var>.</p>
<p>For more information, see the webpage, <a
-href="../cipher.html">ImageMagick: Encipher or
+href="../www/cipher.html">ImageMagick: Encipher or
Decipher an Image</a>.</p>
<div style="margin: auto;">
- <h4><a id="encoding"></a>-encoding <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="encoding"></a>-encoding <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>specify the text encoding.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">specify the text encoding.</p>
-<p>Choose from <code>AdobeCustom</code>, <code>AdobeExpert</code>,
-<code>AdobeStandard</code>, <code>AppleRoman</code>, <code>BIG5</code>,
-<code>GB2312</code>, <code>Latin 2</code>, <code>None</code>, <code>SJIScode</code>,
-<code>Symbol</code>, <code>Unicode</code>, <code>Wansung</code>.</p>
+<p>Choose from</p>
+
+<pre class="highlight"><code>AdobeCustom AdobeExpert
+AdobeStandard AppleRoman
+BIG5 GB2312
+Latin 2 None
+SJIScode Symbol
+Unicode Wansung
+</code></pre>
<div style="margin: auto;">
- <h4><a id="endian"></a>-endian <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="endian"></a>-endian <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Specify endianness (<code>MSB</code> or <code>LSB</code>) of the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Specify endianness (<code>MSB</code> or <code>LSB</code>) of the image.</p>
<p>To print a complete list of endian types, use the <a href="command-line-options.html#list">-list endian</a> option.</p>
<div style="margin: auto;">
- <h4><a id="enhance"></a>-enhance</h4>
+ <h3><a class="anchor" id="enhance"></a>-enhance</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Apply a digital filter to enhance a noisy image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Apply a digital filter to enhance a noisy image.</p>
<div style="margin: auto;">
- <h4><a id="equalize"></a>-equalize</h4>
+ <h3><a class="anchor" id="equalize"></a>-equalize</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>perform histogram equalization on the image channel-by-channel.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">perform histogram equalization on the image channel-by-channel.</p>
<p>To perform histogram equalization on all channels in concert, transform the
image into some other color space, such as HSL, OHTA, YIQ or YUV, then
-colorspace RGB</code> ...</p>
<div style="margin: auto;">
- <h4><a id="evaluate"></a>-evaluate <em class="arg">operator value</em></h4>
+ <h3><a class="anchor" id="evaluate"></a>-evaluate <var>operator value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Alter channel pixels by evaluating an arithmetic, relational, or logical expression.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Alter channel pixels by evaluating an arithmetic, relational, or logical expression.</p>
<p>(See the <a href="command-line-options.html#function" >-function</a> operator for some
multi-parameter functions. See the <a href="command-line-options.html#fx" >-fx</a> operator if more
elaborate calculations are needed.)</p>
-<p>The behaviors of each <em class="arg">operator</em> are summarized in the
+<p>The behaviors of each <var>operator</var> are summarized in the
following list. For brevity, the numerical value of a "pixel" referred to
below is the value of the corresponding channel of that pixel, while
a "normalized pixel" is that number divided by the maximum
-(installation-dependent) value <em class="QR">QuantumRange</em>. (If
+(installation-dependent) value <var>QuantumRange</var>. (If
normalized pixels are used, they are restored, following the other
-calculations, to the full range by multiplying by <em
-class="QR">QuantumRange</em>.)</p>
+calculations, to the full range by multiplying by <var>QuantumRange</var>.)</p>
-<table class="doc">
+<table class="table table-sm table-striped">
<col width="25%" />
<col width="75%" />
<thead>
<tr>
- <th><em class="arg">operator</em></th>
+ <th><var>operator</var></th>
<th>Summary (see further below for details)</th>
</tr>
</thead>
<tbody>
- <tr><td>Abs </td> <td>Add <em class="arg">value</em> to pixels and return absolute value. </td></tr>
- <tr><td>Add </td> <td>Add <em class="arg">value</em> to pixels. </td></tr>
- <tr><td>AddModulus </td> <td>Add <em class="arg">value</em> to pixels modulo <em class="QR">QuantumRange</em>.</td></tr>
- <tr><td>And </td> <td>Binary AND of pixels with <em class="arg">value</em>.</td></tr>
- <tr><td>Cos, Cosine </td> <td>Apply cosine to pixels with frequency <em class="arg">value</em> with 50% bias added.</td></tr>
- <tr><td>Divide </td> <td>Divide pixels by <em class="arg">value</em>.</td></tr>
+ <tr><td>Abs </td> <td>Add <var>value</var> to pixels and return absolute value. </td></tr>
+ <tr><td>Add </td> <td>Add <var>value</var> to pixels. </td></tr>
+ <tr><td>AddModulus </td> <td>Add <var>value</var> to pixels modulo <var>QuantumRange</var>.</td></tr>
+ <tr><td>And </td> <td>Binary AND of pixels with <var>value</var>.</td></tr>
+ <tr><td>Cos, Cosine </td> <td>Apply cosine to pixels with frequency <var>value</var> with 50% bias added.</td></tr>
+ <tr><td>Divide </td> <td>Divide pixels by <var>value</var>.</td></tr>
<tr><td>Exp </td> <td>base-e exponential function</td></tr>
<tr><td>Exponential </td> <td>base-e exponential function</td></tr>
- <tr><td>LeftShift </td> <td>Shift the pixel values left by <em class="arg">value</em> bits (i.e., multiply pixels by 2<sup><em class="arg">value</em></sup>).</td></tr>
+ <tr><td>LeftShift </td> <td>Shift the pixel values left by <var>value</var> bits (i.e., multiply pixels by 2<sup><var>value</var></sup>).</td></tr>
<tr><td>Log </td> <td>Apply scaled logarithm to normalized pixels.</td></tr>
- <tr><td>Max </td> <td>Clip pixels at lower bound <em class="arg">value</em>.</td></tr>
- <tr><td>Mean </td> <td>Add the <em class="arg">value</em> and divide by 2.</td></tr>
+ <tr><td>Max </td> <td>Set pixels to maximum of <var>value</var> and current pixel <var>value</var> (i.e. set any pixels currently less than <var>value</var> to <var>value</var>).</td></tr>
+ <tr><td>Mean </td> <td>Add the <var>value</var> and divide by 2.</td></tr>
<tr><td>Median </td> <td>Choose the median value from an image sequence.</td></tr>
- <tr><td>Min </td> <td>Clip pixels at upper bound <em class="arg">value</em>.</td></tr>
- <tr><td>Multiply </td> <td>Multiply pixels by <em class="arg">value</em>.</td></tr>
- <tr><td>Or </td> <td>Binary OR of pixels with <em class="arg">value</em>.</td></tr>
- <tr><td>Pow </td> <td>Raise normalized pixels to the power <em class="arg">value</em>.</td></tr>
- <tr><td>RightShift </td> <td>Shift the pixel values right by <em class="arg">value</em> bits (i.e., divide pixels by 2<sup><em class="arg">value</em></sup>).</td></tr>
- <tr><td>RMS</td> <td>Square the pixel and add the <em class="arg">value</em>.</td></tr>
- <tr><td>RootMeanSquare</td> <td>Square the pixel and add the <em class="arg">value</em>.</td></tr>
- <tr><td>Set </td> <td>Set pixel equal to <em class="arg">value</em>.</td></tr>
- <tr><td>Sin, Sine </td> <td>Apply sine to pixels with frequency <em class="arg">value</em> with 50% bias added.</td></tr>
- <tr><td>Subtract </td> <td>Subtract <em class="arg">value</em> from pixels.</td></tr>
- <tr><td>Xor </td> <td>Binary XOR of pixels with <em class="arg">value.</em></td></tr>
-
- <tr><td> </td></tr>
-
- <tr><td>Gaussian-noise</td></tr>
- <tr><td>Impulse-noise</td></tr>
- <tr><td>Laplacian-noise</td></tr>
+ <tr><td>Min </td> <td>Set pixels to minimum of <var>value</var> and current pixel <var>value</var> (i.e. set any pixels currently greater than <var>value</var> to <var>value</var>).</td></tr>
+ <tr><td>Multiply </td> <td>Multiply pixels by <var>value</var>.</td></tr>
+ <tr><td>Or </td> <td>Binary OR of pixels with <var>value</var>.</td></tr>
+ <tr><td>Pow </td> <td>Raise normalized pixels to the power <var>value</var>.</td></tr>
+ <tr><td>RightShift </td> <td>Shift the pixel values right by <var>value</var> bits (i.e., divide pixels by 2<sup><var>value</var></sup>).</td></tr>
+ <tr><td>RMS</td> <td>Square the pixel and add the <var>value</var>.</td></tr>
+ <tr><td>RootMeanSquare</td> <td>Square the pixel and add the <var>value</var>.</td></tr>
+ <tr><td>Set </td> <td>Set pixel equal to <var>value</var>.</td></tr>
+ <tr><td>Sin, Sine </td> <td>Apply sine to pixels with frequency <var>value</var> with 50% bias added.</td></tr>
+ <tr><td>Subtract </td> <td>Subtract <var>value</var> from pixels.</td></tr>
+ <tr><td>Xor </td> <td>Binary XOR of pixels with <var>value.</var></td></tr>
+
+ <tr><td> </td><td> </td></tr>
+
+ <tr><td>Gaussian-noise</td><td> </td></tr>
+ <tr><td>Impulse-noise</td><td> </td></tr>
+ <tr><td>Laplacian-noise</td><td> </td></tr>
<tr><td>Multiplicative-noise</td> <td>(These are equivalent to the corresponding <a href="command-line-options.html#noise" >-noise</a> operators.)</td></tr>
- <tr><td>PoissonNoise</td></tr>
- <tr><td>Uniform-noise</td></tr>
+ <tr><td>PoissonNoise</td><td> </td></tr>
+ <tr><td>Uniform-noise</td><td> </td></tr>
- <tr><td> </td></tr>
+ <tr><td> </td><td> </td></tr>
- <tr><td>Threshold </td> <td>Threshold pixels larger than <em class="arg">value</em>.</td></tr>
- <tr><td>ThresholdBlack </td> <td>Threshold pixels to zero values equal to or below <em class="arg">value</em>.</td></tr>
- <tr><td>ThresholdWhite </td> <td>Threshold pixels to maximum values above <em class="arg">value</em>. </td></tr>
+ <tr><td>Threshold </td> <td>Threshold pixels larger than <var>value</var>.</td></tr>
+ <tr><td>ThresholdBlack </td> <td>Threshold pixels to zero values equal to or below <var>value</var>.</td></tr>
+ <tr><td>ThresholdWhite </td> <td>Threshold pixels to maximum values above <var>value</var>. </td></tr>
</tbody>
</table>
<p>The specified functions are applied only to each previously set <a
href="command-line-options.html#channel" >-channel</a> in the image. If necessary, the results of the
-calculations are truncated (clipped) to fit in the interval [0, <em
-class="QR">QuantumRange</em>]. The transparency channel of the image is
+calculations are truncated (clipped) to fit in the interval [0, <var>QuantumRange</var>]. The transparency channel of the image is
represented as a 'alpha' values (0 = fully transparent), so, for example, a
<code>Divide</code> by 2 of the alpha channel will make the image
semi-transparent. Append the percent symbol '<code>%</code>' to specify a value
-as a percentage of the <em class="QR">QuantumRange</em>.</p>
+as a percentage of the <var>QuantumRange</var>.</p>
<p>To print a complete list of <a href="command-line-options.html#evaluate">-evaluate</a> operators, use
<a href="command-line-options.html#list">-list evaluate</a>.</p>
'alpha' values.</p>
<p><code>AddModulus</code> has been added as of ImageMagick 6.4.8-4 and provides
-addition modulo the <em class="QR">QuantumRange</em>. It is therefore
+addition modulo the <var>QuantumRange</var>. It is therefore
equivalent to <code>Add</code> unless the resulting pixel value is outside the
-interval [0, <em class="QR">QuantumRange</em>]. </p>
+interval [0, <var>QuantumRange</var>]. </p>
<p><code>Exp or Exponential</code> has been added as of ImageMagick 6.6.5-1 and
-works on normalized pixel values. The <em class="arg">value</em> used with
+works on normalized pixel values. The <var>value</var> used with
<code>Exp</code> should be negative so as to produce a decaying exponential
function. Non-negative values will always produce results larger unity and
-thus outside the interval [0, <em class="QR">QuantumRange</em>]. The
+thus outside the interval [0, <var>QuantumRange</var>]. The
formula is expressed below. </p>
- <div style="text-align:center;">
- exp(<em class="arg">value</em> × <b><em>u</em></b>)
- </div>
+<p class="text-center">
+exp(<var>value</var> × <b><var>u</var></b>)
+</p>
<p> If the input image is squared, for example, using <a href="command-line-options.html#-function"
>-function polynomial "2 0 0"</a>, then a decaying Gaussian function will be
the result.</p>
<p><code>Log</code> has been added as of ImageMagick 6.4.2-1 and works on
-normalized pixel values. This a <em>scaled</em> log function. The <em
-class="arg">value</em> used with <code>Log</code> provides a <em>scaling
-factor</em> that adjusts the curvature in the graph of the log function. The
-formula applied to a normalized value <b><em>u</em></b> is below. </p>
+normalized pixel values. This a <var>scaled</var> log function. The <var>value</var> used with <code>Log</code> provides a <var>scaling
+factor</var> that adjusts the curvature in the graph of the log function. The
+formula applied to a normalized value <b><var>u</var></b> is below. </p>
- <div style="text-align:center;">
- log(<em class="arg">value</em> × <b><em>u</em></b> + 1) / log(<em class="arg">value</em> + 1)
- </div>
+<p class="text-center">
+log(<var>value</var> × <b><var>u</var></b> + 1) / log(<var>value</var> + 1)
+</p>
<p><code>Pow</code> has been added as of ImageMagick 6.4.1-9, and works on
normalized pixel values. Note that <code>Pow</code> is related to the <a
converts the image values into a value according to a (co)sine wave function.
The synonyms <code>Cos</code> and <code>Sin</code> may also be used. The output
is biased 50% and normalized by 50% so as to fit in the respective color value
-range. The <em class="arg">value</em> scaling of the <em>period</em> of the
+range. The <var>value</var> scaling of the <var>period</var> of the
function (its frequency), and thus determines the number of 'waves' that will
-be generated over the input color range. For example, if the <em
-class="arg">value</em> is 1, the effective period is simply the <em
-class="QR">QuantumRange</em>; but if the <em class="arg">value</em> is 2,
-then the effective period is the <em>half</em> the <em
-class="QR">QuantumRange</em>.</p>
+be generated over the input color range. For example, if the <var>value</var> is 1, the effective period is simply the <var>QuantumRange</var>; but if the <var>value</var> is 2,
+then the effective period is the <var>half</var> the <var>QuantumRange</var>.</p>
- <div style="text-align:center;">
- 0.5 + 0.5 × cos(2 π <b><em>u</em></b> × <em class="arg">value</em>).
- </div>
+<p class="text-center">
+0.5 + 0.5 × cos(2 π <b><var>u</var></b> × <var>value</var>).
+</p>
<p>See also the <a href="command-line-options.html#function" >-function</a> operator, which is a
multi-value version of evaluate. </p>
<div style="margin: auto;">
- <h4><a id="evaluate-sequence"></a>-evaluate-sequence <em class="arg">operator</em></h4>
+ <h3><a class="anchor" id="evaluate-sequence"></a>-evaluate-sequence <var>operator</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Alter channel pixels by evaluating an arithmetic, relational, or
-logical expression over a sequence of images.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Alter channel pixels by evaluating an arithmetic, relational, or logical expression over a sequence of images. Ensure all the images in the sequence are in the same colorspace, otherwise you may get unexpected results, e.g. add <a href="command-line-options.html#colorspace" >-colorspace sRGB</a> to your command-line.</p>
<p>To print a complete list of <a
href="command-line-options.html#evaluate-sequence">-evaluate-sequence</a> operators, use <a
href="command-line-options.html#list">-list evaluate</a>.</p>
<div style="margin: auto;">
- <h4><a id="extent"></a>-extent <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="extent"></a>-extent <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the image size and offset.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set the image size and offset.</p>
<p>If the image is enlarged, unfilled areas are set to the background color.
-To position the image, use offsets in the <em class="arg">geometry</em>
+To position the image, use offsets in the <var>geometry</var>
specification or precede with a <a href="command-line-options.html#gravity">-gravity</a> setting. To
specify how to compose the image with the background, use <a href="command-line-options.html#compose"
>-compose</a>.</p>
display. If the aspect ratio of the input image isn't exactly 4:3, then the
image is centered on an 800x600 black canvas: </p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert input.jpg -resize 800x600 -background black -compose Copy \ <br /> -gravity center -extent 800x600 -quality 92 output.jpg</span></p>
-
+<pre class="highlight"><code>convert input.jpg -resize 800x600 -background black -compose Copy \
+ -gravity center -extent 800x600 -quality 92 output.jpg
+</code></pre>
<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
<div style="margin: auto;">
- <h4><a id="extract"></a>-extract <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="extract"></a>-extract <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Extract the specified area from image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Extract the specified area from image.</p>
<p>This option is most useful for extracting a subregion of a very large raw
image. Note that these two commands are equivalent:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert -size 16000x16000 -depth 8 -extract 640x480+1280+960 \ <br/> image.rgb image.png</span><span class='crtout'></span><span class="crtprompt"> $magick> </span><span class='crtin'>convert -size 16000x16000 -depth 8 'image.rgb[640x480+1280+960]' \ <br/> image.rgb image.png</span></p><p>If you omit the offsets, as in</p>
+<pre class="highlight"><code>convert -size 16000x16000 -depth 8 -extract 640x480+1280+960 \
+ image.rgb image.png",
+convert -size 16000x16000 -depth 8 'image.rgb[640x480+1280+960]' \
+ image.rgb image.png"
+</code></pre>
+
+<p>If you omit the offsets, as in</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert -size 16000x16000 -depth 8 -extract 640x480 \ <br/> image.rgb image.png</span></p>
-<p>the image is <em>resized</em> to the specified dimensions instead,
+<pre class="highlight"><code>convert -size 16000x16000 -depth 8 -extract 640x480 \
+ image.rgb image.png
+</code></pre>
+
+<p>the image is <var>resized</var> to the specified dimensions instead,
equivalent to:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert -size 16000x16000 -depth 8 -resize 640x480 image.rgb image.png</span></p>
+<pre class="highlight"><code>convert -size 16000x16000 -depth 8 -resize 640x480 image.rgb image.png
+</code></pre>
+
<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
<div style="margin: auto;">
- <h4><a id="family"></a>-family <em class="arg">fontFamily</em></h4>
+ <h3><a class="anchor" id="family"></a>-family <var>fontFamily</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set a font family for text.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set a font family for text.</p>
<p>This setting suggests a font family that ImageMagick should try to use for
rendering text. If the family can be found it is used; if not, a default font
href="command-line-options.html#style">-style</a>, and <a href="command-line-options.html#weight">-weight</a>. </p>
<div style="margin: auto;">
- <h4><a id="features"></a>-features <em class="arg">distance</em></h4>
+ <h3><a class="anchor" id="features"></a>-features <var>distance</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>display (cooccurrence matrix) texture measure features for each channel in the image in each of four directions (horizontal, vertical, left and right diagonals) for the specified distance.</td><td style='text-align:right;'>[<a href="identify.html">identify</a>]</td></tr></table>
-
-<pre class="text">
- Angular Second Moment
- Contrast
- Correlation
- Sum of Squares Variance
- Inverse Difference Moment
- Sum Average
- Sum Variance
- Sum Entropy
- Entropy
- Difference Variance
- Difference Entropy
- Information Measure of Correlation 1
- Information Measure of Correlation 2
- Maximum Correlation Coefficient
-</pre>
+<p class="magick-description">display (co-occurrence matrix) texture measure features for each channel in the image in each of four directions (horizontal, vertical, left and right diagonals) for the specified distance.</p>
+<pre class="highlight"><code>Angular Second Moment Sum Entropy
+Contrast Entropy
+Correlation Difference Variance
+Sum of Squares Variance Difference Entropy
+Inverse Difference Moment Information Measure of Correlation 1
+Sum Average Information Measure of Correlation 2
+Sum Variance Maximum Correlation Coefficient
+</code></pre>
<div style="margin: auto;">
- <h4><a id="fft"></a>-fft</h4>
+ <h3><a class="anchor" id="fft"></a>-fft</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>implements the forward discrete Fourier transform (DFT).</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">implements the forward discrete Fourier transform (DFT).</p>
<p>This option is new as of ImageMagick 6.5.4-3 (and now working for Windows
users in ImageMagick 6.6.0-9). It transforms an image from the normal
PFM, EXR and PNG are the recommended image formats to use. All of these
formats, except PNG support multi-frame images. So for example,</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert image.png -fft fft_image.miff</span></p>
+<pre class="highlight"><code>convert image.png -fft fft_image.miff
+</code></pre>
+
<p>generates a magnitude image as <code>fft_image.miff[0]</code> and a phase
image as <code>fft_image.miff[1]</code>. Similarly,</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert image.png -fft fft_image.png</span></p>
+<pre class="highlight"><code>convert image.png -fft fft_image.png
+</code></pre>
+
<p>generates a magnitude image as <code>fft_image-0.png</code> and a phase image
as <code>fft_image-1.png</code>. If you prefer this representation, then you can
force any of the other formats to produce two output images by including <a
href="command-line-options.html#virtual-pixel">-virtual-pixel</a> setting.</p>
<p>Both output components will have dynamic ranges that fit within
-[0, <em class="QR">QuantumRange</em>], so that HDRI need not be enabled.
+[0, <var>QuantumRange</var>], so that HDRI need not be enabled.
Phase values nominally range from 0 to 2*π, but is scaled to span the full
dynamic range. (The first few releases had non-HDRI scaled but HDRI not
scaled). The magnitude image is not scaled and thus generally will contain
enhance the darker values more in comparison to the lighter values. This can
be done, for example, as follows:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert fft_image.miff[0] -contrast-stretch 0 \ <br />
- -evaluate log 1000 fft_image_spectrum.png</span></p>
+<pre class="highlight"><code>convert fft_image.miff[0] -contrast-stretch 0 \
+ -evaluate log 1000 fft_image_spectrum.png"
+</code></pre>
+
<p>where either <a href="command-line-options.html#contrast-stretch">-contrast-stretch</a> 0 or <a
href="command-line-options.html#auto-level">-auto-level</a> is used to scale the image to full dynamic
range, first. The argument to the <a href="command-line-options.html#evaluate">-evaluate</a> log
use either MIFF, TIF, PFM or MPC formats for the real and imaginary component
results, since they are formats that preserve both negative and fractional
values without clipping them or truncating the fractional part. With either
-MIFF or TIF, one should add -define quantum:format=32, to allow those image
+MIFF or TIF, one should add <code>-define quantum:format=32</code>, to allow those image
types to work properly in HDRI mode without clipping.</p>
<p>The real and imaginary component images resulting from <a
<p>See the discussion on HDRI implementations of ImageMagick on the page <a
href="high-dynamic-range.html" >High Dynamic-Range Images</a>. For more
about HDRI go the ImageMagick <a
-href="http://www.imagemagick.org/Usage/basics/#hdri" >Usage</a> pages, <a
+href="../Usage/basics/#hdri" >Usage</a> pages, <a
href="http://www.fmwconcepts.com/imagemagick/fourier_transforms/fourier.html"
>Fred's Fourier Processing With ImageMagick page</a> or this <a
href="http://en.wikipedia.org/wiki/High_dynamic_range_imaging" >Wikipedia</a>
entry. </p>
-<p>
-
-<p>By default the FFT is normalized (and the IFT is not). Use "<code><a href="command-line-options.html#define" >-define</a> fourier:normalize=forward</code> to explicityly normalize the FFT and unnormalize the IFT.</p>
+<p>By default the FFT is normalized (and the IFT is not). Use "<code><a href="command-line-options.html#define" >-define</a> fourier:normalize=forward</code> to explicitly normalize the FFT and unnormalize the IFT.</p>
<div style="margin: auto;">
- <h4><a id="fill"></a>-fill <em class="arg">color</em></h4>
+ <h3><a class="anchor" id="fill"></a>-fill <var>color</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>color to use when filling a graphic primitive.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">color to use when filling a graphic primitive.</p>
<p>This option accepts a color name, a hex color, or a numerical RGB, RGBA,
HSL, HSLA, CMYK, or CMYKA specification. See <a href="color.html" >Color Names</a> for
<p>For example,</p>
-<p class="crtsnip">
- -fill blue
-</p>
-<p class="crtsnip">
- -fill "#ddddff"
-</p>
-<p class="crtsnip">
- -fill "rgb(255,255,255)"
-</p>
+<pre class="highlight"><code>-fill blue
+-fill "#ddddff"
+-fill "rgb(255,255,255)"
+</code></pre>
<p>See <a href="command-line-options.html#draw">-draw</a> for further details.</p>
<p>To print a complete list of color names, use the <a href="command-line-options.html#list">-list color</a> option.</p>
<div style="margin: auto;">
- <h4><a id="filter"></a>-filter <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="filter"></a>-filter <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Use this <em class="arg">type</em> of filter when resizing or
-distorting an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Use this <var>type</var> of filter when resizing or distorting an image.</p>
<p>Use this option to affect the resizing operation of an image during
operations such as <a href="command-line-options.html#resize">-resize</a> and <a href="command-line-options.html#distort"
>-distort</a>. For example you can use a simple resize filter such as:</p>
-<pre class="text">
- Point Hermite Cubic
- Box Gaussian Catrom
- Triangle Quadratic Mitchell
-</pre>
+<pre class="highlight"><code>Point Hermite Cubic
+Box Gaussian Catrom
+Triangle Quadratic Mitchell
+CubicSpline
+</code></pre>
+
+<p>Use <code>-define filter:lobes={2,3,4}</code> to specify the support size for filtering for the <code>CubicSpline</code> filter.</p>
<p>The <code>Bessel</code> and <code>Sinc</code> filter is also provided (as well
as a faster <code>SincFast</code> equivalent form). However these filters are
using these functions will define a 'Windowed' filter, appropriate to the
operator involved. Windowed filters include: </p>
-<pre class="text">
- Lanczos Hamming Parzen
- Blackman Kaiser Welsh
- Hanning Bartlett Bohman
-</pre>
+<pre class="highlight"><code>Lanczos Hamming Parzen
+Blackman Kaiser Welsh
+Hanning Bartlett Bohman
+</code></pre>
<p>Also one special self-windowing filter is also provided
<code>Lagrange</code>, which will automagically re-adjust its function depending
use of these expert settings (see also <a href="command-line-options.html#define" >-define</a> and <a
href="command-line-options.html#set" >-set</a>):-</p>
-<dl class="doc">
-<dt>-define filter:blur=<em>factor</em></dt>
-<dd>Scale the X axis of the filter (and its window). Use > 1.0 for
+<table class="table table-sm table-striped">
+ <tr>
+ <td>-define filter:blur=<var>factor</var></td>
+ <td>Scale the X axis of the filter (and its window). Use > 1.0 for
blurry or < 1.0 for sharp. This should only be used with Gaussian and
Gaussian-like filters simple filters, or you may not get the expected
- results. </dd>
+ results. </td>
+ </tr>
-<dt>-define filter:support=<em>radius</em></dt>
-<dd>Set the filter support radius. Defines how large the filter should be and
+ <tr>
+ <td>-define filter:support=<var>radius</var></td>
+ <td>Set the filter support radius. Defines how large the filter should be and
thus directly defines how slow the filtered resampling process is. All
- filters have a default 'prefered' support size. Some filters like
+ filters have a default 'preferred' support size. Some filters like
<code>Lagrange</code> and windowed filters adjust themselves depending on
this value. With simple filters this value either does nothing (but slow
the resampling), or will clip the filter function in a detrimental way.
- </dd>
+ </td>
+ </tr>
-<dt>-define filter:lobes=<em>count</em></dt>
-<dd>Set the number of lobes to use for the Sinc/Bessel filter. This an
+ <tr>
+ <td>-define filter:lobes=<var>count</var></td>
+ <td>Set the number of lobes to use for the Sinc/Bessel filter. This an
alternative way of specifying the 'support' range of the filter, that is
designed to be more suited to windowed filters, especially when used for
- image distorts.</dd>
+ image distorts.</td>
+ </tr>
-<dt>-define filter:sigma=<em>value</em></dt>
-<dd>The 'sigma' value used to define the <code>Gaussian</code> filter. Default
- sigma value is '<code>0.5</code>'. It only effects <code>Gaussian</code> but
+ <tr>
+ <td>-define filter:sigma=<var>value</var></td>
+ <td>The 'sigma' value used to define the <code>Gaussian</code> filter. Default
+ sigma value is '<code>0.5</code>'. It only affects <code>Gaussian</code> but
does not shrink (but may enlarge) the filter's 'support'. It can be used
to generate very small blurs but without the filter 'missing' pixels due
to using a small support setting. A larger value of '<code>0.707</code>'
- (a value of '1/sqrt(2)') is another common setting. </dd>
+ (a value of '1/sqrt(2)') is another common setting. </td>
+ </tr>
+
+ <tr>
+ <td>-define filter:b=<var>b-spline_factor</var></td>
+ </tr>
-<dt>-define filter:b=<em>b-spline_factor</em></dt>
-<dt>-define filter:c=<em>keys_alpha_factor</em></dt>
-<dd>Redefine the values used for cubic filters such as <code>Cubic</code>,
+ <tr>
+ <td>-define filter:c=<var>keys_alpha_factor</var></td>
+ <td>Redefine the values used for cubic filters such as <code>Cubic</code>,
<code>Catrom</code>, <code>Mitchel</code>, and <code>Hermite</code>, as well as
the <code>Parzen</code> cubic windowing function. If only one of the values
are defined, the other is set so as to generate a 'Cubic-Keys' filter.
The values meaning was defined by a research paper by
- Mitchell-Netravali.</dd>
-
-<dt>-define filter:kaiser-beta=<em>value</em></dt>
-<dd>The 'alpha' value used to as part of the Kaiser Windowing function.
- Default value is '6.5'. It only effects Kaiser windowing function, and
- does not effect any other attributes.</dd>
+ Mitchell-Netravali.</td>
+ </tr>
-<dd>Before IM v6.7.6-10, this option was known as "filter:alpha", (an
+ <tr>
+ <td>-define filter:kaiser-beta=<var>value</var></td>
+ <td>The 'alpha' value used to as part of the Kaiser Windowing function.
+ Default value is '6.5'. It only affects Kaiser windowing function, and
+ does not affect any other attributes.
+ Before ImageMagick v6.7.6-10, this option was known as "filter:alpha", (an
inheritance from the very old "zoom" program). It was changed to bring the
function in line with more modern academic research usage, and better
- assign it be more definitive. </dd>
+ assign it be more definitive. </td>
+ </tr>
-<dt>-define filter:kaiser-alpha=<em>value</em></dt>
-<dd>This value when multiplied by 'PI' is equivalent to "kaiser-beta", and
- will override that setting. It only effects Kaiser windowing function,
- and does not effect any other attributes. </dd>
+ <tr>
+ <td>-define filter:kaiser-alpha=<var>value</var></td>
+ <td>This value when multiplied by 'PI' is equivalent to "kaiser-beta", and
+ will override that setting. It only affects Kaiser windowing function,
+ and does not affect any other attributes. </td>
+ </tr>
-<dt>-define filter:filter=<em>filter_function</em></dt>
-<dd>Use this function directly as the weighting filter. This will allow
+ <tr>
+ <td>-define filter:filter=<var>filter_function</var></td>
+ <td>Use this function directly as the weighting filter. This will allow
you to directly use a windowing function such as <code>Blackman</code>,
as a resampling filter, rather than as its normal usage as a windowing
- function. </dd>
-
-<dd>If defined, no windowing function also defined, the window function is set
+ function. If defined, no windowing function also defined, the window function is set
to <code>Box</code>). Directly specifying <code>Sinc</code> or <code>Jinc</code>
- as a filter will also do this. </dd>
+ as a filter will also do this. </td>
+ </tr>
-<dt>-define filter:window=<em>filter_function</em></dt>
-<dd>The IIR (infinite impulse response) filters <code>Sinc</code> and
+ <tr>
+ <td>-define filter:window=<var>filter_function</var></td>
+ <td>The IIR (infinite impulse response) filters <code>Sinc</code> and
<code>Jinc</code> are windowed (brought down to zero over the defined
support range) with the given filter. This allows you to specify a filter
- function to be used as a windowing function for these IIR filters. </dd>
-
-<dd>Many of the defined filters are actually windowing functions for these IIR
+ function to be used as a windowing function for these IIR filters.
+ Many of the defined filters are actually windowing functions for these IIR
filters. A typical choices is <code>Box</code>, (which effectively turns
- off the windowing function). </dd>
+ off the windowing function). </td>
+ </tr>
-<dt>-define filter:win-support=<em>radius</em></dt>
-<dd>Scale windowing function to this size instead. This causes the windowing
+ <tr>
+ <td>-define filter:win-support=<var>radius</var></td>
+ <td>Scale windowing function to this size instead. This causes the windowing
(or self-windowing Lagrange filter) to act is if the support window is
larger than what is actually supplied to the calling operator. The filter
however is still clipped to the real support size given. If unset this
- will equal the normal filter support size. </dd>
+ will equal the normal filter support size. </td>
+ </tr>
-<dt>-define filter:verbose=<em>1</em></dt>
-<dd>This causes IM to print information on the final internal filter
+ <tr>
+ <td>-define filter:verbose=<var>1</var></td>
+ <td>This causes IM to print information on the final internal filter
selection to standard output. This includes a commented header on the
filter settings being used, and data allowing the filter weights to be
- easily graphed. </dd>
-
-<dd>Note however that some filters are internally defined in terms of other
- filters. The <code>Lanczos</code> filter for example is defined in terms of
+ easily graphed. Note however that some filters are internally defined in terms of other filters. The <code>Lanczos</code> filter for example is defined in terms of
a <code>SincFast</code> windowed <code>SincFast</code> filter, while
<code>Mitchell</code> is defined as a general <code>Cubic</code> family filter
- with specific 'B' and 'C' settings. </dd>
+ with specific 'B' and 'C' settings. </td>
+ </tr>
-</dl>
+</table>
<p>For example, to get a 8 lobe jinc windowed sinc filter (Genseng filter?):</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert image.png \<br/>
- -filter sinc \<br/>
- -set filter:window=jinc \<br/>
- -set filter:lobes=8 \<br/>
- -resize 150% image.jpg</span></p>
+<pre class="highlight"><code>convert image.png \
+ -filter sinc \
+ -set filter:window=jinc \
+ -set filter:lobes=8 \
+ -resize 150% image.jpg"
+</code></pre>
+
<p>Or a raw un-windowed Sinc filter with 4 lobes:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert image.png \<br/>
- -set filter:filter=sinc \<br/>
- -set filter:lobes=4 \<br/>
- -resize 150% image.jpg</span></p>
+<pre class="highlight"><code>convert image.png \
+ -set filter:filter=sinc \
+ -set filter:lobes=4 \
+ -resize 150% image.jpg"
+</code></pre>
+
<p>To extract the data for a raw windowing function, combine it with
a '<code>Box</code>' filter. For example the '<code>Welch</code> parabolic
windowing function. </p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert null: -define filter:filter=Box \<br/>
- -define filter:window=Welch \<br/>
- -define filter:support=1.0 \<br/>
- -define filter:verbose=1 \<br/>
- -resize 2 null: > window_welch.dat<br/>
- gnuplot<br/>
- set grid<br/>
- plot "window_welch.dat" with lines</span></p>
+<pre class="highlight"><code>convert null: -define filter:filter=Box \
+ -define filter:window=Welch \
+ -define filter:support=1.0 \
+ -define filter:verbose=1 \
+ -resize 2 null: > window_welch.dat
+gnuplot
+ set grid
+ plot \"window_welch.dat\" with lines
+</code></pre>
+
<p>Note that the use of expert options is provided for image processing experts
who have studied and understand how resize filters work. Without this
knowledge, and an understanding of the definition of the actual filters
<div style="margin: auto;">
- <h4><a id="flatten"></a>-flatten</h4>
+ <h3><a class="anchor" id="flatten"></a>-flatten</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>This is a simple alias for the <a href="command-line-options.html#layers" >-layers</a> method "flatten".</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">This is a simple alias for the <a href="command-line-options.html#layers" >-layers</a> method "flatten".</p>
<div style="margin: auto;">
- <h4><a id="flip"></a>-flip</h4>
+ <h3><a class="anchor" id="flip"></a>-flip</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>create a <em>mirror image</em>.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">create a <var>mirror image</var></p>
<p>reflect the scanlines in the vertical direction. The image will be mirrored
upside-down. </p>
<div style="margin: auto;">
- <h4><a id="floodfill"></a>-floodfill {<em class="arg">+-</em>}<em class="arg">x</em>{<em class="arg">+-</em>}<em class="arg">y</em> <em class="arg">color</em></h4>
+ <h3><a class="anchor" id="floodfill"></a>-floodfill {<var>+-</var>}<var>x</var>{<var>+-</var>}<var>y</var> <var>color</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>floodfill the image with color at the specified offset.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">floodfill the image with color at the specified offset.</p>
-<p>Flood fill starts from the given 'seed point' which is not gravity effected.
+<p>Flood fill starts from the given 'seed point' which is not gravity affected.
Any color that matches within <a href="command-line-options.html#fuzz" >-fuzz</a> color distance of the
-given <em class="arg">color</em> argument, connected to that 'seed point'
+given <var>color</var> argument, connected to that 'seed point'
will be replaced with the current <a href="command-line-options.html#fill" >-fill</a> color. </p>
<p>Note that if the pixel at the 'seed point' does not itself match the given
-<em class="arg">color</em> (according to <a href="command-line-options.html#fuzz" >-fuzz</a>), then no
+<var>color</var> (according to <a href="command-line-options.html#fuzz" >-fuzz</a>), then no
action will be taken. </p>
<p>This operator works more like the <a href="command-line-options.html#opaque" >-opaque</a> option, than
<div style="margin: auto;">
- <h4><a id="flop"></a>-flop</h4>
+ <h3><a class="anchor" id="flop"></a>-flop</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>create a <em>mirror image</em>.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">create a <var>mirror image</var>.</p>
<p>Reflect the scanlines in the horizontal direction, just like the image in
a vertical mirror. </p>
<div style="margin: auto;">
- <h4><a id="font"></a>-font <em class="arg">name</em></h4>
+ <h3><a class="anchor" id="font"></a>-font <var>name</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>set the font to use when annotating images with text, or creating labels.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">set the font to use when annotating images with text, or creating labels.</p>
<p>To print a complete list of fonts, use the <a href="command-line-options.html#list">-list font</a>
option (for versions prior to 6.3.6, use 'type' instead of 'font').</p>
<div style="margin: auto;">
- <h4><a id="foreground"></a>-foreground <em class="arg">color</em></h4>
+ <h3><a class="anchor" id="foreground"></a>-foreground <var>color</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Define the foreground color for menus.</td><td style='text-align:right;'>[<a href="display.html">display</a>]</td></tr></table>
+<p class="magick-description">Define the foreground color for menus.", "display</p>
<p>The color is specified using the format described under the <a
href="command-line-options.html#fill">-fill</a> option.</p>
<p>The default foreground color is black.</p>
<div style="margin: auto;">
- <h4><a id="format"></a>-format <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="format"></a>-format <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>the image format type.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">the image format type.</p>
<p>When used with the <code>mogrify</code> utility, this option converts any
image to the image <a href="formats.html">format</a> you specify.
<p>By default the file is written to its original name. However, if the
filename extension matches a supported format, the extension is replaced with
the image format type specified with <a href="command-line-options.html#format">-format</a>. For
-example, if you specify <em class="arg">tiff</em> as the format type and the
-input image filename is <em class="arg">image.gif</em>, the output image
-filename becomes <em class="arg">image.tiff</em>.</p>
+example, if you specify <var>tiff</var> as the format type and the
+input image filename is <var>image.gif</var>, the output image
+filename becomes <var>image.tiff</var>.</p>
<div style="margin: auto;">
- <h4><a id="format_identify_"></a>-format <em class="arg">string</em></h4>
+ <h3><a class="anchor" id="format_identify_"></a>-format <var>string</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>output formatted image characteristics.</td><td style='text-align:right;'>[<a href="identify.html">identify</a>]</td></tr></table>
+<p class="magick-description">output formatted image characteristics.</p>
<p>See <a href="escape.html">Format and Print Image
Properties</a> for an explanation on how to specify the argument to this
option.</p>
<div style="margin: auto;">
- <h4><a id="frame"></a>-frame <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="frame"></a>-frame <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Surround the image with a border or beveled frame.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Surround the image with a border or beveled frame.</p>
<p>The color of the border is specified with the <a href="command-line-options.html#mattecolor"
>-mattecolor</a> command line option. </p>
-<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. The <em class="arg">size</em> portion of the <em
-class="arg">geometry</em> argument indicates the amount of extra width and
+<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. The <var>size</var> portion of the <var>geometry</var> argument indicates the amount of extra width and
height that is added to the dimensions of the image. If no offsets are given
-in the <em class="arg">geometry</em> argument, then the border added is
-a solid color. Offsets <em>x</em> and <em>y</em>, if present, specify that
+in the <var>geometry</var> argument, then the border added is
+a solid color. Offsets <var>x</var> and <var>y</var>, if present, specify that
the width and height of the border is partitioned to form an outer bevel of
-thickness <em>x</em> pixels and an inner bevel of thickness
-<em>y</em> pixels. Negative offsets make no sense as frame arguments.
+thickness <var>x</var> pixels and an inner bevel of thickness
+<var>y</var> pixels. Negative offsets make no sense as frame arguments.
</p>
<p>The <a href="command-line-options.html#frame">-frame</a> option is affected by the current <a
<div style="margin: auto;">
- <h4><a id="frame_import_"></a>-frame</h4>
+ <h3><a class="anchor" id="frame_import_"></a>-frame</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>include the X window frame in the imported image.</td><td style='text-align:right;'>[<a href="import.html">import</a>]</td></tr></table>
-
+<p class="magick-description">include the X window frame in the imported image. </p>
<div style="margin: auto;">
- <h4><a id="function"></a>-function <em class="arg">function</em> <em class="arg">parameters</em></h4>
+ <h3><a class="anchor" id="function"></a>-function <var>function</var> <var>parameters</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Apply a function to channel values.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Apply a function to channel values.</p>
<p>This operator performs calculations based on the given arguments to modify
each of the color values for each previously set <a
href="command-line-options.html#evaluate">-evaluate</a> operator. (Added in
ImageMagick 6.4.8−8.)</p>
-<p>Here, <em class="arg">parameters</em> is a comma-separated list of
-numerical values. The number of values varies depending on which <em
-class="arg">function</em> is selected. Choose the <em
-class="arg">function</em> from:</p>
+<p>Here, <var>parameters</var> is a comma-separated list of
+numerical values. The number of values varies depending on which <var>function</var> is selected. Choose the <var>function</var> from:</p>
-<pre class="text">
- Polynomial
- Sinusoid
- Arcsin
- Arctan
-</pre>
+<pre class="highlight"><code>Polynomial
+Sinusoid
+Arcsin
+Arctan
+</code></pre>
<p>To print a complete list of <a href="command-line-options.html#function">-function</a> operators,
use <a href="command-line-options.html#list">-list function</a>. Descriptions follow.</p>
-<dl class="doc">
-<dt><code>Polynomial</code></dt>
-<dd>
-
-<p>The <code>Polynomial</code> function takes an arbitrary number of parameters,
+<dl class="row">
+ <dt class="col-md-4">Polynomial</dt>
+ <dd class="col-md-8"><p>The <code>Polynomial</code> function takes an arbitrary number of parameters,
these being the coefficients of a polynomial, in decreasing order of degree.
That is, entering</p>
-<div style="text-align: center">
- -function Polynomial <em>a</em><sub><em>n</em></sub>,<em>a</em><sub><em>n</em>-1</sub>,...<em>a</em><sub>1</sub>,<em>a</em><sub>0</sub>
-</div>
+<pre class="highlight"><code>-function Polynomial <var>a</var><sub><var>n</var></sub>,<var>a</var><sub><var>n</var>-1</sub>,...<var>a</var><sub>1</sub>,<var>a</var><sub>0</sub>
+</code></pre>
<p>will invoke a polynomial function given by</p>
-<div style="text-align: center">
- <em>a</em><sub><em>n</em></sub> <b><em>u</em></b><sup><em>n</em></sup> +
- <em>a</em><sub><em>n</em>-1</sub> <b><em>u</em></b><sup><em>n</em>-1</sup> +
- ··· <em>a</em><sub>1</sub> <b><em>u</em></b> + <em>a</em><sub>0</sub>,
-</div>
+<pre class="highlight"><code><var>a</var><sub><var>n</var></sub> <b><var>u</var></b><sup><var>n</var></sup> + <var>a</var><sub><var>n</var>-1</sub> <b><var>u</var></b><sup><var>n</var>-1</sup> + ··· <var>a</var><sub>1</sub> <b><var>u</var></b> + <var>a</var><sub>0</sub>,
+</code></pre>
-<p>where <b><em>u</em></b> is pixel's original normalized channel value.</p>
+<p>where <b><var>u</var></b> is pixel's original normalized channel value.</p>
<p>The <code>Polynomial</code> function can be used in place of <code>Set</code>
-(the <em>constant</em> polynomial) and <code>Add</code>, <code>Divide</code>,
-<code>Multiply</code>, and <code>Subtract</code> (some <em>linear</em>
+(the <var>constant</var> polynomial) and <code>Add</code>, <code>Divide</code>,
+<code>Multiply</code>, and <code>Subtract</code> (some <var>linear</var>
polynomials) of the <a href="command-line-options.html#evaluate">-evaluate</a> operator. The <a
href="command-line-options.html#level">-level</a> operator also affects channels linearly. Some
correspondences follow.</p>
-<table class="doc">
- <col width="35%" />
- <col width="35%" />
- <col width="30%" />
+<table class="table table-sm table-striped">
<tr>
- <td>-evaluate Set <em class="arg">value</em> </td>
- <td>-function Polynomial <em class="arg">value</em></td>
- <td>(Constant functions; set <em class="arg">value</em>×100% gray when channels are RGB.)</td>
+ <td>-evaluate Set <var>value</var> </td>
+ <td>-function Polynomial <var>value</var></td>
+ <td>(Constant functions; set <var>value</var>×100% gray when channels are RGB.)</td>
</tr>
<tr>
- <td>-evaluate Add <em class="arg">value</em> </td>
- <td>-function Polynomial 1,<em class="arg">value</em></td>
+ <td>-evaluate Add <var>value</var> </td>
+ <td>-function Polynomial 1,<var>value</var></td>
</tr>
<tr>
- <td>-evaluate Subtract <em class="arg">value</em> </td>
- <td>-function Polynomial 1,−<em class="arg">value</em></td>
+ <td>-evaluate Subtract <var>value</var> </td>
+ <td>-function Polynomial 1,−<var>value</var></td>
</tr>
<tr>
- <td>-evaluate Multiply <em class="arg">value</em> </td>
- <td>-function Polynomial <em class="arg">value</em>,0</td>
+ <td>-evaluate Multiply <var>value</var> </td>
+ <td>-function Polynomial <var>value</var>,0</td>
</tr>
<tr>
<td>+level black% x white%</td>
desired.</p>
</dd>
-
-<dt><code>Sinusoid</code></dt>
-<dd>
+<dt class="col-md-4">Sinusoid</dt>
+<dd class="col-md-8">
<p>The <code>Sinusoid</code> function can be used to vary the channel values
sinusoidally by setting frequency, phase shift, amplitude, and a bias. These
values are given as one to four parameters, as follows,</p>
-<div style="text-align: center">
- -function <code>Sinusoid</code> <em class="arg">freq</em>,[<em class="arg">phase</em>,[<em class="arg">amp</em>,[<em class="arg">bias</em>]]]
-</div>
+<pre class="highlight"><code>-function <code>Sinusoid</code> <var>freq</var>,[<var>phase</var>,[<var>amp</var>,[<var>bias</var>]]]
+</code></pre>
-<p>where <em>phase</em> is in degrees. (The domain [0,1] of the function
-corresponds to 0 through <em class="arg">freq</em>×360 degrees.)
+<p>where <var>phase</var> is in degrees. (The domain [0,1] of the function
+corresponds to 0 through <var>freq</var>×360 degrees.)
The result is that if a pixel's normalized channel value is originally
-<b><em>u</em></b>, its resulting normalized value is given by </p>
+<b><var>u</var></b>, its resulting normalized value is given by </p>
-<div style="text-align: center">
-<em class="arg">amp</em> * sin(2*π* (<em class="arg">freq</em> * <b><em>u</em></b> + <em class="arg">phase</em> / 360)) + <em class="arg">bias</em>
-</div>
+<pre class="highlight"><code><var>amp</var> * sin(2*π* (<var>freq</var> * <b><var>u</var></b> + <var>phase</var> / 360)) + <var>bias</var>
+</code></pre>
<p> For example, the following generates a curve that starts and ends at 0.9
-(when <b><em>u</em></b>=0 and 1, resp.), oscillating three times between
+(when <b><var>u</var></b>=0 and 1, resp.), oscillating three times between
.7−.2=.5 and .7+.2=.9. </p>
-<p class="crtsnip">
- -function Sinusoid 3,-90,.2,.7
-</p>
+<pre class="highlight"><code>-function Sinusoid 3,-90,.2,.7
+</code></pre>
-<p>The default values of <em class="arg">amp</em> and <em
-class="arg">bias</em> are both .5. The default for <em class="arg">phase</em>
+<p>The default values of <var>amp</var> and <var>bias</var> are both .5. The default for <var>phase</var>
is 0.</p>
<p>The <code>Sinusoid</code> function generalizes <code>Sin</code> and
<code>Cos</code> of the <a href="command-line-options.html#evaluate">-evaluate</a> operator by allowing
varying amplitude, phase and bias. The correspondence is as follows.</p>
-<table class="doc">
+<table class="table table-sm table-striped">
<tr>
- <td>-evaluate Sin <em class="arg">freq</em> </td>
- <td>-function Sinusoid <em class="arg">freq</em>,0 </td>
+ <td>-evaluate Sin <var>freq</var> </td>
+ <td>-function Sinusoid <var>freq</var>,0 </td>
</tr>
<tr>
- <td>-evaluate Cos <em class="arg">freq</em> </td>
- <td>-function Sinusoid <em class="arg">freq</em>,90 </td>
+ <td>-evaluate Cos <var>freq</var> </td>
+ <td>-function Sinusoid <var>freq</var>,90 </td>
</tr>
</table>
-</dd>
-
-<dt><code>ArcSin</code></dt>
-<dd>
+ </dd>
+<dt class="col-md-4">ArcSin</dt>
+<dd class="col-md-8">
<p>The <code>ArcSin</code> function generates the inverse curve of a Sinusoid,
and can be used to generate cylindrical distortion and displacement maps.
The curve can be adjusted relative to both the input values and output range
of values.</p>
-<p style="text-align: center">
- -function <code>ArcSin</code> <em class="arg">width</em>,[<em class="arg">center</em>,[<em class="arg">range</em>,[<em class="arg">bias</em>]]]
-</p>
+<pre class="highlight"><code>-function <code>ArcSin</code> <var>width</var>,[<var>center</var>,[<var>range</var>,[<var>bias</var>]]]
+</code></pre>
<p>with all values given in terms of normalized color values (0.0 for black,
1.0 for white). Defaulting to values covering the full range from 0.0 to 1.0
-for bout input (<em class="arg">width</em>), and output (<em
-class="arg">width</em>) values. '<code>1.0,0.5,1.0,0.5</code>' </p>
+for bout input (<var>width</var>), and output (<var>width</var>) values. '<code>1.0,0.5,1.0,0.5</code>' </p>
-<p style="text-align: center">
-<em class="arg">range</em>/π * asin( 2/<em class="arg">width</em> * ( <b><em>u</em></b> - <em class="arg">center</em> ) ) + <em class="arg">bias</em>
-</p>
+<pre class="highlight"><code><var>range</var>/π * asin( 2/<var>width</var> * ( <b><var>u</var></b> - <var>center</var> ) ) + <var>bias</var>
+</code></pre>
</dd>
-
-<dt><code>ArcTan</code></dt>
-<dd>
+<dt class="col-md-4">ArcTan</dt>
+<dd class="col-md-8">
<p>The <code>ArcTan</code> function generates a curve that smooth crosses from
limit values at infinities, though a center using the given slope value.
All these values can be adjusted via the arguments.</p>
-<p style="text-align: center">
- -function <code>ArcTan</code> <em class="arg">slope</em>,[<em class="arg">center</em>,[<em class="arg">range</em>,[<em class="arg">bias</em>]]]
-</p>
+<pre class="highlight"><code>-function <code>ArcTan</code> <var>slope</var>,[<var>center</var>,[<var>range</var>,[<var>bias</var>]]]
+</code></pre>
<p>Defaulting to '<code>1.0,0.5,1.0,0.5</code>'.
</p>
-<p style="text-align: center">
-<em class="arg">range</em>/π * atan( <em class="arg">slope</em>*π * ( <b><em>u</em></b> - <em class="arg">center</em> ) ) + <em class="arg">bias</em>
-</p>
-
-</dd>
-
+<pre class="highlight"><code><var>range</var>/π * atan( <var>slope</var>*π * ( <b><var>u</var></b> - <var>center</var> ) ) + <var>bias</var>
+</code></pre>
+ </dd>
</dl>
+
<div style="margin: auto;">
- <h4><a id="fuzz"></a>-fuzz <em class="arg">distance</em>{<em class="arg">%</em>}</h4>
+ <h3><a class="anchor" id="fuzz"></a>-fuzz <var>distance</var>{<var>%</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Colors within this <em class="arg">distance</em> are considered equal.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Colors within this <var>distance</var> are considered equal.</p>
<p>A number of algorithms search for a target color. By default the color must
be exact. Use this option to match colors that are close to the target color
background color may differ by a small amount. This option can account for
these differences.</p>
-<p>The <em class="arg">distance</em> can be in absolute intensity units or, by
+<p>The <var>distance</var> can be in absolute intensity units or, by
appending <code>%</code> as a percentage of the maximum possible intensity (255,
65535, or 4294967295).</p>
+<p>Use <a href="command-line-options.html#fuzz" >+fuzz</a> to reset the fuzz value to 0.</p>
+
<div style="margin: auto;">
- <h4><a id="fx"></a>-fx <em class="arg">expression</em></h4>
+ <h3><a class="anchor" id="fx"></a>-fx <var>expression</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>apply a mathematical expression to an image or image channels.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">apply a mathematical expression to an image or image channels.</p>
-<p>If the first character of <em class="arg">expression</em> is <code>@</code>,
+<p>If the first character of <var>expression</var> is <code>@</code>,
the expression is read from a file titled by the remaining characters in the
string.</p>
<div style="margin: auto;">
- <h4><a id="gamma"></a>-gamma <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="gamma"></a>-gamma <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>level of gamma correction.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">level of gamma correction.</p>
<p>The same color image displayed on two different workstations may look
different due to differences in the display monitor. Use gamma correction to
normalized or 0 to 1 color value. For example, using a value of gamma=2 is the
same as taking the square root of the image.</p>
-<p>You can apply separate gamma values to the red, green, and blue channels of
-the image with a gamma value list delimited with commas (e.g.,
-<code>1.7,2.3,1.2</code>).</p>
-
-<p>Use <a href="command-line-options.html#gamma">+gamma <em class="arg">value</em></a> to set the
+<p>Use <a href="command-line-options.html#gamma">+gamma <var>value</var></a> to set the
image gamma level without actually adjusting the image pixels. This option
is useful if the image is of a known gamma but not set as an image attribute
(e.g. PNG images). Write the "file gamma" which is the reciprocal of the
display gamma; e.g., if your image is sRGB and you want to write a PNG gAMA
chunk, use</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert input.png +gamma .45455 output.png</span></p><p>(0.45455 is 1/2.2)</p>
+
+<pre class="highlight"><code>convert input.png +gamma .45455 output.png
+</code></pre>
+
+<p>(0.45455 is 1/2.2)</p>
<p>Note that gamma adjustments are also available via the <a href="command-line-options.html#level">-level</a> operator.</p>
<div style="margin: auto;">
- <h4><a id="gaussian-blur"></a>-gaussian-blur <em class="arg">radius</em><br />-gaussian-blur <em class="arg">radius</em>x<em class="arg">sigma</em></h4>
+ <h3><a class="anchor" id="gaussian-blur"></a>-gaussian-blur <var>radius</var><br />-gaussian-blur <var>radius</var>x<var>sigma</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Blur the image with a Gaussian operator.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Blur the image with a Gaussian operator.</p>
<p>Convolve the image with a Gaussian or normal distribution using the given
-<em class="arg" >Sigma</em> value. The formula is:</p>
+<var >Sigma</var> value. The formula is:</p>
-<div class="eqn"><img alt="gaussian distribution" width="243px" height="42px" src="../images/gaussian-blur.png"/>
-</div>
+<p class="text-center"><img class="img-thumbnail" alt="gaussian distribution" width="243px" height="42px" src="../images/gaussian-blur.png"/> </p>
-<p>The <em class="arg" >Sigma</em> value is the important argument, and
+<p>The <var >Sigma</var> value is the important argument, and
determines the actual amount of blurring that will take place. </p>
-<p>The <em class="arg" >Radius</em> is only used to determine the size of the
+<p>The <var >Radius</var> is only used to determine the size of the
array which will hold the calculated Gaussian distribution. It should be an
integer. If not given, or set to zero, IM will calculate the largest possible
radius that will provide meaningful results for the Gaussian distribution.
</p>
-<p>The larger the <em class="arg" >Radius</em> the radius the slower the
-operation is. However too small a <em class="arg" >Radius</em>, and sever
-aliasing effects may result. As a guideline, <em class="arg" >Radius</em>
-should be at least twice the <em class="arg" >Sigma</em> value, though three
+<p>The larger the <var >Radius</var> the radius the slower the
+operation is. However too small a <var >Radius</var>, and severe
+aliasing effects may result. As a guideline, <var >Radius</var>
+should be at least twice the <var >Sigma</var> value, though three
times will produce a more accurate result. </p>
<p>This differs from the faster <a href="command-line-options.html#blur">-blur</a> operator in that a
<div style="margin: auto;">
- <h4><a id="geometry"></a>-geometry <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="geometry"></a>-geometry <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the preferred size and location of the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set the preferred size and location of the image.</p>
<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
<div style="margin: auto;">
- <h4><a id="gravity"></a>-gravity <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="gravity"></a>-gravity <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Sets the current gravity suggestion for various other settings and options.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Sets the current gravity suggestion for various other settings and options.</p>
<p>Choices include: <code>NorthWest</code>, <code>North</code>,
<code>NorthEast</code>, <code>West</code>, <code>Center</code>, <code>East</code>,
<p>The direction you choose specifies where to position text or subimages. For
example, a gravity of <code>Center</code> forces the text to be centered within
-the image. By default, the image gravity is <code>NorthWest</code>. See <a
+the image. By default, the image gravity is <code>undefined</code>. See <a
href="command-line-options.html#draw">-draw</a> for more details about graphic primitives. Only the
text primitive of <a href="command-line-options.html#draw">-draw</a> is affected by the <a
href="command-line-options.html#gravity">-gravity</a> option.</p>
<p>The <a href="command-line-options.html#gravity">-gravity</a> option is also used in concert with the
<a href="command-line-options.html#geometry">-geometry</a> setting and other settings or options that
-take <em class="arg">geometry</em> as an argument, such as the <a
+take <var>geometry</var> as an argument, such as the <a
href="command-line-options.html#crop">-crop</a> option. </p>
<p>If a <a href="command-line-options.html#gravity">-gravity</a> setting occurs before another option
-or setting having a <em class="arg">geometry</em> argument that specifies an
+or setting having a <var>geometry</var> argument that specifies an
offset, the offset is usually applied to the point within the image suggested
by the <a href="command-line-options.html#gravity">-gravity</a> argument. Thus, in the following
command, for example, suppose the file <code>image.png</code> has dimensions
(100,50). The offset (−40,20) is applied to that point, giving
(100−40,50+20)=(60,70), so the specified 10x10 region is located at
that point. (In addition, the <a href="command-line-options.html#gravity">-gravity</a> affects the
-region itself, which is <em>centered</em> at the pixel
+region itself, which is <var>centered</var> at the pixel
coordinate (60,70). (See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.)</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert image.png -gravity Center -region 10x10-40+20 \ <br/> -negate output.png</span></p>
+<pre class="highlight"><code>convert image.png -gravity Center -region 10x10-40+20 \
+ -negate output.png
+</code></pre>
+
<p>When used as an option to <a href="composite.html">composite</a>, <a
href="command-line-options.html#gravity">-gravity</a> gives the direction that the image gravitates
within the composite.</p>
href="command-line-options.html#gravity">-gravity</a> gives the direction that an image gravitates
within a tile. The default gravity is <code>Center</code> for this purpose.</p>
+<p>Use <a href="command-line-options.html#gravity">+gravity</a> to return gravity to its default value.</p>
+
<div style="margin: auto;">
- <h4><a id="grayscale"></a>-grayscale <em class="arg">method</em></h4>
+ <h3><a class="anchor" id="grayscale"></a>-grayscale <var>method</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>convert image to grayscale.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">convert image to grayscale.</p>
<p>This will use one of the <a href="command-line-options.html#intensity" >-intensity</a> methods to
-convert the given image into a linear-grayscale image. </p>
+convert the given image into a grayscale image. </p>
<p>For example, to convert an image to (linear) Rec709Luminance grayscale, type:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert in.png -grayscale Rec709Luminance out.png</span></p>
+<pre class="highlight"><code>convert in.png -grayscale Rec709Luminance out.png
+</code></pre>
+
<p>which is equivalent to:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert in.png -colorspace gray out.png</span></p>
+<pre class="highlight">
+<code>convert in.png -colorspace RGB -colorspace Gray out.png</code>
+or
+<code>convert in.png -colorspace LinearGray out.png</code>
+</pre>
+
+<p>Note that LinearGray is new as of Imagemagick 6.9.9-29 and 7.0.7-17.</p>
+
<p>Similarly, to convert an image to (non-linear) Rec709Luma grayscale, type:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert in.png -grayscale Rec709Luma out.png</span></p>
+<pre class="highlight"><code>convert in.png -grayscale Rec709Luma out.png
+</code></pre>
+
<p>which is equivalent to:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert in.png -set colorspace RGB -colorspace gray out.png</span></p>
+<pre class="highlight"><code>convert in.png -colorspace Gray out.png
+</code></pre>
+
<p>Note that a 'colorspace' intensity method will produce the same result
regardless of the current colorpsace of the image. But a 'mathematical'
-intensity method will depend on the current colorspace the image is currently
+intensity method depends on the current colorspace the image is currently
using. </p>
-<p>While this operation uses an <a href="command-line-options.html#intensity" >-intensity</a> method,
+<p>While this operation uses an <a href="command-line-options.html#intensity" >-intensity</a> method,
it does not use or set the <a href="command-line-options.html#intensity" >-intensity</a> setting, so
-will not effect other operations that may use that setting.</p>
+will not affect other operations that may use that setting.</p>
<div style="margin: auto;">
- <h4><a id="green-primary"></a>-green-primary <em class="arg">x,y</em></h4>
+ <h3><a class="anchor" id="green-primary"></a>-green-primary <var>x,y</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>green chromaticity primary point.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">green chromaticity primary point.</p>
<div style="margin: auto;">
- <h4><a id="hald-clut"></a>-hald-clut</h4>
+ <h3><a class="anchor" id="hald-clut"></a>-hald-clut</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>apply a Hald color lookup table to the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">apply a Hald color lookup table to the image.</p>
<p>A Hald color lookup table is a 3-dimensional color cube mapped to 2
dimensions. Create it with the <code>HALD:</code> prefix (e.g. HALD:8). You
can apply any color transformation to the Hald image and then use this option
to apply the transform to the image. </p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert image.png hald.png -hald-clut transform.png</span></p>
+<pre class="highlight"><code>convert image.png hald.png -hald-clut transform.png
+</code></pre>
+
<p>This option provides a convenient method for you to use Gimp or Photoshop
to make color corrections to the Hald CLUT image and subsequently apply them
to multiple images using an ImageMagick script. </p>
<p>Note that the representation is only of the normal RGB color space and that
the whole color value triplet is used for the interpolated lookup of the
represented Hald color cube image. Because of this the operation is not <a
-href="command-line-options.html#channel" >-channel</a> setting effected, nor can it adjust or modify an
+href="command-line-options.html#channel" >-channel</a> setting affected, nor can it adjust or modify an
images transparency or alpha/matte channel.</p>
<p>See also <a href="command-line-options.html#clut" >-clut</a> which provides color value replacement
-of the individual color channels, usually involving a simpler gray-scale
-image. E.g: gray-scale to color replacement, or modification by a histogram
+of the individual color channels, usually involving a simpler grayscale
+image. E.g: grayscale to color replacement, or modification by a histogram
mapping. </p>
<div style="margin: auto;">
- <h4><a id="help"></a>-help</h4>
+ <h3><a class="anchor" id="help"></a>-help</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>print usage instructions.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">print usage instructions.</p>
<div style="margin: auto;">
- <h4><a id="highlight-color"></a>-highlight-color <em class="arg">color</em></h4>
+ <h3><a class="anchor" id="highlight-color"></a>-highlight-color <var>color</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>when comparing images, emphasize pixel differences with this color.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">when comparing images, emphasize pixel differences with this color.</p>
<div style="margin: auto;">
- <h4><a id="hough-lines"></a>-hough-lines <em class="arg">width</em>x<em class="arg">height</em>{<em class="arg">+threshold</em>}</h4>
+ <h3><a class="anchor" id="hough-lines"></a>-hough-lines <var>width</var>x<var>height</var>{<var>+threshold</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>identify straight lines in the image (e.g. -hough-lines 9x9+195).</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">identify straight lines in the image (e.g. -hough-lines 9x9+195).</p>
<p>Use the Hough line detector with any binary edge extracted image to locate and draw any straight lines that it finds.</p>
-<p>The process accumulates counts for every white pixel in the binary edge image for every possible orientation (for angles from 0 to 179 in 1 deg increments) and distance from the center of the image to the corners (in 1 px increments). It stores the counts in an accumulator matrix of angle vs distance. The size of the accumulator will be 180x(diagonal/2). Next it searches the accumulator for peaks in counts and converts the locations of the peaks to slope and intercept in the normal x,y input image space. The algorithm uses slope/intercepts to find the endpoints clipped to the bounds of the image. The lines are drawn from the given endpoints. The counts are a measure of the length of the lines.</p.
+<p>The process accumulates counts for every white pixel in the binary edge image for every possible orientation (for angles from 0 to 179 in 1 deg increments) and distance from the center of the image to the corners (in 1 px increments). It stores the counts in an accumulator matrix of angle vs distance. The size of the accumulator will be 180x(diagonal/2). Next it searches the accumulator for peaks in counts and converts the locations of the peaks to slope and intercept in the normal x,y input image space. The algorithm uses slope/intercepts to find the endpoints clipped to the bounds of the image. The lines are drawn from the given endpoints. The counts are a measure of the length of the lines.</p>.
-<p>The WxH arguments specify the filter size for locating the peaks in the Hough accumulator. The threshold excludes lines whose counts are less than the threshold value.<p>
+<p>The WxH arguments specify the filter size for locating the peaks in the Hough accumulator. The threshold excludes lines whose counts are less than the threshold value.</p>
<p>Use <code><a href="command-line-options.html#background" >-background</a></code> to specify the color of the background onto which the lines will be drawn. The default is black.</p>
<p>Use <code><a href="command-line-options.html#define" >-define</a> hough-lines:accumulator=true</code> to return the accumulator image in addition to the lines image.</p>
<div style="margin: auto;">
- <h4><a id="iconGeometry"></a>-iconGeometry <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="iconGeometry"></a>-iconGeometry <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>specify the icon geometry.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">specify the icon geometry.</p>
<p>Offsets, if present in the geometry specification, are handled in the same
manner as the <a href="command-line-options.html#geometry">-geometry</a> option, using X11 style to
<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
<div style="margin: auto;">
- <h4><a id="iconic"></a>-iconic</h4>
+ <h3><a class="anchor" id="iconic"></a>-iconic</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>start in icon mode in X Windows</td><td style='text-align:right;'>[<a href="animate.html">animate</a>, <a href="display.html">display</a>]</td></tr></table>
+<p class="magick-description">start in icon mode in X Windows", 'animate', 'display</p>
<div style="margin: auto;">
- <h4><a id="identify"></a>-identify</h4>
+ <h3><a class="anchor" id="identify"></a>-identify</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>identify the format and characteristics of the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">identify the format and characteristics of the image.</p>
<p>This information is printed: image scene number; image name; image size;
-the image class (<em class="arg">DirectClass</em> or <em
-class="arg">PseudoClass</em>); the total number of unique colors; and the
+the image class (<var>DirectClass</var> or <var>PseudoClass</var>); the total number of unique colors; and the
number of seconds to read and transform the image. Refer to <a href="miff.html">MIFF</a> for
a description of the image class.</p>
<p>If <a href="command-line-options.html#colors">-colors</a> is also specified, the total unique colors
in the image and color reduction error values are printed. Refer to <a
-href="quantize.html">color
+href="../www/quantize.html">color
reduction algorithm</a> for a description of these values.</p>
<p>If <a href="command-line-options.html#verbose">-verbose</a> precedes this option, copious
image histogram, and others.</p>
<div style="margin: auto;">
- <h4><a id="ift"></a>-ift</h4>
+ <h3><a class="anchor" id="ift"></a>-ift</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>implements the inverse discrete Fourier transform (DFT).</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">implements the inverse discrete Fourier transform (DFT).</p>
<p>This option is new as of ImageMagick 6.5.4-3 (and now working for Windows
users in ImageMagick 6.6.0-9). It transforms a pair of magnitude and phase
<p>For example, depending upon the image format used to store the result of
the <a href="command-line-options.html#fft">-fft</a>, one would use either</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert fft_image.miff -ift fft_image_ift.png</span></p>
+<pre class="highlight"><code>convert fft_image.miff -ift fft_image_ift.png
+</code></pre>
+
<p>or</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert fft_image-0.png fft_image-1.png -ift fft_image_ift.png</span></p>
+<pre class="highlight"><code>convert fft_image-0.png fft_image-1.png -ift fft_image_ift.png
+</code></pre>
<p>The resulting image may need to be cropped due to padding introduced when
the original image, prior to the <a href="command-line-options.html#fft">-fft</a> or <a
and imaginary images from the frequency domain to a single image in the normal
(spatial) domain.</p>
-<p>By default the IFT is not normalized (and the FFT is). Use "<code><a href="command-line-options.html#define" >-define</a> fourier:normalize=inverse</code> to explictly normalize the IFT and unnormalize the FFT.</p>
+<p>By default the IFT is not normalized (and the FFT is). Use "<code><a href="command-line-options.html#define" >-define</a> fourier:normalize=inverse</code> to explicitly normalize the IFT and unnormalize the FFT.</p>
<div style="margin: auto;">
- <h4><a id="immutable"></a>-immutable</h4>
+ <h3><a class="anchor" id="immutable"></a>-immutable</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>make image immutable.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">make image immutable.</p>
<div style="margin: auto;">
- <h4><a id="implode"></a>-implode <em class="arg">factor</em></h4>
+ <h3><a class="anchor" id="implode"></a>-implode <var>factor</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>implode image pixels about the center.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">implode image pixels about the center.</p>
<div style="margin: auto;">
- <h4><a id="insert"></a>-insert <em class="arg">index</em></h4>
+ <h3><a class="anchor" id="insert"></a>-insert <var>index</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>insert the last image into the image sequence.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">insert the last image into the image sequence.</p>
<p>This option takes last image in the current image sequence and inserts it
at the given index. If a negative index is used, the insert position is
Consequently this has no effect on the image sequence order.</p>
<div style="margin: auto;">
- <h4><a id="intensity"></a>-intensity <em class="arg">method</em></h4>
+ <h3><a class="anchor" id="intensity"></a>-intensity <var>method</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>method to generate intensity value from pixel.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">method to generate intensity value from pixel.</p>
<p>ImageMagick provides a number of methods used in situations where an
-operatory needs to determine a single grayscale value for some purpose, from
-an image with red, green, and blue pixel components. Typically the linear
-<code>Rec709Luminance</code> formula is used, which is the same formula used when
-converting images to <code>-colorspace gray</code>. </p>
+operator needs to determine a single grayscale value for some purpose, from
+an image with red, green, and blue pixel components. Typically the
+<code>Rec709Luma</code> formula is used, which is the same formula used when converting images to <code>-colorspace gray</code>. </p>
<p>The following formulas are currently provided, and will first convert
the pixel values to linear-RGB or non-linear sRGB colorspace before
-being applied to calulate the final greyscale value. </p>
-
-<pre class="text">
- Rec601Luma 0.298839R' + 0.586811G'+ 0.114350B'
- Rec601Luminance 0.298839R + 0.586811G + 0.114350B
- Rec709Luma 0.212656R' + 0.715158G' + 0.072186B'
- Rec709Luminance 0.212656R + 0.715158G + 0.072186B
- Brightness max(R', G', B')
- Lightness (min(R', G', B') + max(R', G', B')) / 2.0
-</pre>
+being applied to calculate the final greyscale value. </p>
+
+<dl class="row">
+<dt class="col-md-4">Rec601Luma</dt><dd class="col-md-8"> 0.298839R' + 0.586811G'+ 0.114350B'</dd>
+<dt class="col-md-4">Rec601Luminance</dt><dd class="col-md-8"> 0.298839R + 0.586811G + 0.114350B</dd>
+<dt class="col-md-4">Rec709Luma</dt><dd class="col-md-8"> 0.212656R' + 0.715158G' + 0.072186B'</dd>
+<dt class="col-md-4">Rec709Luminance</dt><dd class="col-md-8"> 0.212656R + 0.715158G + 0.072186B</dd>
+<dt class="col-md-4">Brightness</dt><dd class="col-md-8"> max(R', G', B')</dd>
+<dt class="col-md-4">Lightness</dt><dd class="col-md-8"> (min(R', G', B') + max(R', G', B')) / 2.0</dd>
+</dl>
+
<p>Note that the above R,G,B values is the image's linear-RGB values, while
R',G',B' are sRGB non-linear values. </p>
current value in the images respective R,G,B channel regardless of
what that is, or what colorspace the image is currently using.</p>
-<pre class="text">
- Average (R + G + B) / 3.0
- MS (R^2 + G^2 + B^2) / 3.0
- RMS sqrt( (R^2 + G^2 + B^2) / 3.0 )
-</pre>
+<dl class="row">
+<dt class="col-md-4">Average</dt><dd class="col-md-8">(R' + G' + B') / 3.0</dd>
+<dt class="col-md-4">MS</dt><dd class="col-md-8">(R'^2 + G'^2 + B'^2) / 3.0</dd>
+<dt class="col-md-4">RMS</dt><dd class="col-md-8">sqrt( (R'^2 + G'^2 + B'^2) / 3.0 )</dd>
+</dl>
<p>These methods are often used for other purposes, such as generating a
grayscale difference image between two color images (using <a href="command-line-options.html#compose"
appropriate sRGB or linear-RGB colorspace before appling the above
function.</p>
-<p>To print a complete list of posible pixel intensity setting methods, use <a href="command-line-options.html#list">-list intensity</a>.</p>
+<p>To print a complete list of possible pixel intensity setting methods, use <a href="command-line-options.html#list">-list intensity</a>.</p>
<p>Operators affected by the <a href="command-line-options.html#intensity" >-intensity</a> setting include:</p>
-<pre class="text">
--adaptive-blur
+<pre class="highlight"><code>-adaptive-blur
-adaptive-sharpen
-black-threshold
-clut (when mapping greyscale CLUT image to alpha channel if set by -channels)
-threshold
-tint
-white-threshold
-</pre>
+</code></pre>
<div style="margin: auto;">
- <h4><a id="intent"></a>-intent <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="intent"></a>-intent <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>use this type of rendering intent when managing the image color.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">use this type of rendering intent when managing the image color.</p>
<p>Use this option to affect the color management operation of an image (see
<a href="command-line-options.html#profile">-profile</a>). Choose from these intents: <code>Absolute,
<p>To print a complete list of rendering intents, use <a href="command-line-options.html#list">-list intent</a>.</p>
<div style="margin: auto;">
- <h4><a id="interlace"></a>-interlace <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="interlace"></a>-interlace <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>the type of interlacing scheme.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">the type of interlacing scheme.</p>
<p>Choose from:</p>
-<pre class="text">
- none
- line
- plane
- partition
- JPEG
- GIF
- PNG
-</pre>
+<pre class="highlight"><code>none
+line
+plane
+partition
+JPEG
+GIF
+PNG
+</code></pre>
<p>This option is used to specify the type of interlacing scheme for raw image
formats such as <code>RGB</code> or <code>YUV</code>.</p>
interlace</a>.</p>
<div style="margin: auto;">
- <h4><a id="interpolate"></a>-interpolate <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="interpolate"></a>-interpolate <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the pixel color interpolation method to use when looking up a color based on a floating point or real value.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set the pixel color interpolation method to use when looking up a color based on a floating point or real value.</p>
<p>When looking up the color of a pixel using a non-integer floating point
value, you typically fall in between the pixel colors defined by the source
the pixels surrounding that point. That is how to determine the color of a
point that falls between two, or even four different colored pixels. </p>
-<pre class="text">
- integer The color of the top-left pixel (floor function)
- nearest-neighbor The nearest pixel to the lookup point (rounded function)
- average The average color of the surrounding four pixels
- bilinear A double linear interpolation of pixels (the default)
- mesh Divide area into two flat triangular interpolations
- bicubic Fitted bicubic-spines of surrounding 16 pixels
- spline Direct spline curves (colors are blurred)
- filter Use resize <a href="command-line-options.html#filter">-filter</a> settings
-</pre>
+<dl class="row">
+ <dt class="col-md-4">average</dt>
+ <dd class="col-md-8">The average color of the surrounding four pixels</dd>
+ <dt class="col-md-4">average4</dt>
+ <dd class="col-md-8">The average color of the surrounding four pixels</dd>
+ <dt class="col-md-4">average9</dt>
+ <dd class="col-md-8">The average color of the surrounding nine pixels</dd>
+ <dt class="col-md-4">average16</dt>
+ <dd class="col-md-8">The average color of the surrounding sixteen pixels</dd>
+ <dt class="col-md-4">background</dt>
+ <dd class="col-md-8"> </dd>
+ <dt class="col-md-4">bilinear</dt>
+ <dd class="col-md-8">A double linear interpolation of pixels (the default)</dd>
+ <dt class="col-md-4">blend</dt>
+ <dd class="col-md-8"> </dd>
+ <dt class="col-md-4">catrom</dt>
+ <dd class="col-md-8">Fitted bicubic-spines of surrounding 16 pixels</dd>
+ <dt class="col-md-4">integer</dt>
+ <dd class="col-md-8">The color of the top-left pixel (floor function)</dd>
+ <dt class="col-md-4">mesh</dt>
+ <dd class="col-md-8">Divide area into two flat triangular interpolations</dd>
+ <dt class="col-md-4">nearest-neighbor</dt>
+ <dd class="col-md-8">The nearest pixel to the lookup point (rounded function)</dd>
+ <dt class="col-md-4">spline</dt>
+ <dd class="col-md-8">Direct spline curves (colors are blurred)</dd>
+</dl>
<p>This most important for distortion operators such as <a href="command-line-options.html#distort"
>-distort</a>, <a href="command-line-options.html#implode" >-implode</a>, <a href="command-line-options.html#transform"
<div style="margin: auto;">
- <h4><a id="interline-spacing"></a>-interline-spacing <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="interline-spacing"></a>-interline-spacing <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>the space between two text lines.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">the space between two text lines.</p>
<div style="margin: auto;">
- <h4><a id="interword-spacing"></a>-interword-spacing <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="interword-spacing"></a>-interword-spacing <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>the space between two words.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">the space between two words.</p>
<div style="margin: auto;">
- <h4><a id="kerning"></a>-kerning <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="kerning"></a>-kerning <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>the space between two letters.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">the space between two letters.</p>
<div style="margin: auto;">
- <h4><a id="kuwahara"></a>-kuwahara <em class="arg">radius</em><br />-kuwahara <em class="arg">radius</em>x<em class="arg">sigma</em></h4>
+ <h3><a class="anchor" id="kuwahara"></a>-kuwahara <var>radius</var><br />-kuwahara <var>radius</var>x<var>sigma</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>edge preserving noise reduction filter.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">edge preserving noise reduction filter.</p>
-<p>The <em class="arg" >radius</em> is more important than the <em class="arg" >sigma</em>. If <em class="arg" >sigma</em> is left off, it will be computed automatically from the <em class="arg" >radius</em> as <em class="arg" >sigma</em>=<em class="arg" >radius</em>-0.5. The <em class="arg" >sigma</em> provides a bit of additional smoothing control.</p>
+<p>The <var >radius</var> is more important than the <var >sigma</var>. If <var >sigma</var> is left off, it will be computed automatically from the <var >radius</var> as <var >sigma</var>=<var >radius</var>-0.5. The <var >sigma</var> provides a bit of additional smoothing control.</p>
<div style="margin: auto;">
- <h4><a id="label"></a>-label <em class="arg">name</em></h4>
+ <h3><a class="anchor" id="label"></a>-label <var>name</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>assign a label to an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">assign a label to an image.</p>
<p>Use this option to assign a specific label to the image, as it is read in
or created. You can use the <a href="command-line-options.html#set" >-set</a> operation to re-assign
a the labels of images already read in. Image formats such as TIFF, PNG,
MIFF, supports saving the label information with the image.</p>
-<p>When saving an image to a <em class="arg">PostScript</em> file, any label
+<p>When saving an image to a <var>PostScript</var> file, any label
assigned to an image is used as a header string to print above the postscript
image. </p>
<p>For example,</p>
-<p class="crtsnip">
- -label "%m:%f %wx%h" bird.miff
-</p>
+<pre class="highlight"><code>-label "%m:%f %wx%h" bird.miff
+</code></pre>
<p>assigns an image label of <code>MIFF:bird.miff 512x480</code> to the
"<code>bird.miff</code>" image and whose width is 512 and height is 480, as it
from an image by assigning the empty string. </p>
<p>A label is not drawn on the image, but is embedded in the image datastream
-via <em>Label</em> tag or similar mechanism. If you want the label to be
+via <var>Label</var> tag or similar mechanism. If you want the label to be
visible on the image itself, use the <a href="command-line-options.html#draw">-draw</a> option, or
during the final processing in the creation of an image montage.</p>
-<p>If the first character of <em class="arg">string</em> is <em
-class="arg">@</em>, the image label is read from a file titled by the
+<p>If the first character of <var>string</var> is <var>@</var>, the image label is read from a file titled by the
remaining characters in the string. Labels in a file are literal, no embedded
formatting characters are recognized.</p>
<div style="margin: auto;">
- <h4><a id="lat"></a>-lat <em class="arg">width</em><br />-lat <em class="arg">width</em>x<em class="arg">height</em>{<em class="arg">+-</em>}<em class="arg">offset</em>{<em class="arg">%</em>}</h4>
+ <h3><a class="anchor" id="lat"></a>-lat <var>width</var><br />-lat <var>width</var>x<var>height</var>{<var>+-</var>}<var>offset</var>{<var>%</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>perform local adaptive threshold.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">perform local adaptive threshold.</p>
<p>Adaptively threshold each pixel based on the value of pixels in a
surrounding window. If the current pixel is lighter than this average plus
<div style="margin: auto;">
- <h4><a id="layers"></a>-layers <em class="arg">method</em></h4>
+ <h3><a class="anchor" id="layers"></a>-layers <var>method</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>handle multiple images forming a set of image layers or animation frames.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">handle multiple images forming a set of image layers or animation frames.</p>
<p>Perform various image operation methods to a ordered sequence of images
which may represent either a set of overlaid 'image layers', a GIF disposal
animation, or a fully-'coalesced' animation sequence. </p>
-<table class="doc">
+<table class="table table-sm table-striped">
<tbody>
- <tr valign="top">
- <th align="left" style="width: 8%">Method</th>
- <th align="left">Description</th>
+ <tr>
+ <th style="width: 8%">Method</th>
+ <th>Description</th>
</tr>
- <tr valign="top">
- <td valign="top">compare-any</td>
- <td valign="top">Crop the second and later frames to the smallest rectangle
+ <tr>
+ <td>compare-any</td>
+ <td>Crop the second and later frames to the smallest rectangle
that contains all the differences between the two images. No GIF <a
href="command-line-options.html#dispose" >-dispose</a> methods are taken into account. </td>
</tr>
'<code>Previous</code>' or '<code>Background</code>'. </td>
</tr>
- <tr valign="top">
- <td valign="top">compare-clear</td>
- <td valign="top">As '<code>compare-any</code>' but crop to the bounds of any
+ <tr>
+ <td>compare-clear</td>
+ <td>As '<code>compare-any</code>' but crop to the bounds of any
opaque pixels which become transparent in the second frame. That is the
smallest image needed to mask or erase pixels for the next frame. </td>
</tr>
- <tr valign="top">
- <td valign="top">compare-overlay</td>
- <td valign="top">As '<code>compare-any</code>' but crop to pixels that add
+ <tr>
+ <td>compare-overlay</td>
+ <td>As '<code>compare-any</code>' but crop to pixels that add
extra color to the next image, as a result of overlaying color pixels.
That is the smallest single overlaid image to add or change colors. </td>
</tr>
just the pixels that need to be overlaid. </td>
</tr>
- <tr valign="top">
- <td valign="top">coalesce</td>
- <td valign="top">Equivalent to a call to the <a href="command-line-options.html#coalesce"
+ <tr>
+ <td>coalesce</td>
+ <td>Equivalent to a call to the <a href="command-line-options.html#coalesce"
>-coalesce</a> operator. Apply the layer disposal methods set in the
current image sequence to form a fully defined animation sequence, as
it should be displayed. Effectively converting a GIF animation into a
'film strip'-like animation. </td>
</tr>
- <tr valign="top">
- <td valign="top">composite</td>
- <td valign="top">Alpha Composition of two image lists, separated by a
+ <tr>
+ <td>composite</td>
+ <td>Alpha Composition of two image lists, separated by a
"<code>null:</code>" image, with the destination image list first, and
the source images last. An image from each list are composited
together until one list is finished. The separator image and source
</tr>
- <tr valign="top">
- <td valign="top">dispose</td>
- <td valign="top">This like '<code>coalesce</code>' but shows the look of
+ <tr>
+ <td>dispose</td>
+ <td>This like '<code>coalesce</code>' but shows the look of
the animation after the layer disposal method has been applied, before
the next sub-frame image is overlaid. That is the 'dispose' image that
results from the application of the GIF <a href="command-line-options.html#dispose"
</td>
</tr>
- <tr valign="top">
- <td valign="top">flatten</td>
- <td valign="top">Create a canvas the size of the first images virtual
+ <tr>
+ <td>flatten</td>
+ <td>Create a canvas the size of the first images virtual
canvas using the current <a href="command-line-options.html#background" >-background</a> color,
and <a href="command-line-options.html#compose" >-compose</a> each image in turn onto that
canvas. Images falling outside that canvas is clipped. Final
</tr>
- <tr valign="top">
- <td valign="top">merge</td>
- <td valign="top">As 'flatten' method but merging all the given image
+ <tr>
+ <td>merge</td>
+ <td>As 'flatten' method but merging all the given image
layers to create a new layer image just large enough to hold all the
image without clipping or extra space. The new images virtual offset
will preserve the position of the new layer, even if this offset is
without doing the'flatten' to merge the images together. </td>
</tr>
- <tr valign="top">
- <td valign="top">mosaic</td>
- <td valign="top">As 'flatten' method but expanding the initial canvas size
+ <tr>
+ <td>mosaic</td>
+ <td>As 'flatten' method but expanding the initial canvas size
of the first image in a positive direction only so as to hold all the
image layers. However as a virtual canvas is 'locked' to the origin,
by its own definition, image layers with a negative offsets will still
</tr>
- <tr valign="top">
- <td valign="top">optimize</td>
- <td valign="top">Optimize a coalesced animation, into GIF animation using
+ <tr>
+ <td>optimize</td>
+ <td>Optimize a coalesced animation, into GIF animation using
a number of general techniques. This currently a short cut to
apply both the '<code>optimize-frame</code>', and
'<code>optimize-transparency</code>' methods but may be expanded to
include other optimization methods as they are developed. </td>
</tr>
- <tr valign="top">
- <td valign="top">optimize-frame</td>
- <td valign="top">Optimize a coalesced animation, into GIF animation by
+ <tr>
+ <td>optimize-frame</td>
+ <td>Optimize a coalesced animation, into GIF animation by
reducing the number of pixels per frame as much as possible by
attempting to pick the best layer disposal method to use, while ensuring
the result will continue to animate properly. </td>
optimizers seen. </td>
</tr>
- <tr valign="top">
- <td valign="top">optimize-plus</td>
- <td valign="top">As '<code>optimize-frame</code>' but attempt to improve the
+ <tr>
+ <td>optimize-plus</td>
+ <td>As '<code>optimize-frame</code>' but attempt to improve the
overall optimization by adding extra frames to the animation, without
changing the final look or timing of the animation. The frames are
added to attempt to separate the clearing of pixels from the
animation size. </td>
</tr>
- <tr valign="top">
- <td valign="top">optimize-transparency</td>
- <td valign="top">Given a GIF animation, replace any pixel in the sub-frame
+ <tr>
+ <td>optimize-transparency</td>
+ <td>Given a GIF animation, replace any pixel in the sub-frame
overlay images with transparency, if it does not change the resulting
animation by more than the current <a href="command-line-options.html#fuzz" >-fuzz</a> factor.
</td>
the current disposed image of the last frame. </td>
</tr>
- <tr valign="top">
- <td valign="top">remove-dups</td>
- <td valign="top">Remove (and merge time delays) of duplicate consecutive
+ <tr>
+ <td>remove-dups</td>
+ <td>Remove (and merge time delays) of duplicate consecutive
images, so as to simplify layer overlays of coalesced animations.
</td>
</tr>
used as part of some frame optimization methods. </td>
</tr>
- <tr valign="top">
- <td valign="top">remove-zero</td>
- <td valign="top">Remove any image with a zero time delay, unless ALL the
+ <tr>
+ <td>remove-zero</td>
+ <td>Remove any image with a zero time delay, unless ALL the
images have a zero time delay (and is not a proper timed animation, a
warning is then issued). </td>
</tr>
improved frame optimization in GIF animations. </td>
</tr>
- <tr valign="top">
- <td valign="top">trim-bounds</td>
- <td valign="top">Find the bounds of all the images in the current
+ <tr>
+ <td>trim-bounds</td>
+ <td>Find the bounds of all the images in the current
image sequence, then adjust the offsets so all images are contained on
a minimal positive canvas. None of the image data is modified or
merged, only the individual image virtual canvas size and offset.
<div style="margin: auto;">
- <h4><a id="level"></a>-level <em class="arg">black_point</em>{,<em class="arg">white_point</em>}{<em class="arg">%</em>}{,<em class="arg">gamma</em>}</h4>
+ <h3><a class="anchor" id="level"></a>-level <var>black_point</var>{,<var>white_point</var>}{<var>%</var>}{,<var>gamma</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>adjust the level of image channels.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">adjust the level of image channels.</p>
<p>Given one, two or three values delimited with commas: black-point,
white-point, gamma (for example: 10,250,1.0 or 2%,98%,0.5). The black and
-white points range from 0 to <em class="QR">QuantumRange</em>, or from 0 to
-100%; if the white point is omitted it is set to (<em
-class="QR">QuantumRange</em> - black_point), so as to center contrast changes.
+white points range from 0 to <var>QuantumRange</var>, or from 0 to
+100%; if the white point is omitted it is set to (<var>QuantumRange</var> - black_point), so as to center contrast changes.
If a <code>%</code> sign is present anywhere in the string, both black and white
points are percentages of the full color range. Gamma will do a <a
href="command-line-options.html#gamma">-gamma</a> adjustment of the values. If it is omitted, the
<p>In normal usage (<code>-level</code>) the image values are stretched so that
the given '<code>black_point</code>' value in the original image is set to zero
-(or black), while the given '<code>white_point</code>' value is set to <em
-class="QR">QuantumRange</em> (or white). This provides you with direct
+(or black), while the given '<code>white_point</code>' value is set to <var>QuantumRange</var> (or white). This provides you with direct
contrast adjustments to the image. The '<code>gamma</code>' of the resulting
image will then be adjusted. </p>
<p>From ImageMagick v6.4.1-9 using the plus form of the operator
(<code>+level</code>) or adding the special '!' flag anywhere in the argument
list, will cause the operator to do the reverse of the level adjustment. That
-is a zero, or <em class="QR">QuantumRange</em> value (black, and white, resp.)
+is a zero, or <var>QuantumRange</var> value (black, and white, resp.)
in the original image, is adjusted to the given level values, allowing you to
de-contrast, or compress the channel values within the image. The
'<code>gamma</code>' is adjusted before the level adjustment to de-contrast the
<div style="margin: auto;">
- <h4><a id="level-colors"></a>-level-colors {<em
- class="arg">black_color</em>}{,}{<em class="arg">white_color</em>}</h4>
+ <h3><a class="anchor" id="level-colors"></a>-level-colors {<var>black_color</var>}{,}{<var>white_color</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>adjust the level of an image using the provided dash separated colors.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">adjust the level of an image using the provided dash separated colors.</p>
<p>This function is exactly like <a href="command-line-options.html#level">-level</a>, except that the
value value for each color channel is determined by the
'<code>black_color</code>' and '<code>white_color</code>' colors given (as
described under the <a href="command-line-options.html#fill">-fill</a> option). </p>
-<p>This effectually means the colors provided to <code>-level-colors</code>
+<p>This effectively means the colors provided to <code>-level-colors</code>
is mapped to become 'black' and 'white' respectively, with all the other
colors linearly adjusted (or clipped) to match that change. Each channel is
adjusted separately using the channel values of the colors specified. </p>
<p>On the other hand the plus form of the operator (<code>+level-colors</code>)
will map the image color 'black' and 'white' to the given colors
respectively, resulting in a gradient (de-contrasting) tint of the image to
-those colors. This can also be used to convert a plain gray-scale image into a
+those colors. This can also be used to convert a plain grayscale image into a
one using the gradient of colors specified. </p>
<p>By supplying a single color with a comma separator either before or after
<div style="margin: auto;">
- <h4><a id="limit"></a>-limit <em class="arg">type value</em></h4>
+ <h3><a class="anchor" id="limit"></a>-limit <var>type value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the pixel cache resource limit.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set the pixel cache resource limit.</p>
-<p>Choose from: <code>area</code>, <code>disk</code>, <code>file</code>,
-<code>map</code>, <code>memory</code>, <code>thread</code>, or <code>time</code>.</p>
+<p>Choose from: <code>width</code>, <code>height</code>, <code>area</code>, <code>memory</code>, <code>map</code>, <code>disk</code>, <code>file</code>, <code>thread</code>, <code>throttle</code>, or <code>time</code>.</p>
<p>The value for <code>file</code> is in number of files. The other limits are
in bytes. Define arguments for the memory, map, area, and disk resource limits
compensating actions, if possible. For example, the following limits
memory:</p>
-<p class="crtsnip">
- -limit memory 32MiB -limit map 64MiB
-</p>
+<pre class="highlight"><code>-limit memory 32MiB -limit map 64MiB
+</code></pre>
<p>Use <a href="command-line-options.html#list">-list resource</a> to list the current limits. For example, our system shows these limits:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>identify -list resource</span><span class='crtout'></span></p><pre class="text">
- File Area Memory Map Disk Thread Time
- ------------------------------------------------------------------------------
- 768 12.404GB 8.6642GiB 23.104GiB 18.446744EB 8 unlimited
-</pre>
+<pre class="highlight"><code>-> identify -list resource
+Resource limits:
+ Width: 100MP
+ Height: 100MP
+ Area: 25.181GB
+ Memory: 11.726GiB
+ Map: 23.452GiB
+ Disk: unlimited
+ File: 768
+ Thread: 12
+ Throttle: 0
+ Time: unlimited
+</code></pre>
<p>Requests for pixel storage to keep intermediate images are satisfied by one
of three resource categories: in-memory pool, memory-mapped files pool, and
the Internet. To assure ImageMagick does not exceed 10MiB of memory you can
simply set the area limit to 10MiB:</p>
-<p class="crtsnip">
--limit area 10MB
-</p>
+<pre class="highlight"><code>-limit area 10MB
+</code></pre>
<p>Now whenever a large image is processed, the pixels are automagically
cached to disk instead of memory. This of course implies that large images
might inadvertently upload a huge image to process, you should set a disk
limit as well:</p>
-<p class="crtsnip">
--limit area 10MB -limit disk 500MB
-</p>
+<pre class="highlight"><code>-limit area 10MB -limit disk 500MB
+</code></pre>
<p>Here ImageMagick stops processing if an image requires more than 500MB of disk storage.</p>
">Architecture</a> page. </p>
<div style="margin: auto;">
- <h4><a id="linear-stretch"></a>-linear-stretch <em class="arg">black-point</em><br />-linear-stretch <em class="arg">black-point</em>{x<em class="arg">white-point</em>}{<em class="arg">%</em>}}</h4>
+ <h3><a class="anchor" id="linear-stretch"></a>-linear-stretch <var>black-point</var><br />-linear-stretch <var>black-point</var>{x<var>white-point</var>}{<var>%</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Linear with saturation stretch.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Linear with saturation stretch.</p>
<p>This is very similar to <a href="command-line-options.html#contrast-stretch" >-contrast-stretch</a>,
and uses a 'histogram bin' to determine the range of color values that needs to
<div style="margin: auto;">
- <h4><a id="linewidth"></a>-linewidth</h4>
+ <h3><a class="anchor" id="linewidth"></a>-linewidth</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>the line width for subsequent draw operations.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">the line width for subsequent draw operations.</p>
<div style="margin: auto;">
- <h4><a id="liquid-rescale"></a>-liquid-rescale <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="liquid-rescale"></a>-liquid-rescale <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>rescale image with seam-carving.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">rescale image with seam-carving.</p>
<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
<div style="margin: auto;">
- <h4><a id="list"></a>-list <em class="arg">type</em></h4>
-</div>
-
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Print a list of supported arguments for various options or settings. Choose from these list types:</td><td style='text-align:right;'></td></tr></table>
-
-<pre class="text">
- Align Alpha Boolean Channel
- Class ClipPath Coder Color
- Colorspace Command Compose Compress
- Configure DataType Debug Decoration
- Delegate Direction Dispose Distort
- Dither Endian Evaluate FillRule
- Filter Font Format Function
- Gravity ImageList Intent Interlace
- Interpolate Kernel Layers LineCap
- LineJoin List Locale LogEvent
- Log Magic Method Metric
- Mime Mode Morphology Module
- Noise Orientation Policy PolicyDomain
- PolicyRights Preview Primitive QuantumFormat
- Resource SparseColor Storage Stretch
- Style Threshold Type Units
- Validate VirtualPixel
-</pre>
+ <h3><a class="anchor" id="list"></a>-list <var>type</var></h3>
+</div>
+
+<p class="magick-description">Print a list of supported arguments for various options or settings. Choose from these list types:</p>
+
+<pre class="pre-scrollable"><code>
+Align
+Alpha
+Boolean
+Cache
+Channel
+Class
+ClipPath
+Coder
+Color
+Colorspace
+Command
+Complex
+Compose
+Compress
+Configure
+DataType
+Debug
+Decoration
+Delegate
+Direction
+Dispose
+Distort
+Dither
+Endian
+Evaluate
+FillRule
+Filter
+Font
+Format
+Function
+Gravity
+Intensity
+Intent
+Interlace
+Interpolate
+Kernel
+Layers
+LineCap
+LineJoin
+List
+Locale
+LogEvent
+Log
+Magic
+Method
+Metric
+Mime
+Mode
+Morphology
+Module
+Noise
+Orientation
+PixelIntensity
+Policy
+PolicyDomain
+PolicyRights
+Preview
+Primitive
+QuantumFormat
+Resource
+SparseColor
+Statistic
+Storage
+Stretch
+Style
+Threshold
+Type
+Units
+Validate
+VirtualPixel
+</code></pre>
<p>These lists vary depending on your version of ImageMagick. Use "<code>-list
list</code>" to get a complete listing of all the "<code>-list</code>" arguments
available:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>identify -list list</span></p>
+<pre class="highlight"><code>identify -list list
+</code></pre>
+
<div style="margin: auto;">
- <h4><a id="log"></a>-log <em class="arg">string</em></h4>
+ <h3><a class="anchor" id="log"></a>-log <var>string</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Specify format for debug log.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Specify format for debug log.</p>
<p>This option specifies the format for the log printed when the <a
href="command-line-options.html#debug">-debug</a> option is active.</p>
<p>You can display the following components by embedding special format
characters:</p>
-<pre class="text">
- %d domain
- %e event
- %f function
- %l line
- %m module
- %p process ID
- %r real CPU time
- %t wall clock time
- %u user CPU time
- %% percent sign
- \n newline
- \r carriage return
-</pre>
+<dl class="row">
+<dt class="col-md-4">%d</dt><dd class="col-md-8">domain</dd>
+<dt class="col-md-4">%e</dt><dd class="col-md-8">event</dd>
+<dt class="col-md-4">%f</dt><dd class="col-md-8">function</dd>
+<dt class="col-md-4">%l</dt><dd class="col-md-8">line</dd>
+<dt class="col-md-4">%m</dt><dd class="col-md-8">module</dd>
+<dt class="col-md-4">%p</dt><dd class="col-md-8">process ID</dd>
+<dt class="col-md-4">%r</dt><dd class="col-md-8">real CPU time</dd>
+<dt class="col-md-4">%t</dt><dd class="col-md-8">wall clock time</dd>
+<dt class="col-md-4">%u</dt><dd class="col-md-8">user CPU time</dd>
+<dt class="col-md-4">%%</dt><dd class="col-md-8">percent sign</dd>
+<dt class="col-md-4">\n</dt><dd class="col-md-8">newline</dd>
+<dt class="col-md-4">\r</dt><dd class="col-md-8">carriage return</dd>
+</dl>
<p>For example:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert -debug coders -log "%u %m:%l %e" in.gif out.png</span></p>
+<pre class="highlight"><code>convert -debug coders -log "%u %m:%l %e" in.gif out.png
+</code></pre>
+
<p>The default behavior is to print all of the components.</p>
<div style="margin: auto;">
- <h4><a id="loop"></a>-loop <em class="arg">iterations</em></h4>
+ <h3><a class="anchor" id="loop"></a>-loop <var>iterations</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>add Netscape loop extension to your GIF animation.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">add Netscape loop extension to your GIF animation.</p>
<p>Set iterations to zero to repeat the animation an infinite number of times,
-otherwise the animation repeats itself up to <em class="arg">iterations</em>
+otherwise the animation repeats itself up to <var>iterations</var>
times.</p>
<div style="margin: auto;">
- <h4><a id="lowlight-color"></a>-lowlight-color <em class="arg">color</em></h4>
+ <h3><a class="anchor" id="lowlight-color"></a>-lowlight-color <var>color</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>when comparing images, de-emphasize pixel differences with this color.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">when comparing images, de-emphasize pixel differences with this color.</p>
<div style="margin: auto;">
- <h4><a id="magnify"></a>-magnify</h4>
+ <h3><a class="anchor" id="magnify"></a>-magnify</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>double the size of the image with pixel art scaling.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">double the size of the image with pixel art scaling.</p>
<div style="margin: auto;">
- <h4><a id="map"></a>-map <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="map"></a>-map <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Display image using this <em class="arg">type</em>.</td><td style='text-align:right;'>[<a href="animate.html">animate</a>, <a href="display.html">display</a>]</td></tr></table>
+<p class="magick-description">Display image using this <var>type</var>.</p>
-<p>Choose from these <em class="arg">Standard Colormap</em> types:</p>
+<p>Choose from these <var>Standard Colormap</var> types:</p>
-<pre class="text">
- best
- default
- gray
- red
- green
- blue
-</pre>
+<pre class="highlight"><code>best
+default
+gray
+red
+green
+blue
+</code></pre>
-<p>The <em class="arg">X server</em> must support the <em class="arg">Standard
-Colormap</em> you choose, otherwise an error occurs. Use <code>list</code> as
+<p>The <var>X server</var> must support the <var>Standard
+Colormap</var> you choose, otherwise an error occurs. Use <code>list</code> as
the type and <code>display</code> searches the list of colormap types in
-<code>top-to-bottom</code> order until one is located. See <em
-class="arg">xstdcmap(1)</em> for one way of creating Standard Colormaps.</p>
+<code>top-to-bottom</code> order until one is located. See <var>xstdcmap(1)</var> for one way of creating Standard Colormaps.</p>
<div style="margin: auto;">
- <h4><a id="map_stream_"></a>-map <em class="arg">components</em></h4>
+ <h3><a class="anchor" id="map_stream_"></a>-map <var>components</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>pixel map.</td><td style='text-align:right;'>[<a href="stream.html">stream</a>]</td></tr></table>
+<p class="magick-description">pixel map.</p>
<p>Here are the valid components of a map:</p>
-<pre class="text">
- r red pixel component
- g green pixel component
- b blue pixel component
- a alpha pixel component (0 is transparent)
- o opacity pixel component (0 is opaque)
- i grayscale intensity pixel component
- c cyan pixel component
- m magenta pixel component
- y yellow pixel component
- k black pixel component
- p pad component (always 0)
-</pre>
+<dl class="row">
+<dt class="col-md-4">r</dt><dd class="col-md-8"> red pixel component</dd>
+<dt class="col-md-4">g</dt><dd class="col-md-8"> green pixel component</dd>
+<dt class="col-md-4">b</dt><dd class="col-md-8"> blue pixel component</dd>
+<dt class="col-md-4">a</dt><dd class="col-md-8"> alpha pixel component (0 is transparent)</dd>
+<dt class="col-md-4">o</dt><dd class="col-md-8"> opacity pixel component (0 is opaque)</dd>
+<dt class="col-md-4">i</dt><dd class="col-md-8"> grayscale intensity pixel component</dd>
+<dt class="col-md-4">c</dt><dd class="col-md-8"> cyan pixel component</dd>
+<dt class="col-md-4">m</dt><dd class="col-md-8"> magenta pixel component</dd>
+<dt class="col-md-4">y</dt><dd class="col-md-8"> yellow pixel component</dd>
+<dt class="col-md-4">k</dt><dd class="col-md-8"> black pixel component</dd>
+<dt class="col-md-4">p</dt><dd class="col-md-8"> pad component (always 0)</dd>
+</dl>
<p>You can specify as many of these components as needed in any order (e.g.
bgr). The components can repeat as well (e.g. rgbr).</p>
<div style="margin: auto;">
- <h4><a id="mask"></a>-mask
-<em class="arg">filename</em></h4>
-</div>
-
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Prevent updates to image pixels specified by the mask.</td><td style='text-align:right;'></td></tr></table>
-
-<p>This the same as using a mask used for composite masking operations, with
-grayscale values causing blended updates of the image the mask is attached to.
-</p>
-
-<p>Use <a href="command-line-options.html#mask">+mask</a> to remove the mask from images.</p>
-
-<p>Also see <a href="command-line-options.html#clip-mask">-clip-mask</a> which work in the same way,
-but with strict boolean masking. </p>
-
-<div style="margin: auto;">
- <h4><a id="mattecolor"></a>-mattecolor <em class="arg">color</em></h4>
+ <h3><a class="anchor" id="mattecolor"></a>-mattecolor <var>color</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Specify the color to be used with the <a href="command-line-options.html#frame">-frame</a> option.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Specify the color to be used with the <a href="command-line-options.html#frame">-frame</a> option.</p>
<p>The color is specified using the format described under the <a href="command-line-options.html#fill">-fill</a> option.</p>
style="background-color: #bdbdbd;">this shade of gray</span>.</p>
<div style="margin: auto;">
- <h4><a id="maximum"></a>-maximum</h4>
+ <h3><a class="anchor" id="maximum"></a>-maximum</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>return the maximum intensity of an image sequence.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">return the maximum intensity of an image sequence.</p>
<p>Select the 'maximum' value from all the surrounding pixels. </p>
name. </p>
<div style="margin: auto;">
- <h4><a id="median"></a>-median <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="median"></a>-median <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>apply a median filter to the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">apply a median filter to the image.</p>
<p>Select the 'middle' value from all the surrounding pixels. </p>
name. </p>
<div style="margin: auto;">
- <h4><a id="mean-shift"></a>-mean-shift <em class="arg">width</em>x<em class="arg">height</em>{<em class="arg">+distance</em>{%}}</h4>
+ <h3><a class="anchor" id="mean-shift"></a>-mean-shift <var>width</var>x<var>height</var>{<var>+distance</var>{%}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>image noise removal and color reduction/segmentation (e.g. -mean-shift 7x7+10%).</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">image noise removal and color reduction/segmentation (e.g. -mean-shift 7x7+10%).</p>
-<p><em class="arg">width</em>x<em class="arg">height</em> is the window size and <em class="arg">distance</em> is the color distance measured in the range 0 to 1 or 0 to 100%</p>
+<p><var>width</var>x<var>height</var> is the window size and <var>distance</var> is the color distance measured in the range 0 to 1 or 0 to 100%</p>
-<p>The mean shift algorithm is iterative and thus slower the larger the window size. For each pixel, it gets all the pixels in the window centered at the pixel and excludes those that are outside the radius=sqrt((width-1)(height-1)/4) surrounding the pixel. From those pixels, it finds which of them are within the specified squared color distance from the current mean. It then computes a new x,y centroid from those coordinates and a new mean. This new x,y centroid is used as the center for a new window. This process is iterated until it converges and the final mean is then used to replace the original pixel value. It repeats this process for the next pixel, etc, until it processes all pixels in the image. Results are better when using other colorspaces rather than RGB. Recommend YIQ, YUV or YCbCr, which seem to give equivalent results.</p>
+<p>The mean shift algorithm is iterative and thus slower the larger the window size. For each pixel, it gets all the pixels in the window centered at the pixel and excludes those that are outside the <var>radius=sqrt((width-1)(height-1)/4)</var> surrounding the pixel. From those pixels, it finds which of them are within the specified squared color distance from the current mean. It then computes a new x,y centroid from those coordinates and a new mean. This new x,y centroid is used as the center for a new window. This process is iterated until it converges and the final mean is then used to replace the original pixel value. It repeats this process for the next pixel, etc, until it processes all pixels in the image. Results are better when using other colorspaces rather than RGB. Recommend YIQ, YUV or YCbCr, which seem to give equivalent results.</p>
<div style="margin: auto;">
- <h4><a id="metric"></a>-metric <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="metric"></a>-metric <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Output to STDERR a measure of the differences between images according to the <em class="arg">type</em> given metric.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Output to STDERR a measure of the differences between images according to the <var>type</var> given metric.</p>
<p>Choose from:</p>
-<pre class="text">
- AE absolute error count, number of different pixels (-fuzz effected)
- FUZZ mean color distance
- MAE mean absolute error (normalized), average channel error distance
- MEPP mean error per pixel (normalized mean error, normalized peak error)
- MSE mean error squared, average of the channel error squared
- NCC normalized cross correlation
- PAE peak absolute (normalized peak absolute)
- PHASH perceptual hash
- PSNR peak signal to noise ratio
- RMSE root mean squared (normalized root mean squared)
-</pre>
+<dl class="row">
+<dt class="col-md-4">AE</dt><dd class="col-md-8"> absolute error count, number of different pixels (-fuzz affected)</dd>
+<dt class="col-md-4">DSSIM</dt><dd class="col-md-8"> structural dissimilarity index</dd>
+<dt class="col-md-4">FUZZ</dt><dd class="col-md-8"> mean color distance</dd>
+<dt class="col-md-4">MAE</dt><dd class="col-md-8"> mean absolute error (normalized), average channel error distance</dd>
+<dt class="col-md-4">MEPP</dt><dd class="col-md-8"> mean error per pixel (normalized mean error, normalized peak error)</dd>
+<dt class="col-md-4">MSE</dt><dd class="col-md-8"> mean error squared, average of the channel error squared</dd>
+<dt class="col-md-4">NCC</dt><dd class="col-md-8"> normalized cross correlation</dd>
+<dt class="col-md-4">PAE</dt><dd class="col-md-8"> peak absolute (normalized peak absolute)</dd>
+<dt class="col-md-4">PHASH</dt><dd class="col-md-8"> perceptual hash for the sRGB and HCLp colorspaces. Specify an alternative colorspace with <code>-define phash:colorspaces=<var>colorspace,colorspace,...</var></code></dd>
+<dt class="col-md-4">PSNR</dt><dd class="col-md-8"> peak signal to noise ratio</dd>
+<dt class="col-md-4">RMSE</dt><dd class="col-md-8"> root mean squared (normalized root mean squared)</dd>
+<dt class="col-md-4">SSIM</dt><dd class="col-md-8"> structural similarity index</dd>
+</dl>
<p>Control the '<code>AE</code>', or absolute count of pixels that are different,
with the <a href="command-line-options.html#fuzz" >-fuzz</a> factor (ignore pixels which
'similar', while '<code>MAE</code>' determines the factor needed
for about half the pixels to be similar. </p>
-<p>The '<code>MEPP</code>' metric returns three different metrics
+<p>The <code>MEPP</code> metric returns three different metrics
('<code>MAE</code>', '<code>MAE</code>' normalized, and '<code>PAE</code>'
normalized) from a single comparison run. </p>
+<p>The <code>SSIM</code> and <code>DSSIM</code> metrics respect these defines:
+<code>-define compare:ssim-radius</code>, <code>-define compare:ssim-sigma</code>,
+<code>-define compare:ssim-k1</code>, and <code>-define compare:ssim-k2</code>.</p>
+
<p>To print a complete list of metrics, use the <a href="command-line-options.html#list">-list
metric</a> option.</p>
<div style="margin: auto;">
- <h4><a id="minimum"></a>-minimum</h4>
+ <h3><a class="anchor" id="minimum"></a>-minimum</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>return the minimum intensity of an image sequence.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">return the minimum intensity of an image sequence.</p>
<p>Select the 'minimal' value from all the surrounding pixels. </p>
<div style="margin: auto;">
- <h4><a id="mode"></a>-mode <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="mode"></a>-mode <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>make each pixel the 'predominant color' of the neighborhood.</td><td style='text-align:right;'>[<a href="convert.html">convert</a>, <a href="mogrify.html">mogrify</a>]</td></tr></table>
+<p class="magick-description">make each pixel the \'predominant color\' of the neighborhood.'</p>
<div style="margin: auto;">
- <h4>-mode <em class="arg">value</em></h4>
+ <h3>-mode <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Mode of operation.</td><td style='text-align:right;'>[<a href="montage.html">montage</a>]</td></tr></table>
+<p class="magick-description">Mode of operation.</p>
-<p>Choose the <em class="arg">value</em> from these styles: <code>Frame,
+<p>Choose the <var>value</var> from these styles: <code>Frame,
Unframe, or Concatenate</code></p>
<p>Use the <a href="command-line-options.html#list" >-list</a> option with a '<code>Mode</code>' argument
<div style="margin: auto;">
- <h4><a id="modulate"></a>-modulate <em class="arg">brightness</em>[,<em class="arg">saturation</em>,<em class="arg">hue</em>]</h4>
+ <h3><a class="anchor" id="modulate"></a>-modulate <var>brightness</var>[,<var>saturation</var>,<var>hue</var>]</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Vary the <em class="arg">brightness</em>, <em
-class="arg">saturation</em>, and <em class="arg">hue</em> of an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Vary the <var>brightness</var>, <var>saturation</var>, and <var>hue</var> of an image.</p>
<p>The arguments are given as a percentages of variation. A value of 100 means
no change, and any missing values are taken to mean 100.</p>
-<p>The <em class="arg">brightness</em> is a multiplier of the overall
+<p>The <var>brightness</var> is a multiplier of the overall
brightness of the image, so 0 means pure black, 50 is half as bright, 200 is
twice as bright. To invert its meaning <a href="command-line-options.html#negate">-negate</a> the image
before and after. </p>
-<p>The <em class="arg">saturation</em> controls the amount of color in an
+<p>The <var>saturation</var> controls the amount of color in an
image. For example, 0 produce a grayscale image, while a large value such as
200 produce a very colorful, 'cartoonish' color.</p>
-<p>The <em class="arg">hue</em> argument causes a "rotation" of the colors
+<p>The <var>hue</var> argument causes a "rotation" of the colors
within the image by the amount specified. For example, 50 results in
a counter-clockwise rotation of 90, mapping red shades to purple, and so on.
A value of either 0 or 200 results in a complete 180 degree rotation of the
href="command-line-options.html#modulate">-modulate 120,90</a>.</p>
<p>Use <a href="command-line-options.html#set">-set</a> attribute of '<code
-class="arg">option:modulate:colorspace</code>' to specify which colorspace to
+>option:modulate:colorspace</code>' to specify which colorspace to
modulate. Choose from <code>HCL</code>, <code>HCLp</code>, <code>HSB</code>, <code>HSI</code>, <code>HSL</code> (the default), <code>HSV</code>, <code>HWB</code>, or <code>LCH</code> (LCHuv). For example,</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert image.png -set option:modulate:colorspace hsb -modulate 120,90 modulate.png</span></p>
+<pre class="highlight"><code>convert image.png -set option:modulate:colorspace hsb -modulate 120,90 modulate.png
+</code></pre>
+
<div style="margin: auto;">
- <h4><a id="moments"></a>-moments</h4>
+ <h3><a class="anchor" id="moments"></a>-moments</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>report image moments and perceptual hash.</td><td style='text-align:right;'>[<a href="identify.html">identify</a>]</td></tr></table>
+<p class="magick-description">report image moments and perceptual hash.</p>
<div style="margin: auto;">
- <h4><a id="monitor"></a>-monitor</h4>
+ <h3><a class="anchor" id="monitor"></a>-monitor</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>monitor progress.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">monitor progress.</p>
<div style="margin: auto;">
- <h4><a id="monochrome"></a>-monochrome</h4>
+ <h3><a class="anchor" id="monochrome"></a>-monochrome</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>transform the image to black and white.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">transform the image to black and white.</p>
<div style="margin: auto;">
- <h4><a id="morph"></a>-morph <em class="arg">frames</em></h4>
+ <h3><a class="anchor" id="morph"></a>-morph <var>frames</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>morphs an image sequence.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">morphs an image sequence.</p>
<p>Both the image pixels and size are linearly interpolated to give the
appearance of a metamorphosis from one image to the next, over all the images
in the current image list. The added images are the equivalent of a <a
-href="command-line-options.html#blend">-blend</a> composition. The <em class="arg">frames</em>
+href="command-line-options.html#blend">-blend</a> composition. The <var>frames</var>
argument determine how many images to interpolate between each image. </p>
<div style="margin: auto;">
- <h4><a id="morphology"></a>-morphology</h4>
- <h4>-morphology <em class="arg">method</em> <em class="arg">kernel</em></h4>
+ <h3><a class="anchor" id="morphology"></a>-morphology</h3>
+ <h3>-morphology <var>method</var> <var>kernel</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>apply a morphology method to the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">apply a morphology method to the image.</p>
<p>Until I get around to writing an option summary for this, see <a
-href="http://www.imagemagick.org/Usage/morphology/" >IM Usage Examples,
+href="../Usage/morphology/" >IM Usage Examples,
Morphology</a>. </p>
<div style="margin: auto;">
- <h4><a id="mosaic"></a>-mosaic</h4>
+ <h3><a class="anchor" id="mosaic"></a>-mosaic</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>an simple alias for the <a href="command-line-options.html#layers" >-layers</a> method "mosaic"</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">an simple alias for the <a href="command-line-options.html#layers" >-layers</a> method "mosaic"</p>
<div style="margin: auto;">
- <h4><a id="motion-blur"></a>-motion-blur <em class="arg">radius</em><br />-motion-blur <em class="arg">radius</em>x<em class="arg">sigma</em>+<em class="arg">angle</em></h4>
+ <h3><a class="anchor" id="motion-blur"></a>-motion-blur <var>radius</var><br />-motion-blur <var>radius</var>x<var>sigma</var>+<var>angle</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>simulate motion blur.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">simulate motion blur.</p>
<p>Blur with the given radius, standard deviation (sigma), and angle. The
angle given is the angle toward which the image is blurred. That is the
</p>
<div style="margin: auto;">
- <h4><a id="name"></a>-name</h4>
+ <h3><a class="anchor" id="name"></a>-name</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>name an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">name an image.</p>
<div style="margin: auto;">
- <h4><a id="negate"></a>-negate</h4>
+ <h3><a class="anchor" id="negate"></a>-negate</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>replace each pixel with its complementary color.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">replace each pixel with its complementary color.</p>
<p>The red, green, and blue intensities of an image are negated. White becomes
black, yellow becomes blue, etc. Use <a href="command-line-options.html#negate">+negate</a> to only
negate the grayscale pixels of the image.</p>
<div style="margin: auto;">
- <h4><a id="noise"></a>-noise <em class="arg">geometry</em><br/>
- +noise <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="noise"></a>-noise <var>geometry</var><br/>
+ +noise <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Add or reduce noise in an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Add or reduce noise in an image.</p>
<p>The principal function of noise peak elimination filter is to smooth the
objects within an image without losing edge information and without creating
found to be noise. A pixel is defined as noise if and only if this pixel is
a maximum or minimum within the pixel window.</p>
-<p>Use <code><a href="command-line-options.html#noise">-noise</a> <em class="arg">radius</em></code> to
+<p>Use <code><a href="command-line-options.html#noise">-noise</a> <var>radius</var></code> to
specify the width of the neighborhood when reducing noise. This is equivalent
to using a <code><a href="command-line-options.html#statistic" >-statistic</a> NonPeak</code> operation,
which should be used in preference.</p>
-<p>Use <a href="command-line-options.html#noise">+noise</a> followed by a noise <em
-class="arg">type</em> to add noise to an image. Choose from these noise
+<p>Use <a href="command-line-options.html#noise">+noise</a> followed by a noise <var>type</var> to add noise to an image. Choose from these noise
types:</p>
-<pre class="text">
- Gaussian
- Impulse
- Laplacian
- Multiplicative
- Poisson
- Random
- Uniform
-</pre>
-
-<p>The amount of noise added can be controled by the <code><a
-href="command-line-options.html#attunuuate" >-attenuate</a></code> setting. If unset the value is
+<pre class="highlight"><code>Gaussian
+Impulse
+Laplacian
+Multiplicative
+Poisson
+Random
+Uniform
+</code></pre>
+
+<p>The amount of noise added can be controlled by the <code><a
+href="command-line-options.html#attenuate" >-attenuate</a></code> setting. If unset the value is
equivalent to 1.0, or a maximum noise addition.</p>
<p>Note that Random will replace the image with noise rather than add noise to the image. Use Uniform, if you wish to add random noise to the image.</p>
<div style="margin: auto;">
- <h4><a id="normalize"></a>-normalize</h4>
+ <h3><a class="anchor" id="normalize"></a>-normalize</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Increase the contrast in an image by <em>stretching</em> the range of intensity values.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Increase the contrast in an image by <var>stretching</var> the range of intensity values.</p>
<p>The intensity values are stretched to cover the entire range of possible
-values. While doing so, black-out at most <em>2%</em> of the pixels and
-white-out at most <em>1%</em> of the pixels.</p>
+values. While doing so, black-out at most <var>2%</var> of the pixels and
+white-out at most <var>1%</var> of the pixels.</p>
<p>Note that as of ImageMagick 6.4.7-0, <a href="command-line-options.html#normalize" >-normalize</a>
is equivalent to <a href="command-line-options.html#contrast-stretch" >-contrast-stretch 2%x1%</a>.
(Before this version, it was equivalent to <a href="command-line-options.html#contrast-stretch"
>-contrast-stretch 2%x99%</a>).</p>
-<p>All the channels are normalized in concert by the came amount so as to
+<p>All the channels are normalized in concert by the same amount so as to
preserve color integrity, when the default <a href="command-line-options.html#channel" >+channel</a>
setting is in use. Specifying any other <a href="command-line-options.html#channel" >-channel</a>
setting will normalize the RGB channels independently.</p>
<div style="margin: auto;">
- <h4><a id="opaque"></a>-opaque <em class="arg">color</em></h4>
+ <h3><a class="anchor" id="opaque"></a>-opaque <var>color</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>change this color to the fill color within the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">change this color to the fill color within the image.</p>
-<p>The <em class="arg">color</em> argument is defined using the format
+<p>The <var>color</var> argument is defined using the format
described under the <a href="command-line-options.html#fill" >-fill</a> option. The <a href="command-line-options.html#fuzz"
>-fuzz</a> setting can be used to match and replace colors similar to the one
given.</p>
<div style="margin: auto;">
- <h4><a id="ordered-dither"></a>-ordered-dither <em class="arg">threshold_map</em>{,<em class="arg">level</em>...}</h4>
+ <h3><a class="anchor" id="ordered-dither"></a>-ordered-dither <var>threshold_map</var>{,<var>level</var>...}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>dither the image using a pre-defined ordered dither <em
-class="arg">threshold map</em> specified, and a uniform color map with the
-given number of <em class="arg">levels</em> per color channel . </td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">dither the image using a pre-defined ordered dither <var>threshold map</var> specified, and a uniform color map with the
+given number of <var>levels</var> per color channel.</p>
<p>You can choose from these standard threshold maps:</p>
-<pre class="text">
- threshold 1x1 Threshold 1x1 (non-dither)
- checks 2x1 Checkerboard 2x1 (dither)
- o2x2 2x2 Ordered 2x2 (dispersed)
- o3x3 3x3 Ordered 3x3 (dispersed)
- o4x4 4x4 Ordered 4x4 (dispersed)
- o8x8 8x8 Ordered 8x8 (dispersed)
- h4x4a 4x1 Halftone 4x4 (angled)
- h6x6a 6x1 Halftone 6x6 (angled)
- h8x8a 8x1 Halftone 8x8 (angled)
- h4x4o Halftone 4x4 (orthogonal)
- h6x6o Halftone 6x6 (orthogonal)
- h8x8o Halftone 8x8 (orthogonal)
- h16x16o Halftone 16x16 (orthogonal)
- c5x5b c5x5 Circles 5x5 (black)
- c5x5w Circles 5x5 (white)
- c6x6b c6x6 Circles 6x6 (black)
- c6x6w Circles 6x6 (white)
- c7x7b c7x7 Circles 7x7 (black)
- c7x7w Circles 7x7 (white)
-</pre>
+<pre class="pre-scrollable"><code>
+threshold 1x1 Threshold 1x1 (non-dither)
+checks 2x1 Checkerboard 2x1 (dither)
+o2x2 2x2 Ordered 2x2 (dispersed)
+o3x3 3x3 Ordered 3x3 (dispersed)
+o4x4 4x4 Ordered 4x4 (dispersed)
+o8x8 8x8 Ordered 8x8 (dispersed)
+h3x4a 4x1 Halftone 4x4 (angled)
+h6x6a 6x1 Halftone 6x6 (angled)
+h8x8a 8x1 Halftone 8x8 (angled)
+h3x4o Halftone 4x4 (orthogonal)
+h6x6o Halftone 6x6 (orthogonal)
+h8x8o Halftone 8x8 (orthogonal)
+h36x16o Halftone 16x16 (orthogonal)
+c5x5b c5x5 Circles 5x5 (black)
+c5x5w Circles 5x5 (white)
+c6x6b c6x6 Circles 6x6 (black)
+c6x6w Circles 6x6 (white)
+c7x7b c7x7 Circles 7x7 (black)
+c7x7w Circles 7x7 (white)
+</code></pre>
<p> The <code>threshold</code> generated a simple 50% threshold of the image.
-This could be used with <em class="arg" >level</em> to do the equivalent of <a
+This could be used with <var >level</var> to do the equivalent of <a
href="command-line-options.html#posterize" >-posterize</a> to reduce an image to basic primary colors.
</p>
white, and mid-tone colors into a checkerboard pattern of black and white.
</p>
-<p>You can define your own <em class="arg" >threshold map</em> for ordered
+<p>You can define your own <var >threshold map</var> for ordered
dithering and halftoning your images, in either personal or system
<code>thresholds.xml</code> XML file. See <a href="resources.html" >Resources</a>
for more details of configuration files. </p>
<div style="margin: auto;">
- <h4><a id="orient"></a>-orient <em class="arg">image orientation</em></h4>
+ <h3><a class="anchor" id="orient"></a>-orient <var>image orientation</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>specify orientation of a digital camera image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">specify orientation of a digital camera image.</p>
<p>Choose from these orientations:</p>
-<pre class="text">
- bottom-left
- bottom-right
- left-bottom
- left-top
- right-bottom
- right-top
- top-left
- top-right
- undefined
-</pre>
+<pre class="highlight"><code>bottom-left right-top
+bottom-right top-left
+left-bottom top-right
+left-top undefined
+right-bottom
+</code></pre>
<p>To print a complete list of orientations, use the <a href="command-line-options.html#list" >-list
orientation</a> option.</p>
<div style="margin: auto;">
- <h4><a id="page"></a>-page <em class="arg">geometry</em><br/>
- -page <em class="arg">media</em>[<em class="arg">offset</em>][{<em class="arg">^!<></em>}]<br/>
+ <h3><a class="anchor" id="page"></a>-page <var>geometry</var><br/>
+ -page <var>media</var>[<var>offset</var>][{<var>^!<></var>}]<br/>
+page
- </h4>
+ </h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the size and location of an image on the larger virtual canvas.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set the size and location of an image on the larger virtual canvas.</p>
<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
-<p>For convenience you can specify the page size using <em
-class="arg">media</em> (see below). Offsets can then be added as with other
-<em class="arg">geometry</em> arguments (e.g. <a
+<p>For convenience you can specify the page size using <var>media</var> (see below). Offsets can then be added as with other
+<var>geometry</var> arguments (e.g. <a
href="command-line-options.html#page">-page</a> <code>Letter+43+43</code>).</p>
-<p>Use <em class="arg">media</em> as shorthand to specify the dimensions (<em
-class="arg">width</em>x<em class="arg">height</em>) of the <em
-class="arg">PostScript</em> page in dots per inch or a TEXT page in pixels.
+<p>Use <var>media</var> as shorthand to specify the dimensions (<var>width</var>x<var>height</var>) of the <var>PostScript</var> page in dots per inch or a TEXT page in pixels.
The choices for a PostScript page are:</p>
-<table id="geometryTable" cellpadding="2" cellspacing="0" border="1"
-width="50%" style="margin-left: auto; margin-right: auto;">
-<thead>
- <tr valign="top">
- <th align="center"><em class="arg">media</em></th>
- <th align="center"><em class="arg">width</em></th>
- <th align="center"><em class="arg">height</em></th>
- </tr>
-</thead>
-<tbody>
-<tr><td align="left"> 11x17 </td> <td align="right"> 792</td> <td align="right"> 1224</td> </tr>
-<tr><td align="left"> Ledger </td> <td align="right"> 1224</td> <td align="right"> 792</td> </tr>
-<tr><td align="left"> Legal </td> <td align="right"> 612</td> <td align="right"> 1008</td> </tr>
-<tr><td align="left"> Letter </td> <td align="right"> 612</td> <td align="right"> 792</td> </tr>
-<tr><td align="left"> LetterSmall</td> <td align="right"> 612</td> <td align="right"> 792</td> </tr>
-<tr><td align="left"> ArchE </td> <td align="right"> 2592</td> <td align="right"> 3456</td> </tr>
-<tr><td align="left"> ArchD </td> <td align="right"> 1728</td> <td align="right"> 2592</td> </tr>
-<tr><td align="left"> ArchC </td> <td align="right"> 1296</td> <td align="right"> 1728</td> </tr>
-<tr><td align="left"> ArchB </td> <td align="right"> 864</td> <td align="right"> 1296</td> </tr>
-<tr><td align="left"> ArchA </td> <td align="right"> 648</td> <td align="right"> 864</td> </tr>
-<tr><td align="left"> A0 </td> <td align="right"> 2380</td> <td align="right"> 3368</td> </tr>
-<tr><td align="left"> A1 </td> <td align="right"> 1684</td> <td align="right"> 2380</td> </tr>
-<tr><td align="left"> A2 </td> <td align="right"> 1190</td> <td align="right"> 1684</td> </tr>
-<tr><td align="left"> A3 </td> <td align="right"> 842</td> <td align="right"> 1190</td> </tr>
-<tr><td align="left"> A4 </td> <td align="right"> 595</td> <td align="right"> 842</td> </tr>
-<tr><td align="left"> A4Small </td> <td align="right"> 595</td> <td align="right"> 842</td> </tr>
-<tr><td align="left"> A5 </td> <td align="right"> 421</td> <td align="right"> 595</td> </tr>
-<tr><td align="left"> A6 </td> <td align="right"> 297</td> <td align="right"> 421</td> </tr>
-<tr><td align="left"> A7 </td> <td align="right"> 210</td> <td align="right"> 297</td> </tr>
-<tr><td align="left"> A8 </td> <td align="right"> 148</td> <td align="right"> 210</td> </tr>
-<tr><td align="left"> A9 </td> <td align="right"> 105</td> <td align="right"> 148</td> </tr>
-<tr><td align="left"> A10 </td> <td align="right"> 74</td> <td align="right"> 105</td> </tr>
-<tr><td align="left"> B0 </td> <td align="right"> 2836</td> <td align="right"> 4008</td> </tr>
-<tr><td align="left"> B1 </td> <td align="right"> 2004</td> <td align="right"> 2836</td> </tr>
-<tr><td align="left"> B2 </td> <td align="right"> 1418</td> <td align="right"> 2004</td> </tr>
-<tr><td align="left"> B3 </td> <td align="right"> 1002</td> <td align="right"> 1418</td> </tr>
-<tr><td align="left"> B4 </td> <td align="right"> 709</td> <td align="right"> 1002</td> </tr>
-<tr><td align="left"> B5 </td> <td align="right"> 501</td> <td align="right"> 709</td> </tr>
-<tr><td align="left"> C0 </td> <td align="right"> 2600</td> <td align="right"> 3677</td> </tr>
-<tr><td align="left"> C1 </td> <td align="right"> 1837</td> <td align="right"> 2600</td> </tr>
-<tr><td align="left"> C2 </td> <td align="right"> 1298</td> <td align="right"> 1837</td> </tr>
-<tr><td align="left"> C3 </td> <td align="right"> 918</td> <td align="right"> 1298</td> </tr>
-<tr><td align="left"> C4 </td> <td align="right"> 649</td> <td align="right"> 918</td> </tr>
-<tr><td align="left"> C5 </td> <td align="right"> 459</td> <td align="right"> 649</td> </tr>
-<tr><td align="left"> C6 </td> <td align="right"> 323</td> <td align="right"> 459</td> </tr>
-<tr><td align="left"> Flsa </td> <td align="right"> 612</td> <td align="right"> 936</td> </tr>
-<tr><td align="left"> Flse </td> <td align="right"> 612</td> <td align="right"> 936</td> </tr>
-<tr><td align="left"> HalfLetter </td> <td align="right"> 396</td> <td align="right"> 612</td> </tr>
-</tbody>
-</table>
-
+<dl class="row">
+<dt class="col-md-4"> 11x17 </dt> <dd class="col-md-8"> 792 x 1224</dd>
+<dt class="col-md-4"> Ledger </dt> <dd class="col-md-8"> 1224 x 792</dd>
+<dt class="col-md-4"> Legal </dt> <dd class="col-md-8"> 612 x 1008</dd>
+<dt class="col-md-4"> Letter </dt> <dd class="col-md-8"> 612 x 792</dd>
+<dt class="col-md-4"> LetterSmall</dt> <dd class="col-md-8"> 612 x 792</dd>
+<dt class="col-md-4"> ArchE </dt> <dd class="col-md-8"> 2592 x 3456</dd>
+<dt class="col-md-4"> ArchD </dt> <dd class="col-md-8"> 1728 x 2592</dd>
+<dt class="col-md-4"> ArchC </dt> <dd class="col-md-8"> 1296 x 1728</dd>
+<dt class="col-md-4"> ArchB </dt> <dd class="col-md-8"> 864 x 1296</dd>
+<dt class="col-md-4"> ArchA </dt> <dd class="col-md-8"> 648 x 864</dd>
+<dt class="col-md-4"> A0 </dt> <dd class="col-md-8"> 2380 x 3368</dd>
+<dt class="col-md-4"> A1 </dt> <dd class="col-md-8"> 1684 x 2380</dd>
+<dt class="col-md-4"> A2 </dt> <dd class="col-md-8"> 1190 x 1684</dd>
+<dt class="col-md-4"> A3 </dt> <dd class="col-md-8"> 842 x 1190</dd>
+<dt class="col-md-4"> A4 </dt> <dd class="col-md-8"> 595 x 842</dd>
+<dt class="col-md-4"> A4Small </dt> <dd class="col-md-8"> 595 x 842</dd>
+<dt class="col-md-4"> A5 </dt> <dd class="col-md-8"> 421 x 595</dd>
+<dt class="col-md-4"> A6 </dt> <dd class="col-md-8"> 297 x 421</dd>
+<dt class="col-md-4"> A7 </dt> <dd class="col-md-8"> 210 x 297</dd>
+<dt class="col-md-4"> A8 </dt> <dd class="col-md-8"> 148 x 210</dd>
+<dt class="col-md-4"> A9 </dt> <dd class="col-md-8"> 105 x 148</dd>
+<dt class="col-md-4"> A10 </dt> <dd class="col-md-8"> 74 x 105</dd>
+<dt class="col-md-4"> B0 </dt> <dd class="col-md-8"> 2836 x 4008</dd>
+<dt class="col-md-4"> B1 </dt> <dd class="col-md-8"> 2004 x 2836</dd>
+<dt class="col-md-4"> B2 </dt> <dd class="col-md-8"> 1418 x 2004</dd>
+<dt class="col-md-4"> B3 </dt> <dd class="col-md-8"> 1002 x 1418</dd>
+<dt class="col-md-4"> B4 </dt> <dd class="col-md-8"> 709 x 1002</dd>
+<dt class="col-md-4"> B5 </dt> <dd class="col-md-8"> 501 x 709</dd>
+<dt class="col-md-4"> C0 </dt> <dd class="col-md-8"> 2600 x 3677</dd>
+<dt class="col-md-4"> C1 </dt> <dd class="col-md-8"> 1837 x 2600</dd>
+<dt class="col-md-4"> C2 </dt> <dd class="col-md-8"> 1298 x 1837</dd>
+<dt class="col-md-4"> C3 </dt> <dd class="col-md-8"> 918 x 1298</dd>
+<dt class="col-md-4"> C4 </dt> <dd class="col-md-8"> 649 x 918</dd>
+<dt class="col-md-4"> C5 </dt> <dd class="col-md-8"> 459 x 649</dd>
+<dt class="col-md-4"> C6 </dt> <dd class="col-md-8"> 323 x 459</dd>
+<dt class="col-md-4"> Flsa </dt> <dd class="col-md-8"> 612 x 936</dd>
+<dt class="col-md-4"> Flse </dt> <dd class="col-md-8"> 612 x 936</dd>
+<dt class="col-md-4"> HalfLetter </dt> <dd class="col-md-8"> 396 x 612</dd>
+</dl>
<p>This option is also used to place subimages when writing to a multi-image
format that supports offsets, such as GIF89 and MNG. When used for this
purpose the offsets are always measured from the top left corner of the canvas
and are not affected by the <a href="command-line-options.html#gravity">-gravity</a> option. To
-position a GIF or MNG image, use <a href="command-line-options.html#page">-page</a><em
-class="arg">{+-}x{+-}y</em> (e.g. -page +100+200). When writing to a MNG
+position a GIF or MNG image, use <a href="command-line-options.html#page">-page</a><var>{+-}x{+-}y</var> (e.g. -page +100+200). When writing to a MNG
file, a <a href="command-line-options.html#page">-page</a> option appearing ahead of the first image in
the sequence with nonzero width and height defines the width and height values
that are written in the <code>MHDR</code> chunk. Otherwise, the MNG width and
determine its dimensions.</p>
<p>For a PostScript page, the image is sized as in <a
-href="command-line-options.html#geometry">-geometry</a> but positioned relative to the <em>lower
-left-hand corner</em> of the page by {+-}<code>x</code><em
-class="arg">offset</em>{+-}<code>y</code> <em class="arg">offset</em>. Use <a
+href="command-line-options.html#geometry">-geometry</a> but positioned relative to the <var>lower
+left-hand corner</var> of the page by {+-}<code>x</code><var>offset</var>{+-}<code>y</code> <var>offset</var>. Use <a
href="command-line-options.html#page">-page 612x792</a>, for example, to center the image within the
page. If the image size exceeds the PostScript page, it is reduced to fit the
-page. The default gravity for the <a href="command-line-options.html#page">-page</a> option is <em
-class="arg">NorthWest</em>, i.e., positive <code>x</code> and <code>y</code> <em
-class="arg">offset</em> are measured rightward and downward from the top left
+page. The default gravity for the <a href="command-line-options.html#page">-page</a> option is <var>NorthWest</var>, i.e., positive <code>x</code> and <code>y</code> <var>offset</var> are measured rightward and downward from the top left
corner of the page, unless the <a href="command-line-options.html#gravity">-gravity</a> option is
-present with a value other than <em class="arg">NorthWest</em>.</p>
+present with a value other than <var>NorthWest</var>.</p>
<p>The default page dimensions for a TEXT image is 612x792.</p>
<p>Use <a href="command-line-options.html#page">+page</a> to remove the page settings for an image.</p>
<div style="margin: auto;">
- <h4><a id="paint"></a>-paint <em class="arg">radius</em></h4>
+ <h3><a class="anchor" id="paint"></a>-paint <var>radius</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>simulate an oil painting.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">simulate an oil painting.</p>
<p>Each pixel is replaced by the most frequent color in a circular
-neighborhood whose width is specified with <em class="arg">radius</em>.</p>
+neighborhood whose width is specified with <var>radius</var>.</p>
<div style="margin: auto;">
- <h4><a id="path"></a>-path <em class="arg">path</em></h4></div>
+ <h3><a class="anchor" id="path"></a>-path <var>path</var></h3></div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>write images to this path on disk.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">write images to this path on disk.</p>
<div style="margin: auto;">
- <h4><a id="pause_animate_"></a>-pause <em class="arg">seconds</em></h4>
+ <h3><a class="anchor" id="pause_animate_"></a>-pause <var>seconds</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Pause between animation loops.</td><td style='text-align:right;'>[<a href="animate.html">animate</a>]</td></tr></table>
+<p class="magick-description">Pause between animation loops</p>
<p>Pause for the specified number of seconds before repeating the animation.</p>
<div style="margin: auto;">
- <h4><a id="pause_import_"></a>-pause <em class="arg">seconds</em></h4>
+ <h3><a class="anchor" id="pause_import_"></a>-pause <var>seconds</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Pause between snapshots.</td><td style='text-align:right;'>[<a href="import.html">import</a>]</td></tr></table>
+<p class="magick-description">Pause between snapshots.</p>
<p>Pause for the specified number of seconds before taking the next snapshot.</p>
<div style="margin: auto;">
- <h4><a id="perceptible"></a>-perceptible <em class="arg">epsilon</em></h4>
+ <h3><a class="anchor" id="perceptible"></a>-perceptible <var>epsilon</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>set each pixel whose value is less than |<em>epsilon</em>| to <em>-epsilon</em> or <em>epsilon</em> (whichever is closer) otherwise the pixel value remains unchanged.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">set each pixel whose value is less than |<var>epsilon</var>| to <var>-epsilon</var> or <var>epsilon</var> (whichever is closer) otherwise the pixel value remains unchanged.</p>
<div style="margin: auto;">
- <h4><a id="ping"></a>-ping</h4>
+ <h3><a class="anchor" id="ping"></a>-ping</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>efficiently determine image characteristics.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">efficiently determine image characteristics.</p>
<div style="margin: auto;">
- <h4><a id="pointsize"></a>-pointsize <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="pointsize"></a>-pointsize <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>pointsize of the PostScript, OPTION1, or TrueType font.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">pointsize of the PostScript, OPTION1, or TrueType font.</p>
<div style="margin: auto;">
- <h4><a id="polaroid"></a>-polaroid <em class="arg">angle</em></h4>
+ <h3><a class="anchor" id="polaroid"></a>-polaroid <var>angle</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>simulate a Polaroid picture.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">simulate a Polaroid picture.</p>
<p>Use <code>+polaroid</code> to rotate the image at a random angle between -15 and +15 degrees.</p>
<div style="margin: auto;">
- <h4><a id="poly"></a>-poly <em class="arg">"wt,exp ..."</em></h4>
+ <h3><a class="anchor" id="poly"></a>-poly <var>"wt,exp ..."</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>combines multiple images according to a weighted sum of polynomials; one floating point weight (coefficient) and one floating point polynomial exponent (power) for each image expressed as comma separated pairs.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">combines multiple images according to a weighted sum of polynomials; one floating point weight (coefficient) and one floating point polynomial exponent (power) for each image expressed as comma separated pairs.</p>
<p> The weights should typically be fractions between -1 and 1. But the sum of weights should be 1 or at least between 0 and 1 to avoid clamping in non-hdri mode at black and white.</p>
<p>The exponents may be positive, negative or zero. A negative exponent is equivalent to 1 divided by the image raised to the corresponding positive exponent. A zero exponent always produces 1 scaled by quantumrange to white, i.e. wt*white, no matter what the image.</p>
-<p>The format is: output = wt1*image1^exp1 + wt2*image2^exp2 ...</p>
+<p>The format is: <var>output = wt1*image1^exp1 + wt2*image2^exp2 </var>...</p>
<p>Some simple uses are:</p>
<ul>
-<li>A weighted sum of each image provided all weights add to unity and all exponents=1. If the the weights are all equal to 1/(number of images), then this is equivalent to <a href="command-line-options.html#profile">-evaluate-sequence</a> <em class="arg">mean</em>.</li>
+<li>A weighted sum of each image provided all weights add to unity and all exponents=1. If the the weights are all equal to 1/(number of images), then this is equivalent to <a href="command-line-options.html#profile">-evaluate-sequence</a> <var>mean</var>.</li>
<li>The sum of squares of two or more images, provided the weights are equal (and sum to 1 to avoid clamping) and the exponents equal 2.</li>
</ul>
<div style="margin: auto;">
- <h4><a id="posterize"></a>-posterize <em class="arg">levels</em></h4>
+ <h3><a class="anchor" id="posterize"></a>-posterize <var>levels</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>reduce the image to a limited number of color levels per channel.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">reduce the image to a limited number of color levels per channel.</p>
-<p>Very low values of <em class="arg">levels</em>, e.g., 2, 3, 4, have the most
+<p>Very low values of <var>levels</var>, e.g., 2, 3, 4, have the most
visible effect.</p>
<div style="margin: auto;">
- <h4><a id="precision"></a>-precision <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="precision"></a>-precision <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>set the maximum number of significant digits to be printed.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">set the maximum number of significant digits to be printed.</p>
<div style="margin: auto;">
- <h4><a id="preview"></a>-preview <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="preview"></a>-preview <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>image preview type.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">image preview type.</p>
<p>Use this option to affect the preview operation of an image (e.g.
<code>convert file.png -preview Gamma Preview:gamma.png</code>). Choose from
these previews:</p>
-<pre class="text">
- Rotate Shear Roll Hue
- Saturation Brightness Gamma Spiff
- Dull Grayscale Quantize Despeckle
- ReduceNoise Add Noise Sharpen Blur
- Threshold EdgeDetect Spread Shade
- Raise Segment Solarize Swirl
- Implode Wave OilPaint CharcoalDrawing
- JPEG
-</pre>
+<pre class="pre-scrollable"><code>
+AddNoise
+Blur
+Brightness
+Charcoal
+Despeckle
+Dull
+EdgeDetect
+Gamma
+Grayscale
+Hue
+Implode
+JPEG
+OilPaint
+Quantize
+Raise
+ReduceNoise
+Roll
+Rotate
+Saturation
+Segment
+Shade
+Sharpen
+Shear
+Solarize
+Spiff
+Spread
+Swirl
+Threshold
+Wave
+</code></pre>
<p>To print a complete list of previews, use the <a href="command-line-options.html#list">-list preview</a> option.</p>
<p>The default preview is <code>JPEG</code>.</p>
<div style="margin: auto;">
- <h4><a id="print"></a>-print <em class="arg">string</em></h4>
+ <h3><a class="anchor" id="print"></a>-print <var>string</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>interpret string and print to console.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">interpret string and print to console.</p>
<div style="margin: auto;">
- <h4><a id="process"></a>-process <em class="arg">command</em></h4>
+ <h3><a class="anchor" id="process"></a>-process <var>command</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>process the image with a custom image filter.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">process the image with a custom image filter.</p>
<p>The command arguments has the form <code>"module arg1 arg2 arg3 ...
argN"</code> where <code>module</code> is the name of the module to invoke (e.g.
pass to the process module.</p>
<div style="margin: auto;">
- <h4><a id="profile"></a>-profile <em class="arg">filename</em><br/>
- +profile <em class="arg">profile_name</em></h4>
+ <h3><a class="anchor" id="profile"></a>-profile <var>filename</var><br/>
+ +profile <var>profile_name</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Manage ICM, IPTC, or generic profiles in an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Manage ICM, IPTC, or generic profiles in an image.</p>
-<p>Using <a href="command-line-options.html#profile">-profile</a> <em class="arg">filename</em> adds an
+<p>Using <a href="command-line-options.html#profile">-profile</a> <var>filename</var> adds an
ICM (ICC color management), IPTC (newswire information), or a generic profile
to the image.</p>
-<p>Use <a href="command-line-options.html#profile">+profile <em class="arg">profile_name</em></a> to
+<p>Use <a href="command-line-options.html#profile">+profile <var>profile_name</var></a> to
remove the indicated profile. ImageMagick uses standard filename globbing, so
wildcard expressions may be used to remove more than one profile. Here we
remove all profiles from the image except for the XMP profile: <code>+profile
comments).</p>
<p>To extract a profile, the <a href="command-line-options.html#profile">-profile</a> option is not
-used. Instead, simply write the file to an image format such as <em
-class="arg">APP1, 8BIM, ICM,</em> or <em class="arg">IPTC</em>.</p>
+used. Instead, simply write the file to an image format such as <var>APP1, 8BIM, ICM,</var> or <var>IPTC</var>.</p>
<p>For example, to extract the Exif data (which is stored in JPEG files in the
-<em class="arg">APP1</em> profile), use.</p>
+<var>APP1</var> profile), use.</p>
+
+<pre class="highlight"><code>convert cockatoo.jpg profile.exif
+</code></pre>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert cockatoo.jpg profile.exif</span></p>
<p>It is important to note that results may depend on whether or not the
original image already has an included profile. Also, keep in mind that <a
href="command-line-options.html#profile">-profile</a> is an "operator" (as opposed to a "setting") and
command-line. For instance, in the following example, if the original image is
CMYK with profile, a CMYK-CMYK-RGB conversion results.</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert CMYK.tif -profile "CMYK.icc" -profile "RGB.icc" RGB.tiff</span></p>
+<pre class="highlight"><code>convert CMYK.tif -profile "CMYK.icc" -profile "RGB.icc" RGB.tiff
+</code></pre>
+
<p>Furthermore, since ICC profiles are not necessarily symmetric, extra
conversion steps can yield unwanted results. CMYK profiles are often very
asymmetric since they involve 3−>4 and 4−>3 channel mapping.
</p>
<div style="margin: auto;">
- <h4><a id="quality"></a>-quality <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="quality"></a>-quality <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>JPEG/MIFF/PNG compression level.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">JPEG/MIFF/PNG compression level.</p>
<p>For the JPEG and MPEG image formats, quality is 1 (lowest image quality and
highest compression) to 100 (best quality but least effective compression).
Use the <a href="command-line-options.html#sampling-factor">-sampling-factor</a> option to specify the
factors for chroma downsampling.</p>
-<p>For the MIFF image format, quality/10 is the zlib compression level, which
-is 0 (worst but fastest compression) to 9 (best but slowest). It has no effect
-on the image appearance, since the compression is always lossless.</p>
-
<p>For the JPEG-2000 image format, quality is mapped using a non-linear
equation to the compression ratio required by the Jasper library. This
non-linear equation is intended to loosely approximate the quality provided by
<p>If filter-type is 4 or less, the specified PNG filter-type is used for
all scanlines:</p>
-<pre class="text">
- 0: none
- 1: sub
- 2: up
- 3: average
- 4: Paeth
-</pre>
+<dl class="row">
+<dt class="col-md-4">0</dt><dd class="col-md-8">none</dd>
+<dt class="col-md-4">1</dt><dd class="col-md-8">sub</dd>
+<dt class="col-md-4">2</dt><dd class="col-md-8">up</dd>
+<dt class="col-md-4">3</dt><dd class="col-md-8">average</dd>
+<dt class="col-md-4">4</dt><dd class="col-md-8">Paeth</dd>
+</dl>
<p>If filter-type is 5, adaptive filtering is used when quality is greater
than 50 and the image does not have a color map, otherwise no filtering is
used.</p>
<p>If filter-type is 6, adaptive filtering
-with <em class="arg">minimum-sum-of-absolute-values</em> is used.</p>
+with <var>minimum-sum-of-absolute-values</var> is used.</p>
<p>Only if the output is MNG, if filter-type is 7, the LOCO color
transformation (intrapixel differencing) and adaptive filtering
-with <em class="arg">minimum-sum-of-absolute-values</em> are used.</p>
+with <var>minimum-sum-of-absolute-values</var> are used.</p>
<p>If the filter-type is 8 the zlib Z_RLE compression strategy (or the
Z_HUFFMAN_ONLY strategy, when compression level is 0) is used with
<p>For further information, see
the <a href="http://www.w3.org/pub/WWW/TR">PNG</a> specification.</p>
+<p>For the MIFF and TIFF image formats, quality/10 is the <a href="command-line-options.html#compress">Zip/BZip</a> compression level, which is 0 (worst but fastest compression) to 9 (best but slowest). It has no effect on the image appearance, since the compression is always lossless.</p>
+
+<p>For the BPG image format, quality/2 is the actual BPG compression level (range from 0 to 51).</p>
+
<div style="margin: auto;">
- <h4><a id="quantize"></a>-quantize <em class="arg">colorspace</em></h4>
+ <h3><a class="anchor" id="quantize"></a>-quantize <var>colorspace</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>reduce colors using this colorspace.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">reduce colors using this colorspace.</p>
<p>This setting defines the colorspace used to sort out and reduce the number
of colors needed by an image (for later dithering) by operators such as <a
<div style="margin: auto;">
- <h4><a id="quiet"></a>-quiet</h4>
+ <h3><a class="anchor" id="quiet"></a>-quiet</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>suppress all warning messages. Error messages are still reported.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">suppress all warning messages. Error messages are still reported.</p>
<div style="margin: auto;">
- <h4><a id="radial-blur"></a>-radial-blur <em class="arg">angle</em></h4>
+ <h3><a class="anchor" id="radial-blur"></a>-radial-blur <var>angle</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Blur around the center of the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Blur around the center of the image.</p>
<p>Note that this is actually a rotational blur rather than a radial and as
such actually mis-named. </p>
<div style="margin: auto;">
- <h4><a id="raise"></a>-raise <em class="arg">thickness</em></h4>
+ <h3><a class="anchor" id="raise"></a>-raise <var>thickness</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Lighten or darken image edges.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Lighten or darken image edges.</p>
<p>This will create a 3-D effect. Use <a href="command-line-options.html#raise">-raise</a> to create
a raised effect, otherwise use <a href="command-line-options.html#raise">+raise</a>. </p>
href="command-line-options.html#raise">-raise</a> does not alter the dimensions of the image.</p>
<div style="margin: auto;">
- <h4><a id="random-threshold"></a>-random-threshold <em class="arg">low</em>x<em class="arg">high</em></h4>
+ <h3><a class="anchor" id="random-threshold"></a>-random-threshold <var>low</var>x<var>high</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Apply a random threshold to the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Apply a random threshold to the image.</p>
+
+<div style="margin: auto;">
+ <h3><a class="anchor" id="read-mask"></a>-read-mask
+<var>filename</var></h3>
+</div>
+
+<p class="magick-description">Prevent updates to image pixels specified by the mask.</p>
+
+<p>This the same as using a mask used for composite masking operations, with
+grayscale values causing blended updates of the image the mask is attached to.
+</p>
+
+<p>Use <a href="command-line-options.html#read-mask">+read-mask</a> to remove the mask from images.</p>
+
+<p>Also see <a href="command-line-options.html#clip-mask">-clip-mask</a> which work in the same way,
+but with strict boolean masking. </p>
<div style="margin: auto;">
- <h4><a id="red-primary"></a>-red-primary <em class="arg">x,y</em></h4>
+ <h3><a class="anchor" id="red-primary"></a>-red-primary <var>x,y</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the red chromaticity primary point.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set the red chromaticity primary point.</p>
<div style="margin: auto;">
- <h4><a id="regard-warnings"></a>-regard-warnings</h4>
+ <h3><a class="anchor" id="regard-warnings"></a>-regard-warnings</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Pay attention to warning messages.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Pay attention to warning messages.</p>
<p>This option causes some warnings in some image formats to be treated
as errors. </p>
<div style="margin: auto;">
- <h4><a id="remap"></a>-remap <em class="arg">filename</em></h4>
+ <h3><a class="anchor" id="remap"></a>-remap <var>filename</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Reduce the number of colors in an image to the colors used by this image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Reduce the number of colors in an image to the colors used by this image.</p>
<p>If the <a href="command-line-options.html#dither">-dither</a> setting is enabled (the default) then
the given colors are dithered over the image as necessary, otherwise the closest
<p>Note, the remap image colormap has at most 8-bits of precision. Deeper color maps are automagically coalesced with other colors to meet this requirement.</p>
<div style="margin: auto;">
- <h4><a id="region"></a>-region <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="region"></a>-region <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set a region in which subsequent operations apply.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set a region in which subsequent operations apply.</p>
-<p>The <em class="arg">x</em> and <em class="arg">y</em> offsets are treated
+<p>The <var>x</var> and <var>y</var> offsets are treated
in the same manner as in <a href="command-line-options.html#crop">-crop</a>.</p>
<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
+<p>Use <code>+region</code> to remove any previously set regions.</p>
+
<div style="margin: auto;">
- <h4><a id="remote"></a>-remote</h4>
+ <h3><a class="anchor" id="remote"></a>-remote</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>perform a remote operation.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">perform a remote operation.</p>
<p>The only command recognized is the name of an image file to load.</p>
specify which application to control.</p>
<div style="margin: auto;">
- <h4><a id="render"></a>-render</h4>
+ <h3><a class="anchor" id="render"></a>-render</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>render vector operations.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">render vector operations.</p>
<p>Use <a href="command-line-options.html#render">+render</a> to turn off rendering vector operations.
This useful when saving the result to vector formats such as MVG or SVG.</p>
<div style="margin: auto;">
-<h4><a id="repage"></a>-repage <em class="arg">geometry</em></h4>
+<h3><a class="anchor" id="repage"></a>-repage <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Adjust the canvas and offset information of the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Adjust the canvas and offset information of the image.</p>
<p>This option is like <a href="command-line-options.html#page">-page</a> but acts as an image operator
rather than a setting. You can separately set the canvas size or the offset
<div style="margin: auto;">
- <h4><a id="resample"></a>-resample <em class="arg">horizontal</em>x<em class="arg">vertical</em></h4>
+ <h3><a class="anchor" id="resample"></a>-resample <var>horizontal</var>x<var>vertical</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Resample image to specified horizontal and vertical resolution.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Resample image to specified horizontal and vertical resolution.</p>
<p>Resize the image so that its rendered size remains the same as the original
at the specified target resolution. For example, if a 300 DPI image renders at
resolution specified in the standard file header.</p>
<div style="margin: auto;">
- <h4><a id="resize"></a>-resize <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="resize"></a>-resize <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Resize an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Resize an image.</p>
<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. Offsets, if present in the geometry string, are
ignored, and the <a href="command-line-options.html#gravity">-gravity</a> option has no effect.</p>
coding. If your image is gamma-corrected, you can remove the nonlinear gamma
correction, apply the transform, then restore it like this:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert portrait.jpg -gamma .45455 -resize 25% -gamma 2.2 \ <br/> -quality 92 passport.jpg</span></p>
+<pre class="highlight"><code>convert portrait.jpg -gamma .45455 -resize 25% -gamma 2.2 \
+ -quality 92 passport.jpg
+</code></pre>
+
<div style="margin: auto;">
- <h4><a id="respect-parentheses"></a>-respect-parentheses</h4>
+ <h3><a class="anchor" id="respect-parentheses"></a>-respect-parentheses</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>settings remain in effect until parenthesis boundary.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">settings remain in effect until parenthesis boundary.</p>
<div style="margin: auto;">
- <h4><a id="reverse"></a>-reverse</h4>
+ <h3><a class="anchor" id="reverse"></a>-reverse</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Reverse the order of images in the current image list.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Reverse the order of images in the current image list.</p>
<div style="margin: auto;">
- <h4><a id="roll"></a>-roll {<em class="arg">+-</em>}<em class="arg">x</em>{<em class="arg">+-</em>}<em class="arg">y</em></h4>
+ <h3><a class="anchor" id="roll"></a>-roll {<var>+-</var>}<var>x</var>{<var>+-</var>}<var>y</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>roll an image vertically or horizontally by the amount given.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">roll an image vertically or horizontally by the amount given.</p>
-<p>A negative <em class="arg">x</em> offset rolls the image right-to-left.
-A negative <em class="arg">y</em> offset rolls the image bottom-to-top.</p>
+<p>A negative <var>x</var> offset rolls the image right-to-left.
+A negative <var>y</var> offset rolls the image bottom-to-top.</p>
<div style="margin: auto;">
- <h4><a id="rotate"></a>-rotate <em class="arg">degrees</em>{<em class="arg"><</em>}{<em class="arg">></em>}</h4>
+ <h3><a class="anchor" id="rotate"></a>-rotate <var>degrees</var>{<var><</var>}{<var>></var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Apply Paeth image rotation (using shear operations) to the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Apply Paeth image rotation (using shear operations) to the image.</p>
<p>Use <code>></code> to rotate the image only if its width exceeds the
-height. <code><</code> rotates the image <em>only</em> if its width is less
+height. <code><</code> rotates the image <var>only</var> if its width is less
than the height. For example, if you specify <code>-rotate "-90>"</code> and
the image size is 480x640, the image is not rotated. However, if the image is
640x480, it is rotated by -90 degrees. If you use <code>></code> or
<div style="margin: auto;">
- <h4><a id="sample"></a>-sample <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="sample"></a>-sample <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>minify / magnify the image with pixel subsampling and pixel replication, respectively.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">minify / magnify the image with pixel subsampling and pixel replication, respectively.</p>
<p>Change the image size simply by directly sampling the pixels original
from the image. When magnifying, pixels are replicated in blocks. When
<p>The results are thus equivalent to using <a href="command-line-options.html#resize">-resize</a> with
a <a href="command-line-options.html#filter">-filter</a> setting of <code>point</code> (nearest
-neighbour), though <a href="command-line-options.html#sample">-sample</a> is a lot faster, as it
+neighbor), though <a href="command-line-options.html#sample">-sample</a> is a lot faster, as it
avoids all the filter processing of the image. As such it completely ignores
the current <a href="command-line-options.html#filter">-filter</a> setting. </p>
<div style="margin: auto;">
- <h4><a id="sampling-factor"></a>-sampling-factor <em class="arg">horizontal-factor</em>x<em class="arg">vertical-factor</em></h4>
+ <h3><a class="anchor" id="sampling-factor"></a>-sampling-factor <var>horizontal-factor</var>x<var>vertical-factor</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encoder.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encoder.</p>
<p>This option specifies the sampling factors to be used by the JPEG encoder
for chroma downsampling. If this option is omitted, the JPEG library will use
downsampling method.</p>
<div style="margin: auto;">
- <h4><a id="scale"></a>-scale <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="scale"></a>-scale <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>minify / magnify the image with pixel block averaging and pixel replication, respectively.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">minify / magnify the image with pixel block averaging and pixel replication, respectively.</p>
<p>Change the image size simply by replacing pixels by averaging pixels
together when minifying, or replacing pixels when magnifying. </p>
<div style="margin: auto;">
- <h4><a id="scene"></a>-scene <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="scene"></a>-scene <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>set scene number.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">set scene number.</p>
<p>This option sets the scene number of an image or the first image in an image sequence.</p>
<div style="margin: auto;">
- <h4><a id="screen"></a>-screen</h4>
+ <h3><a class="anchor" id="screen"></a>-screen</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>specify the screen to capture.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">specify the screen to capture.</p>
<p>This option indicates that the GetImage request used to obtain the image
should be done on the root window, rather than directly on the specified
that are independent windows but appear over the specified window.</p>
<div style="margin: auto;">
- <h4><a id="seed"></a>-seed</h4>
+ <h3><a class="anchor" id="seed"></a>-seed</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>seed a new sequence of pseudo-random numbers</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">seed a new sequence of pseudo-random numbers</p>
<div style="margin: auto;">
- <h4><a id="segment"></a>-segment <em class="arg">cluster-threshold</em>x<em class="arg">smoothing-threshold</em></h4>
+ <h3><a class="anchor" id="segment"></a>-segment <var>cluster-threshold</var>x<var>smoothing-threshold</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>segment the colors of an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">segment the colors of an image.</p>
<p>Segment an image by analyzing the histograms of the color components and
identifying units that are homogeneous with the fuzzy c-means technique. This
is part of the ImageMagick color quantization routines. </p>
-<p>Specify <em class="arg">cluster threshold</em> as the number of pixels in
+<p>Specify <var>cluster threshold</var> as the number of pixels in
each cluster that must exceed the cluster threshold to be considered valid.
-<em class="arg">Smoothing threshold</em> eliminates noise in the second
+<var>Smoothing threshold</var> eliminates noise in the second
derivative of the histogram. As the value is increased, you can expect
a smoother second derivative. The default is 1.5.</p>
<div style="margin: auto;">
- <h4><a id="selective-blur"></a>-selective-blur <em class="arg">radius</em><br />-selective-blur <em class="arg">radius</em>x<em class="arg">sigma</em>{<em class="arg">+threshold</em>}</h4>
+ <h3><a class="anchor" id="selective-blur"></a>-selective-blur <var>radius</var><br />-selective-blur <var>radius</var>x<var>sigma</var>{<var>+threshold</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Selectively blur pixels within a contrast threshold.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Selectively blur pixels within a contrast threshold.</p>
<p>Blurs those pixels that are less than or equal to the threshold in
-contrast. The threshold may be expressed as a fraction of <em
-class="QR">QuantumRange</em> or as a percentage.</p>
+contrast. The threshold may be expressed as a fraction of <var>QuantumRange</var> or as a percentage.</p>
<div style="margin: auto;">
- <h4><a id="separate"></a>-separate</h4>
+ <h3><a class="anchor" id="separate"></a>-separate</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>separate an image channel into a grayscale image. Specify the channel with <a href="command-line-options.html#channel">-channel</a>.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">separate an image channel into a grayscale image. Specify the channel with <a href="command-line-options.html#channel">-channel</a>.</p>
<div style="margin: auto;">
- <h4><a id="sepia-tone"></a>-sepia-tone <em class="arg">threshold</em></h4>
+ <h3><a class="anchor" id="sepia-tone"></a>-sepia-tone <var>percent-threshold</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>simulate a sepia-toned photo.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">simulate a sepia-toned photo.</p>
-<p>Specify <em class="arg">threshold</em> as the percent threshold of the intensity (0 - 99.9%).</p>
+<p>Specify <var>threshold</var> as the percent threshold of the intensity (0 - 99.9%).</p>
<p>This option applies a special effect to the image, similar to the effect
-achieved in a photo darkroom by sepia toning. Threshold ranges from 0 to <em
-class="QR">QuantumRange</em> and is a measure of the extent of the sepia
+achieved in a photo darkroom by sepia toning. Threshold ranges from 0 to <var>QuantumRange</var> and is a measure of the extent of the sepia
toning. A threshold of 80% is a good starting point for a reasonable
tone.</p>
<div style="margin: auto;">
- <h4><a id="set"></a>-set <em class="arg">key value</em></h4>
- <h4>+set <em class="arg">key</em></h4>
+ <h3><a class="anchor" id="set"></a>-set <var>key value</var></h3>
+ <h3>+set <var>key</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>sets image attributes and properties for images in the current
-image sequence.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">sets image attributes and properties for images in the current image sequence.</p>
<p>This will assign (or modify) specific settings attached to all the images
in the current image sequence. Using the <a href="command-line-options.html#set">+set</a> form of the
'attributes' such as those normally overridden by: the options <a
href="command-line-options.html#delay" >-delay</a>, <a href="command-line-options.html#dispose" >-dispose</a>, and <a
href="command-line-options.html#page" >-page</a>, <a href="command-line-options.html#colorspace" >-colorspace</a>; generally
-assigned before the image is read in, by using a <em class="arg">key</em> of
+assigned before the image is read in, by using a <var>key</var> of
the same name. </p>
-<p>If the given <em class="arg">key</em> does not match a specific known
+<p>If the given <var>key</var> does not match a specific known
'attribute ', such as shown above, the setting is stored as a a free form
'property' string. Such settings are listed in <a href="command-line-options.html#verbose"
>-verbose</a> information ("<code>info:</code>" output format) as "Properties".
a global 'artifact' which are automatically assigned (and any <a href="escape.html" >Format Percent
Escapes</a> expanded) to images as they are read in. For example:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert rose: -set comment 'Rose is a rose is a rose is a rose' rose.png</span><span class='crtout'>identify -format %c rose.png</span><span class="crtprompt"> $magick> </span><span class='crtin'>Rose is a rose is a rose is a rose</span></p>
+<pre class="highlight"><code>-> convert rose: -set comment 'Rose is a rose is a rose is a rose' rose.png
+identify -format %c rose.png
+Rose is a rose is a rose is a rose
+</code></pre>
+
<p>The set value can also make use of <a href="escape.html" >Format and Print Image
Properties</a> in the defined value. For example:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert rose: -set origsize '%wx%h' -resize 50% \</span><span class='crtout'> -format 'Old size = %[origsize] New size = %wx%h' info:</span><span class="crtprompt"> $magick> </span><span class='crtin'>Old size = 70x46 New size = 35x23</span></p>
-<p>Other well known 'properties' that are availible include:
+<pre class="highlight"><code>-> convert rose: -set origsize '%wx%h' -resize 50% \
+ -format 'Old size = %[origsize] New size = %wx%h' info:
+Old size = 70x46 New size = 35x23
+</code></pre>
+
+<p>Other well known 'properties' that are available include:
'<code>date:create</code>' and '<code>date:modify</code>' and
'<code>signature</code>'. </p>
<p>This option can also associate a colorspace or profile with your image.
For example,</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert image.psd -set profile ISOcoated_v2_eci.icc image-icc.psd</span></p>
+<pre class="highlight"><code>convert image.psd -set profile ISOcoated_v2_eci.icc image-icc.psd
+</code></pre>
+
<p>Some 'properties' must be defined in a specific way to be used. For
example only 'properties' prefixed with "<code>filename:</code>" can be used to
modify the output filename of an image. For example</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert rose: -set filename:mysize '%wx%h' 'rose_%[filename:mysize].png'</span></p>
+<pre class="highlight"><code>convert rose: -set filename:mysize '%wx%h' 'rose_%[filename:mysize].png'
+</code></pre>
+
<p>If the setting value is prefixed with "<code>option:</code>" the setting will
be saved as a global "Artifact" exactly as if it was set using the <a
href="command-line-options.html#define" >-define</a> option. As such settings are global in scope, they
in a way that allows you to use them in a completely different image, even if
the original image has long since been modified or destroyed. For example: </p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert rose: -set option:rosesize '%wx%h' -delete 0 \</span><span class='crtout'> label:'%[rosesize]' label_size_of_rose.gif</span></p>
+<pre class="highlight"><code>convert rose: -set option:rosesize '%wx%h' -delete 0 \
+ label:'%[rosesize]' label_size_of_rose.gif"
+</code></pre>
+
<p>Note that <a href="escape.html" >Format Percent Escapes</a> will only match
-a 'artifact' if the given <em class="arg">key</em> does not match an existing
+a 'artifact' if the given <var>key</var> does not match an existing
'attribute' or 'property'. </p>
<p>You can set the attributes of the image registry by prefixing the value
the commandline option as shown below or by setting the profile via a
programming interface:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert in.png -set profile PNG-chunk-x:<filename> out.png</span></p>
-<p>where <em>x</em> is a location flag and
-<em class="arg">filename</em> is a file containing the chunk
+<pre class="highlight"><code>convert in.png -set profile PNG-chunk-x:<filename> out.png
+</code></pre>
+
+<p>where <var>x</var> is a location flag and
+<var>filename</var> is a file containing the chunk
name in the first 4 bytes, then a colon (":"), followed by the chunk data.
This encoder will compute the chunk length and CRC, so those must not
be included in the file.</p>
subsequent profiles from overwriting the preceding ones, e.g.,</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert in.png -set profile PNG-chunk-b01:file01 / <br/>
- -profile PNG-chunk-b02:file02 out.png</span></p>
+<pre class="highlight"><code>convert in.png -set profile PNG-chunk-b01:file01 \
+ -profile PNG-chunk-b02:file02 out.png
+</code></pre>
<div style="margin: auto;">
- <h4><a id="shade"></a>-shade <em class="arg">azimuth</em>x<em class="arg">elevation</em></h4>
+ <h3><a class="anchor" id="shade"></a>-shade <var>azimuth</var>x<var>elevation</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>shade the image using a distant light source.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">shade the image using a distant light source.</p>
-<p>Specify <em class="arg">azimuth</em> and <em class="arg">elevation</em> as
+<p>Specify <var>azimuth</var> and <var>elevation</var> as
the position of the light source. Use <a href="command-line-options.html#shade">+shade</a> to return
the shading results as a grayscale image.</p>
<div style="margin: auto;">
- <h4><a id="shadow"></a>-shadow <em class="arg">percent-opacity</em>{x<em class="arg">sigma</em>}{<em class="arg">+-</em>}<em class="arg">x</em>{<em class="arg">+-</em>}<em class="arg">y</em>{<em class="arg">%</em>}</h4>
+ <h3><a class="anchor" id="shadow"></a>-shadow <var>percent-opacity</var>{x<var>sigma</var>}{<var>+-</var>}<var>x</var>{<var>+-</var>}<var>y</var>{<var>%</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>simulate an image shadow.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">simulate an image shadow.</p>
<div style="margin: auto;">
- <h4><a
-id="shared-memory"></a>-shared-memory</h4>
+ <h3><a
+id="shared-memory"></a>-shared-memory</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>use shared memory.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">use shared memory.</p>
<p>This option specifies whether the utility should attempt to use shared
memory for pixmaps. ImageMagick must be compiled with shared memory support,
-and the display must support the <em class="arg">MIT-SHM</em> extension.
+and the display must support the <var>MIT-SHM</var> extension.
Otherwise, this option is ignored. The default is <code>True</code>.</p>
<div style="margin: auto;">
- <h4><a id="sharpen"></a>-sharpen <em class="arg">radius</em><br />-sharpen <em class="arg">radius</em>x<em class="arg">sigma</em></h4>
+ <h3><a class="anchor" id="sharpen"></a>-sharpen <var>radius</var><br />-sharpen <var>radius</var>x<var>sigma</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>sharpen the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">sharpen the image.</p>
<p>Use a Gaussian operator of the given radius and standard deviation (sigma).</p>
<div style="margin: auto;">
- <h4><a id="shave"></a>-shave <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="shave"></a>-shave <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Shave pixels from the image edges.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Shave pixels from the image edges.</p>
-<p>The <em class="arg">size</em> portion of the <em class="arg">geometry</em>
+<p>The <var>size</var> portion of the <var>geometry</var>
argument specifies the width of the region to be removed from both sides of
the image and the height of the regions to be removed from top and bottom.
Offsets are ignored.</p>
<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
<div style="margin: auto;">
- <h4><a id="shear"></a>-shear <em class="arg">Xdegrees</em>[x<em class="arg">Ydegrees</em>]</h4>
+ <h3><a class="anchor" id="shear"></a>-shear <var>Xdegrees</var>[x<var>Ydegrees</var>]</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Shear the image along the x-axis and/or y-axis.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Shear the image along the x-axis and/or y-axis.</p>
-<p>The shear angles may be positive, negative, or zero. When <em
-class="arg">Ydegrees</em> is omitted it defaults to 0. When both angles are
+<p>The shear angles may be positive, negative, or zero. When <var>Ydegrees</var> is omitted it defaults to 0. When both angles are
given, the horizontal component of the shear is performed before the vertical
component.</p>
<p>Shearing slides one edge of an image along the x-axis or y-axis (i.e.,
horizontally or vertically, respectively),creating a parallelogram. The amount
of each is controlled by the respective shear angle. For horizontal shears,
-<em class="arg">Xdegrees</em> is measured clockwise relative to "up" (the
-negative y-axis), sliding the top edge to the right when 0°<<em
-class="arg">Xdegrees</em><90° and to the left when 90°<<em
-class="arg">Xdegrees</em><180°. For vertical shears <em
-class="arg">Ydegrees</em> is measured clockwise relative to "right" (the
-positive x-axis), sliding the right edge down when 0°<<em
-class="arg">Ydegrees</em><90° and up when 90°<<em
-class="arg">Ydegrees</em><180°.</p>
+<var>Xdegrees</var> is measured clockwise relative to "up" (the
+negative y-axis), sliding the top edge to the right when 0°<<var>Xdegrees</var><90° and to the left when 90°<<var>Xdegrees</var><180°. For vertical shears <var>Ydegrees</var> is measured clockwise relative to "right" (the
+positive x-axis), sliding the right edge down when 0°<<var>Ydegrees</var><90° and up when 90°<<var>Ydegrees</var><180°.</p>
<p>Empty triangles left over from shearing the image are filled with the color
defined by the <a href="command-line-options.html#fill">-background</a> option. The color is specified
<p>The horizontal shear is performed before the vertical part. This is
important to note, since horizontal and vertical shears do not
-<em>commute</em>, i.e., the order matters in a sequence of shears. For
+<var>commute</var>, i.e., the order matters in a sequence of shears. For
example, the following two commands are not equivalent.</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert logo: -shear 20x0 -shear 0x60 logo-sheared.png</span><span class='crtout'></span><span class="crtprompt"> $magick> </span><span class='crtin'>convert logo: -shear 0x60 -shear 20x0 logo-sheared.png</span></p>
+<pre class="highlight"><code>convert logo: -shear 20x0 -shear 0x60 logo-sheared.png
+convert logo: -shear 0x60 -shear 20x0 logo-sheared.png
+</code></pre>
+
<p>The first of the two commands above is equivalent to the following, except
for the amount of empty space created; the command that follows generates
a smaller image, and so is a better choice in terms of time and space.</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert logo: -shear 20x60 logo-sheared.png</span></p>
+<pre class="highlight"><code>convert logo: -shear 20x60 logo-sheared.png
+</code></pre>
+
<div style="margin: auto;">
- <h4><a id="sigmoidal-contrast"></a>-sigmoidal-contrast <em class="arg">contrast</em>x<em class="arg">mid-point</em></h4>
+ <h3><a class="anchor" id="sigmoidal-contrast"></a>-sigmoidal-contrast <var>contrast</var>x<var>mid-point</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>increase the contrast without saturating highlights or shadows.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">increase the contrast without saturating highlights or shadows.</p>
<p>Increase the contrast of the image using a sigmoidal transfer function
-without saturating highlights or shadows. <em class="arg">Contrast</em>
+without saturating highlights or shadows. <var>Contrast</var>
indicates how much to increase the contrast. For example, 0 is none, 3 is
typical and 20 is a lot.
</p>
-<p>The <em class="arg">mid-point</em> indicates where the maximum change
+<p>The <var>mid-point</var> indicates where the maximum change
'slope' in contrast should fall in the resultant image (0 is white; 50% is
middle-gray; 100% is black). </p>
-<p>By default the image contrast is increased, use <em
-class="arg">+sigmoidal-contrast</em> to decrease the contrast.</p>
+<p>By default the image contrast is increased, use <var>+sigmoidal-contrast</var> to decrease the contrast.</p>
-<p>To achieve the equivalent of a sigmoidal brightness change (similar to
-a gamma adjustment), you would use <em class="arg">-sigmoidal-contrast
-{brightness}x0%</em> to increase brightness and <em
-class="arg">+sigmoidal-contrast {brightness}x0%</em> to decrease brightness.
+<p>To achieve the equivalent of a sigmoidal brightness change (similar to
+a gamma adjustment), you would use <var>-sigmoidal-contrast
+{brightness}x0%</var> to increase brightness and <var>+sigmoidal-contrast {brightness}x0%</var> to decrease brightness.
Note the use of '0' fo rthe mid-point of the sigmoidal curve. </p>
-<p>Using a very high <em class="arg">contrast</em> will produce a sort of
+<p>Using a very high <var>contrast</var> will produce a sort of
'smoothed thresholding' of the image. Not as sharp (with high aliasing
effects) of a true threshold, but with tapered gray-levels around the threshold
-<em class="arg">mid-point</em>. </p>
+<var>mid-point</var>. </p>
<div style="margin: auto;">
- <h4><a id="silent"></a>-silent</h4>
+ <h3><a class="anchor" id="silent"></a>-silent</h3>
+
+
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>operate silently.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">operate silently. This option is only used
+by the <a href="import.html">import</a> tool.</p>
<div style="margin: auto;">
- <h4><a id="similarity-threshold"></a>-similarity-threshold <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="similarity-threshold"></a>-similarity-threshold <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>minimum RMSE for subimage match.</td><td style='text-align:right;'>[<a href="compare.html">compare</a>]</td></tr></table>
+<p class="magick-description">minimum RMSE for subimage match.</p>
-<p>If this setting is used, then the search will stop as soon as it finds a match whose metric is less than or equal to the value. A partially filled second output image will result. Using a value of zero, will cause the search to stop at the first perfect match it finds. If this setting is left off, then the search will proceed to completion or as limited by <em class="arg">-dissimilarity-threshold</em>.</p>
+<p>If this setting is used, then the search will stop as soon as it finds a match whose metric is less than or equal to the value. A partially filled second output image will result. Using a value of zero, will cause the search to stop at the first perfect match it finds. If this setting is left off, then the search will proceed to completion or as limited by <var>-dissimilarity-threshold</var>.</p>
<div style="margin: auto;">
- <h4><a id="size"></a>-size <em class="arg">width</em>[x<em class="arg">height</em>][<em class="arg">+offset</em>]</h4>
+ <h3><a class="anchor" id="size"></a>-size <var>width</var>[x<var>height</var>][<var>+offset</var>]</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>set the width and height of the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">set the width and height of the image.</p>
<p>Use this option to specify the width and height of raw images whose
dimensions are unknown such as <code>GRAY</code>, <code>RGB</code>, or
<p>For Photo CD images, choose from these sizes:</p>
-<pre class="text">
- 192x128
- 384x256
- 768x512
- 1536x1024
- 3072x2048
-</pre>
+<pre class="highlight"><code>192x128
+384x256
+768x512
+1536x1024
+3072x2048
+</code></pre>
<div style="margin: auto;">
- <h4><a id="sketch"></a>-sketch <em class="arg">radius</em><br />-sketch <em class="arg">radius</em>x<em class="arg">sigma</em>+<em class="arg">angle</em></h4>
+ <h3><a class="anchor" id="sketch"></a>-sketch <var>radius</var><br />-sketch <var>radius</var>x<var>sigma</var>+<var>angle</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>simulate a pencil sketch.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">simulate a pencil sketch.</p>
<p>Sketch with the given radius, standard deviation (sigma), and angle. The
angle given is the angle toward which the image is sketched. That is the
direction people would consider the object is coming from. </p>
<div style="margin: auto;">
- <h4><a id="smush"></a>-smush <em class="arg">offset</em></h4>
+ <h3><a class="anchor" id="smush"></a>-smush <var>offset</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>smush an image sequence together.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">appends an image sequence together ignoring transparency.</p>
+
+<p>Smush is a more flexible version of <a href="command-line-options.html#append">-append</a>, joining the images in the sequence top-to-bottom (<a href="command-line-options.html#smush">-smush</a>) or left-to-right (<a href="command-line-options.html#smush">+smush</a>), with a gap between images according to the specified offset.</p>
+
+<p>If the offset is negative, images will overlap by that amount.</p>
+
+<p><a href="command-line-options.html#smush">-smush</a> respects <a href="command-line-options.html#gravity">-gravity</a>. Any empty space will be filled with the <a href="command-line-options.html#background">-background</a> color.</p>
+
+<p>For zero offset and transparent images, the non-transparent parts of the two images will be aligned as close as possible without overlapping.</p>
<div style="margin: auto;">
- <h4><a id="snaps"></a>-snaps <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="snaps"></a>-snaps <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the number of screen snapshots.</td><td style='text-align:right;'>[<a href="import.html">import</a>]</td></tr></table>
+<p class="magick-description">Set the number of screen snapshots.</p>
<p>Use this option to grab more than one image from the X server screen, to create an animation sequence.</p>
<div style="margin: auto;">
- <h4><a id="solarize"></a>-solarize <em class="arg">threshold</em></h4>
+ <h3><a class="anchor" id="solarize"></a>-solarize <var>percent-threshold</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>negate all pixels above the threshold level.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">negate all pixels above the threshold level.</p>
-<p>Specify <em class="arg">factor</em> as the percent threshold of the intensity (0 - 99.9%).</p>
+<p>Specify <var>factor</var> as the percent threshold of the intensity (0 - 99.9%).</p>
-<p>This option produces a <em class="arg">solarization</em> effect seen when
+<p>This option produces a <var>solarization</var> effect seen when
exposing a photographic film to light during the development process.</p>
<div style="margin: auto;">
- <h4><a id="sparse-color"></a>-sparse-color <em
- class="arg">method</em> '<em class="arg">x</em>,<em class="arg">y</em> <em class="arg">color</em> ...'</h4>
+ <h3><a class="anchor" id="sparse-color"></a>-sparse-color <var>method</var> '<var>x</var>,<var>y</var> <var>color</var> ...'</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'> color the given image using the specified points of color, and filling the other intervening colors using the given methods. </td><td style='text-align:right;'></td></tr></table>
-
+<p class="magick-description"> color the given image using the specified points of color, and filling the other intervening colors using the given methods. </p>
-<table class="doc">
- <tbody>
- <tr valign="top">
- <th align="left" style="width: 8%">Method</th>
- <th align="left">Description</th>
- </tr>
- <tr valign="top">
- <td valign="top">barycentric</td>
- <td valign="top">three point triangle of color given 3 points.
+<dl class="row">
+ <dt class="col-md-4">barycentric</dt>
+ <dd class="col-md-8">three point triangle of color given 3 points.
Giving only 2 points will form a linear gradient between those points.
The gradient generated extends beyond the triangle created by those
- 3 points. </td>
- </tr>
-
- <tr valign="top">
- <td valign="top">bilinear</td>
- <td valign="top">Like barycentric but for 4 points. Less than 4 points
- fall back to barycentric. </td>
- </tr>
- <tr valign="top">
- <td valign="top">voronoi</td>
- <td valign="top">Simply map each pixel to the to nearest color point
- given. The result are polygonal 'cells' of solid color. </td>
- </tr>
-
- <tr valign="top">
- <td valign="top">shepards</td>
- <td valign="top">Colors points biased on the ratio of inverse distance
+ 3 points. </dd>
+ <dt class="col-md-4">bilinear</dt>
+ <dd class="col-md-8">Like barycentric but for 4 points. Less than 4 points
+ fall back to barycentric. </dd>
+ <dt class="col-md-4">voronoi</dt>
+ <dd class="col-md-8">Simply map each pixel to the to nearest color point
+ given. The result are polygonal 'cells' of solid color. </dd>
+ <dt class="col-md-4">manhattan</dt>
+ <dd class="col-md-8">Like voronoi, but resulting polygonal 'cells' are mapped to a fixed coordinate system.</dd>
+ <dt class="col-md-4">shepards</dt>
+ <dd class="col-md-8">Colors points biased on the ratio of inverse distance
squared. Generating spots of color in a sea of the average of
- colors. </td>
- </tr>
-
- <tr valign="top">
- <td valign="top">inverse</td>
- <td valign="top">Colors points biased on the ratio of inverse distance.
+ colors. </dd>
+ <dt class="col-md-4">inverse</dt>
+ <dd class="col-md-8">Colors points biased on the ratio of inverse distance.
This generates sharper points of color rather than rounded spots of
'<code>shepards</code>' Generating spots of color in a sea of the
- average of colors. </td>
- </tr>
-
- </tbody>
-</table>
+ average of colors. </dd>
+</dl>
<p>The points are placed according to the images location on the virtual
canvas (<a href="command-line-options.html#page" >-page</a> or <a href="command-line-options.html#repage" >-repage</a>
<p>Only the color channels defined by the <a href="command-line-options.html#channel" >-channel</a> are
modified, which means that by default matte/alpha transparency channel is not
-effected. Typically transparency channel is turned off either before or after
+affected. Typically transparency channel is turned off either before or after
the operation. </p>
<p>Of course if some color points are transparent to generate a transparent
<div style="margin: auto;">
- <h4><a id="splice"></a>-splice <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="splice"></a>-splice <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Splice the current background color into the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Splice the current background color into the image.</p>
<p>This will add rows and columns of the current <a
href="command-line-options.html#background">-background</a> color into the given image according to the
-given <a href="command-line-options.html#gravity">-gravity</a> geometry setting. >See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. Essentially <a href="command-line-options.html#splice">-splice</a> will divide the
+given <a href="command-line-options.html#gravity">-gravity</a> geometry setting. See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. Essentially <a href="command-line-options.html#splice">-splice</a> will divide the
image into four quadrants, separating them by the inserted rows and columns.
</p>
the image, padding the image only along that one edge. Edge padding is what <a
href="command-line-options.html#splice">-splice</a> is most commonly used for. </p>
-<p>If the exact same <em class="arg">geometry</em> and <a
+<p>If the exact same <var>geometry</var> and <a
href="command-line-options.html#gravity">-gravity</a> is later used with <a href="command-line-options.html#chop">-chop</a> the
added added all splices removed. </p>
<div style="margin: auto;">
- <h4><a id="spread"></a>-spread <em class="arg">amount</em></h4>
+ <h3><a class="anchor" id="spread"></a>-spread <var>amount</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>displace image pixels by a random amount.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">displace image pixels by a random amount.</p>
-<p>The argument <em class="arg">amount</em> defines the size of the
+<p>The argument <var>amount</var> defines the size of the
neighborhood around each pixel from which to choose a candidate pixel to
-swap.</p>
+blend.</p>
+
+<p>The lookup is controlled by the <a href="command-line-options.html#interpolate">-interpolate</a> setting.</p>
<div style="margin: auto;">
- <h4><a id="statistic"></a>-statistic <em class="arg">type</em> <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="statistic"></a>-statistic <var>type</var> <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>replace each pixel with corresponding statistic from the neighborhood.</td><td style='text-align:right;'>[<a href="convert.html">convert</a>, <a href="mogrify.html">mogrify</a>]</td></tr></table>
+<p class="magick-description">replace each pixel with corresponding statistic from the neighborhood.</p>
<p>Choose from these statistic types:</p>
-<pre class="text">
- Gradient maximum difference (max - min) value in neighborhood
- Maximum maximum value per channel in neighborhood
- Minimum minimum value per channel in neighborhood
- Mean average value per channel in neighborhood
- Median median value per channel in neighborhood
- Mode mode (most frequent) value per channel in neighborhood
- Nonpeak value just before or after the median value per channel in neighborhood
- RMS root mean square value per channel in neighborhood
- StandardDeviation standard deviation value per channel in neighborhood
-</pre>
+<dl class="row">
+<dt class="col-md-4">Gradient</dt><dd class="col-md-8">maximum difference (max - min) value in neighborhood</dd>
+<dt class="col-md-4">Maximum</dt><dd class="col-md-8">maximum value per channel in neighborhood</dd>
+<dt class="col-md-4">Minimum</dt><dd class="col-md-8">minimum value per channel in neighborhood</dd>
+<dt class="col-md-4">Mean</dt><dd class="col-md-8">average value per channel in neighborhood</dd>
+<dt class="col-md-4">Median</dt><dd class="col-md-8">median value per channel in neighborhood</dd>
+<dt class="col-md-4">Mode</dt><dd class="col-md-8">mode (most frequent) value per channel in neighborhood</dd>
+<dt class="col-md-4">Nonpeak</dt><dd class="col-md-8">value just before or after the median value per channel in neighborhood</dd>
+<dt class="col-md-4">RMS</dt><dd class="col-md-8">root mean square value per channel in neighborhood</dd>
+<dt class="col-md-4">StandardDeviation</dt><dd class="col-md-8"> standard deviation value per channel in neighborhood</dd>
+</dl>
<div style="margin: auto;">
- <h4><a id="stegano"></a>-stegano <em class="arg">offset</em></h4>
+ <h3><a class="anchor" id="stegano"></a>-stegano <var>offset</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>hide watermark within an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">hide watermark within an image.</p>
<p>Use an offset to start the image hiding some number of pixels from the
beginning of the image. Note this offset and the image size. You will need
320x256+35 stegano:image.png).</p>
<div style="margin: auto;">
- <h4><a id="stereo"></a>-stereo <em class="arg">+x</em>{<em class="arg">+y</em>}</h4>
+ <h3><a class="anchor" id="stereo"></a>-stereo <var>+x</var>{<var>+y</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>composite two images to create a red / cyan stereo anaglyph.</td><td style='text-align:right;'>[<a href="composite.html">composite</a>]</td></tr></table>
+<p class="magick-description">composite two images to create a red / cyan stereo anaglyph.</p>
<p>The left side of the stereo pair (second image) is saved as the red channel of the output image. The right side (first image) is saved as the green and blue channels. Red-green stereo glasses are required to properly view the stereo image.</p>
<div style="margin: auto;">
- <h4><a id="storage-type"></a>-storage-type <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="storage-type"></a>-storage-type <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>pixel storage type. Here are the valid types:</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">pixel storage type. Here are the valid types:</p>
-<pre class="text">
- char unsigned characters
- double doubles
- float floats
- integer integers
- long longs
- quantum pixels in the native depth of your ImageMagick distribution
- short unsigned shorts
-</pre>
+<dl class="row">
+<dt class="col-md-4">char</dt><dd class="col-md-8">unsigned characters</dd>
+<dt class="col-md-4">double</dt><dd class="col-md-8">doubles</dd>
+<dt class="col-md-4">float</dt><dd class="col-md-8">floats</dd>
+<dt class="col-md-4">integer</dt><dd class="col-md-8">integers</dd>
+<dt class="col-md-4">long</dt><dd class="col-md-8">longs</dd>
+<dt class="col-md-4">quantum</dt><dd class="col-md-8">pixels in the native depth of your ImageMagick distribution</dd>
+<dt class="col-md-4">short</dt><dd class="col-md-8">unsigned shorts</dd>
+</dl>
<p>Float and double types are normalized from 0.0 to 1.0 otherwise the pixels
values range from 0 to the maximum value the storage type can support.</p>
<div style="margin: auto;">
- <h4><a id="stretch"></a>-stretch <em class="arg">fontStretch</em></h4>
+ <h3><a class="anchor" id="stretch"></a>-stretch <var>fontStretch</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set a type of stretch style for fonts.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set a type of stretch style for fonts.</p>
<p>This setting suggests a type of stretch that ImageMagick should try to
-apply to the currently selected font family. Select <em
-class="arg">fontStretch</em> from the following.</p>
-
-<pre class="text">
- Any
- Condensed
- Expanded
- ExtraCondensed
- ExtraExpanded
- Normal
- SemiCondensed
- SemiExpanded
- UltraCondensed
- UltraExpanded
-</pre>
+apply to the currently selected font family. Select <var>fontStretch</var> from the following.</p>
+
+<pre class="highlight"><code>Any
+Condensed
+Expanded
+ExtraCondensed
+ExtraExpanded
+Normal
+SemiCondensed
+SemiExpanded
+UltraCondensed
+UltraExpanded
+</code></pre>
<p>To print a complete list of stretch types, use <a href="command-line-options.html#list">-list
stretch</a>.</p>
href="command-line-options.html#style">-style</a>, and <a href="command-line-options.html#weight">-weight</a>. </p>
<div style="margin: auto;">
- <h4><a id="strip"></a>-strip</h4>
+ <h3><a class="anchor" id="strip"></a>-strip</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>strip the image of any profiles or comments.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">strip the image of any profiles, comments or these PNG chunks: bKGD,cHRM,EXIF,gAMA,iCCP,iTXt,sRGB,tEXt,zCCP,zTXt,date.</p>
<div style="margin: auto;">
- <h4><a id="stroke"></a>-stroke <em class="arg">color</em></h4>
+ <h3><a class="anchor" id="stroke"></a>-stroke <var>color</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>color to use when stroking a graphic primitive.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">color to use when stroking a graphic primitive.</p>
<p>The color is specified using the format described under the <a href="command-line-options.html#fill">-fill</a> option.</p>
<p>See <a href="command-line-options.html#draw">-draw</a> for further details.</p>
<div style="margin: auto;">
- <h4><a id="strokewidth"></a>-strokewidth <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="strokewidth"></a>-strokewidth <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>set the stroke width.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">set the stroke width.</p>
<p>See <a href="command-line-options.html#draw">-draw</a> for further details.</p>
<div style="margin: auto;">
- <h4><a id="style"></a>-style <em class="arg">fontStyle</em></h4>
+ <h3><a class="anchor" id="style"></a>-style <var>fontStyle</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set a font style for text.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set a font style for text.</p>
<p>This setting suggests a font style that ImageMagick should try to apply to
-the currently selected font family. Select <em class="arg">fontStyle</em> from
+the currently selected font family. Select <var>fontStyle</var> from
the following.</p>
-<pre class="text">
- Any
- Italic
- Normal
- Oblique
-</pre>
+<pre class="highlight"><code>Any
+Italic
+Normal
+Oblique
+</code></pre>
<p>For other settings that affect fonts, see the options <a
href="command-line-options.html#font">-font</a>, <a href="command-line-options.html#family">-family</a>, <a
href="command-line-options.html#stretch">-stretch</a>, and <a href="command-line-options.html#weight">-weight</a>. </p>
<div style="margin: auto;">
- <h4><a id="subimage-search"></a>-subimage-search</h4>
+ <h3><a class="anchor" id="subimage-search"></a>-subimage-search</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>search for subimage.</td><td style='text-align:right;'>[<a href="compare.html">compare</a>]</td></tr></table>
+<p class="magick-description">search for subimage.</p>
<p>This option is required to have compare search for the best match location
of a small image within a larger image. This search will produce two images
<div style="margin: auto;">
- <h4><a id="swap"></a>-swap <em class="arg">index,index</em></h4>
+ <h3><a class="anchor" id="swap"></a>-swap <var>index,index</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Swap the positions of two images in the image sequence.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Swap the positions of two images in the image sequence.</p>
<p>For example, <a href="command-line-options.html#swap">-swap 0,2</a> swaps the first and the third
images in the current image sequence. Use <a href="command-line-options.html#swap">+swap</a> to switch
the last two images in the sequence.</p>
<div style="margin: auto;">
- <h4><a id="swirl"></a>-swirl <em class="arg">degrees</em></h4>
+ <h3><a class="anchor" id="swirl"></a>-swirl <var>degrees</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>swirl image pixels about the center.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">swirl image pixels about the center.</p>
-<p><em class="arg">Degrees</em> defines the tightness of the swirl.</p>
+<p><var>Degrees</var> defines the tightness of the swirl.</p>
<div style="margin: auto;">
- <h4><a id="synchronize"></a>-synchronize</h4>
+ <h3><a class="anchor" id="synchronize"></a>-synchronize</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>synchronize image to storage device.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">synchronize image to storage device.</p>
<p>Set to "true" to ensure all image data is fully flushed and synchronized
to disk. There is a performance penalty, but the benefits include ensuring a
is not enough disk space for the image pixel cache.</p>
<div style="margin: auto;">
- <h4><a id="taint"></a>-taint</h4>
+ <h3><a class="anchor" id="taint"></a>-taint</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Mark the image as modified.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Mark the image as modified.</p>
<div style="margin: auto;">
- <h4><a id="text-font"></a>-text-font <em class="arg">name</em></h4>
+ <h3><a class="anchor" id="text-font"></a>-text-font <var>name</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>font for writing fixed-width text.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">font for writing fixed-width text.</p>
<p>Specifies the name of the preferred font to use in fixed (typewriter style)
-formatted text. The default is 14 point <em class="arg">Courier</em>.</p>
+formatted text. The default is 14 point <var>Courier</var>.</p>
<p>You can tag a font to specify whether it is a PostScript, TrueType, or
OPTION1 font. For example, <code>Courier.ttf</code> is a TrueType font and
<code>x:fixed</code> is OPTION1.</p>
<div style="margin: auto;">
- <h4><a id="texture"></a>-texture <em class="arg">filename</em></h4>
+ <h3><a class="anchor" id="texture"></a>-texture <var>filename</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>name of texture to tile onto the image background.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">name of texture to tile onto the image background.</p>
<div style="margin: auto;">
- <h4><a id="threshold"></a>-threshold <em class="arg">value</em>{<em class="arg">%</em>}</h4>
+ <h3><a class="anchor" id="threshold"></a>-threshold <var>value</var>{<var>%</var>}</h3>
</div>
-<!-- {<em class="arg">green,blue,opacity</em>}
+<!-- {<var>green,blue,opacity</var>}
<p>If the green or blue value is omitted, these channels use the same value as
the first one provided. If all three color values are the same, the result is
a bi-level image. If the opacity threshold is omitted, OpaqueOpacity is used
and any partially transparent pixel becomes fully transparent.</p>
-->
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Apply simultaneous black/white threshold to the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Apply simultaneous black/white threshold to the image.</p>
<p>Any pixel values (more specifically, those channels set using <a href="command-line-options.html#channel">‑channel</a>) that exceed the specified threshold are reassigned the
maximum channel value, while all other values are assigned the minimum.</p>
channel. The green, blue, and alpha channels (if present) would be unchanged.
</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert in.png -channel red -threshold 50% out.png</span></p>
+<pre class="highlight"><code>convert in.png -channel red -threshold 50% out.png
+</code></pre>
+
<p>As (possibly) impractical but instructive examples, the following would
generate an all-black and an all-white image with the same dimensions as the
input image.</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert in.png -threshold 100% black.png</span><span class='crtout'></span><span class="crtprompt"> $magick> </span><span class='crtin'>convert in.png -threshold -1 white.png</span></p>
+<pre class="highlight"><code>convert in.png -threshold 100% black.png
+convert in.png -threshold -1 white.png
+</code></pre>
+
<p>Note that the values of the transparency channel is treated as 'matte'
values (0 is opaque) and not as 'alpha' values (0 is transparent).</p>
</p>
<div style="margin: auto;">
- <h4><a id="thumbnail"></a>-thumbnail <em class="arg">geometry</em></h4>
+ <h3><a class="anchor" id="thumbnail"></a>-thumbnail <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Create a thumbnail of the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Create a thumbnail of the image.</p>
<p>This is similar to <a href="command-line-options.html#resize">-resize</a>, except it is optimized
for speed and any image profile, other than a color profile, is removed to
<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
<div style="margin: auto;">
- <h4><a id="tile"></a>-tile <em class="arg">filename</em></h4>
+ <h3><a class="anchor" id="tile"></a>-tile <var>filename</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the tile image used for filling a subsequent graphic primitive.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set the tile image used for filling a subsequent graphic primitive.</p>
<div style="margin: auto;">
- <h4>-tile <em class="arg">geometry</em></h4>
+ <h3>-tile <var>geometry</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Specify the layout of images .</td><td style='text-align:right;'>[<a href="montage.html">montage</a>]</td></tr></table>
+<p class="magick-description">Specify the layout of images.</p>
<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
<div style="margin: auto;">
- <h4>-tile</h4>
+ <h3>-tile</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Specifies that a subsequent composite operation is repeated across and down image.</td><td style='text-align:right;'>[<a href="composite.html">composite</a>]</td></tr></table>
+<p class="magick-description">Specifies that a subsequent composite operation is repeated across and down image.</p>
<div style="margin: auto;">
- <h4><a id="tile-offset"></a>-tile-offset {<em class="arg">+-</em>}<em class="arg">x</em>{<em class="arg">+-</em>}<em class="arg">y</em></h4>
+ <h3><a class="anchor" id="tile-offset"></a>-tile-offset {<var>+-</var>}<var>x</var>{<var>+-</var>}<var>y</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Specify the offset for tile images, relative to the background image it is tiled on.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Specify the offset for tile images, relative to the background image it is tiled on.</p>
<p>This should be set before the tiling image is set by <a href="command-line-options.html#tile"
>-tile</a> or <a href="command-line-options.html#texture" >-texture</a>, or directly applied for
by the arguments given when the tile image is set. </p>
<div style="margin: auto;">
- <h4><a id="tint"></a>-tint <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="tint"></a>-tint <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Tint the image with the fill color.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Tint the image with the fill color.</p>
<p>Tint the image with the fill color.</p>
as the various shades of grey.</p>
<div style="margin: auto;">
- <h4><a id="title"></a>-title <em class="arg">string</em></h4>
+ <h3><a class="anchor" id="title"></a>-title <var>string</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Assign a title to displayed image.</td><td style='text-align:right;'>[<a href="animate.html">animate</a>, <a href="display.html">display</a>, <a href="montage.html">montage</a>]</td></tr></table>
+<p class="magick-description">Assign a title to displayed image.", "animate", "display", "montage</p>
<p>Use this option to assign a specific title to the image. This assigned to
the image window and is typically displayed in the window title bar.
<p>For example,</p>
-<p class="crtsnip">
- -title "%m:%f %wx%h"
-</p>
+<pre class="highlight"><code>-title "%m:%f %wx%h"
+</code></pre>
<p>produces an image title of <code>MIFF:bird.miff 512x480</code> for an image
titled <code>bird.miff</code> and whose width is 512 and height is 480.</p>
<div style="margin: auto;">
- <h4><a id="transform"></a>-transform</h4>
+ <h3><a class="anchor" id="transform"></a>-transform</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>transform the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">transform the image.</p>
<p>This option applies the transformation matrix from a previous <a href="command-line-options.html#affine">-affine</a> option.</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert -affine 2,2,-2,2,0,0 -transform bird.ppm bird.jpg</span></p>
+<pre class="highlight"><code>convert -affine 2,2,-2,2,0,0 -transform bird.ppm bird.jpg
+</code></pre>
+
<p>This operator has been now been superseded by the <a
href="command-line-options.html#distort">-distort</a> '<code>AffineProjection</code>' method. </p>
<div style="margin: auto;">
- <h4><a id="transparent"></a>-transparent <em class="arg">color</em></h4>
+ <h3><a class="anchor" id="transparent"></a>-transparent <var>color</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Make this color transparent within the image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Make this color transparent within the image.</p>
-<p>The <em class="arg">color</em> argument is defined using the format
+<p>The <var>color</var> argument is defined using the format
described under the <a href="command-line-options.html#fill">-fill</a> option. The <a href="command-line-options.html#fuzz"
>-fuzz</a> setting can be used to match and replace colors similar to the one
given. </p>
<div style="margin: auto;">
- <h4><a id="transparent-color"></a>-transparent-color <em class="arg">color</em></h4>
+ <h3><a class="anchor" id="transparent-color"></a>-transparent-color <var>color</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set the transparent color.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set the transparent color.</p>
<p>Sometimes this is used for saving to image formats such as
GIF and PNG8 which uses this color to represent boolean transparency. This
<p>The default transparent color is <code>#00000000</code>, which is fully transparent black.</p>
<div style="margin: auto;">
- <h4><a id="transpose"></a>-transpose</h4>
+ <h3><a class="anchor" id="transpose"></a>-transpose</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Mirror the image along the top-left to bottom-right diagonal.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Mirror the image along the top-left to bottom-right diagonal.</p>
<p> This option mathematically transposes the pixel array. It is equivalent to the sequence <code>-flip -rotate 90</code>.
</p>
<div style="margin: auto;">
- <h4><a id="transverse"></a>-transverse</h4>
+ <h3><a class="anchor" id="transverse"></a>-transverse</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Mirror the image along the images bottom-left top-right diagonal. Equivalent to the operations <code>-flop -rotate 90</code>.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Mirror the image along the images bottom-left top-right diagonal. Equivalent to the operations <code>-flop -rotate 90</code>.</p>
<div style="margin: auto;">
- <h4><a id="treedepth"></a>-treedepth <em class="arg">value</em></h4>
+ <h3><a class="anchor" id="treedepth"></a>-treedepth <var>value</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>tree depth for the color reduction algorithm.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">tree depth for the color reduction algorithm.</p>
<p>Normally, this integer value is zero or one. A value of zero or one causes
the use of an optimal tree depth for the color reduction algorithm.</p>
image with the fastest computational speed and the least amount of memory.
However, the default depth is inappropriate for some images. To assure the
best representation, try values between 2 and 8 for this parameter. Refer to
-the <a href="quantize.html"
+the <a href="../www/quantize.html"
>color reduction algorithm</a> for more details.</p>
<p>The <a href="command-line-options.html#colors">-colors</a> or <a href="command-line-options.html#monochrome">-monochrome</a>
required for this option to take effect.</p>
<div style="margin: auto;">
- <h4><a id="trim"></a>-trim</h4>
+ <h3><a class="anchor" id="trim"></a>-trim</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>trim an image.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">trim an image.</p>
<p>This option removes any edges that are exactly the same color as the corner
pixels. Use <a href="command-line-options.html#fuzz">-fuzz</a> to make <a href="command-line-options.html#trim">-trim</a> remove
<div style="margin: auto;">
- <h4><a id="type"></a>-type <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="type"></a>-type <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>the image type.</td><td style='text-align:right;'></td></tr></table>
- <p>Choose from: <code>Bilevel</code>,
+<p class="magick-description">the image type.</p> <p>Choose from: <code>Bilevel</code>,
<code>Grayscale</code>, <code>GrayscaleMatte</code>, <code>Palette</code>,
<code>PaletteMatte</code>, <code>TrueColor</code>, <code>TrueColorMatte</code>,
<code>ColorSeparation</code>, or <code>ColorSeparationMatte</code>.</p>
example, to prevent a JPEG from being written in grayscale format even though
only gray pixels are present, use.</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert bird.png -type TrueColor bird.jpg</span></p>
+<pre class="highlight"><code>convert bird.png -type TrueColor bird.jpg
+</code></pre>
+
<p>Similarly, use <a href="command-line-options.html#type">-type TrueColorMatte</a> to force the
encoder to write an alpha channel even though the image is opaque, if the
output format supports transparency.</p>
<p>Use <a href="command-line-options.html#type">-type optimize</a> to ensure the image is written in the smallest possible file size.</p>
<div style="margin: auto;">
- <h4><a id="undercolor"></a>-undercolor <em class="arg">color</em></h4>
+ <h3><a class="anchor" id="undercolor"></a>-undercolor <var>color</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>set the color of the annotation bounding box.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">set the color of the annotation bounding box.</p>
<p>The color is specified using the format described under the <a href="command-line-options.html#fill">-fill</a> option.</p>
<div style="margin: auto;">
- <h4><a id="update"></a>-update <em class="arg">seconds</em></h4>
+ <h3><a class="anchor" id="update"></a>-update <var>seconds</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>detect when image file is modified and redisplay.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">detect when image file is modified and redisplay.</p>
<p>Suppose that while you are displaying an image the file that is currently
displayed is over-written. <code>display</code> will automagically detect that
<div style="margin: auto;">
- <h4><a id="unique-colors"></a>-unique-colors</h4>
+ <h3><a class="anchor" id="unique-colors"></a>-unique-colors</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>discard all but one of any pixel color.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">discard all but one of any pixel color.</p>
<div style="margin: auto;">
- <h4><a id="units"></a>-units <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="units"></a>-units <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>the units of image resolution.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">the units of image resolution.</p>
<p>Choose from: <code>Undefined</code>, <code>PixelsPerInch</code>, or
<code>PixelsPerCentimeter</code>. This option is normally used in conjunction
<div style="margin: auto;">
- <h4><a id="unsharp"></a>-unsharp <em class="arg">radius</em><br />-unsharp <em class="arg">radius</em>x<em class="arg">sigma</em>{<em class="arg">+gain</em>}{<em class="arg">+threshold</em>}</h4>
+ <h3><a class="anchor" id="unsharp"></a>-unsharp <var>radius</var><br />-unsharp <var>radius</var>x<var>sigma</var>{<var>+gain</var>}{<var>+threshold</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>sharpen the image with an unsharp mask operator.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">sharpen the image with an unsharp mask operator.</p>
<p>The <a href="command-line-options.html#unsharp">-unsharp</a> option sharpens an image. The image is
convolved with a Gaussian operator of the given radius and standard deviation
<p>The parameters are:</p>
-<pre class="text">
- radius The radius of the Gaussian, in pixels, not counting the center
- pixel (default 0).
- sigma The standard deviation of the Gaussian, in pixels (default 1.0).
- gain The fraction of the difference between the original and the blur
- image that is added back into the original (default 1.0).
- threshold The threshold, as a fraction of <em class="QR">QuantumRange</em>, needed to apply the
- difference amount (default 0.05).
-</pre>
-
+<dl class="row">
+<dt class="col-md-4">radius</dt>
+<dd class="col-md-8">The radius of the Gaussian, in pixels, not counting the center pixel (default 0).</dd>
+<dt class="col-md-4">sigma</dt>
+<dd class="col-md-8">The standard deviation of the Gaussian, in pixels (default 1.0).</dd>
+<dt class="col-md-4">gain</dt>
+<dd class="col-md-8">The fraction of the difference between the original and the blur image that is added back into the original (default 1.0).</dd>
+<dt class="col-md-4">threshold</dt>
+<dd class="col-md-8">The threshold, as a fraction of <var>QuantumRange</var>, needed to apply the difference amount (default 0.05).</dd>
+</dl>
<div style="margin: auto;">
- <h4><a id="verbose"></a>-verbose</h4>
+ <h3><a class="anchor" id="verbose"></a>-verbose</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>print detailed information about the image when this option
-precedes the <a href="command-line-options.html#identify">-identify</a> option or
-<code>info:</code>.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">print detailed information about the image when this option precedes the <a href="command-line-options.html#identify">-identify</a> option or <code>info:</code>.</p>
<div style="margin: auto;">
- <h4><a id="version"></a>-version</h4>
+ <h3><a class="anchor" id="version"></a>-version</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>print ImageMagick version string and exit.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">print ImageMagick version string and exit.</p>
<div style="margin: auto;">
- <h4><a id="view"></a>-view <em class="arg">string</em></h4>
+ <h3><a class="anchor" id="view"></a>-view <var>string</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>FlashPix viewing parameters.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">FlashPix viewing parameters.</p>
<div style="margin: auto;">
- <h4><a id="vignette"></a>-vignette <em class="arg">radius</em>{x<em class="arg">sigma</em>}{<em class="arg">+-</em>}<em class="arg">x</em>{<em class="arg">+-</em>}<em class="arg">y</em>{<em class="arg">%</em>}</h4>
+ <h3><a class="anchor" id="vignette"></a>-vignette <var>radius</var>{x<var>sigma</var>}{<var>+-</var>}<var>x</var>{<var>+-</var>}<var>y</var>{<var>%</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>soften the edges of the image in vignette style.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">soften the edges of the image in vignette style.</p>
<p>The vignette effect rolloff is controlled by radiusxsigma. For nominal rolloff, this would be set to 0xsigma. A value of 0x0 will produce a circle/ellipse with no rolloff. The arguments x and y control the size of the circle. Larger values decrease the radii and smaller values increase the radii. Values of +0+0 will generate a circle/ellipse the same size as the image. The default values for x and y are 10% of the corresponding image dimension. Thus, the radii will be decreased by 10%, i.e., the diameters of the circle/ellipse will be 80% of the corresponding image dimension.</p>
<div style="margin: auto;">
- <h4><a id="virtual-pixel"></a>-virtual-pixel <em class="arg">method</em></h4>
+ <h3><a class="anchor" id="virtual-pixel"></a>-virtual-pixel <var>method</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Specify contents of <em>virtual pixels</em>.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Specify contents of <var>virtual pixels</var>.</p>
<p>This option defines what color source should be used if and when a color
lookup completely 'misses' the source image. The color(s) that appear to
<p>Choose from these methods:</p>
-<pre class="text">
- background the area surrounding the image is the background color
- black the area surrounding the image is black
- checker-tile alternate squares with image and background color
- dither non-random 32x32 dithered pattern
- edge extend the edge pixel toward infinity
- gray the area surrounding the image is gray
- horizontal-tile horizontally tile the image, background color above/below
- horizontal-tile-edge horizontally tile the image and replicate the side edge pixels
- mirror mirror tile the image
- random choose a random pixel from the image
- tile tile the image (default)
- transparent the area surrounding the image is transparent blackness
- vertical-tile vertically tile the image, sides are background color
- vertical-tile-edge vertically tile the image and replicate the side edge pixels
- white the area surrounding the image is white
-</pre>
+<dl class="row">
+<dt class="col-md-4">background</dt><dd class="col-md-8">the area surrounding the image is the background color</dd>
+<dt class="col-md-4">black</dt><dd class="col-md-8">the area surrounding the image is black</dd>
+<dt class="col-md-4">checker-tile</dt><dd class="col-md-8">alternate squares with image and background color</dd>
+<dt class="col-md-4">dither</dt><dd class="col-md-8">non-random 32x32 dithered pattern</dd>
+<dt class="col-md-4">edge</dt><dd class="col-md-8">extend the edge pixel toward infinity</dd>
+<dt class="col-md-4">gray</dt><dd class="col-md-8">the area surrounding the image is gray</dd>
+<dt class="col-md-4">horizontal-tile</dt><dd class="col-md-8">horizontally tile the image, background color above/below</dd>
+<dt class="col-md-4">horizontal-tile-edge</dt><dd class="col-md-8">horizontally tile the image and replicate the side edge pixels</dd>
+<dt class="col-md-4">mirror</dt><dd class="col-md-8">mirror tile the image</dd>
+<dt class="col-md-4">random</dt><dd class="col-md-8">choose a random pixel from the image</dd>
+<dt class="col-md-4">tile</dt><dd class="col-md-8">tile the image (default)</dd>
+<dt class="col-md-4">transparent</dt><dd class="col-md-8">the area surrounding the image is transparent blackness</dd>
+<dt class="col-md-4">vertical-tile</dt><dd class="col-md-8">vertically tile the image, sides are background color</dd>
+<dt class="col-md-4">vertical-tile-edge</dt><dd class="col-md-8">vertically tile the image and replicate the side edge pixels</dd>
+<dt class="col-md-4">white</dt><dd class="col-md-8">the area surrounding the image is white</dd>
+</dl>
<p>The default value is "edge".</p>
<p>This most important for distortion operators such as <a href="command-line-options.html#distort"
>-distort</a>, <a href="command-line-options.html#implode" >-implode</a>, and <a href="command-line-options.html#fx" >-fx</a>.
-However it also effects operations that may access pixels just outside the
+However it also affects operations that may access pixels just outside the
image proper, such as <a href="command-line-options.html#convolve">-convolve</a>, <a
href="command-line-options.html#blur">-blur</a>, and <a href="command-line-options.html#sharpen">-sharpen</a>. </p>
<div style="margin: auto;">
- <h4><a id="visual"></a>-visual <em class="arg">type</em></h4>
+ <h3><a class="anchor" id="visual"></a>-visual <var>type</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Animate images using this X visual type.</td><td style='text-align:right;'>[<a href="animate.html">animate</a>, <a href="display.html">display</a>]</td></tr></table>
+<p class="magick-description">Animate images using this X visual type.", 'animate', 'display'</p>
<p>Choose from these visual classes:</p>
-<pre class="text">
- StaticGray
- GrayScale
- StaticColor
- PseudoColor
- TrueColor
- DirectColor
- default
- visual id
-</pre>
+<pre class="highlight"><code>StaticGray TrueColor
+GrayScale DirectColor
+StaticColor default
+PseudoColor visual id
+</code></pre>
<p>The X server must support the visual you choose, otherwise an error occurs.
If a visual is not specified, the visual class that can display the most
<div style="margin: auto;">
- <h4><a id="watermark"></a>-watermark <em
- class="arg">brightness</em>x<em class="arg">saturation</em></h4>
+ <h3><a class="anchor" id="watermark"></a>-watermark <var>brightness</var>x<var>saturation</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Watermark an image using the given percentages of brightness and
-saturation.</td><td style='text-align:right;'>[<a href="composite.html">composite</a>]</td></tr></table>
+<p class="magick-description">Watermark an image using the given percentages of brightness and saturation.</p>
<p>Take a grayscale image (with alpha mask) and modify the destination image's
-brightness according to watermark image's grayscale value and the <em
-class="arg">brightness</em> percentage. The destinations color saturation
-attribute is just direct modified by the <em class="arg">saturation</em>
+brightness according to watermark image's grayscale value and the
+<var>brightness</var> percentage. The destinations color saturation
+attribute is just direct modified by the <var>saturation</var>
percentage, which defaults to 100 percent (no color change). </p>
<div style="margin: auto;">
- <h4><a id="wave"></a>-wave <em class="arg">amplitude</em><br />-wave <em class="arg">amplitude</em>x<em class="arg">wavelength</em></h4>
+ <h3><a class="anchor" id="wave"></a>-wave <var>amplitude</var><br />-wave <var>amplitude</var>x<var>wavelength</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Shear the columns of an image into a sine wave.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Shear the columns of an image into a sine wave.</p>
+
+<div style="margin: auto;">
+ <h3><a class="anchor" id="wavelet-denoise"></a>-wavelet-denoise <var>threshold</var><br />-wavelet-denoise <var>threshold</var>x<var>softness</var></h3>
+</div>
-<p>Specify <em class="arg">amplitude</em> and <em class="arg">wavelength</em>
-of the wave.</p>
+<p class="magick-description">removes noise from the image using a wavelet transform. The threshold is the value below which everything is considered noise and ranges from 0.0 (none) to QuantumRange or use percent (e.g. 5%). Softness attenuates the threshold and typically ranges from 0.0 (none) to 1.0. The higher the value the more noise that remains in the image.</p>
<div style="margin: auto;">
- <h4><a id="weight"></a>-weight <em class="arg">fontWeight</em></h4>
+ <h3><a class="anchor" id="weight"></a>-weight <var>fontWeight</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Set a font weight for text.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Set a font weight for text.</p>
<p>This setting suggests a font weight that ImageMagick should try to apply to
-the currently selected font family. Use a positive integer for <em
-class="arg">fontWeight</em> or select from the following.</p>
-
-<table class="doc">
- <col width="25%" />
- <col width="75%" />
- <thead>
- <tr>
- <th><em class="arg">fontWeight</em></th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr><td>All </td>
- <td>No effect. </td></tr>
- <tr><td>Bold </td>
- <td>Same as <em class="arg">fontWeight</em> = 700.</td></tr>
- <tr><td>Bolder </td>
- <td>Add 100 to font weight if currently ≤ 800.</td></tr>
- <tr><td>Lighter </td>
- <td>Subtract 100 to font weight if currently ≤ 100.</td></tr>
- <tr><td>Normal </td>
- <td>Same as <em class="arg">fontWeight</em> = 400.</td></tr>
- </tbody>
- </table>
+the currently selected font family. Use a positive integer for
+<var>fontWeight</var> or select from the following.</p>
+
+<dl class="row">
+<dt class="col-md-4">Thin </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 100.</dd>
+<dt class="col-md-4">ExtraLight </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 200.</dd>
+<dt class="col-md-4">Light </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 300.</dd>
+<dt class="col-md-4">Normal </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 400.</dd>
+<dt class="col-md-4">Medium </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 500.</dd>
+<dt class="col-md-4">DemiBold </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 600.</dd>
+<dt class="col-md-4">Bold </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 700.</dd>
+<dt class="col-md-4">ExtraBold </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 800.</dd>
+<dt class="col-md-4">Heavy </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 900.</dd>
+</dl>
+<br/>
-<p>To print a complete list of weight types, use <a href="command-line-options.html#list">-list
-weight</a>.</p>
+<p>To print a complete list of weight types, use <a href="command-line-options.html#list">-list weight</a>.</p>
<p>For other settings that affect fonts, see the options <a
href="command-line-options.html#font">-font</a>, <a href="command-line-options.html#family">-family</a>, <a
href="command-line-options.html#stretch">-stretch</a>, and <a href="command-line-options.html#style">-style</a>. </p>
<div style="margin: auto;">
- <h4><a id="white-point"></a>-white-point <em class="arg">x,y</em></h4>
+ <h3><a class="anchor" id="white-point"></a>-white-point <var>x,y</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>chromaticity white point.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">chromaticity white point.</p>
<div style="margin: auto;">
- <h4><a id="white-threshold"></a>-white-threshold <em class="arg">value</em>{<em class="arg">%</em>}</h4>
+ <h3><a class="anchor" id="white-threshold"></a>-white-threshold <var>value</var>{<var>%</var>}</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Force to white all pixels above the threshold while leaving all
-pixels at or below the threshold unchanged.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">Force to white all pixels above the threshold while leaving all pixels at or below the threshold unchanged.</p>
<p> The threshold value can be given as a percentage or as an absolute integer
-value within [0, <em class="QR">QuantumRange</em>] corresponding to the
+value within [0, <var>QuantumRange</var>] corresponding to the
desired <a href="command-line-options.html#channel">‑channel</a> value. See <a href="command-line-options.html#threshold">‑threshold</a>for more details on thresholds and resulting values. </p>
<div style="margin: auto;">
- <h4><a id="window"></a>-window <em class="arg">id</em></h4>
+ <h3><a class="anchor" id="window"></a>-window <var>id</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Make the image the background of a window.</td><td style='text-align:right;'>[<a href="animate.html">animate</a>, <a href="display.html">display</a>]</td></tr></table>
+<p class="magick-description">Make the image the background of a window.", 'animate', 'display'</p>
-<p><em class="arg">id</em> can be a window id or name. Specify <code>root</code>
+<p><var>id</var> can be a window id or name. Specify <code>root</code>
to select X's root window as the target window.</p>
<p>By default the image is tiled onto the background of the target window. If
href="command-line-options.html#colors">-colors</a> to reduce the number of colors.</p>
<div style="margin: auto;">
- <h4><a id="window-group"></a>-window-group</h4>
+ <h3><a class="anchor" id="window-group"></a>-window-group</h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>specify the window group.</td><td style='text-align:right;'></td></tr></table>
+<p class="magick-description">specify the window group.</p>
<div style="margin: auto;">
- <h4><a id="write"></a>-write <em class="arg">filename</em></h4>
+ <h3><a class="anchor" id="write"></a>-write <var>filename</var></h3>
</div>
-<table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>write an image sequence.</td><td style='text-align:right;'></td></tr></table>
- <p>The image sequence preceding the <a href="command-line-options.html#write">-write</a> <em class="arg">filename</em> option is written out, and processing continues with the same image in its current state if there are additional options. To restore the image to its original state after writing it, use the <a href="command-line-options.html#write">+write</a> <em class="arg">filename</em> option.</p>
+<p class="magick-description">write an image sequence.</p>
+
+<p>The image sequence preceding the <a href="command-line-options.html#write">-write</a> <var>filename</var> option is written out, and processing continues with the same image in its current state if there are additional options. To restore the image to its original state after writing it, use the <a href="command-line-options.html#write">+write</a> <var>filename</var> option.</p>
<p>Use <a href="command-line-options.html#compress">-compress</a> to specify the type of image compression.</p>
-</div>
-</div>
+<div style="margin: auto;">
+ <h3><a class="anchor" id="write-mask"></a>-write-mask <var>filename</var></h3>
</div>
-<div id="linkbar">
- <span id="linkbar-west"> </span>
+<p class="magick-description">Prevent updates to image pixels specified by the mask.</p>
+
+<p>This the same as using a mask used for composite masking operations, with
+grayscale values causing blended updates of the image the mask is attached to.
+</p>
+
+<p>Use <a href="command-line-options.html#write-mask">+write-mask</a> to remove the mask from images.</p>
- <span id="linkbar-center">
- <a href="../discourse-server">Discourse Server</a> •
- <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> •
- <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a> •
- <a href="http://jqmagick.imagemagick.org/">JqMagick</a>
- </span>
- <span id="linkbar-east"> </span>
+<p>Also see <a href="command-line-options.html#clip-mask">-clip-mask</a> which work in the same way,
+but with strict boolean masking. </p>
</div>
-<div class="footer">
- <span id="footer-west">© 1999-2014 ImageMagick Studio LLC</span>
- <span id="footer-east"> <a href="contact.html">Contact the Wizards</a></span>
</div>
-<div style="clear: both; margin: 0; width: 100%; "></div>
+ </div>
+ </main><!-- /.container -->
+ <footer class="magick-footer">
+ <p><a href="security-policy.html">Security</a> •
+ <a href="architecture.html">Architecture</a> •
+ <a href="links.html">Related</a> •
+ <a href="sitemap.html">Sitemap</a>
+
+ <a href="command-line-options.html#"><img class="d-inline" id="wand" alt="And Now a Touch of Magick" width="16" height="16" src="../images/wand.ico"/></a>
+
+ <a href="http://pgp.mit.edu/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> •
+ <a href="support.html">Donate</a> •
+ <a href="https://www.imagemagick.org/script/contact.php">Contact Us</a>
+ <br/>
+ <small>© 1999-2018 ImageMagick Studio LLC</small></p>
+ </footer>
+
+ <!-- Javascript assets -->
+ <script src="assets/magick.js" crossorigin="anonymous"></script>
+ <script>window.jQuery || document.write('<script src="assets/jquery.min.js"><\/script>')</script>
</body>
</html>
+<!-- Magick Cache 8th July 2018 08:34 -->
\ No newline at end of file