<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="https://www.imagemagick.org/script/command-line-options.html" rel="canonical" />
+ <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="css/magick.css" rel="stylesheet" />
+ <link href="assets/magick.css" rel="stylesheet" />
</head>
<body>
-<div class="magick-masthead">
+ <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"
+ <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"
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>
- <nav class="nav magick-nav">
- <a class="nav-link " href="../index.html">Home</a>
- <a class="nav-link " href="download.html">Download</a>
- <a class="nav-link " href="command-line-tools.html">Tools</a>
- <a class="nav-link " href="command-line-processing.html">Command-line</a>
- <a class="nav-link " href="resources.html">Resources</a>
- <a class="nav-link " href="develop.html">Develop</a>
- <a class="nav-link " href="https://www.imagemagick.org/script/search.php">Search</a>
- <a class="nav-link float-right" href="https://www.imagemagick.org/discourse-server/">Community</a>
- </nav>
+
</div>
-</div>
-<div class="container">
+ </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 id="adaptive-blur"></a>-adaptive-blur <var>radius</var>[x<var>sigma</var>]</h3>
+ <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>
defaults to 1.</p>
<div style="margin: auto;">
- <h3><a id="adaptive-resize"></a>-adaptive-resize <var>geometry</var></h3>
+ <h3><a class="anchor" id="adaptive-resize"></a>-adaptive-resize <var>geometry</var></h3>
</div>
<p class="magick-description">Resize the image using data-dependent triangulation.</p>
href="command-line-options.html#gravity">-gravity</a> option has no effect.</p>
<div style="margin: auto;">
- <h3><a id="adaptive-sharpen"></a>-adaptive-sharpen <var>radius</var>[x<var>sigma</var>]</h3>
+ <h3><a class="anchor" id="adaptive-sharpen"></a>-adaptive-sharpen <var>radius</var>[x<var>sigma</var>]</h3>
</div>
<p class="magick-description">Adaptively sharpen pixels, with increasing effect near edges.</p>
defaults to 1.</p>
<div style="margin: auto;">
- <h3><a id="adjoin"></a>-adjoin</h3>
+ <h3><a class="anchor" id="adjoin"></a>-adjoin</h3>
</div>
<p class="magick-description">Join images into a single multi-image file.</p>
who have used the standard <code>printf()</code>' C-library function. As an
example, the command</p>
-<pre><code>
-convert logo: rose: -morph 15 my%02dmorph.jpg
+<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
<div style="margin: auto;">
- <h3><a id="affine"></a>-affine
+ <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>
information </p>
-<pre><code>
--affine <var>s<sub>x</sub></var>,0,0,<var>s<sub>y</sub></var>
+<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 (<var>t<sub>x</sub></var>, <var>t<sub>y</sub></var>) is accomplished like so:</p>
-<pre><code>
--affine 1,0,0,1,<var>t<sub>x</sub></var>,<var>t<sub>y</sub></var>
+<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
<var>a</var> by letting <var>c</var> = cos(<var>a</var>), <var>s</var>
= sin(<var>a</var>), and using the following.</p>
-<pre><code>
--affine <var>c</var>,<var>s</var>,-<var>s</var>,<var>c</var>
+<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>
matrix determinant has a sufficiently small absolute value it is rejected.</p>
<div style="margin: auto;">
- <h3><a id="alpha"></a>-alpha <var>type</var></h3>
+ <h3><a class="anchor" id="alpha"></a>-alpha <var>type</var></h3>
</div>
<p class="magick-description">Gives control of the alpha/matte channel of an image.</p>
Set</code>" and not "<code><a href="command-line-options.html#alpha" >-alpha</a> On</code>". </p>
<div style="margin: auto;">
- <h3><a id="annotate"></a>
+ <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>
formatting characters are recognized.</p>
<div style="margin: auto;">
- <h3><a id="antialias"></a>-antialias</h3>
+ <h3><a class="anchor" id="antialias"></a>-antialias</h3>
</div>
<p class="magick-description">Enable/Disable of the rendering of anti-aliasing pixels when drawing fonts and lines.</p>
are added when drawing such objects. </p>
<div style="margin: auto;">
- <h3><a id="append"></a>-append</h3>
+ <h3><a class="anchor" id="append"></a>-append</h3>
</div>
<p class="magick-description">Join current images vertically or horizontally.</p>
<div style="margin: auto;">
- <h3><a id="attenuate"></a>-attenuate <var>value</var></h3>
+ <h3><a class="anchor" id="attenuate"></a>-attenuate <var>value</var></h3>
</div>
<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;">
- <h3><a id="authenticate"></a>-authenticate <var>password</var></h3>
+ <h3><a class="anchor" id="authenticate"></a>-authenticate <var>password</var></h3>
</div>
<p class="magick-description">Decrypt a PDF with a password.</p>
<div style="margin: auto;">
- <h3><a id="auto-gamma"></a>-auto-gamma</h3>
+ <h3><a class="anchor" id="auto-gamma"></a>-auto-gamma</h3>
</div>
<p class="magick-description">Automagically adjust gamma level of image.</p>
<div style="margin: auto;">
- <h3><a id="auto-level"></a>-auto-level</h3>
+ <h3><a class="anchor" id="auto-level"></a>-auto-level</h3>
</div>
<p class="magick-description">Automagically adjust color levels of image.</p>
<div style="margin: auto;">
- <h3><a id="auto-orient"></a>-auto-orient</h3>
+ <h3><a class="anchor" id="auto-orient"></a>-auto-orient</h3>
</div>
<p class="magick-description">adjusts an image so that its orientation is suitable for viewing (i.e. top-left orientation).</p>
href="command-line-options.html#auto-orient" >-auto-orient</a> operator will do nothing. </p>
<div style="margin: auto;">
- <h3><a id="auto-threshold"></a>-auto-threshold <var>method</var></h3>
+ <h3><a class="anchor" id="auto-threshold"></a>-auto-threshold <var>method</var></h3>
</div>
<p class="magick-description">automatically perform image thresholding.</p>
<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;">
- <h3><a id="average"></a>-average</h3>
+ <h3><a class="anchor" id="average"></a>-average</h3>
</div>
<p class="magick-description">Average a set of images.</p>
<div style="margin: auto;">
- <h3><a id="backdrop"></a>-backdrop</h3>
+ <h3><a class="anchor" id="backdrop"></a>-backdrop</h3>
</div>
<p class="magick-description">Display the image centered on a backdrop.</p>
described under the <a href="command-line-options.html#fill">-fill</a> option.</p>
<div style="margin: auto;">
- <h3><a id="background"></a>-background <var>color</var></h3>
+ <h3><a class="anchor" id="background"></a>-background <var>color</var></h3>
</div>
<p class="magick-description">Set the background color.</p>
specified or found in the image) is white.</p>
<div style="margin: auto;">
- <h3><a id="bench"></a>-bench <var>iterations</var></h3>
+ <h3><a class="anchor" id="bench"></a>-bench <var>iterations</var></h3>
</div>
<p class="magick-description">Measure performance.</p>
-duration to run the benchmark for a fixed number of seconds and -concurrent
to run the benchmark in parallel (requires the OpenMP feature).</p>
-<pre><code>
--> convert logo: -resize 200% -bench 5 logo.png
+<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
a total elapsed time of 2.300 seconds.</p>
<div style="margin: auto;">
- <h3><a id="bias"></a>-bias <var>value</var>{<var>%</var>}</h3>
+ <h3><a class="anchor" id="bias"></a>-bias <var>value</var>{<var>%</var>}</h3>
</div>
<p class="magick-description">Add bias when convolving an image.</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="https://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;">
- <h3><a id="black-point-compensation"></a>-black-point-compensation</h3>
+ <h3><a class="anchor" id="black-point-compensation"></a>-black-point-compensation</h3>
</div>
<p class="magick-description">Use black point compensation.</p>
<div style="margin: auto;">
- <h3><a id="black-threshold"></a>-black-threshold <var>value</var>{<var>%</var>}</h3>
+ <h3><a class="anchor" id="black-threshold"></a>-black-threshold <var>value</var>{<var>%</var>}</h3>
</div>
<p class="magick-description">Force to black all pixels below the threshold while leaving all pixels at or above the threshold unchanged.</p>
<div style="margin: auto;">
- <h3><a id="blend"></a>-blend <var>geometry</var></h3>
+ <h3><a class="anchor" id="blend"></a>-blend <var>geometry</var></h3>
</div>
<p class="magick-description">blend an image into another by the given absolute value or percent.</p>
<div style="margin: auto;">
- <h3><a id="blue-primary"></a>-blue-primary <var>x</var>,<var>y</var></h3>
+ <h3><a class="anchor" id="blue-primary"></a>-blue-primary <var>x</var>,<var>y</var></h3>
</div>
<p class="magick-description">Set the blue chromaticity primary point.</p>
<div style="margin: auto;">
- <h3><a id="blue-shift"></a>-blue-shift <var>factor</var></h3>
+ <h3><a class="anchor" id="blue-shift"></a>-blue-shift <var>factor</var></h3>
</div>
<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;">
- <h3><a id="blur"></a>-blur <var>radius</var><br />-blur <var>radius</var>x<var>sigma</var></h3>
+ <h3><a class="anchor" id="blur"></a>-blur <var>radius</var><br />-blur <var>radius</var>x<var>sigma</var></h3>
</div>
<p class="magick-description">Reduce image noise and reduce detail levels.</p>
</p>
<p>The larger the <var >Radius</var> the slower the
-operation is. However too small a <var >Radius</var>, and sever
+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>
<div style="margin: auto;">
- <h3><a id="border"></a>-border <var>geometry</var></h3>
+ <h3><a class="anchor" id="border"></a>-border <var>geometry</var></h3>
</div>
<p class="magick-description">Surround the image with a border of color. </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><kbd>x</kbd></dt>
+<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"><kbd>x</kbd><var>value-y</var></dt>
+<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><kbd>x</kbd><var>value-y</var></dt>
+<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><kbd>x</kbd>0</dt>
+<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<kbd>x</kbd><var>value-y</var></dt>
+<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><kbd>x</kbd>%</dt>
+<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>%<kbd>x</kbd><var>value-y</var>%</dt>
+<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>%<kbd>x</kbd>0%</dt>
+<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%<kbd>x</kbd><var>value-y</var>%</dt>
+<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>
functionality.</p>
<div style="margin: auto;">
- <h3><a id="bordercolor"></a>-bordercolor <var>color</var></h3>
+ <h3><a class="anchor" id="bordercolor"></a>-bordercolor <var>color</var></h3>
</div>
<p class="magick-description">Set the border color.</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;">
- <h3><a id="borderwidth"></a>-borderwidth <var>geometry</var> </h3>
+ <h3><a class="anchor" id="borderwidth"></a>-borderwidth <var>geometry</var> </h3>
</div>
<p class="magick-description">Set the border width.</p>
<div style="margin: auto;">
- <h3><a id="brightness-contrast"></a>-brightness-contrast <var>brightness</var><br />-brightness-contrast <var>brightness</var>{x<var>contrast</var>}{<var>%</var>}</h3>
+ <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>
<p class="magick-description">Adjust the brightness and/or contrast of the image.</p>
symbol is no different than leaving it off.</p>
<div style="margin: auto;">
- <h3><a id="cache"></a>-cache <var>threshold</var></h3>
+ <h3><a class="anchor" id="cache"></a>-cache <var>threshold</var></h3>
</div>
<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;">
- <h3><a 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>
+ <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>
<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 {<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;">
- <h3><a id="caption"></a>-caption <var>string</var></h3>
+ <h3><a class="anchor" id="caption"></a>-caption <var>string</var></h3>
</div>
<p class="magick-description">Assign a caption to an image.</p>
<p>For example,</p>
-<pre><code>
--caption "%m:%f %wx%h" bird.miff
+<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
<div style="margin: auto;">
- <h3><a id="cdl"></a>-cdl <var>filename</var></h3>
+ <h3><a class="anchor" id="cdl"></a>-cdl <var>filename</var></h3>
</div>
<p class="magick-description">color correct with a color decision list.</p>
<p>Here is an example color correction collection:</p>
-<pre><code>
-<?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>
</code></pre>
<div style="margin: auto;">
- <h3><a id="channel"></a>-channel <var>type</var></h3>
+ <h3><a class="anchor" id="channel"></a>-channel <var>type</var></h3>
</div>
<p class="magick-description">Specify those image color channels to which subsequent operators are limited.</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>
-<pre><code>
--channel Red,Blue
-</code></pre>
-<p>or you can use the short hand form</p>
-<pre><code>
--channel RB
-</code></pre>
+'<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',
href="command-line-options.html#clut">-clut</a> operator is a good example of this. </p>
<div style="margin: auto;">
- <h3><a id="channel-fx"></a>-channel-fx <var>expression</var></h3>
+ <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><code>
-<=> exchange two channels (e.g. red<=>blue)
+<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)
<p>For example, to create 3 grayscale images from the red, green, and blue channels of an image, use:</p>
-<pre><code>
--channel-fx "red; green; blue"
+<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><code>
-convert wizard.png mask.pgm -channel-fx '| gray=>alpha' wizard-alpha.png
+<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><code>
-convert wizard.png mask.pgm -channel-fx '| gray=>read-mask' wizard-mask.png
+<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;">
- <h3><a id="charcoal"></a>-charcoal <var>factor</var></h3>
+ <h3><a class="anchor" id="charcoal"></a>-charcoal <var>factor</var></h3>
</div>
<p class="magick-description">Simulate a charcoal drawing.</p>
-
<div style="margin: auto;">
- <h3><a id="chop"></a>-chop <var>geometry</var></h3>
+ <h3><a class="anchor" id="chop"></a>-chop <var>geometry</var></h3>
</div>
<p class="magick-description">Remove pixels from the interior of an image.</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;">
- <h3><a id="clamp"></a>-clamp</h3>
+ <h3><a class="anchor" id="clamp"></a>-clamp</h3>
</div>
<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;">
- <h3><a id="clip"></a>-clip</h3>
+ <h3><a class="anchor" id="clip"></a>-clip</h3>
</div>
<p class="magick-description">Apply the clipping path if one is present.</p>
<p>For example, in the command</p>
-<pre><code>
-convert cockatoo.tif -clip -negate negated.tif
+<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>Use <a href="command-line-options.html#clip">+clip</a> to disable clipping for subsequent operations.</p>
<div style="margin: auto;">
- <h3><a id="clip-mask"></a>-clip-mask</h3>
+ <h3><a class="anchor" id="clip-mask"></a>-clip-mask</h3>
</div>
<p class="magick-description">Clip the image as defined by this mask.</p>
<p>Use <a href="command-line-options.html#clip-mask">+clip-mask</a> to disable clipping for subsequent operations.</p>
<div style="margin: auto;">
- <h3><a id="clip-path"></a>-clip-path <var>id</var></h3>
+ <h3><a class="anchor" id="clip-path"></a>-clip-path <var>id</var></h3>
</div>
<p class="magick-description">Clip along a named path from the 8BIM profile.</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;">
- <h3><a id="clone"></a>-clone <var>index(s)</var></h3>
+ <h3><a class="anchor" id="clone"></a>-clone <var>index(s)</var></h3>
</div>
<p class="magick-description">make a clone of an image (or images).</p>
'<code>−1</code>'. </p>
<div style="margin: auto;">
- <h3><a id="clut"></a>-clut</h3>
+ <h3><a class="anchor" id="clut"></a>-clut</h3>
</div>
<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>
<div style="margin: auto;">
- <h3><a id="coalesce"></a>-coalesce</h3>
+ <h3><a class="anchor" id="coalesce"></a>-coalesce</h3>
</div>
<p class="magick-description">Fully define the look of each frame of an GIF animation sequence, to form a 'film strip' animation.</p>
<div style="margin: auto;">
- <h3><a id="colorize"></a>-colorize <var>value</var></h3>
+ <h3><a class="anchor" id="colorize"></a>-colorize <var>value</var></h3>
</div>
<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>
values (e.g., <code>-colorize 0,0,50</code>).</p>
<div style="margin: auto;">
- <h3><a id="colormap"></a>-colormap <var>type</var></h3>
+ <h3><a class="anchor" id="colormap"></a>-colormap <var>type</var></h3>
</div>
<p class="magick-description">Define the colormap type.</p>
when the image colormap is installed.</p>
<div style="margin: auto;">
- <h3><a id="colors"></a>-colors <var>value</var></h3>
+ <h3><a class="anchor" id="colors"></a>-colors <var>value</var></h3>
</div>
<p class="magick-description">Set the preferred number of colors in the image.</p>
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="http://www.imagemagick.org/www/quantize.html">
+the <a href="../www/quantize.html">
color reduction algorithm</a> for more details.</p>
<div style="margin: auto;">
- <h3><a id="color-matrix"></a>-color-matrix <var>matrix</var></h3>
+ <h3><a class="anchor" id="color-matrix"></a>-color-matrix <var>matrix</var></h3>
</div>
<p class="magick-description">apply color correction to the image.</p>
<p>As an example, to add contrast to an image with offsets, try this command:</p>
-<pre><code>
-convert kittens.jpg -color-matrix \
+<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 0.0, 0.0, 1.0" kittens.png
</code></pre>
<div style="margin: auto;">
- <h3><a id="colorspace"></a>-colorspace <var>value</var></h3>
+ <h3><a class="anchor" id="colorspace"></a>-colorspace <var>value</var></h3>
</div>
<p class="magick-description">Set the image colorspace.</p>
<p>Choices are:</p>
-<pre><code>
-CMY CMYK Gray HCL
+<pre class="highlight"><code>CMY CMYK Gray HCL
HCLp HSB HSI HSL
HSV HWB Lab LCHab
LCHuv LMS Log Luv
<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.298839*R+0.586811*G+0.114350*B</td></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">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">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><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>
<p>Use the <code>Undefined</code> colorspace to identify multi-spectral images.</p>
<div style="margin: auto;">
- <h3><a id="combine"></a>-combine</h3>
+ <h3><a class="anchor" id="combine"></a>-combine</h3>
<h3>+combine <var>colorspace</var></h3>
</div>
Thus, in the following example, the final image should be a copy of the
original. </p>
-<pre><code>
-convert original.png -channel RGB -separate sepimage.png
+<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;">
- <h3><a id="comment"></a>-comment <var>string</var></h3>
+ <h3><a class="anchor" id="comment"></a>-comment <var>string</var></h3>
</div>
<p class="magick-description">Embed a comment in an image.</p>
<p>For example,</p>
-<pre><code>
--comment "%m:%f %wx%h" bird.miff
+<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
480.</p>
<div style="margin: auto;">
- <h3><a id="compare"></a>-compare</h3>
+ <h3><a class="anchor" id="compare"></a>-compare</h3>
</div>
<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>
-<pre><code>
-convert image.png reference.png -metric RMSE -compare \ <br/> difference.png
+<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>
-<pre><code>
-convert image.png reference.png -metric RMSE -compare -format \
+<pre class="highlight"><code>convert image.png reference.png -metric RMSE -compare -format \
"%[distortion]" info:
</code></pre>
<div style="margin: auto;">
- <h3><a id="complex"></a>-complex <var>operator</var></h3>
+ <h3><a class="anchor" id="complex"></a>-complex <var>operator</var></h3>
</div>
<p class="magick-description">perform complex mathematics on an image sequence</p>
Choose from these operators:
-<pre><code>
-add
+<pre class="highlight"><code>add
conjugate
divide
magnitude-phase
<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;">
- <h3><a id="compose"></a>-compose <var>operator</var></h3>
+ <h3><a class="anchor" id="compose"></a>-compose <var>operator</var></h3>
</div>
<p class="magick-description">Set the type of image composition.</p>
-<p>See <a href="http://www.imagemagick.org/www/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;">
- <h3><a id="composite"></a>-composite</h3>
+ <h3><a class="anchor" id="composite"></a>-composite</h3>
</div>
<p class="magick-description">Perform alpha composition on two images and an optional mask</p>
<div style="margin: auto;">
- <h3><a id="compress"></a>-compress <var>type</var></h3>
+ <h3><a class="anchor" id="compress"></a>-compress <var>type</var></h3>
</div>
<p class="magick-description">Use pixel compression specified by <var>type</var> when writing the image.</p>
the chroma channels.</p>
<div style="margin: auto;">
- <h3><a id="connected-components"></a>-connected-components <var>connectivity</var></h3>
+ <h3><a class="anchor" id="connected-components"></a>-connected-components <var>connectivity</var></h3>
</div>
<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;">
- <h3><a id="contrast"></a>-contrast</h3>
+ <h3><a class="anchor" id="contrast"></a>-contrast</h3>
</div>
<p class="magick-description">Enhance or reduce the image contrast.</p>
<p>For a more pronounced effect you can repeat the option:</p>
-<pre><code>
-convert rose: -contrast -contrast rose_c2.png
+<pre class="highlight"><code>convert rose: -contrast -contrast rose_c2.png
</code></pre>
<div style="margin: auto;">
- <h3><a 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>
+ <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>
<p class="magick-description">Increase the contrast in an image by <var>stretching</var> the range of intensity values.</p>
<div style="margin: auto;">
- <h3><a id="convolve"></a>-convolve <var>kernel</var></h3>
+ <h3><a class="anchor" id="convolve"></a>-convolve <var>kernel</var></h3>
</div>
<p class="magick-description">Convolve an image with a user-supplied convolution kernel.</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="https://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;">
- <h3><a id="copy"></a>-copy <var>geometry</var> <var>offset</var></h3>
+ <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 id="crop"></a>-crop <var>geometry</var>{<var>@</var>}{<var>!</var>}</h3>
+ <h3><a class="anchor" id="crop"></a>-crop <var>geometry</var>{<var>@</var>}{<var>!</var>}</h3>
</div>
<p class="magick-description">Cut out one or more rectangular regions of the image.</p>
offset.</p>
<div style="margin: auto;">
- <h3><a id="cycle"></a>-cycle <var>amount</var></h3>
+ <h3><a class="anchor" id="cycle"></a>-cycle <var>amount</var></h3>
</div>
<p class="magick-description">displace image colormap by amount.</p>
<div style="margin: auto;">
- <h3><a id="debug"></a>-debug <var>events</var></h3>
+ <h3><a class="anchor" id="debug"></a>-debug <var>events</var></h3>
</div>
<p class="magick-description">enable debug printout.</p>
<p>For example, to log cache and blob events, use.</p>
-<pre><code>
-convert -debug "Cache,Blob" rose: rose.png
+<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
<div style="margin: auto;">
- <h3><a id="decipher"></a>-decipher <var>filename</var></h3>
+ <h3><a class="anchor" id="decipher"></a>-decipher <var>filename</var></h3>
</div>
<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 <var>filename</var>.</p>
<p>For more information, see the webpage, <a
-href="https://www.imagemagick.org/script/cipher.html">ImageMagick: Encipher or
+href="../www/cipher.html">ImageMagick: Encipher or
Decipher an Image</a>.</p>
<div style="margin: auto;">
- <h3><a id="deconstruct"></a>-deconstruct</h3>
+ <h3><a class="anchor" id="deconstruct"></a>-deconstruct</h3>
</div>
<p class="magick-description">find areas that has changed between images </p>
<div style="margin: auto;">
- <h3><a id="define"></a>-define <var>key</var>{<var>=value</var>}<var>...</var></h3>
+ <h3><a class="anchor" id="define"></a>-define <var>key</var>{<var>=value</var>}<var>...</var></h3>
</div>
<p class="magick-description">add specific global settings generally used to control coders and image processing operations.</p>
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
<tr>
<td>compose:args=<var>arguments</var></td>
<td>Sets certain compose argument values when using convert ... -compose ...
- -composite. See <a href="https://www.imagemagick.org/script/compose.html"
+ -composite. See <a href="compose.html"
>Image Composition</a></td>
</tr>
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.</td>
</tr>
<tr>
- <td>convolve:showkernel=<var>1</var></td>
+ <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>
</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
</tr>
<tr>
- <td>morphology:showkernel=<var>1</var></td>
+ <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>
the PNG file. Because the list is processed from left to right, you
can achieve this with a single define:</p>
-<pre><code>
--define png:include-chunk=none,gAMA
+<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
<p>The <a href="command-line-options.html#strip">-strip</a> option does the equivalent of the
following for PNG output:</p>
-<pre><code>
--define png:exclude-chunk=EXIF,iCCP,iTXt,sRGB,tEXt,zCCP,zTXt,date
+<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
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>
+
<tr>
<td>png:preserve-colormap[=<var>true</var>]</td>
<td>Use the existing image->colormap. Normally the PNG encoder will
<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
</tr>
<tr>
- <td>showkernel=<var>1</var></td>
+ <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>
<td>Allows one or more tag ID values to be ignored.</td>
</tr>
+ <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>
+
<tr>
<td>tiff:rows-per-strip=<var>value</var></td>
<td>Sets the number of rows per strip</td>
<tr>
<td>txt:compliance=<var>css</var></td>
- <td> </td>
+ <td>The first argument of a hsl() color is integer, not percentage</td>
</tr>
<tr>
<p>For example, to create a postscript file that will render only the black
pixels of a bilevel image, use:</p>
-<pre><code>
-convert bilevel.tif -define ps:imagemask eps3:stencil.ps
+<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>
-<pre><code>
--define registry:temporary-path=/data/tmp
+<pre class="highlight"><code>-define registry:temporary-path=/data/tmp
</code></pre>
<div style="margin: auto;">
- <h3><a id="delay"></a>-delay <var>ticks</var> <br />-delay <var>ticks</var>x<var>ticks-per-second</var> {<var><</var>} {<var>></var>}</h3>
+ <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>
<p class="magick-description">display the next image after pausing.</p>
<div style="margin: auto;">
- <h3><a id="delete"></a>-delete <var>indexes</var></h3>
+ <h3><a class="anchor" id="delete"></a>-delete <var>indexes</var></h3>
</div>
<p class="magick-description">delete the images specified by index, from the image sequence.</p>
<div style="margin: auto;">
- <h3><a id="density"></a>-density <var>width</var><br />-density <var>width</var>x<var>height</var></h3>
+ <h3><a class="anchor" id="density"></a>-density <var>width</var><br />-density <var>width</var>x<var>height</var></h3>
</div>
<p class="magick-description">Set the horizontal and vertical resolution of an image for rendering to devices.</p>
resolution, use the <a href="command-line-options.html#resample">-resample</a> option.</p>
<div style="margin: auto;">
- <h3><a id="depth"></a>-depth <var>value</var></h3>
+ <h3><a class="anchor" id="depth"></a>-depth <var>value</var></h3>
</div>
<p class="magick-description">depth of the image.</p>
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;">
- <h3><a id="descend"></a>-descend</h3>
+ <h3><a class="anchor" id="descend"></a>-descend</h3>
</div>
<p class="magick-description">obtain image by descending window hierarchy.</p>
<div style="margin: auto;">
- <h3><a id="deskew"></a>-deskew <var>threshold{%}</var></h3>
+ <h3><a class="anchor" id="deskew"></a>-deskew <var>threshold{%}</var></h3>
</div>
<p class="magick-description">straighten an image. A threshold of 40% works for most images.</p>
<var>true | false</var></code> to auto crop the image.</p>
<div style="margin: auto;">
- <h3><a id="despeckle"></a>-despeckle</h3>
+ <h3><a class="anchor" id="despeckle"></a>-despeckle</h3>
</div>
<p class="magick-description">reduce the speckles within an image.</p>
<div style="margin: auto;">
- <h3><a id="direction"></a>-direction <var>type</var></h3>
+ <h3><a class="anchor" id="direction"></a>-direction <var>type</var></h3>
</div>
-<p class="magick-description">render text right-to-left or left-to-right.</p>
+<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;">
- <h3><a id="displace"></a>-displace <var>horizontal-scale</var>{%}{!}<br />-displace <var>horizontal-scale</var>x<var>vertical-scale</var>{%}{!}</h3>
+ <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>
<p class="magick-description">shift image pixels as defined by a displacement map.</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;">
- <h3><a id="display"></a>-display <var>host:display[.screen]</var></h3>
+ <h3><a class="anchor" id="display"></a>-display <var>host:display[.screen]</var></h3>
</div>
<p class="magick-description">Specifies the X server to contact.</p>
X server. See <var>X(1)</var>.</p>
<div style="margin: auto;">
- <h3><a id="dispose"></a>-dispose <var>method</var></h3>
+ <h3><a class="anchor" id="dispose"></a>-dispose <var>method</var></h3>
</div>
<p class="magick-description">define the GIF disposal image setting for images that are being created or read in. </p>
disposal method for images already in memory.</p>
<div style="margin: auto;">
- <h3><a id="dissimilarity-threshold"></a>-dissimilarity-threshold <var>value</var></h3>
+ <h3><a class="anchor" id="dissimilarity-threshold"></a>-dissimilarity-threshold <var>value</var></h3>
</div>
<p class="magick-description">maximum RMSE for subimage match (default 0.2).</p>
<div style="margin: auto;">
- <h3><a id="dissolve"></a>-dissolve <var>src_percent</var>[x<var>dst_percent</var>]</h3>
+ <h3><a class="anchor" id="dissolve"></a>-dissolve <var>src_percent</var>[x<var>dst_percent</var>]</h3>
</div>
<p class="magick-description">dissolve an image into another by the given percent.</p>
images, you would need to use dissolve values of '50,100'. </p>
<div style="margin: auto;">
- <h3><a id="distort"></a>-distort <var>method arguments</var></h3>
+ <h3><a class="anchor" id="distort"></a>-distort <var>method arguments</var></h3>
</div>
<p class="magick-description">distort an image, using the given <var>method</var> and its required <var>arguments</var>.</p>
used to group the 4 sets of coordinate pairs, to make it easier to read and
understand.</p>
-<pre><code>
-convert rose: -virtual-pixel black \
+<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>
using '<code>perspective</code>' distortion. For example here we view
a infinitely tiled 'plane' all the way to the horizon. </p>
-<pre><code>
-convert -size 90x90 pattern:checkerboard -normalize -virtual-pixel tile \
+<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>
<div style="margin: auto;">
- <h3><a id="distribute-cache"></a>-distribute-cache <var>port</var></h3>
+ <h3><a class="anchor" id="distribute-cache"></a>-distribute-cache <var>port</var></h3>
</div>
<p class="magick-description">launch a distributed pixel cache server. </p>
<div style="margin: auto;">
- <h3><a id="dither"></a>-dither <var>method</var></h3>
+ <h3><a class="anchor" id="dither"></a>-dither <var>method</var></h3>
</div>
<p class="magick-description">Apply a Riemersma or Floyd-Steinberg error diffusion dither to
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;">
- <h3><a id="draw"></a>-draw <var>string</var></h3>
+ <h3><a class="anchor" id="draw"></a>-draw <var>string</var></h3>
</div>
<p class="magick-description">Annotate an image with one or more graphic primitives.</p>
<p>As an example, to define a circle centered at 100,100 that extends to
150,150 use:</p>
-<pre><code>
--draw 'circle 100,100 150,150'
+<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
<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>
-<pre><code>
--draw 'bezier 20,50 45,100 45,0 70,50'
+<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>
image keyword with the composite operator, image location, image size, and
filename:</p>
-<pre><code>
--draw 'image SrcOver 100,100 225,225 image.jpg'
+<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="http://www.imagemagick.org/www/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>
-<pre><code>
--draw "text 100,100 'Works like magick!' "
+<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><code>
-point
+<pre class="highlight"><code>point
replace
floodfill
filltoborder
<div style="margin: auto;">
- <h3><a id="duplicate"></a>-duplicate <var>count,indexes</var></h3>
+ <h3><a class="anchor" id="duplicate"></a>-duplicate <var>count,indexes</var></h3>
</div>
<p class="magick-description">duplicate an image one or more times.</p>
image sequence.</p>
<div style="margin: auto;">
- <h3><a id="edge"></a>-edge <var>radius</var></h3>
+ <h3><a class="anchor" id="edge"></a>-edge <var>radius</var></h3>
</div>
<p class="magick-description">detect edges within an image.</p>
<div style="margin: auto;">
- <h3><a id="emboss"></a>-emboss <var>radius</var></h3>
+ <h3><a class="anchor" id="emboss"></a>-emboss <var>radius</var></h3>
</div>
<p class="magick-description">emboss an image.</p>
<div style="margin: auto;">
- <h3><a id="encipher"></a>-encipher <var>filename</var></h3>
+ <h3><a class="anchor" id="encipher"></a>-encipher <var>filename</var></h3>
</div>
<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 <var>filename</var>.</p>
<p>For more information, see the webpage, <a
-href="https://www.imagemagick.org/script/cipher.html">ImageMagick: Encipher or
+href="../www/cipher.html">ImageMagick: Encipher or
Decipher an Image</a>.</p>
<div style="margin: auto;">
- <h3><a id="encoding"></a>-encoding <var>type</var></h3>
+ <h3><a class="anchor" id="encoding"></a>-encoding <var>type</var></h3>
</div>
<p class="magick-description">specify the text encoding.</p>
<p>Choose from</p>
-<pre><code>
-AdobeCustom AdobeExpert
+<pre class="highlight"><code>AdobeCustom AdobeExpert
AdobeStandard AppleRoman
BIG5 GB2312
Latin 2 None
</code></pre>
<div style="margin: auto;">
- <h3><a id="endian"></a>-endian <var>type</var></h3>
+ <h3><a class="anchor" id="endian"></a>-endian <var>type</var></h3>
</div>
<p class="magick-description">Specify endianness (<code>MSB</code> or <code>LSB</code>) of the image.</p>
<div style="margin: auto;">
- <h3><a id="enhance"></a>-enhance</h3>
+ <h3><a class="anchor" id="enhance"></a>-enhance</h3>
</div>
<p class="magick-description">Apply a digital filter to enhance a noisy image.</p>
<div style="margin: auto;">
- <h3><a id="equalize"></a>-equalize</h3>
+ <h3><a class="anchor" id="equalize"></a>-equalize</h3>
</div>
<p class="magick-description">perform histogram equalization on the image channel-by-channel.</p>
-colorspace RGB</code> ...</p>
<div style="margin: auto;">
- <h3><a id="evaluate"></a>-evaluate <var>operator value</var></h3>
+ <h3><a class="anchor" id="evaluate"></a>-evaluate <var>operator value</var></h3>
</div>
<p class="magick-description">Alter channel pixels by evaluating an arithmetic, relational, or logical expression.</p>
multi-value version of evaluate. </p>
<div style="margin: auto;">
- <h3><a id="evaluate-sequence"></a>-evaluate-sequence <var>operator</var></h3>
+ <h3><a class="anchor" id="evaluate-sequence"></a>-evaluate-sequence <var>operator</var></h3>
</div>
-<p class="magick-description">Alter channel pixels by evaluating an arithmetic, relational, or
-logical expression over a sequence of images.</p>
+<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;">
- <h3><a id="extent"></a>-extent <var>geometry</var></h3>
+ <h3><a class="anchor" id="extent"></a>-extent <var>geometry</var></h3>
</div>
<p class="magick-description">Set the image size and offset.</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>
-<pre><code>
-convert input.jpg -resize 800x600 -background black -compose Copy \
+<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;">
- <h3><a id="extract"></a>-extract <var>geometry</var></h3>
+ <h3><a class="anchor" id="extract"></a>-extract <var>geometry</var></h3>
</div>
<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>
-<pre><code>
-convert -size 16000x16000 -depth 8 -extract 640x480+1280+960 \
+<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"
<p>If you omit the offsets, as in</p>
-<pre><code>
-convert -size 16000x16000 -depth 8 -extract 640x480 \
+<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>
-<pre><code>
-convert -size 16000x16000 -depth 8 -resize 640x480 image.rgb image.png
+<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;">
- <h3><a id="family"></a>-family <var>fontFamily</var></h3>
+ <h3><a class="anchor" id="family"></a>-family <var>fontFamily</var></h3>
</div>
<p class="magick-description">Set a font family for text.</p>
href="command-line-options.html#style">-style</a>, and <a href="command-line-options.html#weight">-weight</a>. </p>
<div style="margin: auto;">
- <h3><a id="features"></a>-features <var>distance</var></h3>
+ <h3><a class="anchor" id="features"></a>-features <var>distance</var></h3>
</div>
<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><code>
-Angular Second Moment Sum Entropy
+<pre class="highlight"><code>Angular Second Moment Sum Entropy
Contrast Entropy
Correlation Difference Variance
Sum of Squares Variance Difference Entropy
</code></pre>
<div style="margin: auto;">
- <h3><a id="fft"></a>-fft</h3>
+ <h3><a class="anchor" id="fft"></a>-fft</h3>
</div>
<p class="magick-description">implements the forward discrete Fourier transform (DFT).</p>
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>
-<pre><code>
-convert image.png -fft fft_image.miff
+<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>
-<pre><code>
-convert image.png -fft fft_image.png
+<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
enhance the darker values more in comparison to the lighter values. This can
be done, for example, as follows:</p>
-<pre><code>
-convert fft_image.miff[0] -contrast-stretch 0 \
+<pre class="highlight"><code>convert fft_image.miff[0] -contrast-stretch 0 \
-evaluate log 1000 fft_image_spectrum.png"
</code></pre>
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="
https://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>
<div style="margin: auto;">
- <h3><a id="fill"></a>-fill <var>color</var></h3>
+ <h3><a class="anchor" id="fill"></a>-fill <var>color</var></h3>
</div>
<p class="magick-description">color to use when filling a graphic primitive.</p>
<p>For example,</p>
-<pre><code>
--fill blue
+<pre class="highlight"><code>-fill blue
-fill "#ddddff"
-fill "rgb(255,255,255)"
</code></pre>
<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;">
- <h3><a id="filter"></a>-filter <var>type</var></h3>
+ <h3><a class="anchor" id="filter"></a>-filter <var>type</var></h3>
</div>
<p class="magick-description">Use this <var>type</var> of filter when resizing or distorting an image.</p>
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><code>
-Point Hermite Cubic
+<pre class="highlight"><code>Point Hermite Cubic
Box Gaussian Catrom
Triangle Quadratic Mitchell
CubicSpline
using these functions will define a 'Windowed' filter, appropriate to the
operator involved. Windowed filters include: </p>
-<pre><code>
-Lanczos Hamming Parzen
+<pre class="highlight"><code>Lanczos Hamming Parzen
Blackman Kaiser Welsh
Hanning Bartlett Bohman
</code></pre>
<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 effects <code>Gaussian</code> but
+ 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>'
<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 effects Kaiser windowing function, and
- does not effect any other attributes.
+ 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
<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 effects Kaiser windowing function,
- and does not effect any other attributes. </td>
+ will override that setting. It only affects Kaiser windowing function,
+ and does not affect any other attributes. </td>
</tr>
<tr>
<p>For example, to get a 8 lobe jinc windowed sinc filter (Genseng filter?):</p>
-<pre><code>
-convert image.png \
+<pre class="highlight"><code>convert image.png \
-filter sinc \
-set filter:window=jinc \
-set filter:lobes=8 \
<p>Or a raw un-windowed Sinc filter with 4 lobes:</p>
-<pre><code>
-convert image.png \
+<pre class="highlight"><code>convert image.png \
-set filter:filter=sinc \
-set filter:lobes=4 \
-resize 150% image.jpg"
a '<code>Box</code>' filter. For example the '<code>Welch</code> parabolic
windowing function. </p>
-<pre><code>
-convert null: -define filter:filter=Box \
+<pre class="highlight"><code>convert null: -define filter:filter=Box \
-define filter:window=Welch \
-define filter:support=1.0 \
-define filter:verbose=1 \
<div style="margin: auto;">
- <h3><a id="flatten"></a>-flatten</h3>
+ <h3><a class="anchor" id="flatten"></a>-flatten</h3>
</div>
<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;">
- <h3><a id="flip"></a>-flip</h3>
+ <h3><a class="anchor" id="flip"></a>-flip</h3>
</div>
<p class="magick-description">create a <var>mirror image</var></p>
<div style="margin: auto;">
- <h3><a id="floodfill"></a>-floodfill {<var>+-</var>}<var>x</var>{<var>+-</var>}<var>y</var> <var>color</var></h3>
+ <h3><a class="anchor" id="floodfill"></a>-floodfill {<var>+-</var>}<var>x</var>{<var>+-</var>}<var>y</var> <var>color</var></h3>
</div>
<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 <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>
<div style="margin: auto;">
- <h3><a id="flop"></a>-flop</h3>
+ <h3><a class="anchor" id="flop"></a>-flop</h3>
</div>
<p class="magick-description">create a <var>mirror image</var>.</p>
<div style="margin: auto;">
- <h3><a id="font"></a>-font <var>name</var></h3>
+ <h3><a class="anchor" id="font"></a>-font <var>name</var></h3>
</div>
<p class="magick-description">set the font to use when annotating images with text, or creating labels.</p>
<div style="margin: auto;">
- <h3><a id="foreground"></a>-foreground <var>color</var></h3>
+ <h3><a class="anchor" id="foreground"></a>-foreground <var>color</var></h3>
</div>
<p class="magick-description">Define the foreground color for menus.", "display</p>
<p>The default foreground color is black.</p>
<div style="margin: auto;">
- <h3><a id="format"></a>-format <var>type</var></h3>
+ <h3><a class="anchor" id="format"></a>-format <var>type</var></h3>
</div>
<p class="magick-description">the image format type.</p>
filename becomes <var>image.tiff</var>.</p>
<div style="margin: auto;">
- <h3><a id="format_identify_"></a>-format <var>string</var></h3>
+ <h3><a class="anchor" id="format_identify_"></a>-format <var>string</var></h3>
</div>
<p class="magick-description">output formatted image characteristics.</p>
option.</p>
<div style="margin: auto;">
- <h3><a id="frame"></a>-frame <var>geometry</var></h3>
+ <h3><a class="anchor" id="frame"></a>-frame <var>geometry</var></h3>
</div>
<p class="magick-description">Surround the image with a border or beveled frame.</p>
<div style="margin: auto;">
- <h3><a id="frame_import_"></a>-frame</h3>
+ <h3><a class="anchor" id="frame_import_"></a>-frame</h3>
</div>
<p class="magick-description">include the X window frame in the imported image. </p>
<div style="margin: auto;">
- <h3><a id="function"></a>-function <var>function</var> <var>parameters</var></h3>
+ <h3><a class="anchor" id="function"></a>-function <var>function</var> <var>parameters</var></h3>
</div>
<p class="magick-description">Apply a function to channel values.</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><code>
-Polynomial
+<pre class="highlight"><code>Polynomial
Sinusoid
Arcsin
Arctan
these being the coefficients of a polynomial, in decreasing order of degree.
That is, entering</p>
-<pre><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>
+<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>
-<pre><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>,
+<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><var>u</var></b> is pixel's original normalized channel value.</p>
sinusoidally by setting frequency, phase shift, amplitude, and a bias. These
values are given as one to four parameters, as follows,</p>
-<pre><code>
--function <code>Sinusoid</code> <var>freq</var>,[<var>phase</var>,[<var>amp</var>,[<var>bias</var>]]]
+<pre class="highlight"><code>-function <code>Sinusoid</code> <var>freq</var>,[<var>phase</var>,[<var>amp</var>,[<var>bias</var>]]]
</code></pre>
<p>where <var>phase</var> is in degrees. (The domain [0,1] of the function
The result is that if a pixel's normalized channel value is originally
<b><var>u</var></b>, its resulting normalized value is given by </p>
-<pre><code>
-<var>amp</var> * sin(2*π* (<var>freq</var> * <b><var>u</var></b> + <var>phase</var> / 360)) + <var>bias</var>
+<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><var>u</var></b>=0 and 1, resp.), oscillating three times between
.7−.2=.5 and .7+.2=.9. </p>
-<pre><code>
--function Sinusoid 3,-90,.2,.7
+<pre class="highlight"><code>-function Sinusoid 3,-90,.2,.7
</code></pre>
<p>The default values of <var>amp</var> and <var>bias</var> are both .5. The default for <var>phase</var>
The curve can be adjusted relative to both the input values and output range
of values.</p>
-<pre><code>
--function <code>ArcSin</code> <var>width</var>,[<var>center</var>,[<var>range</var>,[<var>bias</var>]]]
+<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 (<var>width</var>), and output (<var>width</var>) values. '<code>1.0,0.5,1.0,0.5</code>' </p>
-<pre><code>
-<var>range</var>/π * asin( 2/<var>width</var> * ( <b><var>u</var></b> - <var>center</var> ) ) + <var>bias</var>
+<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>
limit values at infinities, though a center using the given slope value.
All these values can be adjusted via the arguments.</p>
-<pre><code>
--function <code>ArcTan</code> <var>slope</var>,[<var>center</var>,[<var>range</var>,[<var>bias</var>]]]
+<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>
-<pre><code>
-<var>range</var>/π * atan( <var>slope</var>*π * ( <b><var>u</var></b> - <var>center</var> ) ) + <var>bias</var>
+<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;">
- <h3><a id="fuzz"></a>-fuzz <var>distance</var>{<var>%</var>}</h3>
+ <h3><a class="anchor" id="fuzz"></a>-fuzz <var>distance</var>{<var>%</var>}</h3>
</div>
<p class="magick-description">Colors within this <var>distance</var> are considered equal.</p>
<div style="margin: auto;">
- <h3><a id="fx"></a>-fx <var>expression</var></h3>
+ <h3><a class="anchor" id="fx"></a>-fx <var>expression</var></h3>
</div>
<p class="magick-description">apply a mathematical expression to an image or image channels.</p>
<div style="margin: auto;">
- <h3><a id="gamma"></a>-gamma <var>value</var></h3>
+ <h3><a class="anchor" id="gamma"></a>-gamma <var>value</var></h3>
</div>
<p class="magick-description">level of gamma correction.</p>
display gamma; e.g., if your image is sRGB and you want to write a PNG gAMA
chunk, use</p>
-<pre><code>
-convert input.png +gamma .45455 output.png
+<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;">
- <h3><a id="gaussian-blur"></a>-gaussian-blur <var>radius</var><br />-gaussian-blur <var>radius</var>x<var>sigma</var></h3>
+ <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>
<p class="magick-description">Blur the image with a Gaussian operator.</p>
</p>
<p>The larger the <var >Radius</var> the radius the slower the
-operation is. However too small a <var >Radius</var>, and sever
+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>
<div style="margin: auto;">
- <h3><a id="geometry"></a>-geometry <var>geometry</var></h3>
+ <h3><a class="anchor" id="geometry"></a>-geometry <var>geometry</var></h3>
</div>
<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;">
- <h3><a id="gravity"></a>-gravity <var>type</var></h3>
+ <h3><a class="anchor" id="gravity"></a>-gravity <var>type</var></h3>
</div>
<p class="magick-description">Sets the current gravity suggestion for various other settings and options.</p>
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>
-<pre><code>
-convert image.png -gravity Center -region 10x10-40+20 \
+<pre class="highlight"><code>convert image.png -gravity Center -region 10x10-40+20 \
-negate output.png
</code></pre>
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;">
- <h3><a id="grayscale"></a>-grayscale <var>method</var></h3>
+ <h3><a class="anchor" id="grayscale"></a>-grayscale <var>method</var></h3>
</div>
<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>
-<pre><code>
-convert in.png -grayscale Rec709Luminance out.png
+<pre class="highlight"><code>convert in.png -grayscale Rec709Luminance out.png
</code></pre>
<p>which is equivalent to:</p>
-<pre><code>
-convert in.png -colorspace gray out.png
-</code></pre>
+<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>
-<pre><code>
-convert in.png -grayscale Rec709Luma out.png
+<pre class="highlight"><code>convert in.png -grayscale Rec709Luma out.png
</code></pre>
<p>which is equivalent to:</p>
-<pre><code>
-convert in.png -set colorspace RGB -colorspace gray out.png
+<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,
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;">
- <h3><a id="green-primary"></a>-green-primary <var>x,y</var></h3>
+ <h3><a class="anchor" id="green-primary"></a>-green-primary <var>x,y</var></h3>
</div>
<p class="magick-description">green chromaticity primary point.</p>
<div style="margin: auto;">
- <h3><a id="hald-clut"></a>-hald-clut</h3>
+ <h3><a class="anchor" id="hald-clut"></a>-hald-clut</h3>
</div>
<p class="magick-description">apply a Hald color lookup table to the image.</p>
can apply any color transformation to the Hald image and then use this option
to apply the transform to the image. </p>
-<pre><code>
-convert image.png hald.png -hald-clut transform.png
+<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
<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
<div style="margin: auto;">
- <h3><a id="help"></a>-help</h3>
+ <h3><a class="anchor" id="help"></a>-help</h3>
</div>
<p class="magick-description">print usage instructions.</p>
<div style="margin: auto;">
- <h3><a id="highlight-color"></a>-highlight-color <var>color</var></h3>
+ <h3><a class="anchor" id="highlight-color"></a>-highlight-color <var>color</var></h3>
</div>
<p class="magick-description">when comparing images, emphasize pixel differences with this color.</p>
<div style="margin: auto;">
- <h3><a id="hough-lines"></a>-hough-lines <var>width</var>x<var>height</var>{<var>+threshold</var>}</h3>
+ <h3><a class="anchor" id="hough-lines"></a>-hough-lines <var>width</var>x<var>height</var>{<var>+threshold</var>}</h3>
</div>
<p class="magick-description">identify straight lines in the image (e.g. -hough-lines 9x9+195).</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;">
- <h3><a id="iconGeometry"></a>-iconGeometry <var>geometry</var></h3>
+ <h3><a class="anchor" id="iconGeometry"></a>-iconGeometry <var>geometry</var></h3>
</div>
<p class="magick-description">specify the icon geometry.</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;">
- <h3><a id="iconic"></a>-iconic</h3>
+ <h3><a class="anchor" id="iconic"></a>-iconic</h3>
</div>
<p class="magick-description">start in icon mode in X Windows", 'animate', 'display</p>
<div style="margin: auto;">
- <h3><a id="identify"></a>-identify</h3>
+ <h3><a class="anchor" id="identify"></a>-identify</h3>
</div>
<p class="magick-description">identify the format and characteristics of the image.</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="http://www.imagemagick.org/www/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;">
- <h3><a id="ift"></a>-ift</h3>
+ <h3><a class="anchor" id="ift"></a>-ift</h3>
</div>
<p class="magick-description">implements the inverse discrete Fourier transform (DFT).</p>
<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>
-<pre><code>
-convert fft_image.miff -ift fft_image_ift.png
+<pre class="highlight"><code>convert fft_image.miff -ift fft_image_ift.png
</code></pre>
<p>or</p>
-<pre><code>
-convert fft_image-0.png fft_image-1.png -ift fft_image_ift.png
+<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
<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;">
- <h3><a id="immutable"></a>-immutable</h3>
+ <h3><a class="anchor" id="immutable"></a>-immutable</h3>
</div>
<p class="magick-description">make image immutable.</p>
<div style="margin: auto;">
- <h3><a id="implode"></a>-implode <var>factor</var></h3>
+ <h3><a class="anchor" id="implode"></a>-implode <var>factor</var></h3>
</div>
<p class="magick-description">implode image pixels about the center.</p>
<div style="margin: auto;">
- <h3><a id="insert"></a>-insert <var>index</var></h3>
+ <h3><a class="anchor" id="insert"></a>-insert <var>index</var></h3>
</div>
<p class="magick-description">insert the last image into the image sequence.</p>
Consequently this has no effect on the image sequence order.</p>
<div style="margin: auto;">
- <h3><a id="intensity"></a>-intensity <var>method</var></h3>
+ <h3><a class="anchor" id="intensity"></a>-intensity <var>method</var></h3>
</div>
<p class="magick-description">method to generate intensity value from pixel.</p>
<p>ImageMagick provides a number of methods used in situations where an
operator 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>
+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
what that is, or what colorspace the image is currently using.</p>
<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>
+<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
<p>Operators affected by the <a href="command-line-options.html#intensity" >-intensity</a> setting include:</p>
-<pre><code>
--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)
</code></pre>
<div style="margin: auto;">
- <h3><a id="intent"></a>-intent <var>type</var></h3>
+ <h3><a class="anchor" id="intent"></a>-intent <var>type</var></h3>
</div>
<p class="magick-description">use this type of rendering intent when managing the image color.</p>
<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;">
- <h3><a id="interlace"></a>-interlace <var>type</var></h3>
+ <h3><a class="anchor" id="interlace"></a>-interlace <var>type</var></h3>
</div>
<p class="magick-description">the type of interlacing scheme.</p>
<p>Choose from:</p>
-<pre><code>
-none
+<pre class="highlight"><code>none
line
plane
partition
interlace</a>.</p>
<div style="margin: auto;">
- <h3><a id="interpolate"></a>-interpolate <var>type</var></h3>
+ <h3><a class="anchor" id="interpolate"></a>-interpolate <var>type</var></h3>
</div>
<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>
point that falls between two, or even four different colored pixels. </p>
<dl class="row">
- <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">nearest-neighbor</dt>
- <dd class="col-md-8">The nearest pixel to the lookup point (rounded function)</dd>
<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">bicubic</dt>
- <dd class="col-md-8">Fitted bicubic-spines of surrounding 16 pixels</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>
- <dt class="col-md-4">filter</dt>
- <dd class="col-md-8">Use resize <a href="command-line-options.html#filter">-filter</a> settings</dd>
</dl>
<p>This most important for distortion operators such as <a href="command-line-options.html#distort"
<div style="margin: auto;">
- <h3><a id="interline-spacing"></a>-interline-spacing <var>value</var></h3>
+ <h3><a class="anchor" id="interline-spacing"></a>-interline-spacing <var>value</var></h3>
</div>
<p class="magick-description">the space between two text lines.</p>
<div style="margin: auto;">
- <h3><a id="interword-spacing"></a>-interword-spacing <var>value</var></h3>
+ <h3><a class="anchor" id="interword-spacing"></a>-interword-spacing <var>value</var></h3>
</div>
<p class="magick-description">the space between two words.</p>
<div style="margin: auto;">
- <h3><a id="kerning"></a>-kerning <var>value</var></h3>
+ <h3><a class="anchor" id="kerning"></a>-kerning <var>value</var></h3>
</div>
<p class="magick-description">the space between two letters.</p>
<div style="margin: auto;">
- <h3><a id="kuwahara"></a>-kuwahara <var>radius</var><br />-kuwahara <var>radius</var>x<var>sigma</var></h3>
+ <h3><a class="anchor" id="kuwahara"></a>-kuwahara <var>radius</var><br />-kuwahara <var>radius</var>x<var>sigma</var></h3>
</div>
<p class="magick-description">edge preserving noise reduction filter.</p>
<div style="margin: auto;">
- <h3><a id="label"></a>-label <var>name</var></h3>
+ <h3><a class="anchor" id="label"></a>-label <var>name</var></h3>
</div>
<p class="magick-description">assign a label to an image.</p>
<p>For example,</p>
-<pre><code>
--label "%m:%f %wx%h" bird.miff
+<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
<div style="margin: auto;">
- <h3><a id="lat"></a>-lat <var>width</var><br />-lat <var>width</var>x<var>height</var>{<var>+-</var>}<var>offset</var>{<var>%</var>}</h3>
+ <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>
<p class="magick-description">perform local adaptive threshold.</p>
<div style="margin: auto;">
- <h3><a id="layers"></a>-layers <var>method</var></h3>
+ <h3><a class="anchor" id="layers"></a>-layers <var>method</var></h3>
</div>
<p class="magick-description">handle multiple images forming a set of image layers or animation frames.</p>
<div style="margin: auto;">
- <h3><a id="level"></a>-level <var>black_point</var>{,<var>white_point</var>}{<var>%</var>}{,<var>gamma</var>}</h3>
+ <h3><a class="anchor" id="level"></a>-level <var>black_point</var>{,<var>white_point</var>}{<var>%</var>}{,<var>gamma</var>}</h3>
</div>
<p class="magick-description">adjust the level of image channels.</p>
<div style="margin: auto;">
- <h3><a id="level-colors"></a>-level-colors {<var>black_color</var>}{,}{<var>white_color</var>}</h3>
+ <h3><a class="anchor" id="level-colors"></a>-level-colors {<var>black_color</var>}{,}{<var>white_color</var>}</h3>
</div>
<p class="magick-description">adjust the level of an image using the provided dash separated colors.</p>
'<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>
<div style="margin: auto;">
- <h3><a id="limit"></a>-limit <var>type value</var></h3>
+ <h3><a class="anchor" id="limit"></a>-limit <var>type value</var></h3>
</div>
<p class="magick-description">Set the pixel cache resource limit.</p>
compensating actions, if possible. For example, the following limits
memory:</p>
-<pre><code>
--limit memory 32MiB -limit map 64MiB
+<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>
-<pre><code>
--> identify -list resource
+<pre class="highlight"><code>-> identify -list resource
Resource limits:
Width: 100MP
Height: 100MP
the Internet. To assure ImageMagick does not exceed 10MiB of memory you can
simply set the area limit to 10MiB:</p>
-<pre><code>
--limit area 10MB
+<pre class="highlight"><code>-limit area 10MB
</code></pre>
<p>Now whenever a large image is processed, the pixels are automagically
might inadvertently upload a huge image to process, you should set a disk
limit as well:</p>
-<pre><code>
--limit area 10MB -limit disk 500MB
+<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;">
- <h3><a 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>
+ <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>
<p class="magick-description">Linear with saturation stretch.</p>
<div style="margin: auto;">
- <h3><a id="linewidth"></a>-linewidth</h3>
+ <h3><a class="anchor" id="linewidth"></a>-linewidth</h3>
</div>
<p class="magick-description">the line width for subsequent draw operations.</p>
<div style="margin: auto;">
- <h3><a id="liquid-rescale"></a>-liquid-rescale <var>geometry</var></h3>
+ <h3><a class="anchor" id="liquid-rescale"></a>-liquid-rescale <var>geometry</var></h3>
</div>
<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;">
- <h3><a id="list"></a>-list <var>type</var></h3>
+ <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>
list</code>" to get a complete listing of all the "<code>-list</code>" arguments
available:</p>
-<pre><code>
-identify -list list
+<pre class="highlight"><code>identify -list list
</code></pre>
<div style="margin: auto;">
- <h3><a id="log"></a>-log <var>string</var></h3>
+ <h3><a class="anchor" id="log"></a>-log <var>string</var></h3>
</div>
<p class="magick-description">Specify format for debug log.</p>
<p>For example:</p>
-<pre><code>
-convert -debug coders -log "%u %m:%l %e" in.gif out.png
+<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;">
- <h3><a id="loop"></a>-loop <var>iterations</var></h3>
+ <h3><a class="anchor" id="loop"></a>-loop <var>iterations</var></h3>
</div>
<p class="magick-description">add Netscape loop extension to your GIF animation.</p>
times.</p>
<div style="margin: auto;">
- <h3><a id="lowlight-color"></a>-lowlight-color <var>color</var></h3>
+ <h3><a class="anchor" id="lowlight-color"></a>-lowlight-color <var>color</var></h3>
</div>
<p class="magick-description">when comparing images, de-emphasize pixel differences with this color.</p>
<div style="margin: auto;">
- <h3><a id="magnify"></a>-magnify</h3>
+ <h3><a class="anchor" id="magnify"></a>-magnify</h3>
</div>
<p class="magick-description">double the size of the image with pixel art scaling.</p>
<div style="margin: auto;">
- <h3><a id="map"></a>-map <var>type</var></h3>
+ <h3><a class="anchor" id="map"></a>-map <var>type</var></h3>
</div>
<p class="magick-description">Display image using this <var>type</var>.</p>
<p>Choose from these <var>Standard Colormap</var> types:</p>
-<pre><code>
-best
+<pre class="highlight"><code>best
default
gray
red
<div style="margin: auto;">
- <h3><a id="map_stream_"></a>-map <var>components</var></h3>
+ <h3><a class="anchor" id="map_stream_"></a>-map <var>components</var></h3>
</div>
<p class="magick-description">pixel map.</p>
<div style="margin: auto;">
- <h3><a id="mattecolor"></a>-mattecolor <var>color</var></h3>
+ <h3><a class="anchor" id="mattecolor"></a>-mattecolor <var>color</var></h3>
</div>
<p class="magick-description">Specify the color to be used with the <a href="command-line-options.html#frame">-frame</a> option.</p>
style="background-color: #bdbdbd;">this shade of gray</span>.</p>
<div style="margin: auto;">
- <h3><a id="maximum"></a>-maximum</h3>
+ <h3><a class="anchor" id="maximum"></a>-maximum</h3>
</div>
<p class="magick-description">return the maximum intensity of an image sequence.</p>
name. </p>
<div style="margin: auto;">
- <h3><a id="median"></a>-median <var>geometry</var></h3>
+ <h3><a class="anchor" id="median"></a>-median <var>geometry</var></h3>
</div>
<p class="magick-description">apply a median filter to the image.</p>
name. </p>
<div style="margin: auto;">
- <h3><a id="mean-shift"></a>-mean-shift <var>width</var>x<var>height</var>{<var>+distance</var>{%}</h3>
+ <h3><a class="anchor" id="mean-shift"></a>-mean-shift <var>width</var>x<var>height</var>{<var>+distance</var>{%}</h3>
</div>
<p class="magick-description">image noise removal and color reduction/segmentation (e.g. -mean-shift 7x7+10%).</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;">
- <h3><a id="metric"></a>-metric <var>type</var></h3>
+ <h3><a class="anchor" id="metric"></a>-metric <var>type</var></h3>
</div>
<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>
<dl class="row">
-<dt class="col-md-4">AE</dt><dd class="col-md-8"> absolute error count, number of different pixels (-fuzz effected)</dd>
+<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>
<div style="margin: auto;">
- <h3><a id="minimum"></a>-minimum</h3>
+ <h3><a class="anchor" id="minimum"></a>-minimum</h3>
</div>
<p class="magick-description">return the minimum intensity of an image sequence.</p>
<div style="margin: auto;">
- <h3><a id="mode"></a>-mode <var>geometry</var></h3>
+ <h3><a class="anchor" id="mode"></a>-mode <var>geometry</var></h3>
</div>
<p class="magick-description">make each pixel the \'predominant color\' of the neighborhood.'</p>
<div style="margin: auto;">
- <h3><a id="modulate"></a>-modulate <var>brightness</var>[,<var>saturation</var>,<var>hue</var>]</h3>
+ <h3><a class="anchor" id="modulate"></a>-modulate <var>brightness</var>[,<var>saturation</var>,<var>hue</var>]</h3>
</div>
<p class="magick-description">Vary the <var>brightness</var>, <var>saturation</var>, and <var>hue</var> of an image.</p>
>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>
-<pre><code>
-convert image.png -set option:modulate:colorspace hsb -modulate 120,90 modulate.png
+<pre class="highlight"><code>convert image.png -set option:modulate:colorspace hsb -modulate 120,90 modulate.png
</code></pre>
<div style="margin: auto;">
- <h3><a id="moments"></a>-moments</h3>
+ <h3><a class="anchor" id="moments"></a>-moments</h3>
</div>
<p class="magick-description">report image moments and perceptual hash.</p>
<div style="margin: auto;">
- <h3><a id="monitor"></a>-monitor</h3>
+ <h3><a class="anchor" id="monitor"></a>-monitor</h3>
</div>
<p class="magick-description">monitor progress.</p>
<div style="margin: auto;">
- <h3><a id="monochrome"></a>-monochrome</h3>
+ <h3><a class="anchor" id="monochrome"></a>-monochrome</h3>
</div>
<p class="magick-description">transform the image to black and white.</p>
<div style="margin: auto;">
- <h3><a id="morph"></a>-morph <var>frames</var></h3>
+ <h3><a class="anchor" id="morph"></a>-morph <var>frames</var></h3>
</div>
<p class="magick-description">morphs an image sequence.</p>
<div style="margin: auto;">
- <h3><a id="morphology"></a>-morphology</h3>
+ <h3><a class="anchor" id="morphology"></a>-morphology</h3>
<h3>-morphology <var>method</var> <var>kernel</var></h3>
</div>
<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="https://www.imagemagick.org/Usage/morphology/" >IM Usage Examples,
+href="../Usage/morphology/" >IM Usage Examples,
Morphology</a>. </p>
<div style="margin: auto;">
- <h3><a id="mosaic"></a>-mosaic</h3>
+ <h3><a class="anchor" id="mosaic"></a>-mosaic</h3>
</div>
<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;">
- <h3><a id="motion-blur"></a>-motion-blur <var>radius</var><br />-motion-blur <var>radius</var>x<var>sigma</var>+<var>angle</var></h3>
+ <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>
<p class="magick-description">simulate motion blur.</p>
</p>
<div style="margin: auto;">
- <h3><a id="name"></a>-name</h3>
+ <h3><a class="anchor" id="name"></a>-name</h3>
</div>
<p class="magick-description">name an image.</p>
<div style="margin: auto;">
- <h3><a id="negate"></a>-negate</h3>
+ <h3><a class="anchor" id="negate"></a>-negate</h3>
</div>
<p class="magick-description">replace each pixel with its complementary color.</p>
negate the grayscale pixels of the image.</p>
<div style="margin: auto;">
- <h3><a id="noise"></a>-noise <var>geometry</var><br/>
+ <h3><a class="anchor" id="noise"></a>-noise <var>geometry</var><br/>
+noise <var>type</var></h3>
</div>
<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><code>
-Gaussian
+<pre class="highlight"><code>Gaussian
Impulse
Laplacian
Multiplicative
<div style="margin: auto;">
- <h3><a id="normalize"></a>-normalize</h3>
+ <h3><a class="anchor" id="normalize"></a>-normalize</h3>
</div>
<p class="magick-description">Increase the contrast in an image by <var>stretching</var> the range of intensity values.</p>
<div style="margin: auto;">
- <h3><a id="opaque"></a>-opaque <var>color</var></h3>
+ <h3><a class="anchor" id="opaque"></a>-opaque <var>color</var></h3>
</div>
<p class="magick-description">change this color to the fill color within the image.</p>
<div style="margin: auto;">
- <h3><a id="ordered-dither"></a>-ordered-dither <var>threshold_map</var>{,<var>level</var>...}</h3>
+ <h3><a class="anchor" id="ordered-dither"></a>-ordered-dither <var>threshold_map</var>{,<var>level</var>...}</h3>
</div>
<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
<div style="margin: auto;">
- <h3><a id="orient"></a>-orient <var>image orientation</var></h3>
+ <h3><a class="anchor" id="orient"></a>-orient <var>image orientation</var></h3>
</div>
<p class="magick-description">specify orientation of a digital camera image.</p>
<p>Choose from these orientations:</p>
-<pre><code>
-bottom-left right-top
+<pre class="highlight"><code>bottom-left right-top
bottom-right top-left
left-bottom top-right
left-top undefined
<div style="margin: auto;">
- <h3><a id="page"></a>-page <var>geometry</var><br/>
+ <h3><a class="anchor" id="page"></a>-page <var>geometry</var><br/>
-page <var>media</var>[<var>offset</var>][{<var>^!<></var>}]<br/>
+page
</h3>
<p>Use <a href="command-line-options.html#page">+page</a> to remove the page settings for an image.</p>
<div style="margin: auto;">
- <h3><a id="paint"></a>-paint <var>radius</var></h3>
+ <h3><a class="anchor" id="paint"></a>-paint <var>radius</var></h3>
</div>
<p class="magick-description">simulate an oil painting.</p>
neighborhood whose width is specified with <var>radius</var>.</p>
<div style="margin: auto;">
- <h3><a id="path"></a>-path <var>path</var></h3></div>
+ <h3><a class="anchor" id="path"></a>-path <var>path</var></h3></div>
<p class="magick-description">write images to this path on disk.</p>
<div style="margin: auto;">
- <h3><a id="pause_animate_"></a>-pause <var>seconds</var></h3>
+ <h3><a class="anchor" id="pause_animate_"></a>-pause <var>seconds</var></h3>
</div>
<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;">
- <h3><a id="pause_import_"></a>-pause <var>seconds</var></h3>
+ <h3><a class="anchor" id="pause_import_"></a>-pause <var>seconds</var></h3>
</div>
<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;">
- <h3><a id="perceptible"></a>-perceptible <var>epsilon</var></h3>
+ <h3><a class="anchor" id="perceptible"></a>-perceptible <var>epsilon</var></h3>
</div>
<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;">
- <h3><a id="ping"></a>-ping</h3>
+ <h3><a class="anchor" id="ping"></a>-ping</h3>
</div>
<p class="magick-description">efficiently determine image characteristics.</p>
<div style="margin: auto;">
- <h3><a id="pointsize"></a>-pointsize <var>value</var></h3>
+ <h3><a class="anchor" id="pointsize"></a>-pointsize <var>value</var></h3>
</div>
<p class="magick-description">pointsize of the PostScript, OPTION1, or TrueType font.</p>
<div style="margin: auto;">
- <h3><a id="polaroid"></a>-polaroid <var>angle</var></h3>
+ <h3><a class="anchor" id="polaroid"></a>-polaroid <var>angle</var></h3>
</div>
<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;">
- <h3><a id="poly"></a>-poly <var>"wt,exp ..."</var></h3>
+ <h3><a class="anchor" id="poly"></a>-poly <var>"wt,exp ..."</var></h3>
</div>
<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>
<div style="margin: auto;">
- <h3><a id="posterize"></a>-posterize <var>levels</var></h3>
+ <h3><a class="anchor" id="posterize"></a>-posterize <var>levels</var></h3>
</div>
<p class="magick-description">reduce the image to a limited number of color levels per channel.</p>
visible effect.</p>
<div style="margin: auto;">
- <h3><a id="precision"></a>-precision <var>value</var></h3>
+ <h3><a class="anchor" id="precision"></a>-precision <var>value</var></h3>
</div>
<p class="magick-description">set the maximum number of significant digits to be printed.</p>
<div style="margin: auto;">
- <h3><a id="preview"></a>-preview <var>type</var></h3>
+ <h3><a class="anchor" id="preview"></a>-preview <var>type</var></h3>
</div>
<p class="magick-description">image preview type.</p>
<p>The default preview is <code>JPEG</code>.</p>
<div style="margin: auto;">
- <h3><a id="print"></a>-print <var>string</var></h3>
+ <h3><a class="anchor" id="print"></a>-print <var>string</var></h3>
</div>
<p class="magick-description">interpret string and print to console.</p>
<div style="margin: auto;">
- <h3><a id="process"></a>-process <var>command</var></h3>
+ <h3><a class="anchor" id="process"></a>-process <var>command</var></h3>
</div>
<p class="magick-description">process the image with a custom image filter.</p>
pass to the process module.</p>
<div style="margin: auto;">
- <h3><a id="profile"></a>-profile <var>filename</var><br/>
+ <h3><a class="anchor" id="profile"></a>-profile <var>filename</var><br/>
+profile <var>profile_name</var></h3>
</div>
<p>For example, to extract the Exif data (which is stored in JPEG files in the
<var>APP1</var> profile), use.</p>
-<pre><code>
-convert cockatoo.jpg profile.exif
+<pre class="highlight"><code>convert cockatoo.jpg profile.exif
</code></pre>
<p>It is important to note that results may depend on whether or not the
command-line. For instance, in the following example, if the original image is
CMYK with profile, a CMYK-CMYK-RGB conversion results.</p>
-<pre><code>
-convert CMYK.tif -profile "CMYK.icc" -profile "RGB.icc" RGB.tiff
+<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
</p>
<div style="margin: auto;">
- <h3><a id="quality"></a>-quality <var>value</var></h3>
+ <h3><a class="anchor" id="quality"></a>-quality <var>value</var></h3>
</div>
<p class="magick-description">JPEG/MIFF/PNG compression level.</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;">
- <h3><a id="quantize"></a>-quantize <var>colorspace</var></h3>
+ <h3><a class="anchor" id="quantize"></a>-quantize <var>colorspace</var></h3>
</div>
<p class="magick-description">reduce colors using this colorspace.</p>
<div style="margin: auto;">
- <h3><a id="quiet"></a>-quiet</h3>
+ <h3><a class="anchor" id="quiet"></a>-quiet</h3>
</div>
<p class="magick-description">suppress all warning messages. Error messages are still reported.</p>
<div style="margin: auto;">
- <h3><a id="radial-blur"></a>-radial-blur <var>angle</var></h3>
+ <h3><a class="anchor" id="radial-blur"></a>-radial-blur <var>angle</var></h3>
</div>
<p class="magick-description">Blur around the center of the image.</p>
<div style="margin: auto;">
- <h3><a id="raise"></a>-raise <var>thickness</var></h3>
+ <h3><a class="anchor" id="raise"></a>-raise <var>thickness</var></h3>
</div>
<p class="magick-description">Lighten or darken image edges.</p>
href="command-line-options.html#raise">-raise</a> does not alter the dimensions of the image.</p>
<div style="margin: auto;">
- <h3><a id="random-threshold"></a>-random-threshold <var>low</var>x<var>high</var></h3>
+ <h3><a class="anchor" id="random-threshold"></a>-random-threshold <var>low</var>x<var>high</var></h3>
</div>
<p class="magick-description">Apply a random threshold to the image.</p>
<div style="margin: auto;">
- <h3><a id="read-mask"></a>-read-mask
+ <h3><a class="anchor" id="read-mask"></a>-read-mask
<var>filename</var></h3>
</div>
but with strict boolean masking. </p>
<div style="margin: auto;">
- <h3><a id="red-primary"></a>-red-primary <var>x,y</var></h3>
+ <h3><a class="anchor" id="red-primary"></a>-red-primary <var>x,y</var></h3>
</div>
<p class="magick-description">Set the red chromaticity primary point.</p>
<div style="margin: auto;">
- <h3><a id="regard-warnings"></a>-regard-warnings</h3>
+ <h3><a class="anchor" id="regard-warnings"></a>-regard-warnings</h3>
</div>
<p class="magick-description">Pay attention to warning messages.</p>
as errors. </p>
<div style="margin: auto;">
- <h3><a id="remap"></a>-remap <var>filename</var></h3>
+ <h3><a class="anchor" id="remap"></a>-remap <var>filename</var></h3>
</div>
<p class="magick-description">Reduce the number of colors in an image to the colors used by this image.</p>
<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;">
- <h3><a id="region"></a>-region <var>geometry</var></h3>
+ <h3><a class="anchor" id="region"></a>-region <var>geometry</var></h3>
</div>
<p class="magick-description">Set a region in which subsequent operations apply.</p>
<p>Use <code>+region</code> to remove any previously set regions.</p>
<div style="margin: auto;">
- <h3><a id="remote"></a>-remote</h3>
+ <h3><a class="anchor" id="remote"></a>-remote</h3>
</div>
<p class="magick-description">perform a remote operation.</p>
specify which application to control.</p>
<div style="margin: auto;">
- <h3><a id="render"></a>-render</h3>
+ <h3><a class="anchor" id="render"></a>-render</h3>
</div>
<p class="magick-description">render vector operations.</p>
This useful when saving the result to vector formats such as MVG or SVG.</p>
<div style="margin: auto;">
-<h3><a id="repage"></a>-repage <var>geometry</var></h3>
+<h3><a class="anchor" id="repage"></a>-repage <var>geometry</var></h3>
</div>
<p class="magick-description">Adjust the canvas and offset information of the image.</p>
<div style="margin: auto;">
- <h3><a id="resample"></a>-resample <var>horizontal</var>x<var>vertical</var></h3>
+ <h3><a class="anchor" id="resample"></a>-resample <var>horizontal</var>x<var>vertical</var></h3>
</div>
<p class="magick-description">Resample image to specified horizontal and vertical resolution.</p>
resolution specified in the standard file header.</p>
<div style="margin: auto;">
- <h3><a id="resize"></a>-resize <var>geometry</var></h3>
+ <h3><a class="anchor" id="resize"></a>-resize <var>geometry</var></h3>
</div>
<p class="magick-description">Resize an image.</p>
coding. If your image is gamma-corrected, you can remove the nonlinear gamma
correction, apply the transform, then restore it like this:</p>
-<pre><code>
-convert portrait.jpg -gamma .45455 -resize 25% -gamma 2.2 \
+<pre class="highlight"><code>convert portrait.jpg -gamma .45455 -resize 25% -gamma 2.2 \
-quality 92 passport.jpg
</code></pre>
<div style="margin: auto;">
- <h3><a id="respect-parentheses"></a>-respect-parentheses</h3>
+ <h3><a class="anchor" id="respect-parentheses"></a>-respect-parentheses</h3>
</div>
<p class="magick-description">settings remain in effect until parenthesis boundary.</p>
<div style="margin: auto;">
- <h3><a id="reverse"></a>-reverse</h3>
+ <h3><a class="anchor" id="reverse"></a>-reverse</h3>
</div>
<p class="magick-description">Reverse the order of images in the current image list.</p>
<div style="margin: auto;">
- <h3><a id="roll"></a>-roll {<var>+-</var>}<var>x</var>{<var>+-</var>}<var>y</var></h3>
+ <h3><a class="anchor" id="roll"></a>-roll {<var>+-</var>}<var>x</var>{<var>+-</var>}<var>y</var></h3>
</div>
<p class="magick-description">roll an image vertically or horizontally by the amount given.</p>
<div style="margin: auto;">
- <h3><a id="rotate"></a>-rotate <var>degrees</var>{<var><</var>}{<var>></var>}</h3>
+ <h3><a class="anchor" id="rotate"></a>-rotate <var>degrees</var>{<var><</var>}{<var>></var>}</h3>
</div>
<p class="magick-description">Apply Paeth image rotation (using shear operations) to the image.</p>
<div style="margin: auto;">
- <h3><a id="sample"></a>-sample <var>geometry</var></h3>
+ <h3><a class="anchor" id="sample"></a>-sample <var>geometry</var></h3>
</div>
<p class="magick-description">minify / magnify the image with pixel subsampling and pixel replication, respectively.</p>
<div style="margin: auto;">
- <h3><a id="sampling-factor"></a>-sampling-factor <var>horizontal-factor</var>x<var>vertical-factor</var></h3>
+ <h3><a class="anchor" id="sampling-factor"></a>-sampling-factor <var>horizontal-factor</var>x<var>vertical-factor</var></h3>
</div>
<p class="magick-description">sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encoder.</p>
downsampling method.</p>
<div style="margin: auto;">
- <h3><a id="scale"></a>-scale <var>geometry</var></h3>
+ <h3><a class="anchor" id="scale"></a>-scale <var>geometry</var></h3>
</div>
<p class="magick-description">minify / magnify the image with pixel block averaging and pixel replication, respectively.</p>
<div style="margin: auto;">
- <h3><a id="scene"></a>-scene <var>value</var></h3>
+ <h3><a class="anchor" id="scene"></a>-scene <var>value</var></h3>
</div>
<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;">
- <h3><a id="screen"></a>-screen</h3>
+ <h3><a class="anchor" id="screen"></a>-screen</h3>
</div>
<p class="magick-description">specify the screen to capture.</p>
that are independent windows but appear over the specified window.</p>
<div style="margin: auto;">
- <h3><a id="seed"></a>-seed</h3>
+ <h3><a class="anchor" id="seed"></a>-seed</h3>
</div>
<p class="magick-description">seed a new sequence of pseudo-random numbers</p>
<div style="margin: auto;">
- <h3><a id="segment"></a>-segment <var>cluster-threshold</var>x<var>smoothing-threshold</var></h3>
+ <h3><a class="anchor" id="segment"></a>-segment <var>cluster-threshold</var>x<var>smoothing-threshold</var></h3>
</div>
<p class="magick-description">segment the colors of an image.</p>
<div style="margin: auto;">
- <h3><a id="selective-blur"></a>-selective-blur <var>radius</var><br />-selective-blur <var>radius</var>x<var>sigma</var>{<var>+threshold</var>}</h3>
+ <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>
<p class="magick-description">Selectively blur pixels within a contrast threshold.</p>
contrast. The threshold may be expressed as a fraction of <var>QuantumRange</var> or as a percentage.</p>
<div style="margin: auto;">
- <h3><a id="separate"></a>-separate</h3>
+ <h3><a class="anchor" id="separate"></a>-separate</h3>
</div>
<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;">
- <h3><a id="sepia-tone"></a>-sepia-tone <var>percent-threshold</var></h3>
+ <h3><a class="anchor" id="sepia-tone"></a>-sepia-tone <var>percent-threshold</var></h3>
</div>
<p class="magick-description">simulate a sepia-toned photo.</p>
<div style="margin: auto;">
- <h3><a id="set"></a>-set <var>key value</var></h3>
+ <h3><a class="anchor" id="set"></a>-set <var>key value</var></h3>
<h3>+set <var>key</var></h3>
</div>
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>
-<pre><code>
--> convert rose: -set comment 'Rose is a rose is a rose is a rose' rose.png
+<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>
-<pre><code>
--> convert rose: -set origsize '%wx%h' -resize 50% \
+<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>This option can also associate a colorspace or profile with your image.
For example,</p>
-<pre><code>
-convert image.psd -set profile ISOcoated_v2_eci.icc image-icc.psd
+<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>
-<pre><code>
-convert rose: -set filename:mysize '%wx%h' 'rose_%[filename:mysize].png'
+<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
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>
-<pre><code>
-convert rose: -set option:rosesize '%wx%h' -delete 0 \
+<pre class="highlight"><code>convert rose: -set option:rosesize '%wx%h' -delete 0 \
label:'%[rosesize]' label_size_of_rose.gif"
</code></pre>
the commandline option as shown below or by setting the profile via a
programming interface:</p>
-<pre><code>
-convert in.png -set profile PNG-chunk-x:<filename> out.png
+<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
subsequent profiles from overwriting the preceding ones, e.g.,</p>
-<pre><code>
-convert in.png -set profile PNG-chunk-b01:file01 \
+<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;">
- <h3><a id="shade"></a>-shade <var>azimuth</var>x<var>elevation</var></h3>
+ <h3><a class="anchor" id="shade"></a>-shade <var>azimuth</var>x<var>elevation</var></h3>
</div>
<p class="magick-description">shade the image using a distant light source.</p>
the shading results as a grayscale image.</p>
<div style="margin: auto;">
- <h3><a 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>
+ <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>
<p class="magick-description">simulate an image shadow.</p>
Otherwise, this option is ignored. The default is <code>True</code>.</p>
<div style="margin: auto;">
- <h3><a id="sharpen"></a>-sharpen <var>radius</var><br />-sharpen <var>radius</var>x<var>sigma</var></h3>
+ <h3><a class="anchor" id="sharpen"></a>-sharpen <var>radius</var><br />-sharpen <var>radius</var>x<var>sigma</var></h3>
</div>
<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;">
- <h3><a id="shave"></a>-shave <var>geometry</var></h3>
+ <h3><a class="anchor" id="shave"></a>-shave <var>geometry</var></h3>
</div>
<p class="magick-description">Shave pixels from the image edges.</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;">
- <h3><a id="shear"></a>-shear <var>Xdegrees</var>[x<var>Ydegrees</var>]</h3>
+ <h3><a class="anchor" id="shear"></a>-shear <var>Xdegrees</var>[x<var>Ydegrees</var>]</h3>
</div>
<p class="magick-description">Shear the image along the x-axis and/or y-axis.</p>
<var>commute</var>, i.e., the order matters in a sequence of shears. For
example, the following two commands are not equivalent.</p>
-<pre><code>
-convert logo: -shear 20x0 -shear 0x60 logo-sheared.png
+<pre class="highlight"><code>convert logo: -shear 20x0 -shear 0x60 logo-sheared.png
convert logo: -shear 0x60 -shear 20x0 logo-sheared.png
</code></pre>
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>
-<pre><code>
-convert logo: -shear 20x60 logo-sheared.png
+<pre class="highlight"><code>convert logo: -shear 20x60 logo-sheared.png
</code></pre>
<div style="margin: auto;">
- <h3><a id="sigmoidal-contrast"></a>-sigmoidal-contrast <var>contrast</var>x<var>mid-point</var></h3>
+ <h3><a class="anchor" id="sigmoidal-contrast"></a>-sigmoidal-contrast <var>contrast</var>x<var>mid-point</var></h3>
</div>
<p class="magick-description">increase the contrast without saturating highlights or shadows.</p>
<var>mid-point</var>. </p>
<div style="margin: auto;">
- <h3><a id="silent"></a>-silent</h3>
+ <h3><a class="anchor" id="silent"></a>-silent</h3>
</div>
by the <a href="import.html">import</a> tool.</p>
<div style="margin: auto;">
- <h3><a id="similarity-threshold"></a>-similarity-threshold <var>value</var></h3>
+ <h3><a class="anchor" id="similarity-threshold"></a>-similarity-threshold <var>value</var></h3>
</div>
<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 <var>-dissimilarity-threshold</var>.</p>
<div style="margin: auto;">
- <h3><a id="size"></a>-size <var>width</var>[x<var>height</var>][<var>+offset</var>]</h3>
+ <h3><a class="anchor" id="size"></a>-size <var>width</var>[x<var>height</var>][<var>+offset</var>]</h3>
</div>
<p class="magick-description">set the width and height of the image.</p>
<p>For Photo CD images, choose from these sizes:</p>
-<pre><code>
-192x128
+<pre class="highlight"><code>192x128
384x256
768x512
1536x1024
</code></pre>
<div style="margin: auto;">
- <h3><a id="sketch"></a>-sketch <var>radius</var><br />-sketch <var>radius</var>x<var>sigma</var>+<var>angle</var></h3>
+ <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>
<p class="magick-description">simulate a pencil sketch.</p>
direction people would consider the object is coming from. </p>
<div style="margin: auto;">
- <h3><a id="smush"></a>-smush <var>offset</var></h3>
+ <h3><a class="anchor" id="smush"></a>-smush <var>offset</var></h3>
</div>
<p class="magick-description">appends an image sequence together ignoring transparency.</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;">
- <h3><a id="snaps"></a>-snaps <var>value</var></h3>
+ <h3><a class="anchor" id="snaps"></a>-snaps <var>value</var></h3>
</div>
<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;">
- <h3><a id="solarize"></a>-solarize <var>percent-threshold</var></h3>
+ <h3><a class="anchor" id="solarize"></a>-solarize <var>percent-threshold</var></h3>
</div>
<p class="magick-description">negate all pixels above the threshold level.</p>
exposing a photographic film to light during the development process.</p>
<div style="margin: auto;">
- <h3><a id="sparse-color"></a>-sparse-color <var>method</var> '<var>x</var>,<var>y</var> <var>color</var> ...'</h3>
+ <h3><a class="anchor" id="sparse-color"></a>-sparse-color <var>method</var> '<var>x</var>,<var>y</var> <var>color</var> ...'</h3>
</div>
<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>
<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">manhatten</dt>
+ <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
<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;">
- <h3><a id="splice"></a>-splice <var>geometry</var></h3>
+ <h3><a class="anchor" id="splice"></a>-splice <var>geometry</var></h3>
</div>
<p class="magick-description">Splice the current background color into the image.</p>
added added all splices removed. </p>
<div style="margin: auto;">
- <h3><a id="spread"></a>-spread <var>amount</var></h3>
+ <h3><a class="anchor" id="spread"></a>-spread <var>amount</var></h3>
</div>
<p class="magick-description">displace image pixels by a random amount.</p>
<p>The lookup is controlled by the <a href="command-line-options.html#interpolate">-interpolate</a> setting.</p>
<div style="margin: auto;">
- <h3><a id="statistic"></a>-statistic <var>type</var> <var>geometry</var></h3>
+ <h3><a class="anchor" id="statistic"></a>-statistic <var>type</var> <var>geometry</var></h3>
</div>
<p class="magick-description">replace each pixel with corresponding statistic from the neighborhood.</p>
</dl>
<div style="margin: auto;">
- <h3><a id="stegano"></a>-stegano <var>offset</var></h3>
+ <h3><a class="anchor" id="stegano"></a>-stegano <var>offset</var></h3>
</div>
<p class="magick-description">hide watermark within an image.</p>
320x256+35 stegano:image.png).</p>
<div style="margin: auto;">
- <h3><a id="stereo"></a>-stereo <var>+x</var>{<var>+y</var>}</h3>
+ <h3><a class="anchor" id="stereo"></a>-stereo <var>+x</var>{<var>+y</var>}</h3>
</div>
<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;">
- <h3><a id="storage-type"></a>-storage-type <var>type</var></h3>
+ <h3><a class="anchor" id="storage-type"></a>-storage-type <var>type</var></h3>
</div>
<p class="magick-description">pixel storage type. Here are the valid types:</p>
values range from 0 to the maximum value the storage type can support.</p>
<div style="margin: auto;">
- <h3><a id="stretch"></a>-stretch <var>fontStretch</var></h3>
+ <h3><a class="anchor" id="stretch"></a>-stretch <var>fontStretch</var></h3>
</div>
<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 <var>fontStretch</var> from the following.</p>
-<pre><code>
-Any
+<pre class="highlight"><code>Any
Condensed
Expanded
ExtraCondensed
href="command-line-options.html#style">-style</a>, and <a href="command-line-options.html#weight">-weight</a>. </p>
<div style="margin: auto;">
- <h3><a id="strip"></a>-strip</h3>
+ <h3><a class="anchor" id="strip"></a>-strip</h3>
</div>
<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;">
- <h3><a id="stroke"></a>-stroke <var>color</var></h3>
+ <h3><a class="anchor" id="stroke"></a>-stroke <var>color</var></h3>
</div>
<p class="magick-description">color to use when stroking a graphic primitive.</p>
<p>See <a href="command-line-options.html#draw">-draw</a> for further details.</p>
<div style="margin: auto;">
- <h3><a id="strokewidth"></a>-strokewidth <var>value</var></h3>
+ <h3><a class="anchor" id="strokewidth"></a>-strokewidth <var>value</var></h3>
</div>
<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;">
- <h3><a id="style"></a>-style <var>fontStyle</var></h3>
+ <h3><a class="anchor" id="style"></a>-style <var>fontStyle</var></h3>
</div>
<p class="magick-description">Set a font style for text.</p>
the currently selected font family. Select <var>fontStyle</var> from
the following.</p>
-<pre><code>
-Any
+<pre class="highlight"><code>Any
Italic
Normal
Oblique
href="command-line-options.html#stretch">-stretch</a>, and <a href="command-line-options.html#weight">-weight</a>. </p>
<div style="margin: auto;">
- <h3><a id="subimage-search"></a>-subimage-search</h3>
+ <h3><a class="anchor" id="subimage-search"></a>-subimage-search</h3>
</div>
<p class="magick-description">search for subimage.</p>
<div style="margin: auto;">
- <h3><a id="swap"></a>-swap <var>index,index</var></h3>
+ <h3><a class="anchor" id="swap"></a>-swap <var>index,index</var></h3>
</div>
<p class="magick-description">Swap the positions of two images in the image sequence.</p>
the last two images in the sequence.</p>
<div style="margin: auto;">
- <h3><a id="swirl"></a>-swirl <var>degrees</var></h3>
+ <h3><a class="anchor" id="swirl"></a>-swirl <var>degrees</var></h3>
</div>
<p class="magick-description">swirl image pixels about the center.</p>
<p><var>Degrees</var> defines the tightness of the swirl.</p>
<div style="margin: auto;">
- <h3><a id="synchronize"></a>-synchronize</h3>
+ <h3><a class="anchor" id="synchronize"></a>-synchronize</h3>
</div>
<p class="magick-description">synchronize image to storage device.</p>
is not enough disk space for the image pixel cache.</p>
<div style="margin: auto;">
- <h3><a id="taint"></a>-taint</h3>
+ <h3><a class="anchor" id="taint"></a>-taint</h3>
</div>
<p class="magick-description">Mark the image as modified.</p>
<div style="margin: auto;">
- <h3><a id="text-font"></a>-text-font <var>name</var></h3>
+ <h3><a class="anchor" id="text-font"></a>-text-font <var>name</var></h3>
</div>
<p class="magick-description">font for writing fixed-width text.</p>
<code>x:fixed</code> is OPTION1.</p>
<div style="margin: auto;">
- <h3><a id="texture"></a>-texture <var>filename</var></h3>
+ <h3><a class="anchor" id="texture"></a>-texture <var>filename</var></h3>
</div>
<p class="magick-description">name of texture to tile onto the image background.</p>
<div style="margin: auto;">
- <h3><a id="threshold"></a>-threshold <var>value</var>{<var>%</var>}</h3>
+ <h3><a class="anchor" id="threshold"></a>-threshold <var>value</var>{<var>%</var>}</h3>
</div>
<!-- {<var>green,blue,opacity</var>}
channel. The green, blue, and alpha channels (if present) would be unchanged.
</p>
-<pre><code>
-convert in.png -channel red -threshold 50% out.png
+<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
input image.</p>
-<pre><code>
-convert in.png -threshold 100% black.png
+<pre class="highlight"><code>convert in.png -threshold 100% black.png
convert in.png -threshold -1 white.png
</code></pre>
</p>
<div style="margin: auto;">
- <h3><a id="thumbnail"></a>-thumbnail <var>geometry</var></h3>
+ <h3><a class="anchor" id="thumbnail"></a>-thumbnail <var>geometry</var></h3>
</div>
<p class="magick-description">Create a thumbnail 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;">
- <h3><a id="tile"></a>-tile <var>filename</var></h3>
+ <h3><a class="anchor" id="tile"></a>-tile <var>filename</var></h3>
</div>
<p class="magick-description">Set the tile image used for filling a subsequent graphic primitive.</p>
<p class="magick-description">Specifies that a subsequent composite operation is repeated across and down image.</p>
<div style="margin: auto;">
- <h3><a id="tile-offset"></a>-tile-offset {<var>+-</var>}<var>x</var>{<var>+-</var>}<var>y</var></h3>
+ <h3><a class="anchor" id="tile-offset"></a>-tile-offset {<var>+-</var>}<var>x</var>{<var>+-</var>}<var>y</var></h3>
</div>
<p class="magick-description">Specify the offset for tile images, relative to the background image it is tiled on.</p>
by the arguments given when the tile image is set. </p>
<div style="margin: auto;">
- <h3><a id="tint"></a>-tint <var>value</var></h3>
+ <h3><a class="anchor" id="tint"></a>-tint <var>value</var></h3>
</div>
<p class="magick-description">Tint the image with the fill color.</p>
as the various shades of grey.</p>
<div style="margin: auto;">
- <h3><a id="title"></a>-title <var>string</var></h3>
+ <h3><a class="anchor" id="title"></a>-title <var>string</var></h3>
</div>
<p class="magick-description">Assign a title to displayed image.", "animate", "display", "montage</p>
<p>For example,</p>
-<pre><code>
--title "%m:%f %wx%h"
+<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
<div style="margin: auto;">
- <h3><a id="transform"></a>-transform</h3>
+ <h3><a class="anchor" id="transform"></a>-transform</h3>
</div>
<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>
-<pre><code>
-convert -affine 2,2,-2,2,0,0 -transform bird.ppm bird.jpg
+<pre class="highlight"><code>convert -affine 2,2,-2,2,0,0 -transform bird.ppm bird.jpg
</code></pre>
<div style="margin: auto;">
- <h3><a id="transparent"></a>-transparent <var>color</var></h3>
+ <h3><a class="anchor" id="transparent"></a>-transparent <var>color</var></h3>
</div>
<p class="magick-description">Make this color transparent within the image.</p>
<div style="margin: auto;">
- <h3><a id="transparent-color"></a>-transparent-color <var>color</var></h3>
+ <h3><a class="anchor" id="transparent-color"></a>-transparent-color <var>color</var></h3>
</div>
<p class="magick-description">Set the transparent color.</p>
<p>The default transparent color is <code>#00000000</code>, which is fully transparent black.</p>
<div style="margin: auto;">
- <h3><a id="transpose"></a>-transpose</h3>
+ <h3><a class="anchor" id="transpose"></a>-transpose</h3>
</div>
<p class="magick-description">Mirror the image along the top-left to bottom-right diagonal.</p>
</p>
<div style="margin: auto;">
- <h3><a id="transverse"></a>-transverse</h3>
+ <h3><a class="anchor" id="transverse"></a>-transverse</h3>
</div>
<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;">
- <h3><a id="treedepth"></a>-treedepth <var>value</var></h3>
+ <h3><a class="anchor" id="treedepth"></a>-treedepth <var>value</var></h3>
</div>
<p class="magick-description">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="http://www.imagemagick.org/www/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;">
- <h3><a id="trim"></a>-trim</h3>
+ <h3><a class="anchor" id="trim"></a>-trim</h3>
</div>
<p class="magick-description">trim an image.</p>
<div style="margin: auto;">
- <h3><a id="type"></a>-type <var>type</var></h3>
+ <h3><a class="anchor" id="type"></a>-type <var>type</var></h3>
</div>
<p class="magick-description">the image type.</p> <p>Choose from: <code>Bilevel</code>,
example, to prevent a JPEG from being written in grayscale format even though
only gray pixels are present, use.</p>
-<pre><code>
-convert bird.png -type TrueColor bird.jpg
+<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
<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;">
- <h3><a id="undercolor"></a>-undercolor <var>color</var></h3>
+ <h3><a class="anchor" id="undercolor"></a>-undercolor <var>color</var></h3>
</div>
<p class="magick-description">set the color of the annotation bounding box.</p>
<div style="margin: auto;">
- <h3><a id="update"></a>-update <var>seconds</var></h3>
+ <h3><a class="anchor" id="update"></a>-update <var>seconds</var></h3>
</div>
<p class="magick-description">detect when image file is modified and redisplay.</p>
<div style="margin: auto;">
- <h3><a id="unique-colors"></a>-unique-colors</h3>
+ <h3><a class="anchor" id="unique-colors"></a>-unique-colors</h3>
</div>
<p class="magick-description">discard all but one of any pixel color.</p>
<div style="margin: auto;">
- <h3><a id="units"></a>-units <var>type</var></h3>
+ <h3><a class="anchor" id="units"></a>-units <var>type</var></h3>
</div>
<p class="magick-description">the units of image resolution.</p>
<div style="margin: auto;">
- <h3><a id="unsharp"></a>-unsharp <var>radius</var><br />-unsharp <var>radius</var>x<var>sigma</var>{<var>+gain</var>}{<var>+threshold</var>}</h3>
+ <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>
<p class="magick-description">sharpen the image with an unsharp mask operator.</p>
</dl>
<div style="margin: auto;">
- <h3><a id="verbose"></a>-verbose</h3>
+ <h3><a class="anchor" id="verbose"></a>-verbose</h3>
</div>
<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;">
- <h3><a id="version"></a>-version</h3>
+ <h3><a class="anchor" id="version"></a>-version</h3>
</div>
<p class="magick-description">print ImageMagick version string and exit.</p>
<div style="margin: auto;">
- <h3><a id="view"></a>-view <var>string</var></h3>
+ <h3><a class="anchor" id="view"></a>-view <var>string</var></h3>
</div>
<p class="magick-description">FlashPix viewing parameters.</p>
<div style="margin: auto;">
- <h3><a id="vignette"></a>-vignette <var>radius</var>{x<var>sigma</var>}{<var>+-</var>}<var>x</var>{<var>+-</var>}<var>y</var>{<var>%</var>}</h3>
+ <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>
<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;">
- <h3><a id="virtual-pixel"></a>-virtual-pixel <var>method</var></h3>
+ <h3><a class="anchor" id="virtual-pixel"></a>-virtual-pixel <var>method</var></h3>
</div>
<p class="magick-description">Specify contents of <var>virtual pixels</var>.</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;">
- <h3><a id="visual"></a>-visual <var>type</var></h3>
+ <h3><a class="anchor" id="visual"></a>-visual <var>type</var></h3>
</div>
<p class="magick-description">Animate images using this X visual type.", 'animate', 'display'</p>
<p>Choose from these visual classes:</p>
-<pre><code>
-StaticGray TrueColor
+<pre class="highlight"><code>StaticGray TrueColor
GrayScale DirectColor
StaticColor default
PseudoColor visual id
<div style="margin: auto;">
- <h3><a id="watermark"></a>-watermark <var>brightness</var>x<var>saturation</var></h3>
+ <h3><a class="anchor" id="watermark"></a>-watermark <var>brightness</var>x<var>saturation</var></h3>
</div>
<p class="magick-description">Watermark an image using the given percentages of brightness and saturation.</p>
<div style="margin: auto;">
- <h3><a id="wave"></a>-wave <var>amplitude</var><br />-wave <var>amplitude</var>x<var>wavelength</var></h3>
+ <h3><a class="anchor" id="wave"></a>-wave <var>amplitude</var><br />-wave <var>amplitude</var>x<var>wavelength</var></h3>
</div>
<p class="magick-description">Shear the columns of an image into a sine wave.</p>
<div style="margin: auto;">
- <h3><a id="wavelet-denoise"></a>-wavelet-denoise <var>threshold</var><br />-wavelet-denoise <var>threshold</var>x<var>softness</var></h3>
+ <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 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;">
- <h3><a id="weight"></a>-weight <var>fontWeight</var></h3>
+ <h3><a class="anchor" id="weight"></a>-weight <var>fontWeight</var></h3>
</div>
<p class="magick-description">Set a font weight for text.</p>
href="command-line-options.html#stretch">-stretch</a>, and <a href="command-line-options.html#style">-style</a>. </p>
<div style="margin: auto;">
- <h3><a id="white-point"></a>-white-point <var>x,y</var></h3>
+ <h3><a class="anchor" id="white-point"></a>-white-point <var>x,y</var></h3>
</div>
<p class="magick-description">chromaticity white point.</p>
<div style="margin: auto;">
- <h3><a id="white-threshold"></a>-white-threshold <var>value</var>{<var>%</var>}</h3>
+ <h3><a class="anchor" id="white-threshold"></a>-white-threshold <var>value</var>{<var>%</var>}</h3>
</div>
<p class="magick-description">Force to white all pixels above the threshold while leaving all pixels at or below the threshold unchanged.</p>
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;">
- <h3><a id="window"></a>-window <var>id</var></h3>
+ <h3><a class="anchor" id="window"></a>-window <var>id</var></h3>
</div>
<p class="magick-description">Make the image the background of a window.", 'animate', 'display'</p>
href="command-line-options.html#colors">-colors</a> to reduce the number of colors.</p>
<div style="margin: auto;">
- <h3><a id="window-group"></a>-window-group</h3>
+ <h3><a class="anchor" id="window-group"></a>-window-group</h3>
</div>
<p class="magick-description">specify the window group.</p>
<div style="margin: auto;">
- <h3><a id="write"></a>-write <var>filename</var></h3>
+ <h3><a class="anchor" id="write"></a>-write <var>filename</var></h3>
</div>
<p class="magick-description">write an image sequence.</p>
<p>Use <a href="command-line-options.html#compress">-compress</a> to specify the type of image compression.</p>
<div style="margin: auto;">
- <h3><a id="write-mask"></a>-write-mask <var>filename</var></h3>
+ <h3><a class="anchor" id="write-mask"></a>-write-mask <var>filename</var></h3>
</div>
<p class="magick-description">Prevent updates to image pixels specified by the mask.</p>
but with strict boolean masking. </p>
</div>
</div>
-
-
-
+ </div>
+ </main><!-- /.container -->
<footer class="magick-footer">
- <p><a href="support.html">Donate</a> •
- <a href="sitemap.html">Sitemap</a> •
+ <p><a href="security-policy.html">Security</a> •
+ <a href="architecture.html">Architecture</a> •
<a href="links.html">Related</a> •
- <a href="security-policy.html">Security</a> •
- <a href="architecture.html">Architecture</a>
-</p>
- <p><a href="command-line-options.html#">Back to top</a> •
- <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> •
- <a href="https://www.imagemagick.org/script/contact.php">Contact Us</a></p>
- <p><small>© 1999-2017 ImageMagick Studio LLC</small></p>
+ <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>
-</div><!-- /.container -->
- <script src="https://localhost/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
- <script src="../js/magick.html"></script>
+ <!-- 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 9th September 2017 07:58 -->
\ No newline at end of file
+<!-- Magick Cache 8th July 2018 08:34 -->
\ No newline at end of file
projects / imagemagick / blobdiff