Blame - www/command-line-options.html - platform/external/ImageMagick

blob: f81a34a99a779c5236d6452810733c6125ce1e1e [file] [log] [blame]

Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1
				2
				3
				4
cristy	29dc865	2015-05-12 16:26:21 +0000	[diff] [blame]	5	<!DOCTYPE html>
cristy	d243201	2015-05-04 23:15:15 +0000	[diff] [blame]	6	<html lang="en">
cristy	ad41c0c	2012-10-31 00:49:28 +0000	[diff] [blame]	7	<head>
Cristy	912a922	2016-06-17 15:37:28 -0400	[diff] [blame]	8	<meta charset="utf-8" />
Cristy	3b0b58d	2016-11-06 07:40:23 -0500	[diff] [blame]	9	<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no" />
				10	<meta http-equiv="x-ua-compatible" content="ie=edge" />
Cristy	6549abb	2016-11-10 08:25:55 -0500	[diff] [blame]	11	<title>Command-line Options @ ImageMagick</title>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	12	<meta http-equiv="content-type" content="text/html; charset=utf-8"/>
				13	<meta name="application-name" content="ImageMagick"/>
				14	<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."/>
Cristy	364a72f	2016-11-04 22:38:41 -0400	[diff] [blame]	15	<meta name="application-url" content="https://www.imagemagick.org"/>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	16	<meta name="generator" content="PHP"/>
				17	<meta name="keywords" content="command-line, options, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert"/>
				18	<meta name="rating" content="GENERAL"/>
				19	<meta name="robots" content="INDEX, FOLLOW"/>
				20	<meta name="generator" content="ImageMagick Studio LLC"/>
				21	<meta name="author" content="ImageMagick Studio LLC"/>
				22	<meta name="revisit-after" content="2 DAYS"/>
				23	<meta name="resource-type" content="document"/>
Cristy	912a922	2016-06-17 15:37:28 -0400	[diff] [blame]	24	<meta name="copyright" content="Copyright (c) 1999-2016 ImageMagick Studio LLC"/>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	25	<meta name="distribution" content="Global"/>
				26	<meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1"/>
Cristy	912a922	2016-06-17 15:37:28 -0400	[diff] [blame]	27	<meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
Cristy	579a0cb	2016-11-26 12:27:17 -0500	[diff] [blame^]	28	<link rel="canonical" href="https://www.imagemagick.org/script/command-line-options.html"/>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	29	<link rel="icon" href="../images/wand.png"/>
				30	<link rel="shortcut icon" href="../images/wand.ico"/>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	31	<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" />
Cristy	ce4a355	2015-12-14 13:53:35 -0500	[diff] [blame]	32	<link rel="stylesheet" href="css/magick.css"/>
cristy	ad41c0c	2012-10-31 00:49:28 +0000	[diff] [blame]	33	</head>
cristy	d243201	2015-05-04 23:15:15 +0000	[diff] [blame]	34	<body>
cristy	ad41c0c	2012-10-31 00:49:28 +0000	[diff] [blame]	35	<div class="main">
cristy	d243201	2015-05-04 23:15:15 +0000	[diff] [blame]	36	<div class="magick-masthead">
				37	<div class="container">
Cristy	6549abb	2016-11-10 08:25:55 -0500	[diff] [blame]	38	<script async="async" src="http://localhost/pagead/js/adsbygoogle.js"></script> <ins class="adsbygoogle"
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	39	style="display:block"
				40	data-ad-client="ca-pub-3129977114552745"
				41	data-ad-slot="6345125851"
				42	data-ad-format="auto"></ins>
cristy	29f2c97	2015-07-28 13:37:46 +0000	[diff] [blame]	43	<script>
Cristy	542697a	2015-10-12 20:10:32 -0400	[diff] [blame]	44	(adsbygoogle = window.adsbygoogle \|\| []).push({});
cristy	d243201	2015-05-04 23:15:15 +0000	[diff] [blame]	45	</script>
cristy	d243201	2015-05-04 23:15:15 +0000	[diff] [blame]	46	<nav class="magick-nav">
cristy	44443b9	2015-05-05 00:06:07 +0000	[diff] [blame]	47	<a class="magick-nav-item " href="../index.html">Home</a>
cristy	ea2793e	2015-05-31 16:52:26 +0000	[diff] [blame]	48	<a class="magick-nav-item " href="binary-releases.html">Download</a>
cristy	d243201	2015-05-04 23:15:15 +0000	[diff] [blame]	49	<a class="magick-nav-item " href="command-line-tools.html">Tools</a>
Cristy	e93be68	2015-11-26 09:07:51 -0500	[diff] [blame]	50	<a class="magick-nav-item " href="command-line-processing.html">Command-line</a>
cristy	ea2793e	2015-05-31 16:52:26 +0000	[diff] [blame]	51	<a class="magick-nav-item " href="resources.html">Resources</a>
				52	<a class="magick-nav-item " href="api.html">Develop</a>
Cristy	6549abb	2016-11-10 08:25:55 -0500	[diff] [blame]	53	<a class="magick-nav-item " href="https://www.imagemagick.org/script/search.php">Search</a>
				54	<a class="magick-nav-item pull-right" href="https://www.imagemagick.org/discourse-server/">Community</a>
cristy	d243201	2015-05-04 23:15:15 +0000	[diff] [blame]	55	</nav>
				56	</div>
				57	</div>
				58	<div class="container">
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	59	<div class="magick-header">
Cristy	e077971	2016-07-30 17:25:22 -0400	[diff] [blame]	60	<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#alpha-color">‑alpha‑color</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#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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	61
				62	<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>
				63
				64	<div style="margin: auto;">
				65	<h3 class="magick-header"><a id="adaptive-blur"></a>-adaptive-blur <var>radius</var>[x<var>sigma</var>]</h3>
				66	</div>
				67
				68	<p class="magick-description">Adaptively blur pixels, with decreasing effect near edges.</p>
				69
				70	<p>A Gaussian operator of the given radius and standard deviation (<var>sigma</var>) is used. If <var>sigma</var> is not given it
				71	defaults to 1.</p>
				72
				73	<div style="margin: auto;">
				74	<h3 class="magick-header"><a id="adaptive-resize"></a>-adaptive-resize <var>geometry</var></h3>
				75	</div>
				76
				77	<p class="magick-description">Resize the image using data-dependent triangulation.</p>
				78
				79	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. The <a href="command-line-options.html#adaptive-resize">-adaptive-resize</a>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	80	option defaults to data-dependent triangulation. Use the <a
				81	href="command-line-options.html#filter">-filter</a> to choose a different resampling algorithm.
				82	Offsets, if present in the geometry string, are ignored, and the <a
				83	href="command-line-options.html#gravity">-gravity</a> option has no effect.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	84
				85	<div style="margin: auto;">
				86	<h3 class="magick-header"><a id="adaptive-sharpen"></a>-adaptive-sharpen <var>radius</var>[x<var>sigma</var>]</h3>
				87	</div>
				88
				89	<p class="magick-description">Adaptively sharpen pixels, with increasing effect near edges.</p>
				90
				91	<p>A Gaussian operator of the given radius and standard deviation
				92	(<var>sigma</var>) is used. If <var>sigma</var> is not given it
				93	defaults to 1.</p>
				94
				95	<div style="margin: auto;">
				96	<h3 class="magick-header"><a id="adjoin"></a>-adjoin</h3>
				97	</div>
				98
				99	<p class="magick-description">Join images into a single multi-image file.</p>
				100
				101	<p>This option is enabled by default. An attempt is made to save all images of
				102	an image sequence into the given output file. However, some formats, such as
				103	JPEG and PNG, do not support more than one image per file, and in that case
				104	ImageMagick is forced to write each image as a separate file. As such, if
				105	more than one image needs to be written, the filename given is modified by
				106	adding a <a href="command-line-options.html#scene">-scene</a> number before the suffix, in order to
				107	make distinct names for each image. </p>
				108
				109	<p>Use <a href="command-line-options.html#adjoin">+adjoin</a> to force each image to be written to
				110	separate files, whether or not the file format allows multiple images per file
				111	(for example, GIF, MIFF, and TIFF). </p>
				112
				113	<p>Including a C-style integer format string in the output filename will
				114	automagically enable <a href="command-line-options.html#adjoin">+adjoin</a> and are used to specify
				115	where the <a href="command-line-options.html#scene">-scene</a> number is placed in the filenames. These
				116	strings, such as '<code>%d</code>' or '<code>%03d</code>', are familiar to those
				117	who have used the standard <code>printf()</code>' C-library function. As an
				118	example, the command</p>
				119
				120	<pre>
				121	convert logo: rose: -morph 15 my%02dmorph.jpg
				122	</pre>
				123
				124	<p>will create a sequence of 17 images (the two given plus 15 more created by
				125	<a href="command-line-options.html#morph">-morph</a>), named: my00morph.jpg, my01morph.jpg,
				126	my02morph.jpg, ..., my16morph.jpg. </p>
				127
				128	<p>In summary, ImageMagick tries to write all images to one file, but will
				129	save to multiple files, if any of the following conditions exist...</p>
				130	<ol>
				131	<li>the output image's file format does not allow multi-image files,</li>
				132	<li>the <a href="command-line-options.html#adjoin">+adjoin</a> option is given, or</li>
				133	<li>a printf() integer format string (eg: "%d") is present in the output
				134	filename.</li>
				135	</ol>
				136
				137
				138	<div style="margin: auto;">
				139	<h3 class="magick-header"><a id="affine"></a>-affine
				140	<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>
				141	</div>
				142
				143	<p class="magick-description">Set the drawing transformation matrix for combined rotating and scaling.</p>
				144
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	145	<p>This option sets a transformation matrix, for use by subsequent <a
				146	href="command-line-options.html#draw">-draw</a> or <a href="command-line-options.html#transform">-transform</a> options. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	147
				148	<p>The matrix entries are entered as comma-separated numeric values either in
				149	quotes or without spaces. </p>
				150
				151	<p>Internally, the transformation matrix has 3x3 elements, but three of them
				152	are omitted from the input because they are constant. The new (transformed)
				153	coordinates (<var>x'</var>, <var>y'</var>) of a pixel at
				154	position (<var>x</var>, <var>y</var>) in the original
				155	image are calculated using the following matrix equation.</p>
				156
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	157	<p class="text-center"><img class="img-thumbnail" alt="affine transformation" src="../images/affine.png"/> </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	158
				159	<p> The size of the resulting image is that of the smallest rectangle that
				160	contains the transformed source image. The parameters
				161	<var>t<sub>x</sub></var> and <var>t<sub>y</sub></var>
				162	subsequently shift the image pixels so that those that are moved out of the
				163	image area are cut off.</p>
				164
				165	<p>The transformation matrix complies with the left-handed pixel coordinate
				166	system: positive <var>x</var> and <var>y</var> directions
				167	are rightward and downward, resp.; positive rotation is clockwise.</p>
				168
				169	<p> If the translation coefficients <var>t<sub>x</sub></var> and
				170	<var>t<sub>y</sub></var> are omitted they default to 0,0. Therefore,
				171	four parameters suffice for rotation and scaling without translation.</p>
				172
				173	<p>Scaling by the factors <var>s<sub>x</sub></var> and
				174	<var>s<sub>y</sub></var> in the <var>x</var> and <var>y</var> directions,
				175	respectively, is accomplished with the following.</p>
				176
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	177	<p>See <a href="command-line-options.html#transform">-transform</a>, and the <a
				178	href="command-line-options.html#distort">-distort</a> method '<code>Affineprojection</code> for more
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	179	information </p>
				180
				181
				182	<pre>
				183	-affine <var>s<sub>x</sub></var>,0,0,<var>s<sub>y</sub></var>
				184	</pre>
				185
				186	<p>Translation by a displacement (<var>t<sub>x</sub></var>, <var>t<sub>y</sub></var>) is accomplished like so:</p>
				187
				188	<pre>
				189	-affine 1,0,0,1,<var>t<sub>x</sub></var>,<var>t<sub>y</sub></var>
				190	</pre>
				191
				192	<p>Rotate clockwise about the origin (the upper left-hand corner) by an angle
				193	<var>a</var> by letting <var>c</var> = cos(<var>a</var>), <var>s</var>
				194	= sin(<var>a</var>), and using the following.</p>
				195
				196	<pre>
				197	-affine <var>c</var>,<var>s</var>,-<var>s</var>,<var>c</var>
				198	</pre>
				199
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	200	<p>The cumulative effect of a sequence of <a href="command-line-options.html#affine" >-affine</a>
				201	transformations can be accomplished by instead by a single <a href="command-line-options.html#affine"
				202	>-affine</a> operation using the matrix equal to the product of the matrices
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	203	of the individual transformations.</p>
				204
				205	<p>An attempt is made to detect near-singular transformation matrices. If the
				206	matrix determinant has a sufficiently small absolute value it is rejected.</p>
				207
				208	<div style="margin: auto;">
				209	<h3 class="magick-header"><a id="alpha"></a>-alpha <var>type</var></h3>
				210	</div>
				211
				212	<p class="magick-description">Gives control of the alpha/matte channel of an image.</p>
				213
				214	<p>Used to set a flag on an image indicating whether or not to use existing alpha
				215	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>
				216
				217	<dl class="dl-horizontal">
				218	<dt>Activate</dt>
				219	<dd>
				220	Enable the image's transparency channel. Note normally Set
				221	should be used instead of this, unless you specifically need to
				222	preserve existing (but specifically turned Off) transparency
				223	channel. </dd>
				224
				225	<dt>Associate</dt>
				226	<dd>
				227	associate the alpha channel with the image.</dd>
				228
				229	<dt>Deactivate</dt>
				230	<dd>
				231	Disables the image's transparency channel. Does not delete or change the
				232	existing data, just turns off the use of that data.</dd>
				233
				234	<dt>Disassociate</dt>
				235	<dd>
				236	disassociate the alpha channel from the image.</dd>
				237
				238	<dt>Set</dt>
				239	<dd>
				240	Activates the alpha/matte channel. If it was previously turned off
				241	then it also resets the channel to opaque. If the image already had
				242	the alpha channel turned on, it will have no effect.</dd>
				243
				244	<dt>Opaque</dt>
				245	<dd>
				246	Enables the alpha/matte channel and forces it to be fully opaque.
				247	</dd>
				248
				249	<dt>Transparent</dt>
				250	<dd>
				251	Activates the alpha/matte channel and forces it to be fully
				252	transparent. This effectively creates a fully transparent image the
				253	same size as the original and with all its original RGB data still
				254	intact, but fully transparent. </dd>
				255
				256	<dt>Extract</dt>
				257	<dd>
				258	Copies the alpha channel values into all the color channels and turns
				259	'Off' the the image's transparency, so as to generate
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	260	a grayscale mask of the image's shape. The alpha channel data is left
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	261	intact just deactivated. This is the inverse of 'Copy'.
				262	</dd>
				263
				264	<dt>Copy</dt>
				265	<dd>
				266	Turns 'On' the alpha/matte channel, then copies the
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	267	grayscale intensity of the image, into the alpha channel, converting
				268	a grayscale mask into a transparent shaped mask ready to be colored
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	269	appropriately. The color channels are not modified. </dd>
				270
				271	<dt>Shape</dt>
				272	<dd>
				273	As per 'Copy' but also colors the resulting shape mask with
				274	the current background color. That is the RGB color channels is
				275	replaced, with appropriate alpha shape.
				276	</dd>
				277
				278	<dt>Remove</dt>
				279	<dd>
				280	Composite the image over the background color.
				281	</dd>
				282
				283	<dt>Background</dt>
				284	<dd>
				285	Set any fully-transparent pixel to the background color, while leaving
				286	it fully-transparent. This can make some image file formats, such as
				287	PNG, smaller as the RGB values of transparent pixels are more uniform,
				288	and thus can compress better.
				289	</dd>
				290	</dl>
				291
				292	<p>Note that while the obsolete <code>+matte</code> operation was the
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	293	same as "<code><a href="command-line-options.html#alpha" >-alpha</a> Off</code>", the <code>
				294	>-matte</code> operation was the same as "<code><a href="command-line-options.html#alpha" >-alpha</a>
				295	Set</code>" and not "<code><a href="command-line-options.html#alpha" >-alpha</a> On</code>". </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	296
Cristy	f650f4f	2016-04-01 10:53:07 -0400	[diff] [blame]	297	<div style="margin: auto;">
				298	<h3 class="magick-header"><a id="alpha-color"></a>-alpha-color <var>color</var></h3>
				299	</div>
				300
				301	<p class="magick-description">Specify the color to be used with the <a href="command-line-options.html#frame">-frame</a> option.</p>
				302
				303	<p>The color is specified using the format described under the <a href="command-line-options.html#fill">-fill</a> option.</p>
				304
				305	<p>The default matte color is <code>#BDBDBD</code>, <span
				306	style="background-color: #bdbdbd;">this shade of gray</span>.</p>
				307
				308	<p>This is an IMv7 option, use <a href="command-line-options.html#mattecolor">mattecolor</a> with IMv6.</p>
				309
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	310
				311	<div style="margin: auto;">
				312	<h3 class="magick-header"><a id="annotate"></a>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	313	-annotate <var>degrees</var> <var>text</var><br />
				314	-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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	315	</div>
				316
				317	<p class="magick-description">Annotate an image with text</p>
				318
				319	<p>This is a convenience for annotating an image with text. For more precise
				320	control over text annotations, use <a href="command-line-options.html#draw">-draw</a>.</p>
				321
				322
				323	<p>The values <var>Xdegrees</var> and <var>Ydegrees</var>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	324	control the shears applied to the text, while <var>t<sub>x</sub></var> and <var>t<sub>y</sub></var> are offsets that give the location of the text relative any <a href="command-line-options.html#gravity" >-gravity</a> setting and defaults to the upper left corner of the image.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	325
				326	<p>Using <a href="command-line-options.html#annotate">-annotate</a> <var>degrees</var>
				327	or <a href="command-line-options.html#annotate">-annotate</a> <var>degrees</var>x<var>degrees</var> produces an unsheared rotation of the text. The
				328	direction of the rotation is positive, which means a clockwise rotation if <var>degrees</var> is positive. (This conforms to the usual mathematical
				329	convention once it is realized that the positive <var>y</var>–direction is
				330	conventionally considered to be <var>downward</var> for images.)</p>
				331
				332	<p>The new (transformed) coordinates (<var>x'</var>, <var>y'</var>) of a pixel at position (<var>x</var>, <var>y</var>) in the image are calculated using the following matrix
				333	equation.</p>
				334
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	335	<p class="text-center"><img class="img-thumbnail" alt="annotate transformation" src="../images/annotate.png"/></p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	336
				337	<p>If <var>t<sub>x</sub></var> and <var>t<sub>y</sub></var> are omitted, they default to 0. This makes the
				338	bottom-left of the text becomes the upper-left corner of the image, which is
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	339	probably undesirable. Adding a <a href="command-line-options.html#gravity" >-gravity</a> option in this
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	340	case leads to nice results.</p>
				341
				342	<p>Text is any UTF-8 encoded character sequence. If <var>text</var>
				343	is of the form '@mytext.txt', the text is read from the file
				344	<code>mytext.txt</code>. Text in a file is taken literally; no embedded
				345	formatting characters are recognized.</p>
				346
				347	<div style="margin: auto;">
				348	<h3 class="magick-header"><a id="antialias"></a>-antialias</h3>
				349	</div>
				350
				351	<p class="magick-description">Enable/Disable of the rendering of anti-aliasing pixels when drawing fonts and lines.</p>
				352
				353	<p>By default, objects (e.g. text, lines, polygons, etc.) are antialiased when
				354	drawn. Use <a href="command-line-options.html#antialias">+antialias</a> to disable the addition of
				355	antialiasing edge pixels. This will then reduce the number of colors added to
				356	an image to just the colors being directly drawn. That is, no mixed colors
				357	are added when drawing such objects. </p>
				358
				359	<div style="margin: auto;">
				360	<h3 class="magick-header"><a id="append"></a>-append</h3>
				361	</div>
				362
				363	<p class="magick-description">Join current images vertically or horizontally.</p>
				364
				365	<p>This option creates a single longer image, by joining all the current
				366	images in sequence top-to-bottom. Use <a href="command-line-options.html#append">+append</a> to
				367	stack images left-to-right. </p>
				368
				369	<p>If they are not of the same width, narrower images are padded with the
				370	current <a href="command-line-options.html#background">-background</a> color setting, and their
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	371	position relative to each other can be controlled by the current <a
				372	href="command-line-options.html#gravity">-gravity</a> setting. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	373
				374
				375	<div style="margin: auto;">
				376	<h3 class="magick-header"><a id="attenuate"></a>-attenuate <var>value</var></h3>
				377	</div>
				378
				379	<p class="magick-description">Lessen (or intensify) when adding noise to an image.</p>
				380
				381	<p>If unset the value is equivalent to 1.0, or a maximum noise addition</p>
				382
				383	<div style="margin: auto;">
				384	<h3 class="magick-header"><a id="authenticate"></a>-authenticate <var>password</var></h3>
				385	</div>
				386
				387	<p class="magick-description">Decrypt a PDF with a password.</p>
				388
				389	<p>Use this option to supply a <var>password</var> for decrypting
				390	a PDF that has been encrypted using Microsoft Crypto API (MSC API). The
				391	encrypting using the MSC API is not supported.</p>
				392
				393	<p>For a different encryption method, see <a href="command-line-options.html#encipher">-encipher</a>
				394	and <a href="command-line-options.html#decipher">-decipher</a>. </p>
				395
				396
				397	<div style="margin: auto;">
				398	<h3 class="magick-header"><a id="auto-gamma"></a>-auto-gamma</h3>
				399	</div>
				400
				401	<p class="magick-description">Automagically adjust gamma level of image.</p>
				402
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	403	<p>This calculates the mean values of an image, then applies a calculated <a
				404	href="command-line-options.html#gamma" >-gamma</a> adjustment so that is the mean color exists in the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	405	image it will get a have a value of 50%. </p>
				406
				407	<p>This means that any solid 'gray' image becomes 50% gray. </p>
				408
				409	<p>This works well for real-life images with little or no extreme dark and
				410	light areas, but tend to fail for images with large amounts of bright sky or
				411	dark shadows. It also does not work well for diagrams or cartoon like images.
				412	</p>
				413
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	414	<p>It uses the <a href="command-line-options.html#channel" >-channel</a> setting, (including the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	415	'<var>sync</var>' flag for channel synchronization), to determine which color
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	416	values is used and modified. As the default <a href="command-line-options.html#channel"
				417	>-channel</a> setting is '<var>RGB,sync</var>', channels are modified
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	418	together by the same gamma value, preserving colors. </p>
				419
				420
				421
				422	<div style="margin: auto;">
				423	<h3 class="magick-header"><a id="auto-level"></a>-auto-level</h3>
				424	</div>
				425
				426	<p class="magick-description">Automagically adjust color levels of image.</p>
				427
				428	<p>This is a 'perfect' image normalization operator. It finds the exact
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	429	minimum and maximum color values in the image and then applies a <a
				430	href="command-line-options.html#level" >-level</a> operator to stretch the values to the full range of
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	431	values. </p>
				432
				433	<p>The operator is not typically used for real-life images, image scans, or
				434	JPEG format images, as a single 'out-rider' pixel can set a bad min/max values
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	435	for the <a href="command-line-options.html#level" >-level</a> operation. On the other hand it is the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	436	right operator to use for color stretching gradient images being used to
				437	generate Color lookup tables, distortion maps, or other 'mathematically'
				438	defined images. </p>
				439
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	440	<p>The operator is very similar to the <a href="command-line-options.html#normalize">-normalize</a>, <a
				441	href="command-line-options.html#contrast-stretch" >-contrast-stretch</a>, and <a href="command-line-options.html#linear-stretch"
				442	>-linear-stretch</a> operators, but without 'histogram binning' or 'clipping'
				443	problems that these operators may have. That is <a href="command-line-options.html#auto-level"
				444	>-auto-level</a> is the perfect or ideal version these operators. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	445
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	446	<p>It uses the <a href="command-line-options.html#channel" >-channel</a> setting, (including the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	447	special '<var>sync</var>' flag for channel synchronization), to determine
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	448	which color values are used and modified. As the default <a
				449	href="command-line-options.html#channel" >+channel</a> setting is '<var>RGB,sync</var>', the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	450	'<var>sync</var>' ensures that the color channels will are modified
				451	together by the same gamma value, preserving colors, and ignoring
				452	transparency. </p>
				453
				454
				455	<div style="margin: auto;">
				456	<h3 class="magick-header"><a id="auto-orient"></a>-auto-orient</h3>
				457	</div>
				458
				459	<p class="magick-description">adjusts an image so that its orientation is suitable for viewing (i.e. top-left orientation).</p>
				460
				461	<p>This operator reads and resets the EXIF image profile setting 'Orientation'
				462	and then performs the appropriate 90 degree rotation on the image to orient
				463	the image, for correct viewing. </p>
				464
				465	<p>This EXIF profile setting is usually set using a gravity sensor in digital
				466	camera, however photos taken directly downward or upward may not have an
				467	appropriate value. Also images that have been orientation 'corrected' without
				468	reseting this setting, may be 'corrected' again resulting in a incorrect
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	469	result. If the EXIF profile was previously stripped, the <a
				470	href="command-line-options.html#auto-orient" >-auto-orient</a> operator will do nothing. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	471
				472
				473	<div style="margin: auto;">
				474	<h3 class="magick-header"><a id="average"></a>-average</h3>
				475	</div>
				476
				477	<p class="magick-description">Average a set of images.</p>
				478
				479	<p>An error results if the images are not identically sized.</p>
				480
				481
				482	<div style="margin: auto;">
				483	<h3 class="magick-header"><a id="backdrop"></a>-backdrop</h3>
				484	</div>
				485
				486	<p class="magick-description">Display the image centered on a backdrop.</p>
				487
				488	<p>This backdrop covers the entire workstation screen and is useful for hiding
				489	other X window activity while viewing the image. The color of the backdrop is
				490	specified as the background color. The color is specified using the format
				491	described under the <a href="command-line-options.html#fill">-fill</a> option.</p>
				492
				493	<div style="margin: auto;">
				494	<h3 class="magick-header"><a id="background"></a>-background <var>color</var></h3>
				495	</div>
				496
				497	<p class="magick-description">Set the background color.</p>
				498
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	499	<p>The color is specified using the format described under the <a
				500	href="command-line-options.html#fill">-fill</a> option. The default background color (if none is
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	501	specified or found in the image) is white.</p>
				502
				503	<div style="margin: auto;">
				504	<h3 class="magick-header"><a id="bench"></a>-bench <var>iterations</var></h3>
				505	</div>
				506
				507	<p class="magick-description">Measure performance.</p>
				508
				509	<p>Repeat the entire command for the given number of <var>iterations</var> and report the user-time and elapsed time. For instance,
				510	consider the following command and its output. Modify the benchmark with the
				511	-duration to run the benchmark for a fixed number of seconds and -concurrent
				512	to run the benchmark in parallel (requires the OpenMP feature).</p>
				513
				514	<pre>
Cristy	e09ed31	2016-03-06 08:07:39 -0500	[diff] [blame]	515	-> convert logo: -resize 200% -bench 5 logo.png
				516	Performance[1]: 5i 1.344ips 1.000e 3.710u 0:03.720
				517	Performance[2]: 5i 1.634ips 0.549e 3.890u 0:03.060
				518	Performance[3]: 5i 2.174ips 0.618e 3.190u 0:02.300
				519	Performance[4]: 5i 1.678ips 0.555e 3.810u 0:02.980
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	520	Performance[4]: 5i 0.875657ips 6.880u 0:05.710
				521	</pre>
				522
Cristy	e09ed31	2016-03-06 08:07:39 -0500	[diff] [blame]	523	<p>In this example, 5 iterations were completed at 2.174 iterations per
				524	second, using 3 threads and 3.190 seconds of the user allotted time, for
				525	a total elapsed time of 2.300 seconds.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	526
				527	<div style="margin: auto;">
				528	<h3 class="magick-header"><a id="bias"></a>-bias <var>value</var>{<var>%</var>}</h3>
				529	</div>
				530
				531	<p class="magick-description">Add bias when convolving an image.</p>
				532
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	533	<p>This option shifts the output of <a href="command-line-options.html#convolve">‑convolve</a> so that
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	534	positive and negative results are relative to the specified bias value. </p>
				535
				536	<p>This is important for non-HDRI compilations of ImageMagick when dealing
				537	with convolutions that contain negative as well as positive values. This is
				538	especially the case with convolutions involving high pass filters or edge
				539	detection. Without an output bias, the negative values are clipped at
				540	zero.</p>
				541
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	542	<p>When using an ImageMagick with the HDRI compile-time setting, <a href="command-line-options.html#bias">‑bias</a> is not needed, as ImageMagick is able to store/handle any
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	543	negative results without clipping to the color value range
				544	(0..QuantumRange).</p>
				545
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	546	<p>See the discussion on HDRI implementations of ImageMagick on the page <a
				547	href="high-dynamic-range.html" >High Dynamic-Range Images</a>. For more
				548	about HDRI go the ImageMagick <a
Cristy	364a72f	2016-11-04 22:38:41 -0400	[diff] [blame]	549	href="https://www.imagemagick.org/Usage/basics/#hdri" >Usage</a> pages or this
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	550	<a
				551	href="http://en.wikipedia.org/wiki/High_dynamic_range_imaging">Wikipedia</a>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	552	entry. </p>
				553
				554	<div style="margin: auto;">
				555	<h3 class="magick-header"><a id="black-point-compensation"></a>-black-point-compensation</h3>
				556	</div>
				557
				558	<p class="magick-description">Use black point compensation.</p>
				559
				560	<div style="margin: auto;">
				561	<h3 class="magick-header"><a id="black-threshold"></a>-black-threshold <var>value</var>{<var>%</var>}</h3>
				562	</div>
				563
				564	<p class="magick-description">Force to black all pixels below the threshold while leaving all pixels at or above the threshold unchanged.</p>
				565
				566	<p> The threshold value can be given as a percentage or as an absolute integer
				567	value within [0, <var>QuantumRange</var>] corresponding to the
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	568	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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	569
				570
				571	<div style="margin: auto;">
				572	<h3 class="magick-header"><a id="blend"></a>-blend <var>geometry</var></h3>
				573	</div>
				574
				575	<p class="magick-description">blend an image into another by the given absolute value or percent.</p>
				576
				577	<p>Blend will average the images together ('plus') according to the
				578	percentages given and each pixels transparency. If only a single percentage
				579	value is given it sets the weight of the composite or 'source' image, while
				580	the background image is weighted by the exact opposite amount. That is a
				581	<code>-blend 30%</code> merges 30% of the 'source' image with 70% of the
				582	'destination' image. Thus it is equivalent to <code>-blend 30x70%</code>.</p>
				583
				584
				585	<div style="margin: auto;">
				586	<h3 class="magick-header"><a id="blue-primary"></a>-blue-primary <var>x</var>,<var>y</var></h3>
				587	</div>
				588
				589	<p class="magick-description">Set the blue chromaticity primary point.</p>
				590
				591	<div style="margin: auto;">
				592	<h3 class="magick-header"><a id="blue-shift"></a>-blue-shift <var>factor</var></h3>
				593	</div>
				594
				595	<p class="magick-description">simulate a scene at nighttime in the moonlight. Start with a factor of 1.5</p>
				596
				597	<div style="margin: auto;">
				598
				599	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	600	<h3 class="magick-header"><a id="blur"></a>-blur <var>radius</var><br />-blur <var>radius</var>x<var>sigma</var></h3>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	601	</div>
				602
				603	<p class="magick-description">Reduce image noise and reduce detail levels.</p>
				604
				605	<p>Convolve the image with a Gaussian or normal distribution using the given
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	606	<var >Sigma</var> value. The formula is:</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	607
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	608	<p class="text-center"><img class="img-thumbnail" alt="gaussian distribution" width="243px" height="42px" src="../images/gaussian-blur.png"/></p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	609
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	610	<p>The <var >Sigma</var> value is the important argument, and
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	611	determines the actual amount of blurring that will take place. </p>
				612
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	613	<p>The <var >Radius</var> is only used to determine the size of the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	614	array which will hold the calculated Gaussian distribution. It should be an
				615	integer. If not given, or set to zero, IM will calculate the largest possible
				616	radius that will provide meaningful results for the Gaussian distribution.
				617	</p>
				618
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	619	<p>The larger the <var >Radius</var> the slower the
				620	operation is. However too small a <var >Radius</var>, and sever
				621	aliasing effects may result. As a guideline, <var >Radius</var>
				622	should be at least twice the <var >Sigma</var> value, though three
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	623	times will produce a more accurate result. </p>
				624
				625	<p>This option differs from <a href="command-line-options.html#gaussian-blur">-gaussian-blur</a> simply
				626	by taking advantage of the separability properties of the distribution. Here
				627	we apply a single-dimensional Gaussian matrix in the horizontal direction,
				628	then repeat the process in the vertical direction.</p>
				629
				630	<p>The <a href="command-line-options.html#virtual-pixel">-virtual-pixel</a> setting will determine how
				631	pixels which are outside the image proper are blurred into the final result.
				632	</p>
				633
				634
				635	<div style="margin: auto;">
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	636	<h3 class="magick-header"><a id="border"></a>-border <var>geometry</var></h3>
				637	</div>
				638
				639	<p class="magick-description">Surround the image with a border of color. </p>
				640
				641	<p>Set the width and height using the <var>size</var> portion of the
				642	<var>geometry</var> argument. See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. Offsets are
				643	ignored. </p>
				644
				645	<p>As of IM 6.7.8-8, the <var>geometry</var> arguments behave as follows:</p>
				646
				647	<dl class="dl-horizontal">
				648	<dt><var>value</var></dt>
				649	<dd>value is added to both left/right and top/bottom</dd>
				650	<dt><var>value-x</var><kbd>x</kbd></dt>
				651	<dd>value-x is added only to left/right and top/bottom are unchanged</dd>
				652	<dt><kbd>x</kbd><var>value-y</var></dt>
				653	<dd>value-y is added only to top/bottom and left/right are unchanged</dd>
				654	<dt><var>value-x</var><kbd>x</kbd><var>value-y</var></dt>
				655	<dd>value-x is added to left/right and value-y added to top/bottom</dd>
				656	<dt><var>value-x</var><kbd>x</kbd>0</dt>
				657	<dd>value-x is added only to left/right and top/bottom are unchanged</dd>
				658	<dt>0<kbd>x</kbd><var>value-y</var></dt>
				659	<dd>value-y is added only to top/bottom and left/right are unchanged</dd>
				660	<dt><var>value</var>%</dt>
				661	<dd>value % of width is added to left/right and value % of height is added to top/bottom</dd>
				662	<dt><var>value-x</var><kbd>x</kbd>%</dt>
				663	<dd>value-x % of width is added to left/right and to top/bottom</dd>
				664	<dt>x<var>value-y</var>%</dt>
				665	<dd>value-y % of height is added to top/bottom and to left/right</dd>
				666	<dt><var>value-x</var>%<kbd>x</kbd><var>value-y</var>%</dt>
				667	<dd>value-x % of width is added to left/right and value-y % of height is added to top/bottom</dd>
				668	<dt><var>value-x</var>%<kbd>x</kbd>0%</dt>
				669	<dd>value-x % of width is added to left/right and top/bottom are unchanged</dd>
				670	<dt>0%<kbd>x</kbd><var>value-y</var>%</dt>
				671	<dd>value-y % of height is added to top/bottom and left/right are unchanged</dd>
				672	</dl>
				673
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	674	<p>Set the border color by preceding with the <a
				675	href="command-line-options.html#bordercolor">-bordercolor</a> setting.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	676
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	677	<p>The <a href="command-line-options.html#border">-border</a> operation is affected by the current <a
				678	href="command-line-options.html#compose">-compose</a> setting and assumes that this is using the default
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	679	'<code>Over</code>' composition method. It generates an image of the appropriate
				680	size colors by the current <a href="command-line-options.html#bordercolor">-bordercolor</a> before
				681	overlaying the original image in the center of this net image. This means that
				682	with the default compose method of '<code>Over</code>' any transparent parts may
				683	be replaced by the current <a href="command-line-options.html#bordercolor">-bordercolor</a> setting.</p>
				684	<p>See also the <a href="command-line-options.html#frame">-frame</a> option, which has more
				685	functionality.</p>
				686
				687	<div style="margin: auto;">
				688	<h3 class="magick-header"><a id="bordercolor"></a>-bordercolor <var>color</var></h3>
				689	</div>
				690
				691	<p class="magick-description">Set the border color.</p>
				692
				693	<p>The color is specified using the format described under the <a href="command-line-options.html#fill">-fill</a> option.</p>
				694
				695	<p>The default border color is <code>#DFDFDF</code>, <span style="background-color: #dfdfdf;">this shade of gray</span>.</p>
				696
				697	<div style="margin: auto;">
				698	<h3 class="magick-header"><a id="borderwidth"></a>-borderwidth <var>geometry</var> </h3>
				699	</div>
				700
				701	<p class="magick-description">Set the border width.</p>
				702
				703	<div style="margin: auto;">
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	704	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	705	</div>
				706
				707	<p class="magick-description">Adjust the brightness and/or contrast of the image.</p>
				708
				709	<p>Brightness and Contrast values apply changes to the input image. They are
				710	not absolute settings. A brightness or contrast value of zero means no change.
				711	The range of values is -100 to +100 on each. Positive values increase the
				712	brightness or contrast and negative values decrease the brightness or contrast.
				713	To control only contrast, set the brightness=0. To control only brightness,
				714	set contrast=0 or just leave it off.</p>
				715
				716	<p>You may also use <a href="command-line-options.html#fill">-channel</a> to control which channels to
				717	apply the brightness and/or contrast change. The default is to apply the same
				718	transformation to all channels.</p>
				719
				720	<p>Brightness and Contrast arguments are converted to offset and slope of a
				721	linear transform and applied
				722	using <a href="command-line-options.html#fill">-function polynomial "slope,offset"</a>.</p>
				723
				724	<p>The slope varies from 0 at contrast=-100 to almost vertical at
				725	contrast=+100. For brightness=0 and contrast=-100, the result are totally
				726	midgray. For brightness=0 and contrast=+100, the result will approach but
				727	not quite reach a threshold at midgray; that is the linear transformation
				728	is a very steep vertical line at mid gray.</p>
				729
				730	<p>Negative slopes, i.e. negating the image, are not possible with this
				731	function. All achievable slopes are zero or positive.</p>
				732
				733	<p>The offset varies from -0.5 at brightness=-100 to 0 at brightness=0 to +0.5
				734	at brightness=+100. Thus, when contrast=0 and brightness=100, the result is
				735	totally white. Similarly, when contrast=0 and brightness=-100, the result is
				736	totally black.</p>
				737
				738	<p>As the range of values for the arguments are -100 to +100, adding the '%'
				739	symbol is no different than leaving it off.</p>
				740
				741	<div style="margin: auto;">
				742	<h3 class="magick-header"><a id="cache"></a>-cache <var>threshold</var></h3>
				743	</div>
				744
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	745	<p class="magick-description">(This option has been replaced by the <a href='command-line-options.html#limit'>-limit</a> option).</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	746
				747	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	748	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	749	</div>
				750
				751	<p class="magick-description">Canny edge detector uses a multi-stage algorithm to detect a wide range of edges in the image.</p>
				752
				753	<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>
				754
				755	<div style="margin: auto;">
				756	<h3 class="magick-header"><a id="caption"></a>-caption <var>string</var></h3>
				757	</div>
				758
				759	<p class="magick-description">Assign a caption to an image.</p>
				760
				761	<p>This option sets the caption meta-data of an image read in after this
				762	option has been given. To modify a caption of images already in memory use
				763	"<code><a href="command-line-options.html#set">-set</a> caption</code>". </p>
				764
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	765	<p>The caption can contain special format characters listed in the <a
				766	href="escape.html">Format and
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	767	Print Image Properties</a>. These attributes are expanded when the caption
				768	is finally assigned to the individual images. </p>
				769
				770	<p>If the first character of <var>string</var> is <var>@</var>, the image caption is read from a file titled by the
				771	remaining characters in the string. Comments read in from a file are literal;
				772	no embedded formatting characters are recognized.</p>
				773
				774	<p>Caption meta-data is not visible on the image itself. To do that use the
				775	<a href="command-line-options.html#annotate">-annotate</a> or <a href="command-line-options.html#draw">-draw</a> options
				776	instead.</p>
				777
				778	<p>For example,</p>
				779
				780	<pre>
				781	-caption "%m:%f %wx%h" bird.miff
				782	</pre>
				783
				784	<p>produces an image caption of <code>MIFF:bird.miff 512x480</code> (assuming
				785	that the image <code>bird.miff</code> has a width of 512 and a height of
				786	480.</p>
				787
				788
				789	<div style="margin: auto;">
				790	<h3 class="magick-header"><a id="cdl"></a>-cdl <var>filename</var></h3>
				791	</div>
				792
				793	<p class="magick-description">color correct with a color decision list.</p>
				794
				795	<p>Here is an example color correction collection:</p>
				796
				797	<pre>
				798	<?xml version="1.0" encoding="UTF-8"?>
				799	<ColorCorrectionCollection xmlns="urn:ASC:CDL:v1.2">
				800	<ColorCorrection id="cc06668">
				801	<SOPNode>
				802	<Slope> 0.9 1.2 0.5 </Slope>
				803	<Offset> 0.4 -0.5 0.6 </Offset>
				804	<Power> 1.0 0.8 1.5 </Power>
				805	</SOPNode>
				806	<SATNode>
				807	<Saturation> 0.85 </Saturation>
				808	</SATNode>
				809	</ColorCorrection>
				810	</ColorCorrectionCollection>
				811	</pre>
				812
				813	<div style="margin: auto;">
				814	<h3 class="magick-header"><a id="channel"></a>-channel <var>type</var></h3>
				815	</div>
				816
				817	<p class="magick-description">Specify those image color channels to which subsequent operators are limited.</p>
				818
				819	<p>Choose from: <code>Red</code>, <code>Green</code>, <code>Blue</code>,
				820	<code>Alpha</code>, <code>Gray</code>, <code>Cyan</code>, <code>Magenta</code>,
				821	<code>Yellow</code>, <code>Black</code>, <code>Opacity</code>,
				822	<code>Index</code>, <code>RGB</code>, <code>RGBA</code>, <code>CMYK</code>, or
				823	<code>CMYKA</code>.</p>
				824
				825	<p>The channels above can also be specified as a comma-separated list or can be
				826	abbreviated as a concatenation of the letters '<code>R</code>', '<code>G</code>',
				827	'<code>B</code>', '<code>A</code>', '<code>O</code>', '<code>C</code>',
				828	'<code>M</code>', '<code>Y</code>', '<code>K</code>'.
				829
				830	For example, to only select the <code>Red</code> and <code>Blue</code> channels
				831	you can either use </p>
				832	<pre>
				833	-channel Red,Blue
				834	</pre>
				835	<p>or you can use the short hand form</p>
				836	<pre>
				837	-channel RB
				838	</pre>
				839
				840	<p>All the channels that are present in an image can be specified using the
				841	special channel type <code>All</code>. Not all operators are 'channel capable',
				842	but generally any operators that are generally 'grey-scale' image operators,
				843	will understand this setting. See individual operator documentation. </p>
				844
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	845	<br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	846
				847	<p>On top of the normal channel selection an extra flag can be specified,
				848	'<code>Sync</code>'. This is turned on by default and if set means that
				849	operators that understand this flag should perform: cross-channel
				850	synchronization of the channels. If not specified, then most grey-scale
				851	operators will apply their image processing operations to each individual
				852	channel (as specified by the rest of the <a href="command-line-options.html#channel">-channel</a>
				853	setting) completely independently from each other. </p>
				854
				855	<p>For example for operators such as <a href="command-line-options.html#auto-level">-auto-level</a> and
				856	<a href="command-line-options.html#auto-gamma">-auto-gamma</a> the color channels are modified
				857	together in exactly the same way so that colors will remain in-sync. Without
				858	it being set, then each channel is modified separately and
				859	independently, which may produce color distortion. </p>
				860
				861	<p>The <a href="command-line-options.html#morphology">-morphology</a> '<code>Convolve</code>' method
				862	and the <a href="command-line-options.html#compose">-compose</a> mathematical methods, also understands
				863	the '<code>Sync</code>' flag to modify the behavior of pixel colors according
				864	to the alpha channel (if present). That is to say it will modify the image
				865	processing with the understanding that fully-transparent colors should not
				866	contribute to the final result. </p>
				867
				868	<p>Basically, by default, operators work with color channels in synchronous, and
				869	treats transparency as special, unless the <a href="command-line-options.html#channel">-channel</a>
				870	setting is modified so as to remove the effect of the '<code>Sync</code>' flag.
				871	How each operator does this depends on that operators current implementation.
				872	Not all operators understands this flag at this time, but that is changing.
				873	</p>
				874
				875	<p>To print a complete list of channel types, use <a href="command-line-options.html#list">-list
				876	channel</a>.</p>
				877
				878	<p>By default, ImageMagick sets <a href="command-line-options.html#channel">-channel</a> to the value
				879	'<code>RGBK,sync</code>', which specifies that operators act on all color
				880	channels except the transparency channel, and that all the color channels are
				881	to be modified in exactly the same way, with an understanding of transparency
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	882	(depending on the operation being applied). The 'plus' form <a
				883	href="command-line-options.html#channel" >+channel</a> will reset the value back to this default. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	884
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	885	<p>Options that are affected by the <a href="command-line-options.html#channel" >-channel</a> setting
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	886	include the following.
				887
				888	<a href="command-line-options.html#auto-gamma">-auto-gamma</a>,
				889	<a href="command-line-options.html#auto-level">-auto-level</a>,
				890	<a href="command-line-options.html#black-threshold">-black-threshold</a>,
				891	<a href="command-line-options.html#blur">-blur</a>,
				892	<a href="command-line-options.html#clamp">-clamp</a>,
				893	<a href="command-line-options.html#clut">-clut</a>,
				894	<a href="command-line-options.html#combine">-combine</a>,
				895	<a href="command-line-options.html#composite">-composite</a> (Mathematical compose methods only),
				896	<a href="command-line-options.html#convolve">-convolve</a>,
				897	<a href="command-line-options.html#contrast-stretch">-contrast-stretch</a>,
				898	<a href="command-line-options.html#evaluate">-evaluate</a>,
				899	<a href="command-line-options.html#function">-function</a>,
				900	<a href="command-line-options.html#fx">-fx</a>,
				901	<a href="command-line-options.html#gaussian-blur">-gaussian-blur</a>,
				902	<a href="command-line-options.html#hald-clut">-hald-clut</a>,
				903	<a href="command-line-options.html#motion-blur">-motion-blur</a>,
				904	<a href="command-line-options.html#morphology">-morphology</a>,
				905	<a href="command-line-options.html#negate">-negate</a>,
				906	<a href="command-line-options.html#normalize">-normalize</a>,
				907	<a href="command-line-options.html#ordered-dither">-ordered-dither</a>,
				908	<a href="command-line-options.html#radial-blur">-radial-blur</a>,
				909	<a href="command-line-options.html#random-threshold">-random-threshold</a>,
				910	<a href="command-line-options.html#separate">-separate</a>,
				911	<a href="command-line-options.html#threshold">-threshold</a>, and
				912	<a href="command-line-options.html#white-threshold">-white-threshold</a>.
				913	</p>
				914
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	915	<p>Warning, some operators behave differently when the <a href="command-line-options.html#channel"
				916	>+channel</a> default setting is in effect, verses ANY user defined <a
				917	href="command-line-options.html#channel" >-channel</a> setting (including the equivalent of the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	918	default). These operators have yet to be made to understand the newer 'Sync'
				919	flag. </p>
				920
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	921	<p>For example <a href="command-line-options.html#threshold">-threshold</a> will by default grayscale
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	922	the image before thresholding, if no <a href="command-line-options.html#channel" >-channel</a> setting
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	923	has been defined. This is not 'Sync flag controlled, yet. </p>
				924
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	925	<p>Also some operators such as <a href="command-line-options.html#blur">-blur</a>, <a
				926	href="command-line-options.html#gaussian-blur">-gaussian-blur</a>, will modify their handling of the
				927	color channels if the '<code>alpha</code>' channel is also enabled by <a
				928	href="command-line-options.html#channel" >-channel</a>. Generally this done to ensure that
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	929	fully-transparent colors are treated as being fully-transparent, and thus any
				930	underlying 'hidden' color has no effect on the final results. Typically
				931	resulting in 'halo' effects. The newer <a href="command-line-options.html#morphology">-morphology</a>
				932	convolution equivalents however does have a understanding of the 'Sync' flag
				933	and will thus handle transparency correctly by default. </p>
				934
				935	<p>As a alpha channel is optional within images, some operators will read the
				936	color channels of an image as a greyscale alpha mask, when the image has no
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	937	alpha channel present, and the <a href="command-line-options.html#channel" >-channel</a> setting tells
				938	the operator to apply the operation using alpha channels. The <a
				939	href="command-line-options.html#clut">-clut</a> operator is a good example of this. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	940
				941
				942
				943	<div style="margin: auto;">
				944	<h3 class="magick-header"><a id="charcoal"></a>-charcoal <var>factor</var></h3>
				945	</div>
				946
				947	<p class="magick-description">Simulate a charcoal drawing.</p>
				948
				949	<div style="margin: auto;">
				950	<h3 class="magick-header"><a id="chop"></a>-chop <var>geometry</var></h3>
				951	</div>
				952
				953	<p class="magick-description">Remove pixels from the interior of an image.</p>
				954
				955	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. The <var>width</var>
				956	and <var>height</var> given in the of the <var>size</var>
				957	portion of the <var>geometry</var> argument give the number of
				958	columns and rows to remove. The <var>offset</var> portion of
				959	the <var>geometry</var> argument is influenced by
				960	a <a href="command-line-options.html#gravity">-gravity</a> setting, if present.</p>
				961
				962	<p>The <a href="command-line-options.html#chop">-chop</a> option removes entire rows and columns,
				963	and moves the remaining corner blocks leftward and upward to close the gaps.</p>
				964
				965	<p>While it can remove internal rows and columns of pixels, it is more
				966	typically used with as <a href="command-line-options.html#gravity">-gravity</a> setting and zero
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	967	offsets so as to remove a single edge from an image. Compare this to <a
				968	href="command-line-options.html#shave" >-shave</a> which removes equal numbers of pixels from opposite
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	969	sides of the image. </p>
				970
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	971	<p>Using <a href="command-line-options.html#chop">-chop</a> effectively undoes the results of a <a
				972	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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	973
				974	<div style="margin: auto;">
				975	<h3 class="magick-header"><a id="clamp"></a>-clamp</h3>
				976	</div>
				977
				978	<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>
				979
				980	<div style="margin: auto;">
				981	<h3 class="magick-header"><a id="clip"></a>-clip</h3>
				982	</div>
				983
				984	<p class="magick-description">Apply the clipping path if one is present.</p>
				985
				986	<p>If a clipping path is present, it is applied to subsequent operations.</p>
				987
				988	<p>For example, in the command</p>
				989
				990	<pre>
				991	convert cockatoo.tif -clip -negate negated.tif
				992	</pre>
				993
				994	<p>only the pixels within the clipping path are negated.</p>
				995
				996	<p>The <a href="command-line-options.html#clip">-clip</a> feature requires SVG support. If the SVG
				997	delegate library is not present, the option is ignored.</p>
				998
				999	<p>Use <a href="command-line-options.html#clip">+clip</a> to disable clipping for subsequent operations.</p>
				1000
				1001	<div style="margin: auto;">
				1002	<h3 class="magick-header"><a id="clip-mask"></a>-clip-mask</h3>
				1003	</div>
				1004
				1005	<p class="magick-description">Clip the image as defined by this mask.</p>
				1006
				1007	<p>Use the alpha channel of the current image as a mask. Any areas that is
				1008	white is not modified by any of the 'image processing operators' that follow,
				1009	until the mask is removed. Pixels in the black areas of the clip mask are
				1010	modified per the requirements of the operator. </p>
				1011
				1012	<p>In some ways this is similar to (though not the same) as defining
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1013	a rectangular <a href="command-line-options.html#region" >-region</a>, or using the negative of the
				1014	mask (third) image in a three image <a href="command-line-options.html#composite" >-composite</a>,
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1015	operation. </p>
				1016
				1017	<p>Use <a href="command-line-options.html#clip-mask">+clip-mask</a> to disable clipping for subsequent operations.</p>
				1018
				1019	<div style="margin: auto;">
				1020	<h3 class="magick-header"><a id="clip-path"></a>-clip-path <var>id</var></h3>
				1021	</div>
				1022
				1023	<p class="magick-description">Clip along a named path from the 8BIM profile.</p>
				1024
				1025	<p>This is identical to <a href="command-line-options.html#clip">-clip</a> except choose a specific clip path in the event the image has more than one path available. </p>
				1026
				1027	<p>Use <a href="command-line-options.html#clip-path">+clip-path</a> to disable clipping for subsequent operations.</p>
				1028
				1029	<div style="margin: auto;">
				1030	<h3 class="magick-header"><a id="clone"></a>-clone <var>index(s)</var></h3>
				1031	</div>
				1032
				1033	<p class="magick-description">make a clone of an image (or images).</p>
				1034
				1035	<p>Inside parenthesis (where the operator is normally used) it will make a
				1036	clone of the images from the last 'pushed' image sequence, and adds them to
				1037	the end of the current image sequence. Outside parenthesis
				1038	(not recommended) it clones the images from the current image sequence. </p>
				1039
				1040	<p>Specify the image by its index in the sequence. The first image is index
				1041	0. Negative indexes are relative to the end of the sequence; for
				1042	example, <code>−1</code>
				1043	represents the last image of the sequence. Specify a range of images with a
				1044	dash (e.g. <code>0−4</code>). Separate multiple indexes with commas but no
				1045	spaces (e.g. <code>0,2,5</code>). A value of '<code>0−−1</code> will
				1046	effectively clone all the images. </p>
				1047
				1048	<p>The <a href="command-line-options.html#clone">+clone</a> will simply make a copy of the last image
				1049	in the image sequence, and is thus equivalent to using a argument of
				1050	'<code>−1</code>'. </p>
				1051
				1052	<div style="margin: auto;">
				1053	<h3 class="magick-header"><a id="clut"></a>-clut</h3>
				1054	</div>
				1055
				1056	<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>
				1057
				1058	<p>The second (LUT) image is ordinarily a gradient image containing the
				1059	histogram mapping of how each channel should be modified. Typically it is a
				1060	either a single row or column image of replacement color values. If larger
				1061	than a single row or column, values are taken from a diagonal line from
				1062	top-left to bottom-right corners.</p>
				1063
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1064	<p>The lookup is further controlled by the <a
				1065	href="command-line-options.html#interpolate">-interpolate</a> setting, which is especially handy for an
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1066	LUT which is not the full length needed by the ImageMagick installed Quality
				1067	(Q) level. Good settings for this are the '<code>bilinear</code>' and
				1068	'<code>bicubic</code>' interpolation settings, which give smooth color
				1069	gradients, and the '<code>integer</code>' setting for a direct, unsmoothed
				1070	lookup of color values. </p>
				1071
				1072	<p>This operator is especially suited to replacing a grayscale image with a
				1073	specific color gradient from the CLUT image. </p>
				1074
				1075	<p>Only the channel values defined by the <a href="command-line-options.html#channel">-channel</a>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1076	setting will have their values replaced. In particular, since the default <a
				1077	href="command-line-options.html#channel">-channel</a> setting is <code>RGB</code>, this means that
				1078	transparency (alpha/matte channel) is not affected, unless the <a
				1079	href="command-line-options.html#channel">-channel</a> setting is modified. When the alpha channel is
				1080	set, it is treated by the <a href="command-line-options.html#clut" >-clut</a> operator in the same way
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1081	as the other channels, implying that alpha/matte values are replaced using the
				1082	alpha/matte values of the original image. </p>
				1083
				1084	<p>If either the image being modified, or the lookup image, contains no
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1085	transparency (i.e. <a href="command-line-options.html#alpha" >-alpha</a> is turned 'off') but the <a
				1086	href="command-line-options.html#channel">-channel</a> setting includes alpha replacement, then it is
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	1087	assumed that image represents a grayscale gradient which is used for the
				1088	replacement alpha values. That is you can use a grayscale CLUT image to
				1089	adjust a existing images alpha channel, or you can color a grayscale image
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1090	using colors form CLUT containing the desired colors, including transparency.
				1091	</p>
				1092
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1093	<p>See also <a href="command-line-options.html#hald-clut" >-hald-clut</a> which replaces colors
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1094	according to the lookup of the full color RGB value from a 2D representation
				1095	of a 3D color cube. </p>
				1096
				1097
				1098	<div style="margin: auto;">
				1099	<h3 class="magick-header"><a id="coalesce"></a>-coalesce</h3>
				1100	</div>
				1101
				1102	<p class="magick-description">Fully define the look of each frame of an GIF animation sequence, to form a 'film strip' animation.</p>
				1103
				1104	<p>Overlay each image in an image sequence according to
				1105	its <a href="command-line-options.html#dispose">-dispose</a> meta-data, to reproduce the look of
				1106	an animation at each point in the animation sequence. All images should be
				1107	the same size, and are assigned appropriate GIF disposal settings for the
				1108	animation to continue working as expected as a GIF animation. Such frames
				1109	are more easily viewed and processed than the highly optimized GIF overlay
				1110	images. </p>
				1111
				1112	<p>The animation can be re-optimized after processing using
				1113	the <a href="command-line-options.html#layers">-layers</a> method '<code>optimize</code>', although
				1114	there is no guarantee that the restored GIF animation optimization is
				1115	better than the original. </p>
				1116
				1117
				1118	<div style="margin: auto;">
				1119	<h3 class="magick-header"><a id="colorize"></a>-colorize <var>value</var></h3>
				1120	</div>
				1121
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1122	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1123
				1124	<p>Specify the amount of colorization as a percentage. Separate colorization
				1125	values can be applied to the red, green, and blue channels of the image with
				1126	a comma-delimited list of colorization
				1127	values (e.g., <code>-colorize 0,0,50</code>).</p>
				1128
				1129	<div style="margin: auto;">
				1130	<h3 class="magick-header"><a id="colormap"></a>-colormap <var>type</var></h3>
				1131	</div>
				1132
				1133	<p class="magick-description">Define the colormap type.</p>
				1134
				1135	<p>The <var>type</var> can be <code>shared</code> or <code>private</code>.</p>
				1136
				1137	<p>This option only applies when the default X server visual
				1138	is <code>PseudoColor</code> or <code>GrayScale</code>. Refer
				1139	to <a href="command-line-options.html#visual">-visual</a> for more details. By default,
				1140	a shared colormap is allocated. The image shares colors with
				1141	other X clients. Some image colors could be approximated,
				1142	therefore your image may look very different than intended.
				1143	If <code>private</code> is chosen, the image colors appear exactly
				1144	as they are defined. However, other clients may go <var>technicolor</var>
				1145	when the image colormap is installed.</p>
				1146
				1147	<div style="margin: auto;">
				1148	<h3 class="magick-header"><a id="colors"></a>-colors <var>value</var></h3>
				1149	</div>
				1150
				1151	<p class="magick-description">Set the preferred number of colors in the image.</p>
				1152
				1153	<p>The actual number of colors in the image may be less than your request,
				1154	but never more. Note that this a color reduction option. Images with fewer
				1155	unique colors than specified by <var>value</var> will have any
				1156	duplicate or unused colors removed. The ordering of an existing color
				1157	palette may be altered. When converting an image from color to grayscale,
				1158	it is more efficient to convert the image to the gray colorspace before
				1159	reducing the number of colors. Refer to
Cristy	6549abb	2016-11-10 08:25:55 -0500	[diff] [blame]	1160	the <a href="http://www.imagemagick.org/www/quantize.html">
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1161	color reduction algorithm</a> for more details.</p>
				1162
				1163	<div style="margin: auto;">
				1164	<h3 class="magick-header"><a id="color-matrix"></a>-color-matrix <var>matrix</var></h3>
				1165	</div>
				1166
				1167	<p class="magick-description">apply color correction to the image.</p>
				1168
				1169	<p>This option permits saturation changes, hue rotation, luminance to alpha,
				1170	and various other effects. Although variable-sized transformation matrices
				1171	can be used, typically one uses a 5x5 matrix for an RGBA image and a 6x6
				1172	for CMYKA (or RGBA with offsets). The matrix is similar to those used by
				1173	Adobe Flash except offsets are in column 6 rather than 5 (in support of
				1174	CMYKA images) and offsets are normalized (divide Flash offset by 255).</p>
				1175
				1176	<p>As an example, to add contrast to an image with offsets, try this command:</p>
				1177
				1178	<pre>
				1179	convert kittens.jpg -color-matrix \
				1180	" 1.5 0.0 0.0 0.0, 0.0, -0.157 \
				1181	0.0 1.5 0.0 0.0, 0.0, -0.157 \
				1182	0.0 0.0 1.5 0.0, 0.0, -0.157 \
				1183	0.0 0.0 0.0 1.0, 0.0, 0.0 \
				1184	0.0 0.0 0.0 0.0, 1.0, 0.0 \
				1185	0.0 0.0 0.0 0.0, 0.0, 1.0" kittens.png
				1186	</pre>
				1187	<div style="margin: auto;">
				1188	<h3 class="magick-header"><a id="colorspace"></a>-colorspace <var>value</var></h3>
				1189	</div>
				1190
				1191	<p class="magick-description">Set the image colorspace.</p>
				1192
				1193	<p>Choices are:</p>
				1194
				1195	<pre>
				1196	CMY CMYK Gray HCL
				1197	HCLp HSB HSI HSL
				1198	HSV HWB Lab LCHab
				1199	LCHuv LMS Log Luv
				1200	OHTA Rec601YCbCr Rec709YCbCr RGB
				1201	scRGB sRGB Transparent xyY
				1202	XYZ YCbCr YCC YDbDr
				1203	YIQ YPbPr YUV
				1204	</pre>
				1205
				1206	<p>To print a complete list of colorspaces, use <a href="command-line-options.html#list">-list colorspace</a>.</p>
				1207
				1208	<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>
				1209
				1210	<table class="table table-condensed table-striped">
				1211	<caption>Conversion of RGB to Other Color Spaces</caption>
				1212	<tr><th valign="middle">CMY</th></tr>
				1213	<tr><td valign="middle">C=<var>QuantumRange</var>−R</td></tr>
				1214	<tr><td valign="middle">M=<var>QuantumRange</var>−G</td></tr>
				1215	<tr><td valign="middle">Y=<var>QuantumRange</var>−B</td></tr>
				1216	<tr><th valign="middle">CMYK — starts with CMY from above</th></tr>
				1217	<tr><td valign="middle">K=min(C,Y,M)</td></tr>
				1218	<tr><td valign="middle">C=<var>QuantumRange</var>*(C−K)/(<var>QuantumRange</var>−K)</td></tr>
				1219	<tr><td valign="middle">M=<var>QuantumRange</var>*(M−K)/(<var>QuantumRange</var>−K)</td></tr>
				1220	<tr><td valign="middle">Y=<var>QuantumRange</var>*(Y−K)/(<var>QuantumRange</var>−K)</td></tr>
				1221
				1222	<tr><th valign="middle">Gray</th></tr>
				1223	<tr><td valign="middle">Gray = 0.298839R+0.586811G+0.114350*B</td></tr>
				1224
				1225	<tr><th valign="middle">HSB — Hue, Saturation, Brightness; like a cone peak downward</th></tr>
				1226	<tr><td valign="middle">H=angle around perimeter (0 to 360 deg); H=0 is red; increasing angles toward green</td></tr>
				1227	<tr><td valign="middle">S=distance from axis outward</td></tr>
				1228	<tr><td valign="middle">B=distance along axis from bottom upward; B=max(R,G,B); <var>intensity-like</var></td></tr>
				1229
				1230	<tr><th valign="middle">HSL — Hue, Saturation, Lightness; like a double cone end-to-end with peaks at very top and bottom</th></tr>
				1231	<tr><td valign="middle">H=angle around perimeter (0 to 360 deg); H=0 is red; increasing angles toward green</td></tr>
				1232	<tr><td valign="middle">S=distance from axis outward</td></tr>
				1233	<tr><td valign="middle">L=distance along axis from bottom upward; L=0.5max(R,G,B) + 0.5min(R,G,B); <var>intensity-like</var></td></tr>
				1234
				1235	<tr><th valign="middle">HWB — Hue, Whiteness, Blackness</th></tr>
				1236	<tr><td valign="middle">Hue (complicated equation)</td></tr>
				1237	<tr><td valign="middle">Whiteness (complicated equation)</td></tr>
				1238	<tr><td valign="middle">Blackness (complicated equation)</td></tr>
				1239
				1240	<tr><th valign="middle">LAB</th></tr>
				1241	<tr><td valign="middle">L (complicated equation relating X,Y,Z)</td></tr>
				1242	<tr><td valign="middle">A (complicated equation relating X,Y,Z)</td></tr>
				1243	<tr><td valign="middle">B (complicated equation relating X,Y,Z)</td></tr>
				1244
				1245	<tr><th valign="middle">LOG</th></tr>
				1246	<tr><td valign="middle">I1 (complicated equation involving logarithm of R)</td></tr>
				1247	<tr><td valign="middle">I2 (complicated equation involving logarithm of G)</td></tr>
				1248	<tr><td valign="middle">I3 (complicated equation involving logarithm of B)</td></tr>
				1249
				1250	<tr><th valign="middle">OHTA — approximates principal components transformation</th></tr>
				1251	<tr><td valign="middle">I1=0.33333R+0.33334G+0.33333*B; <var>intensity-like</var></td></tr>
				1252	<tr><td valign="middle">I2=(0.50000R+0.00000G−0.50000B)(<var>QuantumRange</var>+1)/2</td></tr>
				1253	<tr><td valign="middle">I3=(−0.25000R+0.50000G−0.25000B)(<var>QuantumRange</var>+1)/2</td></tr>
				1254
				1255	<tr><th valign="middle">Rec601Luma</th></tr>
				1256	<tr><td valign="middle">Gray = 0.298839R+0.586811G+0.114350*B</td></tr>
				1257
				1258	<tr><th valign="middle">Rec601YCbCr</th></tr>
				1259	<tr><td valign="middle">Y=0.2988390R+0.5868110G+0.1143500*B; <var>intensity-like</var></td></tr>
				1260	<tr><td valign="middle">Cb=(−0.168736R-0.331264G+0.500000B)(<var>QuantumRange</var>+1)/2</td></tr>
				1261	<tr><td valign="middle">Cr=(0.500000R−0.418688G−0.081312B)(<var>QuantumRange</var>+1)/2</td></tr>
				1262
				1263	<tr><th valign="middle">Rec709Luma</th></tr>
				1264	<tr><td valign="middle">Gray=0.212656R+0.715158G+0.072186*B</td></tr>
				1265
				1266	<tr><th valign="middle">Rec709YCbCr</th></tr>
				1267	<tr><td valign="middle">Y=0.212656R+0.715158G+0.072186*B; <var>intensity-like</var></td></tr>
				1268	<tr><td valign="middle">Cb=(−0.114572R−0.385428G+0.500000*B)+(<var>QuantumRange</var>+1)/2</td></tr>
				1269	<tr><td valign="middle">Cr=(0.500000R−0.454153G−0.045847*B)+(<var>QuantumRange</var>+1)/2</td></tr>
				1270
				1271	<tr><th valign="middle">sRGB</th></tr>
				1272	<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>
				1273	<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>
				1274	<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>
				1275
				1276	<tr><th valign="middle">XYZ</th></tr>
				1277	<tr><td valign="middle">X=0.4124564R+0.3575761G+0.1804375*B</td></tr>
				1278	<tr><td valign="middle">Y=0.2126729R+0.7151522G+0.0721750*B</td></tr>
				1279	<tr><td valign="middle">Z=0.0193339R+0.1191920G+0.9503041*B</td></tr>
				1280
				1281	<tr><th valign="middle">YCC</th></tr>
				1282	<tr><td valign="middle">Y=(0.298839R+0.586811G+0.114350*B) (with complicated scaling); <var>intensity-like</var></td></tr>
				1283	<tr><td valign="middle">C1=(−0.298839R−0.586811G+0.88600*B) (with complicated scaling)</td></tr>
				1284	<tr><td valign="middle">C2=(0.70100R−0.586811G−0.114350*B) (with complicated scaling)</td></tr>
				1285
				1286	<tr><th valign="middle">YCbCr</th></tr>
				1287	<tr><td valign="middle">Y=0.2988390R+0.5868110G+0.1143500*B; <var>intensity-like</var></td></tr>
				1288	<tr><td valign="middle">Cb=(−0.168736R−0.331264G+0.500000B)(<var>QuantumRange</var>+1)/2</td></tr>
				1289	<tr><td valign="middle">Cr=(0.500000R−0.418688G−0.081312B)(<var>QuantumRange</var>+1)/2</td></tr>
				1290
				1291	<tr><th valign="middle">YIQ</th></tr>
				1292	<tr><td valign="middle">Y=0.298839R+0.586811G+0.114350*B; <var>intensity-like</var></td></tr>
				1293	<tr><td valign="middle">I=(0.59600R−0.27400G−0.32200B)(<var>QuantumRange</var>+1)/2</td></tr>
				1294	<tr><td valign="middle">Q=(0.21100R−0.52300G+0.31200B)(<var>QuantumRange</var>+1)/2</td></tr>
				1295
				1296	<tr><th valign="middle">YPbPr</th></tr>
				1297	<tr><td valign="middle">Y=0.2988390R+0.5868110G+0.1143500*B; <var>intensity-like</var></td></tr>
				1298	<tr><td valign="middle">Pb=(−0.168736R−0.331264G+0.500000B)(<var>QuantumRange</var>+1)/2</td></tr>
				1299	<tr><td valign="middle">Pr=(0.500000R−0.418688G−0.081312B)(<var>QuantumRange</var>+1)/2</td></tr>
				1300
				1301	<tr><th valign="middle">YUV</th></tr>
				1302	<tr><td valign="middle">Y=0.298839R+0.586811G+0.114350*B; <var>intensity-like</var></td></tr>
				1303	<tr><td valign="middle">U=(−0.14740R−0.28950G+0.43690B)(<var>QuantumRange</var>+1)/2</td></tr>
				1304	<tr><td valign="middle">V=(0.61500R−0.51500G−0.10000B)(<var>QuantumRange</var>+1)/2</td></tr>
				1305	</table>
				1306
				1307	<p>Note the scRGB colorspace requires HDRI support otherwise it behaves just like linear RGB.</p>
				1308
				1309	<div style="margin: auto;">
				1310	<h3 class="magick-header"><a id="combine"></a>-combine</h3>
				1311	</div>
				1312
				1313	<p class="magick-description">Combine one or more images into a single image.</p>
				1314
				1315	<p>The channels (previously set by <a href="command-line-options.html#channel">-channel</a>) of the
				1316	combined image are taken from the grayscale values of each image in the
				1317	sequence, in order. For the default -channel setting of <code>RGB</code>, this
				1318	means the first image is assigned to the <code>Red</code> channel, the second
				1319	to the <code>Green</code> channel, the third to the <code>Blue</code>.</p>
				1320
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1321	<p>This option can be thought of as the inverse to <a
				1322	href="command-line-options.html#separate">-separate</a>, so long as the channel settings are the same.
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1323	Thus, in the following example, the final image should be a copy of the
				1324	original. </p>
				1325
				1326	<pre>
				1327	convert original.png -channel RGB -separate sepimage.png
				1328	convert sepimage-0.png sepimage-1.png sepimage-2.png -channel RGB \
				1329	-combine imagecopy.png
				1330	</pre>
				1331
				1332	<div style="margin: auto;">
				1333	<h3 class="magick-header"><a id="comment"></a>-comment <var>string</var></h3>
				1334	</div>
				1335
				1336	<p class="magick-description">Embed a comment in an image.</p>
				1337
				1338	<p>This option sets the comment meta-data of an image read in after this
				1339	option has been given. To modify a comment of images already in memory use
				1340	"<code><a href="command-line-options.html#set">-set</a> comment</code>". </p>
				1341
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1342	<p>The comment can contain special format characters listed in the <a
				1343	href="escape.html">Format and
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1344	Print Image Properties</a>. These attributes are expanded when the comment
				1345	is finally assigned to the individual images. </p>
				1346
				1347	<p>If the first character of <var>string</var> is <var>@</var>, the image comment is read from a file titled by the
				1348	remaining characters in the string. Comments read in from a file are literal;
				1349	no embedded formatting characters are recognized.</p>
				1350
				1351	<p>Comment meta-data are not visible on the image itself. To do that use the
				1352	<a href="command-line-options.html#annotate">-annotate</a> or <a href="command-line-options.html#draw">-draw</a> options
				1353	instead.</p>
				1354
				1355	<p>For example,</p>
				1356
				1357	<pre>
				1358	-comment "%m:%f %wx%h" bird.miff
				1359	</pre>
				1360
				1361	<p>produces an image comment of <code>MIFF:bird.miff 512x480</code> (assuming
				1362	that the image <code>bird.miff</code> has a width of 512 and a height of
				1363	480.</p>
				1364
				1365	<div style="margin: auto;">
				1366	<h3 class="magick-header"><a id="compare"></a>-compare</h3>
				1367	</div>
				1368
				1369	<p class="magick-description">mathematically and visually annotate the difference between an image and its reconstruction</p>
				1370
				1371	<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>
				1372
				1373	<pre>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1374	convert image.png reference.png -metric RMSE -compare \ <br/> difference.png
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1375	</pre>
				1376
				1377	<p>To get the metric value use the string format "%[distortion]".</p>
				1378
				1379	<pre>
				1380	convert image.png reference.png -metric RMSE -compare -format \
				1381	"%[distortion]" info:
				1382	</pre>
				1383
				1384	<div style="margin: auto;">
				1385	<h3 class="magick-header"><a id="complex"></a>-complex <var>operator</var></h3>
				1386	</div>
				1387
				1388	<p class="magick-description">perform complex mathematics on an image sequence</p>
				1389
				1390	Choose from these operators:
				1391
				1392	<pre>
				1393	add
				1394	conjugate
				1395	divide
				1396	magnitude-phase
				1397	multiply
				1398	real-imaginary
				1399	subtract
				1400	</pre>
				1401
				1402	<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>
				1403
				1404	<div style="margin: auto;">
				1405	<h3 class="magick-header"><a id="compose"></a>-compose <var>operator</var></h3>
				1406	</div>
				1407
				1408	<p class="magick-description">Set the type of image composition.</p>
				1409
Cristy	6549abb	2016-11-10 08:25:55 -0500	[diff] [blame]	1410	<p>See <a href="http://www.imagemagick.org/www/compose.html">Alpha Compositing</a> for
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1411	a detailed discussion of alpha compositing.</p>
				1412
				1413	<p>This setting effects image processing operators that merge two (or more)
				1414	images together in some way. This includes the operators,
				1415	<a href="command-line-options.html#composite">-compare</a>,
				1416	<a href="command-line-options.html#composite">-composite</a>,
				1417	<a href="command-line-options.html#layers">-layers</a> composite,
				1418	<a href="command-line-options.html#flatten">-flatten</a>,
				1419	<a href="command-line-options.html#mosaic">-mosaic</a>,
				1420	<a href="command-line-options.html#layers">-layers</a> merge,
				1421	<a href="command-line-options.html#border">-border</a>,
				1422	<a href="command-line-options.html#frame">-frame</a>,
				1423	and <a href="command-line-options.html#extent">-extent</a>. </p>
				1424
				1425	<p>It is also one of the primary options for the "<code>composite</code>"
				1426	command. </p>
				1427
				1428
				1429	<div style="margin: auto;">
				1430	<h3 class="magick-header"><a id="composite"></a>-composite</h3>
				1431	</div>
				1432
				1433	<p class="magick-description">Perform alpha composition on two images and an optional mask</p>
				1434
				1435	<p>Take the first image 'destination' and overlay the second 'source' image
				1436	according to the current <a href="command-line-options.html#compose">-compose</a> setting. The location
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1437	of the 'source' or 'overlay' image is controlled according to <a
Cristy	e93be68	2015-11-26 09:07:51 -0500	[diff] [blame]	1438	href="command-line-options.html#gravity" >-gravity</a>, and <a href="command-line-options.html#geometry" >-geometry</a>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1439	settings. </p>
				1440
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	1441	<p>If a third image is given this is treated as a grayscale blending 'mask' image
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1442	relative to the first 'destination' image. This mask is blended with the
				1443	source image. However for the '<code>displace</code>' compose method, the
				1444	mask is used to provide a separate Y-displacement image instead. </p>
				1445
				1446	<p>If a <a href="command-line-options.html#compose">-compose</a> method requires extra numerical
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1447	arguments or flags these can be provided by setting the <a
				1448	href="command-line-options.html#set">-set</a> '<code>option:compose:args</code>'
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1449	appropriately for the compose method. </p>
				1450
				1451	<p>Some <a href="command-line-options.html#compose">-compose</a> methods can modify the 'destination'
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1452	image outside the overlay area. You can disable this by setting the special <a
				1453	href="command-line-options.html#set">-set</a> '<code>option:compose:outside-overlay</code>'
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1454	to '<code>false</code>'. </p>
				1455
				1456	<p>The SVG compositing specification requires that color and opacity values range between zero and QuantumRange inclusive. You can permit values outside this range with this option: <a href="command-line-options.html#set">-set</a> '<code>option:compose:clamp=false</code></p>
				1457
				1458
				1459	<div style="margin: auto;">
				1460	<h3 class="magick-header"><a id="compress"></a>-compress <var>type</var></h3>
				1461	</div>
				1462
				1463	<p class="magick-description">Use pixel compression specified by <var>type</var> when writing the image.</p>
				1464
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1465	<p>Choices are: <code>None</code>, <code>BZip</code>, <code
				1466	>Fax</code>, <code>Group4</code>, <code
				1467	>JPEG</code>, <code>JPEG2000</code>, <code
				1468	>Lossless</code>, <code>LZW</code>, <code
				1469	>RLE</code> or <code>Zip</code>.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1470
				1471	<p>To print a complete list of compression types, use <a href="command-line-options.html#list">-list
				1472	compress</a>.</p>
				1473
				1474	<p>Specify <a href="command-line-options.html#compress">+compress</a> to store the binary image in an
				1475	uncompressed format. The default is the compression type of the specified
				1476	image file.</p>
				1477
				1478	<p>If <code>LZW</code> compression is specified but LZW compression has not been
				1479	enabled, the image data is written in an uncompressed LZW format that can be
				1480	read by LZW decoders. This may result in larger-than-expected GIF files.</p>
				1481
				1482	<p><code>Lossless</code> refers to lossless JPEG, which is only available if the
				1483	JPEG library has been patched to support it. Use of lossless JPEG is generally
				1484	not recommended.</p>
				1485
				1486	<p>
				1487	When writing an ICO file, you may request that the images be encoded in
				1488	PNG format, by specifying <code>Zip</code> compression.</p>
				1489
				1490	<p>
				1491	When writing a JNG file, specify <code>Zip</code> compression to request that
				1492	the alpha channel be encoded in PNG "IDAT" format, or <code>JPEG</code>
				1493	to request that it be encoded in JPG "JDAA" format.</p>
				1494
				1495	<p>Use the <a href="command-line-options.html#quality">-quality</a> option to set the compression level
				1496	to be used by JPEG, PNG, MIFF, and MPEG encoders.
				1497	Use the <a href="command-line-options.html#sampling-factor">-sampling-factor</a> option to set the
				1498	sampling factor to be used by JPEG, MPEG, and YUV encoders for down-sampling
				1499	the chroma channels.</p>
				1500
				1501	<div style="margin: auto;">
				1502	<h3 class="magick-header"><a id="connected-components"></a>-connected-components <var>connectivity</var></h3>
				1503	</div>
				1504
Cristy	ce4a355	2015-12-14 13:53:35 -0500	[diff] [blame]	1505	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1506
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1507	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1508
				1509	<div style="margin: auto;">
				1510	<h3 class="magick-header"><a id="contrast"></a>-contrast</h3>
				1511	</div>
				1512
				1513	<p class="magick-description">Enhance or reduce the image contrast.</p>
				1514
				1515	<p>This option enhances the intensity differences between the lighter and
				1516	darker elements of the image. Use <a href="command-line-options.html#contrast">-contrast</a> to enhance
				1517	the image or <a href="command-line-options.html#contrast">+contrast</a> to reduce the image
				1518	contrast.</p>
				1519
				1520	<p>For a more pronounced effect you can repeat the option:</p>
				1521
				1522	<pre>
				1523	convert rose: -contrast -contrast rose_c2.png
				1524	</pre>
				1525
				1526	<div style="margin: auto;">
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	1527	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1528	</div>
				1529
				1530	<p class="magick-description">Increase the contrast in an image by <var>stretching</var> the range of intensity values.</p>
				1531
				1532	<p>While performing the stretch, black-out at most <var>black-point</var> pixels and white-out at most <var>white-point</var> pixels. Or, if percent is used, black-out at most
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1533	<var >black-point %</var> pixels and white-out at most <var>white-point %</var> pixels.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1534
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1535	<p>Prior to ImageMagick 6.4.7-0, <a href="command-line-options.html#contrast-stretch"
				1536	>-contrast-stretch</a> will black-out at most <var>black-point</var> pixels and white-out at most <var >total pixels
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1537	minus white-point</var> pixels. Or, if percent is used, black-out at most <var>black-point %</var> pixels and white-out at most <var>100% minus white-point %</var> pixels.</p>
				1538
				1539	<p>Note that <code>-contrast-stretch 0</code> will modify the image such that
				1540	the image's min and max values are stretched to 0 and <var>QuantumRange</var>, respectively, without any loss of data due to burn-out or
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1541	clipping at either end. This is not the same as <a href="command-line-options.html#normalize"
				1542	>-normalize</a>, which is equivalent to <code>-contrast-stretch 0.15x0.05%</code> (or
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1543	prior to ImageMagick 6.4.7-0, <code>-contrast-stretch 2%x99%</code>).</p>
				1544
				1545	<p>Internally operator works by creating a histogram bin, and then uses that
				1546	bin to modify the image. As such some colors may be merged together when they
				1547	originally fell into the same 'bin'. </p>
				1548
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	1549	<p>All the channels are normalized in concert by the same amount so as to
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1550	preserve color integrity, when the default <a href="command-line-options.html#channel" >+channel</a>
				1551	setting is in use. Specifying any other <a href="command-line-options.html#channel" >-channel</a>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1552	setting will normalize the RGB channels independently.</p>
				1553
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1554	<p>See also <a href="command-line-options.html#auto-level" >-auto-level</a> for a 'perfect'
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1555	normalization of mathematical images. </p>
				1556
				1557	<p>This operator is under review for re-development. </p>
				1558
				1559
				1560	<div style="margin: auto;">
				1561	<h3 class="magick-header"><a id="convolve"></a>-convolve <var>kernel</var></h3>
				1562	</div>
				1563
				1564	<p class="magick-description">Convolve an image with a user-supplied convolution kernel.</p>
				1565
				1566	<p>The <var>kernel</var> is a matrix specified as
				1567	a comma-separated list of integers (with no spaces), ordered left-to right,
				1568	starting with the top row. Presently, only odd-dimensioned kernels are
				1569	supported, and therefore the number of entries in the specified <var>kernel</var> must be 3<sup>2</sup>=9, 5<sup>2</sup>=25,
				1570	7<sup>2</sup>=49, etc. </p>
				1571
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1572	<p>Note that the <a href="command-line-options.html#convolve">‑convolve</a> operator supports the <a href="command-line-options.html#bias">‑bias</a> setting. This option shifts the convolution so that
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1573	positive and negative results are relative to a user-specified bias value.
				1574	This is important for non-HDRI compilations of ImageMagick when dealing with
				1575	convolutions that contain negative as well as positive values. This is
				1576	especially the case with convolutions involving high pass filters or edge
				1577	detection. Without an output bias, the negative values is clipped at zero.
				1578	</p>
				1579
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1580	<p>When using an ImageMagick with the HDRI compile-time setting, <a href="command-line-options.html#bias">‑bias</a> is not needed, as ImageMagick is able to store/handle any
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1581	negative results without clipping to the color value range (0..QuantumRange).
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1582	See the discussion on HDRI implementations of ImageMagick on the page <a
				1583	href="high-dynamic-range.html">High
				1584	Dynamic-Range Images</a>. For more about HDRI go the ImageMagick <a
Cristy	364a72f	2016-11-04 22:38:41 -0400	[diff] [blame]	1585	href="https://www.imagemagick.org/Usage/basics/#hdri">Usage</a> pages or this
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1586	<a href="http://en.wikipedia.org/wiki/High_dynamic_range_imaging">Wikipedia</a>
				1587	entry. </p>
				1588
				1589
				1590	<div style="margin: auto;">
				1591	<h3 class="magick-header"><a id="copy"></a>-copy <var>geometry</var> <var>offset</var></h3>
				1592	</div>
				1593
				1594	<p class="magick-description">copy pixels from one area of an image to another.</p>
				1595
				1596	<div style="margin: auto;">
				1597	<h3 class="magick-header"><a id="crop"></a>-crop <var>geometry</var>{<var>@</var>}{<var>!</var>}</h3>
				1598	</div>
				1599
				1600	<p class="magick-description">Cut out one or more rectangular regions of the image.</p>
				1601
				1602	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
				1603
				1604	<p>The <var>width</var> and <var>height</var> of the <var>geometry</var> argument give the size of the image that remains
				1605	after cropping, and <var>x</var> and <var>y</var> in the
				1606	<var>offset</var> (if present) gives the location of the top left
				1607	corner of the cropped image with respect to the original image. To specify the
				1608	amount to be removed, use <a href="command-line-options.html#shave">-shave</a> instead.</p>
				1609
				1610	<p>If the <var>x</var> and <var>y</var> offsets are
				1611	present, a single image is generated, consisting of the pixels from the
				1612	cropping region. The offsets specify the location of the upper left corner of
				1613	the cropping region measured downward and rightward with respect to the upper
				1614	left corner of the image. If the <a href="command-line-options.html#gravity">-gravity</a> option is
				1615	present with <code>NorthEast</code>, <code>East</code>, or <code>SouthEast</code>
				1616	gravity, it gives the distance leftward from the right edge of the image to
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1617	the right edge of the cropping region. Similarly, if the <a
				1618	href="command-line-options.html#gravity">-gravity</a> option is present with <code>SouthWest</code>,
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1619	<code>South</code>, or <code>SouthEast</code> gravity, the distance is measured
				1620	upward between the bottom edges.</p>
				1621
				1622	<p>If the <var>x</var> and <var>y</var> offsets are
				1623	omitted, a set of tiles of the specified geometry, covering the entire input
				1624	image, is generated. The rightmost tiles and the bottom tiles are smaller if
				1625	the specified geometry extends beyond the dimensions of the input image.</p>
				1626
				1627	<p>You can add the <var>@</var> to the geometry argument to equally divide the image into the number of tiles generated.</p>
				1628
				1629	<p>By adding a exclamation character flag to the geometry argument, the
				1630	cropped images virtual canvas page size and offset is set as if the
				1631	geometry argument was a viewport or window. This means the canvas page size
				1632	is set to exactly the same size you specified, the image offset set
				1633	relative top left corner of the region cropped. </p>
				1634
				1635	<p>If the cropped image 'missed' the actual image on its virtual canvas, a
				1636	special single pixel transparent 'missed' image is returned, and a 'crop
				1637	missed' warning given. </p>
				1638
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1639	<p>It might be necessary to <a href="command-line-options.html#repage" >+repage</a> the image prior to
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1640	cropping the image to ensure the crop coordinate frame is relocated to the
				1641	upper-left corner of the visible image.
				1642
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1643	Similarly you may want to use <a href="command-line-options.html#repage" >+repage</a> after cropping to
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1644	remove the page offset that will be left behind. This is especially true when
				1645	you are going to write to an image format such as PNG that supports an image
				1646	offset.</p>
				1647
				1648	<div style="margin: auto;">
				1649	<h3 class="magick-header"><a id="cycle"></a>-cycle <var>amount</var></h3>
				1650	</div>
				1651
				1652	<p class="magick-description">displace image colormap by amount.</p>
				1653
				1654	<p><var>Amount</var> defines the number of positions each
				1655	colormap entry is shifted.</p>
				1656
				1657
				1658	<div style="margin: auto;">
				1659	<h3 class="magick-header"><a id="debug"></a>-debug <var>events</var></h3>
				1660	</div>
				1661
				1662	<p class="magick-description">enable debug printout.</p>
				1663
				1664	<p>The <code>events</code> parameter specifies which events are to be logged. It
				1665	can be either <code>None</code>, <code>All</code>, <code>Trace</code>, or
				1666	a comma-separated list consisting of one or more of the following domains:
				1667	<code>Accelerate</code>, <code>Annotate</code>, <code>Blob</code>, <code>Cache</code>,
				1668	<code>Coder</code>, <code>Configure</code>, <code>Deprecate</code>,
				1669	<code>Exception</code>, <code>Locale</code>, <code>Render</code>,
				1670	<code>Resource</code>, <code>Security</code>, <code>TemporaryFile</code>,
				1671	<code>Transform</code>, <code>X11</code>, or <code>User</code>. </p>
				1672
				1673
				1674	<p>For example, to log cache and blob events, use.</p>
				1675
				1676	<pre>
				1677	convert -debug "Cache,Blob" rose: rose.png
				1678	</pre>
				1679
				1680	<p>The <code>User</code> domain is normally empty, but developers can log user
				1681	events in their private copy of ImageMagick.</p>
				1682
				1683	<p>To print the complete list of debug methods, use <a href="command-line-options.html#list">-list
				1684	debug</a>.</p>
				1685
				1686	<p>Use the <a href="command-line-options.html#log">-log</a> option to specify the format for debugging
				1687	output.</p>
				1688
				1689	<p>Use <a href="command-line-options.html#debug">+debug</a> to turn off all logging.</p>
				1690
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1691	<p>Debugging may also be set using the <code>MAGICK_DEBUG</code> <a href="resources.html#environment"
				1692	>environment variable</a>. The allowed values for the <code>MAGICK_DEBUG</code>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1693	environment variable are the same as for the <a href="command-line-options.html#debug">-debug</a>
				1694	option.</p>
				1695
				1696
				1697	<div style="margin: auto;">
				1698	<h3 class="magick-header"><a id="decipher"></a>-decipher <var>filename</var></h3>
				1699	</div>
				1700
				1701	<p class="magick-description">Decipher and restore pixels that were previously transformed by <a href="command-line-options.html#encipher">-encipher</a>.</p>
				1702
				1703	<p>Get the passphrase from the file specified by <var>filename</var>.</p>
				1704
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1705	<p>For more information, see the webpage, <a
Cristy	6549abb	2016-11-10 08:25:55 -0500	[diff] [blame]	1706	href="https://www.imagemagick.org/script/cipher.html">ImageMagick: Encipher or
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1707	Decipher an Image</a>.</p>
				1708
				1709
				1710	<div style="margin: auto;">
				1711	<h3 class="magick-header"><a id="deconstruct"></a>-deconstruct</h3>
				1712	</div>
				1713
				1714	<p class="magick-description">find areas that has changed between images </p>
				1715
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1716	<p>Given a sequence of images all the same size, such as produced by <a
				1717	href="command-line-options.html#coalesce">-coalesce</a>, replace the second and later images, with
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1718	a smaller image of just the area that changed relative to the previous image.
				1719	</p>
				1720
				1721	<p>The resulting sequence of images can be used to optimize an animation
				1722	sequence, though will not work correctly for GIF animations when parts of the
				1723	animation can go from opaque to transparent. </p>
				1724
				1725	<p>This option is actually equivalent to the <a href="command-line-options.html#layers">-layers</a>
				1726	method '<code>compare-any</code>'. </p>
				1727
				1728
				1729	<div style="margin: auto;">
				1730	<h3 class="magick-header"><a id="define"></a>-define <var>key</var>{<var>=value</var>}<var>...</var></h3>
				1731	</div>
				1732
				1733	<p class="magick-description">add specific global settings generally used to control coders and image processing operations.</p>
				1734
				1735	<p>This option creates one or more definitions for coders and decoders to use
				1736	while reading and writing image data. Definitions are generally used to
				1737	control image file format coder modules, and image processing operations,
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1738	beyond what is provided by normal means. Defined settings are listed in <a
				1739	href="command-line-options.html#verbose" >-verbose</a> information ("<code>info:</code>" output format)
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1740	as "Artifacts". </p>
				1741
				1742	<p>If <var>value</var> is missing for a definition, an empty-valued
				1743	definition of a flag is created with that name. This used to control on/off
				1744	options. Use <a href="command-line-options.html#define">+define key</a> to remove definitions
				1745	previously created. Use <a href="command-line-options.html#define">+define "*"</a> to remove all
				1746	existing definitions.</p>
				1747
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1748	<p>The same 'artifact' settings can also be defined using the <a
				1749	href="command-line-options.html#set" >-set "option:<var>key</var>" "<var>value</var>"</a> option, which also allows the use of <a href="escape.html" >Format and Print Image
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1750	Properties</a> in the defined value. </p>
				1751
				1752	<p>The <var>option</var> and <var>key</var> are case-independent (they are
				1753	converted to lowercase for use within the decoders) while the <var>value</var>
				1754	is case-dependent.</p>
				1755
				1756	<p>Such settings are global in scope, and affect all images and operations. </p>
				1757
				1758	<p>The following definitions are just some of the artifacts that are
				1759	available:</p>
				1760
				1761	<table class="table table-condensed table-striped">
				1762	<tr>
Cristy	e077971	2016-07-30 17:25:22 -0400	[diff] [blame]	1763	<td>bmp:alpha=<var>true\|false</var></td>
				1764	<td>include any alpha channel when writing in the BMP image format.</td>
				1765	</tr>
				1766
				1767	<tr>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1768	<td>bmp:format=<var>value</var></td>
				1769	<td> valid values are <var>bmp2</var>, <var>bmp3</var>,
				1770	and <var>bmp4</var>. This option can be useful when the
				1771	method of prepending "BMP2:" to the output filename is inconvenient or
				1772	is not available, such as when using the <a href="mogrify.html">mogrify</a> utility.</td>
				1773	</tr>
				1774
				1775	<tr>
				1776	<td>colorspace:auto-grayscale=<var>on\|off</var></td>
				1777	<td>prevent automatic conversion to grayscale inside coders that support
				1778	grayscale. This should be accompanied by -type truecolor. PNG and TIF do
				1779	not need this define. With PNG, just use PNG24:image. With TIF, just use
				1780	-type truecolor. JPG and PSD will need this define.</td>
				1781	</tr>
				1782
				1783	<tr>
				1784	<td>complex:snr=<var>value</var></td>
				1785	<td>Set the divide SNR constant<a href="command-line-options.html#complex">-complex</a></td>
				1786	</tr>
				1787
				1788	<tr>
				1789	<td>compose:args=<var>arguments</var></td>
				1790	<td>Sets certain compose argument values when using convert ... -compose ...
Cristy	1f1f3a0	2016-06-01 07:25:42 -0400	[diff] [blame]	1791	-composite. See <a href="compose.html"
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1792	>Image Composition</a></td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1793	</tr>
				1794
				1795	<tr>
				1796	<td>compose:clamp=<var>on\|off</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	1797	<td>set each pixel whose value is below zero to zero and any the pixel
				1798	whose value is above the quantum range to the quantum range (e.g. 65535)
				1799	otherwise the pixel value remains unchanged. Define supported in
				1800	ImageMagick 6.9.1-3 and above.</td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1801	</tr>
				1802
				1803	<tr>
Cristy	de27d76	2016-01-02 12:56:44 -0500	[diff] [blame]	1804	<td>connected-components:area-threshold=<var>value</var></td>
				1805	<td>Merges any region with area smaller than <var>value</var> into its surrounding region or largest neighbor.</td>
				1806	</tr>
				1807
				1808	<tr>
				1809	<td>connected-components:keep=<var>list-of-ids</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	1810	<td>Comma and/or hyphenated list of id values to keep in the output.
				1811	Supported in Imagemagick 6.9.3-0.</td>
Cristy	de27d76	2016-01-02 12:56:44 -0500	[diff] [blame]	1812	</tr>
				1813
				1814	<tr>
				1815	<td>connected-components:mean-color=<var>true</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	1816	<td>Changes the output image from id values to mean color values. Supported
				1817	in Imagemagick 6.9.2-8.</td>
Cristy	de27d76	2016-01-02 12:56:44 -0500	[diff] [blame]	1818	</tr>
				1819
				1820	<tr>
				1821	<td>connected-components:remove=<var>list-of-ids</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	1822	<td>Comma and/or hyphenated list of id values to remove from the output.
				1823	Supported in Imagemagick 6.9.2-9.</td>
Cristy	de27d76	2016-01-02 12:56:44 -0500	[diff] [blame]	1824	</tr>
				1825
				1826	<tr>
				1827	<td>connected-components:verbose=<var>true</var></td>
				1828	<td>Lists id, bounding box, centroid, area, mean color for each region.</td>
				1829	</tr>
				1830
				1831	<tr>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1832	<td>convolve:scale=<var>{kernel_scale}[!^] [,{origin_addition}] [%]</var></td>
				1833	<td>Defines the kernel scaling. The special flag ! automatically scales to
				1834	full dynamic range. The ! flag can be used in combination with a factor or
				1835	percent. The factor or percent is then applied after the automatic scaling.
				1836	An example is 50%!. This produces a result 50% darker than full dynamic
				1837	range scaling. The ^ flag assures the kernel is 'zero-summing', for
				1838	example when some values are positive and some are negative as in edge
				1839	detection kernels. The origin addition adds that value to the center
				1840	pixel of the kernel. This produces and effect that is like adding the image
				1841	that many times to the result of the filtered image. The typical value
				1842	is 1 so that the original image is added to the result of the convolution.
				1843	The default is 0.</td>
				1844	</tr>
				1845
				1846	<tr>
				1847	<td>convolve:showkernel=<var>1</var></td>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1848	<td>Outputs (to 'standard error') all the information about a specified <a
				1849	href="command-line-options.html#morphology" >-morphology convolve</a> kernel.</td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1850	</tr>
				1851
				1852	<tr>
				1853	<td>dcm:display-range=<var>reset</var></td>
				1854	<td>Sets the display range to the minimum and maximum pixel values for the
				1855	DCM image format.</td>
				1856	</tr>
				1857
				1858	<tr>
				1859	<td>dds:cluster-fit=<var>true\|false</var></td>
				1860	<td>Enables the dds cluster-fit.</td>
				1861	</tr>
				1862
				1863	<tr>
				1864	<td>dds:compression=<var>dxt1\|dxt5\|none</var></td>
				1865	<td>Sets the dds compression.</td>
				1866	</tr>
				1867
				1868	<tr>
				1869	<td>dds:mipmaps=<var>value</var></td>
				1870	<td>Sets the dds number of mipmaps.</td>
				1871	</tr>
				1872
				1873	<tr>
Cristy	3b0b58d	2016-11-06 07:40:23 -0500	[diff] [blame]	1874	<td>dds:weight-by-alpha=<var>true\|false</var></td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1875	<td>Enables the dds alpha weighting.</td>
				1876	</tr>
				1877
				1878	<tr>
Cristy	3b0b58d	2016-11-06 07:40:23 -0500	[diff] [blame]	1879	<td>deskew:auto-crop=<var>true</var></td>
				1880	<td>auto crop the image after deskewing.</td>
				1881	</tr>
				1882
				1883	<tr>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1884	<td>delegate:bimodal=<var>true</var></td>
				1885	<td>Specifies direct conversion from Postscript to PDF.</td>
				1886	</tr>
				1887
				1888	<tr>
				1889	<td>distort:scale=<var>value</var></td>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	1890	<td>Sets the output scaling factor for use with <a href="command-line-options.html#distort"
				1891	>-distort</a></td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1892	</tr>
				1893
				1894	<tr>
				1895	<td>distort:viewport=<var>WxH+X+Y</var></td>
				1896	<td>Sets the viewport for use with <a href="command-line-options.html#distort">-distort</a></td>
				1897	</tr>
				1898
				1899	<tr>
				1900	<td>dot:layout-engine=<var>value</var></td>
				1901	<td>Specifies the layout engine for the DOT image format (e.g.
				1902	<code>neato</code>).</td>
				1903	</tr>
				1904
				1905	<tr>
				1906	<td>filter:option=<var>value</var></td>
				1907	<td>Set a filter option for use with <a href="command-line-options.html#resize">-resize</a>.
				1908	See <a href="command-line-options.html#filter">-filter</a> for details.</td>
				1909	</tr>
				1910
				1911	<tr>
				1912	<td>fourier:normalize=<var>inverse</var></td>
				1913	<td>Sets the location for the FFT/IFT normalization as use by
				1914	<a href="command-line-options.html#fft">+-fft</a> and <a href="command-line-options.html#ift">+-ift</a>. The default is
				1915	<var>forward</var>.</td>
				1916	</tr>
				1917
				1918	<tr>
				1919	<td>h:format=<var>value</var></td>
				1920	<td>Set the image encoding format use when writing a C-style header.
				1921	<var>format</var> can be any output format supported by ImageMagick
Cristy	579a0cb	2016-11-26 12:27:17 -0500	[diff] [blame^]	1922	except for <var>h</var> and <var>magick</var>. If this
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1923	option is omitted, the default is <var>GIF</var> for PseudoClass
				1924	images and <var>PNM</var> for DirectClass images.
Cristy	579a0cb	2016-11-26 12:27:17 -0500	[diff] [blame^]	1925	</td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1926	</tr>
				1927
				1928	<tr>
				1929	<td>icon:auto-resize</td>
				1930	<td>Automatically stores multiple sizes when writing an ico image
				1931	(requires a 256x256 input image).</td>
				1932	</tr>
				1933
				1934	<tr>
				1935	<td>jp2:layer-number=<var>value</var></td>
				1936	<td>Sets the maximum number of quality layers to decode. Same for JPT, JC2,
				1937	and J2K</td>
				1938	</tr>
				1939
				1940	<tr>
				1941	<td>jp2:number-resolutions=<var>value</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	1942	<td>Sets the number of resolutions to encode.Same for JPT, JC2, and
				1943	J2K</td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1944	</tr>
				1945
				1946	<tr>
				1947	<td>jp2:progression-order=<var>value</var></td>
				1948	<td>choose from LRCP, RLCP, RPCL, PCRL or CPRL. Same for JPT, JC2, and
				1949	J2K</td>
				1950	</tr>
				1951
				1952	<tr>
				1953	<td>jp2:quality=<var>value,value...</var></td>
				1954	<td>Sets the quality layer PSNR, given in dB. The order is from left to
				1955	right in ascending order. The default is a single lossless quality layer.
				1956	Same for JPT, JC2, and J2K</td>
				1957	</tr>
				1958
				1959	<tr>
				1960	<td>jp2:rate=<var>value</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	1961	<td>Specify the compression factor to use while writing JPEG-2000 files.
				1962	The compression factor is the reciprocal of the compression ratio. The
				1963	valid range is 0.0 to 1.0, with 1.0 indicating lossless compression. If
				1964	defined, this value overrides the -quality setting. A quality setting
				1965	of 75 results in a rate value of 0.06641. Same for JPT, JC2, and J2K</td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1966	</tr>
				1967
				1968	<tr>
				1969	<td>jp2:reduce-factor=<var>value</var></td>
				1970	<td>Sets the number of highest resolution levels to be discarded.Same for
				1971	JPT, JC2, and J2K</td>
				1972	</tr>
				1973
				1974	<tr>
				1975	<td>jpeg:block-smoothing=<var>on\|off</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	1976	<td> </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	1977	</tr>
				1978
				1979	<tr>
				1980	<td>jpeg:colors=<var>value</var></td>
				1981	<td>Set the desired number of colors and let the JPEG encoder do the
				1982	quantizing.</td>
				1983	</tr>
				1984
				1985	<tr>
				1986	<td>jpeg:dct-method=<var>value</var></td>
				1987	<td>Choose from <code>default</code>, <code>fastest</code>,
				1988	<code>float</code>, <code>ifast</code>, and <code>islow</code>.</td>
				1989	</tr>
				1990
				1991	<tr>
				1992	<td>jpeg:extent=<var>value</var></td>
				1993	<td>Restrict the maximum JPEG file size, for example <code>-define
				1994	jpeg:extent=400KB</code>. The JPEG encoder will search for the highest
				1995	compression quality level that results in an output file that does not
Cristy	e93be68	2015-11-26 09:07:51 -0500	[diff] [blame]	1996	exceed the value. The <code>-quality</code> option also will be respected
				1997	starting with version 6.9.2-5. Between 6.9.1-0 and 6.9.2-4, add -quality
				1998	100 in order for the jpeg:extent to work properly. Prior to 6.9.1-0, the
				1999	-quality setting was ignored.</td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2000	</tr>
				2001
				2002	<tr>
				2003	<td>jpeg:fancy-upsampling=<var>on\|off</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2004	<td> </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2005	</tr>
				2006
				2007	<tr>
				2008	<td>jpeg:optimize-coding=<var>on\|off</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2009	<td> </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2010	</tr>
				2011
				2012	<tr>
				2013	<td>jpeg:q-table=<var>table</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2014	<td> </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2015	</tr>
				2016
				2017	<tr>
				2018	<td>jpeg:sampling-factor=<var>sampling-factor-string</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2019	<td> </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2020	</tr>
				2021
				2022	<tr>
				2023	<td>jpeg:size=<var>geometry</var></td>
				2024	<td>Set the size hint of a JPEG image, for
				2025	example, <code>-define jpeg:size=128x128</code>.
				2026	It is most useful for increasing performance and reducing the memory
				2027	requirements when reducing the size of a large JPEG image.</td>
				2028	</tr>
				2029
				2030	<tr>
				2031	<td>json:features</td>
				2032	<td>includes features in verbose information</td>
				2033	</tr>
				2034
				2035	<tr>
				2036	<td>json:limit</td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2037	<td> </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2038	</tr>
				2039
				2040	<tr>
				2041	<td>json:locate</td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2042	<td> </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2043	</tr>
				2044
				2045	<tr>
				2046	<td>json:moments</td>
				2047	<td>includes image moments in verbose information</td>
				2048	</tr>
				2049
				2050	<tr>
				2051	<td>magick:format=<var>value</var></td>
				2052	<td>Set the image encoding format use when writing a C-style header.
Cristy	579a0cb	2016-11-26 12:27:17 -0500	[diff] [blame^]	2053	This is the same as "h:format=format" described above.</td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2054	</tr>
				2055
				2056	<tr>
				2057	<td>mng:need-cacheoff</td>
				2058	<td>turn playback caching off for streaming MNG.</td>
				2059	</tr>
				2060
				2061	<tr>
				2062	<td>morphology:compose=<var>compose-method</var></td>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2063	<td>Specifies how to merge results generated by multiple<a
				2064	href="command-line-options.html#morphology" >-morphology</a> kernel. The default is none. One
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2065	typical value is 'lighten' as used, for example, with the sobel edge
				2066	kernels. </td>
				2067	</tr>
				2068
				2069	<tr>
				2070	<td>morphology:showkernel=<var>1</var></td>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2071	<td>Outputs (to 'standard error') all the information about a generated <a
				2072	href="command-line-options.html#morphology" >-morphology</a> kernel.</td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2073	</tr>
				2074
				2075	<tr>
				2076	<td>pcl:fit-to-page=<var>true</var></td>
Cristy	579a0cb	2016-11-26 12:27:17 -0500	[diff] [blame^]	2077	</tr>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2078
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2079	<tr>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2080	<td>pdf:fit-page=<var>geometry</var></td>
				2081	<td> geometry specifies the scaling dimensions for resizing when the PDF is
				2082	being read. The geometry is either WxH{%} or page size. No offsets are
				2083	allowed. (introduced in IM 6.8.8-8)</td>
				2084	</tr>
				2085
				2086	<tr>
				2087	<td>pdf:fit-to-page=<var>true</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2088	<td> </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2089	</tr>
				2090
				2091	<tr>
				2092	<td>pdf:use-cropbox=<var>true</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2093	<td> </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2094	</tr>
				2095
				2096	<tr>
				2097	<td>pdf:use-trimbox=<var>true</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2098	<td> </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2099	</tr>
				2100
				2101	<tr>
Cristy	3b0b58d	2016-11-06 07:40:23 -0500	[diff] [blame]	2102	<td>phash:colorspaces=<var>colorspace,colorspace,...</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2103	<td>the perceptual hash defaults to the sRGB and HCLp colorspaces. When
				2104	using this define, you can specify up to six alternative colorspaces. (as
				2105	of IM 7.0.3-8)</td>
				2106	</tr>
				2107
				2108	<tr>
				2109	<td>phash:normalize=<var>true</var></td>
				2110	<td>normalizes the phash metric by dividing by the number of channels
				2111	specified by <code>-define phash:colorspaces</code> when using compare
				2112	-metric phash. (as of IM 7.0.3-8)</td>
Cristy	3b0b58d	2016-11-06 07:40:23 -0500	[diff] [blame]	2113	</tr>
				2114
				2115	<tr>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2116	<td>png:bit-depth=<var>value</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2117	<td> </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2118	</tr>
Cristy	3b0b58d	2016-11-06 07:40:23 -0500	[diff] [blame]	2119
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2120	<tr>
				2121	<td>png:color-type=<var>value</var></td>
				2122	<td>desired bit-depth and color-type for PNG output. You can force the PNG
				2123	encoder to use a different bit-depth and color-type than it would have
				2124	normally selected, but only if this does not cause any loss of image
				2125	quality. Any attempt to reduce image quality is treated as an error and no
				2126	PNG file is written. E.g., if you have a 1-bit black-and-white image, you
				2127	can use these "defines" to cause it to be written as an 8-bit grayscale,
				2128	indexed, or even a 64-bit RGBA. But if you have a 16-million color image,
				2129	you cannot force it to be written as a grayscale or indexed PNG. If you
				2130	wish to do this, you must use the appropriate <a href="command-line-options.html#depth">-depth</a>,
				2131	<a href="command-line-options.html#colors">-colors</a>, or <a href="command-line-options.html#type">-type</a> directives to
				2132	reduce the image quality prior to using the PNG encoder. Note that in
				2133	indexed PNG files, "bit-depth" refers to the number of bits per index,
				2134	which can be 1, 2, 4, or 8. In such files, the color samples always have
				2135	8-bit depth.</td>
				2136	</tr>
				2137
				2138	<tr>
				2139	<td>png:compression-filter=<var>value</var></td>
				2140	<td> valid values are 0 through 9. 0-4 are the corresponding PNG filters,
				2141	5 means adaptive filtering except for images with a colormap, 6 means
				2142	adaptive filtering for all images, 7 means MNG "loco" compression, 8 means
				2143	Z_RLE strategy with adaptive filtering, and 9 means Z_RLE strategy with no
				2144	filtering.</td>
				2145	</tr>
				2146
				2147	<tr>
				2148	<td>png:compression-level=<var>value</var></td>
				2149	<td> valid values are 0 through 9, with 0 providing the least but fastest
				2150	compression and 9 usually providing the best and always the slowest.</td>
				2151	</tr>
				2152
				2153	<tr>
				2154	<td>png:compression-strategy=<var>value</var></td>
				2155	<td> valid values are 0 through 4, meaning default, filtered, huffman_only,
				2156	rle, and fixed ZLIB compression strategy. If you are using an old zlib
				2157	that does not support Z_RLE (before 1.2.0) or Z_FIXED (before 1.2.2.2),
				2158	values 3 and 4, respectively, will use the zlib default strategy
				2159	instead.</td>
				2160	</tr>
				2161
				2162	<tr>
				2163	<td>png:format=<var>value</var></td>
				2164	<td> valid values are <var>png8</var>, <var>png24</var>,
				2165	<var>png32</var>, <var>png48</var>,
				2166	<var>png64</var>, and <var>png00</var>.
				2167	This property can be useful for specifying
				2168	the specific PNG format to be used, when the usual method of prepending the
				2169	format name to the output filename is inconvenient, such as when writing
				2170	a PNG-encoded ICO file or when using <a href="mogrify.html">mogrify</a>.
				2171	Value = <var>png8</var> reduces the number of colors to 256,
				2172	only one of which may be fully transparent, if necessary. The other
				2173	values do not force any reduction of quality; it is an error to request
				2174	a format that cannot represent the image data without loss (except that
				2175	it is allowed to reduce the bit-depth from 16 to 8 for all formats).
				2176	Value = <var>png24</var> and <var>png48</var>
				2177	allow transparency, only if a single color is fully transparent and that
				2178	color does not also appear in an opaque pixel; such transparency is
				2179	written in a PNG <code>tRNS</code> chunk.
				2180	Value = <var>png00</var> causes the image to inherit its
				2181	color-type and bit-depth from the input image, if the input was also
				2182	a PNG.</td>
				2183	</tr>
				2184
				2185	<tr>
				2186	<td>png:exclude-chunk=<var>value</var></td>
				2187
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2188	<tr>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2189	<td>png:include-chunk=<var>value</var></td>
				2190	<td>ancillary chunks to be excluded from or included in PNG output.
				2191
				2192	<p>The <var>value</var> can be the name of a PNG chunk-type such
				2193	as <var>bKGD</var>, a comma-separated list of chunk-names
				2194	(which can include the word <var>date</var>, the word
				2195	<var>all</var>, or the word <var>none</var>).
				2196	Although PNG chunk-names are case-dependent, you can use all lowercase
				2197	names if you prefer.</p>
				2198
				2199	<p>The "include-chunk" and "exclude-chunk" lists only affect the behavior
				2200	of the PNG encoder and have no effect on the PNG decoder.</p>
				2201
				2202	<p>As a special case, if the <code>sRGB</code> chunk is excluded and
				2203	the <code>gAMA</code> chunk is included, the <code>gAMA</code> chunk will
				2204	only be written if gamma is not 1/2.2, since most decoders assume
				2205	sRGB and gamma=1/2.2 when no colorspace information is included in
				2206	the PNG file. Because the list is processed from left to right, you
				2207	can achieve this with a single define:</p>
				2208
				2209	<pre>
				2210	-define png:include-chunk=none,gAMA
				2211	</pre>
				2212
				2213	<p>As a special case, if the <code>sRGB</code> chunk is not excluded and
				2214	the PNG encoder recognizes that the image contains the sRGB ICC profile,
				2215	the PNG encoder will write the <code>sRGB</code> chunk instead of the
				2216	entire ICC profile. To force the PNG encoder to write the sRGB
				2217	profile as an <code>iCCP</code> chunk in the output PNG instead of the
				2218	<code>sRGB</code> chunk, exclude the <code>sRGB</code> chunk.</p>
				2219
				2220	<p>The critical PNG chunks <code>IHDR</code>, <code>PLTE</code>,
				2221	<code>IDAT</code>, and <code>IEND</code> cannot be excluded. Any such
				2222	entries appearing in the list will be ignored.</p>
				2223
				2224	<p>If the ancillary PNG <code>tRNS</code> chunk is excluded and the
				2225	image has transparency, the PNG colortype is forced to be 4 or 6
				2226	(GRAY_ALPHA or RGBA). If the image is not transparent, then the
				2227	<code>tRNS</code> chunk isn't written anyhow, and there is no effect
				2228	on the PNG colortype of the output image.</p>
				2229
				2230	<p>The <a href="command-line-options.html#strip">-strip</a> option does the equivalent of the
				2231	following for PNG output:</p>
				2232
				2233	<pre>
				2234	-define png:exclude-chunk=EXIF,iCCP,iTXt,sRGB,tEXt,zCCP,zTXt,date
				2235	</pre>
				2236
				2237	<p>The default behavior is to include all known PNG ancillary chunks
				2238	plus ImageMagick's private <code>vpAg</code> ("virtual page") chunk,
				2239	and to exclude all PNG chunks that are unknown to ImageMagick,
				2240	regardless of their PNG "copy-safe" status as described in the
				2241	PNG specification.</p>
				2242
				2243	<p>Any chunk names that are not known to ImageMagick are ignored
				2244	if they appear in either the "include-chunk" or "exclude-chunk" list.
				2245	The ancillary chunks currently known to ImageMagick are
				2246	<code>bKGD</code>, <code>cHRM</code>, <code>gAMA</code>, <code>iCCP</code>,
				2247	<code>oFFs</code>, <code>pHYs</code>, <code>sRGB</code>, <code>tEXt</code>,
				2248	<code>tRNS</code>, <code>vpAg</code>, and <code>zTXt</code>.</p>
				2249
				2250	<p>You can also put <code>date</code> in the list to include or exclude
				2251	the "Date:create" and "Date:modify" text chunks that ImageMagick normally
				2252	inserts in the output PNG.</p></td>
				2253	</tr>
				2254
				2255	<tr>
				2256	<td>png:preserve-colormap[=<var>true</var>]</td>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2257	<td>Use the existing image->colormap. Normally the PNG encoder will
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2258	try to optimize the palette, eliminating unused entries and putting
				2259	the transparent colors first. If this flag is set, that behavior
				2260	is suppressed.</td>
				2261	</tr>
				2262
				2263	<tr>
				2264	<td>png:preserve-iCCP[=<var>true</var>]</td>
				2265	<td>By default, the PNG decoder and encoder examine any ICC profile
				2266	that is present, either from an <code>iCCP</code> chunk in the PNG
				2267	input or supplied via an option, and if the profile is recognized
				2268	to be the sRGB profile, converts it to the <code>sRGB</code> chunk.
				2269	You can use <code>-define png:preserve-iCCP</code> to prevent
				2270	this from happening; in such cases the <code>iCCP</code> chunk
				2271	will be read or written and no <code>sRGB</code> chunk will be
				2272	written. There are some ICC profiles that claim to be sRGB but
				2273	have various errors that cause them to be rejected by libpng16; such
				2274	profiles are recognized anyhow and converted to the <code>sRGB</code>
				2275	chunk, but are rejected if the <code>-define png:preserve-iCCP</code>
				2276	is present. Note that not all "sRGB" ICC profiles are recognized
				2277	yet; we will add them to the list as we encounter them.</td>
				2278	</tr>
				2279
				2280	<tr>
				2281	<td>png:swap-bytes[=<var>true</var>]</td>
				2282	<td>The PNG specification requires that any multi-byte integers be stored in
				2283	network byte order (MSB-LSB endian). This option allows you to
				2284	fix any invalid PNG files that have 16-bit samples stored incorrectly
				2285	in little-endian order (LSB-MSB). The "-define png:swap-bytes" option
				2286	must appear before the input filename on the commandline. The swapping
				2287	is done during the libpng decoding operation.</td>
				2288	</tr>
				2289
				2290	<tr>
				2291	<td>profile:skip=<var>name1,name2,...</var></td>
				2292	<td>Skip the named profile[s] when reading the image. Use skip="*" to
				2293	skip all named profiles in the image. Many named profiles exist,
				2294	including ICC, EXIF, APP1, IPTC, XMP, and others.</td>
				2295	</tr>
				2296
				2297	<tr>
				2298	<td>ps:imagemask</td>
				2299	<td>If the ps:imagemask flag is defined, the PS3 and EPS3 coders will
				2300	create Postscript files that render bilevel images with the Postscript
				2301	imagemask operator instead of the image operator.</td>
				2302	</tr>
				2303
				2304	<tr>
Cristy	3b0b58d	2016-11-06 07:40:23 -0500	[diff] [blame]	2305	<td>psd:additional-info=all\|selective</td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2306	<td>This option should only be used when converting from a PSD file to
				2307	another PSD file. This should be placed after the image is read. The two
				2308	options are 'all' and 'selective'. The 'selective' option will preserve
				2309	all additional information that is not related to the geometry of the
				2310	image. The 'all' option should only be used when the geometry of the
				2311	image has not been changed. This option is helpful when transferring
				2312	non-simple layers, such as adjustment layers from the input PSD file to
				2313	the output PSD file. If this option is not used, the additional
				2314	information will not be preserved. This define is available as of
				2315	Imagemagick version 6.9.5-8.
Cristy	3b0b58d	2016-11-06 07:40:23 -0500	[diff] [blame]	2316	</td>
				2317	</tr>
				2318
				2319	<tr>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2320	<td>psd:alpha-unblend=off</td>
				2321	<td>Disables new automatic un-blending of transparency with the base image
				2322	for the flattened layer 0 before adding the alpha channel to the output
				2323	image. This define must be placed before the input psd image. (Available
				2324	as of IM 6.9.2.5). The automatic un-blending is new to IM 6.9.2.5 and
				2325	prevents the transparency from being applied twice in the output
Cristy	3b0b58d	2016-11-06 07:40:23 -0500	[diff] [blame]	2326	image. This option should be set before reading the image.</td>
				2327	</tr>
				2328
				2329	<tr>
				2330	<td>psd:preserve-opacity-mask=true</td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2331	<td>This option should only be used when converting from a PSD file to
				2332	another PSD file. It will preserve the opacity mask of a layer and add it
				2333	back to the layer when the image is saved. Setting this to 'true' will
				2334	enable this feature. This define is available as of Imagemagick version
				2335	6.9.5-10.
Cristy	3b0b58d	2016-11-06 07:40:23 -0500	[diff] [blame]	2336	</td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2337	</tr>
				2338
				2339	<tr>
Cristy	1f1f3a0	2016-06-01 07:25:42 -0400	[diff] [blame]	2340	<td>preserve-timestamp=<var>{True, False}</var></td>
				2341	<td>Preserve file timestamp (<code>mogrify</code> only).</td>
				2342	</tr>
				2343
				2344	<tr>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2345	<td>quantum:format=<var>type</var></td>
				2346	<td>Set the type to <code>floating-point</code> to specify a floating-point
				2347	format for raw files (e.g. GRAY:) or for MIFF and TIFF images in HDRI mode
				2348	to preserve negative values. If <a href="command-line-options.html#depth">-depth</a> 16 is
				2349	included, the result is a single precision floating point format.
				2350	If <a href="command-line-options.html#depth">-depth</a> 32 is included, the result is
				2351	double precision floating point format.</td>
				2352	</tr>
				2353
				2354	<tr>
				2355	<td>quantum:polarity=<var>photometric-interpretation</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2356	<td>Set the photometric-interpretation of an image (typically for TIFF
				2357	image file format) to either <code>min-is-black</code> (default) or
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2358	<code>min-is-white</code>.</td>
				2359	</tr>
				2360
				2361	<tr>
				2362	<td>sample:offset=<var>geometry</var></td>
				2363	<td>Location of the sampling point within the sub-region being sampled,
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2364	expressed as percentages (see <a href="command-line-options.html#sample" >-sample</a>).</td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2365	</tr>
				2366
				2367	<tr>
				2368	<td>showkernel=<var>1</var></td>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2369	<td>Outputs (to 'standard error') all the information about a generated <a
				2370	href="command-line-options.html#morphology" >-morphology</a> kernel.</td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2371	</tr>
				2372
				2373	<tr>
				2374	<td>stream:buffer-size=<var>value</var></td>
				2375	<td>Set the stream buffer size. Select 0 for unbuffered I/O.</td>
				2376	</tr>
				2377
				2378	<tr>
				2379	<td>tiff:alpha=<var>associated\|unassociated\|unspecified</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2380	<td>Specify the alpha extra samples as associated, unassociated or
				2381	unspecified </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2382	</tr>
				2383
				2384	<tr>
				2385	<td>tiff:endian=<var>msb\|lsb</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2386	<td> </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2387	</tr>
				2388
				2389	<tr>
				2390	<td>tiff:exif-properties=<var>false</var></td>
				2391	<td>Skips reading the EXIF properties.</td>
				2392	</tr>
				2393
				2394	<tr>
				2395	<td>tiff:fill-order=<var>msb\|lsb</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2396	<td> </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2397	</tr>
				2398
				2399	<tr>
				2400	<td>tiff:ignore-layers=<var>true</var></td>
				2401	<td>Ignores the photoshop layers.</td>
				2402	</tr>
				2403
				2404	<tr>
				2405	<td>tiff:ignore-tags=<var>comma-separate-list-of-tag-IDs</var></td>
				2406	<td>Allows one or more tag ID values to be ignored.</td>
				2407	</tr>
				2408
				2409	<tr>
				2410	<td>tiff:rows-per-strip=<var>value</var></td>
				2411	<td>Sets the number of rows per strip</td>
				2412	</tr>
				2413
				2414	<tr>
				2415	<td>tiff:tile-geometry=<var>WxH</var></td>
				2416	<td>Sets the tile size for pyramid tiffs. Requires the suffix
				2417	PTIF: before the outputname</td>
				2418	</tr>
Cristy	e09ed31	2016-03-06 08:07:39 -0500	[diff] [blame]	2419
				2420	<tr>
				2421	<td>type:features=<var>string</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2422	<td> </td>
Cristy	e09ed31	2016-03-06 08:07:39 -0500	[diff] [blame]	2423	</tr>
				2424
				2425	<tr>
				2426	<td>type:hinting=<var>off</var></td>
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	2427	<td> </td>
Cristy	e09ed31	2016-03-06 08:07:39 -0500	[diff] [blame]	2428	</tr>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2429	</table>
				2430
				2431	<p>For example, to create a postscript file that will render only the black
				2432	pixels of a bilevel image, use:</p>
				2433
				2434	<pre>
				2435	convert bilevel.tif -define ps:imagemask eps3:stencil.ps
				2436	</pre>
				2437
				2438	<p>Set attributes of the image registry by prefixing the value with
				2439	<code>registry:</code>. For example, to set a temporary path to put work files,
				2440	use:</p>
				2441
				2442	<pre>
				2443	-define registry:temporary-path=/data/tmp
				2444	</pre>
				2445
				2446	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2447	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2448	</div>
				2449
				2450	<p class="magick-description">display the next image after pausing.</p>
				2451
				2452	<p>This option is useful for regulating the animation of image sequences
				2453	<var>ticks/ticks-per-second</var> seconds must expire before the display of the
				2454	next image. The default is no delay between each showing of the image
				2455	sequence. The default ticks-per-second is 100.</p>
				2456
				2457	<p>Use <code>></code> to change the image delay <var>only</var> if its current
				2458	value exceeds the given delay. <code><</code> changes the image delay
				2459	<var>only</var> if current value is less than the given delay. For example, if
				2460	you specify <code>30></code> and the image delay is 20, the image delay does
				2461	not change. However, if the image delay is 40 or 50, the delay it is changed
				2462	to 30. Enclose the given delay in quotation marks to prevent the
				2463	<code><</code> or <code>></code> from being interpreted by your shell as
				2464	a file redirection.</p>
				2465
				2466
				2467	<div style="margin: auto;">
				2468	<h3 class="magick-header"><a id="delete"></a>-delete <var>indexes</var></h3>
				2469	</div>
				2470
				2471	<p class="magick-description">delete the images specified by index, from the image sequence.</p>
				2472
				2473	<p>Specify the image by its index in the sequence. The first image is index
				2474	0. Negative indexes are relative to the end of the sequence, for example, -1
				2475	represents the last image of the sequence. Specify a range of images with
				2476	a dash (e.g. 0-4). Separate indexes with a comma (e.g. 0,2). Use
Cristy	912a922	2016-06-17 15:37:28 -0400	[diff] [blame]	2477	<code>+delete</code> to delete the last image in the current image sequence. Use <code>-delete 0--1</code> to delete the entire image sequence.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2478
				2479
				2480	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2481	<h3 class="magick-header"><a id="density"></a>-density <var>width</var><br />-density <var>width</var>x<var>height</var></h3>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2482	</div>
				2483
				2484	<p class="magick-description">Set the horizontal and vertical resolution of an image for rendering to devices.</p>
				2485
				2486	<p>This option specifies the image resolution to store while encoding a raster
				2487	image or the canvas resolution while rendering (reading) vector formats such
				2488	as Postscript, PDF, WMF, and SVG into a raster image. Image resolution
				2489	provides the unit of measure to apply when rendering to an output device or
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2490	raster image. The default unit of measure is in dots per inch (DPI). The <a
				2491	href="command-line-options.html#units">-units</a> option may be used to select dots per centimeter
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2492	instead.</p>
				2493
				2494	<p>The default resolution is 72 dots per inch, which is equivalent to one
				2495	point per pixel (Macintosh and Postscript standard). Computer screens are
				2496	normally 72 or 96 dots per inch, while printers typically support 150, 300,
				2497	600, or 1200 dots per inch. To determine the resolution of your display, use
				2498	a ruler to measure the width of your screen in inches, and divide by the
				2499	number of horizontal pixels (1024 on a 1024x768 display).</p>
				2500
				2501	<p>If the file format supports it, this option may be used to update the
				2502	stored image resolution. Note that Photoshop stores and obtains image
				2503	resolution from a proprietary embedded profile. If this profile is not
				2504	stripped from the image, then Photoshop will continue to treat the image using
				2505	its former resolution, ignoring the image resolution specified in the standard
				2506	file header.</p>
				2507
				2508	<p>The <a href="command-line-options.html#density">-density</a> option sets an <var>attribute</var> and
				2509	does not alter the underlying raster image. It may be used to adjust the
				2510	rendered size for desktop publishing purposes by adjusting the scale applied
				2511	to the pixels. To resize the image so that it is the same size at a different
				2512	resolution, use the <a href="command-line-options.html#resample">-resample</a> option.</p>
				2513
				2514	<div style="margin: auto;">
				2515	<h3 class="magick-header"><a id="depth"></a>-depth <var>value</var></h3>
				2516	</div>
				2517
				2518	<p class="magick-description">depth of the image.</p>
				2519
				2520	<p>This the number of bits in a color sample within a pixel. Use this option
				2521	to specify the depth of raw images whose depth is unknown such as GRAY, RGB,
				2522	or CMYK, or to change the depth of any image after it has been read.</p>
				2523
				2524	<div style="margin: auto;">
				2525	<h3 class="magick-header"><a id="descend"></a>-descend</h3>
				2526	</div>
				2527
				2528	<p class="magick-description">obtain image by descending window hierarchy.</p>
				2529
				2530	<div style="margin: auto;">
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	2531	<h3 class="magick-header"><a id="deskew"></a>-deskew <var>threshold{%}</var></h3>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2532	</div>
				2533
				2534	<p class="magick-description">straighten an image. A threshold of 40% works for most images.</p>
				2535
				2536	<p>Use <a href="command-line-options.html#set">-set</a> <code>option:deskew:auto-crop
Cristy	3b0b58d	2016-11-06 07:40:23 -0500	[diff] [blame]	2537	<var>true \| false</var></code> to auto crop the image.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2538
				2539	<div style="margin: auto;">
				2540	<h3 class="magick-header"><a id="despeckle"></a>-despeckle</h3>
				2541	</div>
				2542
				2543	<p class="magick-description">reduce the speckles within an image.</p>
				2544
				2545	<div style="margin: auto;">
				2546	<h3 class="magick-header"><a id="direction"></a>-direction <var>type</var></h3>
				2547	</div>
				2548
				2549	<p class="magick-description">render text right-to-left or left-to-right.</p>
				2550
				2551	<div style="margin: auto;">
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	2552	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2553	</div>
				2554
				2555	<p class="magick-description">shift image pixels as defined by a displacement map.</p>
				2556
				2557	<p>With this option, the 'overlay' image, and optionally the 'mask' image,
				2558	is used as a displacement map, which is used to displace the lookup of
				2559	what part of the 'background' image is seen at each point of the overlaid
				2560	area. Much like the displacement map is a 'lens' that redirects light shining
				2561	through it so as to present a distorted view the original 'background' image
				2562	behind it. </p>
				2563
				2564	<p>Any perfect grey areas of the displacement map produce a zero
				2565	displacement of the image. Black areas produce the given maximum negative
				2566	displacement of the lookup point, while white produce a maximum positive
				2567	displacement of the lookup. </p>
				2568
				2569	<p>Note that it is the lookup of the 'background' that is displaced, not a
				2570	displacement of the image itself. As such an area of the displacement map
				2571	containing 'white' will have the lookup point 'shifted' by a positive amount,
				2572	and thus generating a copy of the destination image to the right/downward from
				2573	the correct position. That is the image will look like it may have been
				2574	'shifted' in a negative left/upward direction. Understanding this is a very
				2575	important in understanding how displacement maps work. </p>
				2576
				2577	<p>The given arguments define the maximum amount of displacement in pixels
				2578	that a particular map can produce. If the displacement scale is large enough
				2579	it is also possible to lookup parts of the 'background' image that lie well
				2580	outside the bounds of the displacement map itself. That is you could very
				2581	easily copy a section of the original image from outside the overlay area
				2582	into the overlay area. </p>
				2583
				2584	<p>The '%' flag makes the displacement scale relative to the size of the
				2585	overlay image (100% = half width/height of image). Using '!' switches
				2586	percentage arguments to refer to the destination image size instead.
				2587	these flags were added as of IM v6.5.3-5.</p>
				2588
				2589	<p>Normally a single grayscale displacement map is provided, which with the
				2590	given scaling values will determine a single direction (vector) in which
				2591	displacements can occur (positively or negatively). However, if you also
				2592	specify a third image which is normally used as a <var>mask</var>,
				2593	the <var>composite image</var> is used for horizontal X
				2594	displacement, while the <var>mask image</var> is used for vertical Y
				2595	displacement. This allows you to define completely different displacement
				2596	values for the X and Y directions, and allowing you to lookup any point within
				2597	the <var>scale</var> bounds. In other words each pixel can lookup
				2598	any other nearby pixel, producing complex 2 dimensional displacements, rather
				2599	than a simple 1 dimensional vector displacements. </p>
				2600
				2601	<p>Alternatively rather than supplying two separate images, as of IM v6.4.4-0,
				2602	you can use the 'red' channel of the overlay image to specify the horizontal
				2603	or X displacement, and the 'green' channel for the vertical or Y displacement.
				2604	</p>
				2605
				2606	<p>As of IM v6.5.3-5 any alpha channel in the overlay image is used as a
				2607	mask the transparency of the destination image. However areas outside the
				2608	overlaid areas will not be effected. </p>
				2609
				2610
				2611	<div style="margin: auto;">
				2612	<h3 class="magick-header"><a id="display"></a>-display <var>host:display[.screen]</var></h3>
				2613	</div>
				2614
				2615	<p class="magick-description">Specifies the X server to contact.</p>
				2616
				2617	<p>This option is used with convert for obtaining image or font from this
				2618	X server. See <var>X(1)</var>.</p>
				2619
				2620	<div style="margin: auto;">
				2621	<h3 class="magick-header"><a id="dispose"></a>-dispose <var>method</var></h3>
				2622	</div>
				2623
				2624	<p class="magick-description">define the GIF disposal image setting for images that are being created or read in. </p>
				2625
				2626	<p>The layer disposal method defines the way each the displayed image is to be
				2627	modified after the current 'frame' of an animation has finished being
				2628	displayed (after its 'delay' period), but before the next frame on an
				2629	animation is to be overlaid onto the display. </p>
				2630
				2631	<p>Here are the valid methods:</p>
				2632
				2633	<dl class="dl-horizontal">
				2634	<dt>Undefined</dt><dd>0: No disposal specified (equivalent to '<code>none</code>').</dd>
				2635	<dt>None</dt><dd>1: Do not dispose, just overlay next frame image.</dd>
				2636	<dt>Background</dt><dd>2: Clear the frame area with the background color.</dd>
				2637	<dt>Previous</dt><dd>3: Clear to the image prior to this frames overlay.</dd>
				2638	</dl>
				2639
				2640	<p>You can also use the numbers given above, which is what the GIF format
				2641	uses internally to represent the above settings. </p>
				2642
				2643	<p>To print a complete list of dispose methods, use <a href="command-line-options.html#list">-list dispose</a>.</p>
				2644
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2645	<p>Use <a href="command-line-options.html#dispose" >+dispose</a>, turn off the setting and prevent
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2646	resetting the layer disposal methods of images being read in. </p>
				2647
				2648	<p>Use <a href="command-line-options.html#set">-set</a> '<code>dispose</code>' method to set the image
				2649	disposal method for images already in memory.</p>
				2650
				2651	<div style="margin: auto;">
				2652	<h3 class="magick-header"><a id="dissimilarity-threshold"></a>-dissimilarity-threshold <var>value</var></h3>
				2653	</div>
				2654
				2655	<p class="magick-description">maximum RMSE for subimage match (default 0.2).</p>
				2656
				2657
				2658	<div style="margin: auto;">
				2659	<h3 class="magick-header"><a id="dissolve"></a>-dissolve <var>src_percent</var>[x<var>dst_percent</var>]</h3>
				2660	</div>
				2661
				2662	<p class="magick-description">dissolve an image into another by the given percent.</p>
				2663
				2664	<p>The opacity of the composite image is multiplied by the given percent, then
				2665	it is composited 'over' the main image. If <var>src_percent</var>
				2666	is greater than 100, start dissolving the main image so it becomes
				2667	transparent at a value of '<code>200</code>'. If both percentages
				2668	are given, each image are dissolved to the percentages given. </p>
				2669
				2670	<p>Note that dissolve percentages do not add, two opaque images dissolved
				2671	'50,50', produce a 75% transparency. For a 50% + 50% blending of the two
				2672	images, you would need to use dissolve values of '50,100'. </p>
				2673
				2674	<div style="margin: auto;">
				2675	<h3 class="magick-header"><a id="distort"></a>-distort <var>method arguments</var></h3>
				2676	</div>
				2677
				2678	<p class="magick-description">distort an image, using the given <var>method</var> and its required <var>arguments</var>.</p>
				2679
				2680	<p>The <var>arguments</var> is a single string containing a list
				2681	of floating point numbers separated by commas or spaces. The number of
				2682	and meaning of the floating point values depends on the distortion <var>method</var> being used. </p>
				2683
				2684	<p>Choose from these distortion types:</p>
				2685
				2686	<table class="table table-condensed table-striped">
				2687	<tr>
				2688	<th style="width: 8%">Method</th>
				2689	<th>Description</th>
				2690	</tr>
				2691
				2692	<tr>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2693	<td>ScaleRotateTranslate <br/> SRT</td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2694	<td>
				2695	Distort image by first scaling and rotating about a given 'center',
				2696	before translating that 'center' to the new location, in that order. It
				2697	is an alternative method of specifying a 'Affine' type of
				2698	distortion, but without shearing effects. It also provides a good way
				2699	of rotating and displacing a smaller image for tiling onto a larger
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2700	background (IE 2-dimensional animations). <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2701
				2702	The number of arguments determine the specific meaning of each
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2703	argument for the scales, rotation, and translation operations. <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2704
				2705	<dl class="dl-horizontal">
				2706	<dt>2:</dt><dd><var>Scale Angle</var></dd>
				2707	<dt>3:</dt><dd><var>X,Y Angle</var></dd>
				2708	<dt>4:</dt><dd><var>X,Y Scale Angle</var></dd>
				2709	<dt>5:</dt> <dd><var>X,Y ScaleX,ScaleY Angle</var></dd>
				2710	<dt>6:</dt> <dd><var>X,Y Scale Angle NewX,NewY</var></dd>
				2711	<dt>7:</dt> <dd><var>X,Y ScaleX,ScaleY Angle NewX,NewY</var></dd>
				2712	</dl>
				2713
				2714	This is actually an alternative way of specifying a 2 dimensional linear
				2715	'Affine' or 'AffineProjection' distortion. </td> </tr>
				2716
				2717	<tr>
				2718	<td>Affine</td>
				2719	<td>
				2720	Distort the image linearly by moving a list of at least 3 or more sets
				2721	of control points (as defined below). Ideally 3 sets or 12 floating
				2722	point values are given allowing the image to be linearly scaled,
				2723	rotated, sheared, and translated, according to those three points. See
				2724	also the related 'AffineProjection' and 'SRT'
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2725	distortions. <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2726
				2727	More than 3 sets given control point pairs (12 numbers) is least
				2728	squares fitted to best match a linear affine distortion. If only 2
				2729	control point pairs (8 numbers) are given a two point image translation
				2730	rotation and scaling is performed, without any possible shearing,
				2731	flipping or changes in aspect ratio to the resulting image. If only one
				2732	control point pair is provides the image is only translated, (which may
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2733	be a floating point non-integer translation). <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2734
				2735	This distortion does not include any form of perspective distortion.
				2736	</td>
				2737
				2738	</tr>
				2739
				2740	<tr>
				2741	<td>AffineProjection</td>
				2742	<td>
				2743	Linearly distort an image using the given Affine Matrix of 6
				2744	pre-calculated coefficients forming a set of Affine Equations to map
				2745	the source image to the destination image.
				2746
				2747	<p class="text-center"><var>
				2748	s<sub>x</sub>, r<sub>x</sub>,
				2749	r<sub>y</sub>, s<sub>y</sub>,
				2750	t<sub>x</sub>, t<sub>y</sub>
				2751	</var></p>
				2752
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2753	See <a href="command-line-options.html#affine" >-affine</a> setting for more detail, and
				2754	meanings of these coefficients. <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2755
				2756	The distortions 'Affine' and 'SRT' provide
				2757	alternative methods of defining this distortion, with ImageMagick doing
				2758	the calculations needed to generate the required coefficients. You can
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2759	see the internally generated coefficients, by using a <a
				2760	href="command-line-options.html#verbose" >-verbose</a> setting with those other variants. </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2761
				2762	</tr>
				2763
				2764	<tr>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2765	<td>BilinearForward<br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2766	BilinearReverse</td>
				2767	<td>
				2768	Bilinear Distortion, given a minimum of 4 sets of coordinate pairs, or
				2769	16 values (see below). Not that lines may not appear straight after
				2770	distortion, though the distance between coordinates will remain
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2771	consistent. <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2772
				2773	The 'BilinearForward' is used to map rectangles to any
				2774	quadrilateral, while the 'BilinearReverse' form maps any
				2775	quadrilateral to a rectangle, while preserving the straight line edges
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2776	in each case. <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2777
				2778	Note that 'BilinearForward' can generate invalid pixels
Cristy	f650f4f	2016-04-01 10:53:07 -0400	[diff] [blame]	2779	which will be colored using the <a href="command-line-options.html#alpha-color" >-alpha-color</a>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2780	color setting. Also if the quadrilateral becomes 'flipped' the image
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2781	may disappear. <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2782
				2783	There are future plans to produce a true Bilinear distortion that will
				2784	attempt to map any quadrilateral to any other quadrilateral, while
				2785	preserving edges (and edge distance ratios).
				2786
				2787	</td>
				2788	</tr>
				2789
				2790	<tr>
				2791	<td>Perspective</td>
				2792	<td>
				2793	Perspective distort the images, using a list of 4 or more sets of
				2794	control points (as defined below). More that 4 sets (16 numbers) of
				2795	control points provide least squares fitting for more accurate
				2796	distortions (for the purposes of image registration and panorama
				2797	effects). Less than 4 sets will fall back to a 'Affine'
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2798	linear distortion. <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2799
				2800	Perspective Distorted images ensures that straight lines remain
				2801	straight, but the scale of the distorted image will vary. The horizon
				2802	is anti-aliased, and the 'sky' color may be set using the
Cristy	f650f4f	2016-04-01 10:53:07 -0400	[diff] [blame]	2803	<a href="command-line-options.html#alpha-color" >-alpha-color</a> setting. </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2804	</tr>
				2805
				2806	<tr>
				2807	<td>PerspectiveProjection </td>
				2808	<td>
				2809	Do a 'Perspective' distortion biased on a set of 8
				2810	pre-calculated coefficients. You can get these coefficients by looking
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2811	at the <a href="command-line-options.html#verbose" >-verbose</a> output of a
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2812	'Perspective' distortion, or by calculating them yourself.
				2813	If the last two perspective scaling coefficients are zero, the
				2814	remaining 6 represents a transposed 'Affine Matrix'. </td>
				2815
				2816	</tr>
				2817
				2818	<tr>
				2819	<td>Arc</td>
				2820	<td>
				2821	Arc the image (variation of polar mapping) over the angle given around
				2822	a circle.
				2823
Cristy	579a0cb	2016-11-26 12:27:17 -0500	[diff] [blame^]	2824	<dl class="dl-horizontal">
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2825	<dt>arc_angle</dt>
				2826	<dd>The angle over which to arc the image side-to-side</dd>
				2827	<dt>rotate_angle</dt>
				2828	<dd>Angle to rotate resulting image from vertical center</dd>
				2829	<dt>top_radius</dt>
				2830	<dd>Set top edge of source image at this radius</dd>
				2831	<dt>bottom_radius </dt>
				2832	<dd>Set bottom edge to this radius (radial scaling)</dd>
Cristy	579a0cb	2016-11-26 12:27:17 -0500	[diff] [blame^]	2833	</dl>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2834
				2835	The resulting image is always resized to best fit the resulting image,
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2836	(as if using <a href="command-line-options.html#distort" >+distort</a>) while attempting to
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2837	preserve scale and aspect ratio of the original image as much as
				2838	possible with the arguments given by the user. All four arguments will
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2839	be needed to change the overall aspect ratio of an 'Arc'ed image. <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2840
				2841	This a variation of a polar distortion designed to try to preserve the
				2842	aspect ratio of the image rather than direct Cartesian to Polar
				2843	conversion. </td>
				2844	</tr>
				2845
				2846	<tr>
				2847	<td>Polar</td>
				2848	<td>
				2849	Like 'Arc' but do a complete Cartesian to Polar mapping of
				2850	the image. that is the height of the input image is mapped to the
				2851	radius limits, while the width is wrapped around between the
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2852	angle limits. <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2853
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2854	Arguments: <var>Rmax,Rmin CenterX,CenterY, start,end_angle</var> <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2855
				2856	All arguments are optional. With <var>Rmin</var> defaulting to zero, the
				2857	center to the center of the image, and the angles going from -180 (top)
				2858	to +180 (top). If <var>Rmax</var> is given the special value of
				2859	'0', the the distance from the center to the nearest edge
				2860	is used for the radius of the output image, which will ensure the whole
				2861	image is visible (though scaled smaller). However a special value of
				2862	'-1' will use the distance from the center to the furthest
				2863	corner, This may 'clip' the corners from the input rectangular image,
				2864	but will generate the exact reverse of a 'DePolar' with
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2865	the same arguments. <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2866
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2867	If the plus form of distort (<a href="command-line-options.html#distort" >+distort</a>) is used
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2868	output image center will default to 0,0 of the virtual
				2869	canvas, and the image size adjusted to ensure the whole input image is
				2870	made visible in the output image on the virtual canvas. </td>
				2871
				2872	</tr>
				2873
				2874	<tr>
				2875	<td>DePolar</td>
				2876	<td>
				2877	Uses the same arguments and meanings as a 'Polar' distortion
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2878	but generates the reverse Polar to Cartesian distortion. <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2879
				2880	The special <var>Rmax</var> setting of '0' may however clip
				2881	the corners of the input image. However using the special
				2882	<var>Rmax</var> setting of '-1' (maximum center to corner
				2883	distance) will ensure the whole distorted image is preserved in the
				2884	generated result, so that the same argument to 'Polar' will
				2885	reverse the distortion re-producing the original.
				2886
				2887	Note that as this distortion requires the area resampling of a circular
				2888	arc, which can not be handled by the builtin EWA resampling function.
				2889	As such the normal EWA filters are turned off. It is recommended some
				2890	form of 'super-sampling' image processing technique be used to produce
				2891	a high quality result. </td>
				2892
				2893	</tr>
				2894
				2895	<tr>
				2896	<td>Barrel</td>
				2897	<td>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2898	Given the four coefficients (A,B,C,D) as defined by <a
				2899	href="http://wiki.panotools.org/Lens_correction_model" >Helmut
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2900	Dersch</a>, perform a barrel or pin-cushion distortion appropriate to
				2901	correct radial lens distortions. That is in photographs, make straight
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2902	lines straight again. <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2903
				2904	<p class="text-center">Arguments: <var>A B C</var> [ <var>D</var> [
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2905	<var>X</var> , <var>Y</var> ] ] <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2906	or <var>A<sub>x</sub> B<sub>x</sub> C<sub>x</sub> D<sub>x</sub>
				2907	A<sub>y</sub> B<sub>y</sub> C<sub>y</sub> D<sub>y</sub></var>
				2908	[ <var>X</var> , <var>Y</var> ] </p>
				2909	So that it forms the function
				2910	<p class="text-center">Rsrc = r * ( <var>A</var>r<sup>3</sup> + <var>B</var>r<sup>2</sup> +
				2911	<var>C</var>*r + <var>D</var> )</p>
				2912
				2913	Where <var>X</var>,<var>Y</var> is the optional center of the distortion
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2914	(defaulting to the center of the image). <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2915	The second form is typically used to distort images, rather than
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2916	correct lens distortions. <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2917	</td>
				2918
				2919	</tr>
				2920
				2921	<tr>
				2922	<td>BarrelInverse</td>
				2923	<td>
				2924	This is very similar to 'Barrel' with the same set of
				2925	arguments, and argument handling. However it uses the inverse
				2926	of the radial polynomial,
				2927	so that it forms the function
				2928	<p class="text-center">Rsrc = r / ( <var>A</var>r<sup>3</sup> + <var>B</var>r<sup>2</sup> +
				2929	<var>C</var>*r + <var>D</var> )</p>
				2930	Note that this is not the reverse of the 'Barrel'
				2931	distortion, just a different barrel-like radial distortion method.
				2932
				2933	</td>
				2934	</tr>
				2935
				2936	<tr>
				2937	<td>Shepards</td>
				2938	<td>
				2939	Distort the given list control points (any number) using an Inverse
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2940	Squared Distance Interpolation Method (<a
				2941	href="http://en.wikipedia.org/wiki/Shepard%27s_method" >Shepards
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2942	Method</a>). The control points in effect do 'localized' displacement
				2943	of the image around the given control point (preserving the look and
				2944	the rotation of the area near the control points. For best results
				2945	extra control points should be added to 'lock' the positions of the
				2946	corners, edges and other unchanging parts of the image, to prevent
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2947	their movement. <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2948
				2949	The distortion has been likened to 'taffy pulling' using nails, or
				2950	pins' stuck in a block of 'jelly' which is then moved to the new
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2951	position, distorting the surface of the jelly. <br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2952
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	2953	Internally it is equivalent to generating a displacement map (see <a
				2954	href="command-line-options.html#displace" >-displace</a>) for source image color look-up using
				2955	the <a href="command-line-options.html#sparse-color" >-sparse-color</a> method of the same name.
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	2956
				2957	</td>
				2958	</tr>
				2959
				2960	</table>
				2961
				2962	<p>To print a complete list of distortion methods, use <a href="command-line-options.html#list">-list
				2963	distort</a>.</p>
				2964
				2965	<p>Many of the above distortion methods such as '<code>Affine</code>',
				2966	'<code>Perspective</code>', and '<code>Shepards</code>' use a list control points
				2967	defining how these points in the given image should be distorted in the
				2968	destination image. Each set of four floating point values represent a source
				2969	image coordinate, followed immediately by the destination image coordinate.
				2970	This produces a list of values such as...</p>
				2971	<p class="text-center"><var>
				2972	U<sub>1</sub>,V<sub>1</sub> X<sub>1</sub>,Y<sub>1</sub>
				2973	U<sub>2</sub>,V<sub>2</sub> X<sub>2</sub>,Y<sub>2</sub>
				2974	U<sub>3</sub>,V<sub>3</sub> X<sub>3</sub>,Y<sub>3</sub>
				2975	...
				2976	U<sub>n</sub>,V<sub>n</sub> X<sub>n</sub>,Y<sub>n</sub>
				2977	</var></p>
				2978	<p>where <var>U,V</var> on the source image is mapped to <var>X,Y</var> on the
				2979	destination image. </p>
				2980
				2981	<p>For example, to warp an image using '<code>perspective</code>' distortion,
				2982	needs a list of at least 4 sets of coordinates, or 16 numbers. Here is the
				2983	perspective distortion of the built-in "rose:" image. Note how spaces were
				2984	used to group the 4 sets of coordinate pairs, to make it easier to read and
				2985	understand.</p>
				2986
				2987	<pre>
				2988	convert rose: -virtual-pixel black \
				2989	-distort Perspective '0,0,0,0 0,45,0,45 69,0,60,10 69,45,60,35' \
				2990	rose_3d_rotated.gif"
				2991	</pre>
				2992
				2993	<p>If more that the required number of coordinate pairs are given for
				2994	a distortion, the distortion method is 'least squares' fitted to produce the
				2995	best result for all the coordinate pairs given. If less than the ideal number
				2996	of points are given, the distort will generally fall back to a simpler form of
				2997	distortion that can handles the smaller number of coordinates (usually a linear
				2998	'<code>Affine</code>' distortion). </p>
				2999
				3000	<p>By using more coordinates you can make use of image registration tool to
				3001	find matching coordinate pairs in overlapping images, so as to improve the
				3002	'fit' of the distortion. Of course a bad coordinate pair can also make the
				3003	'fit' worse. Caution is always advised. </p>
				3004
				3005	<p>Colors are acquired from the source image according to a cylindrical
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3006	resampling <a href="command-line-options.html#filter" >-filter</a>, using a special technique known as
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3007	EWA resampling. This produces very high quality results, especially when
				3008	images become smaller (minified) in the output, which is very common when
				3009	using '<code>perspective</code>' distortion. For example here we view
				3010	a infinitely tiled 'plane' all the way to the horizon. </p>
				3011
				3012	<pre>
				3013	convert -size 90x90 pattern:checkerboard -normalize -virtual-pixel tile \
				3014	-distort perspective '0,0,5,45 89,0,45,46 0,89,0,89 89,89,89,89' \
				3015	checks_tiled.jpg
				3016	</pre>
				3017
				3018	<p>Note that a infinitely tiled perspective images involving the horizon can
				3019	be very slow, because of the number of pixels that are compressed to generate
				3020	each individual pixel close to the 'horizon'. You can turn off EWA
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3021	resampling, by specifying the special <a href="command-line-options.html#filter" >-filter</a> setting of
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3022	'<code>point</code>' (recommended if you plan to use super-sampling instead).
				3023	</p>
				3024
				3025	<p>If an image generates <i>invalid pixels</i>, such as the 'sky' in the last
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3026	example, <a href="command-line-options.html#distort" >-distort</a> will use the current <a
Cristy	f650f4f	2016-04-01 10:53:07 -0400	[diff] [blame]	3027	href="command-line-options.html#alpha-color" >-alpha-color</a> setting for these pixels. If you do not
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3028	what these pixels to be visible, set the color to match the rest of the
				3029	ground. </p>
				3030
				3031	<p>The output image size will by default be the same as the input image. This
				3032	means that if the part of the distorted image falls outside the viewed area of
				3033	the 'distorted space', those parts is clipped and lost. However if you use
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3034	the plus form of the operator (<a href="command-line-options.html#distort" >+distort</a>) the operator
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3035	will attempt (if possible) to show the whole of the distorted image, while
				3036	retaining a correct 'virtual canvas' offset, for image layering. This offset
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3037	may need to be removed using <a href="command-line-options.html#repage" >+repage</a>, to remove if it
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3038	is unwanted. </p>
				3039
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3040	<p>Setting <a href="command-line-options.html#verbose" >-verbose</a> setting, will cause <a
				3041	href="command-line-options.html#distort" >-distort</a> to attempt to output the internal coefficients,
				3042	and the <a href="command-line-options.html#fx" >-fx</a> equivalent to the distortion, for expert study,
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3043	and debugging purposes. This many not be available for all distorts. </p>
				3044
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3045	<p>You can alternatively specify a special "<code><a href="command-line-options.html#define"
				3046	>-define</a> distort:viewport={geometry_string}</code>" setting which will
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3047	specify the size and the offset of the generated 'viewport' image of the
				3048	distorted image space.</p>
				3049
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3050	<p>Setting a "<code><a href="command-line-options.html#define" >-define</a>
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	3051	distort:scale=<var>scale_factor</var></code>" will scale the output image (viewport or
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3052	otherwise) by that factor without changing the viewed contents of the
				3053	distorted image. This can be used either for 'super-sampling' the image for
				3054	a higher quality result, or for panning and zooming around the image (with
				3055	appropriate viewport changes, or post-distort cropping and resizing). </p>
				3056
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3057	<p>Setting "<code><a href="command-line-options.html#define" >-define</a> resample:verbose=1</code>"
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3058	will output the cylindrical filter lookup table created by the EWA (Elliptical
				3059	Weighted Average) resampling algorithm. Note this table uses a squared radius
				3060	lookup value. This is typically only used for debugging EWA resampling. </p>
				3061
				3062
				3063	<div style="margin: auto;">
				3064	<h3 class="magick-header"><a id="distribute-cache"></a>-distribute-cache <var>port</var></h3>
				3065	</div>
				3066
				3067	<p class="magick-description">launch a distributed pixel cache server. </p>
				3068
				3069	<div style="margin: auto;">
				3070	<h3 class="magick-header"><a id="dither"></a>-dither <var>method</var></h3>
				3071	</div>
				3072
				3073	<p class="magick-description">Apply a Riemersma or Floyd-Steinberg error diffusion dither to
				3074	images when general color reduction is applied via an option, or automagically
				3075	when saving to specific formats. This enabled by default.</p>
				3076
				3077	<p>Dithering places two or more colors in neighboring pixels so that to the
				3078	eye a closer approximation of the images original color is reproduced. This
				3079	reduces the number of colors needed to reproduce the image but at the cost of
				3080	a lower level pattern of colors. Error diffusion dithers can use any set of
				3081	colors (generated or user defined) to an image. </p>
				3082
				3083	<p>Dithering is turned on by default, to turn it off use the plus form of the
				3084	setting, <a href="command-line-options.html#dither">+dither</a>. This will also also render PostScript
				3085	without text or graphic aliasing. Disabling dithering often (but not always)
				3086	leads to faster process, a smaller number of colors, but more cartoon like
				3087	image coloring. Generally resulting in 'color banding' effects in areas with
				3088	color gradients. </p>
				3089
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3090	<p>The color reduction operators <a href="command-line-options.html#colors">-colors</a>, <a
				3091	href="command-line-options.html#monochrome">-monochrome</a>, <a href="command-line-options.html#remap ">-remap</a>, and <a
				3092	href="command-line-options.html#posterize">-posterize</a>, apply dithering to images using the reduced
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3093	color set they created. These operators are also used as part of automatic
				3094	color reduction when saving images to formats with limited color support, such
				3095	as <code>GIF:</code>, <code>XBM:</code>, and others, so dithering may also be used
				3096	in these cases. </p>
				3097
				3098	<p>Alternatively you can use <a href="command-line-options.html#random-threshold">-random-threshold</a>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3099	to generate purely random dither. Or use <a
				3100	href="command-line-options.html#ordered-dither">-ordered-dither</a> to apply threshold mapped dither
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3101	patterns, using uniform color maps, rather than specific color maps. </p>
				3102
				3103
				3104	<div style="margin: auto;">
				3105	<h3 class="magick-header"><a id="draw"></a>-draw <var>string</var></h3>
				3106	</div>
				3107
				3108	<p class="magick-description">Annotate an image with one or more graphic primitives.</p>
				3109
				3110	<p>Use this option to annotate or decorate an image with one or more graphic
				3111	primitives. The primitives include shapes, text, transformations, and pixel
				3112	operations.</p>
				3113
				3114	<p>The shape primitives:</p>
				3115
				3116	<dl class="dl-horizontal">
				3117	<dt>point</dt><dd> x,y</dd>
				3118	<dt>line</dt><dd> x0,y0 x1,y1</dd>
				3119	<dt>rectangle</dt><dd> x0,y0 x1,y1</dd>
				3120	<dt>roundRectangle</dt><dd> x0,y0 x1,y1 wc,hc</dd>
				3121	<dt>arc</dt><dd> x0,y0 x1,y1 a0,a1</dd>
				3122	<dt>ellipse</dt><dd> x0,y0 rx,ry a0,a1</dd>
				3123	<dt>circle</dt><dd> x0,y0 x1,y1</dd>
				3124	<dt>polyline</dt><dd> x0,y0 ... xn,yn</dd>
				3125	<dt>polygon</dt><dd> x0,y0 ... xn,yn</dd>
				3126	<dt>bezier</dt><dd> x0,y0 ... xn,yn</dd>
				3127	<dt>path</dt><dd>specification </dd>
				3128	<dt>image</dt><dd> operator x0,y0 w,h filename</dd>
				3129	</dl>
				3130
				3131	<p>The text primitive:</p>
				3132
				3133	<dl class="dl-horizontal">
				3134	<dt>text</dt><dd>x0,y0 string</dd>
				3135	</dl>
				3136	<p>The text gravity primitive:</p>
				3137
				3138	<dl class="dl-horizontal">
				3139	<dt>gravity</dt><dd>NorthWest, North, NorthEast, West, Center, East, SouthWest, South, or SouthEast</dd>
				3140	</dl>
				3141
				3142	<p>The text gravity primitive only affects the placement of text and does not
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3143	interact with the other primitives. It is equivalent to using the <a
				3144	href="command-line-options.html#gravity">-gravity</a> command-line option, except that it is limited in
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3145	scope to the <a href="command-line-options.html#draw">-draw</a> option in which it appears.</p>
				3146
				3147	<p>The transformation primitives:</p>
				3148
				3149	<dl class="dl-horizontal">
				3150	<dt>rotate</dt><dd>degrees</dd>
				3151	<dt>translate</dt><dd>dx,dy</dd>
				3152	<dt>scale</dt><dd>sx,sy</dd>
				3153	<dt>skewX</dt><dd>degrees</dd>
				3154	<dt>skewY</dt><dd>degrees</dd>
				3155	</dl>
				3156
				3157	<p>The pixel operation primitives:</p>
				3158
				3159	<dl class="dl-horizontal">
				3160	<dt>color</dt><dd>x0,y0 method</dd>
				3161	<dt>matte</dt><dd>x0,y0 method</dd>
				3162	</dl>
				3163
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3164	<p>The shape primitives are drawn in the color specified by the preceding <a
				3165	href="command-line-options.html#fill">-fill</a> setting. For unfilled shapes, use <a
				3166	href="command-line-options.html#fill">-fill none</a>. You can optionally control the stroke (the
				3167	"outline" of a shape) with the <a href="command-line-options.html#stroke">-stroke</a> and <a
				3168	href="command-line-options.html#strokewidth">-strokewidth</a> settings.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3169
				3170	<p>A <code>point</code> primitive is specified by a single <var>point</var> in the
				3171	pixel plane, that is, by an ordered pair of integer coordinates,
				3172	<var>x</var>,<var>y</var>. (As it involves only a single pixel, a <code>point</code>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3173	primitive is not affected by <a href="command-line-options.html#stroke">-stroke</a> or <a
				3174	href="command-line-options.html#strokewidth">-strokewidth</a>.)</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3175
				3176	<p>A <code>line</code> primitive requires a start point and end point.</p>
				3177
				3178	<p>A <code>rectangle</code> primitive is specified by the pair of points at the
				3179	upper left and lower right corners.</p>
				3180
				3181	<p>A <code>roundRectangle</code> primitive takes the same corner points as
				3182	a <code>rectangle</code> followed by the width and height of the rounded corners
				3183	to be removed.</p>
				3184
				3185	<p>The <code>circle</code> primitive makes a disk (filled) or circle (unfilled).
				3186	Give the center and any point on the perimeter (boundary).</p>
				3187
				3188	<p>The <code>arc</code> primitive is used to inscribe an elliptical segment in
				3189	to a given rectangle. An <code>arc</code> requires the two corners used for
				3190	<code>rectangle</code> (see above) followed by the start and end angles of the
				3191	arc of the segment segment (e.g. 130,30 200,100 45,90). The start and end
				3192	points produced are then joined with a line segment and the resulting segment
				3193	of an ellipse is filled.</p>
				3194
				3195	<p>Use <code>ellipse</code> to draw a partial (or whole) ellipse. Give the
				3196	center point, the horizontal and vertical "radii" (the <var>semi-axes</var> of
				3197	the ellipse) and start and end angles in degrees (e.g. 100,100 100,150
				3198	0,360).</p>
				3199
				3200	<p>The <code>polyline</code> and <code>polygon</code> primitives require three or
				3201	more points to define their perimeters. A <code>polyline</code> is simply
				3202	a <code>polygon</code> in which the final point is not stroked to the start
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3203	point. When unfilled, this is a <var>polygonal line</var>. If the <a
				3204	href="command-line-options.html#stroke">-stroke</a> setting is <code>none</code> (the default), then
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3205	a <code>polyline</code> is identical to a <code>polygon</code>. </p>
				3206
				3207	<p>A <var>coordinate</var> is a pair of integers separated by a space or
				3208	optional comma. </p>
				3209
				3210	<p>As an example, to define a circle centered at 100,100 that extends to
				3211	150,150 use:</p>
				3212
				3213	<pre>
				3214	-draw 'circle 100,100 150,150'
				3215	</pre>
				3216
				3217	<p>The <code>Bezier</code> primitive creates a spline curve and requires three
				3218	or points to define its shape. The first and last points are the
				3219	<var>knots</var> and these points are attained by the curve, while any
				3220	intermediate coordinates are <var>control points</var>. If two control points
				3221	are specified, the line between each end knot and its sequentially respective
				3222	control point determines the tangent direction of the curve at that end. If
				3223	one control point is specified, the lines from the end knots to the one
				3224	control point determines the tangent directions of the curve at each end. If
				3225	more than two control points are specified, then the additional control points
				3226	act in combination to determine the intermediate shape of the curve. In order
				3227	to draw complex curves, it is highly recommended either to use the
				3228	<code>path</code> primitive or to draw multiple four-point bezier segments with
				3229	the start and end knots of each successive segment repeated. For example:</p>
				3230
				3231	<pre>
				3232	-draw 'bezier 20,50 45,100 45,0 70,50'
				3233	-draw 'bezier 70,50 95,100 95,0 120,50'
				3234	</pre>
				3235
				3236	<p>A <code>path</code> represents an outline of an object, defined in terms of
				3237	moveto (set a new current point), lineto (draw a straight line), curveto (draw
				3238	a Bezier curve), arc (elliptical or circular arc) and closepath (close the
				3239	current shape by drawing a line to the last moveto) elements. Compound paths
				3240	(i.e., a path with subpaths, each consisting of a single moveto followed by
				3241	one or more line or curve operations) are possible to allow effects such as
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3242	<var>donut holes</var> in objects. (See <a
				3243	href="http://www.w3.org/TR/SVG/paths.html">Paths</a>.)</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3244
				3245	<p>Use <code>image</code> to composite an image with another image. Follow the
				3246	image keyword with the composite operator, image location, image size, and
				3247	filename:</p>
				3248
				3249	<pre>
				3250	-draw 'image SrcOver 100,100 225,225 image.jpg'
				3251	</pre>
				3252
				3253	<p>You can use 0,0 for the image size, which means to use the actual
				3254	dimensions found in the image header. Otherwise, it is scaled to the given
Cristy	6549abb	2016-11-10 08:25:55 -0500	[diff] [blame]	3255	dimensions. See <a href="http://www.imagemagick.org/www/compose.html">Alpha Compositing</a> for
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3256	a detailed discussion of alpha composition methods that are available. </p>
				3257
				3258	<p>The "special augmented compose operators" such as "dissolve" that require
				3259	arguments cannot be used at present with the <code>-draw image</code> option.
				3260	</p>
				3261
				3262	<p>Use <code>text</code> to annotate an image with text. Follow the text
				3263	coordinates with a string. If the string has embedded spaces, enclose it in
				3264	single or double quotes.</p>
				3265
				3266	<p>For example, the following annotates the image with <code>Works like
				3267	magick!</code> for an image titled <code>bird.miff</code>. </p>
				3268
				3269	<pre>
				3270	-draw "text 100,100 'Works like magick!' "
				3271	</pre>
				3272
				3273	<p>See the <a href="command-line-options.html#annotate">-annotate</a> option for another convenient way
				3274	to annotate an image with text.</p>
				3275
				3276	<p>The <code>rotate</code> primitive rotates subsequent shape primitives and
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3277	text primitives about the origin of the main image. If the <a
				3278	href="command-line-options.html#region">-region</a> option precedes the <a href="command-line-options.html#draw">-draw</a>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3279	option, the origin for transformations is the upper left corner of the
				3280	region.</p>
				3281
				3282	<p>The <code>translate</code> primitive translates subsequent shape and text
				3283	primitives.</p>
				3284
				3285	<p>The <code>scale</code> primitive scales them.</p>
				3286
				3287	<p>The <code>skewX</code> and <code>skewY</code> primitives skew them with respect
				3288	to the origin of the main image or the region.</p>
				3289
				3290	<p>The transformations modify the current affine matrix, which is initialized
				3291	from the initial affine matrix defined by the <a href="command-line-options.html#affine">-affine</a>
				3292	option. Transformations are cumulative within the <a href="command-line-options.html#draw">-draw</a>
				3293	option. The initial affine matrix is not affected; that matrix is only changed
				3294	by the appearance of another <a href="command-line-options.html#affine">-affine</a> option. If another
				3295	<a href="command-line-options.html#draw">-draw</a> option appears, the current affine matrix is
				3296	reinitialized from the initial affine matrix.</p>
				3297
				3298	<p>Use the <code>color</code> primitive to change the color of a pixel to the
				3299	fill color (see <a href="command-line-options.html#fill">-fill</a>). Follow the pixel coordinate with
				3300	a method:</p>
				3301
				3302	<pre>
				3303	point
				3304	replace
				3305	floodfill
				3306	filltoborder
				3307	reset
				3308	</pre>
				3309
				3310	<p>Consider the target pixel as that specified by your coordinate. The
				3311	<code>point</code> method recolors the target pixel. The <code>replace</code>
				3312	method recolors any pixel that matches the color of the target pixel.
				3313	<code>Floodfill</code> recolors any pixel that matches the color of the target
				3314	pixel and is a neighbor, whereas <code>filltoborder</code> recolors any neighbor
				3315	pixel that is not the border color. Finally, <code>reset</code> recolors all
				3316	pixels.</p>
				3317
				3318	<p>Use <code>matte</code> to the change the pixel matte value to transparent.
				3319	Follow the pixel coordinate with a method (see the <code>color</code> primitive
				3320	for a description of methods). The <code>point</code> method changes the matte
				3321	value of the target pixel. The <code>replace</code> method changes the matte
				3322	value of any pixel that matches the color of the target pixel.
				3323	<code>Floodfill</code> changes the matte value of any pixel that matches the
				3324	color of the target pixel and is a neighbor, whereas <code>filltoborder</code>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3325	changes the matte value of any neighbor pixel that is not the border color (<a
				3326	href="command-line-options.html#bordercolor">-bordercolor</a>). Finally <code>reset</code> changes the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3327	matte value of all pixels.</p>
				3328
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3329	<p>You can set the primitive color, font, and font bounding box color with <a
				3330	href="command-line-options.html#fill">-fill</a>, <a href="command-line-options.html#font">-font</a>, and <a href="command-line-options.html#box">-box</a>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3331	respectively. Options are processed in command line order so be sure to use
				3332	these options <var>before</var> the <a href="command-line-options.html#draw">-draw</a> option.</p>
				3333
				3334	<p>Strings that begin with a number must be quoted (e.g. use '1.png' rather
				3335	than 1.png).</p>
				3336
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3337	<p>Drawing primitives conform to the <a href="magick-vector-graphics.html" >Magick
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3338	Vector Graphics</a> format.</p>
				3339
				3340
				3341	<div style="margin: auto;">
				3342	<h3 class="magick-header"><a id="duplicate"></a>-duplicate <var>count,indexes</var></h3>
				3343	</div>
				3344
				3345	<p class="magick-description">duplicate an image one or more times.</p>
				3346
				3347	<p>Specify the count and the image to duplicate by its index in the sequence.
				3348	The first image is index 0. Negative indexes are relative to the end of the
				3349	sequence, for example, -1 represents the last image of the sequence. Specify
				3350	a range of images with a dash (e.g. 0-4). Separate indexes with a comma (e.g.
				3351	0,2). Use <code>+duplicate</code> to duplicate the last image in the current
				3352	image sequence.</p>
				3353
				3354	<div style="margin: auto;">
				3355	<h3 class="magick-header"><a id="edge"></a>-edge <var>radius</var></h3>
				3356	</div>
				3357
				3358	<p class="magick-description">detect edges within an image.</p>
				3359
				3360	<div style="margin: auto;">
				3361	<h3 class="magick-header"><a id="emboss"></a>-emboss <var>radius</var></h3>
				3362	</div>
				3363
				3364	<p class="magick-description">emboss an image.</p>
				3365
				3366	<div style="margin: auto;">
				3367	<h3 class="magick-header"><a id="encipher"></a>-encipher <var>filename</var></h3>
				3368	</div>
				3369
				3370	<p class="magick-description">Encipher pixels for later deciphering by <a href="command-line-options.html#decipher">-decipher</a>.</p>
				3371
				3372	<p>Get the passphrase from the file specified by <var>filename</var>.</p>
				3373
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3374	<p>For more information, see the webpage, <a
Cristy	6549abb	2016-11-10 08:25:55 -0500	[diff] [blame]	3375	href="https://www.imagemagick.org/script/cipher.html">ImageMagick: Encipher or
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3376	Decipher an Image</a>.</p>
				3377
				3378
				3379
				3380	<div style="margin: auto;">
				3381	<h3 class="magick-header"><a id="encoding"></a>-encoding <var>type</var></h3>
				3382	</div>
				3383
				3384	<p class="magick-description">specify the text encoding.</p>
				3385
				3386	<p>Choose from</p>
				3387
				3388	<pre>
				3389	AdobeCustom AdobeExpert
				3390	AdobeStandard AppleRoman
				3391	BIG5 GB2312
				3392	Latin 2 None
				3393	SJIScode Symbol
				3394	Unicode Wansung
				3395	</pre>
				3396
				3397	<div style="margin: auto;">
				3398	<h3 class="magick-header"><a id="endian"></a>-endian <var>type</var></h3>
				3399	</div>
				3400
				3401	<p class="magick-description">Specify endianness (<code>MSB</code> or <code>LSB</code>) of the image.</p>
				3402
				3403	<p>To print a complete list of endian types, use the <a href="command-line-options.html#list">-list endian</a> option.</p>
				3404
				3405	<p>Use <a href="command-line-options.html#endian">+endian</a> to revert to unspecified endianness.</p>
				3406
				3407
				3408	<div style="margin: auto;">
				3409	<h3 class="magick-header"><a id="enhance"></a>-enhance</h3>
				3410	</div>
				3411
				3412	<p class="magick-description">Apply a digital filter to enhance a noisy image.</p>
				3413
				3414
				3415	<div style="margin: auto;">
				3416	<h3 class="magick-header"><a id="equalize"></a>-equalize</h3>
				3417	</div>
				3418
				3419	<p class="magick-description">perform histogram equalization on the image channel-by-channel.</p>
				3420
				3421	<p>To perform histogram equalization on all channels in concert, transform the
				3422	image into some other color space, such as HSL, OHTA, YIQ or YUV, then
				3423	equalize the appropriate intensity-like channel, then convert back to RGB.</p>
				3424
				3425	<p>For example using HSL, we have: ... <code>-colorspace HSL -channel lightness
				3426	-equalize -colorspace RGB</code> ...</p>
				3427
				3428	<p>For YIQ, YUV and OHTA use the red channel. For example, OHTA is a principal
				3429	components transformation that puts most of the information in the first
				3430	channel. Here we have ... <code>-colorspace OHTA -channel red -equalize
				3431	-colorspace RGB</code> ...</p>
				3432
				3433	<div style="margin: auto;">
				3434	<h3 class="magick-header"><a id="evaluate"></a>-evaluate <var>operator value</var></h3>
				3435	</div>
				3436
				3437	<p class="magick-description">Alter channel pixels by evaluating an arithmetic, relational, or logical expression.</p>
				3438
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3439	<p>(See the <a href="command-line-options.html#function" >-function</a> operator for some
				3440	multi-parameter functions. See the <a href="command-line-options.html#fx" >-fx</a> operator if more
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3441	elaborate calculations are needed.)</p>
				3442
				3443	<p>The behaviors of each <var>operator</var> are summarized in the
				3444	following list. For brevity, the numerical value of a "pixel" referred to
				3445	below is the value of the corresponding channel of that pixel, while
				3446	a "normalized pixel" is that number divided by the maximum
				3447	(installation-dependent) value <var>QuantumRange</var>. (If
				3448	normalized pixels are used, they are restored, following the other
				3449	calculations, to the full range by multiplying by <var>QuantumRange</var>.)</p>
				3450
				3451	<table class="table table-condensed table-striped">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3452	<col width="25%" />
				3453	<col width="75%" />
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3454	<thead>
				3455	<tr>
				3456	<th><var>operator</var></th>
				3457	<th>Summary (see further below for details)</th>
				3458	</tr>
				3459	</thead>
				3460	<tbody>
				3461
				3462	<tr><td>Abs </td> <td>Add <var>value</var> to pixels and return absolute value. </td></tr>
				3463	<tr><td>Add </td> <td>Add <var>value</var> to pixels. </td></tr>
				3464	<tr><td>AddModulus </td> <td>Add <var>value</var> to pixels modulo <var>QuantumRange</var>.</td></tr>
				3465	<tr><td>And </td> <td>Binary AND of pixels with <var>value</var>.</td></tr>
				3466	<tr><td>Cos, Cosine </td> <td>Apply cosine to pixels with frequency <var>value</var> with 50% bias added.</td></tr>
				3467	<tr><td>Divide </td> <td>Divide pixels by <var>value</var>.</td></tr>
				3468	<tr><td>Exp </td> <td>base-e exponential function</td></tr>
				3469	<tr><td>Exponential </td> <td>base-e exponential function</td></tr>
				3470	<tr><td>LeftShift </td> <td>Shift the pixel values left by <var>value</var> bits (i.e., multiply pixels by 2<sup><var>value</var></sup>).</td></tr>
				3471	<tr><td>Log </td> <td>Apply scaled logarithm to normalized pixels.</td></tr>
				3472	<tr><td>Max </td> <td>Set pixels to maximum of <var>value</var> and current pixel <var>value</var> (i.e. set any pixels currently less than <var>value</var> to <var>value</var>).</td></tr>
				3473	<tr><td>Mean </td> <td>Add the <var>value</var> and divide by 2.</td></tr>
				3474	<tr><td>Median </td> <td>Choose the median value from an image sequence.</td></tr>
				3475	<tr><td>Min </td> <td>Set pixels to minimum of <var>value</var> and current pixel <var>value</var> (i.e. set any pixels currently greater than <var>value</var> to <var>value</var>).</td></tr>
				3476	<tr><td>Multiply </td> <td>Multiply pixels by <var>value</var>.</td></tr>
				3477	<tr><td>Or </td> <td>Binary OR of pixels with <var>value</var>.</td></tr>
				3478	<tr><td>Pow </td> <td>Raise normalized pixels to the power <var>value</var>.</td></tr>
				3479	<tr><td>RightShift </td> <td>Shift the pixel values right by <var>value</var> bits (i.e., divide pixels by 2<sup><var>value</var></sup>).</td></tr>
				3480	<tr><td>RMS</td> <td>Square the pixel and add the <var>value</var>.</td></tr>
				3481	<tr><td>RootMeanSquare</td> <td>Square the pixel and add the <var>value</var>.</td></tr>
				3482	<tr><td>Set </td> <td>Set pixel equal to <var>value</var>.</td></tr>
				3483	<tr><td>Sin, Sine </td> <td>Apply sine to pixels with frequency <var>value</var> with 50% bias added.</td></tr>
				3484	<tr><td>Subtract </td> <td>Subtract <var>value</var> from pixels.</td></tr>
				3485	<tr><td>Xor </td> <td>Binary XOR of pixels with <var>value.</var></td></tr>
				3486
				3487	<tr><td> </td><td> </td></tr>
				3488
				3489	<tr><td>Gaussian-noise</td><td> </td></tr>
				3490	<tr><td>Impulse-noise</td><td> </td></tr>
				3491	<tr><td>Laplacian-noise</td><td> </td></tr>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3492	<tr><td>Multiplicative-noise</td> <td>(These are equivalent to the corresponding <a href="command-line-options.html#noise" >-noise</a> operators.)</td></tr>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3493	<tr><td>PoissonNoise</td><td> </td></tr>
				3494	<tr><td>Uniform-noise</td><td> </td></tr>
				3495
				3496	<tr><td> </td><td> </td></tr>
				3497
				3498	<tr><td>Threshold </td> <td>Threshold pixels larger than <var>value</var>.</td></tr>
				3499	<tr><td>ThresholdBlack </td> <td>Threshold pixels to zero values equal to or below <var>value</var>.</td></tr>
				3500	<tr><td>ThresholdWhite </td> <td>Threshold pixels to maximum values above <var>value</var>. </td></tr>
				3501	</tbody>
				3502	</table>
				3503
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3504	<p>The specified functions are applied only to each previously set <a
				3505	href="command-line-options.html#channel" >-channel</a> in the image. If necessary, the results of the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3506	calculations are truncated (clipped) to fit in the interval [0, <var>QuantumRange</var>]. The transparency channel of the image is
				3507	represented as a 'alpha' values (0 = fully transparent), so, for example, a
				3508	<code>Divide</code> by 2 of the alpha channel will make the image
				3509	semi-transparent. Append the percent symbol '<code>%</code>' to specify a value
				3510	as a percentage of the <var>QuantumRange</var>.</p>
				3511
				3512	<p>To print a complete list of <a href="command-line-options.html#evaluate">-evaluate</a> operators, use
				3513	<a href="command-line-options.html#list">-list evaluate</a>.</p>
				3514
				3515	<p>The results of the <code>Add</code>, <code>Subtract</code> and
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3516	<code>Multiply</code> methods can also be achieved using either the <a
				3517	href="command-line-options.html#level" >-level</a> or the <a href="command-line-options.html#level" >+level</a> operator, with
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3518	appropriate argument, to linearly modify the overall range of color values.
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3519	Please note, however, that <a href="command-line-options.html#level" >-level</a> treats transparency as
				3520	'matte' values (0 = opaque), while <a href="command-line-options.html#level" >-evaluate</a> works with
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3521	'alpha' values.</p>
				3522
				3523	<p><code>AddModulus</code> has been added as of ImageMagick 6.4.8-4 and provides
				3524	addition modulo the <var>QuantumRange</var>. It is therefore
				3525	equivalent to <code>Add</code> unless the resulting pixel value is outside the
				3526	interval [0, <var>QuantumRange</var>]. </p>
				3527
				3528	<p><code>Exp or Exponential</code> has been added as of ImageMagick 6.6.5-1 and
				3529	works on normalized pixel values. The <var>value</var> used with
				3530	<code>Exp</code> should be negative so as to produce a decaying exponential
				3531	function. Non-negative values will always produce results larger unity and
				3532	thus outside the interval [0, <var>QuantumRange</var>]. The
				3533	formula is expressed below. </p>
				3534
				3535	<p class="text-center">
				3536	exp(<var>value</var> × <b><var>u</var></b>)
				3537	</p>
				3538
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3539	<p> If the input image is squared, for example, using <a href="command-line-options.html#-function"
				3540	>-function polynomial "2 0 0"</a>, then a decaying Gaussian function will be
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3541	the result.</p>
				3542
				3543	<p><code>Log</code> has been added as of ImageMagick 6.4.2-1 and works on
				3544	normalized pixel values. This a <var>scaled</var> log function. The <var>value</var> used with <code>Log</code> provides a <var>scaling
				3545	factor</var> that adjusts the curvature in the graph of the log function. The
				3546	formula applied to a normalized value <b><var>u</var></b> is below. </p>
				3547
				3548	<p class="text-center">
				3549	log(<var>value</var> × <b><var>u</var></b> + 1) / log(<var>value</var> + 1)
				3550	</p>
				3551
				3552	<p><code>Pow</code> has been added as of ImageMagick 6.4.1-9, and works on
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3553	normalized pixel values. Note that <code>Pow</code> is related to the <a
				3554	href="command-line-options.html#gamma" >-gamma</a> operator. For example, <b>-gamma 2</b> is equivalent
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3555	to <b>-evaluate pow 0.5</b>, i.e., a 'square root' function. The value used
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3556	with <a href="command-line-options.html#gamma" >-gamma</a> is simply the reciprocal of the value used
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3557	with <code>Pow</code>.</p>
				3558
				3559	<p><code>Cosine</code> and <code>Sine</code> was added as of IM v6.4.8-8 and
				3560	converts the image values into a value according to a (co)sine wave function.
				3561	The synonyms <code>Cos</code> and <code>Sin</code> may also be used. The output
				3562	is biased 50% and normalized by 50% so as to fit in the respective color value
				3563	range. The <var>value</var> scaling of the <var>period</var> of the
				3564	function (its frequency), and thus determines the number of 'waves' that will
				3565	be generated over the input color range. For example, if the <var>value</var> is 1, the effective period is simply the <var>QuantumRange</var>; but if the <var>value</var> is 2,
				3566	then the effective period is the <var>half</var> the <var>QuantumRange</var>.</p>
				3567
				3568	<p class="text-center">
				3569	0.5 + 0.5 × cos(2 π <b><var>u</var></b> × <var>value</var>).
				3570	</p>
				3571
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3572	<p>See also the <a href="command-line-options.html#function" >-function</a> operator, which is a
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3573	multi-value version of evaluate. </p>
				3574
				3575	<div style="margin: auto;">
				3576	<h3 class="magick-header"><a id="evaluate-sequence"></a>-evaluate-sequence <var>operator</var></h3>
				3577	</div>
				3578
				3579	<p class="magick-description">Alter channel pixels by evaluating an arithmetic, relational, or
				3580	logical expression over a sequence of images.</p>
				3581
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3582	<p>To print a complete list of <a
				3583	href="command-line-options.html#evaluate-sequence">-evaluate-sequence</a> operators, use <a
				3584	href="command-line-options.html#list">-list evaluate</a>.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3585
				3586	<div style="margin: auto;">
				3587	<h3 class="magick-header"><a id="extent"></a>-extent <var>geometry</var></h3>
				3588	</div>
				3589
				3590	<p class="magick-description">Set the image size and offset.</p>
				3591
				3592	<p>If the image is enlarged, unfilled areas are set to the background color.
				3593	To position the image, use offsets in the <var>geometry</var>
				3594	specification or precede with a <a href="command-line-options.html#gravity">-gravity</a> setting. To
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3595	specify how to compose the image with the background, use <a href="command-line-options.html#compose"
				3596	>-compose</a>.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3597
				3598	<p>This command reduces or expands a JPEG image to fit on an 800x600
				3599	display. If the aspect ratio of the input image isn't exactly 4:3, then the
				3600	image is centered on an 800x600 black canvas: </p>
				3601
				3602	<pre>
				3603	convert input.jpg -resize 800x600 -background black -compose Copy \
				3604	-gravity center -extent 800x600 -quality 92 output.jpg
				3605	</pre>
				3606
				3607	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
				3608
				3609	<div style="margin: auto;">
				3610	<h3 class="magick-header"><a id="extract"></a>-extract <var>geometry</var></h3>
				3611	</div>
				3612
				3613	<p class="magick-description">Extract the specified area from image.</p>
				3614
				3615	<p>This option is most useful for extracting a subregion of a very large raw
				3616	image. Note that these two commands are equivalent:</p>
				3617
				3618	<pre>
				3619	convert -size 16000x16000 -depth 8 -extract 640x480+1280+960 \
				3620	image.rgb image.png",
				3621	convert -size 16000x16000 -depth 8 'image.rgb[640x480+1280+960]' \
				3622	image.rgb image.png"
				3623	</pre>
				3624
				3625	<p>If you omit the offsets, as in</p>
				3626
				3627	<pre>
				3628	convert -size 16000x16000 -depth 8 -extract 640x480 \
				3629	image.rgb image.png
				3630	</pre>
				3631
				3632	<p>the image is <var>resized</var> to the specified dimensions instead,
				3633	equivalent to:</p>
				3634
				3635	<pre>
				3636	convert -size 16000x16000 -depth 8 -resize 640x480 image.rgb image.png
				3637	</pre>
				3638
				3639	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
				3640
				3641	<div style="margin: auto;">
				3642	<h3 class="magick-header"><a id="family"></a>-family <var>fontFamily</var></h3>
				3643	</div>
				3644
				3645	<p class="magick-description">Set a font family for text.</p>
				3646
				3647	<p>This setting suggests a font family that ImageMagick should try to use for
				3648	rendering text. If the family can be found it is used; if not, a default font
				3649	(e.g., "Arial") or a family known to be similar is substituted (e.g.,
				3650	"Courier" might be used if "System" is requested but not found). </p>
				3651
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3652	<p>For other settings that affect fonts, see the options <a
				3653	href="command-line-options.html#font">-font</a>, <a href="command-line-options.html#stretch">-stretch</a>, <a
				3654	href="command-line-options.html#style">-style</a>, and <a href="command-line-options.html#weight">-weight</a>. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3655
				3656	<div style="margin: auto;">
				3657	<h3 class="magick-header"><a id="features"></a>-features <var>distance</var></h3>
				3658	</div>
				3659
				3660	<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>
				3661
				3662	<pre>
				3663	Angular Second Moment Sum Entropy
				3664	Contrast Entropy
				3665	Correlation Difference Variance
				3666	Sum of Squares Variance Difference Entropy
				3667	Inverse Difference Moment Information Measure of Correlation 1
				3668	Sum Average Information Measure of Correlation 2
				3669	Sum Variance Maximum Correlation Coefficient
				3670	</pre>
				3671
				3672	<div style="margin: auto;">
				3673	<h3 class="magick-header"><a id="fft"></a>-fft</h3>
				3674	</div>
				3675
				3676	<p class="magick-description">implements the forward discrete Fourier transform (DFT).</p>
				3677
				3678	<p>This option is new as of ImageMagick 6.5.4-3 (and now working for Windows
				3679	users in ImageMagick 6.6.0-9). It transforms an image from the normal
				3680	(spatial) domain to the frequency domain. In the frequency domain, an image is
				3681	represented as a superposition of complex sinusoidal waves of varying
				3682	amplitudes. The image x and y coordinates are the possible frequencies along
				3683	the x and y directions, respectively, and the pixel intensity values are
				3684	complex numbers that correspond to the sinusoidal wave amplitudes. See for
				3685	example, <a href="http://en.wikipedia.org/wiki/Fourier_transform">Fourier
				3686	Transform</a>, <a href="http://en.wikipedia.org/wiki/DFT">Discrete Fourier
				3687	Transform</a> and <a href="http://en.wikipedia.org/wiki/FFT">Fast Fourier
				3688	Transform</a>.</p>
				3689
				3690	<p>A single image name is provided as output for this option. However, the
				3691	output result will have two components. It is either a two-frame image or two
				3692	separate images, depending upon whether the image format specified supports
				3693	multi-frame images. The reason that we get a dual output result is because the
				3694	frequency domain represents an image using complex numbers, which cannot be
				3695	visualized directly. Therefore, the complex values are automagically separated
				3696	into a two-component image representation. The first component is the
				3697	magnitude of the complex number and the second is the phase of the complex
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3698	number. See for example, <a
				3699	href="http://en.wikipedia.org/wiki/Complex_numbers">Complex Numbers</a>.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3700
				3701	<p>The magnitude and phase component images must be specified using image
				3702	formats that do not limit the color or compress the image. Thus, MIFF, TIF,
				3703	PFM, EXR and PNG are the recommended image formats to use. All of these
				3704	formats, except PNG support multi-frame images. So for example,</p>
				3705
				3706	<pre>
				3707	convert image.png -fft fft_image.miff
				3708	</pre>
				3709
				3710	<p>generates a magnitude image as <code>fft_image.miff[0]</code> and a phase
				3711	image as <code>fft_image.miff[1]</code>. Similarly,</p>
				3712
				3713	<pre>
				3714	convert image.png -fft fft_image.png
				3715	</pre>
				3716
				3717	<p>generates a magnitude image as <code>fft_image-0.png</code> and a phase image
				3718	as <code>fft_image-1.png</code>. If you prefer this representation, then you can
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3719	force any of the other formats to produce two output images by including <a
				3720	href="command-line-options.html#adjoin">+adjoin</a> following -fft in the command line.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3721
				3722	<p>The input image can be any size, but if not square and even-dimensioned, it
				3723	is padded automagically to the larger of the width or height of the input
				3724	image and to an even number of pixels. The padding will occur at the bottom
				3725	and/or right sides of the input image. The resulting output magnitude and
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3726	phase images is square at this size. The kind of padding relies on the <a
				3727	href="command-line-options.html#virtual-pixel">-virtual-pixel</a> setting.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3728
				3729	<p>Both output components will have dynamic ranges that fit within
				3730	[0, <var>QuantumRange</var>], so that HDRI need not be enabled.
				3731	Phase values nominally range from 0 to 2*π, but is scaled to span the full
				3732	dynamic range. (The first few releases had non-HDRI scaled but HDRI not
				3733	scaled). The magnitude image is not scaled and thus generally will contain
				3734	very small values. As such, the image normally will appear totally black. In
				3735	order to view any detail, the magnitude image typically is enhanced with a log
				3736	function into what is usually called the spectrum. A log function is used to
				3737	enhance the darker values more in comparison to the lighter values. This can
				3738	be done, for example, as follows:</p>
				3739
				3740	<pre>
				3741	convert fft_image.miff[0] -contrast-stretch 0 \
				3742	-evaluate log 1000 fft_image_spectrum.png"
				3743	</pre>
				3744
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3745	<p>where either <a href="command-line-options.html#contrast-stretch">-contrast-stretch</a> 0 or <a
				3746	href="command-line-options.html#auto-level">-auto-level</a> is used to scale the image to full dynamic
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3747	range, first. The argument to the <a href="command-line-options.html#evaluate">-evaluate</a> log
				3748	typically is specified between 100 and 10,000, depending upon the amount of
				3749	detail that one wants to bring out in the spectrum. Larger values produce more
				3750	visible detail. Too much detail, however, may hide the important features.</p>
				3751
				3752	<p>The <a href="http://www.fftw.org/">FFTW</a> delegate library is required to
				3753	use <a href="command-line-options.html#fft">-fft</a>.</p>
				3754
				3755	<p>Use <a href="command-line-options.html#fft">+fft</a> to produce two output images that are the real
				3756	and imaginary components of the complex valued Fourier transform.</p>
				3757
				3758	<p>However, as the real and imaginary components can contain negative values,
				3759	this requires that IM be configured with HDRI enabled. In this case, you must
				3760	use either MIFF, TIF, PFM or MPC formats for the real and imaginary component
				3761	results, since they are formats that preserve both negative and fractional
				3762	values without clipping them or truncating the fractional part. With either
				3763	MIFF or TIF, one should add -define quantum:format=32, to allow those image
				3764	types to work properly in HDRI mode without clipping.</p>
				3765
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3766	<p>The real and imaginary component images resulting from <a
				3767	href="command-line-options.html#fft">+fft</a> are also square, even dimensioned images due to the same
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3768	padding that was discussed above for the magnitude and phase component
				3769	images.</p>
				3770
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3771	<p>See the discussion on HDRI implementations of ImageMagick on the page <a
				3772	href="high-dynamic-range.html" >High Dynamic-Range Images</a>. For more
				3773	about HDRI go the ImageMagick <a
Cristy	364a72f	2016-11-04 22:38:41 -0400	[diff] [blame]	3774	href="https://www.imagemagick.org/Usage/basics/#hdri" >Usage</a> pages, <a
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3775	href="http://www.fmwconcepts.com/imagemagick/fourier_transforms/fourier.html"
				3776	>Fred's Fourier Processing With ImageMagick page</a> or this <a
				3777	href="http://en.wikipedia.org/wiki/High_dynamic_range_imaging" >Wikipedia</a>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3778	entry. </p>
				3779
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3780	<p>By default the FFT is normalized (and the IFT is not). Use "<code><a href="command-line-options.html#define" >-define</a> fourier:normalize=forward</code> to explicitly normalize the FFT and unnormalize the IFT.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3781
				3782
				3783	<div style="margin: auto;">
				3784	<h3 class="magick-header"><a id="fill"></a>-fill <var>color</var></h3>
				3785	</div>
				3786
				3787	<p class="magick-description">color to use when filling a graphic primitive.</p>
				3788
				3789	<p>This option accepts a color name, a hex color, or a numerical RGB, RGBA,
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3790	HSL, HSLA, CMYK, or CMYKA specification. See <a href="color.html" >Color Names</a> for
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3791	a description of how to properly specify the color argument.</p>
				3792
				3793	<p>Enclose the color specification in quotation marks to prevent the "#" or
				3794	the parentheses from being interpreted by your shell.</p>
				3795
				3796	<p>For example,</p>
				3797
				3798	<pre>
				3799	-fill blue
				3800	-fill "#ddddff"
				3801	-fill "rgb(255,255,255)"
				3802	</pre>
				3803
				3804	<p>See <a href="command-line-options.html#draw">-draw</a> for further details.</p>
				3805
				3806	<p>To print a complete list of color names, use the <a href="command-line-options.html#list">-list color</a> option.</p>
				3807
				3808	<div style="margin: auto;">
				3809	<h3 class="magick-header"><a id="filter"></a>-filter <var>type</var></h3>
				3810	</div>
				3811
				3812	<p class="magick-description">Use this <var>type</var> of filter when resizing or distorting an image.</p>
				3813
				3814	<p>Use this option to affect the resizing operation of an image during
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3815	operations such as <a href="command-line-options.html#resize">-resize</a> and <a href="command-line-options.html#distort"
				3816	>-distort</a>. For example you can use a simple resize filter such as:</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3817
				3818	<pre>
				3819	Point Hermite Cubic
				3820	Box Gaussian Catrom
				3821	Triangle Quadratic Mitchell
				3822	</pre>
				3823
				3824	<p>The <code>Bessel</code> and <code>Sinc</code> filter is also provided (as well
				3825	as a faster <code>SincFast</code> equivalent form). However these filters are
				3826	generally useless on their own as they are infinite filters that are being
				3827	clipped to the filters support size. Their direct use is not recommended
				3828	except via expert settings (see below). </p>
				3829
				3830	<p>Instead these special filter functions are typically windowed by a windowing
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3831	function that the <a href="command-line-options.html#filter" >-filter</a> setting defines. That is
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3832	using these functions will define a 'Windowed' filter, appropriate to the
				3833	operator involved. Windowed filters include: </p>
				3834
				3835	<pre>
				3836	Lanczos Hamming Parzen
				3837	Blackman Kaiser Welsh
				3838	Hanning Bartlett Bohman
				3839	</pre>
				3840
				3841	<p>Also one special self-windowing filter is also provided
				3842	<code>Lagrange</code>, which will automagically re-adjust its function depending
				3843	on the current 'support' or 'lobes' expert settings (see below).</p>
				3844
				3845	<p>If you do not select a filter with this option, the filter defaults to
				3846	<code>Mitchell</code> for a colormapped image, an image with a matte channel, or
				3847	if the image is enlarged. Otherwise the filter default to
				3848	<code>Lanczos</code>.</p>
				3849
				3850	<p>To print a complete list of resize filters, use the <a href="command-line-options.html#list">-list
				3851	filter</a> option.</p>
				3852
				3853	<p>You can modify how the filter behaves as it scales your image through the
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3854	use of these expert settings (see also <a href="command-line-options.html#define" >-define</a> and <a
				3855	href="command-line-options.html#set" >-set</a>):-</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3856
				3857	<table class="table table-condensed table-striped">
				3858	<tr>
				3859	<td>-define filter:blur=<var>factor</var></td>
				3860	<td>Scale the X axis of the filter (and its window). Use > 1.0 for
				3861	blurry or < 1.0 for sharp. This should only be used with Gaussian and
				3862	Gaussian-like filters simple filters, or you may not get the expected
				3863	results. </td>
				3864	</tr>
				3865
				3866	<tr>
				3867	<td>-define filter:support=<var>radius</var></td>
				3868	<td>Set the filter support radius. Defines how large the filter should be and
				3869	thus directly defines how slow the filtered resampling process is. All
				3870	filters have a default 'preferred' support size. Some filters like
				3871	<code>Lagrange</code> and windowed filters adjust themselves depending on
				3872	this value. With simple filters this value either does nothing (but slow
				3873	the resampling), or will clip the filter function in a detrimental way.
				3874	</td>
				3875	</tr>
				3876
				3877	<tr>
				3878	<td>-define filter:lobes=<var>count</var></td>
				3879	<td>Set the number of lobes to use for the Sinc/Bessel filter. This an
				3880	alternative way of specifying the 'support' range of the filter, that is
				3881	designed to be more suited to windowed filters, especially when used for
				3882	image distorts.</td>
				3883	</tr>
				3884
				3885	<tr>
				3886	<td>-define filter:sigma=<var>value</var></td>
				3887	<td>The 'sigma' value used to define the <code>Gaussian</code> filter. Default
				3888	sigma value is '<code>0.5</code>'. It only effects <code>Gaussian</code> but
				3889	does not shrink (but may enlarge) the filter's 'support'. It can be used
				3890	to generate very small blurs but without the filter 'missing' pixels due
				3891	to using a small support setting. A larger value of '<code>0.707</code>'
				3892	(a value of '1/sqrt(2)') is another common setting. </td>
				3893	</tr>
				3894
				3895	<tr>
				3896	<td>-define filter:b=<var>b-spline_factor</var></td>
Cristy	579a0cb	2016-11-26 12:27:17 -0500	[diff] [blame^]	3897	</tr>
				3898
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3899	<tr>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3900	<td>-define filter:c=<var>keys_alpha_factor</var></td>
				3901	<td>Redefine the values used for cubic filters such as <code>Cubic</code>,
				3902	<code>Catrom</code>, <code>Mitchel</code>, and <code>Hermite</code>, as well as
				3903	the <code>Parzen</code> cubic windowing function. If only one of the values
				3904	are defined, the other is set so as to generate a 'Cubic-Keys' filter.
				3905	The values meaning was defined by a research paper by
				3906	Mitchell-Netravali.</td>
				3907	</tr>
				3908
				3909	<tr>
				3910	<td>-define filter:kaiser-beta=<var>value</var></td>
				3911	<td>The 'alpha' value used to as part of the Kaiser Windowing function.
				3912	Default value is '6.5'. It only effects Kaiser windowing function, and
				3913	does not effect any other attributes.
				3914	Before ImageMagick v6.7.6-10, this option was known as "filter:alpha", (an
				3915	inheritance from the very old "zoom" program). It was changed to bring the
				3916	function in line with more modern academic research usage, and better
				3917	assign it be more definitive. </td>
				3918	</tr>
				3919
				3920	<tr>
				3921	<td>-define filter:kaiser-alpha=<var>value</var></td>
				3922	<td>This value when multiplied by 'PI' is equivalent to "kaiser-beta", and
				3923	will override that setting. It only effects Kaiser windowing function,
				3924	and does not effect any other attributes. </td>
				3925	</tr>
				3926
				3927	<tr>
				3928	<td>-define filter:filter=<var>filter_function</var></td>
				3929	<td>Use this function directly as the weighting filter. This will allow
				3930	you to directly use a windowing function such as <code>Blackman</code>,
				3931	as a resampling filter, rather than as its normal usage as a windowing
				3932	function. If defined, no windowing function also defined, the window function is set
				3933	to <code>Box</code>). Directly specifying <code>Sinc</code> or <code>Jinc</code>
				3934	as a filter will also do this. </td>
				3935	</tr>
				3936
				3937	<tr>
				3938	<td>-define filter:window=<var>filter_function</var></td>
				3939	<td>The IIR (infinite impulse response) filters <code>Sinc</code> and
				3940	<code>Jinc</code> are windowed (brought down to zero over the defined
				3941	support range) with the given filter. This allows you to specify a filter
				3942	function to be used as a windowing function for these IIR filters.
				3943	Many of the defined filters are actually windowing functions for these IIR
				3944	filters. A typical choices is <code>Box</code>, (which effectively turns
				3945	off the windowing function). </td>
				3946	</tr>
				3947
				3948	<tr>
				3949	<td>-define filter:win-support=<var>radius</var></td>
				3950	<td>Scale windowing function to this size instead. This causes the windowing
				3951	(or self-windowing Lagrange filter) to act is if the support window is
				3952	larger than what is actually supplied to the calling operator. The filter
				3953	however is still clipped to the real support size given. If unset this
				3954	will equal the normal filter support size. </td>
				3955	</tr>
				3956
				3957	<tr>
				3958	<td>-define filter:verbose=<var>1</var></td>
				3959	<td>This causes IM to print information on the final internal filter
				3960	selection to standard output. This includes a commented header on the
				3961	filter settings being used, and data allowing the filter weights to be
				3962	easily graphed. Note however that some filters are internally defined in terms of other filters. The <code>Lanczos</code> filter for example is defined in terms of
				3963	a <code>SincFast</code> windowed <code>SincFast</code> filter, while
				3964	<code>Mitchell</code> is defined as a general <code>Cubic</code> family filter
				3965	with specific 'B' and 'C' settings. </td>
				3966	</tr>
				3967
				3968	</table>
				3969
				3970	<p>For example, to get a 8 lobe jinc windowed sinc filter (Genseng filter?):</p>
				3971
				3972	<pre>
				3973	convert image.png \
				3974	-filter sinc \
				3975	-set filter:window=jinc \
				3976	-set filter:lobes=8 \
				3977	-resize 150% image.jpg"
				3978	</pre>
				3979
				3980	<p>Or a raw un-windowed Sinc filter with 4 lobes:</p>
				3981
				3982	<pre>
				3983	convert image.png \
				3984	-set filter:filter=sinc \
				3985	-set filter:lobes=4 \
				3986	-resize 150% image.jpg"
				3987	</pre>
				3988
				3989	<p>To extract the data for a raw windowing function, combine it with
				3990	a '<code>Box</code>' filter. For example the '<code>Welch</code> parabolic
				3991	windowing function. </p>
				3992
				3993	<pre>
				3994	convert null: -define filter:filter=Box \
				3995	-define filter:window=Welch \
				3996	-define filter:support=1.0 \
				3997	-define filter:verbose=1 \
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	3998	-resize 2 null: > window_welch.dat
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	3999	gnuplot
				4000	set grid
				4001	plot \"window_welch.dat\" with lines
				4002	</pre>
				4003
				4004	<p>Note that the use of expert options is provided for image processing experts
				4005	who have studied and understand how resize filters work. Without this
				4006	knowledge, and an understanding of the definition of the actual filters
				4007	involved, using expert settings are more likely to be detrimental to your image
				4008	resizing.</p>
				4009
				4010
				4011	<div style="margin: auto;">
				4012	<h3 class="magick-header"><a id="flatten"></a>-flatten</h3>
				4013	</div>
				4014
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4015	<p class="magick-description">This is a simple alias for the <a href="command-line-options.html#layers" >-layers</a> method "flatten".</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4016
				4017
				4018	<div style="margin: auto;">
				4019	<h3 class="magick-header"><a id="flip"></a>-flip</h3>
				4020	</div>
				4021
				4022	<p class="magick-description">create a <var>mirror image</var></p>
				4023
				4024	<p>reflect the scanlines in the vertical direction. The image will be mirrored
				4025	upside-down. </p>
				4026
				4027
				4028	<div style="margin: auto;">
				4029	<h3 class="magick-header"><a id="floodfill"></a>-floodfill {<var>+-</var>}<var>x</var>{<var>+-</var>}<var>y</var> <var>color</var></h3>
				4030	</div>
				4031
				4032	<p class="magick-description">floodfill the image with color at the specified offset.</p>
				4033
				4034	<p>Flood fill starts from the given 'seed point' which is not gravity effected.
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4035	Any color that matches within <a href="command-line-options.html#fuzz" >-fuzz</a> color distance of the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4036	given <var>color</var> argument, connected to that 'seed point'
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4037	will be replaced with the current <a href="command-line-options.html#fill" >-fill</a> color. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4038
				4039	<p>Note that if the pixel at the 'seed point' does not itself match the given
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4040	<var>color</var> (according to <a href="command-line-options.html#fuzz" >-fuzz</a>), then no
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4041	action will be taken. </p>
				4042
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4043	<p>This operator works more like the <a href="command-line-options.html#opaque" >-opaque</a> option, than
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4044	a more general flood fill that reads the matching color directly at the 'seed
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4045	point'. For this form of flood fill, look at <a href="command-line-options.html#draw" >-draw</a> and
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4046	its 'color floodfill' drawing method. </p>
				4047
				4048
				4049	<div style="margin: auto;">
				4050	<h3 class="magick-header"><a id="flop"></a>-flop</h3>
				4051	</div>
				4052
				4053	<p class="magick-description">create a <var>mirror image</var>.</p>
				4054
				4055	<p>Reflect the scanlines in the horizontal direction, just like the image in
				4056	a vertical mirror. </p>
				4057
				4058
				4059	<div style="margin: auto;">
				4060	<h3 class="magick-header"><a id="font"></a>-font <var>name</var></h3>
				4061	</div>
				4062
				4063	<p class="magick-description">set the font to use when annotating images with text, or creating labels.</p>
				4064
				4065	<p>To print a complete list of fonts, use the <a href="command-line-options.html#list">-list font</a>
				4066	option (for versions prior to 6.3.6, use 'type' instead of 'font').</p>
				4067
				4068	<p>In addition to the fonts specified by the above pre-defined list, you can
				4069	also specify a font from a specific source. For example <code>Arial.ttf</code>
				4070	is a TrueType font file, <code>ps:helvetica</code> is PostScript font, and
				4071	<code>x:fixed</code> is X11 font.</p>
				4072
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4073	<p>For other settings that affect fonts, see the options <a
				4074	href="command-line-options.html#family">-family</a>, <a href="command-line-options.html#stretch">-stretch</a>, <a
				4075	href="command-line-options.html#style">-style</a>, and <a href="command-line-options.html#weight">-weight</a>. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4076
				4077
				4078	<div style="margin: auto;">
				4079	<h3 class="magick-header"><a id="foreground"></a>-foreground <var>color</var></h3>
				4080	</div>
				4081
				4082	<p class="magick-description">Define the foreground color for menus.", "display</p>
				4083
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4084	<p>The color is specified using the format described under the <a
				4085	href="command-line-options.html#fill">-fill</a> option.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4086
				4087	<p>The default foreground color is black.</p>
				4088
				4089	<div style="margin: auto;">
				4090	<h3 class="magick-header"><a id="format"></a>-format <var>type</var></h3>
				4091	</div>
				4092
				4093	<p class="magick-description">the image format type.</p>
				4094
				4095	<p>When used with the <code>mogrify</code> utility, this option converts any
				4096	image to the image <a href="formats.html">format</a> you specify.
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4097	For a list of image format types supported by ImageMagick, use <a
				4098	href="command-line-options.html#list">-list format</a>.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4099
				4100	<p>By default the file is written to its original name. However, if the
				4101	filename extension matches a supported format, the extension is replaced with
				4102	the image format type specified with <a href="command-line-options.html#format">-format</a>. For
				4103	example, if you specify <var>tiff</var> as the format type and the
				4104	input image filename is <var>image.gif</var>, the output image
				4105	filename becomes <var>image.tiff</var>.</p>
				4106
				4107	<div style="margin: auto;">
				4108	<h3 class="magick-header"><a id="format_identify_"></a>-format <var>string</var></h3>
				4109	</div>
				4110
				4111	<p class="magick-description">output formatted image characteristics.</p>
				4112
				4113	<p>See <a href="escape.html">Format and Print Image
				4114	Properties</a> for an explanation on how to specify the argument to this
				4115	option.</p>
				4116
				4117	<div style="margin: auto;">
				4118	<h3 class="magick-header"><a id="frame"></a>-frame <var>geometry</var></h3>
				4119	</div>
				4120
				4121	<p class="magick-description">Surround the image with a border or beveled frame.</p>
				4122
Cristy	f650f4f	2016-04-01 10:53:07 -0400	[diff] [blame]	4123	<p>The color of the border is specified with the <a href="command-line-options.html#alpha-color"
				4124	>-alpha-color</a> command line option. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4125
				4126	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. The <var>size</var> portion of the <var>geometry</var> argument indicates the amount of extra width and
				4127	height that is added to the dimensions of the image. If no offsets are given
				4128	in the <var>geometry</var> argument, then the border added is
				4129	a solid color. Offsets <var>x</var> and <var>y</var>, if present, specify that
				4130	the width and height of the border is partitioned to form an outer bevel of
				4131	thickness <var>x</var> pixels and an inner bevel of thickness
				4132	<var>y</var> pixels. Negative offsets make no sense as frame arguments.
				4133	</p>
				4134
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4135	<p>The <a href="command-line-options.html#frame">-frame</a> option is affected by the current <a
				4136	href="command-line-options.html#compose">-compose</a> setting and assumes that this is using the default
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4137	'<code>Over</code>' composition method. It generates an image of the appropriate
				4138	size with the current <a href="command-line-options.html#bordercolor">-bordercolor</a> setting, and then
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4139	draws the frame of four distinct colors close to the current <a
Cristy	f650f4f	2016-04-01 10:53:07 -0400	[diff] [blame]	4140	href="command-line-options.html#alpha-color">-alpha-color</a>. The original image is then overlaid onto
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4141	center of this image. This means that with the default compose method of
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4142	'<code>Over</code>' any transparent parts may be replaced by the current <a
				4143	href="command-line-options.html#bordercolor">-bordercolor</a> setting.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4144
				4145	<p>The image composition is not
				4146	affected by the <a href="command-line-options.html#gravity">-gravity</a> option.</p>
				4147
				4148
				4149	<div style="margin: auto;">
				4150	<h3 class="magick-header"><a id="frame_import_"></a>-frame</h3>
				4151	</div>
				4152
				4153	<p class="magick-description">include the X window frame in the imported image. </p>
				4154	<div style="margin: auto;">
				4155	<h3 class="magick-header"><a id="function"></a>-function <var>function</var> <var>parameters</var></h3>
				4156	</div>
				4157
				4158	<p class="magick-description">Apply a function to channel values.</p>
				4159
				4160	<p>This operator performs calculations based on the given arguments to modify
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4161	each of the color values for each previously set <a
				4162	href="command-line-options.html#channel">-channel</a> in the image. See <a
				4163	href="command-line-options.html#evaluate">-evaluate</a> for details concerning how the results of the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4164	calculations are handled.</p>
				4165
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4166	<p>This is can be considered a multi-argument version of the <a
				4167	href="command-line-options.html#evaluate">-evaluate</a> operator. (Added in
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4168	ImageMagick 6.4.8−8.)</p>
				4169
				4170	<p>Here, <var>parameters</var> is a comma-separated list of
				4171	numerical values. The number of values varies depending on which <var>function</var> is selected. Choose the <var>function</var> from:</p>
				4172
				4173	<pre>
				4174	Polynomial
				4175	Sinusoid
				4176	Arcsin
				4177	Arctan
				4178	</pre>
				4179
				4180	<p>To print a complete list of <a href="command-line-options.html#function">-function</a> operators,
				4181	use <a href="command-line-options.html#list">-list function</a>. Descriptions follow.</p>
				4182
				4183	<dl class="dl-horizontal">
				4184	<dt>Polynomial</dt>
				4185	<dd><p>The <code>Polynomial</code> function takes an arbitrary number of parameters,
				4186	these being the coefficients of a polynomial, in decreasing order of degree.
				4187	That is, entering</p>
				4188
				4189	<pre>
				4190	-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>
				4191	</pre>
				4192
				4193	<p>will invoke a polynomial function given by</p>
				4194
				4195	<pre>
				4196	<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>,
				4197	</pre>
				4198
				4199	<p>where <b><var>u</var></b> is pixel's original normalized channel value.</p>
				4200
				4201	<p>The <code>Polynomial</code> function can be used in place of <code>Set</code>
				4202	(the <var>constant</var> polynomial) and <code>Add</code>, <code>Divide</code>,
				4203	<code>Multiply</code>, and <code>Subtract</code> (some <var>linear</var>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4204	polynomials) of the <a href="command-line-options.html#evaluate">-evaluate</a> operator. The <a
				4205	href="command-line-options.html#level">-level</a> operator also affects channels linearly. Some
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4206	correspondences follow.</p>
				4207
				4208	<table class="table table-condensed table-striped">
				4209	<tr>
				4210	<td>-evaluate Set <var>value</var> </td>
				4211	<td>-function Polynomial <var>value</var></td>
				4212	<td>(Constant functions; set <var>value</var>×100% gray when channels are RGB.)</td>
				4213	</tr>
				4214	<tr>
				4215	<td>-evaluate Add <var>value</var> </td>
				4216	<td>-function Polynomial 1,<var>value</var></td>
				4217	</tr>
				4218	<tr>
				4219	<td>-evaluate Subtract <var>value</var> </td>
				4220	<td>-function Polynomial 1,−<var>value</var></td>
				4221	</tr>
				4222	<tr>
				4223	<td>-evaluate Multiply <var>value</var> </td>
				4224	<td>-function Polynomial <var>value</var>,0</td>
				4225	</tr>
				4226	<tr>
				4227	<td>+level black% x white%</td>
				4228	<td>-function Polynomial A,B</td>
				4229	<td>(Reduce contrast. Here, A=(white-black)/100 and B=black/100.)</td>
				4230	</tr>
				4231	</table>
				4232
				4233	<p>The <code>Polynomial</code> function gives great versatility, since
				4234	polynomials can be used to fit any continuous curve to any degree of accuracy
				4235	desired.</p>
				4236
				4237	</dd>
				4238	<dt>Sinusoid</dt>
				4239	<dd>
				4240	<p>The <code>Sinusoid</code> function can be used to vary the channel values
				4241	sinusoidally by setting frequency, phase shift, amplitude, and a bias. These
				4242	values are given as one to four parameters, as follows,</p>
				4243
				4244	<pre>
				4245	-function <code>Sinusoid</code> <var>freq</var>,[<var>phase</var>,[<var>amp</var>,[<var>bias</var>]]]
				4246	</pre>
				4247
				4248	<p>where <var>phase</var> is in degrees. (The domain [0,1] of the function
				4249	corresponds to 0 through <var>freq</var>×360 degrees.)
				4250	The result is that if a pixel's normalized channel value is originally
				4251	<b><var>u</var></b>, its resulting normalized value is given by </p>
				4252
				4253	<pre>
				4254	<var>amp</var> * sin(2π (<var>freq</var> * <b><var>u</var></b> + <var>phase</var> / 360)) + <var>bias</var>
				4255	</pre>
				4256
				4257	<p> For example, the following generates a curve that starts and ends at 0.9
				4258	(when <b><var>u</var></b>=0 and 1, resp.), oscillating three times between
				4259	.7−.2=.5 and .7+.2=.9. </p>
				4260
				4261	<pre>
				4262	-function Sinusoid 3,-90,.2,.7
				4263	</pre>
				4264
				4265	<p>The default values of <var>amp</var> and <var>bias</var> are both .5. The default for <var>phase</var>
				4266	is 0.</p>
				4267
				4268	<p>The <code>Sinusoid</code> function generalizes <code>Sin</code> and
				4269	<code>Cos</code> of the <a href="command-line-options.html#evaluate">-evaluate</a> operator by allowing
				4270	varying amplitude, phase and bias. The correspondence is as follows.</p>
				4271
				4272	<table class="table table-condensed table-striped">
				4273	<tr>
				4274	<td>-evaluate Sin <var>freq</var> </td>
				4275	<td>-function Sinusoid <var>freq</var>,0 </td>
				4276	</tr>
				4277	<tr>
				4278	<td>-evaluate Cos <var>freq</var> </td>
				4279	<td>-function Sinusoid <var>freq</var>,90 </td>
				4280	</tr>
				4281	</table>
				4282	</dd>
				4283	<dt>ArcSin</dt>
				4284	<dd>
				4285	<p>The <code>ArcSin</code> function generates the inverse curve of a Sinusoid,
				4286	and can be used to generate cylindrical distortion and displacement maps.
				4287	The curve can be adjusted relative to both the input values and output range
				4288	of values.</p>
				4289
				4290	<pre>
				4291	-function <code>ArcSin</code> <var>width</var>,[<var>center</var>,[<var>range</var>,[<var>bias</var>]]]
				4292	</pre>
				4293
				4294	<p>with all values given in terms of normalized color values (0.0 for black,
				4295	1.0 for white). Defaulting to values covering the full range from 0.0 to 1.0
				4296	for bout input (<var>width</var>), and output (<var>width</var>) values. '<code>1.0,0.5,1.0,0.5</code>' </p>
				4297
				4298	<pre>
				4299	<var>range</var>/π * asin( 2/<var>width</var> * ( <b><var>u</var></b> - <var>center</var> ) ) + <var>bias</var>
				4300	</pre>
				4301
				4302	</dd>
				4303	<dt>ArcTan</dt>
				4304	<dd>
				4305	<p>The <code>ArcTan</code> function generates a curve that smooth crosses from
				4306	limit values at infinities, though a center using the given slope value.
				4307	All these values can be adjusted via the arguments.</p>
				4308
				4309	<pre>
				4310	-function <code>ArcTan</code> <var>slope</var>,[<var>center</var>,[<var>range</var>,[<var>bias</var>]]]
				4311	</pre>
				4312
				4313	<p>Defaulting to '<code>1.0,0.5,1.0,0.5</code>'.
				4314	</p>
				4315
				4316	<pre>
				4317	<var>range</var>/π * atan( <var>slope</var>π ( <b><var>u</var></b> - <var>center</var> ) ) + <var>bias</var>
				4318	</pre>
				4319	</dd>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4320	</dl>
				4321
				4322
				4323
				4324	<div style="margin: auto;">
				4325	<h3 class="magick-header"><a id="fuzz"></a>-fuzz <var>distance</var>{<var>%</var>}</h3>
				4326	</div>
				4327
				4328	<p class="magick-description">Colors within this <var>distance</var> are considered equal.</p>
				4329
				4330	<p>A number of algorithms search for a target color. By default the color must
				4331	be exact. Use this option to match colors that are close to the target color
				4332	in RGB space. For example, if you want to automagically trim the edges of an
				4333	image with <a href="command-line-options.html#trim">-trim</a> but the image was scanned and the target
				4334	background color may differ by a small amount. This option can account for
				4335	these differences.</p>
				4336
				4337	<p>The <var>distance</var> can be in absolute intensity units or, by
				4338	appending <code>%</code> as a percentage of the maximum possible intensity (255,
				4339	65535, or 4294967295).</p>
				4340
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4341	<p>Use <a href="command-line-options.html#fuzz" >+fuzz</a> to reset the fuzz value to 0.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4342
				4343
				4344	<div style="margin: auto;">
				4345	<h3 class="magick-header"><a id="fx"></a>-fx <var>expression</var></h3>
				4346	</div>
				4347
				4348	<p class="magick-description">apply a mathematical expression to an image or image channels.</p>
				4349
				4350	<p>If the first character of <var>expression</var> is <code>@</code>,
				4351	the expression is read from a file titled by the remaining characters in the
				4352	string.</p>
				4353
				4354	<p>See <a href="fx.html">FX,
				4355	The Special Effects Image Operator</a> for a detailed discussion of this
				4356	option.</p>
				4357
				4358
				4359	<div style="margin: auto;">
				4360	<h3 class="magick-header"><a id="gamma"></a>-gamma <var>value</var></h3>
				4361	</div>
				4362
				4363	<p class="magick-description">level of gamma correction.</p>
				4364
				4365	<p>The same color image displayed on two different workstations may look
				4366	different due to differences in the display monitor. Use gamma correction to
				4367	adjust for this color difference. Reasonable values extend from
				4368	<code>0.8</code> to <code>2.3</code>. Gamma less than 1.0 darkens the image and
				4369	gamma greater than 1.0 lightens it. Large adjustments to image gamma may
				4370	result in the loss of some image information if the pixel quantum size is only
				4371	eight bits (quantum range 0 to 255).</p>
				4372
				4373	<p>Gamma adjusts the image's channel values pixel-by-pixel according to
				4374	a power law, namely, pow(pixel,1/gamma) or pixel^(1/gamma), where pixel is the
				4375	normalized or 0 to 1 color value. For example, using a value of gamma=2 is the
				4376	same as taking the square root of the image.</p>
				4377
				4378	<p>You can apply separate gamma values to the red, green, and blue channels of
				4379	the image with a gamma value list delimited with commas (e.g.,
				4380	<code>1.7,2.3,1.2</code>).</p>
				4381
				4382	<p>Use <a href="command-line-options.html#gamma">+gamma <var>value</var></a> to set the
				4383	image gamma level without actually adjusting the image pixels. This option
				4384	is useful if the image is of a known gamma but not set as an image attribute
				4385	(e.g. PNG images). Write the "file gamma" which is the reciprocal of the
				4386	display gamma; e.g., if your image is sRGB and you want to write a PNG gAMA
				4387	chunk, use</p>
				4388
				4389	<pre>
				4390	convert input.png +gamma .45455 output.png
				4391	</pre>
				4392
				4393	<p>(0.45455 is 1/2.2)</p>
				4394
				4395	<p>Note that gamma adjustments are also available via the <a href="command-line-options.html#level">-level</a> operator.</p>
				4396
				4397	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4398	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4399	</div>
				4400
				4401	<p class="magick-description">Blur the image with a Gaussian operator.</p>
				4402
				4403	<p>Convolve the image with a Gaussian or normal distribution using the given
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4404	<var >Sigma</var> value. The formula is:</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4405
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4406	<p class="text-center"><img class="img-thumbnail" alt="gaussian distribution" width="243px" height="42px" src="../images/gaussian-blur.png"/> </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4407
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4408	<p>The <var >Sigma</var> value is the important argument, and
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4409	determines the actual amount of blurring that will take place. </p>
				4410
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4411	<p>The <var >Radius</var> is only used to determine the size of the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4412	array which will hold the calculated Gaussian distribution. It should be an
				4413	integer. If not given, or set to zero, IM will calculate the largest possible
				4414	radius that will provide meaningful results for the Gaussian distribution.
				4415	</p>
				4416
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4417	<p>The larger the <var >Radius</var> the radius the slower the
				4418	operation is. However too small a <var >Radius</var>, and sever
				4419	aliasing effects may result. As a guideline, <var >Radius</var>
				4420	should be at least twice the <var >Sigma</var> value, though three
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4421	times will produce a more accurate result. </p>
				4422
				4423	<p>This differs from the faster <a href="command-line-options.html#blur">-blur</a> operator in that a
				4424	full 2-dimensional convolution is used to generate the weighted average of the
				4425	neighboring pixels. </p>
				4426
				4427	<p>The <a href="command-line-options.html#virtual-pixel">-virtual-pixel</a> setting will determine how
				4428	pixels which are outside the image proper are blurred into the final result.
				4429	</p>
				4430
				4431
				4432	<div style="margin: auto;">
				4433	<h3 class="magick-header"><a id="geometry"></a>-geometry <var>geometry</var></h3>
				4434	</div>
				4435
				4436	<p class="magick-description">Set the preferred size and location of the image.</p>
				4437
				4438	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
				4439
				4440	<div style="margin: auto;">
				4441	<h3 class="magick-header"><a id="gravity"></a>-gravity <var>type</var></h3>
				4442	</div>
				4443
				4444	<p class="magick-description">Sets the current gravity suggestion for various other settings and options.</p>
				4445
				4446	<p>Choices include: <code>NorthWest</code>, <code>North</code>,
				4447	<code>NorthEast</code>, <code>West</code>, <code>Center</code>, <code>East</code>,
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4448	<code>SouthWest</code>, <code>South</code>, <code>SouthEast</code>. Use <a
				4449	href="command-line-options.html#list">-list gravity</a> to get a complete list of <a
				4450	href="command-line-options.html#gravity">-gravity</a> settings available in your ImageMagick
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4451	installation.</p>
				4452
				4453	<p>The direction you choose specifies where to position text or subimages. For
				4454	example, a gravity of <code>Center</code> forces the text to be centered within
Cristy	776113a	2016-04-29 12:01:19 -0400	[diff] [blame]	4455	the image. By default, the image gravity is <code>undefined</code>. See <a
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4456	href="command-line-options.html#draw">-draw</a> for more details about graphic primitives. Only the
				4457	text primitive of <a href="command-line-options.html#draw">-draw</a> is affected by the <a
				4458	href="command-line-options.html#gravity">-gravity</a> option.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4459
				4460	<p>The <a href="command-line-options.html#gravity">-gravity</a> option is also used in concert with the
				4461	<a href="command-line-options.html#geometry">-geometry</a> setting and other settings or options that
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4462	take <var>geometry</var> as an argument, such as the <a
				4463	href="command-line-options.html#crop">-crop</a> option. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4464
				4465	<p>If a <a href="command-line-options.html#gravity">-gravity</a> setting occurs before another option
				4466	or setting having a <var>geometry</var> argument that specifies an
				4467	offset, the offset is usually applied to the point within the image suggested
				4468	by the <a href="command-line-options.html#gravity">-gravity</a> argument. Thus, in the following
				4469	command, for example, suppose the file <code>image.png</code> has dimensions
				4470	200x100. The offset specified by the argument to <a href="command-line-options.html#region">-region</a>
				4471	is (−40,+20). The argument to <a href="command-line-options.html#gravity">-gravity</a> is
				4472	<code>Center</code>, which suggests the midpoint of the image, at the point
				4473	(100,50). The offset (−40,20) is applied to that point, giving
				4474	(100−40,50+20)=(60,70), so the specified 10x10 region is located at
				4475	that point. (In addition, the <a href="command-line-options.html#gravity">-gravity</a> affects the
				4476	region itself, which is <var>centered</var> at the pixel
				4477	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>
				4478
				4479	<pre>
				4480	convert image.png -gravity Center -region 10x10-40+20 \
				4481	-negate output.png
				4482	</pre>
				4483
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4484	<p>When used as an option to <a href="composite.html">composite</a>, <a
				4485	href="command-line-options.html#gravity">-gravity</a> gives the direction that the image gravitates
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4486	within the composite.</p>
				4487
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4488	<p>When used as an option to <a href="montage.html">montage</a>, <a
				4489	href="command-line-options.html#gravity">-gravity</a> gives the direction that an image gravitates
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4490	within a tile. The default gravity is <code>Center</code> for this purpose.</p>
				4491
				4492
				4493	<div style="margin: auto;">
				4494	<h3 class="magick-header"><a id="grayscale"></a>-grayscale <var>method</var></h3>
				4495	</div>
				4496
				4497	<p class="magick-description">convert image to grayscale.</p>
				4498
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4499	<p>This will use one of the <a href="command-line-options.html#intensity" >-intensity</a> methods to
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4500	convert the given image into a linear-grayscale image. </p>
				4501
				4502	<p>For example, to convert an image to (linear) Rec709Luminance grayscale, type:</p>
				4503
				4504	<pre>
				4505	convert in.png -grayscale Rec709Luminance out.png
				4506	</pre>
				4507
				4508	<p>which is equivalent to:</p>
				4509
				4510	<pre>
				4511	convert in.png -colorspace gray out.png
				4512	</pre>
				4513
				4514	<p>Similarly, to convert an image to (non-linear) Rec709Luma grayscale, type:</p>
				4515
				4516	<pre>
				4517	convert in.png -grayscale Rec709Luma out.png
				4518	</pre>
				4519
				4520	<p>which is equivalent to:</p>
				4521
				4522	<pre>
				4523	convert in.png -set colorspace RGB -colorspace gray out.png
				4524	</pre>
				4525
				4526	<p>Note that a 'colorspace' intensity method will produce the same result
				4527	regardless of the current colorpsace of the image. But a 'mathematical'
				4528	intensity method will depend on the current colorspace the image is currently
				4529	using. </p>
				4530
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4531	<p>While this operation uses an <a href="command-line-options.html#intensity" >-intensity</a> method,
				4532	it does not use or set the <a href="command-line-options.html#intensity" >-intensity</a> setting, so
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4533	will not effect other operations that may use that setting.</p>
				4534
				4535
				4536	<div style="margin: auto;">
				4537	<h3 class="magick-header"><a id="green-primary"></a>-green-primary <var>x,y</var></h3>
				4538	</div>
				4539
				4540	<p class="magick-description">green chromaticity primary point.</p>
				4541
				4542
				4543	<div style="margin: auto;">
				4544	<h3 class="magick-header"><a id="hald-clut"></a>-hald-clut</h3>
				4545	</div>
				4546
				4547	<p class="magick-description">apply a Hald color lookup table to the image.</p>
				4548
				4549	<p>A Hald color lookup table is a 3-dimensional color cube mapped to 2
				4550	dimensions. Create it with the <code>HALD:</code> prefix (e.g. HALD:8). You
				4551	can apply any color transformation to the Hald image and then use this option
				4552	to apply the transform to the image. </p>
				4553
				4554	<pre>
				4555	convert image.png hald.png -hald-clut transform.png
				4556	</pre>
				4557
				4558	<p>This option provides a convenient method for you to use Gimp or Photoshop
				4559	to make color corrections to the Hald CLUT image and subsequently apply them
				4560	to multiple images using an ImageMagick script. </p>
				4561
				4562	<p>Note that the representation is only of the normal RGB color space and that
				4563	the whole color value triplet is used for the interpolated lookup of the
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4564	represented Hald color cube image. Because of this the operation is not <a
				4565	href="command-line-options.html#channel" >-channel</a> setting effected, nor can it adjust or modify an
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4566	images transparency or alpha/matte channel.</p>
				4567
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4568	<p>See also <a href="command-line-options.html#clut" >-clut</a> which provides color value replacement
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	4569	of the individual color channels, usually involving a simpler grayscale
				4570	image. E.g: grayscale to color replacement, or modification by a histogram
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4571	mapping. </p>
				4572
				4573
				4574	<div style="margin: auto;">
				4575	<h3 class="magick-header"><a id="help"></a>-help</h3>
				4576	</div>
				4577
				4578	<p class="magick-description">print usage instructions.</p>
				4579
				4580	<div style="margin: auto;">
				4581	<h3 class="magick-header"><a id="highlight-color"></a>-highlight-color <var>color</var></h3>
				4582	</div>
				4583
				4584	<p class="magick-description">when comparing images, emphasize pixel differences with this color.</p>
				4585
				4586	<div style="margin: auto;">
				4587	<h3 class="magick-header"><a id="hough-lines"></a>-hough-lines <var>width</var>x<var>height</var>{<var>+threshold</var>}</h3>
				4588	</div>
				4589
				4590	<p class="magick-description">identify straight lines in the image (e.g. -hough-lines 9x9+195).</p>
				4591
				4592	<p>Use the Hough line detector with any binary edge extracted image to locate and draw any straight lines that it finds.</p>
				4593
				4594	<p>The process accumulates counts for every white pixel in the binary edge image for every possible orientation (for angles from 0 to 179 in 1 deg increments) and distance from the center of the image to the corners (in 1 px increments). It stores the counts in an accumulator matrix of angle vs distance. The size of the accumulator will be 180x(diagonal/2). Next it searches the accumulator for peaks in counts and converts the locations of the peaks to slope and intercept in the normal x,y input image space. The algorithm uses slope/intercepts to find the endpoints clipped to the bounds of the image. The lines are drawn from the given endpoints. The counts are a measure of the length of the lines.</p>.
				4595
				4596	<p>The WxH arguments specify the filter size for locating the peaks in the Hough accumulator. The threshold excludes lines whose counts are less than the threshold value.</p>
				4597
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4598	<p>Use <code><a href="command-line-options.html#background" >-background</a></code> to specify the color of the background onto which the lines will be drawn. The default is black.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4599
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4600	<p>Use <code><a href="command-line-options.html#fill" >-fill</a></code> to specify the color of the lines. The default is black.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4601
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4602	<p>Use <code><a href="command-line-options.html#stroke" >-stroke</a></code> and <code><a href="command-line-options.html#strokewidth" >-strokewidth</a></code> to specify the thickness of the lines. The default is black and no strokewidth.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4603
				4604	<p>A text file listing the endpoints and counts may be created by using the suffix, .mvg, for the output image.</p>
				4605
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4606	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4607
				4608	<div style="margin: auto;">
				4609	<h3 class="magick-header"><a id="iconGeometry"></a>-iconGeometry <var>geometry</var></h3>
				4610	</div>
				4611
				4612	<p class="magick-description">specify the icon geometry.</p>
				4613
				4614	<p>Offsets, if present in the geometry specification, are handled in the same
				4615	manner as the <a href="command-line-options.html#geometry">-geometry</a> option, using X11 style to
				4616	handle negative offsets.</p>
				4617
				4618	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
				4619
				4620	<div style="margin: auto;">
				4621	<h3 class="magick-header"><a id="iconic"></a>-iconic</h3>
				4622	</div>
				4623
				4624	<p class="magick-description">start in icon mode in X Windows", 'animate', 'display</p>
				4625
				4626	<div style="margin: auto;">
				4627	<h3 class="magick-header"><a id="identify"></a>-identify</h3>
				4628	</div>
				4629
				4630	<p class="magick-description">identify the format and characteristics of the image.</p>
				4631
				4632	<p>This information is printed: image scene number; image name; image size;
				4633	the image class (<var>DirectClass</var> or <var>PseudoClass</var>); the total number of unique colors; and the
				4634	number of seconds to read and transform the image. Refer to <a href="miff.html">MIFF</a> for
				4635	a description of the image class.</p>
				4636
				4637	<p>If <a href="command-line-options.html#colors">-colors</a> is also specified, the total unique colors
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4638	in the image and color reduction error values are printed. Refer to <a
Cristy	6549abb	2016-11-10 08:25:55 -0500	[diff] [blame]	4639	href="http://www.imagemagick.org/www/quantize.html">color
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4640	reduction algorithm</a> for a description of these values.</p>
				4641
				4642	<p>If <a href="command-line-options.html#verbose">-verbose</a> precedes this option, copious
				4643	amounts of image properties are displayed including image statistics, profiles,
				4644	image histogram, and others.</p>
				4645
				4646	<div style="margin: auto;">
				4647	<h3 class="magick-header"><a id="ift"></a>-ift</h3>
				4648	</div>
				4649
				4650	<p class="magick-description">implements the inverse discrete Fourier transform (DFT).</p>
				4651
				4652	<p>This option is new as of ImageMagick 6.5.4-3 (and now working for Windows
				4653	users in ImageMagick 6.6.0-9). It transforms a pair of magnitude and phase
				4654	images from the frequency domain to a single image in the normal or spatial
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4655	domain. See for example, <a
				4656	href="http://en.wikipedia.org/wiki/Fourier_transform">Fourier Transform</a>,
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4657	<a href="http://en.wikipedia.org/wiki/DFT">Discrete Fourier Transform</a> and
				4658	<a href="http://en.wikipedia.org/wiki/FFT">Fast Fourier Transform</a>.</p>
				4659
				4660	<p>For example, depending upon the image format used to store the result of
				4661	the <a href="command-line-options.html#fft">-fft</a>, one would use either</p>
				4662
				4663	<pre>
				4664	convert fft_image.miff -ift fft_image_ift.png
				4665	</pre>
				4666
				4667	<p>or</p>
				4668
				4669	<pre>
				4670	convert fft_image-0.png fft_image-1.png -ift fft_image_ift.png
				4671	</pre>
				4672
				4673	<p>The resulting image may need to be cropped due to padding introduced when
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4674	the original image, prior to the <a href="command-line-options.html#fft">-fft</a> or <a
				4675	href="command-line-options.html#fft">+fft</a>, was not square or even dimensioned. Any padding is at
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4676	the right and/or bottom sides of the image.</p>
				4677
				4678	<p>The <a href="http://www.fftw.org/">FFTW</a> delegate library is required to
				4679	use <a href="command-line-options.html#ift">-ift</a>.</p>
				4680
				4681	<p>Use <a href="command-line-options.html#ift">+ift</a> (with HDRI enabled) to transform a pair of real
				4682	and imaginary images from the frequency domain to a single image in the normal
				4683	(spatial) domain.</p>
				4684
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4685	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4686
				4687	<div style="margin: auto;">
				4688	<h3 class="magick-header"><a id="immutable"></a>-immutable</h3>
				4689	</div>
				4690
				4691	<p class="magick-description">make image immutable.</p>
				4692
				4693	<div style="margin: auto;">
				4694	<h3 class="magick-header"><a id="implode"></a>-implode <var>factor</var></h3>
				4695	</div>
				4696
				4697	<p class="magick-description">implode image pixels about the center.</p>
				4698
				4699	<div style="margin: auto;">
				4700	<h3 class="magick-header"><a id="insert"></a>-insert <var>index</var></h3>
				4701	</div>
				4702
				4703	<p class="magick-description">insert the last image into the image sequence.</p>
				4704
				4705	<p>This option takes last image in the current image sequence and inserts it
				4706	at the given index. If a negative index is used, the insert position is
				4707	calculated before the last image is removed from the sequence. As such
				4708	<code>-insert -1</code> will result in no change to the image sequence.</p>
				4709
				4710	<p>The <code>+insert</code> option is equivalent to <code>-insert -1</code>. In
				4711	other words, insert the last image, at the end of the current image sequence.
				4712	Consequently this has no effect on the image sequence order.</p>
				4713
				4714	<div style="margin: auto;">
				4715	<h3 class="magick-header"><a id="intensity"></a>-intensity <var>method</var></h3>
				4716	</div>
				4717
				4718	<p class="magick-description">method to generate intensity value from pixel.</p>
				4719
				4720	<p>ImageMagick provides a number of methods used in situations where an
				4721	operator needs to determine a single grayscale value for some purpose, from
				4722	an image with red, green, and blue pixel components. Typically the linear
				4723	<code>Rec709Luminance</code> formula is used, which is the same formula used when
				4724	converting images to <code>-colorspace gray</code>. </p>
				4725
				4726	<p>The following formulas are currently provided, and will first convert
				4727	the pixel values to linear-RGB or non-linear sRGB colorspace before
				4728	being applied to calculate the final greyscale value. </p>
				4729
				4730	<dl class="dl-horizontal">
				4731	<dt>Rec601Luma</dt><dd> 0.298839R' + 0.586811G'+ 0.114350B'</dd>
				4732	<dt>Rec601Luminance</dt><dd> 0.298839R + 0.586811G + 0.114350B</dd>
				4733	<dt>Rec709Luma</dt><dd> 0.212656R' + 0.715158G' + 0.072186B'</dd>
				4734	<dt>Rec709Luminance</dt><dd> 0.212656R + 0.715158G + 0.072186B</dd>
				4735	<dt>Brightness</dt><dd> max(R', G', B')</dd>
				4736	<dt>Lightness</dt><dd> (min(R', G', B') + max(R', G', B')) / 2.0</dd>
				4737	</dl>
				4738
				4739	<p>Note that the above R,G,B values is the image's linear-RGB values, while
				4740	R',G',B' are sRGB non-linear values. </p>
				4741
				4742	<p>These intensity methods are mathematical in nature and will use the
				4743	current value in the images respective R,G,B channel regardless of
				4744	what that is, or what colorspace the image is currently using.</p>
				4745
				4746	<dl class="dl-horizontal">
				4747	<dt>Average</dt><dd>(R + G + B) / 3.0</dd>
				4748	<dt>MS</dt><dd>(R^2 + G^2 + B^2) / 3.0</dd>
				4749	<dt>RMS</dt><dd>sqrt( (R^2 + G^2 + B^2) / 3.0 )</dd>
				4750	</dl>
				4751
				4752	<p>These methods are often used for other purposes, such as generating a
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4753	grayscale difference image between two color images (using <a href="command-line-options.html#compose"
				4754	>-compose</a> '<code>Difference</code>' composition. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4755
				4756	<p> For example The 'MS' (Mean Squared) setting is good for minimizing color
				4757	error comparisions. While... The method 'RMS' (Root Mean Squared) for
				4758	example is appropriate for calculating color vector distance, from a color
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4759	difference image. This is equivalent to the color only component of the <a
				4760	href="command-line-options.html#fuzz" >-fuzz</a> factor color compare setting. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4761
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4762	<p>See also <a href="command-line-options.html#grayscale" >-grayscale</a> which applies one of the above
				4763	grayscaling formula directly to an image without setting the <a
				4764	href="command-line-options.html#intensity" >-intensity</a> setting.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4765
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4766	<p>The <a href="command-line-options.html#colorspace" >-colorspace gray</a> image conversion also uses
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4767	the current intensity setting, but will always convert the image to the
				4768	appropriate sRGB or linear-RGB colorspace before appling the above
				4769	function.</p>
				4770
				4771	<p>To print a complete list of possible pixel intensity setting methods, use <a href="command-line-options.html#list">-list intensity</a>.</p>
				4772
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4773	<p>Operators affected by the <a href="command-line-options.html#intensity" >-intensity</a> setting include:</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4774
				4775	<pre>
				4776	-adaptive-blur
				4777	-adaptive-sharpen
				4778	-black-threshold
				4779	-clut (when mapping greyscale CLUT image to alpha channel if set by -channels)
				4780	-colors for gray colorspace
				4781	-compose {LightenIntensity, DarkenIntensity, CopyOpacity, CopyBlack}
				4782	-contrast-stretch
				4783	-distort {ErodeIntensity, DilateIntensity}
				4784	-normalize
				4785	-random-threshold
				4786	-selective-blur
				4787	-shade
				4788	-threshold
				4789	-tint
				4790	-white-threshold
				4791	</pre>
				4792
				4793	<div style="margin: auto;">
				4794	<h3 class="magick-header"><a id="intent"></a>-intent <var>type</var></h3>
				4795	</div>
				4796
				4797	<p class="magick-description">use this type of rendering intent when managing the image color.</p>
				4798
				4799	<p>Use this option to affect the color management operation of an image (see
				4800	<a href="command-line-options.html#profile">-profile</a>). Choose from these intents: <code>Absolute,
				4801	Perceptual, Relative, Saturation</code>.</p>
				4802
				4803	<p>The default intent is Perceptual for the sRGB colorspace and undefined for the RGB and gray colorspaces.</p>
				4804
				4805	<p>To print a complete list of rendering intents, use <a href="command-line-options.html#list">-list intent</a>.</p>
				4806
				4807	<div style="margin: auto;">
				4808	<h3 class="magick-header"><a id="interlace"></a>-interlace <var>type</var></h3>
				4809	</div>
				4810
				4811	<p class="magick-description">the type of interlacing scheme.</p>
				4812
				4813	<p>Choose from:</p>
				4814
				4815	<pre>
				4816	none
				4817	line
				4818	plane
				4819	partition
				4820	JPEG
				4821	GIF
				4822	PNG
				4823	</pre>
				4824
				4825	<p>This option is used to specify the type of interlacing scheme for raw image
				4826	formats such as <code>RGB</code> or <code>YUV</code>.</p>
				4827
				4828	<p><code>None</code> means do not interlace (RGBRGBRGBRGBRGBRGB...),</p>
				4829
				4830	<p><code>Line</code> uses scanline interlacing (RRR...GGG...BBB...RRR...GGG...BBB...), and.</p>
				4831
				4832	<p><code>Plane</code> uses plane interlacing (RRRRRR...GGGGGG...BBBBBB...).</p>
				4833
				4834	<p><code>Partition</code> is like plane except the different planes are saved to
				4835	individual files (e.g. image.R, image.G, and image.B).</p>
				4836
				4837	<p>Use <code>Line</code> or <code>Plane</code> to create an <code>interlaced
				4838	PNG</code> or <code>GIF</code> or <code>progressive JPEG</code> image.</p>
				4839
				4840	<p>To print a complete list of interlacing schemes, use <a href="command-line-options.html#list">-list
				4841	interlace</a>.</p>
				4842
				4843	<div style="margin: auto;">
				4844	<h3 class="magick-header"><a id="interpolate"></a>-interpolate <var>type</var></h3>
				4845	</div>
				4846
				4847	<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>
				4848
				4849	<p>When looking up the color of a pixel using a non-integer floating point
				4850	value, you typically fall in between the pixel colors defined by the source
				4851	image. This setting determines how the color is determined from the colors of
				4852	the pixels surrounding that point. That is how to determine the color of a
				4853	point that falls between two, or even four different colored pixels. </p>
				4854
				4855	<dl class="dl-horizontal">
				4856	<dt>integer</dt>
				4857	<dd>The color of the top-left pixel (floor function)</dd>
				4858	<dt>nearest-neighbor</dt>
				4859	<dd>The nearest pixel to the lookup point (rounded function)</dd>
				4860	<dt>average</dt>
				4861	<dd>The average color of the surrounding four pixels</dd>
				4862	<dt>bilinear</dt>
				4863	<dd>A double linear interpolation of pixels (the default)</dd>
				4864	<dt>mesh</dt>
				4865	<dd>Divide area into two flat triangular interpolations</dd>
				4866	<dt>bicubic</dt>
				4867	<dd>Fitted bicubic-spines of surrounding 16 pixels</dd>
				4868	<dt>spline</dt>
				4869	<dd>Direct spline curves (colors are blurred)</dd>
				4870	<dt>filter</dt>
				4871	<dd>Use resize <a href="command-line-options.html#filter">-filter</a> settings</dd>
				4872	</dl>
				4873
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4874	<p>This most important for distortion operators such as <a href="command-line-options.html#distort"
				4875	>-distort</a>, <a href="command-line-options.html#implode" >-implode</a>, <a href="command-line-options.html#transform"
				4876	>-transform</a> and <a href="command-line-options.html#fx" >-fx</a>. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4877
				4878	<p>To print a complete list of interpolation methods, use <a href="command-line-options.html#list">-list interpolate</a>.</p>
				4879
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4880	<p>See also <a href="command-line-options.html#virtual-pixel" >-virtual-pixel</a>, for control of the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4881	lookup for positions outside the boundaries of the image. </p>
				4882
				4883
				4884	<div style="margin: auto;">
				4885	<h3 class="magick-header"><a id="interline-spacing"></a>-interline-spacing <var>value</var></h3>
				4886	</div>
				4887
				4888	<p class="magick-description">the space between two text lines.</p>
				4889
				4890	<div style="margin: auto;">
				4891	<h3 class="magick-header"><a id="interword-spacing"></a>-interword-spacing <var>value</var></h3>
				4892	</div>
				4893
				4894	<p class="magick-description">the space between two words.</p>
				4895
				4896	<div style="margin: auto;">
				4897	<h3 class="magick-header"><a id="kerning"></a>-kerning <var>value</var></h3>
				4898	</div>
				4899
				4900	<p class="magick-description">the space between two letters.</p>
				4901
				4902	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4903	<h3 class="magick-header"><a id="kuwahara"></a>-kuwahara <var>radius</var><br />-kuwahara <var>radius</var>x<var>sigma</var></h3>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4904	</div>
				4905
				4906	<p class="magick-description">edge preserving noise reduction filter.</p>
				4907
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4908	<p>The <var >radius</var> is more important than the <var >sigma</var>. If <var >sigma</var> is left off, it will be computed automatically from the <var >radius</var> as <var >sigma</var>=<var >radius</var>-0.5. The <var >sigma</var> provides a bit of additional smoothing control.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4909
				4910
				4911	<div style="margin: auto;">
				4912	<h3 class="magick-header"><a id="label"></a>-label <var>name</var></h3>
				4913	</div>
				4914
				4915	<p class="magick-description">assign a label to an image.</p>
				4916
				4917	<p>Use this option to assign a specific label to the image, as it is read in
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4918	or created. You can use the <a href="command-line-options.html#set" >-set</a> operation to re-assign
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4919	a the labels of images already read in. Image formats such as TIFF, PNG,
				4920	MIFF, supports saving the label information with the image.</p>
				4921
				4922	<p>When saving an image to a <var>PostScript</var> file, any label
				4923	assigned to an image is used as a header string to print above the postscript
				4924	image. </p>
				4925
				4926	<p>You can include the image filename, type, width, height, or other image
				4927	attribute by embedding special format character. See <a href="escape.html">Format and Print Image
				4928	Properties</a> for details of the percent escape codes.</p>
				4929
				4930	<p>For example,</p>
				4931
				4932	<pre>
				4933	-label "%m:%f %wx%h" bird.miff
				4934	</pre>
				4935
				4936	<p>assigns an image label of <code>MIFF:bird.miff 512x480</code> to the
				4937	"<code>bird.miff</code>" image and whose width is 512 and height is 480, as it
				4938	is read in. If a <a href="command-line-options.html#label">+label</a> option was used instead, any
				4939	existing label present in the image would be used. You can remove all labels
				4940	from an image by assigning the empty string. </p>
				4941
				4942	<p>A label is not drawn on the image, but is embedded in the image datastream
				4943	via <var>Label</var> tag or similar mechanism. If you want the label to be
				4944	visible on the image itself, use the <a href="command-line-options.html#draw">-draw</a> option, or
				4945	during the final processing in the creation of an image montage.</p>
				4946
				4947	<p>If the first character of <var>string</var> is <var>@</var>, the image label is read from a file titled by the
				4948	remaining characters in the string. Labels in a file are literal, no embedded
				4949	formatting characters are recognized.</p>
				4950
				4951
				4952	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4953	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4954	</div>
				4955
				4956	<p class="magick-description">perform local adaptive threshold.</p>
				4957
				4958	<p>Adaptively threshold each pixel based on the value of pixels in a
				4959	surrounding window. If the current pixel is lighter than this average plus
				4960	the optional <code>offset</code>, then it is made white, otherwise it is made
				4961	black. Small variations in pixel values such as found in scanned documents
				4962	can be ignored if offset is positive. A negative offset will make it more
				4963	sensitive to those small variations. </p>
				4964
				4965	<p>This is commonly used to threshold images with an uneven background. It is
				4966	based on the assumption that average color of the small window is the
				4967	the local background color, from which to separate the foreground color. </p>
				4968
				4969
				4970	<div style="margin: auto;">
				4971	<h3 class="magick-header"><a id="layers"></a>-layers <var>method</var></h3>
				4972	</div>
				4973
				4974	<p class="magick-description">handle multiple images forming a set of image layers or animation frames.</p>
				4975
				4976	<p>Perform various image operation methods to a ordered sequence of images
				4977	which may represent either a set of overlaid 'image layers', a GIF disposal
				4978	animation, or a fully-'coalesced' animation sequence. </p>
				4979
				4980	<table class="table table-condensed table-striped">
				4981	<tbody>
				4982	<tr>
				4983	<th style="width: 8%">Method</th>
				4984	<th>Description</th>
				4985	</tr>
				4986
				4987	<tr>
				4988	<td>compare-any</td>
				4989	<td>Crop the second and later frames to the smallest rectangle
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4990	that contains all the differences between the two images. No GIF <a
				4991	href="command-line-options.html#dispose" >-dispose</a> methods are taken into account. </td>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4992	</tr>
				4993
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	4994	<tr><td></td><td>This exactly the same as the <a href="command-line-options.html#deconstruct"
				4995	>-deconstruct</a> operator, and does not preserve animations normal
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	4996	working, especially when animation used layer disposal methods such as
				4997	'<code>Previous</code>' or '<code>Background</code>'. </td>
				4998	</tr>
				4999
				5000	<tr>
				5001	<td>compare-clear</td>
				5002	<td>As '<code>compare-any</code>' but crop to the bounds of any
				5003	opaque pixels which become transparent in the second frame. That is the
				5004	smallest image needed to mask or erase pixels for the next frame. </td>
				5005	</tr>
				5006
				5007	<tr>
				5008	<td>compare-overlay</td>
				5009	<td>As '<code>compare-any</code>' but crop to pixels that add
				5010	extra color to the next image, as a result of overlaying color pixels.
				5011	That is the smallest single overlaid image to add or change colors. </td>
				5012	</tr>
				5013
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5014	<tr><td></td><td>This can be used with the <a href="command-line-options.html#compose" >-compose</a> alpha
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5015	composition method '<code>change-mask</code>', to reduce the image to
				5016	just the pixels that need to be overlaid. </td>
				5017	</tr>
				5018
				5019	<tr>
				5020	<td>coalesce</td>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5021	<td>Equivalent to a call to the <a href="command-line-options.html#coalesce"
				5022	>-coalesce</a> operator. Apply the layer disposal methods set in the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5023	current image sequence to form a fully defined animation sequence, as
				5024	it should be displayed. Effectively converting a GIF animation into a
				5025	'film strip'-like animation. </td>
				5026	</tr>
				5027
				5028	<tr>
				5029	<td>composite</td>
				5030	<td>Alpha Composition of two image lists, separated by a
				5031	"<code>null:</code>" image, with the destination image list first, and
				5032	the source images last. An image from each list are composited
				5033	together until one list is finished. The separator image and source
				5034	image lists are removed. </td>
				5035	</tr>
				5036
				5037
				5038	<tr><td></td>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5039	<td>The <a href="command-line-options.html#geometry" >-geometry</a> offset is adjusted according
				5040	to <a href="command-line-options.html#gravity" >-gravity</a> in accordance of the virtual
				5041	canvas size of the first image in each list. Unlike a normal <a
				5042	href="command-line-options.html#composite" >-composite</a> operation, the canvas offset is also
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5043	added to the final composite positioning of each image. </td> </tr>
				5044
				5045	<tr><td></td>
				5046	<td>If one of the image lists only contains one image, that image is
				5047	applied to all the images in the other image list, regardless of which
				5048	list it is. In this case it is the image meta-data of the list which
				5049	preserved. </td>
				5050	</tr>
				5051
				5052
				5053	<tr>
				5054	<td>dispose</td>
				5055	<td>This like '<code>coalesce</code>' but shows the look of
				5056	the animation after the layer disposal method has been applied, before
				5057	the next sub-frame image is overlaid. That is the 'dispose' image that
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5058	results from the application of the GIF <a href="command-line-options.html#dispose"
				5059	>-dispose</a> method. This allows you to check what
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5060	is going wrong with a particular animation you may be developing.
				5061	</td>
				5062	</tr>
				5063
				5064	<tr>
				5065	<td>flatten</td>
				5066	<td>Create a canvas the size of the first images virtual
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5067	canvas using the current <a href="command-line-options.html#background" >-background</a> color,
				5068	and <a href="command-line-options.html#compose" >-compose</a> each image in turn onto that
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5069	canvas. Images falling outside that canvas is clipped. Final
				5070	image will have a zero virtual canvas offset. </td>
				5071	</tr>
				5072
				5073	<tr><td></td>
				5074	<td>This usually used as one of the final 'image layering' operations
				5075	overlaying all the prepared image layers into a final image. </td>
				5076	</tr>
				5077
				5078	<tr><td></td>
				5079	<td>For a single image this method can also be used to fillout a virtual
				5080	canvas with real pixels, or to underlay an opaque color to remove
				5081	transparency from an image.</td>
				5082	</tr>
				5083
				5084
				5085	<tr>
				5086	<td>merge</td>
				5087	<td>As 'flatten' method but merging all the given image
				5088	layers to create a new layer image just large enough to hold all the
				5089	image without clipping or extra space. The new images virtual offset
				5090	will preserve the position of the new layer, even if this offset is
				5091	negative. The virtual canvas size of the first image is preserved.
				5092	</td>
				5093	</tr>
				5094
				5095	<tr><td></td><td>Caution is advised when handling image layers with
				5096	negative offsets as few image file formats handle them correctly.
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5097	Following this operation method with <a href="command-line-options.html#repage" >+repage</a>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5098	will remove the layer offset, and create an image in which all the
				5099	overlaid image positions relative to each other is preserved, though
				5100	not necessarily exactly where you specified them.
				5101	</td>
				5102	</tr>
				5103
				5104	<tr><td></td><td>See also 'trim-bounds' below which is closely related but
				5105	without doing the'flatten' to merge the images together. </td>
				5106	</tr>
				5107
				5108	<tr>
				5109	<td>mosaic</td>
				5110	<td>As 'flatten' method but expanding the initial canvas size
				5111	of the first image in a positive direction only so as to hold all the
				5112	image layers. However as a virtual canvas is 'locked' to the origin,
				5113	by its own definition, image layers with a negative offsets will still
				5114	become clipped by the top and left edges. See 'merge' or 'trim-bounds'
				5115	if this could be a problem. </td>
				5116
				5117	</tr>
				5118
				5119	<tr><td></td><td>This method is commonly used to layout individual image
				5120	using various offset but without knowing the final canvas size. The
				5121	resulting image will, like 'flatten' not have any virtual offset, so
				5122	can be saved to any image file format. </td>
				5123	</tr>
				5124
				5125
				5126	<tr>
				5127	<td>optimize</td>
				5128	<td>Optimize a coalesced animation, into GIF animation using
				5129	a number of general techniques. This currently a short cut to
				5130	apply both the '<code>optimize-frame</code>', and
				5131	'<code>optimize-transparency</code>' methods but may be expanded to
				5132	include other optimization methods as they are developed. </td>
				5133	</tr>
				5134
				5135	<tr>
				5136	<td>optimize-frame</td>
				5137	<td>Optimize a coalesced animation, into GIF animation by
				5138	reducing the number of pixels per frame as much as possible by
				5139	attempting to pick the best layer disposal method to use, while ensuring
				5140	the result will continue to animate properly. </td>
				5141	</tr>
				5142
				5143	<tr><td></td><td> There is no guarantee that the best optimization is found.
				5144	But then no reasonably fast GIF optimization algorithm can do this.
				5145	However this does seem to do better than most other GIF frame
				5146	optimizers seen. </td>
				5147	</tr>
				5148
				5149	<tr>
				5150	<td>optimize-plus</td>
				5151	<td>As '<code>optimize-frame</code>' but attempt to improve the
				5152	overall optimization by adding extra frames to the animation, without
				5153	changing the final look or timing of the animation. The frames are
				5154	added to attempt to separate the clearing of pixels from the
				5155	overlaying of new additional pixels from one animation frame to the
				5156	next. If this does not improve the optimization (for the next frame
				5157	only), it will fall back to the results of the previous normal
				5158	'<code>optimize-frame</code>' technique. </td>
				5159	</tr>
				5160
				5161	<tr><td></td><td>There is the possibility that the change in the disposal
				5162	style will result in a worsening in the optimization of later frames,
				5163	though this is unlikely. In other words there no guarantee that it is
				5164	better than the normal '<code>optimize-frame</code>' technique. For some
				5165	animations however you can get a vast improvement in the final
				5166	animation size. </td>
				5167	</tr>
				5168
				5169	<tr>
				5170	<td>optimize-transparency</td>
				5171	<td>Given a GIF animation, replace any pixel in the sub-frame
				5172	overlay images with transparency, if it does not change the resulting
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5173	animation by more than the current <a href="command-line-options.html#fuzz" >-fuzz</a> factor.
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5174	</td>
				5175	</tr>
				5176
				5177	<tr><td></td><td>This should allow a existing frame optimized GIF animation
				5178	to compress into a smaller file size due to larger areas of one
				5179	(transparent) color rather than a pattern of multiple colors repeating
				5180	the current disposed image of the last frame. </td>
				5181	</tr>
				5182
				5183	<tr>
				5184	<td>remove-dups</td>
				5185	<td>Remove (and merge time delays) of duplicate consecutive
				5186	images, so as to simplify layer overlays of coalesced animations.
				5187	</td>
				5188	</tr>
				5189
				5190	<tr><td></td><td>Usually this a result of using a constant time delay
				5191	across the whole animation, or after a larger animation was split into
				5192	smaller sub-animations. The duplicate frames could also have been
				5193	used as part of some frame optimization methods. </td>
				5194	</tr>
				5195
				5196	<tr>
				5197	<td>remove-zero</td>
				5198	<td>Remove any image with a zero time delay, unless ALL the
				5199	images have a zero time delay (and is not a proper timed animation, a
				5200	warning is then issued). </td>
				5201	</tr>
				5202
				5203	<tr><td></td><td>In a GIF animation, such images are usually frames which
				5204	provide partial intermediary updates between the frames that are
				5205	actually displayed to users. These frames are usually added for
				5206	improved frame optimization in GIF animations. </td>
				5207	</tr>
				5208
				5209	<tr>
				5210	<td>trim-bounds</td>
				5211	<td>Find the bounds of all the images in the current
				5212	image sequence, then adjust the offsets so all images are contained on
				5213	a minimal positive canvas. None of the image data is modified or
				5214	merged, only the individual image virtual canvas size and offset.
				5215	All the images is given the same canvas size, and and will have
				5216	a positive offset, but will remain in the same position relative to
				5217	each other. As a result of the minimal canvas size at least one image
				5218	will touch every edge of that canvas. The image data touching those
				5219	edges however may be transparent. </td>
				5220	</tr>
				5221
				5222	<tr><td></td><td>The result is much like if you used 'merge' followed by a
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5223	<a href="command-line-options.html#repage" >+repage</a> option, except that all the images
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5224	have been kept separate. If 'flatten' is used after using
				5225	'trim-bounds' you will get the same result. </td>
				5226	</tr>
				5227
				5228	</tbody>
				5229	</table>
				5230
				5231	<p>To print a complete list of layer types, use <a href="command-line-options.html#list">-list layers</a>.</p>
				5232
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5233	<p>The operators <a href="command-line-options.html#coalesce" >-coalesce</a>, <a href="command-line-options.html#deconstruct"
				5234	>-deconstruct</a>, <a href="command-line-options.html#flatten" >-flatten</a>, and <a href="command-line-options.html#mosaic"
				5235	>-mosaic</a> are only aliases for the above methods and may be depreciated in
				5236	the future. Also see <a href="command-line-options.html#page" >-page</a>, <a href="command-line-options.html#repage"
				5237	>-repage</a> operators, the <a href="command-line-options.html#compose" >-compose</a> setting, and the
				5238	GIF <a href="command-line-options.html#dispose" >-dispose</a> and <a href="command-line-options.html#delay" >-delay</a>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5239	settings. </p>
				5240
				5241
				5242	<div style="margin: auto;">
				5243	<h3 class="magick-header"><a id="level"></a>-level <var>black_point</var>{,<var>white_point</var>}{<var>%</var>}{,<var>gamma</var>}</h3>
				5244	</div>
				5245
				5246	<p class="magick-description">adjust the level of image channels.</p>
				5247
				5248	<p>Given one, two or three values delimited with commas: black-point,
				5249	white-point, gamma (for example: 10,250,1.0 or 2%,98%,0.5). The black and
				5250	white points range from 0 to <var>QuantumRange</var>, or from 0 to
				5251	100%; if the white point is omitted it is set to (<var>QuantumRange</var> - black_point), so as to center contrast changes.
				5252	If a <code>%</code> sign is present anywhere in the string, both black and white
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5253	points are percentages of the full color range. Gamma will do a <a
				5254	href="command-line-options.html#gamma">-gamma</a> adjustment of the values. If it is omitted, the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5255	default of 1.0 (no gamma correction) is assumed.</p>
				5256
				5257	<p>In normal usage (<code>-level</code>) the image values are stretched so that
				5258	the given '<code>black_point</code>' value in the original image is set to zero
				5259	(or black), while the given '<code>white_point</code>' value is set to <var>QuantumRange</var> (or white). This provides you with direct
				5260	contrast adjustments to the image. The '<code>gamma</code>' of the resulting
				5261	image will then be adjusted. </p>
				5262
				5263	<p>From ImageMagick v6.4.1-9 using the plus form of the operator
				5264	(<code>+level</code>) or adding the special '!' flag anywhere in the argument
				5265	list, will cause the operator to do the reverse of the level adjustment. That
				5266	is a zero, or <var>QuantumRange</var> value (black, and white, resp.)
				5267	in the original image, is adjusted to the given level values, allowing you to
				5268	de-contrast, or compress the channel values within the image. The
				5269	'<code>gamma</code>' is adjusted before the level adjustment to de-contrast the
				5270	image is made. </p>
				5271
				5272	<p>Only the channels defined by the current <a href="command-line-options.html#channel">-channel</a>
				5273	setting are adjusted (defaults to RGB color channels only), allowing you to
				5274	limit the effect of this operator. </p>
				5275
				5276	<p>Please note that the transparency channel is treated as 'matte'
				5277	values (0 is opaque) and not as 'alpha' values (0 is transparent).</p>
				5278
				5279
				5280	<div style="margin: auto;">
				5281	<h3 class="magick-header"><a id="level-colors"></a>-level-colors {<var>black_color</var>}{,}{<var>white_color</var>}</h3>
				5282	</div>
				5283
				5284	<p class="magick-description">adjust the level of an image using the provided dash separated colors.</p>
				5285
				5286	<p>This function is exactly like <a href="command-line-options.html#level">-level</a>, except that the
				5287	value value for each color channel is determined by the
				5288	'<code>black_color</code>' and '<code>white_color</code>' colors given (as
				5289	described under the <a href="command-line-options.html#fill">-fill</a> option). </p>
				5290
				5291	<p>This effectually means the colors provided to <code>-level-colors</code>
				5292	is mapped to become 'black' and 'white' respectively, with all the other
				5293	colors linearly adjusted (or clipped) to match that change. Each channel is
				5294	adjusted separately using the channel values of the colors specified. </p>
				5295
				5296	<p>On the other hand the plus form of the operator (<code>+level-colors</code>)
				5297	will map the image color 'black' and 'white' to the given colors
				5298	respectively, resulting in a gradient (de-contrasting) tint of the image to
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	5299	those colors. This can also be used to convert a plain grayscale image into a
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5300	one using the gradient of colors specified. </p>
				5301
				5302	<p>By supplying a single color with a comma separator either before or after
				5303	that color, will just replace the respective 'black' or 'white' point
				5304	respectively. But if no comma separator is provided, the given color is
				5305	used for both the black and white color points, making the operator either
				5306	threshold the images around that color (- form) or set all colors to that
				5307	color (+ form). </p>
				5308
				5309
				5310	<div style="margin: auto;">
				5311	<h3 class="magick-header"><a id="limit"></a>-limit <var>type value</var></h3>
				5312	</div>
				5313
				5314	<p class="magick-description">Set the pixel cache resource limit.</p>
				5315
Cristy	e09ed31	2016-03-06 08:07:39 -0500	[diff] [blame]	5316	<p>Choose from: <code>width</code>, <code>height</code>, <code>area</code>, <code>memory</code>, <code>map</code>, <code>disk</code>, <code>file</code>, <code>thread</code>, <code>throttle</code>, or <code>time</code>.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5317
				5318	<p>The value for <code>file</code> is in number of files. The other limits are
				5319	in bytes. Define arguments for the memory, map, area, and disk resource limits
				5320	with SI prefixes (.e.g 100MB).</p>
				5321
				5322	<p>By default the limits are 768 files, 3GB of image area, 1.5GiB memory, 3GiB
				5323	memory map, and 18.45EB of disk. These limits are adjusted relative to the
				5324	available resources on your computer if this information is available. When
				5325	any limit is reached, ImageMagick fails in some fashion but attempts to take
				5326	compensating actions, if possible. For example, the following limits
				5327	memory:</p>
				5328
				5329	<pre>
				5330	-limit memory 32MiB -limit map 64MiB
				5331	</pre>
				5332
				5333	<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>
				5334
				5335	<pre>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5336	-> identify -list resource
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5337	Resource limits:
				5338	Width: 100MP
				5339	Height: 100MP
				5340	Area: 25.181GB
				5341	Memory: 11.726GiB
				5342	Map: 23.452GiB
				5343	Disk: unlimited
				5344	File: 768
				5345	Thread: 12
				5346	Throttle: 0
				5347	Time: unlimited
				5348	</pre>
				5349
				5350	<p>Requests for pixel storage to keep intermediate images are satisfied by one
				5351	of three resource categories: in-memory pool, memory-mapped files pool, and
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5352	disk pool (in that order) depending on the <a href="command-line-options.html#limit">‑limit</a> settings
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5353	and whether the system honors a resource request. If the total size of
				5354	allocated pixel storage in the given pool reaches the corresponding limit, the
				5355	request is passed to the next pool. Additionally, requests that exceed the
				5356	<code>area</code> limit automagically are allocated on disk.</p>
				5357
				5358	<p>To illustrate how ImageMagick utilizes resource limits, consider a typical
				5359	image resource request. First, ImageMagick tries to allocate the pixels in
				5360	memory. The request might be denied if the resource request exceeds the
				5361	<code>memory</code> limit or if the system does not honor the request. If
				5362	a memory request is not honored, the pixels are allocated to disk and the file
				5363	is memory-mapped. However, if the allocation request exceeds the
				5364	<code>map</code> limit, the resource allocation goes to disk. In all cases, if
				5365	the resource request exceeds the <code>area</code> limit, the pixels are
				5366	automagically cached to disk. If the disk has a hard limit, the program
				5367	fails.</p>
				5368
				5369	<p>In most cases you simply do not need to concern yourself with resource
				5370	limits. ImageMagick chooses reasonable defaults and most images do not tax
				5371	your computer resources. Where limits do come in handy is when you process
				5372	images that are large or on shared systems where ImageMagick can consume all
				5373	or most of the available memory. In this case, the ImageMagick workflow slows
				5374	other processes or, in extreme cases, brings the system to a halt. Under
				5375	these circumstances, setting limits give some assurances that the ImageMagick
				5376	workflow will not interfere with other concurrent uses of the computer. For
				5377	example, assume you have a web interface that processes images uploaded from
				5378	the Internet. To assure ImageMagick does not exceed 10MiB of memory you can
				5379	simply set the area limit to 10MiB:</p>
				5380
				5381	<pre>
				5382	-limit area 10MB
				5383	</pre>
				5384
				5385	<p>Now whenever a large image is processed, the pixels are automagically
				5386	cached to disk instead of memory. This of course implies that large images
				5387	typically process very slowly, simply because pixel processing in memory can
				5388	be an order of magnitude faster than on disk. Because your web site users
				5389	might inadvertently upload a huge image to process, you should set a disk
				5390	limit as well:</p>
				5391
				5392	<pre>
				5393	-limit area 10MB -limit disk 500MB
				5394	</pre>
				5395
				5396	<p>Here ImageMagick stops processing if an image requires more than 500MB of disk storage.</p>
				5397
				5398	<p>In addition to command-line resource limit option, resources can be set
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5399	with <a href="resources.html#environment" >environment variables</a>. Set the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5400	environment variables <code>MAGICK_AREA_LIMIT</code>,
				5401	<code>MAGICK_DISK_LIMIT</code>, <code>MAGICK_FILE_LIMIT</code>,
				5402	<code>MAGICK_MEMORY_LIMIT</code>, <code>MAGICK_MAP_LIMIT</code>,
				5403	<code>MAGICK_THREAD_LIMIT</code>, <code>MAGICK_TIME_LIMIT</code> for limits of
				5404	image area, disk space, open files, heap memory, memory map, number of threads
				5405	of execution, and maximum elapsed time in seconds respectively.</p>
				5406
				5407	<p> Inquisitive users can try adding <a href="command-line-options.html#debug">-debug cache</a> to
				5408	their commands and then scouring the generated output for references to the
				5409	pixel cache, in order to determine how the pixel cache was allocated and how
				5410	resources were consumed. Advanced Unix/Linux users can pipe that output
				5411	through <code>grep memory\|open\|destroy\|disk</code> for more readable sifting.
				5412	</p>
				5413
				5414	<p>For more about ImageMagick's use of resources, see the section <b>Cache
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5415	Storage and Resource Requirements</b> on the <a href="architecture.html#cache
				5416	">Architecture</a> page. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5417
				5418	<div style="margin: auto;">
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	5419	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5420	</div>
				5421
				5422	<p class="magick-description">Linear with saturation stretch.</p>
				5423
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5424	<p>This is very similar to <a href="command-line-options.html#contrast-stretch" >-contrast-stretch</a>,
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5425	and uses a 'histogram bin' to determine the range of color values that needs to
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5426	be stretched. However it then stretches those colors using the <a
				5427	href="command-line-options.html#level" >-level</a> operator.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5428
				5429	<p>As such while the initial determination may have 'binning' round off
				5430	effects, the image colors are stretched mathematically, rather than using the
				5431	histogram bins. This makes the operator more accurate. </p>
				5432
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5433	<p>note however that a <a href="command-line-options.html#linear-stretch" >-linear-stretch</a> of
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5434	'<code>0</code>' does nothing, while a value of '<code>1</code>' does a near
				5435	perfect stretch of the color range. </p>
				5436
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5437	<p>See also <a href="command-line-options.html#auto-level" >-auto-level</a> for a 'perfect'
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5438	normalization of mathematical images. </p>
				5439
				5440	<p>This operator is under review for re-development. </p>
				5441
				5442
				5443	<div style="margin: auto;">
				5444	<h3 class="magick-header"><a id="linewidth"></a>-linewidth</h3>
				5445	</div>
				5446
				5447	<p class="magick-description">the line width for subsequent draw operations.</p>
				5448
				5449	<div style="margin: auto;">
				5450	<h3 class="magick-header"><a id="liquid-rescale"></a>-liquid-rescale <var>geometry</var></h3>
				5451	</div>
				5452
				5453	<p class="magick-description">rescale image with seam-carving.</p>
				5454
				5455	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
				5456
				5457	<div style="margin: auto;">
				5458	<h3 class="magick-header"><a id="list"></a>-list <var>type</var></h3>
				5459	</div>
				5460
				5461	<p class="magick-description">Print a list of supported arguments for various options or settings. Choose from these list types:</p>
				5462
				5463	<pre class="pre-scrollable">
				5464	Align
				5465	Alpha
				5466	Boolean
				5467	Cache
				5468	Channel
				5469	Class
				5470	ClipPath
				5471	Coder
				5472	Color
				5473	Colorspace
				5474	Command
				5475	Complex
				5476	Compose
				5477	Compress
				5478	Configure
				5479	DataType
				5480	Debug
				5481	Decoration
				5482	Delegate
				5483	Direction
				5484	Dispose
				5485	Distort
				5486	Dither
				5487	Endian
				5488	Evaluate
				5489	FillRule
				5490	Filter
				5491	Font
				5492	Format
				5493	Function
				5494	Gravity
				5495	Intensity
				5496	Intent
				5497	Interlace
				5498	Interpolate
				5499	Kernel
				5500	Layers
				5501	LineCap
				5502	LineJoin
				5503	List
				5504	Locale
				5505	LogEvent
				5506	Log
				5507	Magic
				5508	Method
				5509	Metric
				5510	Mime
				5511	Mode
				5512	Morphology
				5513	Module
				5514	Noise
				5515	Orientation
				5516	PixelIntensity
				5517	Policy
				5518	PolicyDomain
				5519	PolicyRights
				5520	Preview
				5521	Primitive
				5522	QuantumFormat
				5523	Resource
				5524	SparseColor
				5525	Statistic
				5526	Storage
				5527	Stretch
				5528	Style
				5529	Threshold
				5530	Type
				5531	Units
				5532	Validate
				5533	VirtualPixel
				5534	</pre>
				5535
				5536	<p>These lists vary depending on your version of ImageMagick. Use "<code>-list
				5537	list</code>" to get a complete listing of all the "<code>-list</code>" arguments
				5538	available:</p>
				5539
				5540	<pre>
				5541	identify -list list
				5542	</pre>
				5543
				5544	<div style="margin: auto;">
				5545	<h3 class="magick-header"><a id="log"></a>-log <var>string</var></h3>
				5546	</div>
				5547
				5548	<p class="magick-description">Specify format for debug log.</p>
				5549
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5550	<p>This option specifies the format for the log printed when the <a
				5551	href="command-line-options.html#debug">-debug</a> option is active.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5552
				5553	<p>You can display the following components by embedding special format
				5554	characters:</p>
				5555
				5556	<dl class="dl-horizontal">
				5557	<dt>%d</dt><dd>domain</dd>
				5558	<dt>%e</dt><dd>event</dd>
				5559	<dt>%f</dt><dd>function</dd>
				5560	<dt>%l</dt><dd>line</dd>
				5561	<dt>%m</dt><dd>module</dd>
				5562	<dt>%p</dt><dd>process ID</dd>
				5563	<dt>%r</dt><dd>real CPU time</dd>
				5564	<dt>%t</dt><dd>wall clock time</dd>
				5565	<dt>%u</dt><dd>user CPU time</dd>
				5566	<dt>%%</dt><dd>percent sign</dd>
				5567	<dt>\n</dt><dd>newline</dd>
				5568	<dt>\r</dt><dd>carriage return</dd>
				5569	</dl>
				5570
				5571	<p>For example:</p>
				5572
				5573	<pre>
				5574	convert -debug coders -log "%u %m:%l %e" in.gif out.png
				5575	</pre>
				5576
				5577	<p>The default behavior is to print all of the components.</p>
				5578
				5579	<div style="margin: auto;">
				5580	<h3 class="magick-header"><a id="loop"></a>-loop <var>iterations</var></h3>
				5581	</div>
				5582
				5583	<p class="magick-description">add Netscape loop extension to your GIF animation.</p>
				5584
				5585	<p>Set iterations to zero to repeat the animation an infinite number of times,
				5586	otherwise the animation repeats itself up to <var>iterations</var>
				5587	times.</p>
				5588
				5589	<div style="margin: auto;">
				5590	<h3 class="magick-header"><a id="lowlight-color"></a>-lowlight-color <var>color</var></h3>
				5591	</div>
				5592
				5593	<p class="magick-description">when comparing images, de-emphasize pixel differences with this color.</p>
				5594
				5595	<div style="margin: auto;">
				5596	<h3 class="magick-header"><a id="magnify"></a>-magnify</h3>
				5597	</div>
				5598
				5599	<p class="magick-description">double the size of the image with pixel art scaling.</p>
				5600
				5601
				5602	<div style="margin: auto;">
				5603	<h3 class="magick-header"><a id="map"></a>-map <var>type</var></h3>
				5604	</div>
				5605
				5606	<p class="magick-description">Display image using this <var>type</var>.</p>
				5607
				5608	<p>Choose from these <var>Standard Colormap</var> types:</p>
				5609
				5610	<pre>
				5611	best
				5612	default
				5613	gray
				5614	red
				5615	green
				5616	blue
				5617	</pre>
				5618
				5619	<p>The <var>X server</var> must support the <var>Standard
				5620	Colormap</var> you choose, otherwise an error occurs. Use <code>list</code> as
				5621	the type and <code>display</code> searches the list of colormap types in
				5622	<code>top-to-bottom</code> order until one is located. See <var>xstdcmap(1)</var> for one way of creating Standard Colormaps.</p>
				5623
				5624
				5625	<div style="margin: auto;">
				5626	<h3 class="magick-header"><a id="map_stream_"></a>-map <var>components</var></h3>
				5627	</div>
				5628
				5629	<p class="magick-description">pixel map.</p>
				5630
				5631	<p>Here are the valid components of a map:</p>
				5632
				5633	<dl class="dl-horizontal">
				5634	<dt>r</dt><dd> red pixel component</dd>
				5635	<dt>g</dt><dd> green pixel component</dd>
				5636	<dt>b</dt><dd> blue pixel component</dd>
				5637	<dt>a</dt><dd> alpha pixel component (0 is transparent)</dd>
				5638	<dt>o</dt><dd> opacity pixel component (0 is opaque)</dd>
				5639	<dt>i</dt><dd> grayscale intensity pixel component</dd>
				5640	<dt>c</dt><dd> cyan pixel component</dd>
				5641	<dt>m</dt><dd> magenta pixel component</dd>
				5642	<dt>y</dt><dd> yellow pixel component</dd>
				5643	<dt>k</dt><dd> black pixel component</dd>
				5644	<dt>p</dt><dd> pad component (always 0)</dd>
				5645	</dl>
				5646
				5647	<p>You can specify as many of these components as needed in any order (e.g.
				5648	bgr). The components can repeat as well (e.g. rgbr).</p>
				5649
				5650
				5651	<div style="margin: auto;">
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5652	<h3 class="magick-header"><a id="mattecolor"></a>-mattecolor <var>color</var></h3>
				5653	</div>
				5654
				5655	<p class="magick-description">Specify the color to be used with the <a href="command-line-options.html#frame">-frame</a> option.</p>
				5656
				5657	<p>The color is specified using the format described under the <a href="command-line-options.html#fill">-fill</a> option.</p>
				5658
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5659	<p>The default matte color is <code>#BDBDBD</code>, <span
				5660	style="background-color: #bdbdbd;">this shade of gray</span>.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5661
Cristy	f650f4f	2016-04-01 10:53:07 -0400	[diff] [blame]	5662	<p>This is an IMv6 option, use <a href="command-line-options.html#alpha-color">-alpha-color</a> with IMv7.</p>
				5663
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5664	<div style="margin: auto;">
				5665	<h3 class="magick-header"><a id="maximum"></a>-maximum</h3>
				5666	</div>
				5667
				5668	<p class="magick-description">return the maximum intensity of an image sequence.</p>
				5669
				5670	<p>Select the 'maximum' value from all the surrounding pixels. </p>
				5671
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5672	<p>This is legacy option from the <a href="command-line-options.html#statistic" >method</a> of the same
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5673	name. </p>
				5674
				5675	<div style="margin: auto;">
				5676	<h3 class="magick-header"><a id="median"></a>-median <var>geometry</var></h3>
				5677	</div>
				5678
				5679	<p class="magick-description">apply a median filter to the image.</p>
				5680
				5681	<p>Select the 'middle' value from all the surrounding pixels. </p>
				5682
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5683	<p>This is legacy option from the <a href="command-line-options.html#statistic" >method</a> of the same
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5684	name. </p>
				5685
				5686	<div style="margin: auto;">
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	5687	<h3 class="magick-header"><a id="mean-shift"></a>-mean-shift <var>width</var>x<var>height</var>{<var>+distance</var>{%}</h3>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5688	</div>
				5689
				5690	<p class="magick-description">image noise removal and color reduction/segmentation (e.g. -mean-shift 7x7+10%).</p>
				5691
				5692	<p><var>width</var>x<var>height</var> is the window size and <var>distance</var> is the color distance measured in the range 0 to 1 or 0 to 100%</p>
				5693
				5694	<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>
				5695
				5696	<div style="margin: auto;">
				5697	<h3 class="magick-header"><a id="metric"></a>-metric <var>type</var></h3>
				5698	</div>
				5699
				5700	<p class="magick-description">Output to STDERR a measure of the differences between images according to the <var>type</var> given metric.</p>
				5701
				5702	<p>Choose from:</p>
				5703
				5704	<dl class="dl-horizontal">
				5705	<dt>AE</dt><dd> absolute error count, number of different pixels (-fuzz effected)</dd>
				5706	<dt>FUZZ</dt><dd> mean color distance</dd>
				5707	<dt>MAE</dt><dd> mean absolute error (normalized), average channel error distance</dd>
				5708	<dt>MEPP</dt><dd> mean error per pixel (normalized mean error, normalized peak error)</dd>
				5709	<dt>MSE</dt><dd> mean error squared, average of the channel error squared</dd>
				5710	<dt>NCC</dt><dd> normalized cross correlation</dd>
				5711	<dt>PAE</dt><dd> peak absolute (normalized peak absolute)</dd>
Cristy	3b0b58d	2016-11-06 07:40:23 -0500	[diff] [blame]	5712	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5713	<dt>PSNR</dt><dd> peak signal to noise ratio</dd>
				5714	<dt>RMSE</dt><dd> root mean squared (normalized root mean squared)</dd>
				5715	</dl>
				5716
				5717	<p>Control the '<code>AE</code>', or absolute count of pixels that are different,
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5718	with the <a href="command-line-options.html#fuzz" >-fuzz</a> factor (ignore pixels which
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5719	only changed by a small amount). Use '<code>PAE</code>' to find the
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5720	size of the <a href="command-line-options.html#fuzz" >-fuzz</a> factor needed to make all pixels
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5721	'similar', while '<code>MAE</code>' determines the factor needed
				5722	for about half the pixels to be similar. </p>
				5723
				5724	<p>The '<code>MEPP</code>' metric returns three different metrics
				5725	('<code>MAE</code>', '<code>MAE</code>' normalized, and '<code>PAE</code>'
				5726	normalized) from a single comparison run. </p>
				5727
				5728	<p>To print a complete list of metrics, use the <a href="command-line-options.html#list">-list
				5729	metric</a> option.</p>
				5730
				5731
				5732	<div style="margin: auto;">
				5733	<h3 class="magick-header"><a id="minimum"></a>-minimum</h3>
				5734	</div>
				5735
				5736	<p class="magick-description">return the minimum intensity of an image sequence.</p>
				5737
				5738	<p>Select the 'minimal' value from all the surrounding pixels. </p>
				5739
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5740	<p>This is legacy option from the <a href="command-line-options.html#statistic" >method</a> of the same
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5741	name. </p>
				5742
				5743
				5744
				5745	<div style="margin: auto;">
				5746	<h3 class="magick-header"><a id="mode"></a>-mode <var>geometry</var></h3>
				5747	</div>
				5748
				5749	<p class="magick-description">make each pixel the \'predominant color\' of the neighborhood.'</p>
				5750
				5751	<div style="margin: auto;">
				5752	<h3 class="magick-header">-mode <var>value</var></h3>
				5753	</div>
				5754
				5755	<p class="magick-description">Mode of operation.</p>
				5756
				5757	<p>Choose the <var>value</var> from these styles: <code>Frame,
				5758	Unframe, or Concatenate</code></p>
				5759
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5760	<p>Use the <a href="command-line-options.html#list" >-list</a> option with a '<code>Mode</code>' argument
				5761	for a list of <a href="command-line-options.html#mode" >-mode</a> arguments available in your
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5762	ImageMagick installation.</p>
				5763
				5764
				5765	<div style="margin: auto;">
				5766	<h3 class="magick-header"><a id="modulate"></a>-modulate <var>brightness</var>[,<var>saturation</var>,<var>hue</var>]</h3>
				5767	</div>
				5768
				5769	<p class="magick-description">Vary the <var>brightness</var>, <var>saturation</var>, and <var>hue</var> of an image.</p>
				5770
				5771	<p>The arguments are given as a percentages of variation. A value of 100 means
				5772	no change, and any missing values are taken to mean 100.</p>
				5773
				5774	<p>The <var>brightness</var> is a multiplier of the overall
				5775	brightness of the image, so 0 means pure black, 50 is half as bright, 200 is
				5776	twice as bright. To invert its meaning <a href="command-line-options.html#negate">-negate</a> the image
				5777	before and after. </p>
				5778
				5779	<p>The <var>saturation</var> controls the amount of color in an
				5780	image. For example, 0 produce a grayscale image, while a large value such as
				5781	200 produce a very colorful, 'cartoonish' color.</p>
				5782
				5783	<p>The <var>hue</var> argument causes a "rotation" of the colors
				5784	within the image by the amount specified. For example, 50 results in
				5785	a counter-clockwise rotation of 90, mapping red shades to purple, and so on.
				5786	A value of either 0 or 200 results in a complete 180 degree rotation of the
				5787	image. Using a value of 300 is a 360 degree rotation resulting in no change to
				5788	the original image. </p>
				5789
				5790	<p>For example, to increase the color brightness by 20% and decrease the color
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5791	saturation by 10% and leave the hue unchanged, use <a
				5792	href="command-line-options.html#modulate">-modulate 120,90</a>.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5793
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5794	<p>Use <a href="command-line-options.html#set">-set</a> attribute of '<code
				5795	>option:modulate:colorspace</code>' to specify which colorspace to
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5796	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>
				5797
				5798	<pre>
				5799	convert image.png -set option:modulate:colorspace hsb -modulate 120,90 modulate.png
				5800	</pre>
				5801
				5802	<div style="margin: auto;">
				5803	<h3 class="magick-header"><a id="moments"></a>-moments</h3>
				5804	</div>
				5805
				5806	<p class="magick-description">report image moments and perceptual hash.</p>
				5807
				5808
				5809	<div style="margin: auto;">
				5810	<h3 class="magick-header"><a id="monitor"></a>-monitor</h3>
				5811	</div>
				5812
				5813	<p class="magick-description">monitor progress.</p>
				5814
				5815
				5816	<div style="margin: auto;">
				5817	<h3 class="magick-header"><a id="monochrome"></a>-monochrome</h3>
				5818	</div>
				5819
				5820	<p class="magick-description">transform the image to black and white.</p>
				5821
				5822	<div style="margin: auto;">
				5823	<h3 class="magick-header"><a id="morph"></a>-morph <var>frames</var></h3>
				5824	</div>
				5825
				5826	<p class="magick-description">morphs an image sequence.</p>
				5827
				5828	<p>Both the image pixels and size are linearly interpolated to give the
				5829	appearance of a metamorphosis from one image to the next, over all the images
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5830	in the current image list. The added images are the equivalent of a <a
				5831	href="command-line-options.html#blend">-blend</a> composition. The <var>frames</var>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5832	argument determine how many images to interpolate between each image. </p>
				5833
				5834
				5835	<div style="margin: auto;">
				5836	<h3 class="magick-header"><a id="morphology"></a>-morphology</h3>
				5837	<h3 class="magick-header">-morphology <var>method</var> <var>kernel</var></h3>
				5838	</div>
				5839
				5840	<p class="magick-description">apply a morphology method to the image.</p>
				5841
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5842	<p>Until I get around to writing an option summary for this, see <a
Cristy	364a72f	2016-11-04 22:38:41 -0400	[diff] [blame]	5843	href="https://www.imagemagick.org/Usage/morphology/" >IM Usage Examples,
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5844	Morphology</a>. </p>
				5845
				5846
				5847	<div style="margin: auto;">
				5848	<h3 class="magick-header"><a id="mosaic"></a>-mosaic</h3>
				5849	</div>
				5850
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5851	<p class="magick-description">an simple alias for the <a href="command-line-options.html#layers" >-layers</a> method "mosaic"</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5852
				5853
				5854	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5855	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5856	</div>
				5857
				5858	<p class="magick-description">simulate motion blur.</p>
				5859
				5860	<p>Blur with the given radius, standard deviation (sigma), and angle. The
				5861	angle given is the angle toward which the image is blurred. That is the
				5862	direction people would consider the object is coming from. </p>
				5863
				5864	<p>Note that the blur is not uniform distribution, giving the motion a
				5865	definite sense of direction of movement. </p>
				5866
				5867	<p>The <a href="command-line-options.html#virtual-pixel">-virtual-pixel</a> setting will determine how
				5868	pixels which are outside the image proper are blurred into the final result.
				5869	</p>
				5870
				5871	<div style="margin: auto;">
				5872	<h3 class="magick-header"><a id="name"></a>-name</h3>
				5873	</div>
				5874
				5875	<p class="magick-description">name an image.</p>
				5876	<div style="margin: auto;">
				5877	<h3 class="magick-header"><a id="negate"></a>-negate</h3>
				5878	</div>
				5879
				5880	<p class="magick-description">replace each pixel with its complementary color.</p>
				5881
				5882	<p>The red, green, and blue intensities of an image are negated. White becomes
				5883	black, yellow becomes blue, etc. Use <a href="command-line-options.html#negate">+negate</a> to only
				5884	negate the grayscale pixels of the image.</p>
				5885
				5886	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5887	<h3 class="magick-header"><a id="noise"></a>-noise <var>geometry</var><br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5888	+noise <var>type</var></h3>
				5889	</div>
				5890
				5891	<p class="magick-description">Add or reduce noise in an image.</p>
				5892
				5893	<p>The principal function of noise peak elimination filter is to smooth the
				5894	objects within an image without losing edge information and without creating
				5895	undesired structures. The central idea of the algorithm is to replace a pixel
				5896	with its next neighbor in value within a pixel window, if this pixel has been
				5897	found to be noise. A pixel is defined as noise if and only if this pixel is
				5898	a maximum or minimum within the pixel window.</p>
				5899
				5900	<p>Use <code><a href="command-line-options.html#noise">-noise</a> <var>radius</var></code> to
				5901	specify the width of the neighborhood when reducing noise. This is equivalent
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5902	to using a <code><a href="command-line-options.html#statistic" >-statistic</a> NonPeak</code> operation,
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5903	which should be used in preference.</p>
				5904
				5905	<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
				5906	types:</p>
				5907
				5908	<pre>
				5909	Gaussian
				5910	Impulse
				5911	Laplacian
				5912	Multiplicative
				5913	Poisson
				5914	Random
				5915	Uniform
				5916	</pre>
				5917
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5918	<p>The amount of noise added can be controlled by the <code><a
				5919	href="command-line-options.html#attenuate" >-attenuate</a></code> setting. If unset the value is
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5920	equivalent to 1.0, or a maximum noise addition.</p>
				5921
				5922	<p>Note that Random will replace the image with noise rather than add noise to the image. Use Uniform, if you wish to add random noise to the image.</p>
				5923
				5924	<p>To print a complete list of noises, use the <a href="command-line-options.html#list">-list noise</a> option.</p>
				5925
				5926	<p>Also see the <a href="command-line-options.html#evaluate">-evaluate</a> noise functions that allows
				5927	the use of a controlling value to specify the amount of noise that should be
				5928	added to an image. </p>
				5929
				5930
				5931	<div style="margin: auto;">
				5932	<h3 class="magick-header"><a id="normalize"></a>-normalize</h3>
				5933	</div>
				5934
				5935	<p class="magick-description">Increase the contrast in an image by <var>stretching</var> the range of intensity values.</p>
				5936
				5937	<p>The intensity values are stretched to cover the entire range of possible
				5938	values. While doing so, black-out at most <var>2%</var> of the pixels and
				5939	white-out at most <var>1%</var> of the pixels.</p>
				5940
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5941	<p>Note that as of ImageMagick 6.4.7-0, <a href="command-line-options.html#normalize" >-normalize</a>
				5942	is equivalent to <a href="command-line-options.html#contrast-stretch" >-contrast-stretch 2%x1%</a>.
				5943	(Before this version, it was equivalent to <a href="command-line-options.html#contrast-stretch"
				5944	>-contrast-stretch 2%x99%</a>).</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5945
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	5946	<p>All the channels are normalized in concert by the same amount so as to
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5947	preserve color integrity, when the default <a href="command-line-options.html#channel" >+channel</a>
				5948	setting is in use. Specifying any other <a href="command-line-options.html#channel" >-channel</a>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5949	setting will normalize the RGB channels independently.</p>
				5950
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5951	<p>See <a href="command-line-options.html#contrast-stretch" >-contrast-stretch</a> for more details.
				5952	Also see <a href="command-line-options.html#auto-level" >-auto-level</a> for a 'perfect' normalization
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5953	that is better suited to mathematically generated images. </p>
				5954
				5955	<p>This operator is under review for re-development. </p>
				5956
				5957
				5958	<div style="margin: auto;">
				5959	<h3 class="magick-header"><a id="opaque"></a>-opaque <var>color</var></h3>
				5960	</div>
				5961
				5962	<p class="magick-description">change this color to the fill color within the image.</p>
				5963
				5964	<p>The <var>color</var> argument is defined using the format
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5965	described under the <a href="command-line-options.html#fill" >-fill</a> option. The <a href="command-line-options.html#fuzz"
				5966	>-fuzz</a> setting can be used to match and replace colors similar to the one
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5967	given.</p>
				5968
				5969	<p>Use <a href="command-line-options.html#opaque">+opaque</a> to paint any pixel that does not match
				5970	the target color. </p>
				5971
				5972	<p>The <a href="command-line-options.html#transparent">-transparent</a> operator is exactly the same
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5973	as <a href="command-line-options.html#opaque" >-opaque</a> but replaces the matching color with
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5974	transparency rather than the current <a href="command-line-options.html#fill">-fill</a> color setting.
				5975	To ensure that it can do this it also ensures that the image has an alpha
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	5976	channel enabled, as per "<code><a href="command-line-options.html#alpha" >-alpha</a> set</code>", for
				5977	the new transparent colors, and does not require you to modify the <a
				5978	href="command-line-options.html#channel">-channel</a> to enable alpha channel handling. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	5979
				5980
				5981	<div style="margin: auto;">
				5982	<h3 class="magick-header"><a id="ordered-dither"></a>-ordered-dither <var>threshold_map</var>{,<var>level</var>...}</h3>
				5983	</div>
				5984
				5985	<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
				5986	given number of <var>levels</var> per color channel.</p>
				5987
				5988	<p>You can choose from these standard threshold maps:</p>
				5989
				5990	<pre class="pre-scrollable">
				5991	threshold 1x1 Threshold 1x1 (non-dither)
				5992	checks 2x1 Checkerboard 2x1 (dither)
				5993	o2x2 2x2 Ordered 2x2 (dispersed)
				5994	o3x3 3x3 Ordered 3x3 (dispersed)
				5995	o4x4 4x4 Ordered 4x4 (dispersed)
				5996	o8x8 8x8 Ordered 8x8 (dispersed)
				5997	h3x4a 4x1 Halftone 4x4 (angled)
				5998	h6x6a 6x1 Halftone 6x6 (angled)
				5999	h8x8a 8x1 Halftone 8x8 (angled)
				6000	h3x4o Halftone 4x4 (orthogonal)
				6001	h6x6o Halftone 6x6 (orthogonal)
				6002	h8x8o Halftone 8x8 (orthogonal)
				6003	h36x16o Halftone 16x16 (orthogonal)
				6004	c5x5b c5x5 Circles 5x5 (black)
				6005	c5x5w Circles 5x5 (white)
				6006	c6x6b c6x6 Circles 6x6 (black)
				6007	c6x6w Circles 6x6 (white)
				6008	c7x7b c7x7 Circles 7x7 (black)
				6009	c7x7w Circles 7x7 (white)
				6010	</pre>
				6011
				6012	<p> The <code>threshold</code> generated a simple 50% threshold of the image.
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6013	This could be used with <var >level</var> to do the equivalent of <a
				6014	href="command-line-options.html#posterize" >-posterize</a> to reduce an image to basic primary colors.
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6015	</p>
				6016
				6017	<p>The <code>checks</code> pattern produces a 3 level checkerboard dither
				6018	pattern. That is a grayscale will become a pattern of solid black, solid
				6019	white, and mid-tone colors into a checkerboard pattern of black and white.
				6020	</p>
				6021
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6022	<p>You can define your own <var >threshold map</var> for ordered
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6023	dithering and halftoning your images, in either personal or system
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6024	<code>thresholds.xml</code> XML file. See <a href="resources.html" >Resources</a>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6025	for more details of configuration files. </p>
				6026
				6027	<p>To print a complete list of the thresholds that have been defined, use the
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6028	<a href="command-line-options.html#list" >-list threshold</a> option.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6029
				6030	<p>Note that at this time the same threshold dithering map is used for all
				6031	color channels, no attempt is made to offset or rotate the map for different
				6032	channels is made, to create an offset printing effect. Also as the maps are
				6033	simple threshold levels, the halftone and circle maps will create incomplete
				6034	circles along the edges of a colored area. Also all the effects are purely
				6035	on/off boolean effects, without anti-aliasing to make the circles smooth
				6036	looking. Large dots can be made to look better with a small amount of blurring
				6037	after being created. </p>
				6038
				6039
				6040	<div style="margin: auto;">
				6041	<h3 class="magick-header"><a id="orient"></a>-orient <var>image orientation</var></h3>
				6042	</div>
				6043
				6044	<p class="magick-description">specify orientation of a digital camera image.</p>
				6045
				6046	<p>Choose from these orientations:</p>
				6047
				6048	<pre>
				6049	bottom-left right-top
				6050	bottom-right top-left
				6051	left-bottom top-right
				6052	left-top undefined
				6053	right-bottom
				6054	</pre>
				6055
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6056	<p>To print a complete list of orientations, use the <a href="command-line-options.html#list" >-list
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6057	orientation</a> option.</p>
				6058
				6059
				6060	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6061	<h3 class="magick-header"><a id="page"></a>-page <var>geometry</var><br/>
				6062	-page <var>media</var>[<var>offset</var>][{<var>^!<></var>}]<br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6063	+page
				6064	</h3>
				6065	</div>
				6066
				6067	<p class="magick-description">Set the size and location of an image on the larger virtual canvas.</p>
				6068
				6069	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
				6070
				6071	<p>For convenience you can specify the page size using <var>media</var> (see below). Offsets can then be added as with other
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6072	<var>geometry</var> arguments (e.g. <a
				6073	href="command-line-options.html#page">-page</a> <code>Letter+43+43</code>).</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6074
				6075	<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.
				6076	The choices for a PostScript page are:</p>
				6077
				6078	<dl class="dl-horizontal">
				6079	<dt> 11x17 </dt> <dd> 792 x 1224</dd>
				6080	<dt> Ledger </dt> <dd> 1224 x 792</dd>
				6081	<dt> Legal </dt> <dd> 612 x 1008</dd>
				6082	<dt> Letter </dt> <dd> 612 x 792</dd>
				6083	<dt> LetterSmall</dt> <dd> 612 x 792</dd>
				6084	<dt> ArchE </dt> <dd> 2592 x 3456</dd>
				6085	<dt> ArchD </dt> <dd> 1728 x 2592</dd>
				6086	<dt> ArchC </dt> <dd> 1296 x 1728</dd>
				6087	<dt> ArchB </dt> <dd> 864 x 1296</dd>
				6088	<dt> ArchA </dt> <dd> 648 x 864</dd>
				6089	<dt> A0 </dt> <dd> 2380 x 3368</dd>
				6090	<dt> A1 </dt> <dd> 1684 x 2380</dd>
				6091	<dt> A2 </dt> <dd> 1190 x 1684</dd>
				6092	<dt> A3 </dt> <dd> 842 x 1190</dd>
				6093	<dt> A4 </dt> <dd> 595 x 842</dd>
				6094	<dt> A4Small </dt> <dd> 595 x 842</dd>
				6095	<dt> A5 </dt> <dd> 421 x 595</dd>
				6096	<dt> A6 </dt> <dd> 297 x 421</dd>
				6097	<dt> A7 </dt> <dd> 210 x 297</dd>
				6098	<dt> A8 </dt> <dd> 148 x 210</dd>
				6099	<dt> A9 </dt> <dd> 105 x 148</dd>
				6100	<dt> A10 </dt> <dd> 74 x 105</dd>
				6101	<dt> B0 </dt> <dd> 2836 x 4008</dd>
				6102	<dt> B1 </dt> <dd> 2004 x 2836</dd>
				6103	<dt> B2 </dt> <dd> 1418 x 2004</dd>
				6104	<dt> B3 </dt> <dd> 1002 x 1418</dd>
				6105	<dt> B4 </dt> <dd> 709 x 1002</dd>
				6106	<dt> B5 </dt> <dd> 501 x 709</dd>
				6107	<dt> C0 </dt> <dd> 2600 x 3677</dd>
				6108	<dt> C1 </dt> <dd> 1837 x 2600</dd>
				6109	<dt> C2 </dt> <dd> 1298 x 1837</dd>
				6110	<dt> C3 </dt> <dd> 918 x 1298</dd>
				6111	<dt> C4 </dt> <dd> 649 x 918</dd>
				6112	<dt> C5 </dt> <dd> 459 x 649</dd>
				6113	<dt> C6 </dt> <dd> 323 x 459</dd>
				6114	<dt> Flsa </dt> <dd> 612 x 936</dd>
				6115	<dt> Flse </dt> <dd> 612 x 936</dd>
				6116	<dt> HalfLetter </dt> <dd> 396 x 612</dd>
				6117	</dl>
				6118
				6119	<p>This option is also used to place subimages when writing to a multi-image
				6120	format that supports offsets, such as GIF89 and MNG. When used for this
				6121	purpose the offsets are always measured from the top left corner of the canvas
				6122	and are not affected by the <a href="command-line-options.html#gravity">-gravity</a> option. To
				6123	position a GIF or MNG image, use <a href="command-line-options.html#page">-page</a><var>{+-}x{+-}y</var> (e.g. -page +100+200). When writing to a MNG
				6124	file, a <a href="command-line-options.html#page">-page</a> option appearing ahead of the first image in
				6125	the sequence with nonzero width and height defines the width and height values
				6126	that are written in the <code>MHDR</code> chunk. Otherwise, the MNG width and
				6127	height are computed from the bounding box that contains all images in the
				6128	sequence. When writing a GIF89 file, only the bounding box method is used to
				6129	determine its dimensions.</p>
				6130
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6131	<p>For a PostScript page, the image is sized as in <a
				6132	href="command-line-options.html#geometry">-geometry</a> but positioned relative to the <var>lower
				6133	left-hand corner</var> of the page by {+-}<code>x</code><var>offset</var>{+-}<code>y</code> <var>offset</var>. Use <a
				6134	href="command-line-options.html#page">-page 612x792</a>, for example, to center the image within the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6135	page. If the image size exceeds the PostScript page, it is reduced to fit the
				6136	page. The default gravity for the <a href="command-line-options.html#page">-page</a> option is <var>NorthWest</var>, i.e., positive <code>x</code> and <code>y</code> <var>offset</var> are measured rightward and downward from the top left
				6137	corner of the page, unless the <a href="command-line-options.html#gravity">-gravity</a> option is
				6138	present with a value other than <var>NorthWest</var>.</p>
				6139
				6140	<p>The default page dimensions for a TEXT image is 612x792.</p>
				6141
				6142	<p>This option is used in concert with <a href="command-line-options.html#density">-density</a>.</p>
				6143
				6144	<p>Use <a href="command-line-options.html#page">+page</a> to remove the page settings for an image.</p>
				6145
				6146	<div style="margin: auto;">
				6147	<h3 class="magick-header"><a id="paint"></a>-paint <var>radius</var></h3>
				6148	</div>
				6149
				6150	<p class="magick-description">simulate an oil painting.</p>
				6151
				6152	<p>Each pixel is replaced by the most frequent color in a circular
				6153	neighborhood whose width is specified with <var>radius</var>.</p>
				6154
				6155	<div style="margin: auto;">
				6156	<h3 class="magick-header"><a id="path"></a>-path <var>path</var></h3></div>
				6157
				6158	<p class="magick-description">write images to this path on disk.</p>
				6159
				6160	<div style="margin: auto;">
				6161	<h3 class="magick-header"><a id="pause_animate_"></a>-pause <var>seconds</var></h3>
				6162	</div>
				6163
				6164	<p class="magick-description">Pause between animation loops</p>
				6165
				6166	<p>Pause for the specified number of seconds before repeating the animation.</p>
				6167
				6168	<div style="margin: auto;">
				6169	<h3 class="magick-header"><a id="pause_import_"></a>-pause <var>seconds</var></h3>
				6170	</div>
				6171
				6172	<p class="magick-description">Pause between snapshots.</p>
				6173
				6174	<p>Pause for the specified number of seconds before taking the next snapshot.</p>
				6175
				6176	<div style="margin: auto;">
				6177	<h3 class="magick-header"><a id="perceptible"></a>-perceptible <var>epsilon</var></h3>
				6178	</div>
				6179
				6180	<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>
				6181
				6182	<div style="margin: auto;">
				6183	<h3 class="magick-header"><a id="ping"></a>-ping</h3>
				6184	</div>
				6185
				6186	<p class="magick-description">efficiently determine image characteristics.</p>
				6187
				6188	<div style="margin: auto;">
				6189	<h3 class="magick-header"><a id="pointsize"></a>-pointsize <var>value</var></h3>
				6190	</div>
				6191
				6192	<p class="magick-description">pointsize of the PostScript, OPTION1, or TrueType font.</p>
				6193
				6194	<div style="margin: auto;">
				6195	<h3 class="magick-header"><a id="polaroid"></a>-polaroid <var>angle</var></h3>
				6196	</div>
				6197
				6198	<p class="magick-description">simulate a Polaroid picture.</p>
				6199
				6200	<p>Use <code>+polaroid</code> to rotate the image at a random angle between -15 and +15 degrees.</p>
				6201
				6202	<div style="margin: auto;">
				6203	<h3 class="magick-header"><a id="poly"></a>-poly <var>"wt,exp ..."</var></h3>
				6204	</div>
				6205
				6206	<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>
				6207
				6208	<p> The weights should typically be fractions between -1 and 1. But the sum of weights should be 1 or at least between 0 and 1 to avoid clamping in non-hdri mode at black and white.</p>
				6209
				6210	<p>The exponents may be positive, negative or zero. A negative exponent is equivalent to 1 divided by the image raised to the corresponding positive exponent. A zero exponent always produces 1 scaled by quantumrange to white, i.e. wt*white, no matter what the image.</p>
				6211
				6212	<p>The format is: <var>output = wt1image1^exp1 + wt2image2^exp2 </var>...</p>
				6213
				6214	<p>Some simple uses are:</p>
				6215	<ul>
				6216	<li>A weighted sum of each image provided all weights add to unity and all exponents=1. If the the weights are all equal to 1/(number of images), then this is equivalent to <a href="command-line-options.html#profile">-evaluate-sequence</a> <var>mean</var>.</li>
				6217	<li>The sum of squares of two or more images, provided the weights are equal (and sum to 1 to avoid clamping) and the exponents equal 2.</li>
				6218	</ul>
				6219
				6220	<p>Note that one may add a constant color to the expression simply by using xc:somecolor for one of the images and specifying the desired weight and exponent equal to 0.</p>
				6221
				6222	<p>Similarly one may add white to the expression by simply using null: (or xc:white) for one of the images with the appropriate weight and exponent equal to 0.</p>
				6223
				6224
				6225	<div style="margin: auto;">
				6226	<h3 class="magick-header"><a id="posterize"></a>-posterize <var>levels</var></h3>
				6227	</div>
				6228
				6229	<p class="magick-description">reduce the image to a limited number of color levels per channel.</p>
				6230
				6231	<p>Very low values of <var>levels</var>, e.g., 2, 3, 4, have the most
				6232	visible effect.</p>
				6233
				6234	<div style="margin: auto;">
				6235	<h3 class="magick-header"><a id="precision"></a>-precision <var>value</var></h3>
				6236	</div>
				6237
				6238	<p class="magick-description">set the maximum number of significant digits to be printed.</p>
				6239
				6240	<div style="margin: auto;">
				6241	<h3 class="magick-header"><a id="preview"></a>-preview <var>type</var></h3>
				6242	</div>
				6243
				6244	<p class="magick-description">image preview type.</p>
				6245
				6246	<p>Use this option to affect the preview operation of an image (e.g.
				6247	<code>convert file.png -preview Gamma Preview:gamma.png</code>). Choose from
				6248	these previews:</p>
				6249
				6250	<pre class="pre-scrollable">
				6251	AddNoise
				6252	Blur
				6253	Brightness
				6254	Charcoal
				6255	Despeckle
				6256	Dull
				6257	EdgeDetect
				6258	Gamma
				6259	Grayscale
				6260	Hue
				6261	Implode
				6262	JPEG
				6263	OilPaint
				6264	Quantize
				6265	Raise
				6266	ReduceNoise
				6267	Roll
				6268	Rotate
				6269	Saturation
				6270	Segment
				6271	Shade
				6272	Sharpen
				6273	Shear
				6274	Solarize
				6275	Spiff
				6276	Spread
				6277	Swirl
				6278	Threshold
				6279	Wave
				6280	</pre>
				6281
				6282	<p>To print a complete list of previews, use the <a href="command-line-options.html#list">-list preview</a> option.</p>
				6283
				6284	<p>The default preview is <code>JPEG</code>.</p>
				6285
				6286	<div style="margin: auto;">
				6287	<h3 class="magick-header"><a id="print"></a>-print <var>string</var></h3>
				6288	</div>
				6289
				6290	<p class="magick-description">interpret string and print to console.</p>
				6291
				6292	<div style="margin: auto;">
				6293	<h3 class="magick-header"><a id="process"></a>-process <var>command</var></h3>
				6294	</div>
				6295
				6296	<p class="magick-description">process the image with a custom image filter.</p>
				6297
				6298	<p>The command arguments has the form <code>"module arg1 arg2 arg3 ...
				6299	argN"</code> where <code>module</code> is the name of the module to invoke (e.g.
				6300	"Analyze") and arg1 arg2 arg3 ... argN are an arbitrary number of arguments to
				6301	pass to the process module.</p>
				6302
				6303	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6304	<h3 class="magick-header"><a id="profile"></a>-profile <var>filename</var><br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6305	+profile <var>profile_name</var></h3>
				6306	</div>
				6307
				6308	<p class="magick-description">Manage ICM, IPTC, or generic profiles in an image.</p>
				6309
				6310	<p>Using <a href="command-line-options.html#profile">-profile</a> <var>filename</var> adds an
				6311	ICM (ICC color management), IPTC (newswire information), or a generic profile
				6312	to the image.</p>
				6313
				6314	<p>Use <a href="command-line-options.html#profile">+profile <var>profile_name</var></a> to
				6315	remove the indicated profile. ImageMagick uses standard filename globbing, so
				6316	wildcard expressions may be used to remove more than one profile. Here we
				6317	remove all profiles from the image except for the XMP profile: <code>+profile
				6318	"!xmp,*"</code>. </p>
				6319
				6320	<p>Use <code>identify -verbose</code> to find out which profiles are in the
				6321	image file. Use <a href="command-line-options.html#strip">-strip</a> to remove all profiles (and
				6322	comments).</p>
				6323
				6324	<p>To extract a profile, the <a href="command-line-options.html#profile">-profile</a> option is not
				6325	used. Instead, simply write the file to an image format such as <var>APP1, 8BIM, ICM,</var> or <var>IPTC</var>.</p>
				6326
				6327	<p>For example, to extract the Exif data (which is stored in JPEG files in the
				6328	<var>APP1</var> profile), use.</p>
				6329
				6330	<pre>
				6331	convert cockatoo.jpg profile.exif
				6332	</pre>
				6333
				6334	<p>It is important to note that results may depend on whether or not the
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6335	original image already has an included profile. Also, keep in mind that <a
				6336	href="command-line-options.html#profile">-profile</a> is an "operator" (as opposed to a "setting") and
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6337	therefore a conversion is made each time it is encountered, in order, in the
				6338	command-line. For instance, in the following example, if the original image is
				6339	CMYK with profile, a CMYK-CMYK-RGB conversion results.</p>
				6340
				6341	<pre>
				6342	convert CMYK.tif -profile "CMYK.icc" -profile "RGB.icc" RGB.tiff
				6343	</pre>
				6344
				6345	<p>Furthermore, since ICC profiles are not necessarily symmetric, extra
				6346	conversion steps can yield unwanted results. CMYK profiles are often very
				6347	asymmetric since they involve 3−>4 and 4−>3 channel mapping.
				6348	</p>
				6349
				6350	<div style="margin: auto;">
				6351	<h3 class="magick-header"><a id="quality"></a>-quality <var>value</var></h3>
				6352	</div>
				6353
				6354	<p class="magick-description">JPEG/MIFF/PNG compression level.</p>
				6355
				6356	<p>For the JPEG and MPEG image formats, quality is 1 (lowest image quality and
				6357	highest compression) to 100 (best quality but least effective compression).
				6358	The default is to use the estimated quality of your input image if it can
				6359	be determined, otherwise 92. When the quality is greater than 90, then the
				6360	chroma channels are not downsampled.
				6361	Use the <a href="command-line-options.html#sampling-factor">-sampling-factor</a> option to specify the
				6362	factors for chroma downsampling.</p>
				6363
				6364	<p>For the JPEG-2000 image format, quality is mapped using a non-linear
				6365	equation to the compression ratio required by the Jasper library. This
				6366	non-linear equation is intended to loosely approximate the quality provided by
				6367	the JPEG v1 format. The default quality value 100, a request for non-lossy
				6368	compression. A quality of 75 results in a request for 16:1 compression.</p>
				6369
				6370	<p>For the MNG and PNG image formats, the quality value sets the zlib
				6371	compression level (quality / 10) and filter-type (quality % 10). The default
				6372	PNG "quality" is 75, which means compression level 7 with adaptive PNG
				6373	filtering, unless the image has a color map, in which case it means
				6374	compression level 7 with no PNG filtering.</p>
				6375
				6376	<p>For compression level 0 (quality value less than 10), the Huffman-only
				6377	strategy is used, which is fastest but not necessarily the worst
				6378	compression.</p>
				6379
				6380	<p>If filter-type is 4 or less, the specified PNG filter-type is used for
				6381	all scanlines:</p>
				6382
				6383	<dl class="dl-horizontal">
				6384	<dt>0</dt><dd>none</dd>
				6385	<dt>1</dt><dd>sub</dd>
				6386	<dt>2</dt><dd>up</dd>
				6387	<dt>3</dt><dd>average</dd>
				6388	<dt>4</dt><dd>Paeth</dd>
				6389	</dl>
				6390
				6391	<p>If filter-type is 5, adaptive filtering is used when quality is greater
				6392	than 50 and the image does not have a color map, otherwise no filtering is
				6393	used.</p>
				6394
				6395	<p>If filter-type is 6, adaptive filtering
				6396	with <var>minimum-sum-of-absolute-values</var> is used.</p>
				6397
				6398	<p>Only if the output is MNG, if filter-type is 7, the LOCO color
				6399	transformation (intrapixel differencing) and adaptive filtering
				6400	with <var>minimum-sum-of-absolute-values</var> are used.</p>
				6401
				6402	<p>If the filter-type is 8 the zlib Z_RLE compression strategy (or the
				6403	Z_HUFFMAN_ONLY strategy, when compression level is 0) is used with
				6404	adaptive PNG filtering.</p>
				6405
				6406	<p>If the filter-type is 9 the zlib Z_RLE compression strategy (or the
				6407	Z_HUFFMAN_ONLY strategy, when compression level is 0) is used with
				6408	no PNG filtering.</p>
				6409
				6410	<p>The quality setting has no effect on the appearance or signature of PNG
				6411	and MNG images, since the compression is always lossless.</p>
				6412
				6413	<p>Not all combinations of compression level, strategy, and PNG filter type
				6414	can be obtained using the -quality option. For more precise control,
				6415	you can use the PNG:compression-level=N, PNG:compression-strategy=N, and
				6416	PNG:compression-filter=N defines, respectively, instead.
				6417	See <a href="command-line-options.html#define">-define</a>. Values from the defines take precedence
				6418	over values from the -quality option.</p>
				6419
				6420	<p>For further information, see
				6421	the <a href="http://www.w3.org/pub/WWW/TR">PNG</a> specification.</p>
				6422
				6423	<p>For the MIFF and TIFF image formats, quality/10 is the <a href="command-line-options.html#compress">Zip/BZip</a> compression level, which is 0 (worst but fastest compression) to 9 (best but slowest). It has no effect on the image appearance, since the compression is always lossless.</p>
				6424
				6425	<p>For the BPG image format, quality/2 is the actual BPG compression level (range from 0 to 51).</p>
				6426
				6427	<div style="margin: auto;">
				6428	<h3 class="magick-header"><a id="quantize"></a>-quantize <var>colorspace</var></h3>
				6429	</div>
				6430
				6431	<p class="magick-description">reduce colors using this colorspace.</p>
				6432
				6433	<p>This setting defines the colorspace used to sort out and reduce the number
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6434	of colors needed by an image (for later dithering) by operators such as <a
				6435	href="command-line-options.html#colors" >-colors</a>, Note that color reduction also happens
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6436	automatically when saving images to color-limited image file formats, such as
				6437	GIF, and PNG8.</p>
				6438
				6439
				6440	<div style="margin: auto;">
				6441	<h3 class="magick-header"><a id="quiet"></a>-quiet</h3>
				6442	</div>
				6443
				6444	<p class="magick-description">suppress all warning messages. Error messages are still reported.</p>
				6445
				6446	<div style="margin: auto;">
				6447	<h3 class="magick-header"><a id="radial-blur"></a>-radial-blur <var>angle</var></h3>
				6448	</div>
				6449
				6450	<p class="magick-description">Blur around the center of the image.</p>
				6451
				6452	<p>Note that this is actually a rotational blur rather than a radial and as
				6453	such actually mis-named. </p>
				6454
				6455	<p>The <a href="command-line-options.html#virtual-pixel">-virtual-pixel</a> setting will determine how
				6456	pixels which are outside the image proper are blurred into the final result.
				6457	</p>
				6458
				6459
				6460	<div style="margin: auto;">
				6461	<h3 class="magick-header"><a id="raise"></a>-raise <var>thickness</var></h3>
				6462	</div>
				6463
				6464	<p class="magick-description">Lighten or darken image edges.</p>
				6465
				6466	<p>This will create a 3-D effect. Use <a href="command-line-options.html#raise">-raise</a> to create
				6467	a raised effect, otherwise use <a href="command-line-options.html#raise">+raise</a>. </p>
				6468
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6469	<p>Unlike the similar <a href="command-line-options.html#frame">-frame</a> option, <a
				6470	href="command-line-options.html#raise">-raise</a> does not alter the dimensions of the image.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6471
				6472	<div style="margin: auto;">
				6473	<h3 class="magick-header"><a id="random-threshold"></a>-random-threshold <var>low</var>x<var>high</var></h3>
				6474	</div>
				6475
				6476	<p class="magick-description">Apply a random threshold to the image.</p>
				6477
				6478	<div style="margin: auto;">
Cristy	e077971	2016-07-30 17:25:22 -0400	[diff] [blame]	6479	<h3 class="magick-header"><a id="read-mask"></a>-read-mask
				6480	<var>filename</var></h3>
				6481	</div>
				6482
				6483	<p class="magick-description">Prevent updates to image pixels specified by the mask.</p>
				6484
				6485	<p>This the same as using a mask used for composite masking operations, with
				6486	grayscale values causing blended updates of the image the mask is attached to.
				6487	</p>
				6488
				6489	<p>Use <a href="command-line-options.html#read-mask">+read-mask</a> to remove the mask from images.</p>
				6490
				6491	<p>Also see <a href="command-line-options.html#clip-mask">-clip-mask</a> which work in the same way,
				6492	but with strict boolean masking. </p>
				6493
				6494	<div style="margin: auto;">
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6495	<h3 class="magick-header"><a id="red-primary"></a>-red-primary <var>x,y</var></h3>
				6496	</div>
				6497
				6498	<p class="magick-description">Set the red chromaticity primary point.</p>
				6499
				6500	<div style="margin: auto;">
				6501	<h3 class="magick-header"><a id="regard-warnings"></a>-regard-warnings</h3>
				6502	</div>
				6503
				6504	<p class="magick-description">Pay attention to warning messages.</p>
				6505
				6506	<p>This option causes some warnings in some image formats to be treated
				6507	as errors. </p>
				6508
				6509	<div style="margin: auto;">
				6510	<h3 class="magick-header"><a id="remap"></a>-remap <var>filename</var></h3>
				6511	</div>
				6512
				6513	<p class="magick-description">Reduce the number of colors in an image to the colors used by this image.</p>
				6514
				6515	<p>If the <a href="command-line-options.html#dither">-dither</a> setting is enabled (the default) then
				6516	the given colors are dithered over the image as necessary, otherwise the closest
				6517	color (in RGB colorspace) is selected to replace that pixel in the image. </p>
				6518
				6519	<p>As a side effect of applying a <a href="command-line-options.html#remap">-remap</a> of colors across all
				6520	images in the current image sequence, all the images will have the same color
				6521	table. That means that when saved to a file format such as GIF, it will use
				6522	that color table as a single common or global color table, for all the images,
				6523	without requiring extra local color tables. </p>
				6524
				6525	<p>Use <a href="command-line-options.html#remap">+remap</a> to reduce all images in the current image
				6526	sequence to use a common color map over all the images. This equivalent to
				6527	appending all the images together (without extra background colors) and color
				6528	reducing those images using <a href="command-line-options.html#colors">-colors</a> with a 256 color
				6529	limit, then <a href="command-line-options.html#remap">-remap</a> those colors over the original list of
				6530	images. This ensures all the images follow a single color map. </p>
				6531
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6532	<p>If the number of colors over all the images is less than 256, then <a
				6533	href="command-line-options.html#remap">+remap</a> should not perform any color reduction or dithering, as
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6534	no color changes are needed. In that case, its only effect is to force the use
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6535	of a global color table. This recommended after using either <a
				6536	href="command-line-options.html#colors">-colors</a> or <a href="command-line-options.html#ordered-dither">-ordered-dither</a> to
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6537	reduce the number of colors in an animated image sequence. </p>
				6538
				6539	<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>
				6540
				6541	<div style="margin: auto;">
				6542	<h3 class="magick-header"><a id="region"></a>-region <var>geometry</var></h3>
				6543	</div>
				6544
				6545	<p class="magick-description">Set a region in which subsequent operations apply.</p>
				6546
				6547	<p>The <var>x</var> and <var>y</var> offsets are treated
				6548	in the same manner as in <a href="command-line-options.html#crop">-crop</a>.</p>
				6549
				6550	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
				6551
				6552	<p>Use <code>+region</code> to remove any previously set regions.</p>
				6553
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6554	<div style="margin: auto;">
				6555	<h3 class="magick-header"><a id="remote"></a>-remote</h3>
				6556	</div>
				6557
				6558	<p class="magick-description">perform a remote operation.</p>
				6559
				6560	<p>The only command recognized is the name of an image file to load.</p>
				6561
				6562	<p>If you have more than one <a href="display.html">display</a> application
				6563	running simultaneously, use the <a href="command-line-options.html#window"> window</a> option to
				6564	specify which application to control.</p>
				6565
				6566	<div style="margin: auto;">
				6567	<h3 class="magick-header"><a id="render"></a>-render</h3>
				6568	</div>
				6569
				6570	<p class="magick-description">render vector operations.</p>
				6571
				6572	<p>Use <a href="command-line-options.html#render">+render</a> to turn off rendering vector operations.
				6573	This useful when saving the result to vector formats such as MVG or SVG.</p>
				6574
				6575	<div style="margin: auto;">
				6576	<h3 class="magick-header"><a id="repage"></a>-repage <var>geometry</var></h3>
				6577	</div>
				6578
				6579	<p class="magick-description">Adjust the canvas and offset information of the image.</p>
				6580
				6581	<p>This option is like <a href="command-line-options.html#page">-page</a> but acts as an image operator
				6582	rather than a setting. You can separately set the canvas size or the offset
				6583	of the image on that canvas by only providing those components. </p>
				6584
				6585	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
				6586
				6587	<p>If a <code>!</code> flag is given the offset given is added to the existing
				6588	offset to move the image relative to its previous position. This useful for
				6589	animation sequences. </p>
				6590
				6591	<p>A given a canvas size of zero such as '<code>0x0</code>' forces it to
				6592	recalculate the canvas size so the image (at its current offset) will appear
				6593	completely on that canvas (unless it has a negative offset).</p>
				6594
				6595	<p>Use <a href="command-line-options.html#repage">+repage</a> to completely remove/reset the virtual
				6596	canvas meta-data from the images. </p>
				6597
				6598	<p>The <a href="command-line-options.html#set">-set</a> '<code>page</code>' option can be used to
				6599	directly assign virtual canvas meta-data. </p>
				6600
				6601
				6602	<div style="margin: auto;">
				6603	<h3 class="magick-header"><a id="resample"></a>-resample <var>horizontal</var>x<var>vertical</var></h3>
				6604	</div>
				6605
				6606	<p class="magick-description">Resample image to specified horizontal and vertical resolution.</p>
				6607
				6608	<p>Resize the image so that its rendered size remains the same as the original
				6609	at the specified target resolution. For example, if a 300 DPI image renders at
				6610	3 inches by 2 inches on a 300 DPI device, when the image has been resampled to
				6611	72 DPI, it will render at 3 inches by 2 inches on a 72 DPI device. Note that
				6612	only a small number of image formats (e.g. JPEG, PNG, and TIFF) are capable of
				6613	storing the image resolution. For formats which do not support an image
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6614	resolution, the original resolution of the image must be specified via <a
				6615	href="command-line-options.html#density">-density</a> on the command line prior to specifying the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6616	resample resolution.</p>
				6617
				6618	<p>Note that Photoshop stores and obtains image resolution from a proprietary
				6619	embedded profile. If this profile exists in the image, then Photoshop will
				6620	continue to treat the image using its former resolution, ignoring the image
				6621	resolution specified in the standard file header.</p>
				6622
				6623	<div style="margin: auto;">
				6624	<h3 class="magick-header"><a id="resize"></a>-resize <var>geometry</var></h3>
				6625	</div>
				6626
				6627	<p class="magick-description">Resize an image.</p>
				6628
				6629	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. Offsets, if present in the geometry string, are
				6630	ignored, and the <a href="command-line-options.html#gravity">-gravity</a> option has no effect.</p>
				6631
				6632	<p>If the <a href="command-line-options.html#filter">-filter</a> option
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6633	or <code>-define filter:option=value</code> precedes the <a
				6634	href="command-line-options.html#resize">-resize</a> option, the image is resized with the specified
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6635	filter.</p>
				6636
				6637	<p>Many image processing algorithms assume your image is in a linear-light
				6638	coding. If your image is gamma-corrected, you can remove the nonlinear gamma
				6639	correction, apply the transform, then restore it like this:</p>
				6640
				6641	<pre>
				6642	convert portrait.jpg -gamma .45455 -resize 25% -gamma 2.2 \
				6643	-quality 92 passport.jpg
				6644	</pre>
				6645
				6646	<div style="margin: auto;">
				6647	<h3 class="magick-header"><a id="respect-parentheses"></a>-respect-parentheses</h3>
				6648	</div>
				6649
				6650	<p class="magick-description">settings remain in effect until parenthesis boundary.</p>
				6651
				6652	<div style="margin: auto;">
				6653	<h3 class="magick-header"><a id="reverse"></a>-reverse</h3>
				6654	</div>
				6655
				6656	<p class="magick-description">Reverse the order of images in the current image list.</p>
				6657
				6658
				6659	<div style="margin: auto;">
				6660	<h3 class="magick-header"><a id="roll"></a>-roll {<var>+-</var>}<var>x</var>{<var>+-</var>}<var>y</var></h3>
				6661	</div>
				6662
				6663	<p class="magick-description">roll an image vertically or horizontally by the amount given.</p>
				6664
				6665	<p>A negative <var>x</var> offset rolls the image right-to-left.
				6666	A negative <var>y</var> offset rolls the image bottom-to-top.</p>
				6667
				6668
				6669	<div style="margin: auto;">
				6670	<h3 class="magick-header"><a id="rotate"></a>-rotate <var>degrees</var>{<var><</var>}{<var>></var>}</h3>
				6671	</div>
				6672
				6673	<p class="magick-description">Apply Paeth image rotation (using shear operations) to the image.</p>
				6674
				6675	<p>Use <code>></code> to rotate the image only if its width exceeds the
				6676	height. <code><</code> rotates the image <var>only</var> if its width is less
				6677	than the height. For example, if you specify <code>-rotate "-90>"</code> and
				6678	the image size is 480x640, the image is not rotated. However, if the image is
				6679	640x480, it is rotated by -90 degrees. If you use <code>></code> or
				6680	<code><</code>, enclose it in quotation marks to prevent it from being
				6681	misinterpreted as a file redirection.</p>
				6682
				6683	<p>Empty triangles in the corners, left over from rotating the image, are
				6684	filled with the <code>background</code> color. </p>
				6685
				6686	<p>See also the <a href="command-line-options.html#distort">-distort</a> operator and specifically the
				6687	'<code>ScaleRotateTranslate</code>' distort method. </p>
				6688
				6689
				6690	<div style="margin: auto;">
				6691	<h3 class="magick-header"><a id="sample"></a>-sample <var>geometry</var></h3>
				6692	</div>
				6693
				6694	<p class="magick-description">minify / magnify the image with pixel subsampling and pixel replication, respectively.</p>
				6695
				6696	<p>Change the image size simply by directly sampling the pixels original
				6697	from the image. When magnifying, pixels are replicated in blocks. When
				6698	minifying, pixels are sub-sampled (i.e., some rows and columns are skipped
				6699	over). </p>
				6700
				6701	<p>The results are thus equivalent to using <a href="command-line-options.html#resize">-resize</a> with
				6702	a <a href="command-line-options.html#filter">-filter</a> setting of <code>point</code> (nearest
				6703	neighbor), though <a href="command-line-options.html#sample">-sample</a> is a lot faster, as it
				6704	avoids all the filter processing of the image. As such it completely ignores
				6705	the current <a href="command-line-options.html#filter">-filter</a> setting. </p>
				6706
				6707	<p>The key feature of the <a href="command-line-options.html#sample">-sample</a> is that no new colors
				6708	will be added to the resulting image, though some colors may disappear. </p>
				6709
				6710	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. Offsets, if present in the geometry string, are
				6711	ignored, unlike <a href="command-line-options.html#resize">-resize</a>. </p>
				6712
				6713
				6714	<p>The actual sampling point is the middle of the sub-region being sampled.
				6715	As such a single pixel sampling of an image will take the middle pixel, (or
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6716	top-left-middle if image has even dimensions). However the <a
				6717	href="command-line-options.html#define">-define</a> '<code>sample:offset</code>' can be set to modify
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6718	this position some other location within each sub-region being sampled, as
				6719	a percentage offset.</p>
				6720
				6721	<p>By default this value is '<code>50</code>' for the midpoint, but could be set
				6722	to '<code>0</code>' for top-left, '<code>100</code>' for bottom-right, or with
				6723	separate X and Y offsets such as '<code>0x50</code>' for left-middle edge of
				6724	sampling sub-region.</p>
				6725
				6726
				6727	<div style="margin: auto;">
				6728	<h3 class="magick-header"><a id="sampling-factor"></a>-sampling-factor <var>horizontal-factor</var>x<var>vertical-factor</var></h3>
				6729	</div>
				6730
				6731	<p class="magick-description">sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encoder.</p>
				6732
				6733	<p>This option specifies the sampling factors to be used by the JPEG encoder
				6734	for chroma downsampling. If this option is omitted, the JPEG library will use
				6735	its own default values. When reading or writing the YUV format and when
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6736	writing the M2V (MPEG-2) format, use <a
				6737	href="command-line-options.html#sampling-factor">-sampling-factor 2x1</a> or <a
				6738	href="command-line-options.html#sampling-factor">-sampling-factor 4:2:2</a> to specify the 4:2:2
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6739	downsampling method.</p>
				6740
				6741	<div style="margin: auto;">
				6742	<h3 class="magick-header"><a id="scale"></a>-scale <var>geometry</var></h3>
				6743	</div>
				6744
				6745	<p class="magick-description">minify / magnify the image with pixel block averaging and pixel replication, respectively.</p>
				6746
				6747	<p>Change the image size simply by replacing pixels by averaging pixels
				6748	together when minifying, or replacing pixels when magnifying. </p>
				6749
				6750	<p>The results are thus equivalent to using <a href="command-line-options.html#resize">-resize</a> with
				6751	a <a href="command-line-options.html#filter">-filter</a> setting of <code>box</code>. Though it is a lot
				6752	faster, as it avoids all the filter processing of the image. As such it
				6753	completely ignores the current <a href="command-line-options.html#filter">-filter</a> setting. </p>
				6754
				6755	<p>If when shrinking (minifying) images the original image is some integer
				6756	multiple of the new image size, the number of pixels averaged together to
				6757	produce the new pixel color is the same across the whole image. This is
				6758	a special case known as 'binning' and is often used as a method of reducing
				6759	noise in image such as those generated by digital cameras, especially in low
				6760	light conditions. </p>
				6761
				6762
				6763	<div style="margin: auto;">
				6764	<h3 class="magick-header"><a id="scene"></a>-scene <var>value</var></h3>
				6765	</div>
				6766
				6767	<p class="magick-description">set scene number.</p>
				6768
				6769	<p>This option sets the scene number of an image or the first image in an image sequence.</p>
				6770
				6771	<div style="margin: auto;">
				6772	<h3 class="magick-header"><a id="screen"></a>-screen</h3>
				6773	</div>
				6774
				6775	<p class="magick-description">specify the screen to capture.</p>
				6776
				6777	<p>This option indicates that the GetImage request used to obtain the image
				6778	should be done on the root window, rather than directly on the specified
				6779	window. In this way, you can obtain pieces of other windows that overlap the
				6780	specified window, and more importantly, you can capture menus or other popups
				6781	that are independent windows but appear over the specified window.</p>
				6782
				6783	<div style="margin: auto;">
				6784	<h3 class="magick-header"><a id="seed"></a>-seed</h3>
				6785	</div>
				6786
				6787	<p class="magick-description">seed a new sequence of pseudo-random numbers</p>
				6788
				6789	<div style="margin: auto;">
				6790	<h3 class="magick-header"><a id="segment"></a>-segment <var>cluster-threshold</var>x<var>smoothing-threshold</var></h3>
				6791	</div>
				6792
				6793	<p class="magick-description">segment the colors of an image.</p>
				6794
				6795	<p>Segment an image by analyzing the histograms of the color components and
				6796	identifying units that are homogeneous with the fuzzy c-means technique. This
				6797	is part of the ImageMagick color quantization routines. </p>
				6798
				6799	<p>Specify <var>cluster threshold</var> as the number of pixels in
				6800	each cluster that must exceed the cluster threshold to be considered valid.
				6801	<var>Smoothing threshold</var> eliminates noise in the second
				6802	derivative of the histogram. As the value is increased, you can expect
				6803	a smoother second derivative. The default is 1.5.</p>
				6804
				6805	<p>If the <a href="command-line-options.html#verbose">-verbose</a> setting is defined, a detailed report
				6806	of the color clusters is returned.</p>
				6807
				6808
				6809	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6810	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6811	</div>
				6812
				6813	<p class="magick-description">Selectively blur pixels within a contrast threshold.</p>
				6814
				6815	<p>Blurs those pixels that are less than or equal to the threshold in
				6816	contrast. The threshold may be expressed as a fraction of <var>QuantumRange</var> or as a percentage.</p>
				6817
				6818	<div style="margin: auto;">
				6819	<h3 class="magick-header"><a id="separate"></a>-separate</h3>
				6820	</div>
				6821
				6822	<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>
				6823
				6824	<div style="margin: auto;">
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	6825	<h3 class="magick-header"><a id="sepia-tone"></a>-sepia-tone <var>percent-threshold</var></h3>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6826	</div>
				6827
				6828	<p class="magick-description">simulate a sepia-toned photo.</p>
				6829
				6830	<p>Specify <var>threshold</var> as the percent threshold of the intensity (0 - 99.9%).</p>
				6831
				6832	<p>This option applies a special effect to the image, similar to the effect
				6833	achieved in a photo darkroom by sepia toning. Threshold ranges from 0 to <var>QuantumRange</var> and is a measure of the extent of the sepia
				6834	toning. A threshold of 80% is a good starting point for a reasonable
				6835	tone.</p>
				6836
				6837
				6838
				6839	<div style="margin: auto;">
				6840	<h3 class="magick-header"><a id="set"></a>-set <var>key value</var></h3>
				6841	<h3 class="magick-header">+set <var>key</var></h3>
				6842	</div>
				6843
				6844	<p class="magick-description">sets image attributes and properties for images in the current image sequence.</p>
				6845
				6846	<p>This will assign (or modify) specific settings attached to all the images
				6847	in the current image sequence. Using the <a href="command-line-options.html#set">+set</a> form of the
				6848	option will either remove, or reset that setting to a default state, as
				6849	appropriate. </p>
				6850
				6851	<p>For example, it will modify specific well known image meta-data
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6852	'attributes' such as those normally overridden by: the options <a
				6853	href="command-line-options.html#delay" >-delay</a>, <a href="command-line-options.html#dispose" >-dispose</a>, and <a
				6854	href="command-line-options.html#page" >-page</a>, <a href="command-line-options.html#colorspace" >-colorspace</a>; generally
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6855	assigned before the image is read in, by using a <var>key</var> of
				6856	the same name. </p>
				6857
				6858	<p>If the given <var>key</var> does not match a specific known
				6859	'attribute ', such as shown above, the setting is stored as a a free form
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6860	'property' string. Such settings are listed in <a href="command-line-options.html#verbose"
				6861	>-verbose</a> information ("<code>info:</code>" output format) as "Properties".
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6862	</p>
				6863
				6864	<p>This includes string 'properties' that are set by and assigned to images
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6865	using the options <a href="command-line-options.html#comment" >-comment</a>, <a href="command-line-options.html#label"
				6866	>-label</a>, <a href="command-line-options.html#caption" >-caption</a>. These options actually assign
				6867	a global 'artifact' which are automatically assigned (and any <a href="escape.html" >Format Percent
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6868	Escapes</a> expanded) to images as they are read in. For example:</p>
				6869
				6870	<pre>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6871	-> convert rose: -set comment 'Rose is a rose is a rose is a rose' rose.png
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6872	identify -format %c rose.png
				6873	Rose is a rose is a rose is a rose
				6874	</pre>
				6875
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6876	<p>The set value can also make use of <a href="escape.html" >Format and Print Image
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6877	Properties</a> in the defined value. For example:</p>
				6878
				6879	<pre>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6880	-> convert rose: -set origsize '%wx%h' -resize 50% \
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6881	-format 'Old size = %[origsize] New size = %wx%h' info:
				6882	Old size = 70x46 New size = 35x23
				6883	</pre>
				6884
				6885	<p>Other well known 'properties' that are available include:
				6886	'<code>date:create</code>' and '<code>date:modify</code>' and
				6887	'<code>signature</code>'. </p>
				6888
				6889	<p>The <a href="command-line-options.html#repage">-repage</a> operator will also allow you to modify
				6890	the '<code>page</code>' attribute of an image for images already in memory (also
				6891	see <a href="command-line-options.html#repage">-page</a>). However it is designed to provide a finer
				6892	control of the sub-parts of this 'attribute'. The <a href="command-line-options.html#set">-set page</a>
				6893	option will only provide a direct, unmodified assignment of '<code>page</code>'
				6894	attribute. </p>
				6895
				6896	<p>This option can also associate a colorspace or profile with your image.
				6897	For example,</p>
				6898
				6899	<pre>
				6900	convert image.psd -set profile ISOcoated_v2_eci.icc image-icc.psd
				6901	</pre>
				6902
				6903	<p>Some 'properties' must be defined in a specific way to be used. For
				6904	example only 'properties' prefixed with "<code>filename:</code>" can be used to
				6905	modify the output filename of an image. For example</p>
				6906
				6907	<pre>
				6908	convert rose: -set filename:mysize '%wx%h' 'rose_%[filename:mysize].png'
				6909	</pre>
				6910
				6911	<p>If the setting value is prefixed with "<code>option:</code>" the setting will
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6912	be saved as a global "Artifact" exactly as if it was set using the <a
				6913	href="command-line-options.html#define" >-define</a> option. As such settings are global in scope, they
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6914	can be used to pass 'attributes' and 'properties' of one specific image,
				6915	in a way that allows you to use them in a completely different image, even if
				6916	the original image has long since been modified or destroyed. For example: </p>
				6917
				6918	<pre>
				6919	convert rose: -set option:rosesize '%wx%h' -delete 0 \
				6920	label:'%[rosesize]' label_size_of_rose.gif"
				6921	</pre>
				6922
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6923	<p>Note that <a href="escape.html" >Format Percent Escapes</a> will only match
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6924	a 'artifact' if the given <var>key</var> does not match an existing
				6925	'attribute' or 'property'. </p>
				6926
				6927	<p>You can set the attributes of the image registry by prefixing the value
				6928	with <code>registry:</code>.</p>
				6929
				6930	<p>The <a href="command-line-options.html#set">-set profile</a> option can also be used to inject
				6931	previously-formatted ancillary chunks into the output PNG file, using
				6932	the commandline option as shown below or by setting the profile via a
				6933	programming interface:</p>
				6934
				6935	<pre>
				6936	convert in.png -set profile PNG-chunk-x:<filename> out.png
				6937	</pre>
				6938
				6939	<p>where <var>x</var> is a location flag and
				6940	<var>filename</var> is a file containing the chunk
				6941	name in the first 4 bytes, then a colon (":"), followed by the chunk data.
				6942	This encoder will compute the chunk length and CRC, so those must not
				6943	be included in the file.</p>
				6944
				6945	<p>"x" can be "b" (before PLTE), "m" (middle, i.e., between PLTE and IDAT),
				6946	or "e" (end, i.e., after IDAT). If you want to write multiple chunks
				6947	of the same type, then add a short unique string after the "x" to prevent
				6948	subsequent profiles from overwriting the preceding ones, e.g.,</p>
				6949
				6950
				6951	<pre>
				6952	convert in.png -set profile PNG-chunk-b01:file01 \
				6953	-profile PNG-chunk-b02:file02 out.png
				6954	</pre>
				6955
				6956	<div style="margin: auto;">
				6957	<h3 class="magick-header"><a id="shade"></a>-shade <var>azimuth</var>x<var>elevation</var></h3>
				6958	</div>
				6959
				6960	<p class="magick-description">shade the image using a distant light source.</p>
				6961
				6962	<p>Specify <var>azimuth</var> and <var>elevation</var> as
				6963	the position of the light source. Use <a href="command-line-options.html#shade">+shade</a> to return
				6964	the shading results as a grayscale image.</p>
				6965
				6966	<div style="margin: auto;">
				6967	<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>
				6968	</div>
				6969
				6970	<p class="magick-description">simulate an image shadow.</p>
				6971
				6972	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6973	<h3 class="magick-header"><a
				6974	id="shared-memory"></a>-shared-memory</h3>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6975	</div>
				6976
				6977	<p class="magick-description">use shared memory.</p>
				6978
				6979	<p>This option specifies whether the utility should attempt to use shared
				6980	memory for pixmaps. ImageMagick must be compiled with shared memory support,
				6981	and the display must support the <var>MIT-SHM</var> extension.
				6982	Otherwise, this option is ignored. The default is <code>True</code>.</p>
				6983
				6984	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	6985	<h3 class="magick-header"><a id="sharpen"></a>-sharpen <var>radius</var><br />-sharpen <var>radius</var>x<var>sigma</var></h3>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	6986	</div>
				6987
				6988	<p class="magick-description">sharpen the image.</p>
				6989
				6990	<p>Use a Gaussian operator of the given radius and standard deviation (sigma).</p>
				6991
				6992	<div style="margin: auto;">
				6993	<h3 class="magick-header"><a id="shave"></a>-shave <var>geometry</var></h3>
				6994	</div>
				6995
				6996	<p class="magick-description">Shave pixels from the image edges.</p>
				6997
				6998	<p>The <var>size</var> portion of the <var>geometry</var>
				6999	argument specifies the width of the region to be removed from both sides of
				7000	the image and the height of the regions to be removed from top and bottom.
				7001	Offsets are ignored.</p>
				7002
				7003	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
				7004
				7005	<div style="margin: auto;">
				7006	<h3 class="magick-header"><a id="shear"></a>-shear <var>Xdegrees</var>[x<var>Ydegrees</var>]</h3>
				7007	</div>
				7008
				7009	<p class="magick-description">Shear the image along the x-axis and/or y-axis.</p>
				7010
				7011	<p>The shear angles may be positive, negative, or zero. When <var>Ydegrees</var> is omitted it defaults to 0. When both angles are
				7012	given, the horizontal component of the shear is performed before the vertical
				7013	component.</p>
				7014
				7015	<p>Shearing slides one edge of an image along the x-axis or y-axis (i.e.,
				7016	horizontally or vertically, respectively),creating a parallelogram. The amount
				7017	of each is controlled by the respective shear angle. For horizontal shears,
				7018	<var>Xdegrees</var> is measured clockwise relative to "up" (the
				7019	negative y-axis), sliding the top edge to the right when 0°<<var>Xdegrees</var><90° and to the left when 90°<<var>Xdegrees</var><180°. For vertical shears <var>Ydegrees</var> is measured clockwise relative to "right" (the
				7020	positive x-axis), sliding the right edge down when 0°<<var>Ydegrees</var><90° and up when 90°<<var>Ydegrees</var><180°.</p>
				7021
				7022	<p>Empty triangles left over from shearing the image are filled with the color
				7023	defined by the <a href="command-line-options.html#fill">-background</a> option. The color is specified
				7024	using the format described under the <a href="command-line-options.html#fill">-fill</a> option.</p>
				7025
				7026	<p>The horizontal shear is performed before the vertical part. This is
				7027	important to note, since horizontal and vertical shears do not
				7028	<var>commute</var>, i.e., the order matters in a sequence of shears. For
				7029	example, the following two commands are not equivalent.</p>
				7030
				7031	<pre>
				7032	convert logo: -shear 20x0 -shear 0x60 logo-sheared.png
				7033	convert logo: -shear 0x60 -shear 20x0 logo-sheared.png
				7034	</pre>
				7035
				7036	<p>The first of the two commands above is equivalent to the following, except
				7037	for the amount of empty space created; the command that follows generates
				7038	a smaller image, and so is a better choice in terms of time and space.</p>
				7039
				7040	<pre>
				7041	convert logo: -shear 20x60 logo-sheared.png
				7042	</pre>
				7043
				7044	<div style="margin: auto;">
				7045	<h3 class="magick-header"><a id="sigmoidal-contrast"></a>-sigmoidal-contrast <var>contrast</var>x<var>mid-point</var></h3>
				7046	</div>
				7047
				7048	<p class="magick-description">increase the contrast without saturating highlights or shadows.</p>
				7049
				7050	<p>Increase the contrast of the image using a sigmoidal transfer function
				7051	without saturating highlights or shadows. <var>Contrast</var>
				7052	indicates how much to increase the contrast. For example, 0 is none, 3 is
				7053	typical and 20 is a lot.
				7054	</p>
				7055
				7056	<p>The <var>mid-point</var> indicates where the maximum change
				7057	'slope' in contrast should fall in the resultant image (0 is white; 50% is
				7058	middle-gray; 100% is black). </p>
				7059
				7060	<p>By default the image contrast is increased, use <var>+sigmoidal-contrast</var> to decrease the contrast.</p>
				7061
				7062	<p>To achieve the equivalent of a sigmoidal brightness change (similar to
				7063	a gamma adjustment), you would use <var>-sigmoidal-contrast
				7064	{brightness}x0%</var> to increase brightness and <var>+sigmoidal-contrast {brightness}x0%</var> to decrease brightness.
				7065	Note the use of '0' fo rthe mid-point of the sigmoidal curve. </p>
				7066
				7067	<p>Using a very high <var>contrast</var> will produce a sort of
				7068	'smoothed thresholding' of the image. Not as sharp (with high aliasing
				7069	effects) of a true threshold, but with tapered gray-levels around the threshold
				7070	<var>mid-point</var>. </p>
				7071
				7072	<div style="margin: auto;">
				7073	<h3 class="magick-header"><a id="silent"></a>-silent</h3>
Cristy	f650f4f	2016-04-01 10:53:07 -0400	[diff] [blame]	7074
				7075
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7076	</div>
				7077
Cristy	f650f4f	2016-04-01 10:53:07 -0400	[diff] [blame]	7078	<p class="magick-description">operate silently. This option is only used
				7079	by the <a href="import.html">import</a> tool.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7080
				7081	<div style="margin: auto;">
				7082	<h3 class="magick-header"><a id="similarity-threshold"></a>-similarity-threshold <var>value</var></h3>
				7083	</div>
				7084
				7085	<p class="magick-description">minimum RMSE for subimage match.</p>
				7086
				7087	<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>
				7088
				7089	<div style="margin: auto;">
				7090	<h3 class="magick-header"><a id="size"></a>-size <var>width</var>[x<var>height</var>][<var>+offset</var>]</h3>
				7091	</div>
				7092
				7093	<p class="magick-description">set the width and height of the image.</p>
				7094
				7095	<p>Use this option to specify the width and height of raw images whose
				7096	dimensions are unknown such as <code>GRAY</code>, <code>RGB</code>, or
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7097	<code>CMYK</code>. In addition to width and height, use <a
				7098	href="command-line-options.html#size">-size</a> with an offset to skip any header information in the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7099	image or tell the number of colors in a <code>MAP</code> image file, (e.g. -size
				7100	640x512+256).</p>
				7101
				7102	<p>For Photo CD images, choose from these sizes:</p>
				7103
				7104	<pre>
				7105	192x128
				7106	384x256
				7107	768x512
				7108	1536x1024
				7109	3072x2048
				7110	</pre>
				7111
				7112	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7113	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7114	</div>
				7115
				7116	<p class="magick-description">simulate a pencil sketch.</p>
				7117
				7118	<p>Sketch with the given radius, standard deviation (sigma), and angle. The
				7119	angle given is the angle toward which the image is sketched. That is the
				7120	direction people would consider the object is coming from. </p>
				7121
				7122	<div style="margin: auto;">
				7123	<h3 class="magick-header"><a id="smush"></a>-smush <var>offset</var></h3>
				7124	</div>
				7125
Cristy	bc23242	2016-11-22 07:46:18 -0500	[diff] [blame]	7126	<p class="magick-description">appends an image sequence together ignoring transparency.</p>
				7127
				7128	<p>Smush is a more flexible version of <a href="command-line-options.html#append">-append</a>, joining the images in the sequence top-to-bottom (<a href="command-line-options.html#smush">-smush</a>) or left-to-right (<a href="command-line-options.html#smush">+smush</a>), with a gap between images according to the specified offset.</p>
				7129
				7130	<p>If the offset is negative, images will overlap by that amount.</p>
				7131
				7132	<p><a href="command-line-options.html#smush">-smush</a> respects <a href="command-line-options.html#gravity">-gravity</a>. Any empty space will be filled with the <a href="command-line-options.html#background">-background</a> color.</p>
				7133
				7134	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7135
				7136	<div style="margin: auto;">
				7137	<h3 class="magick-header"><a id="snaps"></a>-snaps <var>value</var></h3>
				7138	</div>
				7139
				7140	<p class="magick-description">Set the number of screen snapshots.</p>
				7141
				7142	<p>Use this option to grab more than one image from the X server screen, to create an animation sequence.</p>
				7143
				7144	<div style="margin: auto;">
Cristy	769d889	2016-01-19 18:11:14 -0500	[diff] [blame]	7145	<h3 class="magick-header"><a id="solarize"></a>-solarize <var>percent-threshold</var></h3>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7146	</div>
				7147
				7148	<p class="magick-description">negate all pixels above the threshold level.</p>
				7149
				7150	<p>Specify <var>factor</var> as the percent threshold of the intensity (0 - 99.9%).</p>
				7151
				7152	<p>This option produces a <var>solarization</var> effect seen when
				7153	exposing a photographic film to light during the development process.</p>
				7154
				7155	<div style="margin: auto;">
				7156	<h3 class="magick-header"><a id="sparse-color"></a>-sparse-color <var>method</var> '<var>x</var>,<var>y</var> <var>color</var> ...'</h3>
				7157	</div>
				7158
				7159	<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>
				7160
				7161
				7162	<dl class="dl-horizontal">
				7163	<dt>barycentric</dt>
				7164	<dd>three point triangle of color given 3 points.
				7165	Giving only 2 points will form a linear gradient between those points.
				7166	The gradient generated extends beyond the triangle created by those
				7167	3 points. </dd>
				7168	<dt>bilinear</dt>
				7169	<dd>Like barycentric but for 4 points. Less than 4 points
				7170	fall back to barycentric. </dd>
				7171	<dt>voronoi</dt>
				7172	<dd>Simply map each pixel to the to nearest color point
				7173	given. The result are polygonal 'cells' of solid color. </dd>
				7174	<dt>manhatten</dt>
				7175	<dd>Like voronoi, but resulting polygonal 'cells' are mapped to a fixed coordinate system.</dd>
				7176	<dt>shepards</dt>
				7177	<dd>Colors points biased on the ratio of inverse distance
				7178	squared. Generating spots of color in a sea of the average of
				7179	colors. </dd>
				7180	<dt>inverse</dt>
				7181	<dd>Colors points biased on the ratio of inverse distance.
				7182	This generates sharper points of color rather than rounded spots of
				7183	'<code>shepards</code>' Generating spots of color in a sea of the
				7184	average of colors. </dd>
				7185	</dl>
				7186
				7187	<p>The points are placed according to the images location on the virtual
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7188	canvas (<a href="command-line-options.html#page" >-page</a> or <a href="command-line-options.html#repage" >-repage</a>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7189	offset), and do not actually have to exist on the given image, but may be
				7190	some point beyond the edge of the image. All points are floating point values.
				7191	</p>
				7192
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7193	<p>Only the color channels defined by the <a href="command-line-options.html#channel" >-channel</a> are
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7194	modified, which means that by default matte/alpha transparency channel is not
				7195	effected. Typically transparency channel is turned off either before or after
				7196	the operation. </p>
				7197
				7198	<p>Of course if some color points are transparent to generate a transparent
				7199	gradient, then the image also requires transparency enabled to store the
				7200	values. </p>
				7201
				7202	<p>All the above methods when given a single point of color will replace all
				7203	the colors in the image with the color given, regardless of the point. This is
				7204	logical, and provides an alternative technique to recolor an image to some
				7205	default value. </p>
				7206
				7207
				7208	<div style="margin: auto;">
				7209	<h3 class="magick-header"><a id="splice"></a>-splice <var>geometry</var></h3>
				7210	</div>
				7211
				7212	<p class="magick-description">Splice the current background color into the image.</p>
				7213
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7214	<p>This will add rows and columns of the current <a
				7215	href="command-line-options.html#background">-background</a> color into the given image according to the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7216	given <a href="command-line-options.html#gravity">-gravity</a> geometry setting. See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument. Essentially <a href="command-line-options.html#splice">-splice</a> will divide the
				7217	image into four quadrants, separating them by the inserted rows and columns.
				7218	</p>
				7219
				7220	<p>If a dimension of geometry is zero no rows or columns will be added for that
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7221	dimension. Similarly using a zero offset with the appropriate <a
				7222	href="command-line-options.html#gravity">-gravity</a> setting will add rows and columns to the edges of
				7223	the image, padding the image only along that one edge. Edge padding is what <a
				7224	href="command-line-options.html#splice">-splice</a> is most commonly used for. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7225
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7226	<p>If the exact same <var>geometry</var> and <a
				7227	href="command-line-options.html#gravity">-gravity</a> is later used with <a href="command-line-options.html#chop">-chop</a> the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7228	added added all splices removed. </p>
				7229
				7230	<div style="margin: auto;">
				7231	<h3 class="magick-header"><a id="spread"></a>-spread <var>amount</var></h3>
				7232	</div>
				7233
				7234	<p class="magick-description">displace image pixels by a random amount.</p>
				7235
				7236	<p>The argument <var>amount</var> defines the size of the
				7237	neighborhood around each pixel from which to choose a candidate pixel to
				7238	blend.</p>
				7239
				7240	<p>The lookup is controlled by the <a href="command-line-options.html#interpolate">-interpolate</a> setting.</p>
				7241
				7242	<div style="margin: auto;">
				7243	<h3 class="magick-header"><a id="statistic"></a>-statistic <var>type</var> <var>geometry</var></h3>
				7244	</div>
				7245
				7246	<p class="magick-description">replace each pixel with corresponding statistic from the neighborhood.</p>
				7247
				7248	<p>Choose from these statistic types:</p>
				7249	<dl class="dl-horizontal">
				7250	<dt>Gradient</dt><dd>maximum difference (max - min) value in neighborhood</dd>
				7251	<dt>Maximum</dt><dd>maximum value per channel in neighborhood</dd>
				7252	<dt>Minimum</dt><dd>minimum value per channel in neighborhood</dd>
				7253	<dt>Mean</dt><dd>average value per channel in neighborhood</dd>
				7254	<dt>Median</dt><dd>median value per channel in neighborhood</dd>
				7255	<dt>Mode</dt><dd>mode (most frequent) value per channel in neighborhood</dd>
				7256	<dt>Nonpeak</dt><dd>value just before or after the median value per channel in neighborhood</dd>
				7257	<dt>RMS</dt><dd>root mean square value per channel in neighborhood</dd>
				7258	<dt>StandardDeviation</dt><dd> standard deviation value per channel in neighborhood</dd>
				7259	</dl>
				7260
				7261	<div style="margin: auto;">
				7262	<h3 class="magick-header"><a id="stegano"></a>-stegano <var>offset</var></h3>
				7263	</div>
				7264
				7265	<p class="magick-description">hide watermark within an image.</p>
				7266
				7267	<p>Use an offset to start the image hiding some number of pixels from the
				7268	beginning of the image. Note this offset and the image size. You will need
				7269	this information to recover the steganographic image (e.g. display -size
				7270	320x256+35 stegano:image.png).</p>
				7271
				7272	<div style="margin: auto;">
				7273	<h3 class="magick-header"><a id="stereo"></a>-stereo <var>+x</var>{<var>+y</var>}</h3>
				7274	</div>
				7275
				7276	<p class="magick-description">composite two images to create a red / cyan stereo anaglyph.</p>
				7277
				7278	<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>
				7279
				7280	<div style="margin: auto;">
				7281	<h3 class="magick-header"><a id="storage-type"></a>-storage-type <var>type</var></h3>
				7282	</div>
				7283
				7284	<p class="magick-description">pixel storage type. Here are the valid types:</p>
				7285
				7286	<dl class="dl-horizontal">
				7287	<dt>char</dt><dd>unsigned characters</dd>
				7288	<dt>double</dt><dd>doubles</dd>
				7289	<dt>float</dt><dd>floats</dd>
				7290	<dt>integer</dt><dd>integers</dd>
				7291	<dt>long</dt><dd>longs</dd>
				7292	<dt>quantum</dt><dd>pixels in the native depth of your ImageMagick distribution</dd>
				7293	<dt>short</dt><dd>unsigned shorts</dd>
				7294	</dl>
				7295
				7296	<p>Float and double types are normalized from 0.0 to 1.0 otherwise the pixels
				7297	values range from 0 to the maximum value the storage type can support.</p>
				7298
				7299	<div style="margin: auto;">
				7300	<h3 class="magick-header"><a id="stretch"></a>-stretch <var>fontStretch</var></h3>
				7301	</div>
				7302
				7303	<p class="magick-description">Set a type of stretch style for fonts.</p>
				7304
				7305	<p>This setting suggests a type of stretch that ImageMagick should try to
				7306	apply to the currently selected font family. Select <var>fontStretch</var> from the following.</p>
				7307
				7308	<pre>
				7309	Any
				7310	Condensed
				7311	Expanded
				7312	ExtraCondensed
				7313	ExtraExpanded
				7314	Normal
				7315	SemiCondensed
				7316	SemiExpanded
				7317	UltraCondensed
				7318	UltraExpanded
				7319	</pre>
				7320
				7321	<p>To print a complete list of stretch types, use <a href="command-line-options.html#list">-list
				7322	stretch</a>.</p>
				7323
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7324	<p>For other settings that affect fonts, see the options <a
				7325	href="command-line-options.html#font">-font</a>, <a href="command-line-options.html#family">-family</a>, <a
				7326	href="command-line-options.html#style">-style</a>, and <a href="command-line-options.html#weight">-weight</a>. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7327
				7328	<div style="margin: auto;">
				7329	<h3 class="magick-header"><a id="strip"></a>-strip</h3>
				7330	</div>
				7331
Cristy	776113a	2016-04-29 12:01:19 -0400	[diff] [blame]	7332	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7333
				7334	<div style="margin: auto;">
				7335	<h3 class="magick-header"><a id="stroke"></a>-stroke <var>color</var></h3>
				7336	</div>
				7337
				7338	<p class="magick-description">color to use when stroking a graphic primitive.</p>
				7339
				7340	<p>The color is specified using the format described under the <a href="command-line-options.html#fill">-fill</a> option.</p>
				7341
				7342	<p>See <a href="command-line-options.html#draw">-draw</a> for further details.</p>
				7343
				7344	<div style="margin: auto;">
				7345	<h3 class="magick-header"><a id="strokewidth"></a>-strokewidth <var>value</var></h3>
				7346	</div>
				7347
				7348	<p class="magick-description">set the stroke width.</p>
				7349
				7350	<p>See <a href="command-line-options.html#draw">-draw</a> for further details.</p>
				7351
				7352	<div style="margin: auto;">
				7353	<h3 class="magick-header"><a id="style"></a>-style <var>fontStyle</var></h3>
				7354	</div>
				7355
				7356	<p class="magick-description">Set a font style for text.</p>
				7357
				7358	<p>This setting suggests a font style that ImageMagick should try to apply to
				7359	the currently selected font family. Select <var>fontStyle</var> from
				7360	the following.</p>
				7361
				7362	<pre>
				7363	Any
				7364	Italic
				7365	Normal
				7366	Oblique
				7367	</pre>
				7368
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7369	<p>For other settings that affect fonts, see the options <a
				7370	href="command-line-options.html#font">-font</a>, <a href="command-line-options.html#family">-family</a>, <a
				7371	href="command-line-options.html#stretch">-stretch</a>, and <a href="command-line-options.html#weight">-weight</a>. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7372
				7373	<div style="margin: auto;">
				7374	<h3 class="magick-header"><a id="subimage-search"></a>-subimage-search</h3>
				7375	</div>
				7376
				7377	<p class="magick-description">search for subimage.</p>
				7378
				7379	<p>This option is required to have compare search for the best match location
				7380	of a small image within a larger image. This search will produce two images
				7381	(or two frames). The first is the "difference" image and the second will
				7382	be the "match score" image.</p>
				7383
				7384	<p>The "match-score" image is smaller containing a pixel for ever possible
				7385	position of the top-left corner of the given sub-image. that is its size will
				7386	be the size of the larger_image - sub_image + 1. The brightest location in
				7387	this image is the location s the locate on the best match that is also
				7388	reported. Note that this may or may not be a perfect match, and the actual
				7389	brightness will reflect this. Other bright 'peaks' can be used to locate other
				7390	possible matching locations. </p>
				7391
				7392	<p>Note that the search will try to compare the sub-image at every possible
				7393	location in the larger image, as such it can be very slow. The smaller the
				7394	sub-image the faster this search is. </p>
				7395
				7396
				7397	<div style="margin: auto;">
				7398	<h3 class="magick-header"><a id="swap"></a>-swap <var>index,index</var></h3>
				7399	</div>
				7400
				7401	<p class="magick-description">Swap the positions of two images in the image sequence.</p>
				7402
				7403	<p>For example, <a href="command-line-options.html#swap">-swap 0,2</a> swaps the first and the third
				7404	images in the current image sequence. Use <a href="command-line-options.html#swap">+swap</a> to switch
				7405	the last two images in the sequence.</p>
				7406
				7407	<div style="margin: auto;">
				7408	<h3 class="magick-header"><a id="swirl"></a>-swirl <var>degrees</var></h3>
				7409	</div>
				7410
				7411	<p class="magick-description">swirl image pixels about the center.</p>
				7412
				7413	<p><var>Degrees</var> defines the tightness of the swirl.</p>
				7414
				7415	<div style="margin: auto;">
				7416	<h3 class="magick-header"><a id="synchronize"></a>-synchronize</h3>
				7417	</div>
				7418
				7419	<p class="magick-description">synchronize image to storage device.</p>
				7420
				7421	<p>Set to "true" to ensure all image data is fully flushed and synchronized
				7422	to disk. There is a performance penalty, but the benefits include ensuring a
				7423	valid image file in the event of a system crash and early reporting if there
				7424	is not enough disk space for the image pixel cache.</p>
				7425
				7426	<div style="margin: auto;">
				7427	<h3 class="magick-header"><a id="taint"></a>-taint</h3>
				7428	</div>
				7429
				7430	<p class="magick-description">Mark the image as modified.</p>
				7431
				7432	<div style="margin: auto;">
				7433	<h3 class="magick-header"><a id="text-font"></a>-text-font <var>name</var></h3>
				7434	</div>
				7435
				7436	<p class="magick-description">font for writing fixed-width text.</p>
				7437
				7438	<p>Specifies the name of the preferred font to use in fixed (typewriter style)
				7439	formatted text. The default is 14 point <var>Courier</var>.</p>
				7440
				7441	<p>You can tag a font to specify whether it is a PostScript, TrueType, or
				7442	OPTION1 font. For example, <code>Courier.ttf</code> is a TrueType font and
				7443	<code>x:fixed</code> is OPTION1.</p>
				7444
				7445	<div style="margin: auto;">
				7446	<h3 class="magick-header"><a id="texture"></a>-texture <var>filename</var></h3>
				7447	</div>
				7448
				7449	<p class="magick-description">name of texture to tile onto the image background.</p>
				7450
				7451	<div style="margin: auto;">
				7452	<h3 class="magick-header"><a id="threshold"></a>-threshold <var>value</var>{<var>%</var>}</h3>
				7453	</div>
				7454
				7455	<!-- {<var>green,blue,opacity</var>}
				7456	<p>If the green or blue value is omitted, these channels use the same value as
				7457	the first one provided. If all three color values are the same, the result is
				7458	a bi-level image. If the opacity threshold is omitted, OpaqueOpacity is used
				7459	and any partially transparent pixel becomes fully transparent.</p>
				7460	-->
				7461
				7462	<p class="magick-description">Apply simultaneous black/white threshold to the image.</p>
				7463
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7464	<p>Any pixel values (more specifically, those channels set using <a href="command-line-options.html#channel">‑channel</a>) that exceed the specified threshold are reassigned the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7465	maximum channel value, while all other values are assigned the minimum.</p>
				7466
				7467	<p> The threshold value can be given as a percentage or as an absolute integer
				7468	value corresponding to the desired channel value. When given as an integer,
				7469	the minimum attainable value is 0 (corresponding to black when all channels
				7470	are affected), but the maximum value (corresponding to white) is that of the
				7471	<code>quantum depth</code> of the particular build of ImageMagick, and is
				7472	therefore dependent on the installation. For that reason, a reasonable
				7473	recommendation for most applications is to specify the threshold values as
				7474	a percentage. </p>
				7475
				7476	<p> The following would force pixels with red values above 50% to have 100%
				7477	red values, while those at or below 50% red would be set to 0 in the red
				7478	channel. The green, blue, and alpha channels (if present) would be unchanged.
				7479	</p>
				7480
				7481	<pre>
				7482	convert in.png -channel red -threshold 50% out.png
				7483	</pre>
				7484
				7485	<p>As (possibly) impractical but instructive examples, the following would
				7486	generate an all-black and an all-white image with the same dimensions as the
				7487	input image.</p>
				7488
				7489
				7490	<pre>
				7491	convert in.png -threshold 100% black.png
				7492	convert in.png -threshold -1 white.png
				7493	</pre>
				7494
				7495	<p>Note that the values of the transparency channel is treated as 'matte'
				7496	values (0 is opaque) and not as 'alpha' values (0 is transparent).</p>
				7497
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7498	<p> See also <a href="command-line-options.html#black-threshold">‑black‑threshold</a> and <a href="command-line-options.html#white-threshold">‑white‑threshold</a>.
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7499	</p>
				7500
				7501	<div style="margin: auto;">
				7502	<h3 class="magick-header"><a id="thumbnail"></a>-thumbnail <var>geometry</var></h3>
				7503	</div>
				7504
				7505	<p class="magick-description">Create a thumbnail of the image.</p>
				7506
				7507	<p>This is similar to <a href="command-line-options.html#resize">-resize</a>, except it is optimized
				7508	for speed and any image profile, other than a color profile, is removed to
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7509	reduce the thumbnail size. To strip the color profiles as well, add <a
				7510	href="command-line-options.html#strip">-strip</a> just before of after this option.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7511
				7512	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
				7513
				7514	<div style="margin: auto;">
				7515	<h3 class="magick-header"><a id="tile"></a>-tile <var>filename</var></h3>
				7516	</div>
				7517
				7518	<p class="magick-description">Set the tile image used for filling a subsequent graphic primitive.</p>
				7519
				7520	<div style="margin: auto;">
				7521	<h3 class="magick-header">-tile <var>geometry</var></h3>
				7522	</div>
				7523
				7524	<p class="magick-description">Specify the layout of images.</p>
				7525
				7526	<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p>
				7527
				7528	<div style="margin: auto;">
				7529	<h3 class="magick-header">-tile</h3>
				7530	</div>
				7531
				7532	<p class="magick-description">Specifies that a subsequent composite operation is repeated across and down image.</p>
				7533
				7534	<div style="margin: auto;">
				7535	<h3 class="magick-header"><a id="tile-offset"></a>-tile-offset {<var>+-</var>}<var>x</var>{<var>+-</var>}<var>y</var></h3>
				7536	</div>
				7537
				7538	<p class="magick-description">Specify the offset for tile images, relative to the background image it is tiled on.</p>
				7539
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7540	<p>This should be set before the tiling image is set by <a href="command-line-options.html#tile"
				7541	>-tile</a> or <a href="command-line-options.html#texture" >-texture</a>, or directly applied for
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7542	creating a tiled canvas using <code>TILE:</code> or <code>PATTERN:</code> input
				7543	formats. </p>
				7544
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7545	<p>Internally ImageMagick does a <a href="command-line-options.html#roll" >-roll</a> of the tile image
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7546	by the arguments given when the tile image is set. </p>
				7547
				7548	<div style="margin: auto;">
				7549	<h3 class="magick-header"><a id="tint"></a>-tint <var>value</var></h3>
				7550	</div>
				7551
				7552	<p class="magick-description">Tint the image with the fill color.</p>
				7553
				7554	<p>Tint the image with the fill color.</p>
				7555
				7556	<p>Specify the amount of tinting as a percentage. Pure colors like black,
				7557	white red, yellow, will not be affected by -tint. Only mid-range colors such
				7558	as the various shades of grey.</p>
				7559
				7560	<div style="margin: auto;">
				7561	<h3 class="magick-header"><a id="title"></a>-title <var>string</var></h3>
				7562	</div>
				7563
				7564	<p class="magick-description">Assign a title to displayed image.", "animate", "display", "montage</p>
				7565
				7566	<p>Use this option to assign a specific title to the image. This assigned to
				7567	the image window and is typically displayed in the window title bar.
				7568	Optionally you can include the image filename, type, width, height, Exif data,
				7569	or other image attribute by embedding special format characters described
				7570	under the <a href="command-line-options.html#format">-format</a> option.</p>
				7571
				7572	<p>For example,</p>
				7573
				7574	<pre>
				7575	-title "%m:%f %wx%h"
				7576	</pre>
				7577
				7578	<p>produces an image title of <code>MIFF:bird.miff 512x480</code> for an image
				7579	titled <code>bird.miff</code> and whose width is 512 and height is 480.</p>
				7580
				7581
				7582	<div style="margin: auto;">
				7583	<h3 class="magick-header"><a id="transform"></a>-transform</h3>
				7584	</div>
				7585
				7586	<p class="magick-description">transform the image.</p>
				7587
				7588	<p>This option applies the transformation matrix from a previous <a href="command-line-options.html#affine">-affine</a> option.</p>
				7589
				7590	<pre>
				7591	convert -affine 2,2,-2,2,0,0 -transform bird.ppm bird.jpg
				7592	</pre>
				7593
				7594
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7595	<p>This operator has been now been superseded by the <a
				7596	href="command-line-options.html#distort">-distort</a> '<code>AffineProjection</code>' method. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7597
				7598
				7599	<div style="margin: auto;">
				7600	<h3 class="magick-header"><a id="transparent"></a>-transparent <var>color</var></h3>
				7601	</div>
				7602
				7603	<p class="magick-description">Make this color transparent within the image.</p>
				7604
				7605	<p>The <var>color</var> argument is defined using the format
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7606	described under the <a href="command-line-options.html#fill">-fill</a> option. The <a href="command-line-options.html#fuzz"
				7607	>-fuzz</a> setting can be used to match and replace colors similar to the one
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7608	given. </p>
				7609
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7610	<p>Use <a href="command-line-options.html#transparent" >+transparent</a> to invert the pixels matched.
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7611	that is make all non-matching colors transparent. </p>
				7612
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7613	<p>The <a href="command-line-options.html#opaque">-opaque</a> operator is exactly the same as <a
				7614	href="command-line-options.html#transparent" >-transparent</a> but replaces the matching color with the
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7615	current <a href="command-line-options.html#fill">-fill</a> color setting, rather than transparent.
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7616	However the <a href="command-line-options.html#transparent" >-transparent</a> operator also ensures
				7617	that the image has an alpha channel enabled, as per "<code><a href="command-line-options.html#alpha"
				7618	>-alpha</a> set</code>", and does not require you to modify the <a
				7619	href="command-line-options.html#channel">-channel</a> to enable alpha channel handling. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7620
				7621	<p>Note that this does not define the color as being the 'transparency color'
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7622	used for color-mapped image formats, such as GIF. For that use <a
				7623	href="command-line-options.html#transparent-color" >-transparent-color</a> </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7624
				7625
				7626	<div style="margin: auto;">
				7627	<h3 class="magick-header"><a id="transparent-color"></a>-transparent-color <var>color</var></h3>
				7628	</div>
				7629
				7630	<p class="magick-description">Set the transparent color.</p>
				7631
				7632	<p>Sometimes this is used for saving to image formats such as
				7633	GIF and PNG8 which uses this color to represent boolean transparency. This
				7634	does not make a color transparent, it only defines what color the transparent
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7635	color is in the color palette of the saved image. Use <a
				7636	href="command-line-options.html#transparent">-transparent</a> to make an opaque color transparent.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7637
				7638	<p>This option allows you to have both an opaque visible color, as well as a
				7639	transparent color of the same color value without conflict. That is, you can
				7640	use the same color for both the transparent and opaque color areas within an
				7641	image. This, in turn, frees to you to select a transparent color that is
				7642	appropriate when an image is displayed by an application that does not handle a
				7643	transparent color index, while allowing ImageMagick to correctly handle images of this
				7644	type. </p>
				7645
				7646	<p>The default transparent color is <code>#00000000</code>, which is fully transparent black.</p>
				7647
				7648	<div style="margin: auto;">
				7649	<h3 class="magick-header"><a id="transpose"></a>-transpose</h3>
				7650	</div>
				7651
				7652	<p class="magick-description">Mirror the image along the top-left to bottom-right diagonal.</p>
				7653
				7654	<p> This option mathematically transposes the pixel array. It is equivalent to the sequence <code>-flip -rotate 90</code>.
				7655	</p>
				7656
				7657	<div style="margin: auto;">
				7658	<h3 class="magick-header"><a id="transverse"></a>-transverse</h3>
				7659	</div>
				7660
				7661	<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>
				7662
				7663
				7664	<div style="margin: auto;">
				7665	<h3 class="magick-header"><a id="treedepth"></a>-treedepth <var>value</var></h3>
				7666	</div>
				7667
				7668	<p class="magick-description">tree depth for the color reduction algorithm.</p>
				7669
				7670	<p>Normally, this integer value is zero or one. A value of zero or one causes
				7671	the use of an optimal tree depth for the color reduction algorithm.</p>
				7672
				7673	<p>An optimal depth generally allows the best representation of the source
				7674	image with the fastest computational speed and the least amount of memory.
				7675	However, the default depth is inappropriate for some images. To assure the
				7676	best representation, try values between 2 and 8 for this parameter. Refer to
Cristy	6549abb	2016-11-10 08:25:55 -0500	[diff] [blame]	7677	the <a href="http://www.imagemagick.org/www/quantize.html"
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7678	>color reduction algorithm</a> for more details.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7679
				7680	<p>The <a href="command-line-options.html#colors">-colors</a> or <a href="command-line-options.html#monochrome">-monochrome</a>
				7681	option, or writing to an image format which requires color reduction, is
				7682	required for this option to take effect.</p>
				7683
				7684	<div style="margin: auto;">
				7685	<h3 class="magick-header"><a id="trim"></a>-trim</h3>
				7686	</div>
				7687
				7688	<p class="magick-description">trim an image.</p>
				7689
				7690	<p>This option removes any edges that are exactly the same color as the corner
				7691	pixels. Use <a href="command-line-options.html#fuzz">-fuzz</a> to make <a href="command-line-options.html#trim">-trim</a> remove
				7692	edges that are nearly the same color as the corner pixels.</p>
				7693
				7694	<p>The page or virtual canvas information of the image is preserved allowing
				7695	you to extract the result of the <a href="command-line-options.html#trim">-trim</a> operation from the
				7696	image. Use a <a href="command-line-options.html#repage">+repage</a> to remove the virtual canvas page
				7697	information if it is unwanted.</p>
				7698
				7699	<p>If the trimmed image 'disappears' an warning is produced, and a special
				7700	single pixel transparent 'missed' image is returned, in the same way as when a
				7701	<a href="command-line-options.html#crop">-crop</a> operation 'misses' the image proper. </p>
				7702
				7703
				7704	<div style="margin: auto;">
				7705	<h3 class="magick-header"><a id="type"></a>-type <var>type</var></h3>
				7706	</div>
				7707
				7708	<p class="magick-description">the image type.</p> <p>Choose from: <code>Bilevel</code>,
				7709	<code>Grayscale</code>, <code>GrayscaleMatte</code>, <code>Palette</code>,
				7710	<code>PaletteMatte</code>, <code>TrueColor</code>, <code>TrueColorMatte</code>,
				7711	<code>ColorSeparation</code>, or <code>ColorSeparationMatte</code>.</p>
				7712
				7713	<p>Normally, when a format supports different subformats such as grayscale and
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7714	truecolor, the encoder will try to choose an efficient subformat. The <a
				7715	href="command-line-options.html#type">-type</a> option can be used to override this behavior. For
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7716	example, to prevent a JPEG from being written in grayscale format even though
				7717	only gray pixels are present, use.</p>
				7718
				7719	<pre>
				7720	convert bird.png -type TrueColor bird.jpg
				7721	</pre>
				7722
				7723	<p>Similarly, use <a href="command-line-options.html#type">-type TrueColorMatte</a> to force the
				7724	encoder to write an alpha channel even though the image is opaque, if the
				7725	output format supports transparency.</p>
				7726
				7727	<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>
				7728
				7729	<div style="margin: auto;">
				7730	<h3 class="magick-header"><a id="undercolor"></a>-undercolor <var>color</var></h3>
				7731	</div>
				7732
				7733	<p class="magick-description">set the color of the annotation bounding box.</p>
				7734
				7735	<p>The color is specified using the format described under the <a href="command-line-options.html#fill">-fill</a> option.</p>
				7736
				7737	<p>See <a href="command-line-options.html#draw">-draw</a> for further details.</p>
				7738
				7739
				7740	<div style="margin: auto;">
				7741	<h3 class="magick-header"><a id="update"></a>-update <var>seconds</var></h3>
				7742	</div>
				7743
				7744	<p class="magick-description">detect when image file is modified and redisplay.</p>
				7745
				7746	<p>Suppose that while you are displaying an image the file that is currently
				7747	displayed is over-written. <code>display</code> will automagically detect that
				7748	the input file has been changed and update the displayed image
				7749	accordingly.</p>
				7750
				7751
				7752	<div style="margin: auto;">
				7753	<h3 class="magick-header"><a id="unique-colors"></a>-unique-colors</h3>
				7754	</div>
				7755
				7756	<p class="magick-description">discard all but one of any pixel color.</p>
				7757
				7758
				7759	<div style="margin: auto;">
				7760	<h3 class="magick-header"><a id="units"></a>-units <var>type</var></h3>
				7761	</div>
				7762
				7763	<p class="magick-description">the units of image resolution.</p>
				7764
				7765	<p>Choose from: <code>Undefined</code>, <code>PixelsPerInch</code>, or
				7766	<code>PixelsPerCentimeter</code>. This option is normally used in conjunction
				7767	with the <a href="command-line-options.html#density">-density</a> option.</p>
				7768
				7769
				7770	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7771	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7772	</div>
				7773
				7774	<p class="magick-description">sharpen the image with an unsharp mask operator.</p>
				7775
				7776	<p>The <a href="command-line-options.html#unsharp">-unsharp</a> option sharpens an image. The image is
				7777	convolved with a Gaussian operator of the given radius and standard deviation
				7778	(sigma). For reasonable results, radius should be larger than sigma. Use
				7779	a radius of 0 to have the method select a suitable radius.</p>
				7780
				7781	<p>The parameters are:</p>
				7782
				7783	<dl class="dl-horizontal">
				7784	<dt>radius</dt>
				7785	<dd>The radius of the Gaussian, in pixels, not counting the center pixel (default 0).</dd>
				7786	<dt>sigma</dt>
				7787	<dd>The standard deviation of the Gaussian, in pixels (default 1.0).</dd>
				7788	<dt>gain</dt>
				7789	<dd>The fraction of the difference between the original and the blur image that is added back into the original (default 1.0).</dd>
				7790	<dt>threshold</dt>
				7791	<dd>The threshold, as a fraction of <var>QuantumRange</var>, needed to apply the difference amount (default 0.05).</dd>
				7792	</dl>
				7793
				7794	<div style="margin: auto;">
				7795	<h3 class="magick-header"><a id="verbose"></a>-verbose</h3>
				7796	</div>
				7797
				7798	<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>
				7799
				7800
				7801	<div style="margin: auto;">
				7802	<h3 class="magick-header"><a id="version"></a>-version</h3>
				7803	</div>
				7804
				7805	<p class="magick-description">print ImageMagick version string and exit.</p>
				7806
				7807
				7808	<div style="margin: auto;">
				7809	<h3 class="magick-header"><a id="view"></a>-view <var>string</var></h3>
				7810	</div>
				7811
				7812	<p class="magick-description">FlashPix viewing parameters.</p>
				7813
				7814
				7815	<div style="margin: auto;">
				7816	<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>
				7817	</div>
				7818
				7819	<p class="magick-description">soften the edges of the image in vignette style.</p>
				7820
				7821	<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>
				7822
				7823	<div style="margin: auto;">
				7824	<h3 class="magick-header"><a id="virtual-pixel"></a>-virtual-pixel <var>method</var></h3>
				7825	</div>
				7826
				7827	<p class="magick-description">Specify contents of <var>virtual pixels</var>.</p>
				7828
				7829	<p>This option defines what color source should be used if and when a color
				7830	lookup completely 'misses' the source image. The color(s) that appear to
				7831	surround the source image. Generally this color is derived from the source
				7832	image, but could also be set to a specify background color. </p>
				7833
				7834	<p>Choose from these methods:</p>
				7835
				7836	<dl class="dl-horizontal">
				7837	<dt>background</dt><dd>the area surrounding the image is the background color</dd>
				7838	<dt>black</dt><dd>the area surrounding the image is black</dd>
				7839	<dt>checker-tile</dt><dd>alternate squares with image and background color</dd>
				7840	<dt>dither</dt><dd>non-random 32x32 dithered pattern</dd>
				7841	<dt>edge</dt><dd>extend the edge pixel toward infinity</dd>
				7842	<dt>gray</dt><dd>the area surrounding the image is gray</dd>
				7843	<dt>horizontal-tile</dt><dd>horizontally tile the image, background color above/below</dd>
				7844	<dt>horizontal-tile-edge</dt><dd>horizontally tile the image and replicate the side edge pixels</dd>
				7845	<dt>mirror</dt><dd>mirror tile the image</dd>
				7846	<dt>random</dt><dd>choose a random pixel from the image</dd>
				7847	<dt>tile</dt><dd>tile the image (default)</dd>
				7848	<dt>transparent</dt><dd>the area surrounding the image is transparent blackness</dd>
				7849	<dt>vertical-tile</dt><dd>vertically tile the image, sides are background color</dd>
				7850	<dt>vertical-tile-edge</dt><dd>vertically tile the image and replicate the side edge pixels</dd>
				7851	<dt>white</dt><dd>the area surrounding the image is white</dd>
				7852	</dl>
				7853
				7854	<p>The default value is "edge".</p>
				7855
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7856	<p>This most important for distortion operators such as <a href="command-line-options.html#distort"
				7857	>-distort</a>, <a href="command-line-options.html#implode" >-implode</a>, and <a href="command-line-options.html#fx" >-fx</a>.
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7858	However it also effects operations that may access pixels just outside the
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7859	image proper, such as <a href="command-line-options.html#convolve">-convolve</a>, <a
				7860	href="command-line-options.html#blur">-blur</a>, and <a href="command-line-options.html#sharpen">-sharpen</a>. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7861
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7862	<p>To print a complete list of virtual pixel types, use the <a
				7863	href="command-line-options.html#list">-list virtual-pixel</a> option.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7864
				7865
				7866	<div style="margin: auto;">
				7867	<h3 class="magick-header"><a id="visual"></a>-visual <var>type</var></h3>
				7868	</div>
				7869
				7870	<p class="magick-description">Animate images using this X visual type.", 'animate', 'display'</p>
				7871
				7872	<p>Choose from these visual classes:</p>
				7873
				7874	<pre>
				7875	StaticGray TrueColor
				7876	GrayScale DirectColor
				7877	StaticColor default
				7878	PseudoColor visual id
				7879	</pre>
				7880
				7881	<p>The X server must support the visual you choose, otherwise an error occurs.
				7882	If a visual is not specified, the visual class that can display the most
				7883	simultaneous colors on the default screen is chosen.</p>
				7884
				7885
				7886	<div style="margin: auto;">
				7887	<h3 class="magick-header"><a id="watermark"></a>-watermark <var>brightness</var>x<var>saturation</var></h3>
				7888	</div>
				7889
				7890	<p class="magick-description">Watermark an image using the given percentages of brightness and saturation.</p>
				7891
				7892	<p>Take a grayscale image (with alpha mask) and modify the destination image's
				7893	brightness according to watermark image's grayscale value and the
				7894	<var>brightness</var> percentage. The destinations color saturation
				7895	attribute is just direct modified by the <var>saturation</var>
				7896	percentage, which defaults to 100 percent (no color change). </p>
				7897
				7898
				7899	<div style="margin: auto;">
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7900	<h3 class="magick-header"><a id="wave"></a>-wave <var>amplitude</var><br />-wave <var>amplitude</var>x<var>wavelength</var></h3>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7901	</div>
				7902
				7903	<p class="magick-description">Shear the columns of an image into a sine wave.</p>
				7904
Cristy	e09ed31	2016-03-06 08:07:39 -0500	[diff] [blame]	7905	<div style="margin: auto;">
				7906	<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>
				7907	</div>
				7908
				7909	<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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7910
				7911	<div style="margin: auto;">
				7912	<h3 class="magick-header"><a id="weight"></a>-weight <var>fontWeight</var></h3>
				7913	</div>
				7914
				7915	<p class="magick-description">Set a font weight for text.</p>
				7916
				7917	<p>This setting suggests a font weight that ImageMagick should try to apply to
				7918	the currently selected font family. Use a positive integer for
				7919	<var>fontWeight</var> or select from the following.</p>
				7920
				7921	<dl class="dl-horizontal">
				7922	<dt>Thin </dt>
				7923	<dd>Same as <var>fontWeight</var> = 100.</dd>
				7924	<dt>ExtraLight </dt>
				7925	<dd>Same as <var>fontWeight</var> = 200.</dd>
				7926	<dt>Light </dt>
				7927	<dd>Same as <var>fontWeight</var> = 300.</dd>
				7928	<dt>Normal </dt>
				7929	<dd>Same as <var>fontWeight</var> = 400.</dd>
				7930	<dt>Medium </dt>
				7931	<dd>Same as <var>fontWeight</var> = 500.</dd>
				7932	<dt>DemiBold </dt>
				7933	<dd>Same as <var>fontWeight</var> = 600.</dd>
				7934	<dt>Bold </dt>
				7935	<dd>Same as <var>fontWeight</var> = 700.</dd>
				7936	<dt>ExtraBold </dt>
				7937	<dd>Same as <var>fontWeight</var> = 800.</dd>
				7938	<dt>Heavy </dt>
				7939	<dd>Same as <var>fontWeight</var> = 900.</dd>
				7940	</dl>
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7941	<br/>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7942
				7943	<p>To print a complete list of weight types, use <a href="command-line-options.html#list">-list weight</a>.</p>
				7944
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7945	<p>For other settings that affect fonts, see the options <a
				7946	href="command-line-options.html#font">-font</a>, <a href="command-line-options.html#family">-family</a>, <a
				7947	href="command-line-options.html#stretch">-stretch</a>, and <a href="command-line-options.html#style">-style</a>. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7948
				7949	<div style="margin: auto;">
				7950	<h3 class="magick-header"><a id="white-point"></a>-white-point <var>x,y</var></h3>
				7951	</div>
				7952
				7953	<p class="magick-description">chromaticity white point.</p>
				7954
				7955	<div style="margin: auto;">
				7956	<h3 class="magick-header"><a id="white-threshold"></a>-white-threshold <var>value</var>{<var>%</var>}</h3>
				7957	</div>
				7958
				7959	<p class="magick-description">Force to white all pixels above the threshold while leaving all pixels at or below the threshold unchanged.</p>
				7960
				7961	<p> The threshold value can be given as a percentage or as an absolute integer
				7962	value within [0, <var>QuantumRange</var>] corresponding to the
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7963	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>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7964
				7965	<div style="margin: auto;">
				7966	<h3 class="magick-header"><a id="window"></a>-window <var>id</var></h3>
				7967	</div>
				7968
				7969	<p class="magick-description">Make the image the background of a window.", 'animate', 'display'</p>
				7970
				7971	<p><var>id</var> can be a window id or name. Specify <code>root</code>
				7972	to select X's root window as the target window.</p>
				7973
				7974	<p>By default the image is tiled onto the background of the target window. If
				7975	<code>backdrop</code> or <a href="command-line-options.html#geometry">-resize</a> are specified, the
				7976	image is surrounded by the background color. Refer to <code>X RESOURCES</code>
				7977	for details.</p>
				7978
				7979	<p>The image will not display on the root window if the image has more unique
Cristy	594d277	2015-11-15 10:47:42 -0500	[diff] [blame]	7980	colors than the target window colormap allows. Use <a
				7981	href="command-line-options.html#colors">-colors</a> to reduce the number of colors.</p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	7982
				7983	<div style="margin: auto;">
				7984	<h3 class="magick-header"><a id="window-group"></a>-window-group</h3>
				7985	</div>
				7986
				7987	<p class="magick-description">specify the window group.</p>
				7988
				7989	<div style="margin: auto;">
				7990	<h3 class="magick-header"><a id="write"></a>-write <var>filename</var></h3>
				7991	</div>
				7992
				7993	<p class="magick-description">write an image sequence.</p>
				7994
				7995	<p>The image sequence preceding the <a href="command-line-options.html#write">-write</a> <var>filename</var> option is written out, and processing continues with the same image in its current state if there are additional options. To restore the image to its original state after writing it, use the <a href="command-line-options.html#write">+write</a> <var>filename</var> option.</p>
				7996
				7997	<p>Use <a href="command-line-options.html#compress">-compress</a> to specify the type of image compression.</p>
Cristy	e077971	2016-07-30 17:25:22 -0400	[diff] [blame]	7998
				7999	<div style="margin: auto;">
				8000	<h3 class="magick-header"><a id="write-mask"></a>-write-mask <var>filename</var></h3>
				8001	</div>
				8002
				8003	<p class="magick-description">Prevent updates to image pixels specified by the mask.</p>
				8004
				8005	<p>This the same as using a mask used for composite masking operations, with
				8006	grayscale values causing blended updates of the image the mask is attached to.
				8007	</p>
				8008
				8009	<p>Use <a href="command-line-options.html#write-mask">+write-mask</a> to remove the mask from images.</p>
				8010
				8011	<p>Also see <a href="command-line-options.html#clip-mask">-clip-mask</a> which work in the same way,
				8012	but with strict boolean masking. </p>
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	8013	</div>
				8014	</div>
				8015
				8016
Cristy	e93be68	2015-11-26 09:07:51 -0500	[diff] [blame]	8017
Cristy	882d9f4	2015-10-29 16:48:39 -0400	[diff] [blame]	8018	<footer class="magick-footer">
cristy	29f2c97	2015-07-28 13:37:46 +0000	[diff] [blame]	8019	<p><a href="support.html">Donate</a> •
				8020	<a href="sitemap.html">Sitemap</a> •
cristy	d243201	2015-05-04 23:15:15 +0000	[diff] [blame]	8021	<a href="links.html">Related</a> •
Cristy	e077971	2016-07-30 17:25:22 -0400	[diff] [blame]	8022	<a href="security-policy.html">Security</a> •
cristy	29f2c97	2015-07-28 13:37:46 +0000	[diff] [blame]	8023	<a href="architecture.html">Architecture</a>
cristy	d243201	2015-05-04 23:15:15 +0000	[diff] [blame]	8024	</p>
				8025	<p><a href="command-line-options.html#">Back to top</a> •
cristy	ea2793e	2015-05-31 16:52:26 +0000	[diff] [blame]	8026	<a href="http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> •
Cristy	6549abb	2016-11-10 08:25:55 -0500	[diff] [blame]	8027	<a href="https://www.imagemagick.org/script/contact.php">Contact Us</a></p>
Cristy	de27d76	2016-01-02 12:56:44 -0500	[diff] [blame]	8028	<p><small>© 1999-2016 ImageMagick Studio LLC</small></p>
cristy	d243201	2015-05-04 23:15:15 +0000	[diff] [blame]	8029	</footer>
				8030	</div><!-- /.container -->
				8031
Cristy	542697a	2015-10-12 20:10:32 -0400	[diff] [blame]	8032	<script src="https://localhost/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
Cristy	1f1f3a0	2016-06-01 07:25:42 -0400	[diff] [blame]	8033	<script src="../js/magick.html"></script>
cristy	d243201	2015-05-04 23:15:15 +0000	[diff] [blame]	8034	</div>
cristy	ad41c0c	2012-10-31 00:49:28 +0000	[diff] [blame]	8035	</body>
cristy	5a367e4	2015-05-05 12:39:18 +0000	[diff] [blame]	8036	</html>
Cristy	579a0cb	2016-11-26 12:27:17 -0500	[diff] [blame^]	8037	<!-- Magick Cache 26th November 2016 12:13 -->