summaryrefslogtreecommitdiff
path: root/www/gm.html
diff options
context:
space:
mode:
Diffstat (limited to 'www/gm.html')
-rw-r--r--www/gm.html313
1 files changed, 192 insertions, 121 deletions
diff --git a/www/gm.html b/www/gm.html
index 4b263e1..76b4962 100644
--- a/www/gm.html
+++ b/www/gm.html
@@ -394,7 +394,7 @@ can tell if <strong>gm</strong> was compiled in 16-bit mode by typing "gm
version" without any options, and looking for "Q:16" in the first line
of output.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -473,7 +473,7 @@ prepend an at sign <tt>@</tt> to a filename to read a list of image
filenames from that file. This is convenient in the event you have too
many image filenames to fit on the command line.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -585,7 +585,7 @@ option appears after all of the input images, all images are appended.</font></t
ALT=">" BORDER=0 height=14
width=15><b><font face="Helvetica, Arial"
><font color="#00B04F"><font size="+1">
- <a name="details"></a> <i>-asc-cdl &lt;spec&gt;</i>
+ <a name="details-asc-cdl"></a>-asc-cdl <i>&lt;spec&gt;</i>
</font></font></font></b></td></tr></table>
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply ASC CDL color transform</td></tr></table>
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
@@ -1573,6 +1573,15 @@ are not.
<dd>If the pcl:fit-to-page flag is defined, then the printer is
requested to scale the image to fit the page size (width and/or
height).</dd>
+<dt>png:chunk-malloc-max=&lt;value&gt;</dt>
+<dd>png:chunk-malloc-max specifies the maximum chunk size that libpng
+will be allowed to read. Libpng's default is normally 8,000,000
+bytes. Very rarely, a valid PNG file may be encountered where the
+error is reported "chunk data is too large". In this case, the limit
+may be increased using this option. Take care when increasing this
+limit since an excessively large limit could allow untrusted files to
+use excessive memory.
+</dd>
<dt>mng:maximum-loops=&lt;value&gt;</dt>
<dd>mng:maximum-loops specifies the maximum number of loops allowed to
be specified by a MNG LOOP chunk. Without an imposed limit, a MNG file
@@ -2148,7 +2157,7 @@ For example,
</font></td></tr></table>
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre>
-draw 'text 100,100 "%m:%f %wx%h"'
-</pre></font></td></tr></table>
+</font></td></tr></table>
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
annotates the image with <tt>MIFF:bird.miff 512x480</tt> for an image titled
<tt>bird.miff</tt>
@@ -3277,28 +3286,41 @@ width=15><b><font face="Helvetica, Arial"
><font color="#00B04F"><font size="+1">
<a name="details-limit"></a>-limit <i>&lt;type&gt; &lt;value&gt;</i>
</font></font></font></b></td></tr></table>
-<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height, Read, or Threads resource limit</td></tr></table>
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
By default, resource limits are estimated based on the available
-resources of the system. The resource limits are <strong>Disk</strong>, maximum
-total disk space consumed; <strong>File</strong>, maximum number of file
-descriptors allowed to be open at once; <strong>Map</strong>, maximum total
-number of file bytes which may be memory mapped; <strong>Memory</strong>,
-maximum total number of bytes of heap memory used for image storage;
-<strong>Pixels</strong>, maximum absolute image size (per image); <strong>Width</strong>,
-maximum image pixels width; <strong>Height</strong>, maximum image pixels
-height; and <strong>Threads</strong>, the maximum number of worker threads to
-use per OpenMP thread team.</font></td></tr></table>
-<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
-These resource limits are used to decide if (for a given image) the
-decoded image ("pixel cache") should be stored in heap memory (RAM),
-in a memory-mapped disk file, or in a disk file accessed via
-read/write I/O. The number of total pixels in one image, and/or the
-width/height, may also be limited in order to force the reading, or
-creation of images larger than the limit (in pixels) to intentionally
-fail. The disk limit establishes an overall limit since using the disk
-is the means of last resort. When the disk limit has been reached, no
-more images may be read.</font></td></tr></table>
+resources and capabilities of the system. The resource limits are
+<strong>Disk</strong>, maximum total disk space consumed; <strong>File</strong>, maximum
+number of file descriptors allowed to be open at once; <strong>Map</strong>,
+maximum total number of file bytes which may be memory mapped;
+<strong>Memory</strong>, maximum total number of bytes of heap memory used for
+image storage; <strong>Pixels</strong>, maximum absolute image size (per image);
+<strong>Width</strong>, maximum image pixels width; <strong>Height</strong>, maximum image
+pixels height; <strong>Read</strong>, maximum number of uncompressed bytes to
+read; and <strong>Threads</strong>, the maximum number of worker threads to use
+per OpenMP thread team.</font></td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
+The <strong>Disk</strong> and <strong>Map</strong> resource limits are used to decide if
+(for a given image) the decoded image ("pixel cache") should be stored
+in heap memory (RAM), in a memory-mapped disk file, or in a disk file
+accessed via read/write I/O.</font></td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
+The number of total pixels in one image (<strong>Pixels</strong>), and/or the
+width/height (<strong>Width</strong>/<strong>Height</strong>), may be limited in order to
+force the reading, or creation of images larger than the limit (in
+pixels) to intentionally fail. The disk limit (<strong>Disk</strong>)
+establishes an overall limit since using the disk is the means of last
+resort. When the disk limit has been reached, no more images may be
+read.</font></td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
+The amount of uncompressed data read when reading one image may be
+limited by the <strong>Read</strong> limit. Reading the image fails when the
+limit is hit. This option is useful if the data is read from a stream
+(pipe) or from a compressed file such as a gzipped file. Some files
+are very compressable and so a small compressed file can decompress to
+a huge amount of data. This option also defends against files which
+produce seemingly endless loops while decoding by seeking backwards in
+the file.</font></td></tr></table>
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
The value argument is an absolute value, but may have standard binary
suffix characters applied ('K', 'M', 'G', 'T', 'P', 'E') to apply a
@@ -3312,10 +3334,11 @@ Resource limits may also be set using environment variables. The
environment variables <strong>MAGICK_LIMIT_DISK</strong>,
<strong>MAGICK_LIMIT_FILES</strong>, <strong>MAGICK_LIMIT_MAP</strong>,
<strong>MAGICK_LIMIT_MEMORY</strong>, <strong>MAGICK_LIMIT_PIXELS</strong>,
-<strong>MAGICK_LIMIT_WIDTH</strong>, <strong>MAGICK_LIMIT_HEIGHT</strong>,and
-<strong>OMP_NUM_THREADS</strong> may be used to set the limits for disk space,
-open files, memory mapped size, heap memory, per-image pixels, image
-width, image height, and threads respectively.</font></td></tr></table>
+<strong>MAGICK_LIMIT_WIDTH</strong>, <strong>MAGICK_LIMIT_HEIGHT</strong>.
+<strong>MAGICK_LIMIT_READ</strong>, and <strong>OMP_NUM_THREADS</strong> may be used to
+set the limits for disk space, open files, memory mapped size, heap
+memory, per-image pixels, image width, image height, and threads
+respectively.</font></td></tr></table>
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
Use the option <tt>-list resource</tt> list the current limits.</font></td></tr></table>
<table BORDER=0 WIDTH="94%">
@@ -4367,7 +4390,7 @@ width=15><b><font face="Helvetica, Arial"
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>process a sequence of images using a process module</td></tr></table>
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
The command argument has the form <strong>module=arg1,arg2,arg3,...,argN</strong>
-where <strong>module</strong> is the name of the module to invoke (e.g. "analyze")
+where <strong>module</strong> is the name of the module to invoke (e.g. "Analyze")
and arg1,arg2,arg3,...,argN are an arbitrary number of arguments to
pass to the process module.</font></td></tr></table><table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
The sequence of images
@@ -4375,6 +4398,13 @@ is terminated by the appearance of any option.</font></td></tr></table>
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
If the <strong>-process</strong>
option appears after all of the input images, all images are processed.</font></td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
+For example:</font></td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre>
+ gm convert logo: -process Analyze= \
+ -format "%[BrightnessMean],%[BrightnessStddev]" info:-
+ 51952,23294
+<pre></font></td></tr></table>
<table BORDER=0 WIDTH="94%">
<tr>
<td width="3%"><br></td>
@@ -5892,7 +5922,7 @@ See
"X Resources", below,
for details.</font></td></tr></table>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -6212,6 +6242,23 @@ document or an animation).</td></tr></table>
ALT=">" BORDER=0 height=14
width=15><b><font face="Helvetica, Arial"
><font color="#00B04F"><font size="+1">
+ MAGICK_LIMIT_READ
+</font></font></font></b></td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum number of uncompressed bytes which may be read while
+decoding an image. Each read by the software from the input file is
+counted against the total, even if it has been read before. Decoding
+fails when the limit is reached. This limit helps defend against
+highly compressed files (e.g. via gzip), or files which use complex
+looping structures, or when data is being read from a stream
+(pipe).</td></tr></table>
+<table BORDER=0 WIDTH="94%">
+<tr>
+<td width="3%"><br></td>
+<td ALIGN=LEFT BGCOLOR="#FFFFFF">
+<img SRC="images/right_triangle_option.png"
+ALT=">" BORDER=0 height=14
+width=15><b><font face="Helvetica, Arial"
+><font color="#00B04F"><font size="+1">
MAGICK_LIMIT_WIDTH
</font></font></font></b></td></tr></table>
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum pixel width of an image read, or created.</td></tr></table>
@@ -6281,7 +6328,7 @@ use to the number of processor cores available while others default to
just one thread. See the OpenMP specification for other standard
adjustments and your compiler's manual for vendor-specific settings.</td></tr></table>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -6393,7 +6440,7 @@ width=15><b><font face="Helvetica, Arial"
&lt;/typemap&gt;
</pre></font></td></tr></table>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<br>&nbsp;<br>
@@ -6432,7 +6479,7 @@ You can define a Standard Colormap with <em>xstdcmap</em>. See <strong>xstdcmap(
for details. This method is recommended for colormapped X server because
it eliminates the need to compute a global colormap.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -6465,7 +6512,7 @@ use:
gm animate +borderwidth -backdrop cockatoo.*
</pre>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -6778,7 +6825,7 @@ width=15><b><font face="Helvetica, Arial"
><font color="#00B04F"><font size="+1">
<a href="GraphicsMagick.html#details-limit">-limit</a> <i>&lt;type&gt; &lt;value&gt;</i>
</font></font></font></b></td></tr></table>
-<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height, Read, or Threads resource limit</td></tr></table>
<table BORDER=0 WIDTH="94%">
<tr>
<td width="3%"><br></td>
@@ -7068,7 +7115,7 @@ format is <em>MIFF</em> (refer to <strong>miff(5)</strong> and the
is specified in the image. Otherwise the images will display in the order
they appear on the command line.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -7085,7 +7132,7 @@ color="#00B04F"><font size="+1">
Press any button to map or unmap the Command widget. See the next section
for more information about the Command widget.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -7131,7 +7178,7 @@ desired sub-menu item, release the button and the command is executed.
Move the pointer away from the sub-menu if you decide not to execute a
particular command.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -7166,7 +7213,7 @@ and the total number of unique colors in the image.</dd>
<dd>Press to discard all images and exit program.</dd>
</dl>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -7253,7 +7300,7 @@ information is sometimes used by a window manager to provide some sort
of header identifying the window. The default is the image file name.</dd>
</dl>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<br>&nbsp;<br>
@@ -7323,7 +7370,7 @@ as the script to execute:
gm batch -echo on -feedback on script.txt
</pre>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -7549,7 +7596,7 @@ worry about thermal management. The <strong>powertop</strong> utility available
under Linux and Solaris provides a way to observe CPU core clock rates
while a benchmark is running.</em>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -7679,7 +7726,7 @@ To create an annotated difference image use:
-file diff.miff original.miff compare.miff
</pre>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -7719,6 +7766,17 @@ width=15><b><font face="Helvetica, Arial"
ALT=">" BORDER=0 height=14
width=15><b><font face="Helvetica, Arial"
><font color="#00B04F"><font size="+1">
+ <a href="GraphicsMagick.html#details-auto-orient">-auto-orient</a>
+</font></font></font></b></td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>orient (rotate) image so it is upright</td></tr></table>
+<table BORDER=0 WIDTH="94%">
+<tr>
+<td width="3%"><br></td>
+<td ALIGN=LEFT BGCOLOR="#FFFFFF">
+<img SRC="images/right_triangle_option.png"
+ALT=">" BORDER=0 height=14
+width=15><b><font face="Helvetica, Arial"
+><font color="#00B04F"><font size="+1">
<a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i>&lt;value&gt;</i>
</font></font></font></b></td></tr></table>
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table>
@@ -7730,6 +7788,17 @@ width=15><b><font face="Helvetica, Arial"
ALT=">" BORDER=0 height=14
width=15><b><font face="Helvetica, Arial"
><font color="#00B04F"><font size="+1">
+ <a href="GraphicsMagick.html#details-compress">-compress</a> <i>&lt;type&gt;</i>
+</font></font></font></b></td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image compression</td></tr></table>
+<table BORDER=0 WIDTH="94%">
+<tr>
+<td width="3%"><br></td>
+<td ALIGN=LEFT BGCOLOR="#FFFFFF">
+<img SRC="images/right_triangle_option.png"
+ALT=">" BORDER=0 height=14
+width=15><b><font face="Helvetica, Arial"
+><font color="#00B04F"><font size="+1">
-debug <i>&lt;events&gt;</i>
</font></font></font></b></td></tr></table>
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table>
@@ -7853,7 +7922,7 @@ width=15><b><font face="Helvetica, Arial"
><font color="#00B04F"><font size="+1">
<a href="GraphicsMagick.html#details-limit">-limit</a> <i>&lt;type&gt; &lt;value&gt;</i>
</font></font></font></b></td></tr></table>
-<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height, Read, or Threads resource limit</td></tr></table>
<table BORDER=0 WIDTH="94%">
<tr>
<td width="3%"><br></td>
@@ -8039,7 +8108,7 @@ try
gm composite.png
</pre>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -8367,7 +8436,7 @@ width=15><b><font face="Helvetica, Arial"
><font color="#00B04F"><font size="+1">
<a href="GraphicsMagick.html#details-limit">-limit</a> <i>&lt;type&gt; &lt;value&gt;</i>
</font></font></font></b></td></tr></table>
-<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height, Read, or Threads resource limit</td></tr></table>
<table BORDER=0 WIDTH="94%">
<tr>
<td width="3%"><br></td>
@@ -8786,7 +8855,7 @@ invoked with
All operations will closely follow the key/value pairs defined in
PerlMagick, unless otherwise noted.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -8902,7 +8971,7 @@ width=15><b><font face="Helvetica, Arial"
</font></font></font></b></td></tr></table>
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -9153,7 +9222,7 @@ process. <strong>Convert</strong> recognizes the image formats listed in
<em>GraphicsMagick(1)</em>.
<br>&nbsp;<br>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -9247,7 +9316,7 @@ To create a MNG animation from a DNA molecule sequence, use:
gm convert -delay 20 dna.* dna.mng
</pre>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -9322,7 +9391,7 @@ width=15><b><font face="Helvetica, Arial"
ALT=">" BORDER=0 height=14
width=15><b><font face="Helvetica, Arial"
><font color="#00B04F"><font size="+1">
- <a href="GraphicsMagick.html#details"></a> <i>-asc-cdl &lt;spec&gt;</i>
+ <a href="GraphicsMagick.html#details-asc-cdl">-asc-cdl</a> <i>&lt;spec&gt;</i>
</font></font></font></b></td></tr></table>
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply ASC CDL color transform</td></tr></table>
<table BORDER=0 WIDTH="94%">
@@ -10050,7 +10119,7 @@ width=15><b><font face="Helvetica, Arial"
><font color="#00B04F"><font size="+1">
<a href="GraphicsMagick.html#details-limit">-limit</a> <i>&lt;type&gt; &lt;value&gt;</i>
</font></font></font></b></td></tr></table>
-<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height, Read, or Threads resource limit</td></tr></table>
<table BORDER=0 WIDTH="94%">
<tr>
<td width="3%"><br></td>
@@ -11045,7 +11114,7 @@ With <strong>display</strong>, you can perform these functions on an image:
<dd><img SRC="images/ball.png" ALT="*">display images specified by a World Wide Web (WWW) uniform resource locator (URL)
</dl>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -11098,7 +11167,7 @@ To display histogram of an image, use:
gm gm convert file.jpg HISTOGRAM:- | gm display -
</pre>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -11568,7 +11637,7 @@ width=15><b><font face="Helvetica, Arial"
><font color="#00B04F"><font size="+1">
<a href="GraphicsMagick.html#details-limit">-limit</a> <i>&lt;type&gt; &lt;value&gt;</i>
</font></font></font></b></td></tr></table>
-<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height, Read, or Threads resource limit</td></tr></table>
<table BORDER=0 WIDTH="94%">
<tr>
<td width="3%"><br></td>
@@ -12015,7 +12084,7 @@ For a more detailed description of each option, see
Options, above.
<br>&nbsp;<br>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -12093,7 +12162,7 @@ all the image tiles with their respective images. See
and
<a href="miff.html">miff</a> for more details.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -12248,7 +12317,7 @@ desired sub-menu item, release the button and the command is executed.
Move the pointer away from the sub-menu if you decide not to execute a
particular command.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -12393,7 +12462,7 @@ button 2.
Press ALT and one of the arrow keys to trim off one pixel from any side
of the image.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -12767,7 +12836,7 @@ For example, to set the Pan window geometry to 256x256, use:
gm display.pan.geometry: 256x256
</pre>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -12799,7 +12868,7 @@ with <tt>.jpg</tt>.
To select your image from the X server screen instead of from a file, Choose
<strong>Grab</strong> of the <strong>Open</strong> widget.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -12831,7 +12900,7 @@ by the thumbnail is displayed at its full size. Choose <strong>Next</strong> fro
the <strong>File</strong> sub-menu of the Command widget to return to the Visual
Image Directory.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -12880,7 +12949,7 @@ You can make adjustments by moving the pointer to one of the cut rectangle
corners, pressing a button, and dragging. Finally, press Cut to commit
your copy region. To exit without cutting the image, press Dismiss.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -12922,7 +12991,7 @@ You can make adjustments by moving the pointer to one of the copy rectangle
corners, pressing a button, and dragging. Finally, press Copy to commit
your copy region. To exit without copying the image, press Dismiss.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -13179,7 +13248,7 @@ To force a
<em>PseudoClass</em> image to remain <em>PseudoClass</em>,
use <strong>-colors</strong>.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -13220,7 +13289,7 @@ You can make adjustments by moving the pointer to one of the cropping rectangle
corners, pressing a button, and dragging. Finally, press Crop to commit
your cropping region. To exit without cropping the image, press Dismiss.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -13266,7 +13335,7 @@ by which direction you choose from the Command widget.
To cancel the image chopping, move the pointer back to the starting point
of the line and release the button.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -13330,10 +13399,10 @@ sub-menu of the Command widget.
To cancel the image rotation, move the pointer back to the starting point
of the line and release the button.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -13502,7 +13571,7 @@ to <em>DirectClass</em> (see miff(5)). To force a <em>PseudoClass</em> image
to remain
<em>PseudoClass</em>, use <strong>-colors</strong>.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -13790,7 +13859,7 @@ final image, any PseudoClass image is promoted to <em>DirectClass</em> (see
To force a <em>PseudoClass</em> image to remain <em>PseudoClass</em>,
use <strong>-colors</strong>.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -13934,7 +14003,7 @@ to <em>DirectClass</em>
To force a <em>PseudoClass</em> image to remain
<em>PseudoClass</em>, use <strong>-colors</strong>.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -14058,7 +14127,7 @@ unless you immediately save your image to a file (refer to Write). Correct
matte editing behavior may require a <em>TrueColor</em> or <em>DirectColor</em>
visual or a <em>Standard Colormap</em>.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -14201,7 +14270,7 @@ is updated when you press and release the button without moving the pointer.
To cancel image drawing, move the pointer back to the starting point of
the line and release the button.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -14364,7 +14433,7 @@ more than one image processing technique to apply to an area. Alternatively,
you can move the region of interest before applying another image processing
technique. To exit, press Dismiss.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -14392,7 +14461,7 @@ within the image window.
The panning icon is withdrawn if the image becomes smaller than the dimensions
of the X server screen.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -14458,7 +14527,7 @@ image. Panning is much faster with Pixmaps than with a XImage. Pixmaps
are considered a precious resource, use them with discretion.</dd>
</dl>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<br>&nbsp;<br>
@@ -14510,7 +14579,7 @@ For some formats, additional format-specific information about the file
will be written if the <tt>-debug coder</tt> or <tt>-debug all</tt> option
is used.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -14630,7 +14699,7 @@ width=15><b><font face="Helvetica, Arial"
><font color="#00B04F"><font size="+1">
<a href="GraphicsMagick.html#details-limit">-limit</a> <i>&lt;type&gt; &lt;value&gt;</i>
</font></font></font></b></td></tr></table>
-<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height, Read, or Threads resource limit</td></tr></table>
<table BORDER=0 WIDTH="94%">
<tr>
<td width="3%"><br></td>
@@ -14702,7 +14771,7 @@ For a more detailed description of each option, see
Options, above.
<br>&nbsp;<br>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<br>&nbsp;<br>
@@ -14731,7 +14800,7 @@ moves. To save the portion of the screen defined by the rectangle, just
release the button. The keyboard bell is rung once at the beginning of
the screen capture and twice when it completes.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -14771,7 +14840,7 @@ without using the mouse, use:
corner.png
</pre>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -15037,7 +15106,7 @@ width=15><b><font face="Helvetica, Arial"
><font color="#00B04F"><font size="+1">
<a href="GraphicsMagick.html#details-limit">-limit</a> <i>&lt;type&gt; &lt;value&gt;</i>
</font></font></font></b></td></tr></table>
-<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height, Read, or Threads resource limit</td></tr></table>
<table BORDER=0 WIDTH="94%">
<tr>
<td width="3%"><br></td>
@@ -15318,7 +15387,7 @@ filename.
The graphics formats supported by <strong>mogrify</strong> are listed in
<em>GraphicsMagick(1)</em>.
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -15357,7 +15426,7 @@ pixels in height, use:
gm mogrify -resize 640x480! cockatoo.miff
</pre>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -15408,7 +15477,7 @@ width=15><b><font face="Helvetica, Arial"
ALT=">" BORDER=0 height=14
width=15><b><font face="Helvetica, Arial"
><font color="#00B04F"><font size="+1">
- <a href="GraphicsMagick.html#details"></a> <i>-asc-cdl &lt;spec&gt;</i>
+ <a href="GraphicsMagick.html#details-asc-cdl">-asc-cdl</a> <i>&lt;spec&gt;</i>
</font></font></font></b></td></tr></table>
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply ASC CDL color transform</td></tr></table>
<table BORDER=0 WIDTH="94%">
@@ -16059,7 +16128,7 @@ width=15><b><font face="Helvetica, Arial"
><font color="#00B04F"><font size="+1">
<a href="GraphicsMagick.html#details-limit">-limit</a> <i>&lt;type&gt; &lt;value&gt;</i>
</font></font></font></b></td></tr></table>
-<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height, Read, or Threads resource limit</td></tr></table>
<table BORDER=0 WIDTH="94%">
<tr>
<td width="3%"><br></td>
@@ -16923,7 +16992,7 @@ For a more detailed description of each option, see
Options, above.
<br>&nbsp;<br>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<br>&nbsp;<br>
@@ -16998,7 +17067,7 @@ behaves differently than other images. You can think of the composite as
a visual image directory. Choose a particular tile of the composite and
press a button to display it. See <strong>display(1)</strong> and <strong>miff(5)</strong>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -17046,7 +17115,7 @@ no label, no shadowing, no surrounding tile frame), use:
-geometry 50x50+0+0 *.png joined.png
</pre>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -17480,7 +17549,7 @@ width=15><b><font face="Helvetica, Arial"
><font color="#00B04F"><font size="+1">
<a href="GraphicsMagick.html#details-limit">-limit</a> <i>&lt;type&gt; &lt;value&gt;</i>
</font></font></font></b></td></tr></table>
-<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table>
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height, Read, or Threads resource limit</td></tr></table>
<table BORDER=0 WIDTH="94%">
<tr>
<td width="3%"><br></td>
@@ -17882,7 +17951,7 @@ For a more detailed description of each option, see
Options, above.
<br>&nbsp;<br>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -18054,7 +18123,7 @@ convert input.ppm -gaussian 0x2 output.ppm 22.60s user 0.00s system 2354% cpu
<li><strong>total</strong> - the total elapsed time consumed.
</ul>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">
@@ -18110,35 +18179,37 @@ color="#00B04F"><font size="+1">
<table width="94%" border="0" cellspacing="0" cellpadding="8">
<tr><td width="3%"><br></td><td>
<p>To display the version information:
-<pre>
- GraphicsMagick 1.3.27a 2017-12-11 Q16 http://www.GraphicsMagick.org/
- Copyright (C) 2002-2020 GraphicsMagick Group.
+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre>
+ GraphicsMagick 1.3.37 2021-12-12 Q16 http://www.GraphicsMagick.org/
+ Copyright (C) 2002-2021 GraphicsMagick Group.
Additional copyrights and licenses apply to this software.
See http://www.GraphicsMagick.org/www/Copyright.html for details.
Feature Support:
- Native Thread Safe yes
- Large Files (&gt; 32 bit) yes
- Large Memory (&gt; 32 bit) yes
- BZIP yes
- DPS no
- FlashPix no
- FreeType yes
- Ghostscript (Library) no
- JBIG yes
- JPEG-2000 yes
- JPEG yes
- Little CMS yes
- Loadable Modules no
- OpenMP yes (201307)
- PNG yes
- TIFF yes
- TRIO no
- UMEM no
- WebP yes
- WMF yes
- X11 yes
- XML yes
- ZLIB yes
+ Native Thread Safe yes
+ Large Files (&gt; 32 bit) yes
+ Large Memory (&gt; 32 bit) yes
+ BZIP yes
+ DPS no
+ FlashPix no
+ FreeType yes
+ Ghostscript (Library) no
+ JBIG yes
+ JPEG-2000 yes
+ JPEG yes
+ Little CMS yes
+ Loadable Modules no
+ Solaris mtmalloc no
+ Google perftools tcmalloc no
+ OpenMP yes (201511 "4.5")
+ PNG yes
+ TIFF yes
+ TRIO no
+ Solaris umem no
+ WebP yes
+ WMF yes
+ X11 yes
+ XML yes
+ ZLIB yes
Host type: x86_64-unknown-linux-gnu
Configured using the command:
./configure ...
@@ -18150,9 +18221,9 @@ color="#00B04F"><font size="+1">
CXXFLAGS = ...
LDFLAGS = ...
LIBS = ...
-</pre>
+</pre></font></td></tr></table>
</td></tr></table>
-<p>
+ <p>
<i><a href="#top">Back to Contents</a></i>
&nbsp;</p>
<table BORDER=0 WIDTH="100%">