<!DOCTYPE html>
<html lang="en">
<head>
- <meta charset="utf-8" />
- <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no" />
- <meta http-equiv="x-ua-compatible" content="ie=edge" />
+ <meta charset="utf-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no" />
<title>Command-line Options @ ImageMagick</title>
- <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
- <meta name="application-name" content="ImageMagick"/>
- <meta name="description" content="ImageMagick® is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves."/>
- <meta name="application-url" content="https://www.imagemagick.org"/>
- <meta name="generator" content="PHP"/>
- <meta name="keywords" content="command-line, options, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert"/>
- <meta name="rating" content="GENERAL"/>
- <meta name="robots" content="INDEX, FOLLOW"/>
- <meta name="generator" content="ImageMagick Studio LLC"/>
- <meta name="author" content="ImageMagick Studio LLC"/>
- <meta name="revisit-after" content="2 DAYS"/>
- <meta name="resource-type" content="document"/>
- <meta name="copyright" content="Copyright (c) 1999-2017 ImageMagick Studio LLC"/>
- <meta name="distribution" content="Global"/>
- <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1"/>
+ <meta name="application-name" content="ImageMagick" />
+ <meta name="description" content="ImageMagick® is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves." />
+ <meta name="application-url" content="https://www.imagemagick.org" />
+ <meta name="generator" content="PHP" />
+ <meta name="keywords" content="command-line, options, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert" />
+ <meta name="rating" content="GENERAL" />
+ <meta name="robots" content="INDEX, FOLLOW" />
+ <meta name="generator" content="ImageMagick Studio LLC" />
+ <meta name="author" content="ImageMagick Studio LLC" />
+ <meta name="revisit-after" content="2 DAYS" />
+ <meta name="resource-type" content="document" />
+ <meta name="copyright" content="Copyright (c) 1999-2017 ImageMagick Studio LLC" />
+ <meta name="distribution" content="Global" />
+ <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1" />
<meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
- <link rel="canonical" href="https://www.imagemagick.org/script/command-line-options.html"/>
- <link rel="icon" href="../images/wand.png"/>
- <link rel="shortcut icon" href="../images/wand.ico"/>
- <link rel="stylesheet" type="text/css" href="http://fonts.googleapis.com/css?family=Roboto:900,400,400italic,700,700italic,300,300italic|Open+Sans:300italic,400italic,700italic,300,400,600,700" />
- <link rel="stylesheet" href="css/magick.css"/>
+ <link href="../www/command-line-options.html" rel="canonical" />
+ <link href="../images/wand.png" rel="icon" />
+ <link href="../images/wand.ico" rel="shortcut icon" />
+ <link href="assets/magick.css" rel="stylesheet" />
</head>
<body>
-<div class="main">
-<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="magick-nav">
- <a class="magick-nav-item " href="../index.html">Home</a>
- <a class="magick-nav-item " href="download.html">Download</a>
- <a class="magick-nav-item " href="command-line-tools.html">Tools</a>
- <a class="magick-nav-item " href="command-line-processing.html">Command-line</a>
- <a class="magick-nav-item " href="resources.html">Resources</a>
- <a class="magick-nav-item " href="develop.html">Develop</a>
- <a class="magick-nav-item " href="https://www.imagemagick.org/script/search.php">Search</a>
- <a class="magick-nav-item 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#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="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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-convert logo: rose: -morph 15 my%02dmorph.jpg
-</pre>
+<pre class="highlight"><code>convert logo: rose: -morph 15 my%02dmorph.jpg
+</code></pre>
<p>will create a sequence of 17 images (the two given plus 15 more created by
<a href="command-line-options.html#morph">-morph</a>), named: my00morph.jpg, my01morph.jpg,
<div style="margin: auto;">
- <h3 class="magick-header"><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>
<p class="text-center"><img class="img-thumbnail" alt="affine transformation" src="../images/affine.png"/> </p>
<p> The size of the resulting image is that of the smallest rectangle that
-contains the transformed source image. The parameters
+contains the transformed source image. The parameters
<var>t<sub>x</sub></var> and <var>t<sub>y</sub></var>
subsequently shift the image pixels so that those that are moved out of the
image area are cut off.</p>
system: positive <var>x</var> and <var>y</var> directions
are rightward and downward, resp.; positive rotation is clockwise.</p>
-<p> If the translation coefficients <var>t<sub>x</sub></var> and
+<p> If the translation coefficients <var>t<sub>x</sub></var> and
<var>t<sub>y</sub></var> are omitted they default to 0,0. Therefore,
four parameters suffice for rotation and scaling without translation.</p>
-<p>Scaling by the factors <var>s<sub>x</sub></var> and
+<p>Scaling by the factors <var>s<sub>x</sub></var> and
<var>s<sub>y</sub></var> in the <var>x</var> and <var>y</var> directions,
respectively, is accomplished with the following.</p>
information </p>
-<pre>
--affine <var>s<sub>x</sub></var>,0,0,<var>s<sub>y</sub></var>
-</pre>
+<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>
--affine 1,0,0,1,<var>t<sub>x</sub></var>,<var>t<sub>y</sub></var>
-</pre>
+<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>
--affine <var>c</var>,<var>s</var>,-<var>s</var>,<var>c</var>
-</pre>
+<pre class="highlight"><code>-affine <var>c</var>,<var>s</var>,-<var>s</var>,<var>c</var>
+</code></pre>
<p>The cumulative effect of a sequence of <a href="command-line-options.html#affine" >-affine</a>
transformations can be accomplished by instead by a single <a href="command-line-options.html#affine"
matrix determinant has a sufficiently small absolute value it is rejected.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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>
<p>Used to set a flag on an image indicating whether or not to use existing alpha
channel data, to create an alpha channel, or to perform other operations on the alpha channel. Choose the argument <var>type</var> from the list below.</p>
-<dl class="dl-horizontal">
- <dt>Activate</dt>
- <dd>
+<dl class="row">
+ <dt class="col-md-4">Activate</dt>
+ <dd class="col-md-8">
Enable the image's transparency channel. Note normally Set
should be used instead of this, unless you specifically need to
preserve existing (but specifically turned Off) transparency
channel. </dd>
- <dt>Associate</dt>
- <dd>
+ <dt class="col-md-4">Associate</dt>
+ <dd class="col-md-8">
associate the alpha channel with the image.</dd>
- <dt>Deactivate</dt>
- <dd>
+ <dt class="col-md-4">Deactivate</dt>
+ <dd class="col-md-8">
Disables the image's transparency channel. Does not delete or change the
existing data, just turns off the use of that data.</dd>
- <dt>Disassociate</dt>
- <dd>
+ <dt class="col-md-4">Disassociate</dt>
+ <dd class="col-md-8">
disassociate the alpha channel from the image.</dd>
- <dt>Set</dt>
- <dd>
+ <dt class="col-md-4">Set</dt>
+ <dd class="col-md-8">
Activates the alpha/matte channel. If it was previously turned off
then it also resets the channel to opaque. If the image already had
the alpha channel turned on, it will have no effect.</dd>
- <dt>Opaque</dt>
- <dd>
+ <dt class="col-md-4">Opaque</dt>
+ <dd class="col-md-8">
Enables the alpha/matte channel and forces it to be fully opaque.
</dd>
- <dt>Transparent</dt>
- <dd>
+ <dt class="col-md-4">Transparent</dt>
+ <dd class="col-md-8">
Activates the alpha/matte channel and forces it to be fully
transparent. This effectively creates a fully transparent image the
same size as the original and with all its original RGB data still
intact, but fully transparent. </dd>
- <dt>Extract</dt>
- <dd>
+ <dt class="col-md-4">Extract</dt>
+ <dd class="col-md-8">
Copies the alpha channel values into all the color channels and turns
'Off' the the image's transparency, so as to generate
a grayscale mask of the image's shape. The alpha channel data is left
intact just deactivated. This is the inverse of 'Copy'.
</dd>
- <dt>Copy</dt>
- <dd>
+ <dt class="col-md-4">Copy</dt>
+ <dd class="col-md-8">
Turns 'On' the alpha/matte channel, then copies the
grayscale intensity of the image, into the alpha channel, converting
a grayscale mask into a transparent shaped mask ready to be colored
appropriately. The color channels are not modified. </dd>
- <dt>Shape</dt>
- <dd>
+ <dt class="col-md-4">Shape</dt>
+ <dd class="col-md-8">
As per 'Copy' but also colors the resulting shape mask with
the current background color. That is the RGB color channels is
replaced, with appropriate alpha shape.
</dd>
- <dt>Remove</dt>
- <dd>
+ <dt class="col-md-4">Remove</dt>
+ <dd class="col-md-8">
Composite the image over the background color.
</dd>
- <dt>Background</dt>
- <dd>
+ <dt class="col-md-4">Background</dt>
+ <dd class="col-md-8">
Set any fully-transparent pixel to the background color, while leaving
it fully-transparent. This can make some image file formats, such as
PNG, smaller as the RGB values of transparent pixels are more uniform,
Set</code>" and not "<code><a href="command-line-options.html#alpha" >-alpha</a> On</code>". </p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
<p>This calculates the mean values of an image, then applies a calculated <a
-href="command-line-options.html#gamma" >-gamma</a> adjustment so that is the mean color exists in the
-image it will get a have a value of 50%. </p>
+href="command-line-options.html#gamma" >-gamma</a> adjustment so that the mean color in the
+image will get a value of 50%. </p>
<p>This means that any solid 'gray' image becomes 50% gray. </p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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>
result. If the EXIF profile was previously stripped, the <a
href="command-line-options.html#auto-orient" >-auto-orient</a> operator will do nothing. </p>
+<div style="margin: auto;">
+ <h3><a class="anchor" id="auto-threshold"></a>-auto-threshold <var>method</var></h3>
+</div>
+
+<p class="magick-description">automatically perform image thresholding.</p>
+
+<p>Here are the valid methods:</p>
+
+<dl class="row">
+<dt class="col-md-4">Undefined</dt><dd class="col-md-8">0: No method specified (equivalent to '<code>OTSU</code>').</dd>
+<dt class="col-md-4">Kapur</dt><dd class="col-md-8">maximum entropy thresholding.</dd>
+<dt class="col-md-4">OTSU</dt><dd class="col-md-8">cluster-based image thresholding.</dd>
+<dt class="col-md-4">Triangle</dt><dd class="col-md-8">a geometric thresholding method.</dd>
+</dl>
+
+<p>The computed threshold is returned as the <kbd>auto-threshold:threshold</kbd> image property.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
--> 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
Performance[4]: 5i 1.678ips 0.555e 3.810u 0:02.980
Performance[4]: 5i 0.875657ips 6.880u 0:05.710
-</pre>
+</code></pre>
<p>In this example, 5 iterations were completed at 2.174 iterations per
second, using 3 threads and 3.190 seconds of the user allotted time, for
a total elapsed time of 2.300 seconds.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
<p>As of IM 6.7.8-8, the <var>geometry</var> arguments behave as follows:</p>
-<dl class="dl-horizontal">
-<dt><var>value</var></dt>
-<dd>value is added to both left/right and top/bottom</dd>
-<dt><var>value-x</var><kbd>x</kbd></dt>
-<dd>value-x is added only to left/right and top/bottom are unchanged</dd>
-<dt><kbd>x</kbd><var>value-y</var></dt>
-<dd>value-y is added only to top/bottom and left/right are unchanged</dd>
-<dt><var>value-x</var><kbd>x</kbd><var>value-y</var></dt>
-<dd>value-x is added to left/right and value-y added to top/bottom</dd>
-<dt><var>value-x</var><kbd>x</kbd>0</dt>
-<dd>value-x is added only to left/right and top/bottom are unchanged</dd>
-<dt>0<kbd>x</kbd><var>value-y</var></dt>
-<dd>value-y is added only to top/bottom and left/right are unchanged</dd>
-<dt><var>value</var>%</dt>
-<dd>value % of width is added to left/right and value % of height is added to top/bottom</dd>
-<dt><var>value-x</var><kbd>x</kbd>%</dt>
-<dd>value-x % of width is added to left/right and to top/bottom</dd>
-<dt>x<var>value-y</var>%</dt>
-<dd>value-y % of height is added to top/bottom and to left/right</dd>
-<dt><var>value-x</var>%<kbd>x</kbd><var>value-y</var>%</dt>
-<dd>value-x % of width is added to left/right and value-y % of height is added to top/bottom</dd>
-<dt><var>value-x</var>%<kbd>x</kbd>0%</dt>
-<dd>value-x % of width is added to left/right and top/bottom are unchanged</dd>
-<dt>0%<kbd>x</kbd><var>value-y</var>%</dt>
-<dd>value-y % of height is added to top/bottom and left/right are unchanged</dd>
+<dl class="row">
+<dt class="col-md-4"><var>value</var></dt>
+<dd class="col-md-8">value is added to both left/right and top/bottom</dd>
+<dt class="col-md-4"><var>value-x</var><code>x</code></dt>
+<dd class="col-md-8">value-x is added only to left/right and top/bottom are unchanged</dd>
+<dt class="col-md-4"><code>x</code><var>value-y</var></dt>
+<dd class="col-md-8">value-y is added only to top/bottom and left/right are unchanged</dd>
+<dt class="col-md-4"><var>value-x</var><code>x</code><var>value-y</var></dt>
+<dd class="col-md-8">value-x is added to left/right and value-y added to top/bottom</dd>
+<dt class="col-md-4"><var>value-x</var><code>x</code>0</dt>
+<dd class="col-md-8">value-x is added only to left/right and top/bottom are unchanged</dd>
+<dt class="col-md-4">0<code>x</code><var>value-y</var></dt>
+<dd class="col-md-8">value-y is added only to top/bottom and left/right are unchanged</dd>
+<dt class="col-md-4"><var>value</var>%</dt>
+<dd class="col-md-8">value % of width is added to left/right and value % of height is added to top/bottom</dd>
+<dt class="col-md-4"><var>value-x</var><code>x</code>%</dt>
+<dd class="col-md-8">value-x % of width is added to left/right and to top/bottom</dd>
+<dt class="col-md-4">x<var>value-y</var>%</dt>
+<dd class="col-md-8">value-y % of height is added to top/bottom and to left/right</dd>
+<dt class="col-md-4"><var>value-x</var>%<code>x</code><var>value-y</var>%</dt>
+<dd class="col-md-8">value-x % of width is added to left/right and value-y % of height is added to top/bottom</dd>
+<dt class="col-md-4"><var>value-x</var>%<code>x</code>0%</dt>
+<dd class="col-md-8">value-x % of width is added to left/right and top/bottom are unchanged</dd>
+<dt class="col-md-4">0%<code>x</code><var>value-y</var>%</dt>
+<dd class="col-md-8">value-y % of height is added to top/bottom and left/right are unchanged</dd>
</dl>
<p>Set the border color by preceding with the <a
functionality.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
--caption "%m:%f %wx%h" bird.miff
-</pre>
+<pre class="highlight"><code>-caption "%m:%f %wx%h" bird.miff
+</code></pre>
<p>produces an image caption of <code>MIFF:bird.miff 512x480</code> (assuming
that the image <code>bird.miff</code> has a width of 512 and a height of
<div style="margin: auto;">
- <h3 class="magick-header"><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>
-<?xml version="1.0" encoding="UTF-8"?>
+<pre class="highlight"><code><?xml version="1.0" encoding="UTF-8"?>
<ColorCorrectionCollection xmlns="urn:ASC:CDL:v1.2">
<ColorCorrection id="cc06668">
<SOPNode>
</SATNode>
</ColorCorrection>
</ColorCorrectionCollection>
-</pre>
+</code></pre>
<div style="margin: auto;">
- <h3 class="magick-header"><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>
--channel Red,Blue
-</pre>
-<p>or you can use the short hand form</p>
-<pre>
--channel RB
+'<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
href="command-line-options.html#clut">-clut</a> operator is a good example of this. </p>
<div style="margin: auto;">
- <h3 class="magick-header"><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>
-<=> 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)
; add a new output image for the next set of channel operations (e.g. red; green; blue)
| move to the next input image for the source of channel data (e.g. | gray=>alpha)
-</pre>
+</code></pre>
<p>For example, to create 3 grayscale images from the red, green, and blue channels of an image, use:</p>
-<pre>
--channel-fx "red; green; blue"
-</pre>
+<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>
-convert wizard.png mask.pgm -channel-fx '| gray=>alpha' wizard-alpha.png
-</pre>
+<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>
-convert wizard.png mask.pgm -channel-fx '| gray=>read-mask' wizard-mask.png
-</pre>
+<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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-convert cockatoo.tif -clip -negate negated.tif
-</pre>
+<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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-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 1.0, 0.0, 0.0 \
0.0 0.0 0.0 0.0, 1.0, 0.0 \
0.0 0.0 0.0 0.0, 0.0, 1.0" kittens.png
-</pre>
+</code></pre>
<div style="margin: auto;">
- <h3 class="magick-header"><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>
-CMY CMYK Gray HCL
+<pre class="highlight"><code>CMY CMYK Gray HCL
HCLp HSB HSI HSL
HSV HWB Lab LCHab
LCHuv LMS Log Luv
scRGB sRGB Transparent xyY
XYZ YCbCr YCC YDbDr
YIQ YPbPr YUV Undefined
-</pre>
+</code></pre>
<p>To print a complete list of colorspaces, use <a href="command-line-options.html#list">-list colorspace</a>.</p>
<p>For a more accurate color conversion to or from the linear RGB, CMYK, or grayscale colorspaces, use the <a href="command-line-options.html#profile">-profile</a> option. Note, ImageMagick assumes the sRGB colorspace if the image format does not indicate otherwise. For colorspace conversion, the gamma function is first removed to produce linear RGB.</p>
-<table class="table table-condensed table-striped">
+<table class="table table-sm table-striped">
<caption>Conversion of RGB to Other Color Spaces</caption>
<tr><th valign="middle">CMY</th></tr>
<tr><td valign="middle">C=<var>QuantumRange</var>−R</td></tr>
<tr><td valign="middle">Y=<var>QuantumRange</var>*(Y−K)/(<var>QuantumRange</var>−K)</td></tr>
<tr><th valign="middle">Gray</th></tr>
- <tr><td valign="middle">Gray = 0.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 class="magick-header"><a id="combine"></a>-combine</h3>
- <h3 class="magick-header">+combine <var>colorspace</var></h3>
+ <h3><a class="anchor" id="combine"></a>-combine</h3>
+ <h3>+combine <var>colorspace</var></h3>
</div>
<p class="magick-description">Combine one or more images into a single image.</p>
Thus, in the following example, the final image should be a copy of the
original. </p>
-<pre>
-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
-</pre>
+</code></pre>
<div style="margin: auto;">
- <h3 class="magick-header"><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>
--comment "%m:%f %wx%h" bird.miff
-</pre>
+<pre class="highlight"><code>-comment "%m:%f %wx%h" bird.miff
+</code></pre>
<p>produces an image comment of <code>MIFF:bird.miff 512x480</code> (assuming
that the image <code>bird.miff</code> has a width of 512 and a height of
480.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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>
-convert image.png reference.png -metric RMSE -compare \ <br/> difference.png
-</pre>
+<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>
-convert image.png reference.png -metric RMSE -compare -format \
+<pre class="highlight"><code>convert image.png reference.png -metric RMSE -compare -format \
"%[distortion]" info:
-</pre>
+</code></pre>
<div style="margin: auto;">
- <h3 class="magick-header"><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>
-add
+<pre class="highlight"><code>add
conjugate
divide
magnitude-phase
multiply
real-imaginary
subtract
-</pre>
+</code></pre>
<p>Optionally specify the <code>divide</code> operator SNR with <code><a href="command-line-options.html#define">-define</a> complex:snr=float</code>.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-convert rose: -contrast -contrast rose_c2.png
-</pre>
+<pre class="highlight"><code>convert rose: -contrast -contrast rose_c2.png
+</code></pre>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-convert -debug "Cache,Blob" rose: rose.png
-</pre>
+<pre class="highlight"><code>convert -debug "Cache,Blob" rose: rose.png
+</code></pre>
<p>The <code>User</code> domain is normally empty, but developers can log user
events in their private copy of ImageMagick.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
<p>The following definitions are just some of the artifacts that are
available:</p>
-<table class="table table-condensed table-striped">
+<table class="table table-sm table-striped">
<tr>
- <td>bmp:alpha=<var>true|false</var></td>
+ <td>bmp3:alpha=<var>true|false</var></td>
<td>include any alpha channel when writing in the BMP image format.</td>
</tr>
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>connected-components:keep=<var>list-of-ids</var></td>
- <td>Comma and/or hyphenated list of id values to keep in the output.
+ <td>Comma and/or hyphenated list of id values to keep in the output.
Supported in Imagemagick 6.9.3-0.</td>
</tr>
<tr>
<td>connected-components:mean-color=<var>true</var></td>
- <td>Changes the output image from id values to mean color values. Supported
+ <td>Changes the output image from id values to mean color values. Supported
in Imagemagick 6.9.2-8.</td>
</tr>
<tr>
<td>convolve:scale=<var>{kernel_scale}[!^] [,{origin_addition}] [%]</var></td>
- <td>Defines the kernel scaling. The special flag ! automatically scales to
- full dynamic range. The ! flag can be used in combination with a factor or
- percent. The factor or percent is then applied after the automatic scaling.
- An example is 50%!. This produces a result 50% darker than full dynamic
- range scaling. The ^ flag assures the kernel is 'zero-summing', for
+ <td>Defines the kernel scaling. The special flag ! automatically scales to
+ full dynamic range. The ! flag can be used in combination with a factor or
+ percent. The factor or percent is then applied after the automatic scaling.
+ An example is 50%!. This produces a result 50% darker than full dynamic
+ range scaling. The ^ flag assures the kernel is 'zero-summing', for
example when some values are positive and some are negative as in edge
detection kernels. The origin addition adds that value to the center
- pixel of the kernel. This produces and effect that is like adding the image
+ pixel of the kernel. This produces an effect that is like adding the image
that many times to the result of the filtered image. The typical value
is 1 so that the original image is added to the result of the convolution.
The default is 0.</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>
--define png:include-chunk=none,gAMA
-</pre>
+<pre class="highlight"><code>-define png:include-chunk=none,gAMA
+</code></pre>
<p>As a special case, if the <code>sRGB</code> chunk is not excluded and
the PNG encoder recognizes that the image contains the sRGB ICC profile,
<p>The <a href="command-line-options.html#strip">-strip</a> option does the equivalent of the
following for PNG output:</p>
-<pre>
--define png:exclude-chunk=EXIF,iCCP,iTXt,sRGB,tEXt,zCCP,zTXt,date
-</pre>
+<pre class="highlight"><code>-define png:exclude-chunk=EXIF,iCCP,iTXt,sRGB,tEXt,zCCP,zTXt,date
+</code></pre>
<p>The default behavior is to include all known PNG ancillary chunks
plus ImageMagick's private <code>vpAg</code> ("virtual page") chunk,
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>
-convert bilevel.tif -define ps:imagemask eps3:stencil.ps
-</pre>
+<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>
--define registry:temporary-path=/data/tmp
-</pre>
+<pre class="highlight"><code>-define registry:temporary-path=/data/tmp
+</code></pre>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
<p>Here are the valid methods:</p>
-<dl class="dl-horizontal">
-<dt>Undefined</dt><dd>0: No disposal specified (equivalent to '<code>none</code>').</dd>
-<dt>None</dt><dd>1: Do not dispose, just overlay next frame image.</dd>
-<dt>Background</dt><dd>2: Clear the frame area with the background color.</dd>
-<dt>Previous</dt><dd>3: Clear to the image prior to this frames overlay.</dd>
+<dl class="row">
+<dt class="col-md-4">Undefined</dt><dd class="col-md-8">0: No disposal specified (equivalent to '<code>none</code>').</dd>
+<dt class="col-md-4">None</dt><dd class="col-md-8">1: Do not dispose, just overlay next frame image.</dd>
+<dt class="col-md-4">Background</dt><dd class="col-md-8">2: Clear the frame area with the background color.</dd>
+<dt class="col-md-4">Previous</dt><dd class="col-md-8">3: Clear to the image prior to this frames overlay.</dd>
</dl>
<p>You can also use the numbers given above, which is what the GIF format
disposal method for images already in memory.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
<p>Choose from these distortion types:</p>
-<table class="table table-condensed table-striped">
+<table class="table table-sm table-striped">
<tr>
<th style="width: 8%">Method</th>
<th>Description</th>
The number of arguments determine the specific meaning of each
argument for the scales, rotation, and translation operations. <br/>
- <dl class="dl-horizontal">
- <dt>2:</dt><dd><var>Scale Angle</var></dd>
- <dt>3:</dt><dd><var>X,Y Angle</var></dd>
- <dt>4:</dt><dd><var>X,Y Scale Angle</var></dd>
- <dt>5:</dt> <dd><var>X,Y ScaleX,ScaleY Angle</var></dd>
- <dt>6:</dt> <dd><var>X,Y Scale Angle NewX,NewY</var></dd>
- <dt>7:</dt> <dd><var>X,Y ScaleX,ScaleY Angle NewX,NewY</var></dd>
+ <dl class="row">
+ <dt class="col-md-4">2:</dt><dd class="col-md-8"><var>Scale Angle</var></dd>
+ <dt class="col-md-4">3:</dt><dd class="col-md-8"><var>X,Y Angle</var></dd>
+ <dt class="col-md-4">4:</dt><dd class="col-md-8"><var>X,Y Scale Angle</var></dd>
+ <dt class="col-md-4">5:</dt> <dd class="col-md-8"><var>X,Y ScaleX,ScaleY Angle</var></dd>
+ <dt class="col-md-4">6:</dt> <dd class="col-md-8"><var>X,Y Scale Angle NewX,NewY</var></dd>
+ <dt class="col-md-4">7:</dt> <dd class="col-md-8"><var>X,Y ScaleX,ScaleY Angle NewX,NewY</var></dd>
</dl>
This is actually an alternative way of specifying a 2 dimensional linear
Arc the image (variation of polar mapping) over the angle given around
a circle.
- <dl class="dl-horizontal">
- <dt>arc_angle</dt>
- <dd>The angle over which to arc the image side-to-side</dd>
- <dt>rotate_angle</dt>
- <dd>Angle to rotate resulting image from vertical center</dd>
- <dt>top_radius</dt>
- <dd>Set top edge of source image at this radius</dd>
- <dt>bottom_radius </dt>
- <dd>Set bottom edge to this radius (radial scaling)</dd>
+ <dl class="row">
+ <dt class="col-md-4">arc_angle</dt>
+ <dd class="col-md-8">The angle over which to arc the image side-to-side</dd>
+ <dt class="col-md-4">rotate_angle</dt>
+ <dd class="col-md-8">Angle to rotate resulting image from vertical center</dd>
+ <dt class="col-md-4">top_radius</dt>
+ <dd class="col-md-8">Set top edge of source image at this radius</dd>
+ <dt class="col-md-4">bottom_radius </dt>
+ <dd class="col-md-8">Set bottom edge to this radius (radial scaling)</dd>
</dl>
The resulting image is always resized to best fit the resulting image,
used to group the 4 sets of coordinate pairs, to make it easier to read and
understand.</p>
-<pre>
-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"
-</pre>
+</code></pre>
<p>If more that the required number of coordinate pairs are given for
a distortion, the distortion method is 'least squares' fitted to produce the
using '<code>perspective</code>' distortion. For example here we view
a infinitely tiled 'plane' all the way to the horizon. </p>
-<pre>
-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
-</pre>
+</code></pre>
<p>Note that a infinitely tiled perspective images involving the horizon can
be very slow, because of the number of pixels that are compressed to generate
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>The shape primitives:</p>
-<dl class="dl-horizontal">
-<dt>point</dt><dd> x,y</dd>
-<dt>line</dt><dd> x0,y0 x1,y1</dd>
-<dt>rectangle</dt><dd> x0,y0 x1,y1</dd>
-<dt>roundRectangle</dt><dd> x0,y0 x1,y1 wc,hc</dd>
-<dt>arc</dt><dd> x0,y0 x1,y1 a0,a1</dd>
-<dt>ellipse</dt><dd> x0,y0 rx,ry a0,a1</dd>
-<dt>circle</dt><dd> x0,y0 x1,y1</dd>
-<dt>polyline</dt><dd> x0,y0 ... xn,yn</dd>
-<dt>polygon</dt><dd> x0,y0 ... xn,yn</dd>
-<dt>bezier</dt><dd> x0,y0 ... xn,yn</dd>
-<dt>path</dt><dd>specification </dd>
-<dt>image</dt><dd> operator x0,y0 w,h filename</dd>
+<dl class="row">
+<dt class="col-md-4">point</dt><dd class="col-md-8"> x,y</dd>
+<dt class="col-md-4">line</dt><dd class="col-md-8"> x0,y0 x1,y1</dd>
+<dt class="col-md-4">rectangle</dt><dd class="col-md-8"> x0,y0 x1,y1</dd>
+<dt class="col-md-4">roundRectangle</dt><dd class="col-md-8"> x0,y0 x1,y1 wc,hc</dd>
+<dt class="col-md-4">arc</dt><dd class="col-md-8"> x0,y0 x1,y1 a0,a1</dd>
+<dt class="col-md-4">ellipse</dt><dd class="col-md-8"> x0,y0 rx,ry a0,a1</dd>
+<dt class="col-md-4">circle</dt><dd class="col-md-8"> x0,y0 x1,y1</dd>
+<dt class="col-md-4">polyline</dt><dd class="col-md-8"> x0,y0 ... xn,yn</dd>
+<dt class="col-md-4">polygon</dt><dd class="col-md-8"> x0,y0 ... xn,yn</dd>
+<dt class="col-md-4">bezier</dt><dd class="col-md-8"> x0,y0 ... xn,yn</dd>
+<dt class="col-md-4">path</dt><dd class="col-md-8">specification </dd>
+<dt class="col-md-4">image</dt><dd class="col-md-8"> operator x0,y0 w,h filename</dd>
</dl>
<p>The text primitive:</p>
-<dl class="dl-horizontal">
-<dt>text</dt><dd>x0,y0 string</dd>
+<dl class="row">
+<dt class="col-md-4">text</dt><dd class="col-md-8">x0,y0 string</dd>
</dl>
<p>The text gravity primitive:</p>
-<dl class="dl-horizontal">
-<dt>gravity</dt><dd>NorthWest, North, NorthEast, West, Center, East, SouthWest, South, or SouthEast</dd>
+<dl class="row">
+<dt class="col-md-4">gravity</dt><dd class="col-md-8">NorthWest, North, NorthEast, West, Center, East, SouthWest, South, or SouthEast</dd>
</dl>
<p>The text gravity primitive only affects the placement of text and does not
<p>The transformation primitives:</p>
-<dl class="dl-horizontal">
-<dt>rotate</dt><dd>degrees</dd>
-<dt>translate</dt><dd>dx,dy</dd>
-<dt>scale</dt><dd>sx,sy</dd>
-<dt>skewX</dt><dd>degrees</dd>
-<dt>skewY</dt><dd>degrees</dd>
+<dl class="row">
+<dt class="col-md-4">rotate</dt><dd class="col-md-8">degrees</dd>
+<dt class="col-md-4">translate</dt><dd class="col-md-8">dx,dy</dd>
+<dt class="col-md-4">scale</dt><dd class="col-md-8">sx,sy</dd>
+<dt class="col-md-4">skewX</dt><dd class="col-md-8">degrees</dd>
+<dt class="col-md-4">skewY</dt><dd class="col-md-8">degrees</dd>
</dl>
<p>The pixel operation primitives:</p>
-<dl class="dl-horizontal">
-<dt>color</dt><dd>x0,y0 method</dd>
-<dt>matte</dt><dd>x0,y0 method</dd>
+<dl class="row">
+<dt class="col-md-4">color</dt><dd class="col-md-8">x0,y0 method</dd>
+<dt class="col-md-4">matte</dt><dd class="col-md-8">x0,y0 method</dd>
</dl>
<p>The shape primitives are drawn in the color specified by the preceding <a
<p>As an example, to define a circle centered at 100,100 that extends to
150,150 use:</p>
-<pre>
--draw 'circle 100,100 150,150'
-</pre>
+<pre class="highlight"><code>-draw 'circle 100,100 150,150'
+</code></pre>
<p>The <code>Bezier</code> primitive creates a spline curve and requires three
or points to define its shape. The first and last points are the
<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>
--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'
-</pre>
+</code></pre>
<p>A <code>path</code> represents an outline of an object, defined in terms of
moveto (set a new current point), lineto (draw a straight line), curveto (draw
image keyword with the composite operator, image location, image size, and
filename:</p>
-<pre>
--draw 'image SrcOver 100,100 225,225 image.jpg'
-</pre>
+<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>
--draw "text 100,100 'Works like magick!' "
-</pre>
+<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>
-point
+<pre class="highlight"><code>point
replace
floodfill
filltoborder
reset
-</pre>
+</code></pre>
<p>Consider the target pixel as that specified by your coordinate. The
<code>point</code> method recolors the target pixel. The <code>replace</code>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-AdobeCustom AdobeExpert
+<pre class="highlight"><code>AdobeCustom AdobeExpert
AdobeStandard AppleRoman
BIG5 GB2312
Latin 2 None
SJIScode Symbol
Unicode Wansung
-</pre>
+</code></pre>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
normalized pixels are used, they are restored, following the other
calculations, to the full range by multiplying by <var>QuantumRange</var>.)</p>
-<table class="table table-condensed table-striped">
+<table class="table table-sm table-striped">
<col width="25%" />
<col width="75%" />
<thead>
multi-value version of evaluate. </p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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>
-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
-</pre>
+</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 class="magick-header"><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>
-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"
-</pre>
+</code></pre>
<p>If you omit the offsets, as in</p>
-<pre>
-convert -size 16000x16000 -depth 8 -extract 640x480 \
+<pre class="highlight"><code>convert -size 16000x16000 -depth 8 -extract 640x480 \
image.rgb image.png
-</pre>
+</code></pre>
<p>the image is <var>resized</var> to the specified dimensions instead,
equivalent to:</p>
-<pre>
-convert -size 16000x16000 -depth 8 -resize 640x480 image.rgb image.png
-</pre>
+<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 class="magick-header"><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 class="magick-header"><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>
-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
Inverse Difference Moment Information Measure of Correlation 1
Sum Average Information Measure of Correlation 2
Sum Variance Maximum Correlation Coefficient
-</pre>
+</code></pre>
<div style="margin: auto;">
- <h3 class="magick-header"><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>
-convert image.png -fft fft_image.miff
-</pre>
+<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>
-convert image.png -fft fft_image.png
-</pre>
+<pre class="highlight"><code>convert image.png -fft fft_image.png
+</code></pre>
<p>generates a magnitude image as <code>fft_image-0.png</code> and a phase image
as <code>fft_image-1.png</code>. If you prefer this representation, then you can
enhance the darker values more in comparison to the lighter values. This can
be done, for example, as follows:</p>
-<pre>
-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"
-</pre>
+</code></pre>
<p>where either <a href="command-line-options.html#contrast-stretch">-contrast-stretch</a> 0 or <a
href="command-line-options.html#auto-level">-auto-level</a> is used to scale the image to full dynamic
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 class="magick-header"><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>
--fill blue
+<pre class="highlight"><code>-fill blue
-fill "#ddddff"
-fill "rgb(255,255,255)"
-</pre>
+</code></pre>
<p>See <a href="command-line-options.html#draw">-draw</a> for further details.</p>
<p>To print a complete list of color names, use the <a href="command-line-options.html#list">-list color</a> option.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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>
-Point Hermite Cubic
+<pre class="highlight"><code>Point Hermite Cubic
Box Gaussian Catrom
Triangle Quadratic Mitchell
-</pre>
+CubicSpline
+</code></pre>
+
+<p>Use <code>-define filter:lobes={2,3,4}</code> to specify the support size for filtering for the <code>CubicSpline</code> filter.</p>
<p>The <code>Bessel</code> and <code>Sinc</code> filter is also provided (as well
as a faster <code>SincFast</code> equivalent form). However these filters are
using these functions will define a 'Windowed' filter, appropriate to the
operator involved. Windowed filters include: </p>
-<pre>
-Lanczos Hamming Parzen
+<pre class="highlight"><code>Lanczos Hamming Parzen
Blackman Kaiser Welsh
Hanning Bartlett Bohman
-</pre>
+</code></pre>
<p>Also one special self-windowing filter is also provided
<code>Lagrange</code>, which will automagically re-adjust its function depending
use of these expert settings (see also <a href="command-line-options.html#define" >-define</a> and <a
href="command-line-options.html#set" >-set</a>):-</p>
-<table class="table table-condensed table-striped">
+<table class="table table-sm table-striped">
<tr>
<td>-define filter:blur=<var>factor</var></td>
<td>Scale the X axis of the filter (and its window). Use > 1.0 for
<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>
-convert image.png \
+<pre class="highlight"><code>convert image.png \
-filter sinc \
-set filter:window=jinc \
-set filter:lobes=8 \
- -resize 150% image.jpg"
-</pre>
+ -resize 150% image.jpg"
+</code></pre>
<p>Or a raw un-windowed Sinc filter with 4 lobes:</p>
-<pre>
-convert image.png \
+<pre class="highlight"><code>convert image.png \
-set filter:filter=sinc \
-set filter:lobes=4 \
- -resize 150% image.jpg"
-</pre>
+ -resize 150% image.jpg"
+</code></pre>
<p>To extract the data for a raw windowing function, combine it with
a '<code>Box</code>' filter. For example the '<code>Welch</code> parabolic
windowing function. </p>
-<pre>
-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 \
- -resize 2 null: > window_welch.dat
+ -resize 2 null: > window_welch.dat
gnuplot
set grid
plot \"window_welch.dat\" with lines
-</pre>
+</code></pre>
<p>Note that the use of expert options is provided for image processing experts
who have studied and understand how resize filters work. Without this
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-Polynomial
+<pre class="highlight"><code>Polynomial
Sinusoid
Arcsin
Arctan
-</pre>
+</code></pre>
<p>To print a complete list of <a href="command-line-options.html#function">-function</a> operators,
use <a href="command-line-options.html#list">-list function</a>. Descriptions follow.</p>
-<dl class="dl-horizontal">
- <dt>Polynomial</dt>
- <dd><p>The <code>Polynomial</code> function takes an arbitrary number of parameters,
+<dl class="row">
+ <dt class="col-md-4">Polynomial</dt>
+ <dd
class="col-md-8"><p>The <code>Polynomial</code> function takes an arbitrary number of parameters,
these being the coefficients of a polynomial, in decreasing order of degree.
That is, entering</p>
-<pre>
--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>
+<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>
-<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>
+<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>
href="command-line-options.html#level">-level</a> operator also affects channels linearly. Some
correspondences follow.</p>
-<table class="table table-condensed table-striped">
+<table class="table table-sm table-striped">
<tr>
<td>-evaluate Set <var>value</var> </td>
<td>-function Polynomial <var>value</var></td>
desired.</p>
</dd>
-<dt>Sinusoid</dt>
-<dd>
+<dt class="col-md-4">Sinusoid</dt>
+<dd class="col-md-8">
<p>The <code>Sinusoid</code> function can be used to vary the channel values
sinusoidally by setting frequency, phase shift, amplitude, and a bias. These
values are given as one to four parameters, as follows,</p>
-<pre>
--function <code>Sinusoid</code> <var>freq</var>,[<var>phase</var>,[<var>amp</var>,[<var>bias</var>]]]
-</pre>
+<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
corresponds to 0 through <var>freq</var>×360 degrees.)
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>
-<var>amp</var> * sin(2*π* (<var>freq</var> * <b><var>u</var></b> + <var>phase</var> / 360)) + <var>bias</var>
-</pre>
+<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>
--function Sinusoid 3,-90,.2,.7
-</pre>
+<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>
is 0.</p>
<code>Cos</code> of the <a href="command-line-options.html#evaluate">-evaluate</a> operator by allowing
varying amplitude, phase and bias. The correspondence is as follows.</p>
-<table class="table table-condensed table-striped">
+<table class="table table-sm table-striped">
<tr>
<td>-evaluate Sin <var>freq</var> </td>
<td>-function Sinusoid <var>freq</var>,0 </td>
</tr>
</table>
</dd>
-<dt>ArcSin</dt>
-<dd>
+<dt class="col-md-4">ArcSin</dt>
+<dd class="col-md-8">
<p>The <code>ArcSin</code> function generates the inverse curve of a Sinusoid,
and can be used to generate cylindrical distortion and displacement maps.
The curve can be adjusted relative to both the input values and output range
of values.</p>
-<pre>
--function <code>ArcSin</code> <var>width</var>,[<var>center</var>,[<var>range</var>,[<var>bias</var>]]]
-</pre>
+<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>
-<var>range</var>/π * asin( 2/<var>width</var> * ( <b><var>u</var></b> - <var>center</var> ) ) + <var>bias</var>
-</pre>
+<pre class="highlight"><code><var>range</var>/π * asin( 2/<var>width</var> * ( <b><var>u</var></b> - <var>center</var> ) ) + <var>bias</var>
+</code></pre>
</dd>
-<dt>ArcTan</dt>
-<dd>
+<dt class="col-md-4">ArcTan</dt>
+<dd class="col-md-8">
<p>The <code>ArcTan</code> function generates a curve that smooth crosses from
limit values at infinities, though a center using the given slope value.
All these values can be adjusted via the arguments.</p>
-<pre>
--function <code>ArcTan</code> <var>slope</var>,[<var>center</var>,[<var>range</var>,[<var>bias</var>]]]
-</pre>
+<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>
-<var>range</var>/π * atan( <var>slope</var>*π * ( <b><var>u</var></b> - <var>center</var> ) ) + <var>bias</var>
-</pre>
+<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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
normalized or 0 to 1 color value. For example, using a value of gamma=2 is the
same as taking the square root of the image.</p>
-<p>You can apply separate gamma values to the red, green, and blue channels of
-the image with a gamma value list delimited with commas (e.g.,
-<code>1.7,2.3,1.2</code>).</p>
-
<p>Use <a href="command-line-options.html#gamma">+gamma <var>value</var></a> to set the
image gamma level without actually adjusting the image pixels. This option
is useful if the image is of a known gamma but not set as an image attribute
display gamma; e.g., if your image is sRGB and you want to write a PNG gAMA
chunk, use</p>
-<pre>
-convert input.png +gamma .45455 output.png
-</pre>
+<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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-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
-</pre>
+</code></pre>
<p>When used as an option to <a href="composite.html">composite</a>, <a
href="command-line-options.html#gravity">-gravity</a> gives the direction that the image gravitates
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 class="magick-header"><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>
-convert in.png -grayscale Rec709Luminance out.png
-</pre>
+<pre class="highlight"><code>convert in.png -grayscale Rec709Luminance out.png
+</code></pre>
<p>which is equivalent to:</p>
-<pre>
-convert in.png -colorspace gray out.png
+<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>
-convert in.png -grayscale Rec709Luma out.png
-</pre>
+<pre class="highlight"><code>convert in.png -grayscale Rec709Luma out.png
+</code></pre>
<p>which is equivalent to:</p>
-<pre>
-convert in.png -set colorspace RGB -colorspace gray out.png
-</pre>
+<pre class="highlight"><code>convert in.png -colorspace Gray out.png
+</code></pre>
<p>Note that a 'colorspace' intensity method will produce the same result
regardless of the current colorpsace of the image. But a 'mathematical'
-intensity method will depend on the current colorspace the image is currently
+intensity method depends on the current colorspace the image is currently
using. </p>
-<p>While this operation uses an <a href="command-line-options.html#intensity" >-intensity</a> method,
+<p>While this operation uses an <a href="command-line-options.html#intensity" >-intensity</a> method,
it does not use or set the <a href="command-line-options.html#intensity" >-intensity</a> setting, so
-will not effect other operations that may use that setting.</p>
+will not affect other operations that may use that setting.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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>
-convert image.png hald.png -hald-clut transform.png
-</pre>
+<pre class="highlight"><code>convert image.png hald.png -hald-clut transform.png
+</code></pre>
<p>This option provides a convenient method for you to use Gimp or Photoshop
to make color corrections to the Hald CLUT image and subsequently apply them
<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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-convert fft_image.miff -ift fft_image_ift.png
-</pre>
+<pre class="highlight"><code>convert fft_image.miff -ift fft_image_ift.png
+</code></pre>
<p>or</p>
-<pre>
-convert fft_image-0.png fft_image-1.png -ift fft_image_ift.png
-</pre>
+<pre class="highlight"><code>convert fft_image-0.png fft_image-1.png -ift fft_image_ift.png
+</code></pre>
<p>The resulting image may need to be cropped due to padding introduced when
the original image, prior to the <a href="command-line-options.html#fft">-fft</a> or <a
<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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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
being applied to calculate the final greyscale value. </p>
-<dl class="dl-horizontal">
-<dt>Rec601Luma</dt><dd> 0.298839R' + 0.586811G'+ 0.114350B'</dd>
-<dt>Rec601Luminance</dt><dd> 0.298839R + 0.586811G + 0.114350B</dd>
-<dt>Rec709Luma</dt><dd> 0.212656R' + 0.715158G' + 0.072186B'</dd>
-<dt>Rec709Luminance</dt><dd> 0.212656R + 0.715158G + 0.072186B</dd>
-<dt>Brightness</dt><dd> max(R', G', B')</dd>
-<dt>Lightness</dt><dd> (min(R', G', B') + max(R', G', B')) / 2.0</dd>
+<dl class="row">
+<dt class="col-md-4">Rec601Luma</dt><dd class="col-md-8"> 0.298839R' + 0.586811G'+ 0.114350B'</dd>
+<dt class="col-md-4">Rec601Luminance</dt><dd class="col-md-8"> 0.298839R + 0.586811G + 0.114350B</dd>
+<dt class="col-md-4">Rec709Luma</dt><dd class="col-md-8"> 0.212656R' + 0.715158G' + 0.072186B'</dd>
+<dt class="col-md-4">Rec709Luminance</dt><dd class="col-md-8"> 0.212656R + 0.715158G + 0.072186B</dd>
+<dt class="col-md-4">Brightness</dt><dd class="col-md-8"> max(R', G', B')</dd>
+<dt class="col-md-4">Lightness</dt><dd class="col-md-8"> (min(R', G', B') + max(R', G', B')) / 2.0</dd>
</dl>
<p>Note that the above R,G,B values is the image's linear-RGB values, while
current value in the images respective R,G,B channel regardless of
what that is, or what colorspace the image is currently using.</p>
-<dl class="dl-horizontal">
-<dt>Average</dt><dd>(R + G + B) / 3.0</dd>
-<dt>MS</dt><dd>(R^2 + G^2 + B^2) / 3.0</dd>
-<dt>RMS</dt><dd>sqrt( (R^2 + G^2 + B^2) / 3.0 )</dd>
+<dl class="row">
+<dt class="col-md-4">Average</dt><dd class="col-md-8">(R' + G' + B') / 3.0</dd>
+<dt class="col-md-4">MS</dt><dd class="col-md-8">(R'^2 + G'^2 + B'^2) / 3.0</dd>
+<dt class="col-md-4">RMS</dt><dd class="col-md-8">sqrt( (R'^2 + G'^2 + B'^2) / 3.0 )</dd>
</dl>
<p>These methods are often used for other purposes, such as generating a
<p>Operators affected by the <a href="command-line-options.html#intensity" >-intensity</a> setting include:</p>
-<pre>
--adaptive-blur
+<pre class="highlight"><code>-adaptive-blur
-adaptive-sharpen
-black-threshold
-clut (when mapping greyscale CLUT image to alpha channel if set by -channels)
-threshold
-tint
-white-threshold
-</pre>
+</code></pre>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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>
-none
+<pre class="highlight"><code>none
line
plane
partition
JPEG
GIF
PNG
-</pre>
+</code></pre>
<p>This option is used to specify the type of interlacing scheme for raw image
formats such as <code>RGB</code> or <code>YUV</code>.</p>
interlace</a>.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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>
the pixels surrounding that point. That is how to determine the color of a
point that falls between two, or even four different colored pixels. </p>
-<dl class="dl-horizontal">
- <dt>integer</dt>
- <dd>The color of the top-left pixel (floor function)</dd>
- <dt>nearest-neighbor</dt>
- <dd>The nearest pixel to the lookup point (rounded function)</dd>
- <dt>average</dt>
- <dd>The average color of the surrounding four pixels</dd>
- <dt>bilinear</dt>
- <dd>A double linear interpolation of pixels (the default)</dd>
- <dt>mesh</dt>
- <dd>Divide area into two flat triangular interpolations</dd>
- <dt>bicubic</dt>
- <dd>Fitted bicubic-spines of surrounding 16 pixels</dd>
- <dt>spline</dt>
- <dd>Direct spline curves (colors are blurred)</dd>
- <dt>filter</dt>
- <dd>Use resize <a href="command-line-options.html#filter">-filter</a> settings</dd>
+<dl class="row">
+ <dt class="col-md-4">average</dt>
+ <dd class="col-md-8">The average color of the surrounding four pixels</dd>
+ <dt class="col-md-4">average4</dt>
+ <dd class="col-md-8">The average color of the surrounding four pixels</dd>
+ <dt class="col-md-4">average9</dt>
+ <dd class="col-md-8">The average color of the surrounding nine pixels</dd>
+ <dt class="col-md-4">average16</dt>
+ <dd class="col-md-8">The average color of the surrounding sixteen pixels</dd>
+ <dt class="col-md-4">background</dt>
+ <dd class="col-md-8"> </dd>
+ <dt class="col-md-4">bilinear</dt>
+ <dd class="col-md-8">A double linear interpolation of pixels (the default)</dd>
+ <dt class="col-md-4">blend</dt>
+ <dd class="col-md-8"> </dd>
+ <dt class="col-md-4">catrom</dt>
+ <dd class="col-md-8">Fitted bicubic-spines of surrounding 16 pixels</dd>
+ <dt class="col-md-4">integer</dt>
+ <dd class="col-md-8">The color of the top-left pixel (floor function)</dd>
+ <dt class="col-md-4">mesh</dt>
+ <dd class="col-md-8">Divide area into two flat triangular interpolations</dd>
+ <dt class="col-md-4">nearest-neighbor</dt>
+ <dd class="col-md-8">The nearest pixel to the lookup point (rounded function)</dd>
+ <dt class="col-md-4">spline</dt>
+ <dd class="col-md-8">Direct spline curves (colors are blurred)</dd>
</dl>
<p>This most important for distortion operators such as <a href="command-line-options.html#distort"
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
--label "%m:%f %wx%h" bird.miff
-</pre>
+<pre class="highlight"><code>-label "%m:%f %wx%h" bird.miff
+</code></pre>
<p>assigns an image label of <code>MIFF:bird.miff 512x480</code> to the
"<code>bird.miff</code>" image and whose width is 512 and height is 480, as it
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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>
which may represent either a set of overlaid 'image layers', a GIF disposal
animation, or a fully-'coalesced' animation sequence. </p>
-<table class="table table-condensed table-striped">
+<table class="table table-sm table-striped">
<tbody>
<tr>
<th style="width: 8%">Method</th>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
--limit memory 32MiB -limit map 64MiB
-</pre>
+<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>
--> identify -list resource
+<pre class="highlight"><code>-> identify -list resource
Resource limits:
Width: 100MP
Height: 100MP
Thread: 12
Throttle: 0
Time: unlimited
-</pre>
+</code></pre>
<p>Requests for pixel storage to keep intermediate images are satisfied by one
of three resource categories: in-memory pool, memory-mapped files pool, and
the Internet. To assure ImageMagick does not exceed 10MiB of memory you can
simply set the area limit to 10MiB:</p>
-<pre>
--limit area 10MB
-</pre>
+<pre class="highlight"><code>-limit area 10MB
+</code></pre>
<p>Now whenever a large image is processed, the pixels are automagically
cached to disk instead of memory. This of course implies that large images
might inadvertently upload a huge image to process, you should set a disk
limit as well:</p>
-<pre>
--limit area 10MB -limit disk 500MB
-</pre>
+<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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-<pre class="pre-scrollable">
+<pre class="pre-scrollable"><code>
Align
Alpha
Boolean
Units
Validate
VirtualPixel
-</pre>
+</code></pre>
<p>These lists vary depending on your version of ImageMagick. Use "<code>-list
list</code>" to get a complete listing of all the "<code>-list</code>" arguments
available:</p>
-<pre>
-identify -list list
-</pre>
+<pre class="highlight"><code>identify -list list
+</code></pre>
<div style="margin: auto;">
- <h3 class="magick-header"><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>You can display the following components by embedding special format
characters:</p>
-<dl class="dl-horizontal">
-<dt>%d</dt><dd>domain</dd>
-<dt>%e</dt><dd>event</dd>
-<dt>%f</dt><dd>function</dd>
-<dt>%l</dt><dd>line</dd>
-<dt>%m</dt><dd>module</dd>
-<dt>%p</dt><dd>process ID</dd>
-<dt>%r</dt><dd>real CPU time</dd>
-<dt>%t</dt><dd>wall clock time</dd>
-<dt>%u</dt><dd>user CPU time</dd>
-<dt>%%</dt><dd>percent sign</dd>
-<dt>\n</dt><dd>newline</dd>
-<dt>\r</dt><dd>carriage return</dd>
+<dl class="row">
+<dt class="col-md-4">%d</dt><dd class="col-md-8">domain</dd>
+<dt class="col-md-4">%e</dt><dd class="col-md-8">event</dd>
+<dt class="col-md-4">%f</dt><dd class="col-md-8">function</dd>
+<dt class="col-md-4">%l</dt><dd class="col-md-8">line</dd>
+<dt class="col-md-4">%m</dt><dd class="col-md-8">module</dd>
+<dt class="col-md-4">%p</dt><dd class="col-md-8">process ID</dd>
+<dt class="col-md-4">%r</dt><dd class="col-md-8">real CPU time</dd>
+<dt class="col-md-4">%t</dt><dd class="col-md-8">wall clock time</dd>
+<dt class="col-md-4">%u</dt><dd class="col-md-8">user CPU time</dd>
+<dt class="col-md-4">%%</dt><dd class="col-md-8">percent sign</dd>
+<dt class="col-md-4">\n</dt><dd class="col-md-8">newline</dd>
+<dt class="col-md-4">\r</dt><dd class="col-md-8">carriage return</dd>
</dl>
<p>For example:</p>
-<pre>
-convert -debug coders -log "%u %m:%l %e" in.gif out.png
-</pre>
+<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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-best
+<pre class="highlight"><code>best
default
gray
red
green
blue
-</pre>
+</code></pre>
<p>The <var>X server</var> must support the <var>Standard
Colormap</var> you choose, otherwise an error occurs. Use <code>list</code> as
<div style="margin: auto;">
- <h3 class="magick-header"><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>
<p>Here are the valid components of a map:</p>
-<dl class="dl-horizontal">
-<dt>r</dt><dd> red pixel component</dd>
-<dt>g</dt><dd> green pixel component</dd>
-<dt>b</dt><dd> blue pixel component</dd>
-<dt>a</dt><dd> alpha pixel component (0 is transparent)</dd>
-<dt>o</dt><dd> opacity pixel component (0 is opaque)</dd>
-<dt>i</dt><dd> grayscale intensity pixel component</dd>
-<dt>c</dt><dd> cyan pixel component</dd>
-<dt>m</dt><dd> magenta pixel component</dd>
-<dt>y</dt><dd> yellow pixel component</dd>
-<dt>k</dt><dd> black pixel component</dd>
-<dt>p</dt><dd> pad component (always 0)</dd>
+<dl class="row">
+<dt class="col-md-4">r</dt><dd class="col-md-8"> red pixel component</dd>
+<dt class="col-md-4">g</dt><dd class="col-md-8"> green pixel component</dd>
+<dt class="col-md-4">b</dt><dd class="col-md-8"> blue pixel component</dd>
+<dt class="col-md-4">a</dt><dd class="col-md-8"> alpha pixel component (0 is transparent)</dd>
+<dt class="col-md-4">o</dt><dd class="col-md-8"> opacity pixel component (0 is opaque)</dd>
+<dt class="col-md-4">i</dt><dd class="col-md-8"> grayscale intensity pixel component</dd>
+<dt class="col-md-4">c</dt><dd class="col-md-8"> cyan pixel component</dd>
+<dt class="col-md-4">m</dt><dd class="col-md-8"> magenta pixel component</dd>
+<dt class="col-md-4">y</dt><dd class="col-md-8"> yellow pixel component</dd>
+<dt class="col-md-4">k</dt><dd class="col-md-8"> black pixel component</dd>
+<dt class="col-md-4">p</dt><dd class="col-md-8"> pad component (always 0)</dd>
</dl>
<p>You can specify as many of these components as needed in any order (e.g.
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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="dl-horizontal">
-<dt>AE</dt><dd> absolute error count, number of different pixels (-fuzz effected)</dd>
-<dt>FUZZ</dt><dd> mean color distance</dd>
-<dt>MAE</dt><dd> mean absolute error (normalized), average channel error distance</dd>
-<dt>MEPP</dt><dd> mean error per pixel (normalized mean error, normalized peak error)</dd>
-<dt>MSE</dt><dd> mean error squared, average of the channel error squared</dd>
-<dt>NCC</dt><dd> normalized cross correlation</dd>
-<dt>PAE</dt><dd> peak absolute (normalized peak absolute)</dd>
-<dt>PHASH</dt><dd> perceptual hash for the sRGB and HCLp colorspaces. Specify an alternative colorspace with <code>-define phash:colorspaces=<var>colorspace,colorspace,...</var></code></dd>
-<dt>PSNR</dt><dd> peak signal to noise ratio</dd>
-<dt>RMSE</dt><dd> root mean squared (normalized root mean squared)</dd>
+<dl class="row">
+<dt class="col-md-4">AE</dt><dd class="col-md-8"> absolute error count, number of different pixels (-fuzz affected)</dd>
+<dt class="col-md-4">DSSIM</dt><dd class="col-md-8"> structural dissimilarity index</dd>
+<dt class="col-md-4">FUZZ</dt><dd class="col-md-8"> mean color distance</dd>
+<dt class="col-md-4">MAE</dt><dd class="col-md-8"> mean absolute error (normalized), average channel error distance</dd>
+<dt class="col-md-4">MEPP</dt><dd class="col-md-8"> mean error per pixel (normalized mean error, normalized peak error)</dd>
+<dt class="col-md-4">MSE</dt><dd class="col-md-8"> mean error squared, average of the channel error squared</dd>
+<dt class="col-md-4">NCC</dt><dd class="col-md-8"> normalized cross correlation</dd>
+<dt class="col-md-4">PAE</dt><dd class="col-md-8"> peak absolute (normalized peak absolute)</dd>
+<dt class="col-md-4">PHASH</dt><dd class="col-md-8"> perceptual hash for the sRGB and HCLp colorspaces. Specify an alternative colorspace with <code>-define phash:colorspaces=<var>colorspace,colorspace,...</var></code></dd>
+<dt class="col-md-4">PSNR</dt><dd class="col-md-8"> peak signal to noise ratio</dd>
+<dt class="col-md-4">RMSE</dt><dd class="col-md-8"> root mean squared (normalized root mean squared)</dd>
+<dt class="col-md-4">SSIM</dt><dd class="col-md-8"> structural similarity index</dd>
</dl>
<p>Control the '<code>AE</code>', or absolute count of pixels that are different,
'similar', while '<code>MAE</code>' determines the factor needed
for about half the pixels to be similar. </p>
-<p>The '<code>MEPP</code>' metric returns three different metrics
+<p>The <code>MEPP</code> metric returns three different metrics
('<code>MAE</code>', '<code>MAE</code>' normalized, and '<code>PAE</code>'
normalized) from a single comparison run. </p>
+<p>The <code>SSIM</code> and <code>DSSIM</code> metrics respect these defines:
+<code>-define compare:ssim-radius</code>, <code>-define compare:ssim-sigma</code>,
+<code>-define compare:ssim-k1</code>, and <code>-define compare:ssim-k2</code>.</p>
+
<p>To print a complete list of metrics, use the <a href="command-line-options.html#list">-list
metric</a> option.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header">-mode <var>value</var></h3>
+ <h3>-mode <var>value</var></h3>
</div>
<p class="magick-description">Mode of operation.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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>
-convert image.png -set option:modulate:colorspace hsb -modulate 120,90 modulate.png
-</pre>
+<pre class="highlight"><code>convert image.png -set option:modulate:colorspace hsb -modulate 120,90 modulate.png
+</code></pre>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><a id="morphology"></a>-morphology</h3>
- <h3 class="magick-header">-morphology <var>method</var> <var>kernel</var></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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-Gaussian
+<pre class="highlight"><code>Gaussian
Impulse
Laplacian
Multiplicative
Poisson
Random
Uniform
-</pre>
+</code></pre>
<p>The amount of noise added can be controlled by the <code><a
href="command-line-options.html#attenuate" >-attenuate</a></code> setting. If unset the value is
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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
<p>You can choose from these standard threshold maps:</p>
-<pre class="pre-scrollable">
+<pre class="pre-scrollable"><code>
threshold 1x1 Threshold 1x1 (non-dither)
checks 2x1 Checkerboard 2x1 (dither)
o2x2 2x2 Ordered 2x2 (dispersed)
c6x6w Circles 6x6 (white)
c7x7b c7x7 Circles 7x7 (black)
c7x7w Circles 7x7 (white)
-</pre>
+</code></pre>
<p> The <code>threshold</code> generated a simple 50% threshold of the image.
This could be used with <var >level</var> to do the equivalent of <a
<div style="margin: auto;">
- <h3 class="magick-header"><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>
-bottom-left right-top
+<pre class="highlight"><code>bottom-left right-top
bottom-right top-left
left-bottom top-right
left-top undefined
right-bottom
-</pre>
+</code></pre>
<p>To print a complete list of orientations, use the <a href="command-line-options.html#list" >-list
orientation</a> option.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 <var>media</var> as shorthand to specify the dimensions (<var>width</var>x<var>height</var>) of the <var>PostScript</var> page in dots per inch or a TEXT page in pixels.
The choices for a PostScript page are:</p>
-<dl class="dl-horizontal">
-<dt> 11x17 </dt> <dd> 792 x 1224</dd>
-<dt> Ledger </dt> <dd> 1224 x 792</dd>
-<dt> Legal </dt> <dd> 612 x 1008</dd>
-<dt> Letter </dt> <dd> 612 x 792</dd>
-<dt> LetterSmall</dt> <dd> 612 x 792</dd>
-<dt> ArchE </dt> <dd> 2592 x 3456</dd>
-<dt> ArchD </dt> <dd> 1728 x 2592</dd>
-<dt> ArchC </dt> <dd> 1296 x 1728</dd>
-<dt> ArchB </dt> <dd> 864 x 1296</dd>
-<dt> ArchA </dt> <dd> 648 x 864</dd>
-<dt> A0 </dt> <dd> 2380 x 3368</dd>
-<dt> A1 </dt> <dd> 1684 x 2380</dd>
-<dt> A2 </dt> <dd> 1190 x 1684</dd>
-<dt> A3 </dt> <dd> 842 x 1190</dd>
-<dt> A4 </dt> <dd> 595 x 842</dd>
-<dt> A4Small </dt> <dd> 595 x 842</dd>
-<dt> A5 </dt> <dd> 421 x 595</dd>
-<dt> A6 </dt> <dd> 297 x 421</dd>
-<dt> A7 </dt> <dd> 210 x 297</dd>
-<dt> A8 </dt> <dd> 148 x 210</dd>
-<dt> A9 </dt> <dd> 105 x 148</dd>
-<dt> A10 </dt> <dd> 74 x 105</dd>
-<dt> B0 </dt> <dd> 2836 x 4008</dd>
-<dt> B1 </dt> <dd> 2004 x 2836</dd>
-<dt> B2 </dt> <dd> 1418 x 2004</dd>
-<dt> B3 </dt> <dd> 1002 x 1418</dd>
-<dt> B4 </dt> <dd> 709 x 1002</dd>
-<dt> B5 </dt> <dd> 501 x 709</dd>
-<dt> C0 </dt> <dd> 2600 x 3677</dd>
-<dt> C1 </dt> <dd> 1837 x 2600</dd>
-<dt> C2 </dt> <dd> 1298 x 1837</dd>
-<dt> C3 </dt> <dd> 918 x 1298</dd>
-<dt> C4 </dt> <dd> 649 x 918</dd>
-<dt> C5 </dt> <dd> 459 x 649</dd>
-<dt> C6 </dt> <dd> 323 x 459</dd>
-<dt> Flsa </dt> <dd> 612 x 936</dd>
-<dt> Flse </dt> <dd> 612 x 936</dd>
-<dt> HalfLetter </dt> <dd> 396 x 612</dd>
+<dl class="row">
+<dt class="col-md-4"> 11x17 </dt> <dd class="col-md-8"> 792 x 1224</dd>
+<dt class="col-md-4"> Ledger </dt> <dd class="col-md-8"> 1224 x 792</dd>
+<dt class="col-md-4"> Legal </dt> <dd class="col-md-8"> 612 x 1008</dd>
+<dt class="col-md-4"> Letter </dt> <dd class="col-md-8"> 612 x 792</dd>
+<dt class="col-md-4"> LetterSmall</dt> <dd class="col-md-8"> 612 x 792</dd>
+<dt class="col-md-4"> ArchE </dt> <dd class="col-md-8"> 2592 x 3456</dd>
+<dt class="col-md-4"> ArchD </dt> <dd class="col-md-8"> 1728 x 2592</dd>
+<dt class="col-md-4"> ArchC </dt> <dd class="col-md-8"> 1296 x 1728</dd>
+<dt class="col-md-4"> ArchB </dt> <dd class="col-md-8"> 864 x 1296</dd>
+<dt class="col-md-4"> ArchA </dt> <dd class="col-md-8"> 648 x 864</dd>
+<dt class="col-md-4"> A0 </dt> <dd class="col-md-8"> 2380 x 3368</dd>
+<dt class="col-md-4"> A1 </dt> <dd class="col-md-8"> 1684 x 2380</dd>
+<dt class="col-md-4"> A2 </dt> <dd class="col-md-8"> 1190 x 1684</dd>
+<dt class="col-md-4"> A3 </dt> <dd class="col-md-8"> 842 x 1190</dd>
+<dt class="col-md-4"> A4 </dt> <dd class="col-md-8"> 595 x 842</dd>
+<dt class="col-md-4"> A4Small </dt> <dd class="col-md-8"> 595 x 842</dd>
+<dt class="col-md-4"> A5 </dt> <dd class="col-md-8"> 421 x 595</dd>
+<dt class="col-md-4"> A6 </dt> <dd class="col-md-8"> 297 x 421</dd>
+<dt class="col-md-4"> A7 </dt> <dd class="col-md-8"> 210 x 297</dd>
+<dt class="col-md-4"> A8 </dt> <dd class="col-md-8"> 148 x 210</dd>
+<dt class="col-md-4"> A9 </dt> <dd class="col-md-8"> 105 x 148</dd>
+<dt class="col-md-4"> A10 </dt> <dd class="col-md-8"> 74 x 105</dd>
+<dt class="col-md-4"> B0 </dt> <dd class="col-md-8"> 2836 x 4008</dd>
+<dt class="col-md-4"> B1 </dt> <dd class="col-md-8"> 2004 x 2836</dd>
+<dt class="col-md-4"> B2 </dt> <dd class="col-md-8"> 1418 x 2004</dd>
+<dt class="col-md-4"> B3 </dt> <dd class="col-md-8"> 1002 x 1418</dd>
+<dt class="col-md-4"> B4 </dt> <dd class="col-md-8"> 709 x 1002</dd>
+<dt class="col-md-4"> B5 </dt> <dd class="col-md-8"> 501 x 709</dd>
+<dt class="col-md-4"> C0 </dt> <dd class="col-md-8"> 2600 x 3677</dd>
+<dt class="col-md-4"> C1 </dt> <dd class="col-md-8"> 1837 x 2600</dd>
+<dt class="col-md-4"> C2 </dt> <dd class="col-md-8"> 1298 x 1837</dd>
+<dt class="col-md-4"> C3 </dt> <dd class="col-md-8"> 918 x 1298</dd>
+<dt class="col-md-4"> C4 </dt> <dd class="col-md-8"> 649 x 918</dd>
+<dt class="col-md-4"> C5 </dt> <dd class="col-md-8"> 459 x 649</dd>
+<dt class="col-md-4"> C6 </dt> <dd class="col-md-8"> 323 x 459</dd>
+<dt class="col-md-4"> Flsa </dt> <dd class="col-md-8"> 612 x 936</dd>
+<dt class="col-md-4"> Flse </dt> <dd class="col-md-8"> 612 x 936</dd>
+<dt class="col-md-4"> HalfLetter </dt> <dd class="col-md-8"> 396 x 612</dd>
</dl>
<p>This option is also used to place subimages when writing to a multi-image
<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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
<code>convert file.png -preview Gamma Preview:gamma.png</code>). Choose from
these previews:</p>
-<pre class="pre-scrollable">
+<pre class="pre-scrollable"><code>
AddNoise
Blur
Brightness
Swirl
Threshold
Wave
-</pre>
+</code></pre>
<p>To print a complete list of previews, use the <a href="command-line-options.html#list">-list preview</a> option.</p>
<p>The default preview is <code>JPEG</code>.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-convert cockatoo.jpg profile.exif
-</pre>
+<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
original image already has an included profile. Also, keep in mind that <a
command-line. For instance, in the following example, if the original image is
CMYK with profile, a CMYK-CMYK-RGB conversion results.</p>
-<pre>
-convert CMYK.tif -profile "CMYK.icc" -profile "RGB.icc" RGB.tiff
-</pre>
+<pre class="highlight"><code>convert CMYK.tif -profile "CMYK.icc" -profile "RGB.icc" RGB.tiff
+</code></pre>
<p>Furthermore, since ICC profiles are not necessarily symmetric, extra
conversion steps can yield unwanted results. CMYK profiles are often very
</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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>If filter-type is 4 or less, the specified PNG filter-type is used for
all scanlines:</p>
-<dl class="dl-horizontal">
-<dt>0</dt><dd>none</dd>
-<dt>1</dt><dd>sub</dd>
-<dt>2</dt><dd>up</dd>
-<dt>3</dt><dd>average</dd>
-<dt>4</dt><dd>Paeth</dd>
+<dl class="row">
+<dt class="col-md-4">0</dt><dd class="col-md-8">none</dd>
+<dt class="col-md-4">1</dt><dd class="col-md-8">sub</dd>
+<dt class="col-md-4">2</dt><dd class="col-md-8">up</dd>
+<dt class="col-md-4">3</dt><dd class="col-md-8">average</dd>
+<dt class="col-md-4">4</dt><dd class="col-md-8">Paeth</dd>
</dl>
<p>If filter-type is 5, adaptive filtering is used when quality is greater
<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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-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
-</pre>
+</code></pre>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><a id="set"></a>-set <var>key value</var></h3>
- <h3 class="magick-header">+set <var>key</var></h3>
+ <h3><a class="anchor" id="set"></a>-set <var>key value</var></h3>
+ <h3>+set <var>key</var></h3>
</div>
<p class="magick-description">sets image attributes and properties for images in the current image sequence.</p>
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>
--> 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
-</pre>
+</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>
--> 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
-</pre>
+</code></pre>
<p>Other well known 'properties' that are available include:
'<code>date:create</code>' and '<code>date:modify</code>' and
<p>This option can also associate a colorspace or profile with your image.
For example,</p>
-<pre>
-convert image.psd -set profile ISOcoated_v2_eci.icc image-icc.psd
-</pre>
+<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>
-convert rose: -set filename:mysize '%wx%h' 'rose_%[filename:mysize].png'
-</pre>
+<pre class="highlight"><code>convert rose: -set filename:mysize '%wx%h' 'rose_%[filename:mysize].png'
+</code></pre>
<p>If the setting value is prefixed with "<code>option:</code>" the setting will
be saved as a global "Artifact" exactly as if it was set using the <a
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>
-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"
-</pre>
+</code></pre>
<p>Note that <a href="escape.html" >Format Percent Escapes</a> will only match
a 'artifact' if the given <var>key</var> does not match an existing
the commandline option as shown below or by setting the profile via a
programming interface:</p>
-<pre>
-convert in.png -set profile PNG-chunk-x:<filename> out.png
-</pre>
+<pre class="highlight"><code>convert in.png -set profile PNG-chunk-x:<filename> out.png
+</code></pre>
<p>where <var>x</var> is a location flag and
<var>filename</var> is a file containing the chunk
subsequent profiles from overwriting the preceding ones, e.g.,</p>
-<pre>
-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
-</pre>
+</code></pre>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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>
<div style="margin: auto;">
- <h3
class="magick-header"><a
+ <h3><a
id="shared-memory"></a>-shared-memory</h3>
</div>
Otherwise, this option is ignored. The default is <code>True</code>.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-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
-</pre>
+</code></pre>
<p>The first of the two commands above is equivalent to the following, except
for the amount of empty space created; the command that follows generates
a smaller image, and so is a better choice in terms of time and space.</p>
-<pre>
-convert logo: -shear 20x60 logo-sheared.png
-</pre>
+<pre class="highlight"><code>convert logo: -shear 20x60 logo-sheared.png
+</code></pre>
<div style="margin: auto;">
- <h3 class="magick-header"><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>
<p>By default the image contrast is increased, use <var>+sigmoidal-contrast</var> to decrease the contrast.</p>
-<p>To achieve the equivalent of a sigmoidal brightness change (similar to
+<p>To achieve the equivalent of a sigmoidal brightness change (similar to
a gamma adjustment), you would use <var>-sigmoidal-contrast
{brightness}x0%</var> to increase brightness and <var>+sigmoidal-contrast {brightness}x0%</var> to decrease brightness.
Note the use of '0' fo rthe mid-point of the sigmoidal curve. </p>
<var>mid-point</var>. </p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-192x128
+<pre class="highlight"><code>192x128
384x256
768x512
1536x1024
3072x2048
-</pre>
+</code></pre>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-<dl class="dl-horizontal">
- <dt>barycentric</dt>
- <dd>three point triangle of color given 3 points.
+<dl class="row">
+ <dt class="col-md-4">barycentric</dt>
+ <dd class="col-md-8">three point triangle of color given 3 points.
Giving only 2 points will form a linear gradient between those points.
The gradient generated extends beyond the triangle created by those
3 points. </dd>
- <dt>bilinear</dt>
- <dd>Like barycentric but for 4 points. Less than 4 points
+ <dt class="col-md-4">bilinear</dt>
+ <dd class="col-md-8">Like barycentric but for 4 points. Less than 4 points
fall back to barycentric. </dd>
- <dt>voronoi</dt>
- <dd>Simply map each pixel to the to nearest color point
+ <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>manhatten</dt>
- <dd>Like voronoi, but resulting polygonal 'cells' are mapped to a fixed coordinate system.</dd>
- <dt>shepards</dt>
- <dd>Colors points biased on the ratio of inverse distance
+ <dt class="col-md-4">manhattan</dt>
+ <dd class="col-md-8">Like voronoi, but resulting polygonal 'cells' are mapped to a fixed coordinate system.</dd>
+ <dt class="col-md-4">shepards</dt>
+ <dd class="col-md-8">Colors points biased on the ratio of inverse distance
squared. Generating spots of color in a sea of the average of
colors. </dd>
- <dt>inverse</dt>
- <dd>Colors points biased on the ratio of inverse distance.
+ <dt class="col-md-4">inverse</dt>
+ <dd class="col-md-8">Colors points biased on the ratio of inverse distance.
This generates sharper points of color rather than rounded spots of
'<code>shepards</code>' Generating spots of color in a sea of the
average of colors. </dd>
<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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
<p>Choose from these statistic types:</p>
-<dl class="dl-horizontal">
-<dt>Gradient</dt><dd>maximum difference (max - min) value in neighborhood</dd>
-<dt>Maximum</dt><dd>maximum value per channel in neighborhood</dd>
-<dt>Minimum</dt><dd>minimum value per channel in neighborhood</dd>
-<dt>Mean</dt><dd>average value per channel in neighborhood</dd>
-<dt>Median</dt><dd>median value per channel in neighborhood</dd>
-<dt>Mode</dt><dd>mode (most frequent) value per channel in neighborhood</dd>
-<dt>Nonpeak</dt><dd>value just before or after the median value per channel in neighborhood</dd>
-<dt>RMS</dt><dd>root mean square value per channel in neighborhood</dd>
-<dt>StandardDeviation</dt><dd> standard deviation value per channel in neighborhood</dd>
+<dl class="row">
+<dt class="col-md-4">Gradient</dt><dd class="col-md-8">maximum difference (max - min) value in neighborhood</dd>
+<dt class="col-md-4">Maximum</dt><dd class="col-md-8">maximum value per channel in neighborhood</dd>
+<dt class="col-md-4">Minimum</dt><dd class="col-md-8">minimum value per channel in neighborhood</dd>
+<dt class="col-md-4">Mean</dt><dd class="col-md-8">average value per channel in neighborhood</dd>
+<dt class="col-md-4">Median</dt><dd class="col-md-8">median value per channel in neighborhood</dd>
+<dt class="col-md-4">Mode</dt><dd class="col-md-8">mode (most frequent) value per channel in neighborhood</dd>
+<dt class="col-md-4">Nonpeak</dt><dd class="col-md-8">value just before or after the median value per channel in neighborhood</dd>
+<dt class="col-md-4">RMS</dt><dd class="col-md-8">root mean square value per channel in neighborhood</dd>
+<dt class="col-md-4">StandardDeviation</dt><dd class="col-md-8"> standard deviation value per channel in neighborhood</dd>
</dl>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-<dl class="dl-horizontal">
-<dt>char</dt><dd>unsigned characters</dd>
-<dt>double</dt><dd>doubles</dd>
-<dt>float</dt><dd>floats</dd>
-<dt>integer</dt><dd>integers</dd>
-<dt>long</dt><dd>longs</dd>
-<dt>quantum</dt><dd>pixels in the native depth of your ImageMagick distribution</dd>
-<dt>short</dt><dd>unsigned shorts</dd>
+<dl class="row">
+<dt class="col-md-4">char</dt><dd class="col-md-8">unsigned characters</dd>
+<dt class="col-md-4">double</dt><dd class="col-md-8">doubles</dd>
+<dt class="col-md-4">float</dt><dd class="col-md-8">floats</dd>
+<dt class="col-md-4">integer</dt><dd class="col-md-8">integers</dd>
+<dt class="col-md-4">long</dt><dd class="col-md-8">longs</dd>
+<dt class="col-md-4">quantum</dt><dd class="col-md-8">pixels in the native depth of your ImageMagick distribution</dd>
+<dt class="col-md-4">short</dt><dd class="col-md-8">unsigned shorts</dd>
</dl>
<p>Float and double types are normalized from 0.0 to 1.0 otherwise the pixels
values range from 0 to the maximum value the storage type can support.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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>
-Any
+<pre class="highlight"><code>Any
Condensed
Expanded
ExtraCondensed
SemiExpanded
UltraCondensed
UltraExpanded
-</pre>
+</code></pre>
<p>To print a complete list of stretch types, use <a href="command-line-options.html#list">-list
stretch</a>.</p>
href="command-line-options.html#style">-style</a>, and <a href="command-line-options.html#weight">-weight</a>. </p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-Any
+<pre class="highlight"><code>Any
Italic
Normal
Oblique
-</pre>
+</code></pre>
<p>For other settings that affect fonts, see the options <a
href="command-line-options.html#font">-font</a>, <a href="command-line-options.html#family">-family</a>, <a
href="command-line-options.html#stretch">-stretch</a>, and <a href="command-line-options.html#weight">-weight</a>. </p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-convert in.png -channel red -threshold 50% out.png
-</pre>
+<pre class="highlight"><code>convert in.png -channel red -threshold 50% out.png
+</code></pre>
<p>As (possibly) impractical but instructive examples, the following would
generate an all-black and an all-white image with the same dimensions as the
input image.</p>
-<pre>
-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
-</pre>
+</code></pre>
<p>Note that the values of the transparency channel is treated as 'matte'
values (0 is opaque) and not as 'alpha' values (0 is transparent).</p>
</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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>
<div style="margin: auto;">
- <h3 class="magick-header">-tile <var>geometry</var></h3>
+ <h3>-tile <var>geometry</var></h3>
</div>
<p class="magick-description">Specify the layout of images.</p>
<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
<div style="margin: auto;">
- <h3 class="magick-header">-tile</h3>
+ <h3>-tile</h3>
</div>
<p class="magick-description">Specifies that a subsequent composite operation is repeated across and down image.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
--title "%m:%f %wx%h"
-</pre>
+<pre class="highlight"><code>-title "%m:%f %wx%h"
+</code></pre>
<p>produces an image title of <code>MIFF:bird.miff 512x480</code> for an image
titled <code>bird.miff</code> and whose width is 512 and height is 480.</p>
<div style="margin: auto;">
- <h3 class="magick-header"><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>
-convert -affine 2,2,-2,2,0,0 -transform bird.ppm bird.jpg
-</pre>
+<pre class="highlight"><code>convert -affine 2,2,-2,2,0,0 -transform bird.ppm bird.jpg
+</code></pre>
<p>This operator has been now been superseded by the <a
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-convert bird.png -type TrueColor bird.jpg
-</pre>
+<pre class="highlight"><code>convert bird.png -type TrueColor bird.jpg
+</code></pre>
<p>Similarly, use <a href="command-line-options.html#type">-type TrueColorMatte</a> to force the
encoder to write an alpha channel even though the image is opaque, if the
<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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
<p>The parameters are:</p>
-<dl class="dl-horizontal">
-<dt>radius</dt>
-<dd>The radius of the Gaussian, in pixels, not counting the center pixel (default 0).</dd>
-<dt>sigma</dt>
-<dd>The standard deviation of the Gaussian, in pixels (default 1.0).</dd>
-<dt>gain</dt>
-<dd>The fraction of the difference between the original and the blur image that is added back into the original (default 1.0).</dd>
-<dt>threshold</dt>
-<dd>The threshold, as a fraction of <var>QuantumRange</var>, needed to apply the difference amount (default 0.05).</dd>
+<dl class="row">
+<dt class="col-md-4">radius</dt>
+<dd class="col-md-8">The radius of the Gaussian, in pixels, not counting the center pixel (default 0).</dd>
+<dt class="col-md-4">sigma</dt>
+<dd class="col-md-8">The standard deviation of the Gaussian, in pixels (default 1.0).</dd>
+<dt class="col-md-4">gain</dt>
+<dd class="col-md-8">The fraction of the difference between the original and the blur image that is added back into the original (default 1.0).</dd>
+<dt class="col-md-4">threshold</dt>
+<dd class="col-md-8">The threshold, as a fraction of <var>QuantumRange</var>, needed to apply the difference amount (default 0.05).</dd>
</dl>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>Choose from these methods:</p>
-<dl class="dl-horizontal">
-<dt>background</dt><dd>the area surrounding the image is the background color</dd>
-<dt>black</dt><dd>the area surrounding the image is black</dd>
-<dt>checker-tile</dt><dd>alternate squares with image and background color</dd>
-<dt>dither</dt><dd>non-random 32x32 dithered pattern</dd>
-<dt>edge</dt><dd>extend the edge pixel toward infinity</dd>
-<dt>gray</dt><dd>the area surrounding the image is gray</dd>
-<dt>horizontal-tile</dt><dd>horizontally tile the image, background color above/below</dd>
-<dt>horizontal-tile-edge</dt><dd>horizontally tile the image and replicate the side edge pixels</dd>
-<dt>mirror</dt><dd>mirror tile the image</dd>
-<dt>random</dt><dd>choose a random pixel from the image</dd>
-<dt>tile</dt><dd>tile the image (default)</dd>
-<dt>transparent</dt><dd>the area surrounding the image is transparent blackness</dd>
-<dt>vertical-tile</dt><dd>vertically tile the image, sides are background color</dd>
-<dt>vertical-tile-edge</dt><dd>vertically tile the image and replicate the side edge pixels</dd>
-<dt>white</dt><dd>the area surrounding the image is white</dd>
+<dl class="row">
+<dt class="col-md-4">background</dt><dd class="col-md-8">the area surrounding the image is the background color</dd>
+<dt class="col-md-4">black</dt><dd class="col-md-8">the area surrounding the image is black</dd>
+<dt class="col-md-4">checker-tile</dt><dd class="col-md-8">alternate squares with image and background color</dd>
+<dt class="col-md-4">dither</dt><dd class="col-md-8">non-random 32x32 dithered pattern</dd>
+<dt class="col-md-4">edge</dt><dd class="col-md-8">extend the edge pixel toward infinity</dd>
+<dt class="col-md-4">gray</dt><dd class="col-md-8">the area surrounding the image is gray</dd>
+<dt class="col-md-4">horizontal-tile</dt><dd class="col-md-8">horizontally tile the image, background color above/below</dd>
+<dt class="col-md-4">horizontal-tile-edge</dt><dd class="col-md-8">horizontally tile the image and replicate the side edge pixels</dd>
+<dt class="col-md-4">mirror</dt><dd class="col-md-8">mirror tile the image</dd>
+<dt class="col-md-4">random</dt><dd class="col-md-8">choose a random pixel from the image</dd>
+<dt class="col-md-4">tile</dt><dd class="col-md-8">tile the image (default)</dd>
+<dt class="col-md-4">transparent</dt><dd class="col-md-8">the area surrounding the image is transparent blackness</dd>
+<dt class="col-md-4">vertical-tile</dt><dd class="col-md-8">vertically tile the image, sides are background color</dd>
+<dt class="col-md-4">vertical-tile-edge</dt><dd class="col-md-8">vertically tile the image and replicate the side edge pixels</dd>
+<dt class="col-md-4">white</dt><dd class="col-md-8">the area surrounding the image is white</dd>
</dl>
<p>The default value is "edge".</p>
<p>This most important for distortion operators such as <a href="command-line-options.html#distort"
>-distort</a>, <a href="command-line-options.html#implode" >-implode</a>, and <a href="command-line-options.html#fx" >-fx</a>.
-However it also effects operations that may access pixels just outside the
+However it also affects operations that may access pixels just outside the
image proper, such as <a href="command-line-options.html#convolve">-convolve</a>, <a
href="command-line-options.html#blur">-blur</a>, and <a href="command-line-options.html#sharpen">-sharpen</a>. </p>
<div style="margin: auto;">
- <h3 class="magick-header"><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>
-StaticGray TrueColor
+<pre class="highlight"><code>StaticGray TrueColor
GrayScale DirectColor
StaticColor default
PseudoColor visual id
-</pre>
+</code></pre>
<p>The X server must support the visual you choose, otherwise an error occurs.
If a visual is not specified, the visual class that can display the most
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
the currently selected font family. Use a positive integer for
<var>fontWeight</var> or select from the following.</p>
-<dl class="dl-horizontal">
-<dt>Thin </dt>
-<dd>Same as <var>fontWeight</var> = 100.</dd>
-<dt>ExtraLight </dt>
-<dd>Same as <var>fontWeight</var> = 200.</dd>
-<dt>Light </dt>
-<dd>Same as <var>fontWeight</var> = 300.</dd>
-<dt>Normal </dt>
-<dd>Same as <var>fontWeight</var> = 400.</dd>
-<dt>Medium </dt>
-<dd>Same as <var>fontWeight</var> = 500.</dd>
-<dt>DemiBold </dt>
-<dd>Same as <var>fontWeight</var> = 600.</dd>
-<dt>Bold </dt>
-<dd>Same as <var>fontWeight</var> = 700.</dd>
-<dt>ExtraBold </dt>
-<dd>Same as <var>fontWeight</var> = 800.</dd>
-<dt>Heavy </dt>
-<dd>Same as <var>fontWeight</var> = 900.</dd>
+<dl class="row">
+<dt class="col-md-4">Thin </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 100.</dd>
+<dt class="col-md-4">ExtraLight </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 200.</dd>
+<dt class="col-md-4">Light </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 300.</dd>
+<dt class="col-md-4">Normal </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 400.</dd>
+<dt class="col-md-4">Medium </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 500.</dd>
+<dt class="col-md-4">DemiBold </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 600.</dd>
+<dt class="col-md-4">Bold </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 700.</dd>
+<dt class="col-md-4">ExtraBold </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 800.</dd>
+<dt class="col-md-4">Heavy </dt>
+<dd class="col-md-8">Same as <var>fontWeight</var> = 900.</dd>
</dl>
<br/>
href="command-line-options.html#stretch">-stretch</a>, and <a href="command-line-options.html#style">-style</a>. </p>
<div style="margin: auto;">
- <h3 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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 class="magick-header"><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>
-</div>
+ <!-- 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 2nd June 2017 20:19 -->
\ No newline at end of file
+<!-- Magick Cache 8th July 2018 08:34 -->
\ No newline at end of file
projects / imagemagick / blobdiff