diff --git a/www/command-line-processing.html b/www/command-line-processing.html
index 21a4c3a..3748069 100644
--- a/www/command-line-processing.html
+++ b/www/command-line-processing.html
@@ -127,7 +127,7 @@
<div class="sponsbox">
<div class="sponsor">
- <a title="Sponsor: alaTest.com" href="http://alatest.com">alaTest.com</a><!-- 20110801000300 -->
+ <a title="Sponsor: Atlas Multimedia" href="http://www.atlas-multimedia.de/">Atlas Multimedia</a><!-- 20101201000025 tanju.temurbas-->
</div>
<div class="sponsor">
<a title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
@@ -251,7 +251,20 @@
<h3>Explicit Image Format</h3>
<div class="doc-section">
- <p>Images are stored in a mryiad of image formats including the better known JPEG, PNG, TIFF and others. ImageMagick must know the format of the image before it can be read and processed. Most formats have a signature within the image that uniquely identifies the format. Failing that, ImageMagick leverages the filename extension to determine the format. For example, <kbd>image.jpg</kbd> tells ImageMagick it is reading an image in the JPEG format. In some cases the image may not contain a signature and/or the filename does not identify the image format. In these cases an explicit image format must be specified. For example, suppose our image is named <kbd>image</kbd> and contains raw red, green, and blue intensity values. ImageMagick has no way to automagically determine the image format so we explicitly set one:
+ <p>Images are stored in a myriad of image formats including
+the better known JPEG, PNG, TIFF and others. ImageMagick must know the format
+of the image before it can be read and processed. Most formats have a
+signature within the image that uniquely identifies the format. Failing
+that, ImageMagick leverages the filename extension to determine the format.
+For example, <kbd>image.jpg</kbd> or <kbd>image.JPG</kbd> tells ImageMagick
+it is reading an image in the JPEG format. </>
+
+ <p>In some cases the image may not contain a signature
+and/or the filename does not identify the image format. In these cases an
+explicit image format must be specified. For example, suppose our image
+is named <kbd>image</kbd> and contains raw red, green, and blue intensity
+values. ImageMagick has no way to automagically determine the image format
+so we explicitly set one:
</p>
<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert -size 640x480 -depth 8 rgb:image image.png</span></p>
@@ -293,7 +306,7 @@
<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert 'images.gif[0]' image.png</span></p>
<p class="warn">[Unix shells generally interpret brackets so we enclosed the filename in quotes above.
- In a Windows command shell the brackets are not interpreted but using quotes doesn't hurt. However, in most cases the roles of single-quotes and double-quotes are reversed with respect to Unix and Windows, so Windows users should usually try double-quotes where we display single-quotes, and vice versa.]
+In a Windows command shell the brackets are not interpreted but using quotes doesn't hurt. However, in most cases the roles of single-quotes and double-quotes are reversed with respect to Unix and Windows, so Windows users should usually try double-quotes where we display single-quotes, and vice versa.]
</p>
<p>You can read more than one image from a sequence with a frame range. For example, you can extract the first four frames of an image sequence:
@@ -327,7 +340,9 @@
</p>
<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert '*.jpg' -resize 120x120 thumbnail%03d.png</span></p>
- <p>Here <em>all</em> the images are read and subsequently resized. It is faster and less resource intensive to resize each image as they are read:
+ <p>Here <em>all</em> the images are read and subsequently
+resized. It is faster and less resource intensive to resize each image it
+is read:
</p>
<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert '*.jpg[120x120]' thumbnail%03d.png</span></p>
@@ -360,10 +375,17 @@
<p>Then with the following command, ImageMagick reads the images <kbd>image-1.jpg</kbd>, <kbd>image-2.jpg</kbd>, and <kbd>image-3.jpg</kbd>. </p>
- <p>Some ImageMagick command-line options may exceed the capabilities of your command line processor. Windows, for example, limits command lines to 8192 characters. If, for example, you have a draw option with polygon points that exceed the command-line length limit, put the draw option instead in a file and reference the file with the <kbd>@</kbd> (e.g. <kbd>@mypoly.txt</kbd>).</p>
-
<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert @myimages.txt mymovie.gif</span></p>
- <p>Another method of referring to other image files is by an embedding a formatting character in the filename with a scene range. Consider the filename <kbd>image-%d.jpg[1-5]</kbd>. The command</p>
+ <p>Some ImageMagick command-line options may exceed the capabilities of
+your command line processor. Windows, for example, limits command lines
+to 8192 characters. If, for example, you have a draw option with polygon
+points that exceed the command-line length limit, put the draw option instead
+in a file and reference the file with
+the <kbd>@</kbd> (e.g. <kbd>@mypoly.txt</kbd>).</p>
+
+ <p>Another method of referring to other image files is by
+embedding a formatting character in the filename with a scene range. Consider
+the filename <kbd>image-%d.jpg[1-5]</kbd>. The command</p>
<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert image-%d.jpg[1-5]</span></p>
<p>causes ImageMagick to attempt to read images with these filenames:
@@ -384,7 +406,10 @@
<h2><a name="setting"></a>Image Setting</h2>
<div class="doc-section">
-<p>An image setting persists as it appears on the command line and may affect subsequent processing such as reading an image, an image operator, or when writing an image as appropriate. An image setting stays in effect until it is reset or the command line terminates. The image settings include:</p>
+<p>An image setting persists as it appears on the command line and may affect
+subsequent processing such as reading an image, an image operator, or when
+writing an image as appropriate. An image setting stays in effect until it
+is reset or the command line terminates. The image settings include:</p>
<p class="options">
<a href="../www/command-line-options.html#adjoin">‑adjoin</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#affine">‑affine</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#alpha">‑alpha</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#antialias">‑antialias</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#authenticate">‑authenticate</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#background">‑background</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#bias">‑bias</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#black-point-compensation">‑black‑point‑compensation</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#blue-primary">‑blue‑primary</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#bordercolor">‑bordercolor</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#caption">‑caption</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#channel">‑channel</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#comment">‑comment</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#compress">‑compress</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#debug">‑debug</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#define">‑define</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#delay">‑delay</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#density">‑density</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#depth">‑depth</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#direction">‑direction</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#display">‑display</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#dispose">‑dispose</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#dither">‑dither</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#encoding">‑encoding</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#endian">‑endian</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#extract">‑extract</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#family">‑family</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#fill">‑fill</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#filter">‑filter</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#font">‑font</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#format">‑format</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#fuzz">‑fuzz</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#geometry">‑geometry</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#gravity">‑gravity</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#green-primary">‑green‑primary</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#interlace">‑interlace</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#intent">‑intent</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#interpolate">‑interpolate</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#label">‑label</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#limit">‑limit</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#linewidth">‑linewidth</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#log">‑log</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#loop">‑loop</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#mask">‑mask</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#mattecolor">‑mattecolor</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#monitor">‑monitor</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#orient">‑orient</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#page">‑page</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#pointsize">‑pointsize</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#preview">‑preview</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#quality">‑quality</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#quiet">‑quiet</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#red-primary">‑red‑primary</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#region">‑region</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#render">‑render</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#repage">‑repage</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#sampling-factor">‑sampling‑factor</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#scene">‑scene</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#seed">‑seed</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#size">‑size</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#stretch">‑stretch</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#stroke">‑stroke</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#strokewidth">‑strokewidth</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#style">‑style</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#texture">‑texture</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#tile">‑tile</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#transparent-color">‑transparent‑color</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#treedepth">‑treedepth</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#type">‑type</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#undercolor">‑undercolor</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#units">‑units</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#verbose">‑verbose</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#virtual-pixel">‑virtual‑pixel</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#weight">‑weight</a> </p>
@@ -398,7 +423,14 @@
<h2><a name="operator"></a>Image Operator</h2>
<div class="doc-section">
-<p>An image operator differs from a setting in that it affects the image immediately as it appears on the command line. An operator is any <a href="../www/command-line-options.html">command line option</a> not listed as a <a href="#setting">image setting</a> or <a href="#sequence">image sequence operator</a>. Unlike an image setting, which persists until the command line terminates, an operator is applied to an image and forgotten. The image operators include:</p>
+<p>An image operator differs from a setting in that it affects the image
+immediately as it appears on the command line. An operator is
+any <a href="/script../www/command-line-options.html">command line option</a>
+not listed as a <a href="#setting">image setting</a>
+or <a href="#sequence">image sequence operator</a>. Unlike an
+image setting, which persists until the command line terminates,
+an operator is applied to an image and forgotten. The image operators
+include:</p>
<p class="options">
<a href="../www/command-line-options.html#annotate">‑annotate</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#black-threshold">‑black‑threshold</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#blur">‑blur</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#border">‑border</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#charcoal">‑charcoal</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#chop">‑chop</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#clip">‑clip</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#clip-path">‑clip‑path</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#clip-mask">‑clip‑mask</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#colors">‑colors</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#colorize">‑colorize</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#colorspace">‑colorspace</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#compose">‑compose</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#contrast">‑contrast</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#convolve">‑convolve</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#crop">‑crop</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#cycle">‑cycle</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#despeckle">‑despeckle</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#draw">‑draw</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#edge">‑edge</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#emboss">‑emboss</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#enhance">‑enhance</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#equalize">‑equalize</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#evaluate">‑evaluate</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#extent">‑extent</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#flip">‑flip</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#flop">‑flop</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#floodfill">‑floodfill</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#frame">‑frame</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#gamma">‑gamma</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#gaussian-blur">‑gaussian‑blur</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#implode">‑implode</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#lat">‑lat</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#level">‑level</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#map">‑map</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#median">‑median</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#modulate">‑modulate</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#monochrome">‑monochrome</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#negate">‑negate</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#noise">‑noise</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#normalize">‑normalize</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#opaque">‑opaque</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#ordered-dither">‑ordered‑dither</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#paint">‑paint</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#posterize">‑posterize</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#raise">‑raise</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#profile">‑profile</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#radial-blur">‑radial‑blur</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#raise">‑raise</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#random-threshold">‑random‑threshold</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#resample">‑resample</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#resize">‑resize</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#roll">‑roll</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#rotate">‑rotate</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#sample">‑sample</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#scale">‑scale</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#sepia-tone">‑sepia‑tone</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#segment">‑segment</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#shade">‑shade</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#shadow">‑shadow</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#sharpen">‑sharpen</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#shave">‑shave</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#shear">‑shear</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#sigmoidal-contrast">‑sigmoidal‑contrast</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#solarize">‑solarize</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#splice">‑splice</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#spread">‑spread</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#strip">‑strip</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#swirl">‑swirl</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#threshold">‑threshold</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#transparent">‑transparent</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#thumbnail">‑thumbnail</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#tint">‑tint</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#transform">‑transform</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#trim">‑trim</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#unsharp">‑unsharp</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#version">‑version</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#wave">‑wave</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#white-point">‑white‑point</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#white-threshold">‑white‑threshold</a> </p>
@@ -410,7 +442,9 @@
<h2><a name="sequence"></a>Image Sequence Operator</h2>
<div class="doc-section">
-<p>An image sequence operator differs from a setting in that it affects an image sequence immediately as it appears on the command line. Choose from these image sequence operators:</p>
+<p>An image sequence operator differs from a setting in that it affects an
+image sequence immediately as it appears on the command line. Choose from
+these image sequence operators:</p>
<p class="options">
<a href="../www/command-line-options.html#append">‑append</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#affinity">‑affinity</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#average">‑average</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#clut">‑clut</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#coalesce">‑coalesce</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#combine">‑combine</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#composite">‑composite</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#crop">‑crop</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#debug">‑debug</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#deconstruct">‑deconstruct</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#delete">‑delete</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#evaluate-seqence">‑evaluate‑seqence</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#fft">‑fft</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#flatten">‑flatten</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#fx">‑fx</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#hald-clut">‑hald‑clut</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#ift">‑ift</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#identify">‑identify</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#insert">‑insert</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#layers">‑layers</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#limit">‑limit</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#map">‑map</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#maximum">‑maximum</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#minimum">‑minimum</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#morph">‑morph</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#mosaic">‑mosaic</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#optimize">‑optimize</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#print">‑print</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#process">‑process</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#quiet">‑quiet</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#separate">‑separate</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#swap">‑swap</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#write">‑write</a> </p>
@@ -419,9 +453,18 @@
<h2><a name="geometry"></a>Image Geometry</h2>
<div class="doc-section">
-<p>Many command-line options take a <em class="arg">geometry</em> argument to specify such things as the desired width and height of an image and other dimensional quantities. Because users want so many variations on the resulting dimensions, sizes, and positions of images (and because ImageMagick wants to provide them), the <em class="arg">geometry</em> argument can take many forms. We describe many of these in this section. </p>
+<p>Many command-line options take a <em class="arg">geometry</em> argument
+to specify such things as the desired width and height of an image and other
+dimensional quantities. Because users want so many variations on the resulting
+dimensions, sizes, and positions of images (and because ImageMagick wants to
+provide them), the <em class="arg">geometry</em> argument can take many
+forms. We describe many of these in this section. </p>
-<p>The image options and settings that take some form of a <em class="arg">geometry</em> argument include the following. Keep in mind that some of these parse their arguments in slightly different ways. See the documentation for the individual option or setting for more specifics.</p>
+<p>The image options and settings that take some form of
+a <em class="arg">geometry</em> argument include the following.
+Keep in mind that some of these parse their arguments in slightly
+different ways. See the documentation for the individual option or
+setting for more specifics.</p>
<p class="options" style="text-align:justify">
<a href="../www/command-line-options.html#adaptive-resize">‑adaptive‑resize</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#border">‑border</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#borderwidth">‑borderwidth</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#chop">‑chop</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#crop">‑crop</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#density">‑density</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#extent">‑extent</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#extract">‑extract</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#frame">‑frame</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#geometry">‑geometry</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#iconGeometry">‑iconGeometry</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#liquid-rescale">‑liquid‑rescale</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#page">‑page</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#region">‑region</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#repage">‑repage</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#resize">‑resize</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#sample">‑sample</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#scale">‑scale</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#shave">‑shave</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#splice">‑splice</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#thumbnail">‑thumbnail</a> <span class='bull'> • </span> <a href="../www/command-line-options.html#window">‑window</a> </p>
@@ -534,7 +577,7 @@
<p>If only one dimension is given it is taken to be the width. When only the width is specified, as in the first example above, the width is accepted as given and the height is chosen to maintain the aspect ratio of the input image. Similarly, if only the height is specified, as in the second example above, the height is accepted and the width is chosen to maintain the aspect ratio.</p>
- <p>Use <kbd>></kbd> to change the dimensions of the image <em>only</em> if both the original width or height is exeeded by one of the <em class="arg">geometry</em> specifications. Use <kbd><</kbd> to resize the image <em>only</em> if both of the original dimensions are more than the <em class="arg">geometry</em> specifications. In either case, if a change is made, the result is as if the <kbd>></kbd> or <kbd>></kbd> operator was not present. So, in the third example above, we specified <kbd>100x200></kbd> and the original image size is 640x480, so the image size is reduced as if we had specified <kbd>100x200</kbd>. However, in the fourth example above, there will be no change to its size.</p>
+ <p>Use <kbd>></kbd> to change the dimensions of the image <em>only</em> if the original width or height is exeeded by one of the <em class="arg">geometry</em> specifications. Use <kbd><</kbd> to resize the image <em>only</em> if the original dimensions are more than the <em class="arg">geometry</em> specifications. In either case, if a change is made, the result is as if the <kbd>></kbd> or <kbd>></kbd> operator was not present. So, in the third example above, we specified <kbd>100x200></kbd> and the original image size is 640x480, so the image size is reduced as if we had specified <kbd>100x200</kbd>. However, in the fourth example above, there will be no change to its size.</p>
<p>Finally, use <kbd>@</kbd> to specify the maximum area in pixels of an image, again while attempting to preserve aspect ratio. (Pixels take only integer values, so some approximation is always at work.) In the following example, an area of 10000 pixels is requested. The resulting file has dimensions 115x86, which has 9890 pixels. </p>