• R/O
  • SSH

GM: Commit

Main GraphicsMagick source repository


Commit MetaInfo

Revision5ad72c2bb8ff11e2f4fe7ab132bb3b613e7a1cd8 (tree)
Time2022-01-01 06:20:41
AuthorBob Friesenhahn <bfriesen@Grap...>
CommiterBob Friesenhahn

Log Message

Documentation generator improvements.

Change Summary

Incremental Difference

diff -r 764d46677eca -r 5ad72c2bb8ff ChangeLog
--- a/ChangeLog Fri Dec 31 11:08:22 2021 -0600
+++ b/ChangeLog Fri Dec 31 15:20:41 2021 -0600
@@ -1,10 +1,14 @@
11 2021-12-31 Bob Friesenhahn <bfriesen@simple.dallas.tx.us>
22
3+ * doc/{gmdoc2html, gmdocselect, imdoc2man, imdocselect}: Fixes to
4+ work better with both GNU sed and Solaris/Illumos sed.
5+
36 * doc/GNUmakefile: Use GNU make rules to produce the full imdoc
47 list for man, html, and tex, rather than relying on a shell
58 wildcard expression, since the order produced by the shell
69 wildcard expression is indeterminate.
710
11+
812 2021-12-30 Bob Friesenhahn <bfriesen@simple.dallas.tx.us>
913
1014 * www/index.rst: Document that
diff -r 764d46677eca -r 5ad72c2bb8ff VisualMagick/installer/inc/version.isx
--- a/VisualMagick/installer/inc/version.isx Fri Dec 31 11:08:22 2021 -0600
+++ b/VisualMagick/installer/inc/version.isx Fri Dec 31 15:20:41 2021 -0600
@@ -10,5 +10,5 @@
1010
1111 #define public MagickPackageName "GraphicsMagick"
1212 #define public MagickPackageVersion "1.4"
13-#define public MagickPackageVersionAddendum ".020211230"
14-#define public MagickPackageReleaseDate "snapshot-20211230"
13+#define public MagickPackageVersionAddendum ".020211231"
14+#define public MagickPackageReleaseDate "snapshot-20211231"
diff -r 764d46677eca -r 5ad72c2bb8ff doc/GNUmakefile
--- a/doc/GNUmakefile Fri Dec 31 11:08:22 2021 -0600
+++ b/doc/GNUmakefile Fri Dec 31 15:20:41 2021 -0600
@@ -42,7 +42,7 @@
4242 DOCINCLUDE = ./imdocinclude
4343
4444 # You might need to change this to /usr/bin/sed
45-SED = /bin/sed
45+SED ?= /bin/sed
4646 export SED
4747
4848 HTML_TARGETS = \
@@ -82,19 +82,16 @@
8282 if test -d expanded; then rmdir expanded; fi
8383
8484 gm.1: targets-man $(GMSUBDIR)/man.imdoc $(DOC2MAN)
85- -rm -f $@ $@.tmp
86- $(DOC2MAN) gm $(GMSUBDIR)/man.imdoc > $@.tmp && \
87- mv $@.tmp $@
85+ @-rm -f $@ $@.tmp
86+ $(DOC2MAN) gm $(GMSUBDIR)/man.imdoc > $@.tmp && mv $@.tmp $@
8887
8988 gm.html: targets-html $(GMSUBDIR)/html.imdoc $(DOC2HTML)
90- -rm -f $@ $@.tmp
91- $(DOC2HTML) gm $(GMSUBDIR)/man.imdoc > $@.tmp && \
92- mv $@.tmp $@
89+ @-rm -f $@ $@.tmp
90+ $(DOC2HTML) gm $(GMSUBDIR)/man.imdoc > $@.tmp && mv $@.tmp $@
9391
9492 gm.tex: targets-tex $(GMSUBDIR)/tex.imdoc $(DOC2TEX)
95- -rm -f $@ $@.tmp
96- $(DOC2TEX) < $(GMSUBDIR)/man.imdoc > $@.tmp && \
97- mv $@.tmp $@
93+ @-rm -f $@ $@.tmp
94+ $(DOC2TEX) < $(GMSUBDIR)/man.imdoc > $@.tmp && mv $@.tmp $@
9895
9996 brief_options.imdoc: options.imdoc
10097 $(DOCSELECTBRIEF) options.imdoc brief_options.imdoc
@@ -109,19 +106,16 @@
109106 mkdir -p $(GMSUBDIR)
110107
111108 $(GMSUBDIR)/man.imdoc: targets-man $(GMSUBDIR)
112- -rm -f $@ $@.tmp
113- cat $(addsuffix /man.imdoc, $(UTILSUBWILDCARD)) > $@.tmp && \
114- mv $@.tmp $@
109+ @-rm -f $@ $@.tmp
110+ cat $(addsuffix /man.imdoc, $(UTILSUBWILDCARD)) > $@.tmp && mv $@.tmp $@
115111
116112 $(GMSUBDIR)/html.imdoc: targets-html $(GMSUBDIR)
117- -rm -f $@ $@.tmp
118- cat $(addsuffix /html.imdoc, $(UTILSUBWILDCARD)) > $@.tmp && \
119- mv $@.tmp $@
113+ @-rm -f $@ $@.tmp
114+ cat $(addsuffix /html.imdoc, $(UTILSUBWILDCARD)) > $@.tmp && mv $@.tmp $@
120115
121116 $(GMSUBDIR)/tex.imdoc: targets-tex $(GMSUBDIR)
122- -rm -f $@ $@.tmp
123- cat $(addsuffix /tex.imdoc, $(UTILSUBWILDCARD)) > $@.tmp && \
124- mv $@.tmp $@
117+ @-rm -f $@ $@.tmp
118+ cat $(addsuffix /tex.imdoc, $(UTILSUBWILDCARD)) > $@.tmp && mv $@.tmp $@
125119
126120 #
127121 # Invoke per-utility targets
@@ -179,24 +173,20 @@
179173
180174 $(UTILSUBDIR)/Expanded.imdoc: $(UTILITY).imdoc brief_options.imdoc config_files.imdoc copyright.imdoc environment.imdoc $(DOCINCLUDE)
181175 @if test ! -d $(UTILSUBDIR); then mkdir -p $(UTILSUBDIR); fi
182- -rm -f $@ $@.tmp
183- $(DOCINCLUDE) $< > $@.tmp && \
184- mv $@.tmp $@
176+ @-rm -f $@ $@.tmp
177+ $(DOCINCLUDE) $< > $@.tmp && mv $@.tmp $@
185178
186179 $(UTILSUBDIR)/man.imdoc: $(UTILSUBDIR)/Expanded.imdoc $(DOCSELECTCOMBINED)
187- -rm -f $@ $@.tmp
188- $(DOCSELECTCOMBINED) $(UTILITY) man $< > $@.tmp && \
189- mv $@.tmp $@
180+ @-rm -f $@ $@.tmp
181+ $(DOCSELECTCOMBINED) $(UTILITY) man $< > $@.tmp && mv $@.tmp $@
190182
191183 $(UTILSUBDIR)/html.imdoc: $(UTILSUBDIR)/Expanded.imdoc $(DOCSELECTSEPARATE)
192- -rm -f $@ $@.tmp
193- $(DOCSELECTSEPARATE) $(UTILITY) html $< > $@.tmp && \
194- mv $@.tmp $@
184+ @-rm -f $@ $@.tmp
185+ $(DOCSELECTSEPARATE) $(UTILITY) html $< > $@.tmp && mv $@.tmp $@
195186
196187 $(UTILSUBDIR)/tex.imdoc: $(UTILSUBDIR)/Expanded.imdoc $(DOCSELECTCOMBINED)
197- -rm -f $@ $@.tmp
198- $(DOCSELECTCOMBINED) $(UTILITY) tex $< > $@.tmp && \
199- mv $@.tmp $@
188+ @-rm -f $@ $@.tmp
189+ $(DOCSELECTCOMBINED) $(UTILITY) tex $< > $@.tmp && mv $@.tmp $@
200190
201191 #$(UTILBASE).1: $(UTILSUBDIR)/man.imdoc $(DOC2MAN)
202192 # -rm -f $@ $@.tmp
@@ -204,14 +194,12 @@
204194 # mv $@.tmp $@
205195
206196 $(UTILBASE).html: $(UTILSUBDIR)/html.imdoc $(DOC2HTML)
207- -rm -f $@ $@.tmp
208- $(DOC2HTML) $(UTILITY) $< > $@.tmp && \
209- mv $@.tmp $@
197+ @-rm -f $@ $@.tmp
198+ $(DOC2HTML) $(UTILITY) $< > $@.tmp && mv $@.tmp $@
210199
211200 $(UTILBASE).tex: $(UTILSUBDIR)/tex.imdoc $(DOC2TEX)
212- -rm -f $@ $@.tmp
213- $(DOC2TEX) < $< > $@.tmp && \
214- mv $@.tmp $@
201+ @-rm -f $@ $@.tmp
202+ $(DOC2TEX) < $< > $@.tmp && mv $@.tmp $@
215203
216204 $(INSTALLWWW)/$(UTILITY).html: $(UTILBASE).html
217205 cp -p $< $@
diff -r 764d46677eca -r 5ad72c2bb8ff doc/gmdoc2html
--- a/doc/gmdoc2html Fri Dec 31 11:08:22 2021 -0600
+++ b/doc/gmdoc2html Fri Dec 31 15:20:41 2021 -0600
@@ -2,12 +2,7 @@
22
33 # gmdoc2html utility utility.imdoc > utility.html
44
5-# FIXME: There is an output difference between System V sed and GNU
6-# sed in paragraph delimiters:
7-# -
8-# +\'
9-#
10-# Pre-formatted text is losing all blank lines.
5+# FIXME: Pre-formatted text is losing all blank lines.
116
127 # <!-- ---------------------------------------------------------------- -->
138 # <!-- Options.xml: "options" subsection of convert, composite, et al. -->
diff -r 764d46677eca -r 5ad72c2bb8ff doc/gmdocselect
--- a/doc/gmdocselect Fri Dec 31 11:08:22 2021 -0600
+++ b/doc/gmdocselect Fri Dec 31 15:20:41 2021 -0600
@@ -35,15 +35,13 @@
3535 s/.*/!DELETE!/
3636 n
3737 b skipim
38-
38+
3939 : select
4040 d
4141 " $3 | \
4242 \
4343 \
4444 ${SED} "
45- : begin
46-
4745 /<imdoc>/d
4846 /<\/imdoc>/d
4947 /!DELETE!/d
diff -r 764d46677eca -r 5ad72c2bb8ff doc/imdoc2man
--- a/doc/imdoc2man Fri Dec 31 11:08:22 2021 -0600
+++ b/doc/imdoc2man Fri Dec 31 15:20:41 2021 -0600
@@ -1,17 +1,13 @@
11 #!/bin/sh
22
33 # imdoc2man utility utility.imdoc > utility.1
4-
5-# FIXME: There is an output difference between System V sed and GNU
6-# sed in paragraph delimiters:
7-#
8-# -<p>
9-# + <p>
4+# See https://www.gnu.org/software/groff/manual/html_node/man.html#man
5+# See https://www.oreilly.com/library/view/unix-text-processing/9780810462915/Chapter14.html
6+# See https://cmd.inp.nsk.su/old/cmd2/manuals/unix/UNIX_Unleashed/ch08.htm
107
118 echo ".TH $1 1 \"`date '+%Y/%m/%d'`\" \"GraphicsMagick\""
129
1310 ${SED} "
14- : begin
1511 /<imdoc>/d
1612 /<\/imdoc>/d
1713 /<include file=/d
@@ -69,8 +65,9 @@
6965 /<utils/d
7066 /<\/utils>/d
7167 /<!--/d
72- s/<pre>//
73- s/<\/pre>//
68+ s/<pre>/\\
69+.nf/
70+ s/<\/pre>/.fi/
7471 /<tab>/d
7572 /<\/tab>/d
7673
@@ -100,7 +97,7 @@
10097 s/<\/s>/\\\\fP/g
10198 s/<tt>//g
10299 s/<\/tt>//g
103- s/^\\'/\\\\'/g
100+ s/^'/\\\\'/g
104101
105102 " $2
106-
103+# s/^'/\\\\'/g
diff -r 764d46677eca -r 5ad72c2bb8ff doc/imdocselect
--- a/doc/imdocselect Fri Dec 31 11:08:22 2021 -0600
+++ b/doc/imdocselect Fri Dec 31 15:20:41 2021 -0600
@@ -23,8 +23,6 @@
2323 \
2424 \
2525 ${SED} "
26- : begin
27-
2826 /<imdoc>/d
2927 /<\/imdoc>/d
3028 /<im>/d
diff -r 764d46677eca -r 5ad72c2bb8ff doc/options.imdoc
--- a/doc/options.imdoc Fri Dec 31 11:08:22 2021 -0600
+++ b/doc/options.imdoc Fri Dec 31 15:20:41 2021 -0600
@@ -130,7 +130,7 @@
130130 <!-- ------------ -asc-cdl ------------------------------------------- -->
131131
132132 <utils apps=convert,mogrify>
133-<dopt> -asc-cdl <spec></opt>
133+<dopt>-asc-cdl <spec></opt>
134134
135135 <abs>apply ASC CDL color transform</abs>
136136
@@ -1931,7 +1931,7 @@
19311931
19321932 <pp><pre>
19331933 -draw 'text 100,100 "%m:%f %wx%h"'
1934-</pre></pp>
1934+</pp>
19351935
19361936 <pp>
19371937 annotates the image with <tt>MIFF:bird.miff 512x480</tt> for an image titled
diff -r 764d46677eca -r 5ad72c2bb8ff doc/version.imdoc
--- a/doc/version.imdoc Fri Dec 31 11:08:22 2021 -0600
+++ b/doc/version.imdoc Fri Dec 31 15:20:41 2021 -0600
@@ -55,7 +55,7 @@
5555
5656 <p>To display the version information:</p>
5757
58-<pre>
58+<pp><pre>
5959 GraphicsMagick 1.3.37 2021-12-12 Q16 http://www.GraphicsMagick.org/
6060 Copyright (C) 2002-2021 GraphicsMagick Group.
6161 Additional copyrights and licenses apply to this software.
@@ -102,7 +102,7 @@
102102 LDFLAGS = ...
103103 LIBS = ...
104104
105-</pre>
105+</pre></pp>
106106
107107 </sect>
108108 <back>
diff -r 764d46677eca -r 5ad72c2bb8ff magick/version.h
--- a/magick/version.h Fri Dec 31 11:08:22 2021 -0600
+++ b/magick/version.h Fri Dec 31 15:20:41 2021 -0600
@@ -38,8 +38,8 @@
3838 #define MagickLibVersion 0x262300
3939 #define MagickLibVersionText "1.4"
4040 #define MagickLibVersionNumber 26,23,0
41-#define MagickChangeDate "20211230"
42-#define MagickReleaseDate "snapshot-20211230"
41+#define MagickChangeDate "20211231"
42+#define MagickReleaseDate "snapshot-20211231"
4343
4444 /*
4545 The MagickLibInterfaceNewest and MagickLibInterfaceOldest defines
diff -r 764d46677eca -r 5ad72c2bb8ff utilities/gm.1
--- a/utilities/gm.1 Fri Dec 31 11:08:22 2021 -0600
+++ b/utilities/gm.1 Fri Dec 31 15:20:41 2021 -0600
@@ -1,68 +1,68 @@
1-.TH gm 1 "2021/12/30" "GraphicsMagick"
1+.TH gm 1 "2021/12/31" "GraphicsMagick"
22 .TP
33 .in 15
44 .in 15
55 .in 20
66 .SH NAME
7-\'
7+
88 gm - command-line utility to create, edit, compare, convert, or display images
9-\'
9+
1010 .SH SYNOPSIS
11-\'
11+
1212 \fBgm animate\fP \fB[\fP \fIoptions ...\fP \fB]\fP \fIfile\fP \fB[ [\fP
1313 \fIoptions ...\fP \fB]\fP \fIfile ...\fP \fB]\fP
14-\'
14+
1515 \fBgm batch\fP \fB[\fP \fIoptions ...\fP \fB]\fP \fB[\fP \fIscript\fP \fB]\fP
16-\'
16+
1717 \fBgm benchmark\fP \fB[\fP \fIoptions ...\fP \fB]\fP subcommand
18-\'
18+
1919 \fBgm compare\fP \fB[\fP \fIoptions\fP \fB... ]\fP \fIreference-image\fP
2020 \fB[\fP \fIoptions\fP \fB... ]\fP \fIcompare-image\fP
2121 \fB[\fP \fIoptions\fP \fB... ]\fP
22-\'
22+
2323 \fBgm composite\fP \fB[\fP \fIoptions ...\fP \fB]\fP \fIchange-image base-image\fP
2424 \fB[\fP \fImask-image\fP \fB]\fP \fIoutput-image\fP
25-\'
25+
2626 \fBgm conjure\fP \fB[\fP \fIoptions\fP \fB]\fP \fIscript.msl\fP
2727 \fB[ [\fP \fIoptions\fP \fB]\fP \fIscript.msl\fP \fB]\fP
28-\'
28+
2929 \fBgm convert\fP \fB[ [\fP \fIoptions ...\fP \fB] [\fP \fIinput-file ...\fP
3030 \fB] [\fP \fIoptions ...\fP \fB] ]\fP \fIoutput-file\fP
31-\'
31+
3232 \fBgm display\fP \fB[\fP \fIoptions ...\fP \fB]\fP \fIfile ...\fP
3333 \fB[ [\fP\fIoptions ...\fP \fB]\fP\fIfile ...\fP \fB]\fP
34-\'
34+
3535 \fBgm identify\fP \fIfile\fP \fB[\fP \fIfile ...\fP \fB]\fP
36-\'
36+
3737 \fBgm import\fP \fB[\fP \fIoptions ...\fP \fB]\fP \fIfile\fP
38-\'
38+
3939 \fBgm mogrify\fP \fB[\fP \fIoptions ...\fP \fB]\fP \fIfile ...\fP
40-\'
40+
4141 \fBgm montage\fP \fB[\fP \fIoptions ...\fP \fB]\fP \fIfile\fP \fB[ [\fP
4242 \fIoptions ...\fP \fB]\fP \fIfile ...\fP \fB]\fP \fIoutput-file\fP
43-\'
43+
4444 \fBgm time\fP subcommand
45-\'
45+
4646 \fBgm version\fP
4747 .SH DESCRIPTION
48-\'
48+
4949 GraphicsMagick's \fBgm\fP provides a suite of utilities for creating,
5050 comparing, converting, editing, and displaying images. All of the
5151 utilities are provided as sub-commands of a single \fBgm\fP
5252 executable. The \fBgm\fP executable returns the exit code 0 to
5353 indicate success, or 1 to indicate failure:
54-\'
54+
5555 \fBanimate\fP
5656 displays an animation (e.g. a GIF file) on any workstation display
5757 running an \fIX\fP server.
58-\'
58+
5959 \fBbatch\fP
6060 executes an arbitary number of the utility commands
6161 (e.g. \fBconvert\fP) in the form of a simple linear batch script in
6262 order to improve execution efficiency, and/or to allow use as a
6363 subordinate co-process under the control of an arbitrary script or
6464 program.
65-\'
65+
6666 \fBbenchmark\fP
6767 executes one of the other utility commands (e.g. \fBconvert\fP) for a
6868 specified number of iterations, or execution time, and reports
@@ -70,63 +70,63 @@
7070 utilization. \fBBenchmark\fP provides various operating modes
7171 including executing the command with a varying number of threads, and
7272 alternate reporting formats such as comma-separated value (CSV).
73-\'
73+
7474 \fBcompare\fP
7575 compares two images and reports difference statistics according to
7676 specified metrics and/or outputs an image with a visual representation
7777 of the differences. It may also be used to test if images are similar
7878 within a particular range and specified metric, returning a truth
7979 value to the executing environment.
80-\'
80+
8181 \fBcomposite\fP
8282 composites images (blends or merges images together) to create new images.
83-\'
83+
8484 \fBconjure\fP
8585 interprets and executes scripts in
8686 the Magick Scripting Language (MSL).
87-\'
87+
8888 \fBconvert\fP
8989 converts an input file using one image format to an output file with
9090 the same or differing image format while applying an arbitrary number
9191 of image transformations.
92-\'
92+
9393 \fBdisplay\fP
9494 is a machine architecture independent image processing and display
9595 facility. It can display an image on any workstation display running
9696 an \fIX\fP server.
97-\'
97+
9898 \fBidentify\fP
9999 describes the format and characteristics of one or more image
100100 files. It will also report if an image is incomplete or corrupt.
101-\'
101+
102102 \fBimport\fP
103103 reads an image from any visible window on an \fIX\fP server and
104104 outputs it as an image file. You can capture a single window, the
105105 entire screen, or any rectangular portion of the screen.
106-\'
106+
107107 \fBmogrify\fP
108108 transforms an image or a sequence of images. These transforms include
109109 \fBimage scaling\fP, \fBimage rotation\fP, \fBcolor reduction\fP,
110110 and others. The transmogrified image \fBoverwrites\fP the original
111111 image.
112-\'
112+
113113 \fBmontage\fP
114114 creates a composite by combining several separate images. The images
115115 are tiled on the composite image with the name of the image optionally
116116 appearing just below the individual tile.
117-\'
117+
118118 \fBtime\fP
119119 executes a subcommand and reports the user, system, and total
120120 execution time consumed.
121-\'
121+
122122 \fBversion\fP
123123 reports the GraphicsMagick release version, maximum sample-depth,
124124 copyright notice, supported features, and the options used while
125125 building the software.
126-\'
126+
127127 The \fBGraphicsMagick\fP utilities recognize the following image formats:
128-\'
129-\'
128+
129+
130130 \fBName\fP \fBMode\fP \fBDescription\fP
131131 o 3FR r-- Hasselblad Photo RAW
132132 o 8BIM rw- Photoshop resource format
@@ -324,21 +324,21 @@
324324 r Read
325325 w Write
326326 + Multi-image
327-\'
328-\'
327+
328+
329329 \fISupport for some of these formats require additional programs or libraries.
330330 See README
331331 in the source package for where to find optional additional software\fP.
332-\'
332+
333333 Note, a format delineated with + means that if more than one
334334 image is specified, frames are combined into a single multi-image
335335 file. Use \fB+adjoin\fP if you want a single image produced for each
336336 frame.
337-\'
337+
338338 Your installation might not support all of the formats in the list.
339339 To get an accurate listing of the formats supported by your particular
340340 configuration, run "gm convert -list format".
341-\'
341+
342342 Raw images are expected to have one byte per pixel unless \fBgm\fP is
343343 compiled in 16-bit quantum mode or in 32-bit quantum mode. Here, the
344344 raw data is expected to be stored two or four bytes per pixel,
@@ -347,7 +347,7 @@
347347 version" without any options, and looking for "Q:16" in the first line
348348 of output.
349349 .SH FILES AND FORMATS
350-\'
350+
351351 By default, the image format is determined by its magic number, i.e., the
352352 first few bytes of the file. To specify
353353 a particular image format, precede the filename with an image format name
@@ -361,20 +361,20 @@
361361 In output files, the prefix takes precedence over the filename suffix,
362362 and the filename suffix takes precedence over the
363363 "image->magick" string.
364-\'
364+
365365 To read the "built-in" formats (GRANITE, H, LOGO,
366366 NETSCAPE, PLASMA, and ROSE) use a prefix (including the colon) without a
367367 filename or suffix. To read the XC format, follow the colon with a color
368368 specification. To read the CAPTION format, follow the colon with a text
369369 string or with a filename prefixed with the at symbol (\fB@\fP).
370-\'
371-\'
370+
371+
372372 When you specify \fBX\fP as your image type, the filename has special
373373 meaning. It specifies an X window by \fBid, name\fP, or
374374 \fBroot\fP. If
375375 no filename is specified, the window is selected by clicking the mouse
376376 in the desired window.
377-\'
377+
378378 Specify \fIinput_file\fP as \fB-\fP for standard input,
379379 \fIoutput_file\fP as \fB-\fP for standard output.
380380 If \fIinput_file\fP has the extension \fB.Z\fP or \fB.gz\fP, the
@@ -382,7 +382,7 @@
382382 respectively.
383383 If \fIoutput_file\fP has the extension \fB.Z\fP or \fB.gz\fP,
384384 the file is compressed using with \fIcompress\fP or \fIgzip\fP respectively.
385-\'
385+
386386 Use an optional index enclosed in brackets after an input file name to
387387 specify a desired subimage of a multi-resolution image format like
388388 Photo CD (e.g. "img0001.pcd[4]") or a range for MPEG images
@@ -398,44 +398,45 @@
398398 number in the filename, it is necessary to include a printf-style
399399 %d format specification in the file name and use the +adjoin
400400 option. For example,
401-\'
401+
402+.nf
402403 image%02d.miff
403-\'
404-\'
404+.fi
405+
405406 writes files \fIimage00.miff, image01.miff,\fP etc. Only a single
406407 specification is allowed within an output filename. If more than one
407408 specification is present, it will be ignored. It is best to embed the
408409 scene number in the base part of the file name, not in the extension,
409410 because the extension will not be a recognizeable image type.
410-\'
411+
411412 When running a commandline utility, you can
412413 prepend an at sign @ to a filename to read a list of image
413414 filenames from that file. This is convenient in the event you have too
414415 many image filenames to fit on the command line.
415416 .SH OPTIONS
416-\'
417+
417418 Options are processed in command line order. Any option you specify on
418419 the command line remains in effect for the set of images that follows,
419420 until the set is terminated by the appearance of any option or \fB-noop\fP.
420421 Some options only affect the decoding of images and others only the encoding.
421422 The latter can appear after the final group of input images.
422-\'
423+
423424 This is a combined list of the command-line options used by the
424425 GraphicsMagick utilities (\fIanimate\fP, \fIcompare\fP,
425426 \fIcomposite\fP, \fIconvert\fP, \fIdisplay\fP, \fIidentify\fP,
426427 \fIimport\fP, \fImogrify\fP and \fImontage\fP).
427-\'
428-\'
428+
429+
429430 In this document, angle brackets ("<>") enclose variables and curly
430431 brackets ("{}") enclose optional parameters. For example,
431432 "\fB-fuzz <distance>{%}\fP" means you can use the
432433 option "-fuzz 10"
433434 or "-fuzz 2%".
434-\'
435+
435436 .TP
436437 .B "-adjoin"
437438 \fRjoin images into a single multi-image file
438-\'
439+
439440 By default, all images of an image sequence are stored in the same
440441 file. However, some formats (e.g. JPEG) do not support storing more
441442 than one image per file and only the first frame in an image sequence
@@ -444,19 +445,20 @@
444445 files. If \fB+adjoin\fP is used, then the output filename must
445446 include a printf style formatting specification for the numeric part
446447 of the filename. For example,
447-\'
448+
449+.nf
448450 image%02d.miff
449-\'
451+.fi
450452 .TP
451453 .B "-affine \fI<matrix>"\fP
452454 \fRdrawing transform matrix
453-\'
455+
454456 This option provides a transform matrix {sx,rx,ry,sy,tx,ty} for
455457 use by subsequent \fB-draw\fP or \fB-transform\fP options.
456458 .TP
457459 .B "-antialias"
458460 \fRremove pixel aliasing
459-\'
461+
460462 By default antialiasing algorithms are used when drawing objects (e.g. lines)
461463 or rendering vector formats (e.g. WMF and Postscript). Use +antialias to
462464 disable use of antialiasing algorithms. Reasons to disable antialiasing
@@ -464,7 +466,7 @@
464466 .TP
465467 .B "-append"
466468 \fRappend a set of images
467-\'
469+
468470 This option creates a single image where the images in the original set
469471 are stacked top-to-bottom. If they are not of the same width,
470472 any narrow images will be expanded to fit using the background color.
@@ -473,9 +475,9 @@
473475 If the \fB-append\fP
474476 option appears after all of the input images, all images are appended.
475477 .TP
476-.B " \fI-asc-cdl <spec>"\fP
478+.B "-asc-cdl \fI<spec>"\fP
477479 \fRapply ASC CDL color transform
478-\'
480+
479481 Applies ("bakes in") the ASC CDL, which is a format for the exchange
480482 of basic primary color grading information between equipment and
481483 software from different manufacturers. The format defines the math for
@@ -484,38 +486,40 @@
484486 numbers comprising a single color decision. The tenth number
485487 (optional) is for chromiance (saturation) as specified by ASC CDL
486488 1.2.
487-\'
489+
488490 The argument string is comma delimited and is in the following form
489491 (but without invervening spaces or line breaks)
490-\'
492+
493+.nf
491494 redslope,redoffset,redpower:
492495 greenslope,greenoffset,greenpower:
493496 blueslope,blueoffset,bluepower:
494497 saturation
495-\'
496-\'
498+.fi
499+
497500 with the unity (no change) specification being:
498-\'
501+
502+.nf
499503 "1.0,0.0,1.0:1.0,0.0,1.0:1.0,0.0,1.0:1.0"
500-\'
504+.fi
501505 .TP
502506 .B "-authenticate \fI<string>"\fP
503507 \fRdecrypt image with this password
504-\'
508+
505509 Use this option to supply a password for decrypting an image or an
506510 image sequence, if it is being read from a format such as PDF that supports
507511 encryption. Encrypting images being written is not supported.
508512 .TP
509513 .B "-auto-orient"
510514 \fRorient (rotate) image so it is upright
511-\'
515+
512516 Adjusts the image orienation so that it is suitable for viewing. Uses
513517 the orientation tag obtained from the image file or as supplied by the
514518 \fB-orient\fP option.
515519 .TP
516520 .B "-average"
517521 \fRaverage a set of images
518-\'
522+
519523 The set of images
520524 is terminated by the appearance of any option.
521525 If the \fB-average\fP
@@ -523,7 +527,7 @@
523527 .TP
524528 .B "-backdrop"
525529 \fRdisplay the image centered on a backdrop.
526-\'
530+
527531 This backdrop covers the entire workstation screen and is useful for hiding
528532 other X window activity while viewing the image. The color of the backdrop
529533 is specified as the foreground color (X11 default is black).
@@ -533,13 +537,13 @@
533537 .TP
534538 .B "-background \fI<color>"\fP
535539 \fRthe background color
536-\'
540+
537541 The color is specified using the format described under the \fB-fill\fP
538542 option.
539543 .TP
540544 .B "-black-threshold \fIred[,green][,blue][,opacity]"\fP
541545 \fRpixels below the threshold become black
542-\'
546+
543547 Use \fB-black-threshold\fP to set pixels with values below the specified
544548 threshold to minimum value (black). If only one value is supplied, or the
545549 red, green, and blue values are identical, then intensity thresholding is
@@ -555,19 +559,19 @@
555559 .TP
556560 .B "-blur \fI<radius>{x<sigma>}"\fP
557561 \fRblur the image with a Gaussian operator
558-\'
562+
559563 Blur with the given radius and
560564 standard deviation (sigma).
561565 .TP
562566 .B "-border \fI<width>x<height>"\fP
563567 \fRsurround the image with a border of color
564-\'
568+
565569 See \fB-geometry\fP for details
566570 about the geometry specification.
567571 .TP
568572 .B "-bordercolor \fI<color>"\fP
569573 \fRthe border color
570-\'
574+
571575 The color is specified using the format described under the \fB-fill\fP
572576 option.
573577 .TP
@@ -576,20 +580,20 @@
576580 .TP
577581 .B "-box \fI<color>"\fP
578582 \fRset the color of the annotation bounding box
579-\'
583+
580584 The color is specified using the format described under the \fB-fill\fP
581585 option.
582-\'
586+
583587 See \fB-draw\fP for further
584588 details.
585589 .TP
586590 .B "-channel \fI<type>"\fP
587591 \fRthe type of channel
588-\'
592+
589593 Choose from: \fBRed\fP, \fBGreen\fP, \fBBlue\fP, \fBOpacity\fP,
590594 \fBMatte\fP, \fBCyan\fP, \fBMagenta\fP, \fBYellow\fP, \fBBlack\fP,
591595 or \fBGray\fP.
592-\'
596+
593597 Use this option to extract a particular \fIchannel\fP from the image.
594598 \fBOpacity\fP,
595599 for example, is useful for extracting the opacity values from an image.
@@ -599,11 +603,11 @@
599603 .TP
600604 .B "-chop \fI<width>x<height>{+-}<x>{+-}<y>{%}"\fP
601605 \fRremove pixels from the interior of an image
602-\'
606+
603607 \fIWidth\fP and \fIheight\fP give the number of columns and rows to remove,
604608 and \fIx\fP and \fIy\fP are offsets that give the location of the
605609 leftmost column and topmost row to remove.
606-\'
610+
607611 The \fIx\fP offset normally specifies the leftmost column to remove.
608612 If the \fB-gravity\fP option is present with \fINorthEast, East,\fP
609613 or \fISouthEast\fP
@@ -614,31 +618,32 @@
614618 or \fISouthEast\fP
615619 gravity, it specifies the distance upward from the bottom edge of the
616620 image to the bottom row to remove.
617-\'
621+
618622 The \fB-chop\fP option removes entire rows and columns,
619623 and moves the remaining corner blocks leftward and upward to close the gaps.
620624 .TP
621625 .B "-clip"
622626 \fRapply the clipping path, if one is present
623-\'
627+
624628 If a clipping path is present, it will be applied to subsequent operations.
625-\'
629+
626630 For example, if you type the following command:
627-\'
631+
632+.nf
628633 gm convert -clip -negate cockatoo.tif negated.tif
629-\'
630-\'
634+.fi
635+
631636 only the pixels within the clipping path are negated.
632-\'
637+
633638 The \fB-clip\fP feature requires the XML library. If the XML library
634639 is not present, the option is ignored.
635640 .TP
636641 .B "-coalesce"
637642 \fRmerge a sequence of images
638-\'
643+
639644 Each image N in the sequence after Image 0 is replaced with the image
640645 created by flattening images 0 through N.
641-\'
646+
642647 The set of images
643648 is terminated by the appearance of any option.
644649 If the \fB-coalesce\fP
@@ -646,23 +651,24 @@
646651 .TP
647652 .B "-colorize \fI<value>"\fP
648653 \fRcolorize the image with the pen color
649-\'
654+
650655 Specify the amount of colorization as a percentage. You can apply separate
651656 colorization values to the red, green, and blue channels of the image with
652657 a colorization value list delimited with slashes (e.g. 0/0/50).
653-\'
658+
654659 The \fB-colorize\fP option may be used in conjunction with \fB-modulate\fP
655660 to produce a nice sepia toned image like:
656-\'
661+
662+.nf
657663 gm convert input.ppm -modulate 115,0,100 \\
658664 -colorize 7,21,50 output.ppm.
659-\'
665+.fi
660666 .TP
661667 .B "-colormap \fI<type>"\fP
662668 \fRdefine the colormap type
663-\'
669+
664670 Choose between \fBshared\fP or \fBprivate\fP.
665-\'
671+
666672 This option only applies when the default X server visual is \fIPseudoColor\fP
667673 or \fIGRAYScale\fP. Refer to \fB-visual\fP for more details. By default,
668674 a shared colormap is allocated. The image shares colors with other X clients.
@@ -673,7 +679,7 @@
673679 .TP
674680 .B "-colors \fI<value>"\fP
675681 \fRpreferred number of colors in the image
676-\'
682+
677683 The actual number of colors in the image may be less than your request,
678684 but never more. Note, this is a color reduction option. Images with less
679685 unique colors than specified with this option will have any duplicate or
@@ -682,19 +688,19 @@
682688 image to the gray colorspace before reducing the number of colors since
683689 doing so is most efficient. Refer to <a
684690 href="quantize.html">quantize for more details.
685-\'
691+
686692 Note, options \fB-dither\fP, \fB-colorspace\fP, and \fB-treedepth\fP
687693 affect the color reduction algorithm.
688694 .TP
689695 .B "-colorspace \fI<value>"\fP
690696 \fRthe type of colorspace
691-\'
697+
692698 Choices are:
693699 \fBCineonLog\fP, \fBCMYK\fP, \fBGRAY\fP, \fBHSL\fP, \fBHWB\fP,
694700 \fBOHTA\fP, \fBRGB\fP, \fBRec601Luma\fP, \fBRec709Luma\fP,
695701 \fBRec601YCbCr\fP, \fBRec709YCbCr\fP, \fBTransparent\fP, \fBXYZ\fP,
696702 \fBYCbCr\fP, \fBYIQ\fP, \fBYPbPr\fP, or \fBYUV\fP.
697-\'
703+
698704 Color reduction, by default, takes place in the RGB color space. Empirical
699705 evidence suggests that distances in color spaces such as YUV or YIQ correspond
700706 to perceptual color differences more closely than do distances in RGB space.
@@ -708,25 +714,25 @@
708714 \fBGRAY\fP colorspace currently selects the \fBRec601Luma\fP
709715 colorspace by default for backwards compatibly reasons. This default
710716 may be re-considered in the future.
711-\'
717+
712718 Two YCbCr colorspaces are supported. The \fBRec601YCbCr\fP space is
713719 based on the recommendations for legacy NTSC television (ITU-R BT.601-5). The
714720 \fBRec709CbCr\fP space is based on the recommendations for HDTV (Rec.
715721 ITU-R BT.709-5) and is suitable for suitable for use with computer
716722 graphics, and for contemporary CRT displays. The \fBYCbCr\fP colorspace
717723 specification is equivalent to\fBRec601YCbCr\fP.
718-\'
719-\'
724+
725+
720726 The \fBTransparent\fP color space behaves uniquely in that it preserves
721727 the matte channel of the image if it exists.
722-\'
728+
723729 The \fB-colors\fP or \fB-monochrome\fP option, or saving to a file
724730 format which requires color reduction, is required for this option to
725731 take effect.
726732 .TP
727733 .B "-comment \fI<string>"\fP
728734 \fRannotate an image with a comment
729-\'
735+
730736 Use this option to assign a specific comment to the image, when writing
731737 to an image format that supports comments. You can include the
732738 image filename, type, width, height, or other image attribute by embedding
@@ -735,31 +741,32 @@
735741 datastream via a "Comment" tag or similar mechanism. If you want the
736742 comment to be visible on the image itself, use the \fB-draw\fP option
737743 instead.
738-\'
744+
739745 For example,
740-\'
746+
747+.nf
741748 -comment "%m:%f %wx%h"
742-\'
743-\'
749+.fi
750+
744751 produces an image comment of \fBMIFF:bird.miff 512x480\fP for an image
745752 titled \fBbird.miff\fP and whose width is 512 and height is 480.
746-\'
753+
747754 If the first character of \fIstring\fP is \fI@\fP, the image comment
748755 is read from a file titled by the remaining characters in the string.
749756 Please note that if the string comes from an untrusted source that it
750757 should be sanitized before use since otherwise the content of an
751758 arbitrary readable file could be incorporated in a comment in the
752759 output file (a security risk).
753-\'
760+
754761 If the -comment option appears multiple times, only the last comment is
755762 stored.
756-\'
763+
757764 In PNG images, the comment is stored in a \fBtEXt\fP or \fBzTXt\fP chunk
758765 with the keyword "comment".
759766 .TP
760767 .B "-compose \fI<operator>"\fP
761768 \fRthe type of image composition
762-\'
769+
763770 The description of composition uses abstract terminology in order to
764771 allow the the description to be more clear, while avoiding constant
765772 values which are specific to a particular build configuration. Each image
@@ -773,7 +780,7 @@
773780 channel is disabled, then all pixels in the image are treated as opaque.
774781 The color of an \fIopaque\fP pixel is fully visible while the color of a
775782 \fItransparent\fP pixel color is entirely absent (pixel color is ignored).
776-\'
783+
777784 By definition, raster images have a rectangular shape. All image rows are
778785 of equal length, and all image columns have the same number of rows. By
779786 treating the opacity channel as a visual "mask" the rectangular image may
@@ -787,10 +794,11 @@
787794 "shapes" they are by no means limited to mask-style operations since they
788795 are based on continuous floating-point mathematics rather than simple
789796 boolean operations.
790-\'
797+
791798 By default, the \fIOver\fP composite operator is used. The following
792799 composite operators are available:
793-\'
800+
801+.nf
794802 Over
795803 In
796804 Out
@@ -813,12 +821,12 @@
813821 CopyMagenta
814822 CopyYellow
815823 CopyBlack
816-\'
817-\'
824+.fi
825+
818826 The behavior of each operator is described below.
819-\'
820-.in 15
821-\'
827+
828+.in 15
829+
822830 .in 15
823831 .B "Over"
824832 .in 20
@@ -827,7 +835,7 @@
827835 The result will be the union of the two image shapes, with opaque areas
828836 of \fIchange-image\fP obscuring \fIbase-image\fP in the region of
829837 overlap.
830-\'
838+
831839 .in 15
832840 .in 15
833841 .B "In"
@@ -837,7 +845,7 @@
837845 The result is simply \fIchange-image\fP cut by the shape of
838846 \fIbase-image\fP. None of the image data of \fIbase-image\fP will be in
839847 the result.
840-\'
848+
841849 .in 15
842850 .in 15
843851 .B "Out"
@@ -846,7 +854,7 @@
846854 .in 20
847855 The resulting image is \fIchange-image\fP with the shape of
848856 \fIbase-image\fP cut out.
849-\'
857+
850858 .in 15
851859 .in 15
852860 .B "Atop"
@@ -858,7 +866,7 @@
858866 overlap. Note this differs from \fBover\fP because the portion of
859867 \fIchange-image\fP outside \fIbase-image\fP's shape does not appear in
860868 the result.
861-\'
869+
862870 .in 15
863871 .in 15
864872 .B "Xor"
@@ -868,7 +876,7 @@
868876 The result is the image data from both \fIchange-image\fP and
869877 \fIbase-image\fP that is outside the overlap region. The overlap region
870878 will be blank.
871-\'
879+
872880 .in 15
873881 .in 15
874882 .B "Plus"
@@ -878,7 +886,7 @@
878886 The result is just the sum of the image data. Output values are cropped
879887 to MaxRGB (no overflow). This operation is independent of the matte
880888 channels.
881-\'
889+
882890 .in 15
883891 .in 15
884892 .B "Minus"
@@ -888,7 +896,7 @@
888896 The result of \fIchange-image\fP - \fIbase-image\fP, with underflow
889897 cropped to zero. The matte channel is ignored (set to opaque, full
890898 coverage).
891-\'
899+
892900 .in 15
893901 .in 15
894902 .B "Add"
@@ -897,7 +905,7 @@
897905 .in 20
898906 The result of \fIchange-image\fP + \fIbase-image\fP, with overflow
899907 wrapping around (\fImod\fP MaxRGB+1).
900-\'
908+
901909 .in 15
902910 .in 15
903911 .B "Subtract"
@@ -907,7 +915,7 @@
907915 The result of \fIchange-image\fP - \fIbase-image\fP, with underflow
908916 wrapping around (\fImod\fP MaxRGB+1). The \fBadd\fP and \fBsubtract\fP
909917 operators can be used to perform reversible transformations.
910-\'
918+
911919 .in 15
912920 .in 15
913921 .B "Difference"
@@ -916,7 +924,7 @@
916924 .in 20
917925 The result of abs(\fIchange-image\fP - \fIbase-image\fP). This is
918926 useful for comparing two very similar images.
919-\'
927+
920928 .in 15
921929 .in 15
922930 .B "Divide"
@@ -926,7 +934,7 @@
926934 The result of \fIchange-image\fP / \fIbase-image\fP. This is useful
927935 for improving the readability of text on unevenly illuminated photos (by
928936 using a gaussian blurred copy of change-image as base-image).
929-\'
937+
930938 .in 15
931939 .in 15
932940 .B "Multiply"
@@ -935,7 +943,7 @@
935943 .in 20
936944 The result of \fIchange-image\fP * \fIbase-image\fP. This is useful for
937945 the creation of drop-shadows.
938-\'
946+
939947 .in 15
940948 .in 15
941949 .B "Bumpmap"
@@ -943,7 +951,7 @@
943951 \fR
944952 .in 20
945953 The result \fIbase-image\fP shaded by \fIchange-image\fP.
946-\'
954+
947955 .in 15
948956 .in 15
949957 .B "Copy"
@@ -952,7 +960,7 @@
952960 .in 20
953961 The resulting image is \fIbase-image\fP replaced with
954962 \fIchange-image\fP. Here the matte information is ignored.
955-\'
963+
956964 .in 15
957965 .in 15
958966 .B "CopyRed"
@@ -962,7 +970,7 @@
962970 The resulting image is the red channel in \fIbase-image\fP replaced with
963971 the red channel in \fIchange-image\fP. The other channels are copied
964972 untouched.
965-\'
973+
966974 .in 15
967975 .in 15
968976 .B "CopyGreen"
@@ -972,7 +980,7 @@
972980 The resulting image is the green channel in \fIbase-image\fP replaced
973981 with the green channel in \fIchange-image\fP. The other channels are
974982 copied untouched.
975-\'
983+
976984 .in 15
977985 .in 15
978986 .B "CopyBlue"
@@ -982,7 +990,7 @@
982990 The resulting image is the blue channel in \fIbase-image\fP replaced
983991 with the blue channel in \fIchange-image\fP. The other channels are
984992 copied untouched.
985-\'
993+
986994 .in 15
987995 .in 15
988996 .B "CopyOpacity"
@@ -992,7 +1000,7 @@
9921000 The resulting image is the opacity channel in \fIbase-image\fP replaced
9931001 with the opacity channel in \fIchange-image\fP. The other channels are
9941002 copied untouched.
995-\'
1003+
9961004 .in 15
9971005 .in 15
9981006 .B "CopyCyan"
@@ -1003,7 +1011,7 @@
10031011 with the cyan channel in \fIchange-image\fP. The other channels are
10041012 copied untouched. Use of this operator requires that base-image be in
10051013 CMYK(A) colorspace.
1006-\'
1014+
10071015 .in 15
10081016 .in 15
10091017 .B "CopyMagenta"
@@ -1014,7 +1022,7 @@
10141022 replaced with the magenta channel in \fIchange-image\fP. The other
10151023 channels are copied untouched. Use of this operator requires that
10161024 base-image be in CMYK(A) colorspace.
1017-\'
1025+
10181026 .in 15
10191027 .in 15
10201028 .B "CopyYellow"
@@ -1025,7 +1033,7 @@
10251033 replaced with the yellow channel in \fIchange-image\fP. The other
10261034 channels are copied untouched. Use of this operator requires that
10271035 base-image be in CMYK(A) colorspace.
1028-\'
1036+
10291037 .in 15
10301038 .in 15
10311039 .B "CopyBlack"
@@ -1037,28 +1045,28 @@
10371045 channels are copied untouched. Use of this operator requires that
10381046 base-image be in CMYK(A) colorspace. If change-image is not in CMYK
10391047 space, then the change-image pixel intensities are used.
1040-\'
1041-.in 15
1042-\'
1043-\'
1048+
1049+.in 15
1050+
1051+
10441052 .TP
10451053 .B "-compress \fI<type>"\fP
10461054 \fRthe type of image compression
1047-\'
1055+
10481056 Choices are: \fINone\fP, \fIBZip\fP, \fIFax\fP,
10491057 \fIGroup3\fP, \fIGroup4\fP,
10501058 \fIJPEG\fP, \fILossless\fP,
10511059 \fILZW\fP, \fIRLE\fP, \fIZip\fP, \fILZMA\fP, \fIJPEG2000\fP,
10521060 \fIJPEG2000\fP, \fIJBIG\fP, \fIJBIG2\fP, \fIWebP\fP, or \fIZSTD\fP.
1053-\'
1054-\'
1061+
1062+
10551063 Specify \fB+compress\fP to store the binary image in an uncompressed format.
10561064 The default is the compression type of the specified image file.
1057-\'
1065+
10581066 \fI"Lossless"\fP refers to lossless JPEG, which is only available if
10591067 the JPEG library has been patched to support it. Use of lossless JPEG is
10601068 generally not recommended.
1061-\'
1069+
10621070 Use the \fB-quality\fP option to set the compression level to be used
10631071 by the JPEG, JPEG-2000, PNG, MIFF, MPEG, and TIFF encoders. Use the
10641072 \fB-sampling-factor\fP option to set the sampling factor to be used
@@ -1067,21 +1075,22 @@
10671075 .TP
10681076 .B "-contrast"
10691077 \fRenhance or reduce the image contrast
1070-\'
1078+
10711079 This option enhances the intensity differences between the lighter and
10721080 darker elements of the image. Use \fB-contrast\fP to enhance
10731081 the image
10741082 or \fB+contrast\fP to reduce the image contrast.
1075-\'
1076-\'
1083+
1084+
10771085 For a more pronounced effect you can repeat the option:
1078-\'
1086+
1087+.nf
10791088 gm convert rose: -contrast -contrast rose_c2.png
1080-\'
1089+.fi
10811090 .TP
10821091 .B "-convolve \fI<kernel>"\fP
10831092 \fRconvolve image with the specified convolution kernel
1084-\'
1093+
10851094 The kernel is specified as a comma-separated list of floating point
10861095 values, ordered left-to right, starting with the top row. The order of
10871096 the kernel is determined by the square root of the number of entries.
@@ -1089,7 +1098,7 @@
10891098 .TP
10901099 .B "-create-directories"
10911100 \fRcreate output directory if required
1092-\'
1101+
10931102 Use this option with \fB-output-directory\fP if the input paths contain
10941103 subdirectories and it is desired to create similar subdirectories in the
10951104 output directory. Without this option, \fBmogrify\fP will fail if the
@@ -1097,16 +1106,16 @@
10971106 .TP
10981107 .B "-crop \fI<width>x<height>{+-}<x>{+-}<y>{%}"\fP
10991108 \fRpreferred size and location of the cropped image
1100-\'
1109+
11011110 See \fB-geometry\fP for details
11021111 about the geometry specification.
1103-\'
1112+
11041113 The width and height give the size of the image that remains after cropping,
11051114 and \fIx\fP and \fIy\fP are offsets that give the location of the top left
11061115 corner of the cropped
11071116 image with respect to the original image. To specify the amount to be
11081117 removed, use \fB-shave\fP instead.
1109-\'
1118+
11101119 If the \fIx\fP and \fIy\fP offsets are present, a single image is
11111120 generated, consisting of the pixels from the cropping region.
11121121 The offsets specify the location of the upper left corner of
@@ -1120,7 +1129,7 @@
11201129 or \fISouthEast\fP
11211130 gravity, the distance is measured upward between the bottom
11221131 edges.
1123-\'
1132+
11241133 If the \fIx\fP and \fIy\fP offsets are omitted, a set of tiles of the
11251134 specified geometry, covering the entire input image, is generated. The
11261135 rightmost tiles and the bottom tiles are smaller if the
@@ -1128,13 +1137,13 @@
11281137 .TP
11291138 .B "-cycle \fI<amount>"\fP
11301139 \fRdisplace image colormap by amount
1131-\'
1140+
11321141 \fIAmount\fP defines the number of positions each colormap entry isshifted.
1133-\'
1142+
11341143 .TP
11351144 .B "-debug \fI<events>"\fP
11361145 \fRenable debug printout
1137-\'
1146+
11381147 The events parameter specifies which events are to be logged. It
11391148 can be either None, All, or a comma-separated list
11401149 consisting of one or more of the following domains:
@@ -1158,30 +1167,31 @@
11581167 Warning, or
11591168 X11,
11601169 For example, to log cache and blob events, use
1161-\'
1170+
1171+.nf
11621172 gm convert -debug "Cache,Blob" rose: rose.png
1163-\'
1164-\'
1173+.fi
1174+
11651175 The "User" domain is normally empty, but developers can log "User" events
11661176 in their private copy of GraphicsMagick.
1167-\'
1177+
11681178 Use the \fB-log\fP option to specify the format for debugging output.
1169-\'
1179+
11701180 Use \fB+debug\fP to turn off all logging.
1171-\'
1181+
11721182 An alternative to using \fB-debug\fP is to use the \fBMAGICK_DEBUG\fP
11731183 environment variable. The allowed values for the \fBMAGICK_DEBUG\fP
11741184 environment variable are the same as for the \fB-debug\fP option.
11751185 .TP
11761186 .B "-deconstruct"
11771187 \fRbreak down an image sequence into constituent parts
1178-\'
1188+
11791189 This option compares each image with the next in a sequence and
11801190 returns the maximum bounding region of any pixel differences it discovers.
11811191 This method can undo a coalesced sequence returned by the
11821192 \fB-coalesce\fP option, and is useful for removing redundant information
11831193 from a GIF or MNG animation.
1184-\'
1194+
11851195 The sequence of images
11861196 is terminated by the appearance of any option.
11871197 If the \fB-deconstruct\fP
@@ -1197,11 +1207,11 @@
11971207 that name. This is used to control on/off options. Use +define
11981208 <key>,... to remove definitions previously created. Use
11991209 +define "*" to remove all existing definitions.
1200-\'
1210+
12011211 The following definitions may be created:
1202-\'
1203-.in 15
1204-\'
1212+
1213+.in 15
1214+
12051215 .in 15
12061216 .B "cineon:colorspace={rgb|cineonlog}"
12071217 .in 20
@@ -1210,7 +1220,7 @@
12101220 Use the cineon:colorspace option when reading a Cineon file to
12111221 specify the colorspace the Cineon file uses. This overrides the colorspace
12121222 type implied by the DPX header (if any).
1213-\'
1223+
12141224 .in 15
12151225 .in 15
12161226 .B "dpx:bits-per-sample=<value>"
@@ -1224,7 +1234,7 @@
12241234 standard supports bits per sample values of 1, 8, 10, 12, and 16. Many
12251235 DPX readers demand a sample size of 10 bits with type A padding (see
12261236 below).
1227-\'
1237+
12281238 .in 15
12291239 .in 15
12301240 .B "dpx:colorspace={rgb|cineonlog}"
@@ -1234,7 +1244,7 @@
12341244 Use the dpx:colorspace option when reading a DPX file to
12351245 specify the colorspace the DPX file uses. This overrides the colorspace
12361246 type implied by the DPX header (if any).
1237-\'
1247+
12381248 .in 15
12391249 .in 15
12401250 .B "dpx:packing-method={packed|a|b|lsbpad|msbpad}"
@@ -1248,7 +1258,7 @@
12481258 sample sizes of 10 or 12 bits. If samples are not packed, the DPX
12491259 standard recommends type A padding. Many DPX readers demand a sample size
12501260 of 10 bits with type A padding.
1251-\'
1261+
12521262 .in 15
12531263 .in 15
12541264 .B "dpx:pixel-endian={lsb|msb}"
@@ -1259,7 +1269,7 @@
12591269 reading or writing the DPX files. Sometimes this is useful if the file is
12601270 (or must be) written incorrectly so that the file header and the pixels
12611271 use different endianness.
1262-\'
1272+
12631273 .in 15
12641274 .in 15
12651275 .B "dpx:swap-samples={true|false}"
@@ -1283,7 +1293,7 @@
12831293 sample order. Use swap-samples-read when swapping should only occur
12841294 in the reader, or swap-samples-write when swapping should only occur
12851295 in the writer.
1286-\'
1296+
12871297 .in 15
12881298 .in 15
12891299 .B "gradient:direction={South|North|West|East|NorthWest|NorthEast|SouthWest|SouthEast}"
@@ -1299,7 +1309,7 @@
12991309 Top-Left), \fBNorthEast\fP (Bottom-Left to Top-Right),
13001310 \fBSouthWest\fP (Top-Right Bottom-Left), and \fBSouthEast\fP
13011311 (Top-Left to Bottom-Right).
1302-\'
1312+
13031313 .in 15
13041314 .in 15
13051315 .B "jp2:rate=<value>"
@@ -1312,7 +1322,7 @@
13121322 compression. If defined, this value overrides the -quality
13131323 setting. The default quality setting of 75 results in a rate value of
13141324 0.06641.
1315-\'
1325+
13161326 .in 15
13171327 .in 15
13181328 .B "jpeg:block-smoothing={true|false}"
@@ -1321,7 +1331,7 @@
13211331 .in 20
13221332 Enables or disables block smoothing when reading a JPEG file
13231333 (default enabled).
1324-\'
1334+
13251335 .in 15
13261336 .in 15
13271337 .B "jpeg:dct-method=<value>"
@@ -1335,7 +1345,7 @@
13351345 \fBfastest\fP might not necessarily be fastest on your CPU, depending
13361346 on the choices made when the JPEG library was built and how your CPU
13371347 behaves.
1338-\'
1348+
13391349 .in 15
13401350 .in 15
13411351 .B "jpeg:fancy-upsampling={true|false}"
@@ -1344,7 +1354,7 @@
13441354 .in 20
13451355 Enables or disables fancy upsampling when reading a JPEG file
13461356 (default enabled).
1347-\'
1357+
13481358 .in 15
13491359 .in 15
13501360 .B "jpeg:max-scan-number=<value>"
@@ -1355,7 +1365,7 @@
13551365 scans allowed in a JPEG file. The default maximum is 100 scans. This
13561366 limit is imposed due to a weakness in the JPEG standard which allows
13571367 small JPEG files to take many minutes or hours to be read.
1358-\'
1368+
13591369 .in 15
13601370 .in 15
13611371 .B "jpeg:max-warnings=<value>"
@@ -1365,7 +1375,7 @@
13651375 Specifies an integer value for how many warnings are allowed for
13661376 any given error type before being promoted to a hard error. JPEG
13671377 files producing excessive warnings indicate a problem with the file.
1368-\'
1378+
13691379 .in 15
13701380 .in 15
13711381 .B "jpeg:optimize-coding={true|false}"
@@ -1377,7 +1387,7 @@
13771387 requires that the entire image be buffered in memory. Huffman encoding
13781388 produces smaller JPEG files at the expense of added compression time and
13791389 memory consumption.
1380-\'
1390+
13811391 .in 15
13821392 .in 15
13831393 .B "jpeg:preserve-settings"
@@ -1391,7 +1401,7 @@
13911401 file. If the colorspace of the output file differs from that of the
13921402 input file, the quality setting is preserved but the sampling-factors
13931403 are not.
1394-\'
1404+
13951405 .in 15
13961406 .in 15
13971407 .B "pcl:fit-to-page"
@@ -1414,7 +1424,7 @@
14141424 may be increased using this option. Take care when increasing this
14151425 limit since an excessively large limit could allow untrusted files to
14161426 use excessive memory.
1417-\'
1427+
14181428 .in 15
14191429 .in 15
14201430 .B "mng:maximum-loops=<value>"
@@ -1425,7 +1435,7 @@
14251435 be specified by a MNG LOOP chunk. Without an imposed limit, a MNG file
14261436 could request up to 2147483647 loops, which could run for a very long
14271437 time. The current default limit is 512 loops.
1428-\'
1438+
14291439 .in 15
14301440 .in 15
14311441 .B "pdf:use-cropbox={true|false}"
@@ -1434,7 +1444,7 @@
14341444 .in 20
14351445 If the pdf:use-cropbox flag is set to \fBtrue\fP, then
14361446 Ghostscript is requested to apply the PDF crop box.
1437-\'
1447+
14381448 .in 15
14391449 .in 15
14401450 .B "pdf:stop-on-error={true|false}"
@@ -1445,7 +1455,7 @@
14451455 Ghostscript is requested to stop processing the PDF when the first
14461456 error is encountered. Otherwise it will attempt to process all
14471457 requested pages.
1448-\'
1458+
14491459 .in 15
14501460 .in 15
14511461 .B "ps:imagemask"
@@ -1455,7 +1465,7 @@
14551465 If the ps:imagemask flag is defined, the PS3 and EPS3 coders will
14561466 create Postscript files that render bilevel images with the Postscript
14571467 imagemask operator instead of the image operator.
1458-\'
1468+
14591469 .in 15
14601470 .in 15
14611471 .B "ptif:minimum-geometry=<geometry>"
@@ -1466,7 +1476,7 @@
14661476 use it to determine the minimum frame size to output when writing a
14671477 pyramid TIFF file (a TIFF file containing a succession of reduced
14681478 versions of the first frame). The default minimum geometry is 32x32.
1469-\'
1479+
14701480 .in 15
14711481 .in 15
14721482 .B "tiff:alpha={unspecified|associated|unassociated}"
@@ -1487,7 +1497,7 @@
14871497 channel. Note that for many years, ImageMagick and GraphicsMagick marked
14881498 TIFF files as using associated alpha, without properly pre-multiplying
14891499 the pixels.
1490-\'
1500+
14911501 .in 15
14921502 .in 15
14931503 .B "tiff:fill-order={msb2lsb|lsb2msb}"
@@ -1500,7 +1510,7 @@
15001510 only exception to this is when Group3 or Group4 FAX compression is
15011511 requested since FAX machines send data in bit-reversed order and
15021512 therefore RFC 2301 recommends using reverse order.
1503-\'
1513+
15041514 .in 15
15051515 .in 15
15061516 .B "tiff:group-three-options=<value>"
@@ -1511,7 +1521,7 @@
15111521 will use it to set the group3 options tag when writing
15121522 group3-compressed TIFF. Please see the TIFF specification for the
15131523 usage of this tag. The default value is 4.
1514-\'
1524+
15151525 .in 15
15161526 .in 15
15171527 .B "tiff:ignore-tags=<tags>"
@@ -1524,7 +1534,7 @@
15241534 which otherwise fail to read due to problems with TIFF tags. Note
15251535 that some TIFF tags are required in order to be able to read the image
15261536 data at all.
1527-\'
1537+
15281538 .in 15
15291539 .in 15
15301540 .B "tiff:report-warnings={false|true}"
@@ -1538,7 +1548,7 @@
15381548 they may help deduce problems with the TIFF file, or help detect that
15391549 the TIFF file requires a special application to read successfully due
15401550 to the use of proprietary or specialized extensions.
1541-\'
1551+
15421552 .in 15
15431553 .in 15
15441554 .B "tiff:sample-format={unsigned|ieeefp}"
@@ -1551,7 +1561,7 @@
15511561 files with float (32-bit) or double (64-bit) values. Use the
15521562 tiff:bits-per-sample define to determine the type of floating-point value
15531563 to use.
1554-\'
1564+
15551565 .in 15
15561566 .in 15
15571567 .B "tiff:max-sample-value=<value>"
@@ -1566,7 +1576,7 @@
15661576 best maximum sample value so if the range is not 1.0, or the
15671577 SMaxSampleValue tag is not present, it may be necessary to
15681578 (intelligently) use this parameter to properly read a file.
1569-\'
1579+
15701580 .in 15
15711581 .in 15
15721582 .B "tiff:min-sample-value=<value>"
@@ -1577,7 +1587,7 @@
15771587 the assigned value as the minimum floating point value while reading or
15781588 writing IEEE floating point TIFFs. Otherwise the minimum value is 0.0 or
15791589 the value obtained from the file's SMinSampleValue tag (if present).
1580-\'
1590+
15811591 .in 15
15821592 .in 15
15831593 .B "tiff:bits-per-sample=<value>"
@@ -1587,11 +1597,11 @@
15871597 If the tiff:bits-per-sample key is defined, GraphicsMagick will write
15881598 images with the specified bits per sample, overriding any existing depth
15891599 value. Value may be any in the range of 1 to 32, or 64 when the default
1590-'unsigned' format is written, or 16/32/24/64 if IEEEFP format is written.
1600+\'unsigned' format is written, or 16/32/24/64 if IEEEFP format is written.
15911601 Please note that the baseline TIFF 6.0 specification only requires
15921602 readers to handle certain powers of two, and the values to be handled
15931603 depend on the nature of the image (e.g. colormapped, grayscale, RGB, CMYK).
1594-\'
1604+
15951605 .in 15
15961606 .in 15
15971607 .B "tiff:samples-per-pixel=<value>"
@@ -1601,7 +1611,7 @@
16011611 If the tiff:samples-per-pixel key is defined to a value, the TIFF coder
16021612 will write TIFF images with the defined samples per pixel, overriding any
16031613 value stored in the image. This option should not normally be used.
1604-\'
1614+
16051615 .in 15
16061616 .in 15
16071617 .B "tiff:rows-per-strip=<value>"
@@ -1611,7 +1621,7 @@
16111621 Allows the user to specify the number of rows per TIFF strip.
16121622 Rounded up to a multiple of 16 when using JPEG compression. Ignored when
16131623 using tiles.
1614-\'
1624+
16151625 .in 15
16161626 .in 15
16171627 .B "tiff:strip-per-page=true"
@@ -1622,7 +1632,7 @@
16221632 normally the default when group3 or group4 compression is requested
16231633 within reasonable limits. Requesting a single strip for large images may
16241634 result in failure due to resource consumption in the writer or reader.
1625-\'
1635+
16261636 .in 15
16271637 .in 15
16281638 .B "tiff:tile"
@@ -1632,7 +1642,7 @@
16321642 Enable writing tiled TIFF (rather than stripped) using the default tile
16331643 size. Tiled TIFF organizes the image as an array of smaller images
16341644 (tiles) in order to enable random access.
1635-\'
1645+
16361646 .in 15
16371647 .in 15
16381648 .B "tiff:tile-geometry=<width>x<height>"
@@ -1649,7 +1659,7 @@
16491659 to 1024x1024. Large images which require using a disk-based pixel cache
16501660 benefit from large tile sizes while images which fit in memory work well
16511661 with smaller tile sizes.
1652-\'
1662+
16531663 .in 15
16541664 .in 15
16551665 .B "tiff:tile-width=<width>"
@@ -1660,7 +1670,7 @@
16601670 is then defaulted to an appropriate size. Width should be a multiple of
16611671 16. If the value is not a multiple of 16, then it will be rounded down.
16621672 Enables tiled TIFF if it has not already been enabled.
1663-\'
1673+
16641674 .in 15
16651675 .in 15
16661676 .B "tiff:tile-height=<height>"
@@ -1671,7 +1681,7 @@
16711681 is then defaulted to an appropriate size. Height should be a multiple of
16721682 16. If the value is not a multiple of 16, then it will be rounded down.
16731683 Enables tiled TIFF if it has not already been enabled.
1674-\'
1684+
16751685 .in 15
16761686 .in 15
16771687 .B "tiff:webp-lossless={TRUE|FALSE}"
@@ -1683,7 +1693,7 @@
16831693 option may also be used. The quality factor set by the
16841694 \fB-quality\fP option may be used to influence the level of effort
16851695 expended while compressing.
1686-\'
1696+
16871697 .in 15
16881698 .in 15
16891699 .B "tiff:zstd-compress-level=<value>"
@@ -1694,8 +1704,8 @@
16941704 TIFF files. The valid range is 1 to 22. If this define is not
16951705 specified, then the 'quality' value is used such that the default
16961706 quality setting of 75 is translated to a compress level of 9 such that
1697-'quality' has a useful range of 10-184 if used for this purpose.
1698-\'
1707+\'quality' has a useful range of 10-184 if used for this purpose.
1708+
16991709 .in 15
17001710 .in 15
17011711 .B "webp:lossless={true|false}"
@@ -1703,7 +1713,7 @@
17031713 \fR
17041714 .in 20
17051715 Enable lossless encoding.
1706-\'
1716+
17071717 .in 15
17081718 .in 15
17091719 .B "webp:method={0-6}"
@@ -1711,7 +1721,7 @@
17111721 \fR
17121722 .in 20
17131723 Quality/speed trade-off.
1714-\'
1724+
17151725 .in 15
17161726 .in 15
17171727 .B "webp:image-hint={default,graph,photo,picture}"
@@ -1719,7 +1729,7 @@
17191729 \fR
17201730 .in 20
17211731 Hint for image type.
1722-\'
1732+
17231733 .in 15
17241734 .in 15
17251735 .B "webp:target-size=<integer>"
@@ -1727,7 +1737,7 @@
17271737 \fR
17281738 .in 20
17291739 Target size in bytes.
1730-\'
1740+
17311741 .in 15
17321742 .in 15
17331743 .B "webp:target-psnr=<float>"
@@ -1735,7 +1745,7 @@
17351745 \fR
17361746 .in 20
17371747 Minimal distortion to try to achieve.
1738-\'
1748+
17391749 .in 15
17401750 .in 15
17411751 .B "webp:segments={1-4}"
@@ -1743,7 +1753,7 @@
17431753 \fR
17441754 .in 20
17451755 Maximum number of segments to use.
1746-\'
1756+
17471757 .in 15
17481758 .in 15
17491759 .B "webp:sns-strength={0-100}"
@@ -1751,7 +1761,7 @@
17511761 \fR
17521762 .in 20
17531763 Spatial Noise Shaping.
1754-\'
1764+
17551765 .in 15
17561766 .in 15
17571767 .B "webp:filter-strength={0-100}"
@@ -1759,7 +1769,7 @@
17591769 \fR
17601770 .in 20
17611771 Filter strength.
1762-\'
1772+
17631773 .in 15
17641774 .in 15
17651775 .B "webp:filter-sharpness={0-7}"
@@ -1767,7 +1777,7 @@
17671777 \fR
17681778 .in 20
17691779 Filter sharpness.
1770-\'
1780+
17711781 .in 15
17721782 .in 15
17731783 .B "webp:filter-type={0,1}"
@@ -1776,7 +1786,7 @@
17761786 .in 20
17771787 Filtering type. 0 = simple, 1 = strong (only used if
17781788 filter-strength > 0 or autofilter is enabled).
1779-\'
1789+
17801790 .in 15
17811791 .in 15
17821792 .B "webp:auto-filter={true|false}"
@@ -1784,7 +1794,7 @@
17841794 \fR
17851795 .in 20
17861796 Auto adjust filter's strength.
1787-\'
1797+
17881798 .in 15
17891799 .in 15
17901800 .B "webp:alpha-compression=<integer>"
@@ -1793,7 +1803,7 @@
17931803 .in 20
17941804 Algorithm for encoding the alpha plane (0 = none, 1 = compressed
17951805 with WebP lossless). Default is 1.
1796-\'
1806+
17971807 .in 15
17981808 .in 15
17991809 .B "webp:alpha-filtering=<integer>"
@@ -1802,7 +1812,7 @@
18021812 .in 20
18031813 Predictive filtering method for alpha plane. 0: none, 1: fast, 2:
18041814 best. Default is 1.
1805-\'
1815+
18061816 .in 15
18071817 .in 15
18081818 .B "webp:alpha-quality={0-100}"
@@ -1810,7 +1820,7 @@
18101820 \fR
18111821 .in 20
18121822 Between 0 (smallest size) and 100 (lossless). Default is 100.
1813-\'
1823+
18141824 .in 15
18151825 .in 15
18161826 .B "webp:pass=[1..10]"
@@ -1818,7 +1828,7 @@
18181828 \fR
18191829 .in 20
18201830 Number of entropy-analysis passes.
1821-\'
1831+
18221832 .in 15
18231833 .in 15
18241834 .B "webp:show-compressed={true|false}"
@@ -1827,7 +1837,7 @@
18271837 .in 20
18281838 Export the compressed picture back. In-loop filtering is not
18291839 applied.
1830-\'
1840+
18311841 .in 15
18321842 .in 15
18331843 .B "webp:preprocessing=[0,1,2]"
@@ -1835,7 +1845,7 @@
18351845 \fR
18361846 .in 20
18371847 0=none, 1=segment-smooth, 2=pseudo-random dithering
1838-\'
1848+
18391849 .in 15
18401850 .in 15
18411851 .B "webp:partitions=[0-3]"
@@ -1844,7 +1854,7 @@
18441854 .in 20
18451855 log2(number of token partitions) in [0..3]. Default is 0 for
18461856 easier progressive decoding.
1847-\'
1857+
18481858 .in 15
18491859 .in 15
18501860 .B "webp:partition-limit={0-100}"
@@ -1854,7 +1864,7 @@
18541864 Quality degradation allowed to fit the 512k limit on prediction
18551865 modes coding (0: no degradation, 100: maximum possible
18561866 degradation).
1857-\'
1867+
18581868 .in 15
18591869 .in 15
18601870 .B "webp:emulate-jpeg-size={true|false}"
@@ -1864,7 +1874,7 @@
18641874 If true, compression parameters will be remapped to better match
18651875 the expected output size from JPEG compression. Generally, the output
18661876 size will be similar but the degradation will be lower.
1867-\'
1877+
18681878 .in 15
18691879 .in 15
18701880 .B "webp:thread-level=<integer>"
@@ -1872,7 +1882,7 @@
18721882 \fR
18731883 .in 20
18741884 If non-zero, try and use multi-threaded encoding.
1875-\'
1885+
18761886 .in 15
18771887 .in 15
18781888 .B "webp:low-memory={true|false}"
@@ -1880,7 +1890,7 @@
18801890 \fR
18811891 .in 20
18821892 If set, reduce memory usage (but increase CPU use)
1883-\'
1893+
18841894 .in 15
18851895 .in 15
18861896 .B "webp:use-sharp-yuv={true|false}"
@@ -1888,25 +1898,26 @@
18881898 \fR
18891899 .in 20
18901900 If set, if needed, use sharp (and slow) RGB->YUV conversion
1891-\'
1892-.in 15
1893-\'
1894-\'
1895-\'
1901+
1902+.in 15
1903+
1904+
1905+
18961906 For example, to create a postscript file that will render only the black
18971907 pixels of a bilevel image, use:
1898-\'
1908+
1909+.nf
18991910 gm convert bilevel.tif -define ps:imagemask eps3:stencil.ps
1900-\'
1911+.fi
19011912 .TP
19021913 .B "-delay \fI<1/100ths of a second>"\fP
19031914 \fRdisplay the next image after pausing
1904-\'
1915+
19051916 This option is useful for regulating the animation of image sequences
19061917 \fIDelay/100\fP seconds must expire before the display
19071918 of the next image. The default is no delay between each showing of the
19081919 image sequence. The maximum delay is 65535.
1909-\'
1920+
19101921 You can specify a delay range (e.g. \fI-delay 10-500\fP) which sets the
19111922 minimum and maximum delay.
19121923 .TP
@@ -1940,7 +1951,7 @@
19401951 .TP
19411952 .B "-depth \fI<value>"\fP
19421953 \fRdepth of the image
1943-\'
1954+
19441955 This is the number of bits of color to preserve in the image. Any value
19451956 between 1 and \fBQuantumDepth\fP (build option) may be specified,
19461957 although 8 or 16 are the most common values. Use this option to specify
@@ -1960,7 +1971,7 @@
19601971 .TP
19611972 .B "-displace \fI<horizontal scale>x<vertical scale>"\fP
19621973 \fRshift image pixels as defined by a displacement map
1963-\'
1974+
19641975 With this option, \fIcomposite image\fP is used as a displacement map. Black,
19651976 within the displacement map, is a maximum positive displacement. White is a
19661977 maximum negative displacement and middle gray is neutral. The displacement
@@ -1971,18 +1982,19 @@
19711982 .TP
19721983 .B "-display \fI<host:display[.screen]>"\fP
19731984 \fRspecifies the X server to contact
1974-\'
1985+
19751986 This option is used with convert for
19761987 obtaining image or font from this X server. See \fIX(1)\fP.
19771988 .TP
19781989 .B "-dispose \fI<method>"\fP
19791990 \fRGIF disposal method
1980-\'
1991+
19811992 The Disposal Method indicates the way in which the graphic is to
19821993 be treated after being displayed.
1983-\'
1994+
19841995 Here are the valid methods:
1985-\'
1996+
1997+.nf
19861998 Undefined No disposal specified.
19871999 None Do not dispose between frames.
19882000 Background Overwrite the image area with
@@ -1990,36 +2002,37 @@
19902002 Previous Overwrite the image area with
19912003 what was there prior to rendering
19922004 the image.
1993-\'
2005+.fi
19942006 .TP
19952007 .B "-dissolve \fI<percent>"\fP
19962008 \fRdissolve an image into another by the given percent
1997-\'
2009+
19982010 The opacity of the composite image is multiplied by the given percent,
19992011 then it is composited over the main image.
20002012 .TP
20012013 .B "-dither"
20022014 \fRapply Floyd/Steinberg error diffusion to the image
2003-\'
2015+
20042016 The basic strategy of dithering is to trade intensity resolution for spatial
20052017 resolution by averaging the intensities of several neighboring pixels.
20062018 Images which suffer from severe contouring when reducing colors can be
20072019 improved with this option.
2008-\'
2020+
20092021 The \fB-colors\fP or \fB-monochrome\fP option is required for this option
20102022 to take effect.
2011-\'
2023+
20122024 Use \fB+dither\fP to turn off dithering and to render PostScript
20132025 without text or graphic aliasing. Disabling dithering often (but not
20142026 always) leads to decreased processing time.
20152027 .TP
20162028 .B "-draw \fI<string>"\fP
20172029 \fRannotate an image with one or more graphic primitives
2018-\'
2030+
20192031 Use this option to annotate an image with one or more graphic primitives.
20202032 The primitives include shapes, text, transformations,
20212033 and pixel operations. The shape primitives are
2022-\'
2034+
2035+.nf
20232036 point x,y
20242037 line x0,y0 x1,y1
20252038 rectangle x0,y0 x1,y1
@@ -2032,74 +2045,79 @@
20322045 Bezier x0,y0 ... xn,yn
20332046 path path specification
20342047 image operator x0,y0 w,h filename
2035-\'
2036-\'
2048+.fi
2049+
20372050 The text primitive is
2038-\'
2051+
2052+.nf
20392053 text x0,y0 string
2040-\'
2041-\'
2054+.fi
2055+
20422056 The text gravity primitive is
2043-\'
2057+
2058+.nf
20442059 gravity NorthWest, North, NorthEast, West, Center,
20452060 East, SouthWest, South, or SouthEast
2046-\'
2047-\'
2061+.fi
2062+
20482063 The text gravity primitive only affects the placement of text and
20492064 does not interact with the other primitives. It is equivalent to
20502065 using the \fB-gravity\fP commandline option, except that it is
20512066 limited in scope to the \fB-draw\fP option in which it appears.
2052-\'
2067+
20532068 The transformation primitives are
2054-\'
2069+
2070+.nf
20552071 rotate degrees
20562072 translate dx,dy
20572073 scale sx,sy
20582074 skewX degrees
20592075 skewY degrees
2060-\'
2061-\'
2076+.fi
2077+
20622078 The pixel operation primitives are
2063-\'
2079+
2080+.nf
20642081 color x0,y0 method
20652082 matte x0,y0 method
2066-\'
2067-\'
2083+.fi
2084+
20682085 The shape primitives are drawn in the color specified in the preceding
20692086 \fB-stroke\fP option. Except for the \fBline\fP and \fBpoint\fP
20702087 primitives, they are filled with the color specified in the preceding
20712088 \fB-fill\fP option. For unfilled shapes, use -fill none.
2072-\'
2089+
20732090 \fBPoint\fP requires a single coordinate.
2074-\'
2091+
20752092 \fBLine\fP requires a start and end coordinate.
2076-\'
2093+
20772094 \fBRectangle\fP
20782095 expects an upper left and lower right coordinate.
2079-\'
2096+
20802097 \fBRoundRectangle\fP has the upper left and lower right coordinates
20812098 and the width and height of the corners.
2082-\'
2099+
20832100 \fBCircle\fP has a center coordinate and a coordinate for
20842101 the outer edge.
2085-\'
2102+
20862103 Use \fBArc\fP to inscribe an elliptical arc within
20872104 a rectangle. Arcs require a start and end point as well as the degree
20882105 of rotation (e.g. 130,30 200,100 45,90).
2089-\'
2106+
20902107 Use \fBEllipse\fP to draw a partial ellipse
20912108 centered at the given point with the x-axis and y-axis radius
20922109 and start and end of arc in degrees (e.g. 100,100 100,150 0,360).
2093-\'
2110+
20942111 Finally, \fBpolyline\fP and \fBpolygon\fP require
20952112 three or more coordinates to define its boundaries.
20962113 Coordinates are integers separated by an optional comma. For example,
20972114 to define a circle centered at 100,100
20982115 that extends to 150,150 use:
2099-\'
2116+
2117+.nf
21002118 -draw 'circle 100,100 150,150'
2101-\'
2102-\'
2119+.fi
2120+
21032121 \fBPaths\fP
21042122 (See Paths)
21052123 represent an outline of an object which is defined in terms of
@@ -2110,52 +2128,54 @@
21102128 subpaths, each consisting of a single moveto followed by one or more
21112129 line or curve operations) are possible to allow effects such as
21122130 "donut holes" in objects.
2113-\'
2131+
21142132 Use \fBimage\fP to composite an image with another image. Follow the
21152133 image keyword with the composite operator, image location, image size,
21162134 and filename:
2117-\'
2135+
2136+.nf
21182137 -draw 'image Over 100,100 225,225 image.jpg'
2119-\'
2120-\'
2138+.fi
2139+
21212140 You can use 0,0 for the image size, which means to use the actual
21222141 dimensions found in the image header. Otherwise, it will
21232142 be scaled to the given dimensions.
21242143 See \fB-compose\fP for a description of the composite operators.
2125-\'
2144+
21262145 Use \fBtext\fP to annotate an image with text. Follow the text
21272146 coordinates with a string. If the string has embedded spaces, enclose it
21282147 in single or double quotes. Optionally you can include the image
21292148 filename, type, width, height, or other image attribute by embedding
21302149 special format character. See \fB-comment\fP for details.
2131-\'
2150+
21322151 For example,
2133-\'
2134-\'
2152+
2153+
2154+.nf
21352155 -draw 'text 100,100 "%m:%f %wx%h"'
2136-\'
2137-\'
2156+
2157+
21382158 annotates the image with MIFF:bird.miff 512x480 for an image titled
21392159 bird.miff
21402160 and whose width is 512 and height is 480.
2141-\'
2161+
21422162 If the first character of \fIstring\fP is \fI@\fP, the text is read
21432163 from a file titled by the remaining characters in the string. Please
21442164 note that if the string comes from an untrusted source that it should
21452165 be sanitized before use (a security risk).
2146-\'
2166+
21472167 \fBRotate\fP rotates subsequent shape primitives and text primitives about
21482168 the origin of the main image. If the \fB-region\fP option precedes the
21492169 \fB-draw\fP option, the origin for transformations is the upper left
21502170 corner of the region.
2151-\'
2171+
21522172 \fBTranslate\fP translates them.
2153-\'
2173+
21542174 \fBScale\fP scales them.
2155-\'
2175+
21562176 \fBSkewX\fP and \fBSkewY\fP skew them with respect to the origin of
21572177 the main image or the region.
2158-\'
2178+
21592179 The transformations modify the current affine matrix, which is initialized
21602180 from the initial affine matrix defined by the \fB-affine\fP option.
21612181 Transformations are cumulative within the \fB-draw\fP option.
@@ -2163,18 +2183,19 @@
21632183 appearance of another \fB-affine\fP option. If another \fB-draw\fP
21642184 option appears, the current affine matrix is reinitialized from
21652185 the initial affine matrix.
2166-\'
2186+
21672187 Use \fBcolor\fP to change the color of a pixel to the fill color (see
21682188 \fB-fill\fP). Follow the pixel coordinate
21692189 with a method:
2170-\'
2190+
2191+.nf
21712192 point
21722193 replace
21732194 floodfill
21742195 filltoborder
21752196 reset
2176-\'
2177-\'
2197+.fi
2198+
21782199 Consider the target pixel as that specified by your coordinate. The
21792200 \fBpoint\fP
21802201 method recolors the target pixel. The \fBreplace\fP method recolors any
@@ -2183,7 +2204,7 @@
21832204 any pixel that matches the color of the target pixel and is a neighbor,
21842205 whereas \fBfilltoborder\fP recolors any neighbor pixel that is not the
21852206 border color. Finally, \fBreset\fP recolors all pixels.
2186-\'
2207+
21872208 Use \fBmatte\fP to the change the pixel matte value to transparent. Follow
21882209 the pixel coordinate with a method (see the \fBcolor\fP primitive for
21892210 a description of methods). The \fBpoint\fP method changes the matte value
@@ -2194,7 +2215,7 @@
21942215 \fBfilltoborder\fP changes the matte
21952216 value of any neighbor pixel that is not the border color (\fB-bordercolor\fP).
21962217 Finally \fBreset\fP changes the matte value of all pixels.
2197-\'
2218+
21982219 You can set the primitive color, font, and font bounding box
21992220 color with
22002221 \fB-fill\fP, \fB-font\fP, and \fB-box\fP respectively. Options
@@ -2209,19 +2230,19 @@
22092230 .TP
22102231 .B "-encoding \fI<type>"\fP
22112232 \fRspecify the text encoding
2212-\'
2233+
22132234 Choose from \fIAdobeCustom, AdobeExpert, AdobeStandard, AppleRoman,
22142235 BIG5, GB2312, Latin 2, None, SJIScode, Symbol, Unicode, Wansung.\fP
22152236 .TP
22162237 .B "-endian \fI<type>"\fP
22172238 \fRspecify endianness (MSB, LSB, or Native) of image
2218-\'
2239+
22192240 \fIMSB\fP indicates big-endian (e.g. SPARC, Motorola 68K) while
22202241 \fILSB\fP indicates little-endian (e.g. Intel 'x86, VAX) byte
22212242 ordering. \fINative\fP indicates to use the normal ordering for the
22222243 current CPU. This option currently only influences the CMYK, DPX,
22232244 GRAY, RGB, and TIFF, formats.
2224-\'
2245+
22252246 Use \fB+endian\fP to revert to unspecified endianness.
22262247 .TP
22272248 .B "-enhance"
@@ -2232,7 +2253,7 @@
22322253 .TP
22332254 .B "-extent \fI<width>x<height>{+-}<x>{+-}<y>"\fP
22342255 \fRcomposite image on background color canvas image
2235-\'
2256+
22362257 This option composites the image on a new background color
22372258 (\fB-background\fP) canvas image of size <width>x<height>. The
22382259 existing image content is composited at the position specified by
@@ -2240,31 +2261,33 @@
22402261 the current image compose (\fB-compose\fP) method. Image content
22412262 which falls outside the bounds of the new image dimensions is
22422263 discarded.
2243-\'
2264+
22442265 For example, this command creates a thumbnail of an image, and centers
22452266 it on a red color backdrop image, offsetting the canvas ten pixels to
22462267 the left and five pixels up, with respect to the thumbnail:
2247-\'
2268+
2269+.nf
22482270 gm convert infile.jpg -thumbnail 120x80 -background red -gravity center \\
22492271 -extent 140x100-10-5 outfile.jpg
2250-\'
2251-\'
2272+.fi
2273+
22522274 This command reduces or expands a JPEG image to fit on an 800x600
22532275 display:
2254-\'
2276+
2277+.nf
22552278 gm convert -size 800x600 input.jpg \\
22562279 -resize 800x600 -background black \\
22572280 -compose Copy -gravity center \\
22582281 -extent 800x600 \\
22592282 -quality 92 output.jpg
2260-\'
2261-\'
2283+.fi
2284+
22622285 If the aspect ratio of the input image isn't exactly 4:3, then the
22632286 image is centered on an 800x600 black canvas.
22642287 .TP
22652288 .B "-file \fI<filename>"\fP
22662289 \fRwrite annotated difference image to file
2267-\'
2290+
22682291 If \fB-file\fP is specified, then an annotated difference image is
22692292 generated and written to the specified file. Pixels which differ between
22702293 the \fBreference\fP and \fBcompare\fP images are modified from those in
@@ -2275,9 +2298,10 @@
22752298 .TP
22762299 .B "-fill \fI<color>"\fP
22772300 \fRcolor to use when filling a graphic primitive
2278-\'
2301+
22792302 Colors are represented in GraphicsMagick in the same form used by SVG. Use "gm convert -list color" to list named colors:
2280-\'
2303+
2304+.nf
22812305 name (named color)
22822306 #RGB (hex numbers, 4 bits each)
22832307 #RRGGBB (8 bits each)
@@ -2289,31 +2313,33 @@
22892313 #RRRRGGGGBBBBAAAA (16 bits each)
22902314 rgb(r,g,b) (r,g,b are decimal numbers)
22912315 rgba(r,g,b,a) (r,g,b,a are decimal numbers)
2292-\'
2293-\'
2316+.fi
2317+
22942318 Enclose the color specification in quotation marks to prevent the "#"
22952319 or the parentheses from being interpreted by your shell.
2296-\'
2320+
22972321 For example,
2298-\'
2322+
2323+.nf
22992324 gm convert -fill blue ...
23002325 gm convert -fill "#ddddff" ...
23012326 gm convert -fill "rgb(65000,65000,65535)" ...
2302-\'
2303-\'
2327+.fi
2328+
23042329 The shorter forms are scaled up, if necessary by replication. For example,
23052330 #3af, #33aaff, and #3333aaaaffff are all equivalent.
2306-\'
2331+
23072332 See \fB-draw\fP for further details.
23082333 .TP
23092334 .B "-filter \fI<type>"\fP
23102335 \fRuse this type of filter when resizing an image
2311-\'
2336+
23122337 Use this option to affect the resizing operation of an image (see
23132338 \fB-geometry\fP).
23142339 Choose from these filters (ordered by approximate increasing CPU
23152340 time):
2316-\'
2341+
2342+.nf
23172343 Point
23182344 Box
23192345 Triangle
@@ -2329,8 +2355,8 @@
23292355 Lanczos
23302356 Bessel
23312357 Sinc
2332-\'
2333-\'
2358+.fi
2359+
23342360 The default filter is automatically selected to provide the best quality
23352361 while consuming a reasonable amount of time. The \fBMitchell\fP filter
23362362 is used if the image supports a palette, supports a matte channel, or is
@@ -2338,7 +2364,7 @@
23382364 .TP
23392365 .B "-flatten"
23402366 \fRflatten a sequence of images
2341-\'
2367+
23422368 In some file formats (e.g. Photoshop's PSD) complex images may be
23432369 represented by "layers" (independent images) which must be composited
23442370 in order to obtain the final rendition. The \fB-flatten\fP option
@@ -2347,57 +2373,59 @@
23472373 respecting composition operators and page offsets. While
23482374 \fB-flatten\fP is immediately useful for eliminating layers, it is
23492375 also useful as a general-purpose composition tool.
2350-\'
2376+
23512377 The sequence of images is terminated by the appearance of any option.
23522378 If the \fB-flatten\fP option appears after all of the input images,
23532379 all images are flattened. Also see \fB-mosaic\fP which is similar to
23542380 \fB-flatten\fP except that it adds a suitably-sized canvas base
23552381 image.
2356-\'
2382+
23572383 For example, this composites an image on top of a 640x400 transparent
23582384 black canvas image:
2359-\'
2385+
2386+.nf
23602387 gm convert -size 640x300 xc:transparent \\
23612388 -compose over -page +0-100 \\
23622389 frame.png -flatten output.png
2363-\'
2364-\'
2390+.fi
2391+
23652392 and this flattens a Photoshop PSD file:
2366-\'
2393+
2394+.nf
23672395 gm convert input.psd -flatten output.png
2368-\'
2396+.fi
23692397 .TP
23702398 .B "-flip"
23712399 \fRcreate a "mirror image"
2372-\'
2400+
23732401 reflect the scanlines in the vertical direction.
23742402 .TP
23752403 .B "-flop"
23762404 \fRcreate a "mirror image"
2377-\'
2405+
23782406 reflect the scanlines in the horizontal direction.
23792407 .TP
23802408 .B "-font \fI<name>"\fP
23812409 \fRuse this font when annotating the image with text
2382-\'
2410+
23832411 You can tag a font to specify whether it is a PostScript, TrueType, or X11
23842412 font. For example, Arial.ttf is a TrueType font, ps:helvetica
23852413 is PostScript, and x:fixed is X11.
23862414 .TP
23872415 .B "-foreground \fI<color>"\fP
23882416 \fRdefine the foreground color
2389-\'
2417+
23902418 The color is specified using the format described under the \fB-fill\fP
23912419 option.
23922420 .TP
23932421 .B "-format \fI<type>"\fP
23942422 \fRthe image format type
2395-\'
2423+
23962424 When used with the \fBmogrify\fP utility,
23972425 this option will convert any image to the image format you specify.
23982426 See \fIGraphicsMagick(1)\fP for a list of image format types supported by
23992427 \fBGraphicsMagick\fP, or see the output of 'gm -list format'.
2400-\'
2428+
24012429 By default the file is written to its original name. However, if the
24022430 filename extension matches a supported format, the extension is replaced
24032431 with the image format type specified with \fB-format\fP. For example,
@@ -2407,14 +2435,15 @@
24072435 .TP
24082436 .B "-format \fI<string>"\fP
24092437 \fRoutput formatted image characteristics
2410-\'
2438+
24112439 When used with the \fBidentify\fP utility, or the \fBconvert\fP
24122440 utility with output written to the 'info:-' file specification, use
24132441 this option to print information about the image in a format of your
24142442 choosing. You can include the image filename, type, width, height,
24152443 Exif data, or other image attributes by embedding special format
24162444 characters:
2417-\'
2445+
2446+.nf
24182447 %b file size
24192448 %c comment
24202449 %d directory
@@ -2456,24 +2485,26 @@
24562485 \\n newline
24572486 \\r carriage return
24582487 %% %
2459-\'
2460-\'
2488+.fi
2489+
24612490 For example,
2462-\'
2491+
2492+.nf
24632493 -format "%m:%f %wx%h"
2464-\'
2465-\'
2494+.fi
2495+
24662496 displays \fBMIFF:bird.miff 512x480\fP for an image
24672497 titled \fBbird.miff\fP and whose width is 512 and height is 480.
2468-\'
2498+
24692499 If the first character of \fIstring\fP is \fB@\fP, the format is
24702500 read from a file titled by the remaining characters in the string.
24712501 Please note that if the string comes from an untrusted source that it
24722502 should be sanitized before use since this may be used to incorporate
24732503 any readable file on the system (a security risk).
2474-\'
2504+
24752505 The values of image type (\fB%r\fP) which may be returned include:
2476-\'
2506+
2507+.nf
24772508 Bilevel
24782509 Grayscale
24792510 GrayscaleMatte
@@ -2484,16 +2515,18 @@
24842515 ColorSeparation
24852516 ColorSeparationMatte
24862517 Optimize
2487-\'
2488-\'
2518+.fi
2519+
24892520 You can also use the following special formatting syntax to print Exif
24902521 information contained in the file:
2491-\'
2522+
2523+.nf
24922524 %[EXIF:<tag>]
2493-\'
2494-\'
2525+.fi
2526+
24952527 Where "<tag>" may be one of the following:
2496-\'
2528+
2529+.nf
24972530 * (print all Exif tags, in keyword=data format)
24982531 ! (print all Exif tags, in tag_number format)
24992532 #hhhh (print data for Exif tag #hhhh)
@@ -2579,39 +2612,41 @@
25792612 SensingMethod
25802613 FileSource
25812614 SceneType
2582-\'
2583-\'
2615+.fi
2616+
25842617 JPEG specific information (from reading a JPEG file) may be obtained
25852618 like this:
2586-\'
2619+
2620+.nf
25872621 %[JPEG-<tag>]
2588-\'
2589-\'
2622+.fi
2623+
25902624 Where "<tag>" may be one of the following:
2591-\'
2625+
2626+.nf
25922627 * (all JPEG-related tags, in
25932628 keyword=data format)
25942629 Quality IJG JPEG "quality" estimate
25952630 Colorspace JPEG colorspace numeric ID
25962631 Colorspace-Name JPEG colorspace name
25972632 Sampling-factors JPEG sampling factors
2598-\'
2599-\'
2633+.fi
2634+
26002635 Please note that JPEG has no notion of "quality" and that the quality
26012636 metric used by, and estimated by the software is based on the quality
26022637 metric established by IJG JPEG 6b. Other encoders (e.g. that used by
26032638 Adobe Photoshop) use different encoding metrics.
2604-\'
2639+
26052640 Surround the format specification with quotation marks to prevent your shell
26062641 from misinterpreting any spaces and square brackets.
26072642 .TP
26082643 .B "-frame \fI<width>x<height>+<outer bevel width>+<inner bevel width>"\fP
26092644 \fRsurround the image with an ornamental border
2610-\'
2645+
26112646 See \fB-geometry\fP for details about the geometry
26122647 specification. The \fB-frame\fP option is not affected by the
26132648 \fB-gravity\fP option.
2614-\'
2649+
26152650 The color of the border is specified with the \fB-mattecolor\fP
26162651 command line option.
26172652 .TP
@@ -2620,7 +2655,7 @@
26202655 .TP
26212656 .B "-fuzz \fI<distance>{%}"\fP
26222657 \fRcolors within this Euclidean distance are considered equal
2623-\'
2658+
26242659 A number of algorithms search for a target color. By default the color
26252660 must be exact. Use this option to match colors that are close (in
26262661 Euclidean distance) to the target color in RGB 3D space. For example,
@@ -2628,14 +2663,14 @@
26282663 \fB-trim\fP but the image was scanned and the target background color
26292664 may differ by a small amount. This option can account for these
26302665 differences.
2631-\'
2666+
26322667 The \fIdistance\fP can be in absolute intensity units or, by appending
26332668 \fI"%"\fP, as a percentage of the maximum possible intensity (255,
26342669 65535, or 4294967295).
26352670 .TP
26362671 .B "-gamma \fI<value>"\fP
26372672 \fRlevel of gamma correction
2638-\'
2673+
26392674 The same color image displayed on two different workstations may look
26402675 different due to differences in the display monitor. Use gamma
26412676 correction to adjust for this color difference. Reasonable values extend
@@ -2643,11 +2678,11 @@
26432678 gamma greater than 1.0 lightens it. Large adjustments to image gamma may
26442679 result in the loss of some image information if the pixel quantum size
26452680 is only eight bits (quantum range 0 to 255).
2646-\'
2681+
26472682 You can apply separate gamma values to the red, green, and blue channels
26482683 of the image with a gamma value list delimited with slashes
26492684 (e.g., \fB1.7\fP/\fB2.3\fP/\fB1.2\fP).
2650-\'
2685+
26512686 Use \fB+gamma\fP \fIvalue\fP
26522687 to set the image gamma level without actually adjusting
26532688 the image pixels. This option is useful if the image is of a known gamma
@@ -2655,15 +2690,15 @@
26552690 .TP
26562691 .B "-gaussian \fI<radius>{x<sigma>}"\fP
26572692 \fRblur the image with a Gaussian operator
2658-\'
2693+
26592694 Use the given radius and standard deviation (sigma).
26602695 .TP
26612696 .B "-geometry \fI<width>x<height>{+-}<x>{+-}<y>{%}{@}{!}{^}{<}{>}"\fP
26622697 \fRSpecify dimension, offset, and resize options.
2663-\'
2698+
26642699 The \fB-geometry\fP option is used for a number of different
26652700 purposes, depending on the utility it is used with.
2666-\'
2701+
26672702 For the X11 commands ('animate', 'display', and 'import'), it
26682703 specifies the preferred size and location of the Image window. By
26692704 default, the window size is the image size and the location is chosen
@@ -2672,25 +2707,25 @@
26722707 used to specify the desired size when resizing an image. In this
26732708 case, symbols representing resize options may be appended to the
26742709 geometry string to influence how the resize request is treated.
2675-\'
2710+
26762711 See later notes corresponding to usage by particular commands. The
26772712 following notes apply to when \fB-geometry\fP is used to express a
26782713 resize request, taking into account the current properties of the
26792714 image.
2680-\'
2715+
26812716 By default, the width and height are maximum values. That is, the
26822717 image is expanded or contracted to fit the width and height value
26832718 while maintaining the aspect ratio of the image.
2684-\'
2719+
26852720 Append a ^ to the geometry so that the image aspect ratio is
26862721 maintained when the image is resized, but the resulting width or
26872722 height are treated as minimum values rather than maximum values.
2688-\'
2723+
26892724 Append a ! (exclamation point) to the geometry to force the image size to
26902725 exactly the size you specify. For example, if you specify
26912726 640x480! the image width is set to 640 pixels and height to
26922727 480.
2693-\'
2728+
26942729 If only the width is specified, without the trailing 'x', then height
26952730 is set to width (e.g., -geometry 100 is the same as
26962731 -geometry 100x100). If only the width is specified but with
@@ -2698,15 +2733,15 @@
26982733 chosen to maintain the aspect ratio of the image. Similarly, if only
26992734 the height is specified prefixed by 'x' (e.g., -geometry
27002735 x256), the width is chosen to maintain the aspect ratio.
2701-\'
2736+
27022737 To specify a percentage width or height instead, append %. The image size
27032738 is multiplied by the width and height percentages to obtain the final image
27042739 dimensions. To increase the size of an image, use a value greater than
27052740 100 (e.g. 125%). To decrease an image's size, use a percentage less than
27062741 100.
2707-\'
2742+
27082743 Use @ to specify the maximum area in pixels of an image.
2709-\'
2744+
27102745 Use > to change the dimensions of the image \fIonly\fP if
27112746 its width or height exceeds the geometry specification. < resizes
27122747 the image \fIonly\fP if both of its dimensions are less than the geometry
@@ -2716,7 +2751,7 @@
27162751 resized to 480x480. Enclose the geometry specification in quotation marks to
27172752 prevent the < or > from being interpreted by your shell
27182753 as a file redirection.
2719-\'
2754+
27202755 When used with \fIanimate\fP and \fIdisplay\fP, offsets are handled in
27212756 the same manner as in \fIX(1)\fP and the \fB-gravity\fP option is not used.
27222757 If the \fIx\fP is negative, the offset is measured leftward
@@ -2724,7 +2759,7 @@
27242759 screen to the right edge of the image being displayed.
27252760 Similarly, negative \fIy\fP is measured between the bottom edges. The
27262761 offsets are not affected by "%"; they are always measured in pixels.
2727-\'
2762+
27282763 When used as a \fIcomposite\fP option, \fB-geometry\fP
27292764 gives the dimensions of the image and its location with respect
27302765 to the composite image. If the \fB-gravity\fP option is present
@@ -2737,11 +2772,11 @@
27372772 offsets are not affected by "%"; they are always measured in pixels.
27382773 To specify the dimensions of the composite image, use the \fB-resize\fP
27392774 option.
2740-\'
2775+
27412776 When used as a \fIconvert\fP, \fIimport\fP or \fImogrify\fP option,
27422777 \fB-geometry\fP is synonymous with \fB-resize\fP and
27432778 specifies the size of the output image. The offsets, if present, are ignored.
2744-\'
2779+
27452780 When used as a \fImontage\fP option, \fB-geometry\fP specifies the image
27462781 size and border size for each tile; default is 256x256+0+0. Negative
27472782 offsets (border dimensions) are meaningless. The \fB-gravity\fP
@@ -2754,27 +2789,27 @@
27542789 .TP
27552790 .B "-gravity \fI<type>"\fP
27562791 \fRdirection primitive gravitates to when annotating the image.
2757-\'
2792+
27582793 Choices are: NorthWest, North,
27592794 NorthEast, West, Center, East, SouthWest, South, SouthEast.
2760-\'
2795+
27612796 The direction you choose specifies where to position the text
27622797 when annotating
27632798 the image. For example \fICenter\fP gravity forces the text to be centered
27642799 within the image. By default, the image gravity is \fINorthWest\fP.
27652800 See \fB-draw\fP for more details about graphic primitives. Only the
27662801 text primitive is affected by the \fB-gravity\fP option.
2767-\'
2802+
27682803 The \fB-gravity\fP option is also used in concert with the \fB-geometry\fP
27692804 option and other options that take \fB<geometry>\fP as a parameter, such
27702805 as the \fB-crop\fP option. See \fB-geometry\fP for details of how the
27712806 \fB-gravity\fP option interacts with the
27722807 \fB<x>\fP and \fB<y>\fP parameters of a geometry
27732808 specification.
2774-\'
2809+
27752810 When used as an option to \fIcomposite\fP, \fB-gravity\fP
27762811 gives the direction that the image gravitates within the composite.
2777-\'
2812+
27782813 When used as an option to \fImontage\fP, \fB-gravity\fP gives the direction
27792814 that an image gravitates within a tile. The default gravity is \fICenter\fP
27802815 for this purpose.
@@ -2784,7 +2819,7 @@
27842819 .TP
27852820 .B "-hald-clut \fI<clut>"\fP
27862821 \fRapply a Hald CLUT to the image
2787-\'
2822+
27882823 A Hald CLUT ("Color Look-Up Table") is a special square color image
27892824 which contains a look-up table for red, green, and blue. The size of
27902825 the Hald CLUT image is determined by its order. The width (and
@@ -2795,7 +2830,7 @@
27952830 Hald CLUT, one takes an identity CLUT and adjusts its colors in some
27962831 way. The modified CLUT can then be used to transform any number of
27972832 images in an identical way.
2798-\'
2833+
27992834 GraphicsMagick contains a built-in identity CLUT generator via the
28002835 \fBIDENTITY\fP coder. For example reading from the file name
28012836 \fPIDENTITY:8\fP returns an identity CLUT of order 8. Typical Hald
@@ -2810,12 +2845,12 @@
28102845 .TP
28112846 .B "-highlight-color \fI<color>"\fP
28122847 \fRpixel annotation color
2813-\'
2848+
28142849 Specifies the color to use when annotating difference pixels.
28152850 .TP
28162851 .B "-highlight-style \fI<style>"\fP
28172852 \fRpixel annotation style
2818-\'
2853+
28192854 Specifies the pixel difference annotation style used to draw attention to
28202855 changed pixels. May be one of \fBAssign\fP, \fBThreshold\fP,
28212856 \fBTint\fP, or \fBXOR\fP; where \fBAssign\fP replaces the pixel with
@@ -2826,7 +2861,7 @@
28262861 .TP
28272862 .B "-iconGeometry \fI<geometry>"\fP
28282863 \fRspecify the icon geometry
2829-\'
2864+
28302865 Offsets, if present in the geometry specification, are handled in
28312866 the same manner as the \fB-geometry\fP option, using X11 style to handle
28322867 negative offsets.
@@ -2842,40 +2877,40 @@
28422877 .TP
28432878 .B "-intent \fI<type>"\fP
28442879 \fRuse this type of rendering intent when managing the image color
2845-\'
2880+
28462881 Use this option to affect the the color management operation of an image (see
28472882 \fB-profile\fP).
28482883 Choose from these intents:
28492884 \fBAbsolute, Perceptual, Relative, Saturation\fP.
2850-\'
2885+
28512886 The default intent is undefined.
28522887 .TP
28532888 .B "-interlace \fI<type>"\fP
28542889 \fRthe type of interlacing scheme
2855-\'
2890+
28562891 Choices are: \fBNone, Line, Plane,\fP
28572892 or \fBPartition\fP. The default is \fBNone\fP.
2858-\'
2893+
28592894 This option is used to specify the type of interlacing scheme for raw image
28602895 formats such as \fBRGB\fP or \fBYUV\fP.
28612896 \fBNone\fP means do not interlace
28622897 (RGBRGBRGBRGBRGBRGB...),
2863-\'
2898+
28642899 \fBLine\fP uses scanline interlacing
28652900 (RRR...GGG...BBB...RRR...GGG...BBB...),
28662901 and
28672902 \fBPlane\fP uses plane interlacing (RRRRRR...GGGGGG...BBBBBB...).
2868-\'
2903+
28692904 \fBPartition\fP
28702905 is like plane except the different planes are saved to individual files
28712906 (e.g. image.R, image.G, and image.B).
2872-\'
2907+
28732908 Use \fBLine\fP to create an \fBinterlaced PNG\fP or \fB GIF\fP or
28742909 \fBprogressive JPEG\fP image.
28752910 .TP
28762911 .B "-label \fI<name>"\fP
28772912 \fRassign a label to an image
2878-\'
2913+
28792914 Use this option to assign a specific label to the image, when writing
28802915 to an image format that supports labels, such as TIFF, PNG, MIFF, or
28812916 PostScript. You can include the the image filename, type, width, height,
@@ -2884,42 +2919,43 @@
28842919 a "Label" tag or similar mechanism. If you want the
28852920 label to be visible on the image itself, use the \fB-draw\fP option.
28862921 See \fB-comment\fP for details.
2887-\'
2922+
28882923 For example,
2889-\'
2924+
2925+.nf
28902926 -label "%m:%f %wx%h"
2891-\'
2892-\'
2927+.fi
2928+
28932929 produces an image label of \fBMIFF:bird.miff 512x480\fP for an image titled
28942930 \fBbird.miff\fP
28952931 and whose width is 512 and height is 480.
2896-\'
2932+
28972933 If the first character of \fIstring\fP is \fI@\fP, the image label
28982934 is read from a file titled by the remaining characters in the string.
28992935 Please note that if the string comes from an untrusted source that it
29002936 should be sanitized before use since otherwise the content of an
29012937 arbitrary readable file might be incorporated into the image
29022938 label (a security risk).
2903-\'
2939+
29042940 If the -label option appears multiple times, only the last label is
29052941 stored.
2906-\'
2942+
29072943 In PNG images, the label is stored in a \fBtEXt\fP or \fBzTXt\fP chunk
29082944 with the keyword "label".
2909-\'
2945+
29102946 When converting to \fIPostScript\fP, use this option to specify a header
29112947 string to print above the image. Specify the label font with
29122948 \fB-font\fP.
2913-\'
2949+
29142950 When creating a montage, by default the label associated with an image
29152951 is displayed with the corresponding tile in the montage. Use the
29162952 \fB+label\fP option to suppress this behavior.
2917-\'
2918-\'
2953+
2954+
29192955 .TP
29202956 .B "-lat \fI<width>x<height>{+-}<offset>{%}"\fP
29212957 \fRperform local adaptive thresholding
2922-\'
2958+
29232959 Perform local adaptive thresholding using the specified width, height,
29242960 and offset. The offset is a distance in sample space from the mean,
29252961 as an absolute integer ranging from 0 to the maximum sample value or
@@ -2927,18 +2963,19 @@
29272963 is computed as a percentage of the quantum range. It is strongly
29282964 recommended to use the percent option so that results are not
29292965 sensitive to pixel quantum depth.
2930-\'
2966+
29312967 For example,
2932-\'
2968+
2969+.nf
29332970 -colorspace gray -lat "10x10-5%"
2934-\'
2935-\'
2971+.fi
2972+
29362973 will help clarify a scanned grayscale or color document, producing a
29372974 bi-level equivalent.
29382975 .TP
29392976 .B "-level \fI<black_point>{,<gamma>}{,<white_point>}{%}"\fP
29402977 \fRadjust the level of image contrast
2941-\'
2978+
29422979 Give one, two or three values delimited with commas: black-point, gamma,
29432980 white-point (e.g. 10,1.0,250 or 2%,0.5,98%). The black and white
29442981 points range from 0 to MaxRGB or from 0 to 100%; if the white point is
@@ -2951,7 +2988,7 @@
29512988 .TP
29522989 .B "-limit \fI<type> <value>"\fP
29532990 \fRDisk, File, Map, Memory, Pixels, Width, Height or Threads resource limit
2954-\'
2991+
29552992 By default, resource limits are estimated based on the available
29562993 resources of the system. The resource limits are \fBDisk\fP, maximum
29572994 total disk space consumed; \fBFile\fP, maximum number of file
@@ -2962,7 +2999,7 @@
29622999 maximum image pixels width; \fBHeight\fP, maximum image pixels
29633000 height; and \fBThreads\fP, the maximum number of worker threads to
29643001 use per OpenMP thread team.
2965-\'
3002+
29663003 These resource limits are used to decide if (for a given image) the
29673004 decoded image ("pixel cache") should be stored in heap memory (RAM),
29683005 in a memory-mapped disk file, or in a disk file accessed via
@@ -2972,7 +3009,7 @@
29723009 fail. The disk limit establishes an overall limit since using the disk
29733010 is the means of last resort. When the disk limit has been reached, no
29743011 more images may be read.
2975-\'
3012+
29763013 The value argument is an absolute value, but may have standard binary
29773014 suffix characters applied ('K', 'M', 'G', 'T', 'P', 'E') to apply a
29783015 scaling to the value (based on a multiplier of 1024). Any additional
@@ -2980,7 +3017,7 @@
29803017 the maximum image size to 10 megapixels and '-limit memory 32MB
29813018 -limit map 64MB' limits memory and memory mapped files to 32
29823019 megabytes and 64 megabytes respectively.
2983-\'
3020+
29843021 Resource limits may also be set using environment variables. The
29853022 environment variables \fBMAGICK_LIMIT_DISK\fP,
29863023 \fBMAGICK_LIMIT_FILES\fP, \fBMAGICK_LIMIT_MAP\fP,
@@ -2989,7 +3026,7 @@
29893026 \fBOMP_NUM_THREADS\fP may be used to set the limits for disk space,
29903027 open files, memory mapped size, heap memory, per-image pixels, image
29913028 width, image height, and threads respectively.
2992-\'
3029+
29933030 Use the option -list resource list the current limits.
29943031 .TP
29953032 .B "-linewidth"
@@ -2997,22 +3034,23 @@
29973034 .TP
29983035 .B "-list \fI<type>"\fP
29993036 \fRthe type of list
3000-\'
3037+
30013038 Choices are: \fBColor\fP, \fBDelegate\fP, \fBFormat\fP, \fBMagic\fP,
30023039 \fBModule\fP, \fBResource\fP, or \fBType\fP. The \fBModule\fP option
30033040 is only available if GraphicsMagick was built to support loadable modules.
3004-\'
3041+
30053042 This option lists information about the GraphicsMagick configuration.
30063043 .TP
30073044 .B "-log \fI<string>"\fP
30083045 \fRSpecify format for debug log
3009-\'
3046+
30103047 This option specifies the format for the log printed when the \fB-debug\fP
30113048 option is active.
3012-\'
3049+
30133050 You can display the following components by embedding
30143051 special format characters:
3015-\'
3052+
3053+.nf
30163054 %d domain
30173055 %e event
30183056 %f function
@@ -3025,41 +3063,42 @@
30253063 %% percent sign
30263064 \\n newline
30273065 \\r carriage return
3028-\'
3029-\'
3066+.fi
3067+
30303068 For example:
3031-\'
3069+
3070+.nf
30323071 gm convert -debug coders -log "%u %m:%l %e" in.gif out.png
3033-\'
3034-\'
3072+.fi
3073+
30353074 The default behavior is to print all of the components.
30363075 .TP
30373076 .B "-loop \fI<iterations>"\fP
30383077 \fRadd Netscape loop extension to your GIF animation
3039-\'
3078+
30403079 A value other than zero forces the animation to repeat itself up to
30413080 \fIiterations\fP
30423081 times.
30433082 .TP
30443083 .B "-magnify"
30453084 \fRmagnify the image
3046-\'
3085+
30473086 The image size is doubled using linear interpolation.
30483087 .TP
30493088 .B "-magnify \fI<factor>"\fP
30503089 \fRmagnify the image
3051-\'
3090+
30523091 The displayed image is magnified by \fBfactor\fP.
30533092 .TP
30543093 .B "-map \fI<filename>"\fP
30553094 \fRchoose a particular set of colors from this image
3056-\'
3095+
30573096 [\fIconvert\fP or \fImogrify\fP]
3058-\'
3097+
30593098 By default, color reduction chooses an optimal set of colors that best
30603099 represent the original image. Alternatively, you can choose a particular
30613100 set of colors from an image file with this option.
3062-\'
3101+
30633102 Use
30643103 \fB+map\fP to reduce
30653104 all images in the image sequence that follows to a single optimal set of colors
@@ -3070,19 +3109,20 @@
30703109 .TP
30713110 .B "-map \fI<type>"\fP
30723111 \fRdisplay image using this type.
3073-\'
3112+
30743113 [\fIanimate\fP or \fIdisplay\fP]
3075-\'
3114+
30763115 Choose from these \fIStandard Colormap\fP types:
3077-\'
3116+
3117+.nf
30783118 best
30793119 default
30803120 gray
30813121 red
30823122 green
30833123 blue
3084-\'
3085-\'
3124+.fi
3125+
30863126 The \fIX server\fP must support the \fIStandard Colormap\fP you choose,
30873127 otherwise an error occurs. Use \fBlist\fP as the type and \fBdisplay\fP
30883128 searches the list of colormap types in \fBtop-to-bottom\fP order until
@@ -3091,28 +3131,28 @@
30913131 .TP
30923132 .B "-mask \fI<filename>"\fP
30933133 \fRSpecify a clipping mask
3094-\'
3134+
30953135 The image read from the file is used as a clipping mask. It must have
30963136 the same dimensions as the image being masked.
3097-\'
3137+
30983138 If the mask image contains an opacity channel, the opacity of each
30993139 pixel is used to define the mask. Otherwise, the intensity (gray
31003140 level) of each pixel is used. Unmasked (black) pixels are modified
31013141 while masked pixels (not black) are protected from alteration.
3102-\'
3142+
31033143 Use \fB+mask\fP to remove the clipping mask.
3104-\'
3144+
31053145 It is not necessary to use \fB-clip\fP to activate the mask; \fB-clip\fP
31063146 is implied by \fB-mask\fP.
31073147 .TP
31083148 .B "-matte"
31093149 \fRstore matte channel if the image has one
3110-\'
3150+
31113151 If the image does not have a matte channel, create an opaque one.
3112-\'
3152+
31133153 Use \fB+matte\fP to ignore the matte channel (treats it as opaque) and to avoid writing a
31143154 matte channel in the output file.
3115-\'
3155+
31163156 For the compare command, \fB-matte\fP will add an opaque matte
31173157 channel to images if they do not already have a matte channel, and
31183158 matte will be enabled for both images. Likewise, if \fB+matte\fP is
@@ -3122,13 +3162,13 @@
31223162 .TP
31233163 .B "-mattecolor \fI<color>"\fP
31243164 \fRspecify the color to be used with the \fB-frame\fP option
3125-\'
3165+
31263166 The color is specified using the format described under the \fB-fill\fP
31273167 option.
31283168 .TP
31293169 .B "-maximum-error \fI<limit>"\fP
31303170 \fRspecifies the maximum amount of total image error
3131-\'
3171+
31323172 Specifies the maximum amount of total image error (based on comparison
31333173 using a specified metric) before an error ("image difference exceeds
31343174 limit") is reported. The error is reported via a non-zero command
@@ -3142,12 +3182,12 @@
31423182 .TP
31433183 .B "-minify \fI<factor>"\fP
31443184 \fRminify the image
3145-\'
3185+
31463186 The image size is halved using linear interpolation.
31473187 .TP
31483188 .B "-mode \fI<value>"\fP
31493189 \fRmode of operation
3150-\'
3190+
31513191 The available montage modes are \fBframe\fP to place the images in a
31523192 rectangular grid while adding a decorative frame with dropshadow,
31533193 \fBunframe\fP to place undecorated images in a rectangular grid, and
@@ -3156,13 +3196,13 @@
31563196 .TP
31573197 .B "-modulate \fIbrightness[,saturation[,hue]]"\fP
31583198 \fRvary the brightness, saturation, and hue of an image
3159-\'
3199+
31603200 Specify the percent change in brightness, color saturation, and
31613201 hue separated by commas. Default argument values are 100 percent,
31623202 resulting in no change. For example, to increase the color brightness
31633203 by 20% and decrease the color saturation by 10% and leave the hue
31643204 unchanged, use: \fB-modulate 120,90\fP.
3165-\'
3205+
31663206 Hue is the percentage of absolute rotation from the current
31673207 position. For example 50 results in a counter-clockwise rotation of 90
31683208 degrees, 150 results in a clockwise rotation of 90 degrees, with 0 and
@@ -3170,7 +3210,7 @@
31703210 .TP
31713211 .B "-monitor"
31723212 \fRshow progress indication
3173-\'
3213+
31743214 A simple command-line progress indication is shown while the command is
31753215 running. The process indication shows the operation currently being
31763216 performed and the percent completed. Commands using X11 may replace the
@@ -3182,10 +3222,10 @@
31823222 .TP
31833223 .B "-morph \fI<frames>"\fP
31843224 \fRmorphs an image sequence
3185-\'
3225+
31863226 Both the image pixels and size are linearly interpolated to give the appearance
31873227 of a meta-morphosis from one image to the next.
3188-\'
3228+
31893229 The sequence of images
31903230 is terminated by the appearance of any option.
31913231 If the \fB-morph\fP
@@ -3193,7 +3233,7 @@
31933233 .TP
31943234 .B "-mosaic"
31953235 \fRcreate a mosaic from an image or an image sequence
3196-\'
3236+
31973237 The \fB-mosaic\fP option provides a flexible way to composite one or
31983238 more images onto a solid-color canvas image. It works similar to
31993239 \fB-flatten\fP except that a base canvas image is automatically
@@ -3202,35 +3242,36 @@
32023242 canvas image may be set via the \fB-background\fP option. The
32033243 default canvas color is 'white', but 'black' or 'transparent' may be
32043244 more suitable depending on the composition algorithm requested.
3205-\'
3245+
32063246 The \fB-compose\fP option may be used to specify the composition
32073247 algorithm to use when compositing the subsequent image on the base
32083248 canvas.
3209-\'
3249+
32103250 The \fB-page\fP option can be used to establish the dimensions of the
32113251 mosaic and to position the subsequent image within the mosaic. If the
32123252 \fB-page\fP argument does not specify width and height, then the
32133253 canvas dimensions are evaluated based on the image sizes and
32143254 offsets.
3215-\'
3255+
32163256 The sequence of images is terminated by the appearance of any option.
32173257 If the \fB-mosaic\fP option appears after all of the input images,
32183258 all images are included in the mosaic.
3219-\'
3259+
32203260 The following is an example of composing an image based on red, green,
32213261 and blue layers extracted from a sequence of images and pasted on the
32223262 canvas image at specified offsets:
3223-\'
3263+
3264+.nf
32243265 gm convert -background black \\
32253266 -compose CopyRed -page +0-100 red.png \\
32263267 -compose CopyGreen -page +0+40 green.png \\
32273268 -compose CopyBlue -page +0+180 blue.png \\
32283269 -mosaic output.png
3229-\'
3270+.fi
32303271 .TP
32313272 .B "-motion-blur \fI<radius>{x<sigma>}{+angle}"\fP
32323273 \fRSimulate motion blur
3233-\'
3274+
32343275 Simulate motion blur by convolving the image with a Gaussian operator of
32353276 the given radius and standard deviation (sigma). For reasonable results,
32363277 radius should be larger than sigma. If radius is zero, then a suitable
@@ -3242,7 +3283,7 @@
32423283 .TP
32433284 .B "-negate"
32443285 \fRreplace every pixel with its complementary color
3245-\'
3286+
32463287 The red, green, and blue intensities of an image are negated.
32473288 White becomes black,
32483289 yellow becomes blue, etc.
@@ -3251,20 +3292,21 @@
32513292 .TP
32523293 .B "-noise \fI<radius|type>"\fP
32533294 \fRadd or reduce noise in an image
3254-\'
3295+
32553296 The principal function of noise peak elimination filter is to smooth the
32563297 objects within an image without losing edge information and without creating
32573298 undesired structures. The central idea of the algorithm is to replace a
32583299 pixel with its next neighbor in value within a pixel window, if this pixel
32593300 has been found to be noise. A pixel is defined as noise if and only if
32603301 this pixel is a maximum or minimum within the pixel window.
3261-\'
3302+
32623303 Use \fBradius\fP to specify the width of the neighborhood.
3263-\'
3304+
32643305 Use \fB+noise\fP followed by a noise type to add noise to an image.
32653306 The noise added modulates the existing image pixels. Choose from these
32663307 noise types:
3267-\'
3308+
3309+.nf
32683310 Uniform
32693311 Gaussian
32703312 Multiplicative
@@ -3272,20 +3314,20 @@
32723314 Laplacian
32733315 Poisson
32743316 Random (uniform distribution)
3275-\'
3317+.fi
32763318 .TP
32773319 .B "-noop"
32783320 \fRNOOP (no option)
3279-\'
3321+
32803322 The \fB-noop\fP option can be used to terminate a group of images
32813323 and reset all options to their default values, when no other option is
32823324 desired.
32833325 .TP
32843326 .B "-normalize"
32853327 \fRtransform image to span the full range of color values
3286-\'
3328+
32873329 This is a contrast enhancement technique based on the image histogram.
3288-\'
3330+
32893331 When computing the contrast enhancement values, the histogram edges
32903332 are truncated so that the majority of the image pixels are considered
32913333 in the constrast enhancement, and outliers (e.g. random noise or
@@ -3299,29 +3341,29 @@
32993341 .TP
33003342 .B "-opaque \fI<color>"\fP
33013343 \fRchange this color to the pen color within the image
3302-\'
3344+
33033345 The color is specified using the format described under the
33043346 \fB-fill\fP option. The color is replaced if it is identical to the
33053347 target color, or close enough to the target color in a 3D space as
33063348 defined by the Euclidean distance specified by \fB-fuzz\fP.
3307-\'
3349+
33083350 See \fB-fill\fP and \fB-fuzz\fP for more details.
33093351 .TP
33103352 .B "-operator \fIchannel operator rvalue[%]"\fP
33113353 \fRapply a mathematical, bitwise, or value operator to an image channel
3312-\'
3354+
33133355 Apply a low-level mathematical, bitwise, or value operator to a selected
33143356 image channel or all image channels. Operations which result in negative
33153357 results are reset to zero, and operations which overflow the available
33163358 range are reset to the maximum possible value.
3317-\'
3359+
33183360 Select a channel from: \fBRed\fP, \fBGreen\fP, \fBBlue\fP,
33193361 \fBOpacity\fP, \fBMatte\fP, \fBCyan\fP, \fBMagenta\fP, \fBYellow\fP,
33203362 \fBBlack\fP, \fBAll\fP, or \fBGray\fP. \fBAll\fP only modifies the
33213363 color channels and does not modify the \fBOpacity\fP channel. Except for
33223364 the threshold operators, \fBAll\fP operates on each channel
33233365 independently so that operations are on a per-channel basis.
3324-\'
3366+
33253367 \fBGray\fP treats the color channels as a grayscale intensity and
33263368 performs the requested operation on the equivalent pixel intensity so the
33273369 result is a gray image.
@@ -3335,7 +3377,7 @@
33353377 \fBNoise-Impulse\fP, \fBNoise-Laplacian\fP,
33363378 \fBNoise-Multiplicative\fP, \fBNoise-Poisson\fP,
33373379 \fBNoise-Random\fP, and \fBNoise-Uniform\fP.
3338-\'
3380+
33393381 Rvalue may be any floating point or integer value. Normally rvalue will
33403382 be in the range of 0 to MaxRGB, where MaxRGB is the largest quantum value
33413383 supported by the GraphicsMagick build (255, 65535, or 4294967295) but
@@ -3343,18 +3385,18 @@
33433385 Arguments to logical or bit-wise operations are rounded to a positive
33443386 integral value prior to use. If a percent (\fB%\fP) symbol is appended
33453387 to the argument, then the argument has a range of 0 to 100 percent.
3346-\'
3388+
33473389 The following is a description of the operators:
3348-\'
3349-.in 15
3350-\'
3390+
3391+.in 15
3392+
33513393 .in 15
33523394 .B "Add"
33533395 .in 20
33543396 \fR
33553397 .in 20
33563398 Result is rvalue added to channel value.
3357-\'
3399+
33583400 .in 15
33593401 .in 15
33603402 .B "And"
@@ -3362,7 +3404,7 @@
33623404 \fR
33633405 .in 20
33643406 Result is the logical AND of rvalue with channel value.
3365-\'
3407+
33663408 .in 15
33673409 .in 15
33683410 .B "Assign"
@@ -3370,7 +3412,7 @@
33703412 \fR
33713413 .in 20
33723414 Result is rvalue.
3373-\'
3415+
33743416 .in 15
33753417 .in 15
33763418 .B "Depth"
@@ -3379,7 +3421,7 @@
33793421 .in 20
33803422 Result is channel value adjusted so that it may be (approximately)
33813423 stored in the specified number of bits without additional loss.
3382-\'
3424+
33833425 .in 15
33843426 .in 15
33853427 .B "Divide"
@@ -3387,7 +3429,7 @@
33873429 \fR
33883430 .in 20
33893431 Result is channel value divided by rvalue.
3390-\'
3432+
33913433 .in 15
33923434 .in 15
33933435 .B "Gamma"
@@ -3395,7 +3437,7 @@
33953437 \fR
33963438 .in 20
33973439 Result is channel value gamma adjusted by rvalue.
3398-\'
3440+
33993441 .in 15
34003442 .in 15
34013443 .B "LShift"
@@ -3403,7 +3445,7 @@
34033445 \fR
34043446 .in 20
34053447 Result is channel value bitwise left shifted by rvalue bits.
3406-\'
3448+
34073449 .in 15
34083450 .in 15
34093451 .B "Log"
@@ -3411,7 +3453,7 @@
34113453 \fR
34123454 .in 20
34133455 Result is computed as log(value*rvalue+1)/log(rvalue+1).
3414-\'
3456+
34153457 .in 15
34163458 .in 15
34173459 .B "Max"
@@ -3419,7 +3461,7 @@
34193461 \fR
34203462 .in 20
34213463 Result is assigned to rvalue if rvalue is greater than value.
3422-\'
3464+
34233465 .in 15
34243466 .in 15
34253467 .B "Min"
@@ -3427,7 +3469,7 @@
34273469 \fR
34283470 .in 20
34293471 Result is assigned to rvalue if rvalue is less than value.
3430-\'
3472+
34313473 .in 15
34323474 .in 15
34333475 .B "Multiply"
@@ -3435,7 +3477,7 @@
34353477 \fR
34363478 .in 20
34373479 Result is channel value multiplied by rvalue.
3438-\'
3480+
34393481 .in 15
34403482 .in 15
34413483 .B "Negate"
@@ -3445,7 +3487,7 @@
34453487 Result is inverse of channel value (like a film negative). An rvalue
34463488 must be supplied but is currently not used. Inverting the image twice
34473489 results in the original image.
3448-\'
3490+
34493491 .in 15
34503492 .in 15
34513493 .B "Or"
@@ -3453,7 +3495,7 @@
34533495 \fR
34543496 .in 20
34553497 Result is the logical OR of rvalue with channel value.
3456-\'
3498+
34573499 .in 15
34583500 .in 15
34593501 .B "Pow"
@@ -3462,7 +3504,7 @@
34623504 .in 20
34633505 Result is computed as pow(value,rvalue). Similar to Gamma except that
34643506 rvalue is not inverted.
3465-\'
3507+
34663508 .in 15
34673509 .in 15
34683510 .B "RShift"
@@ -3470,7 +3512,7 @@
34703512 \fR
34713513 .in 20
34723514 Result is channel value bitwise right shifted by rvalue bits.
3473-\'
3515+
34743516 .in 15
34753517 .in 15
34763518 .B "Subtract"
@@ -3478,7 +3520,7 @@
34783520 \fR
34793521 .in 20
34803522 Result is channel value minus rvalue.
3481-\'
3523+
34823524 .in 15
34833525 .in 15
34843526 .B "Threshold"
@@ -3489,7 +3531,7 @@
34893531 or minimum (black) if it is less than or equal to rvalue. If \fBall\fP
34903532 channels are specified, then thresholding is done based on computed pixel
34913533 intensity.
3492-\'
3534+
34933535 .in 15
34943536 .in 15
34953537 .B "Threshold-white"
@@ -3501,7 +3543,7 @@
35013543 remove apparent noise from the bright parts of an image. If \fBall\fP
35023544 channels are specified, then thresholding is done based on computed pixel
35033545 intensity.
3504-\'
3546+
35053547 .in 15
35063548 .in 15
35073549 .B "Threshold-White-Negate"
@@ -3512,7 +3554,7 @@
35123554 rvalue and is unchanged if it is less than or equal to rvalue. If
35133555 \fBall\fP channels are specified, then thresholding is done based on
35143556 computed pixel intensity.
3515-\'
3557+
35163558 .in 15
35173559 .in 15
35183560 .B "Threshold-black"
@@ -3524,7 +3566,7 @@
35243566 used to remove apparent noise from the dark parts of an image. If
35253567 \fBall\fP channels are specified, then thresholding is done based on
35263568 computed pixel intensity.
3527-\'
3569+
35283570 .in 15
35293571 .in 15
35303572 .B "Threshold-Black-Negate"
@@ -3535,7 +3577,7 @@
35353577 rvalue and is unchanged if it is greater than or equal to rvalue. If
35363578 \fBall\fP channels are specified, then thresholding is done based on
35373579 computed pixel intensity.
3538-\'
3580+
35393581 .in 15
35403582 .in 15
35413583 .B "Xor"
@@ -3545,7 +3587,7 @@
35453587 Result is the logical XOR of rvalue with channel value. An
35463588 interesting property of XOR is that performing the same operation twice
35473589 results in the original value.
3548-\'
3590+
35493591 .in 15
35503592 .in 15
35513593 .B "Noise-Gaussian"
@@ -3554,7 +3596,7 @@
35543596 .in 20
35553597 Result is the current channel value modulated with gaussian noise
35563598 according to the intensity specified by rvalue.
3557-\'
3599+
35583600 .in 15
35593601 .in 15
35603602 .B "Noise-Impulse"
@@ -3563,7 +3605,7 @@
35633605 .in 20
35643606 Result is the current channel value modulated with impulse noise
35653607 according to the intensity specified by rvalue.
3566-\'
3608+
35673609 .in 15
35683610 .in 15
35693611 .B "Noise-Laplacian"
@@ -3572,7 +3614,7 @@
35723614 .in 20
35733615 Result is the current channel value modulated with laplacian noise
35743616 according to the intensity specified by rvalue.
3575-\'
3617+
35763618 .in 15
35773619 .in 15
35783620 .B "Noise-Multiplicative"
@@ -3581,7 +3623,7 @@
35813623 .in 20
35823624 Result is the current channel value modulated with multiplicative
35833625 gaussian noise according to the intensity specified by rvalue.
3584-\'
3626+
35853627 .in 15
35863628 .in 15
35873629 .B "Noise-Poisson"
@@ -3590,7 +3632,7 @@
35903632 .in 20
35913633 Result is the current channel value modulated with poisson noise
35923634 according to the intensity specified by rvalue.
3593-\'
3635+
35943636 .in 15
35953637 .in 15
35963638 .B "Noise-Random"
@@ -3601,7 +3643,7 @@
36013643 distribution) noise according to the intensity specified by rvalue.
36023644 The initial noise intensity (rvalue=1.0) is the range of one pixel
36033645 quantum span.
3604-\'
3646+
36053647 .in 15
36063648 .in 15
36073649 .B "Noise-Uniform"
@@ -3610,43 +3652,45 @@
36103652 .in 20
36113653 Result is the channel value with uniform noise applied according to
36123654 the intensity specified by rvalue.
3613-\'
3614-.in 15
3615-\'
3616-\'
3617-\'
3655+
3656+.in 15
3657+
3658+
3659+
36183660 As an example, the \fBAssign\fP operator assigns a fixed value to a
36193661 channel. For example, this command sets the red channel to the mid-range
36203662 value:
3621-\'
3663+
3664+.nf
36223665 gm convert in.bmp -operator red assign "50%" out.bmp
3623-\'
3624-\'
3666+.fi
3667+
36253668 The following applies 50% thresholding to the image and returns a gray
36263669 image:
3627-\'
3670+
3671+.nf
36283672 gm convert in.bmp -operator gray threshold "50%" out.bmp
3629-\'
3673+.fi
36303674 .TP
36313675 .B "-ordered-dither \fI<channeltype> <NxN>"\fP
36323676 \fRordered dither the image
3633-\'
3677+
36343678 The channel or channels specified in the \fBchanneltype\fP argument are
36353679 reduced to binary, using an ordered dither method. The choices for
36363680 \fBchanneltype\fP are \fBAll\fP, \fBIntensity\fP, \fBRed\fP,
36373681 \fBGreen\fP, \fBBlue\fP, \fBCyan\fP, \fBMagenta\fP, \fBYellow\fP,
36383682 \fBBlack\fP, and \fBOpacity\fP
3639-\'
3683+
36403684 When \fBchanneltype\fP is "All", the color samples are dithered into
36413685 a gray level and then that gray level is stored in the three color
36423686 channels. Separately, the opacity channel is dithered into a bilevel
36433687 opacity value which is stored in the opacity channel.
3644-\'
3688+
36453689 When \fBchanneltype\fP is "Intensity", only the color samples are
36463690 dithered. When \fBchanneltype\fP is "opacity" or "matte", only the
36473691 opacity channel is dithered. When a color channel is specified, only that
36483692 channel is dithered.
3649-\'
3693+
36503694 The choices for N are 2 through 7. The image is divided into
36513695 NxN pixel tiles. In each tile, some or all pixels are turned to
36523696 white depending on their intensity. For each N, (N**2)+1 levels
@@ -3664,7 +3708,7 @@
36643708 .TP
36653709 .B "-output-directory \fI<directory>"\fP
36663710 \fRoutput files to directory
3667-\'
3711+
36683712 Use -output-directory to specify a directory under which to write the
36693713 output files. Normally mogrify overwrites the input files, but with
36703714 this option the output files may be written to a different directory
@@ -3684,7 +3728,7 @@
36843728 .TP
36853729 .B "-orient \fI<orientation>"\fP
36863730 \fRSet the image orientation attribute
3687-\'
3731+
36883732 Sets the image orientation attribute. The image orientation attribute
36893733 is compatible with the TIFF orientation tag (and the EXIF orientation
36903734 tag). Accepted values are \fBundefined\fP, \fBTopLeft\fP,
@@ -3699,12 +3743,13 @@
36993743 .TP
37003744 .B "-page \fI<width>x<height>{+-}<x>{+-}<y>{%}{!}{<}{>}"\fP
37013745 \fRsize and location of an image canvas
3702-\'
3746+
37033747 Use this option to specify the dimensions of the
37043748 \fIPostScript\fP page
37053749 in dots per inch or a TEXT page in pixels. The choices for a PostScript
37063750 page are:
3707-\'
3751+
3752+.nf
37083753 11x17 792 1224
37093754 Ledger 1224 792
37103755 Legal 612 1008
@@ -3743,12 +3788,12 @@
37433788 Flsa 612 936
37443789 Flse 612 936
37453790 HalfLetter 396 612
3746-\'
3747-\'
3791+.fi
3792+
37483793 For convenience you can specify the page size by media (e.g. A4, Ledger,
37493794 etc.). Otherwise, \fB-page\fP behaves much like
37503795 \fB-geometry\fP (e.g. -page letter+43+43>).
3751-\'
3796+
37523797 This option is also used to place subimages when writing to a multi-image
37533798 format that supports offsets, such as GIF89 and MNG. When used for this
37543799 purpose the offsets are always measured from the
@@ -3762,7 +3807,7 @@
37623807 from the bounding box that contains all images in the sequence. When
37633808 writing a GIF89 file, only the bounding box method is used to determine its
37643809 dimensions.
3765-\'
3810+
37663811 For a PostScript page, the image is sized as in \fB-geometry\fP and positioned
37673812 relative to the lower left hand corner of the page by
37683813 {+-}<\fBx\fP\fIoffset\fP>{+-}<\fBy\fP
@@ -3775,28 +3820,28 @@
37753820 \fBy\fP \fIoffset\fP are measured rightward and downward from the top
37763821 left corner of the page, unless the \fB-gravity\fP option is present with
37773822 a value other than \fINorthWest\fP.
3778-\'
3823+
37793824 The default page dimensions for a TEXT image is 612x792.
3780-\'
3825+
37813826 This option is used in concert with \fB-density\fP.
3782-\'
3827+
37833828 Use \fB+page\fP to remove the page settings for an image.
37843829 .TP
37853830 .B "-paint \fI<radius>"\fP
37863831 \fRsimulate an oil painting
3787-\'
3832+
37883833 Each pixel is replaced by the most frequent color in a circular neighborhood
37893834 whose width is specified with \fIradius\fP.
37903835 .TP
37913836 .B "-pause \fI<seconds>"\fP
37923837 \fRpause between animation loops [animate]
3793-\'
3838+
37943839 Pause for the specified number of seconds before repeating the
37953840 animation.
37963841 .TP
37973842 .B "-pause \fI<seconds>"\fP
37983843 \fRpause between snapshots [import]
3799-\'
3844+
38003845 Pause for the specified number of seconds before taking the next
38013846 snapshot.
38023847 .TP
@@ -3805,7 +3850,7 @@
38053850 .TP
38063851 .B "-ping"
38073852 \fRefficiently determine image characteristics
3808-\'
3853+
38093854 Use this option to disable reading the image pixels so that image
38103855 characteristics such as the image dimensions may be obtained very
38113856 quickly. For identify, use +ping to force reading the image pixels so
@@ -3816,11 +3861,12 @@
38163861 .TP
38173862 .B "-preview \fI<type>"\fP
38183863 \fRimage preview type
3819-\'
3864+
38203865 Use this option to affect the preview operation of an image (e.g.
38213866 convert file.png -preview Gamma Preview:gamma.png). Choose
38223867 from these previews:
3823-\'
3868+
3869+.nf
38243870 Rotate
38253871 Shear
38263872 Roll
@@ -3850,37 +3896,39 @@
38503896 OilPaint
38513897 CharcoalDrawing
38523898 JPEG
3853-\'
3854-\'
3899+.fi
3900+
38553901 The default preview is \fBJPEG\fP.
38563902 .TP
38573903 .B "-process \fI<command>"\fP
38583904 \fRprocess a sequence of images using a process module
3859-\'
3905+
38603906 The command argument has the form \fBmodule=arg1,arg2,arg3,...,argN\fP
38613907 where \fBmodule\fP is the name of the module to invoke (e.g. "Analyze")
38623908 and arg1,arg2,arg3,...,argN are an arbitrary number of arguments to
38633909 pass to the process module.
38643910 The sequence of images
38653911 is terminated by the appearance of any option.
3866-\'
3912+
38673913 If the \fB-process\fP
38683914 option appears after all of the input images, all images are processed.
3869-\'
3915+
38703916 For example:
3871-\'
3917+
3918+.nf
38723919 gm convert logo: -process Analyze= \\
38733920 -format "%[BrightnessMean],%[BrightnessStddev]" info:-
38743921 51952,23294
3875-\'
3922+
3923+.nf
38763924 .TP
38773925 .B "-profile \fI<filename>"\fP
38783926 \fRadd ICM, IPTC, or generic profile to image
3879-\'
3927+
38803928 -profile filename adds an ICM (ICC color management), IPTC
38813929 (newswire information), or a generic (including Exif) profile to the image
38823930 .
3883-\'
3931+
38843932 Use +profile icm, +profile iptc, or
38853933 +profile profile_name to remove the respective profile.
38863934 Multiple profiles may be listed, separated by commas. Profiles may be
@@ -3895,17 +3943,18 @@
38953943 In JPEG they are stored in APP1 markers, and in PNG they are stored
38963944 as hex-coded binary in compressed zTXt chunks, except for the iCC
38973945 chunk which is stored in the iCCP chunk.
3898-\'
3946+
38993947 To extract a profile, the \fB-profile\fP option is not used. Instead,
39003948 simply write the file to an image
39013949 format such as \fIAPP1, 8BIM, ICM,\fP or \fIIPTC\fP.
3902-\'
3950+
39033951 For example, to extract the Exif data (which is stored in JPEG files
39043952 in the \fIAPP1\fP profile), use
3905-\'
3906-\'
3953+
3954+
3955+.nf
39073956 gm convert cockatoo.jpg exifdata.app1
3908-\'
3957+.fi
39093958 Note that GraphicsMagick does not attempt to update any profile to
39103959 reflect changes made to the image, e.g., rotation from portrait to landscape
39113960 orientation, so it is possible that the preserved profile may contain
@@ -3913,13 +3962,13 @@
39133962 .TP
39143963 .B "-preserve-timestamp"
39153964 \fRpreserve the original timestamps of the file
3916-\'
3965+
39173966 Use this option to preserve the original modification and access
39183967 timestamps of the file, even if it has been modified.
39193968 .TP
39203969 .B "+progress"
39213970 \fRdisable progress monitor and busy cursor
3922-\'
3971+
39233972 By default, when an image is displayed, a progress monitor bar is shown
39243973 in the top left corner of an existing image display window, and the
39253974 current cursor is replaced with an hourglass cursor. Use \fB+progress\fP
@@ -3937,92 +3986,93 @@
39373986 \fB-sampling-factor\fP option to specify the factors for chroma
39383987 downsampling. To use the same quality value as that found by the JPEG
39393988 decoder, use the -define jpeg:preserve-settings flag.
3940-\'
3989+
39413990 For the MIFF image format, and the TIFF format while using ZIP
39423991 compression, quality/10 is the zlib compression level, which is 0 (worst
39433992 but fastest compression) to 9 (best but slowest). It has no effect on the
39443993 image appearance, since the compression is always lossless.
3945-\'
3994+
39463995 For the JPEG-2000 image format, quality is mapped using a non-linear
39473996 equation to the compression ratio required by the Jasper library. This
39483997 non-linear equation is intended to loosely approximate the quality
39493998 provided by the JPEG v1 format. The default quality value 75 results in
39503999 a request for 16:1 compression. The quality value 100 results in
39514000 a request for non-lossy compression.
3952-\'
4001+
39534002 For the MNG and PNG image formats, the quality value sets the zlib compression
39544003 level (quality / 10) and filter-type (quality % 10). Compression levels
39554004 range from 0 (fastest compression) to 100 (best but slowest). For compression
39564005 level 0, the Huffman-only strategy is used, which is fastest but not
39574006 necessarily the worst compression.
3958-\'
4007+
39594008 If
39604009 filter-type is 4 or less, the specified filter-type is used for all scanlines:
3961-\'
4010+
4011+.nf
39624012 0: none
39634013 1: sub
39644014 2: up
39654015 3: average
39664016 4: Paeth
3967-\'
3968-\'
4017+.fi
4018+
39694019 If filter-type is 5, adaptive filtering is used when quality is greater
39704020 than 50 and the image does not have a color map, otherwise no filtering
39714021 is used.
3972-\'
4022+
39734023 If filter-type is 6, adaptive filtering
39744024 with \fIminimum-sum-of-absolute-values\fP
39754025 is used.
3976-\'
4026+
39774027 Only if the output is MNG, if filter-type is 7, the LOCO color transformation
39784028 and adaptive filtering with \fIminimum-sum-of-absolute-values\fP
39794029 are used.
3980-\'
4030+
39814031 The default is quality is 75, which means nearly the best compression with
39824032 adaptive filtering. The quality setting has no effect on the appearance
39834033 of PNG and MNG images, since the compression is always lossless.
3984-\'
4034+
39854035 For further information, see the PNG
39864036 specification.
3987-\'
4037+
39884038 When writing a JNG image with transparency, two quality values are required,
39894039 one for the main image and one for the grayscale image that conveys the
39904040 opacity channel. These are written as a single integer equal to the main
39914041 image quality plus 1000 times the opacity quality. For example, if you
39924042 want to use quality 75 for the main image and quality 90 to compress
39934043 the opacity data, use -quality 90075.
3994-\'
4044+
39954045 For the PNM family of formats (PNM, PGM, and PPM) specify a quality
39964046 factor of zero in order to obtain the ASCII variant of the format. Note
39974047 that -compress \fInone\fP used to be used to trigger ASCII output but
39984048 provided the opposite result of what was expected as compared with other
39994049 formats.
4000-\'
4050+
40014051 For the TIFF format, the JPEG, WebP, Zip, and Zstd compression
40024052 algorithms are influenced by the quality value. JPEG and WebP provide
40034053 lossy compression so higher quality produces a larger file with less
40044054 degradation. The Zip and Zstd compression algorithms (and WebP in
40054055 lossless mode) are lossless and for these algorithms a higher
4006-'quality' means to work harder to produce a smaller file, but with no
4056+\'quality' means to work harder to produce a smaller file, but with no
40074057 difference in image quality.
40084058 .TP
40094059 .B "-raise \fI<width>x<height>"\fP
40104060 \fRlighten or darken image edges
4011-\'
4061+
40124062 This will create a 3-D effect. See \fB-geometry\fP for details
40134063 details about the geometry specification. Offsets are not used.
4014-\'
4064+
40154065 Use \fB-raise\fP to create a raised effect, otherwise use \fB+raise\fP.
40164066 .TP
40174067 .B "-random-threshold \fI<channeltype> <LOWxHIGH>"\fP
40184068 \fRrandom threshold the image
4019-\'
4069+
40204070 The channel or channels specified in the <channeltype> argument are
40214071 reduced to binary, using an random-threshold method. The choices for
40224072 \fBchanneltype\fP are \fBAll\fP, \fBIntensity\fP, \fBRed\fP,
40234073 \fBGreen\fP, \fBBlue\fP, \fBCyan\fP, \fBMagenta\fP, \fBYellow\fP,
40244074 \fBBlack\fP, and \fBOpacity\fP
4025-\'
4075+
40264076 When \fBchanneltype\fP is "All", the color samples are thresholded into
40274077 a graylevel and then that gray level is stored in the three color
40284078 channels. Separately, the opacity channel is thresholded into a bilevel
@@ -4030,7 +4080,7 @@
40304080 new random number is used to establish the threshold to be used. The
40314081 threshold never exceeds the specified maximum (HIGH) and is never less
40324082 than the specified minimum (LOW).
4033-\'
4083+
40344084 When \fBchanneltype\fP is "intensity", only the color samples are
40354085 thresholded. When \fBchanneltype\fP is "opacity" or "matte", only the
40364086 opacity channel is thresholded. The other named channels only threshold
@@ -4038,7 +4088,7 @@
40384088 .TP
40394089 .B "-recolor \fI<matrix>"\fP
40404090 \fRapply a color translation matrix to image channels
4041-\'
4091+
40424092 A user supplied color translation matrix (expressed as a text string)
40434093 is used to translate/blend the image channels based on weightings in a
40444094 supplied matrix which may be of order 3 (color channels only), 4
@@ -4053,79 +4103,86 @@
40534103 Flash except that the offset is scaled to 1.0 (divide Flash offset by
40544104 255 for use with GraphicsMagick) so that the results are independent
40554105 of quantum depth.
4056-\'
4106+
40574107 An \fBidentity\fP matrix exists for each matrix order which
40584108 results in no change to the image. The translation matrix should be
40594109 based on an alteration of the identity matrix.
4060-\'
4110+
40614111 Identity matrix of order 3
4062-\'
4112+
4113+.nf
40634114 1 0 0
40644115 0 1 0
40654116 0 0 1
4066-\'
4067-\'
4117+.fi
4118+
40684119 which may be formatted into a convenient matrix argument similar to
40694120 (comma is treated as white space):
4070-\'
4121+
4122+.nf
40714123 -recolor "1 0 0, 0 1 0, 0 0 1"
4072-\'
4073-\'
4124+.fi
4125+
40744126 Identity matrix of order 4
4075-\'
4127+
4128+.nf
40764129 1 0 0 0
40774130 0 1 0 0
40784131 0 0 1 0
40794132 0 0 0 1
4080-\'
4081-\'
4133+.fi
4134+
40824135 Identity matrix of order 5. The last row is required to exist
40834136 for the purpose of parsing, but is otherwise not used.
4084-\'
4137+
4138+.nf
40854139 1 0 0 0 0
40864140 0 1 0 0 0
40874141 0 0 1 0 0
40884142 0 0 0 1 0
40894143 0 0 0 0 1
4090-\'
4091-\'
4144+.fi
4145+
40924146 As an example, an image wrongly in BGR channel order may be converted
40934147 to RGB using this matrix (blue->red, red->blue):
4094-\'
4148+
4149+.nf
40954150 0 0 1
40964151 0 1 0
40974152 1 0 0
4098-\'
4099-\'
4153+.fi
4154+
41004155 and an RGB image using standard Rec.709 primaries may be converted
41014156 to grayscale using this matrix of standard weighting factors:
4102-\'
4157+
4158+.nf
41034159 0.2126 0.7152 0.0722
41044160 0.2126 0.7152 0.0722
41054161 0.2126 0.7152 0.0722
4106-\'
4107-\'
4162+.fi
4163+
41084164 and contrast may be reduced by scaling down by 80% and adding a 10%
41094165 offset:
4110-\'
4166+
4167+.nf
41114168 0.8 0.0 0.0 0.0 0.1
41124169 0.0 0.8 0.0 0.0 0.1
41134170 0.0 0.0 0.8 0.0 0.1
41144171 0.0 0.0 0.0 0.8 0.1
41154172 0.0 0.0 0.0 0.0 1.0
4116-\'
4173+.fi
41174174 .TP
41184175 .B "-red-primary \fI<x>,<y>"\fP
41194176 \fRred chromaticity primary point
41204177 .TP
41214178 .B "-region \fI<width>x<height>{+-}<x>{+-}<y>"\fP
41224179 \fRapply options to a portion of the image
4123-\'
4180+
41244181 The \fIx\fP and \fIy\fP offsets are treated in the same manner as in \fB-crop\fP.
41254182 .TP
41264183 .B "-remote"
41274184 \fRperform a X11 remote operation
4128-\'
4185+
41294186 The \fB-remote\fP command sends a command to a "gm display" or "gm
41304187 animate" which is already running. The only command recognized at this
41314188 time is the name of an image file to load. This capability is very
@@ -4136,13 +4193,13 @@
41364193 .TP
41374194 .B "-render"
41384195 \fRrender vector operations
4139-\'
4196+
41404197 Use \fB+render\fP to turn off rendering vector operations. This is
41414198 useful when saving the result to vector formats such as MVG or SVG.
41424199 .TP
41434200 .B "-repage \fI <width>x<height>+xoff+yoff[!]"\fP
41444201 \fRAdjust image page offsets
4145-\'
4202+
41464203 Adjust the current image page canvas and position based on a relative
41474204 page specification. This option may be used to change the location of
41484205 a subframe (e.g. part of an animation) prior to composition. If the
@@ -4154,7 +4211,7 @@
41544211 .TP
41554212 .B "-resample \fI<horizontal>x<vertical>"\fP
41564213 \fRResample image to specified horizontal and vertical resolution
4157-\'
4214+
41584215 Resize the image so that its rendered size remains the same as the
41594216 original at the specified target resolution. Either the current image
41604217 resolution units or the previously set with \fB-units\fP are used to
@@ -4166,13 +4223,13 @@
41664223 resolution. For formats which do not support an image resolution, the
41674224 original resolution of the image must be specified via \fB-density\fP
41684225 on the command line prior to specifying the resample resolution.
4169-\'
4226+
41704227 Note that Photoshop stores and obtains image resolution from a
41714228 proprietary embedded profile. If this profile exists in the image,
41724229 then Photoshop will continue to treat the image using its former
41734230 resolution, ignoring the image resolution specified in the standard
41744231 file header.
4175-\'
4232+
41764233 Some image formats (e.g. PNG) require use of metric or english units
41774234 so even if the original image used a particular unit system, if it is
41784235 saved to a different format prior to resampling, then it may be
@@ -4183,38 +4240,38 @@
41834240 .TP
41844241 .B "-resize \fI<width>x<height>{%}{@}{!}{<}{>}"\fP
41854242 \fRresize an image
4186-\'
4243+
41874244 This is an alias for the \fB-geometry\fP option and it behaves in the
41884245 same manner. If the \fB-filter\fP option precedes the \fB-resize\fP
41894246 option, the specified filter is used.
4190-\'
4247+
41914248 There are some exceptions:
4192-\'
4249+
41934250 When used as a \fIcomposite\fP option, \fB-resize\fP conveys the
41944251 preferred size of the output image, while \fB-geometry\fP conveys the
41954252 size and placement of the \fIcomposite image\fP within the main
41964253 image.
4197-\'
4254+
41984255 When used as a \fImontage\fP option, \fB-resize\fP conveys the preferred
41994256 size of the montage, while \fB-geometry\fP conveys
42004257 information about the tiles.
42014258 .TP
42024259 .B "-roll \fI{+-}<x>{+-}<y>"\fP
42034260 \fRroll an image vertically or horizontally
4204-\'
4261+
42054262 See \fB-geometry\fP for details the geometry specification. The
42064263 \fIx\fP and \fIy\fP offsets are not affected by the \fB-gravity\fP
42074264 option.
4208-\'
4265+
42094266 A negative \fIx\fP offset rolls the image left-to-right. A negative
42104267 \fIy\fP offset rolls the image top-to-bottom.
42114268 .TP
42124269 .B "-rotate \fI<degrees>{<}{>}"\fP
42134270 \fRrotate the image
4214-\'
4271+
42154272 Positive angles rotate the image in a clockwise direction while
42164273 negative angles rotate counter-clockwise.
4217-\'
4274+
42184275 Use > to rotate the image only if its width exceeds the
42194276 height. < rotates the image \fIonly\fP if its width is less
42204277 than the height. For example, if you specify -rotate "-90>"
@@ -4222,7 +4279,7 @@
42224279 the image is 640x480, it is rotated by -90 degrees. If you use
42234280 > or <, enclose it in quotation marks to prevent it
42244281 from being misinterpreted as a file redirection.
4225-\'
4282+
42264283 Empty triangles left over from rotating the image are filled with the
42274284 color defined as \fBbackground\fP (class \fBbackgroundColor\fP).
42284285 The color is specified using the format described under the
@@ -4230,7 +4287,7 @@
42304287 .TP
42314288 .B "-sample \fI<geometry>"\fP
42324289 \fRscale image using pixel sampling
4233-\'
4290+
42344291 See \fB-geometry\fP for details about
42354292 the geometry specification.
42364293 \fB-sample\fP ignores the \fB-filter\fP selection if the \fB-filter\fP option
@@ -4239,7 +4296,7 @@
42394296 .TP
42404297 .B "-sampling-factor \fI<horizontal_factor>x<vertical_factor>"\fP
42414298 \fRchroma subsampling factors
4242-\'
4299+
42434300 This option specifies the sampling factors to be used by the DPX, JPEG,
42444301 MPEG, or YUV encoders for chroma downsampling. The sampling factor must
42454302 be specified while reading the raw YUV format since it is not preserved
@@ -4247,7 +4304,7 @@
42474304 Industry-standard video subsampling notation such as "4:2:2" may also
42484305 be used to specify the sampling factors. "4:2:2" is equivalent to a
42494306 specification of "2x1"
4250-\'
4307+
42514308 The JPEG decoder obtains the original sampling factors (and quality
42524309 settings) when a JPEG file is read. To re-use the original sampling
42534310 factors (and quality setting) when JPEG is output, use the -define
@@ -4255,7 +4312,7 @@
42554312 .TP
42564313 .B "-scale \fI<geometry>"\fP
42574314 \fRscale the image.
4258-\'
4315+
42594316 See \fB-geometry\fP for details about
42604317 the geometry specification. \fB-scale\fP uses a simpler, faster algorithm,
42614318 and it ignores the \fB-filter\fP selection if the \fB-filter\fP option
@@ -4264,32 +4321,34 @@
42644321 .TP
42654322 .B "-scene \fI<value>"\fP
42664323 \fRset scene number
4267-\'
4324+
42684325 This option sets the scene number of an image or the first image in
42694326 an image sequence.
42704327 .TP
42714328 .B "-scenes \fI<value-value>"\fP
42724329 \fRrange of image scene numbers to read
4273-\'
4330+
42744331 Each image in the range is read
42754332 with the filename followed by a period (\fB.\fP) and the decimal scene
42764333 number. You
42774334 can change this behavior by embedding a \fB%d, %0Nd, %o, %0No, %x, or %0Nx
42784335 printf\fP format specification in the file name. For example,
4279-\'
4336+
4337+.nf
42804338 gm montage -scenes 5-7 image.miff montage.miff
4281-\'
4282-\'
4339+.fi
4340+
42834341 makes a montage of files image.miff.5, image.miff.6, and image.miff.7, and
4284-\'
4342+
4343+.nf
42854344 gm animate -scenes 0-12 image%02d.miff
4286-\'
4287-\'
4345+.fi
4346+
42884347 animates files image00.miff, image01.miff, through image12.miff.
42894348 .TP
42904349 .B "-screen"
42914350 \fRspecify the screen to capture
4292-\'
4351+
42934352 This option indicates that the GetImage request used to obtain the image
42944353 should be done on the root window, rather than directly on the specified
42954354 window. In this way, you can obtain pieces of other windows that overlap
@@ -4298,22 +4357,22 @@
42984357 .TP
42994358 .B "-set \fI<attribute> <value>"\fP
43004359 \fRset an image attribute
4301-\'
4360+
43024361 Set a named image attribute. The attribute is set on the current
43034362 (previously specified on command line) image.
43044363 .TP
43054364 .B "+set \fI<attribute>"\fP
43064365 \fRunset an image attribute
4307-\'
4366+
43084367 Unset a named image attribute. The attribute is removed from the current
43094368 (previously specified on command line) image.
43104369 .TP
43114370 .B "-segment \fI<cluster threshold>x<smoothing threshold>"\fP
43124371 \fRsegment an image
4313-\'
4372+
43144373 Segment an image by analyzing the histograms of the color components and
43154374 identifying units that are homogeneous with the fuzzy c-means technique.
4316-\'
4375+
43174376 Segmentation is a very useful fast and and approximate color quantization
43184377 algorithm for scanned printed pages or scanned cartoons. It may also be
43194378 used as a special effect. Specify \fIcluster threshold\fP as the minimum
@@ -4328,7 +4387,7 @@
43284387 .TP
43294388 .B "-shade \fI<azimuth>x<elevation>"\fP
43304389 \fRshade the image using a distant light source
4331-\'
4390+
43324391 Specify \fIazimuth\fP and \fIelevation\fP as the position of the light
43334392 source. Use \fB+shade\fP to return the shading results as a grayscale
43344393 image.
@@ -4338,7 +4397,7 @@
43384397 .TP
43394398 .B "-shared-memory"
43404399 \fRuse shared memory
4341-\'
4400+
43424401 This option specifies whether the utility should attempt to use shared
43434402 memory for pixmaps. GraphicsMagick must be compiled with shared
43444403 memory support, and the display must support the \fIMIT-SHM\fP
@@ -4347,22 +4406,22 @@
43474406 .TP
43484407 .B "-sharpen \fI<radius>{x<sigma>}"\fP
43494408 \fRsharpen the image
4350-\'
4409+
43514410 Use a Gaussian operator of the given radius and standard deviation
43524411 (sigma).
43534412 .TP
43544413 .B "-shave \fI<width>x<height>{%}"\fP
43554414 \fRshave pixels from the image edges
4356-\'
4415+
43574416 Specify the width of the region to be removed from both
43584417 sides of the image and the height of the regions to be removed from
43594418 top and bottom.
43604419 .TP
43614420 .B "-shear \fI<x degrees>x<y degrees>"\fP
43624421 \fRshear the image along the X or Y axis
4363-\'
4422+
43644423 Use the specified positive or negative shear angle.
4365-\'
4424+
43664425 Shearing slides one edge of an image along the X or Y axis, creating a
43674426 parallelogram. An X direction shear slides an edge along the X axis,
43684427 while a Y direction shear slides an edge along the Y axis. The amount
@@ -4370,7 +4429,7 @@
43704429 \fIx degrees\fP is measured relative to the Y axis, and similarly,
43714430 for Y direction shears \fIy degrees\fP is measured relative to the X
43724431 axis.
4373-\'
4432+
43744433 Empty triangles left over from shearing the image are filled with the
43754434 color defined as \fBbackground\fP (class \fBbackgroundColor\fP).
43764435 The color is specified using the format described under the
@@ -4381,50 +4440,51 @@
43814440 .TP
43824441 .B "-size \fI<width>x<height>{+offset}"\fP
43834442 \fRwidth and height of the image
4384-\'
4443+
43854444 Use this option to specify the width and height of raw images whose
43864445 dimensions are unknown such as \fBGRAY\fP, \fBRGB\fP, or
43874446 \fBCMYK\fP. In addition to width and height, use \fB-size\fP with an
43884447 offset to skip any header information in the image or tell the number
43894448 of colors in a \fBMAP\fP image file, (e.g. -size 640x512+256).
4390-\'
4449+
43914450 For Photo CD images, choose from these sizes:
4392-\'
4451+
4452+.nf
43934453 192x128
43944454 384x256
43954455 768x512
43964456 1536x1024
43974457 3072x2048
4398-\'
4399-\'
4458+.fi
4459+
44004460 Finally, use this option to choose a particular resolution layer of a JBIG
44014461 or JPEG image (e.g. -size 1024x768).
44024462 .TP
44034463 .B "-snaps \fI<value>"\fP
44044464 \fRnumber of screen snapshots
4405-\'
4465+
44064466 Use this option
44074467 to grab more than one image from the X server screen, to create
44084468 an animation sequence.
44094469 .TP
44104470 .B "-solarize \fI<factor>"\fP
44114471 \fRnegate all pixels above the threshold level
4412-\'
4472+
44134473 Specify \fIfactor\fP as the
44144474 percent threshold of the intensity (0 - 99.9%).
4415-\'
4475+
44164476 This option produces a \fIsolarization\fP effect seen when exposing a
44174477 photographic film to light during the development process.
44184478 .TP
44194479 .B "-spread \fI<amount>"\fP
44204480 \fRdisplace image pixels by a random amount
4421-\'
4481+
44224482 \fIAmount\fP defines the size of the neighborhood around each pixel to
44234483 choose a candidate pixel to swap.
44244484 .TP
44254485 .B "-stegano \fI<offset>"\fP
44264486 \fRhide watermark within an image
4427-\'
4487+
44284488 Use an offset to start the image hiding some number of pixels from the
44294489 beginning of the image. Note this offset and the image size. You will
44304490 need this information to recover the steganographic image
@@ -4432,46 +4492,46 @@
44324492 .TP
44334493 .B "-stereo"
44344494 \fRcomposite two images to create a stereo anaglyph
4435-\'
4495+
44364496 The left side of the stereo pair is saved as the red channel of the output
44374497 image. The right side is saved as the green channel. Red-green stereo
44384498 glasses are required to properly view the stereo image.
44394499 .TP
44404500 .B "-strip"
44414501 \fRremove all profiles and text attributes from the image
4442-\'
4502+
44434503 All embedded profiles and text attributes are stripped from the image.
44444504 This is useful for images used for the web, or when output files need
44454505 to be as small as possible
4446-\'
4506+
44474507 Be careful not to use this option to remove author, copyright, and
44484508 license information that you are required to retain when redistributing
44494509 an image.
44504510 .TP
44514511 .B "-stroke \fI<color>"\fP
44524512 \fRcolor to use when stroking a graphic primitive
4453-\'
4513+
44544514 The color is specified using the format described under the \fB-fill\fP
44554515 option.
4456-\'
4516+
44574517 See \fB-draw\fP for further details.
44584518 .TP
44594519 .B "-strokewidth \fI<value>"\fP
44604520 \fRset the stroke width
4461-\'
4521+
44624522 See \fB-draw\fP for further details.
44634523 .TP
44644524 .B "-swirl \fI<degrees>"\fP
44654525 \fRswirl image pixels about the center
4466-\'
4526+
44674527 \fIDegrees\fP defines the tightness of the swirl.
44684528 .TP
44694529 .B "-text-font \fI<name>"\fP
44704530 \fRfont for writing fixed-width text
4471-\'
4531+
44724532 Specifies the name of the preferred font to use in fixed (typewriter style)
44734533 formatted text. The default is 14 point \fICourier\fP.
4474-\'
4534+
44754535 You can tag a font to specify whether it is a PostScript, TrueType, or
44764536 X11 font. For example, Courier.ttf is a TrueType font
44774537 and x:fixed is X11.
@@ -4481,17 +4541,18 @@
44814541 .TP
44824542 .B "-threshold \fI<value>{%}"\fP
44834543 \fRthreshold the image
4484-\'
4544+
44854545 Modify the image such that any pixel sample with an intensity value
44864546 greater than the threshold is assigned the maximum intensity (white), or
44874547 otherwise is assigned the minimum intensity (black). If a percent prefix
44884548 is applied, then the threshold is a percentage of the available range.
4489-\'
4549+
44904550 To efficiently create a black and white image from a color image, use
4491-\'
4551+
4552+.nf
44924553 gm convert -threshold 50% in.png out.png
4493-\'
4494-\'
4554+.fi
4555+
44954556 The optimum threshold value depends on the nature of the image.
44964557 In order to threshold individual channels, use the \fB-operator\fP
44974558 subcommand with it's \fBThreshold\fP, \fBThreshold-White\fP, or
@@ -4499,7 +4560,7 @@
44994560 .TP
45004561 .B "-thumbnail \fI<width>x<height>{%}{@}{!}{<}{>}"\fP
45014562 \fRresize an image (quickly)
4502-\'
4563+
45034564 The \fB-thumbnail\fP command resizes the image as quickly as
45044565 possible, with more concern for speed than resulting image quality.
45054566 Regardless, resulting image quality should be acceptable for many
@@ -4516,102 +4577,106 @@
45164577 .TP
45174578 .B "-title \fI<string>"\fP
45184579 \fRassign title to displayed image [\fIanimate, display, montage\fP]
4519-\'
4580+
45204581 Use this option to assign a specific title to the image. This is
45214582 assigned to the image window and is typically displayed in the window
45224583 title bar. Optionally you can include the image filename, type,
45234584 width, height, Exif data, or other image attribute by embedding
45244585 special format characters described under the \fB-format\fP
45254586 option.
4526-\'
4587+
45274588 For example,
4528-\'
4589+
4590+.nf
45294591 -title "%m:%f %wx%h"
4530-\'
4531-\'
4592+.fi
4593+
45324594 produces an image title of MIFF:bird.miff 512x480 for an image
45334595 titled bird.miff and whose width is 512 and height is 480.
45344596 .TP
45354597 .B "-transform"
45364598 \fRtransform the image
4537-\'
4599+
45384600 This option applies the transformation matrix from a previous
45394601 \fB-affine\fP option.
4540-\'
4602+
4603+.nf
45414604 gm convert -affine 2,2,-2,2,0,0 -transform bird.ppm bird.jpg
4542-\'
4605+.fi
45434606 .TP
45444607 .B "-transparent \fI<color>"\fP
45454608 \fRmake this color transparent within the image
4546-\'
4609+
45474610 The color is specified using the format described under the \fB-fill\fP
45484611 option.
45494612 .TP
45504613 .B "-treedepth \fI<value>"\fP
45514614 \fRtree depth for the color reduction algorithm
4552-\'
4615+
45534616 Normally, this integer value is zero or one. A value of zero or one
45544617 causes the use of an optimal tree depth for the color reduction
45554618 algorithm
4556-\'
4619+
45574620 An optimal depth generally allows the best representation of the source
45584621 image with the fastest computational speed and the least amount of memory.
45594622 However, the default depth is inappropriate for some images. To assure
45604623 the best representation, try values between 2 and 8 for this parameter.
45614624 Refer to
45624625 quantize for more details.
4563-\'
4626+
45644627 The \fB-colors\fP or \fB-monochrome\fP option, or writing to an image
45654628 format which requires color reduction, is required for this option to
45664629 take effect.
45674630 .TP
45684631 .B "-trim"
45694632 \fRtrim an image
4570-\'
4633+
45714634 This option removes any edges that are exactly the same color as the
45724635 corner pixels. Use \fB-fuzz\fP to make \fB-trim\fP remove edges that
45734636 are nearly the same color as the corner pixels.
45744637 .TP
45754638 .B "-type \fI<type>"\fP
45764639 \fRthe image type
4577-\'
4640+
45784641 Choose from:
45794642 \fBBilevel\fP, \fBGrayscale\fP, \fBPalette\fP,
45804643 \fBPaletteMatte\fP, \fBTrueColor\fP, \fBTrueColorMatte\fP,
45814644 \fBColorSeparation\fP, \fBColorSeparationMatte\fP, or \fBOptimize\fP.
4582-\'
4645+
45834646 Normally, when a format supports different subformats such as bilevel,
45844647 grayscale, palette, truecolor, and truecolor+alpha, the encoder will try
45854648 to choose a suitable subformat based on the nature of the image. The
45864649 \fB-type\fP option may be used to tailor the output subformat. By
45874650 default the output subformat is based on readily available image
45884651 information and is usually similar to the input format.
4589-\'
4652+
45904653 Specify -type Optimize in order to enable inspecting all pixels
45914654 (if necessary) in order to find the most efficient subformat. Inspecting
45924655 all of the pixels may be slow for very large images, particularly if they
45934656 are stored in a disk cache. If an RGB image contains only gray pixels,
45944657 then every pixel in the image must be inspected in order to decide that
45954658 the image is actually grayscale!
4596-\'
4659+
45974660 Sometimes a specific subformat is desired. For example, to force a JPEG
45984661 image to be written in TrueColor RGB format even though only gray pixels
45994662 are present, use
4600-\'
4663+
4664+.nf
46014665 gm convert bird.pgm -type TrueColor bird.jpg
4602-\'
4603-\'
4666+.fi
4667+
46044668 Similarly, using -type TrueColorMatte will force the encoder to
46054669 write an alpha channel even though the image is opaque, if the output
46064670 format supports transparency.
4607-\'
4671+
46084672 Some pseudo-formats (e.g. the XC format) will respect the requested
46094673 type if it occurs previously on the command line. For example, to obtain
46104674 a DirectClass solid color canvas image rather than PsuedoClass, use
4611-\'
4675+
4676+.nf
46124677 gm convert -size 640x480 -type TrueColor xc:red red.miff
4613-\'
4614-\'
4678+.fi
4679+
46154680 Likewise, specify \fB-type\fP \fBBilevel\fP, \fBGrayscale\fP,
46164681 \fBTrueColor\fP, or \fBTrueColorMatte\fP prior to reading a Postscript
46174682 (or PDF file) in order to influence the type of image that Ghostcript
@@ -4622,7 +4687,7 @@
46224687 .B "-update \fI<seconds>"\fP
46234688 \fR
46244689 detect when image file is modified and redisplay.
4625-\'
4690+
46264691 Suppose that while you are displaying an image the file that is currently
46274692 displayed is over-written.
46284693 \fBdisplay\fP will automatically detect that
@@ -4630,70 +4695,70 @@
46304695 .TP
46314696 .B "-units \fI<type>"\fP
46324697 \fRthe units of image resolution
4633-\'
4698+
46344699 Choose from: \fBUndefined\fP, \fBPixelsPerInch\fP, or
46354700 \fBPixelsPerCentimeter\fP. This option is normally used in conjunction
46364701 with the \fB-density\fP option.
46374702 .TP
46384703 .B "-unsharp \fI<radius>{x<sigma>}{+<amount>}{+<threshold>}"\fP
46394704 \fRsharpen the image with an unsharp mask operator
4640-\'
4705+
46414706 The \fB-unsharp\fP option sharpens an image. The image is convolved
46424707 with a Gaussian operator of the given radius and standard deviation
46434708 (sigma). For reasonable results, radius should be larger than sigma. Use
46444709 a radius of 0 to have the method select a suitable radius.
4645-\'
4710+
46464711 The parameters are:
4647-\'
4648-.in 15
4649-\'
4712+
4713+.in 15
4714+
46504715 .in 15
46514716 .B "radius"
46524717 .in 20
46534718 \fR
46544719 .in 20
4655-\'
4720+
46564721 The radius of the Gaussian, in pixels, not counting the center pixel (default 0).
4657-\'
4722+
46584723 .in 15
46594724 .in 15
46604725 .B "sigma"
46614726 .in 20
46624727 \fR
46634728 .in 20
4664-\'
4729+
46654730 The standard deviation of the Gaussian, in pixels (default 1.0).
4666-\'
4731+
46674732 .in 15
46684733 .in 15
46694734 .B "amount"
46704735 .in 20
46714736 \fR
46724737 .in 20
4673-\'
4738+
46744739 The percentage of the difference between the original and the blur image that
46754740 is added back into the original (default 1.0).
4676-\'
4741+
46774742 .in 15
46784743 .in 15
46794744 .B "threshold"
46804745 .in 20
46814746 \fR
46824747 .in 20
4683-\'
4748+
46844749 The threshold, as a fraction of MaxRGB, needed to apply the difference
46854750 amount (default 0.05).
4686-\'
4687-.in 15
4688-\'
4689-\'
4751+
4752+.in 15
4753+
4754+
46904755 .TP
46914756 .B "-use-pixmap"
46924757 \fRuse the pixmap
46934758 .TP
46944759 .B "-verbose"
46954760 \fRprint detailed information about the image
4696-\'
4761+
46974762 This information is printed: image scene number; image name; image size;
46984763 the image class (\fIDirectClass\fP or \fIPseudoClass\fP); the total
46994764 number of unique colors; and the number of seconds to read and transform
@@ -4703,7 +4768,7 @@
47034768 If the image is \fIPseudoClass\fP then its pixels are defined by indexes
47044769 into a colormap. If the image is \fIDirectClass\fP then each pixel
47054770 includes a complete and independent color specification.
4706-\'
4771+
47074772 If \fB-colors\fP is also specified, the total unique colors in the image
47084773 and color reduction error values are printed. Refer to quantize
47094774 for a description of these values.
@@ -4716,62 +4781,63 @@
47164781 .TP
47174782 .B "-virtual-pixel \fI<method>"\fP
47184783 \fRspecify contents of "virtual pixels"
4719-\'
4784+
47204785 This option
47214786 defines "virtual pixels" for use in operations that can access pixels outside
47224787 the boundaries of an image.
4723-\'
4788+
47244789 Choose from these methods:
4725-\'
4726-.in 15
4727-\'
4790+
4791+.in 15
4792+
47284793 .in 15
47294794 .B "Constant"
47304795 .in 20
47314796 \fR
47324797 .in 20
4733-\'
4798+
47344799 Use the image background color.
4735-\'
4800+
47364801 .in 15
47374802 .in 15
47384803 .B "Edge"
47394804 .in 20
47404805 \fR
47414806 .in 20
4742-\'
4807+
47434808 Extend the edge pixel toward infinity (default).
4744-\'
4809+
47454810 .in 15
47464811 .in 15
47474812 .B "Mirror"
47484813 .in 20
47494814 \fR
47504815 .in 20
4751-\'
4816+
47524817 Mirror the image.
4753-\'
4818+
47544819 .in 15
47554820 .in 15
47564821 .B "Tile"
47574822 .in 20
47584823 \fR
47594824 .in 20
4760-\'
4825+
47614826 Tile the image.
4762-\'
4763-.in 15
4764-\'
4765-\'
4766-\'
4827+
4828+.in 15
4829+
4830+
4831+
47674832 This option affects operations that use
47684833 virtual pixels such as \fB-blur\fP, \fB-sharpen\fP, \fB-wave\fP, etc.
47694834 .TP
47704835 .B "-visual \fI<type>"\fP
47714836 \fRanimate images using this X visual type
4772-\'
4837+
47734838 Choose from these visual classes:
4774-\'
4839+
4840+.nf
47754841 StaticGray
47764842 GrayScale
47774843 StaticColor
@@ -4780,8 +4846,8 @@
47804846 DirectColor
47814847 default
47824848 visual id
4783-\'
4784-\'
4849+.fi
4850+
47854851 The X server must support the visual you choose, otherwise an error occurs.
47864852 If a visual is not specified, the visual class that can display the most
47874853 simultaneous colors on the default screen is chosen.
@@ -4791,7 +4857,7 @@
47914857 .TP
47924858 .B "-wave \fI<amplitude>x<wavelength>"\fP
47934859 \fRalter an image along a sine wave
4794-\'
4860+
47954861 Specify \fIamplitude\fP and \fIwavelength\fP
47964862 of the wave.
47974863 .TP
@@ -4800,7 +4866,7 @@
48004866 .TP
48014867 .B "-white-threshold \fIred[,green][,blue][,opacity]"\fP
48024868 \fRpixels above the threshold become white
4803-\'
4869+
48044870 Use \fB-white-threshold\fP to set pixels with values above the specified
48054871 threshold to maximum value (white). If only one value is supplied, or the
48064872 red, green, and blue values are identical, then intensity thresholding is
@@ -4813,15 +4879,15 @@
48134879 .TP
48144880 .B "-window \fI<id>"\fP
48154881 \fRmake image the background of a window
4816-\'
4882+
48174883 \fIid\fP can be a window id or name. Specify \fBroot\fP to
48184884 select X's root window as the target window.
4819-\'
4885+
48204886 By default the image is tiled onto the background of the target
48214887 window. If \fBbackdrop\fP or \fB-geometry\fP are
48224888 specified, the image is surrounded by the background color. Refer to
48234889 \fBX RESOURCES\fP for details.
4824-\'
4890+
48254891 The image will not display on the root window if the image has more
48264892 unique colors than the target window colormap allows. Use
48274893 \fB-colors\fP to reduce the number of colors.
@@ -4831,22 +4897,23 @@
48314897 .TP
48324898 .B "-write \fI<filename>"\fP
48334899 \fRwrite an intermediate image [\fIconvert, composite\fP]
4834-\'
4900+
48354901 The current image is written to the specified filename and then
48364902 processing continues using that image. The following is an example of how
48374903 several sizes of an image may be generated in one command (repeat as
48384904 often as needed):
4839-\'
4905+
4906+.nf
48404907 gm convert input.jpg -resize 50% -write input50.jpg \\
48414908 -resize 25% input25.jpg
4842-\'
4909+.fi
48434910 .TP
48444911 .B "-write \fI<filename>"\fP
48454912 \fRwrite the image to a file [\fIdisplay\fP]
4846-\'
4913+
48474914 If \fIfilename\fP already exists, you will be prompted as to whether it should
48484915 be overwritten.
4849-\'
4916+
48504917 By default, the image is written in the format that it was read in as.
48514918 To specify a particular image format, prefix \fIfilename\fP with the
48524919 image type and a colon (e.g., ps:image) or specify the image type as
@@ -4855,9 +4922,9 @@
48554922 size is \fBcompressed\fP using compress or \fBgzip\fP
48564923 respectively. Precede the image file name with | to pipe to a system
48574924 command.
4858-\'
4925+
48594926 Use \fB-compress\fP to specify the type of image compression.
4860-\'
4927+
48614928 The equivalent X resource for this option is
48624929 \fBwriteFilename\fP (class \fBWriteFilename\fP).
48634930 See
@@ -5044,20 +5111,22 @@
50445111 .TP
50455112 .B "colors.mgk"
50465113 \fRcolors configuration file
5047-\'
5114+
5115+.nf
50485116 <?xml version="1.0"?>
50495117 <colormap>
50505118 <color name="AliceBlue" red="240" green="248" blue="255"
50515119 compliance="SVG, X11, XPM" />
50525120 </colormap>
5053-\'
5121+.fi
50545122 .TP
50555123 .B "delegates.mgk"
50565124 \fRdelegates configuration file
50575125 .TP
50585126 .B "log.mgk"
50595127 \fRlogging configuration file
5060-\'
5128+
5129+.nf
50615130 <?xml version="1.0"?>
50625131 <magicklog>
50635132 <log events="None" />
@@ -5067,20 +5136,22 @@
50675136 <log limit="2000" />
50685137 <log format="%t %r %u %p %m/%f/%l/%d:\\n %e" />
50695138 </magicklog>
5070-\'
5139+.fi
50715140 .TP
50725141 .B "modules.mgk"
50735142 \fRloadable modules configuration file
5074-\'
5143+
5144+.nf
50755145 <?xml version="1.0"?>
50765146 <modulemap>
50775147 <module magick="8BIM" name="META" />
50785148 </modulemap>
5079-\'
5149+.fi
50805150 .TP
50815151 .B "type.mgk"
50825152 \fRmaster type (fonts) configuration file
5083-\'
5153+
5154+.nf
50845155 <?xml version="1.0"?>
50855156 <typemap>
50865157 <\fB\fPinclude file="type-windows.mgk" />
@@ -5097,22 +5168,22 @@
50975168 glyphs="/usr/local/share/ghostscript/fonts/a010013l.pfb"
50985169 />
50995170 </typemap>
5100-\'
5171+.fi
51015172 .SH GM ANIMATE
5102-\'
5173+
51035174 \fBAnimate\fP displays a sequence of images on any workstation display
51045175 running an X server. \fBanimate\fP first determines the hardware capabilities
51055176 of the workstation. If the number of unique colors in an image is less
51065177 than or equal to the number the workstation can support, the image is displayed
51075178 in an X window. Otherwise the number of colors in the image is first reduced
51085179 to match the color resolution of the workstation before it is displayed.
5109-\'
5180+
51105181 This means that a continuous-tone 24 bits-per-pixel image can display on
51115182 a 8 bit pseudo-color device or monochrome device. In most instances the
51125183 reduced color image closely resembles the original. Alternatively, a monochrome
51135184 or pseudo-color image sequence can display on a continuous-tone 24 bits-per-pixel
51145185 device.
5115-\'
5186+
51165187 To help prevent color flashing on X server visuals that have colormaps,
51175188 \fBanimate\fP
51185189 creates a single colormap from the image sequence. This can be rather time
@@ -5124,30 +5195,33 @@
51245195 for details. This method is recommended for colormapped X server because
51255196 it eliminates the need to compute a global colormap.
51265197 .SH EXAMPLES
5127-\'
5198+
51285199 To animate a set of images of a cockatoo, use:
5129-\'
5200+
5201+.nf
51305202 gm animate cockatoo.*
5131-\'
5132-\'
5203+.fi
5204+
51335205 To animate a cockatoo image sequence while using the Standard Colormap
51345206 \fIbest\fP, use:
5135-\'
5207+
5208+.nf
51365209 xstdcmap -best
51375210 gm animate -map best cockatoo.*
5138-\'
5139-\'
5211+.fi
5212+
51405213 To animate an image of a cockatoo without a border centered on a backdrop,
51415214 use:
5142-\'
5143-\'
5215+
5216+
5217+.nf
51445218 gm animate +borderwidth -backdrop cockatoo.*
5145-\'
5219+.fi
51465220 .SH OPTIONS
5147-\'
5221+
51485222 For a more detailed description of each option, see
51495223 Options, above.
5150-\'
5224+
51515225 .TP
51525226 .B "-authenticate \fI<string>"\fP
51535227 \fRdecrypt image with this password
@@ -5301,22 +5375,23 @@
53015375 .TP
53025376 .B "-window \fI<id>"\fP
53035377 \fRmake image the background of a window
5304-\'
5378+
53055379 For a more detailed description of each option, see
53065380 Options, above.
5307-\'
5308-\'
5381+
5382+
53095383 Any option you specify on the command line remains in effect for the group
53105384 of images following it, until the group is terminated by the appearance of
53115385 any option or \fB-noop\fP. For example, to animate three images, the first
53125386 with 32 colors, the second with an unlimited number of colors, and the
53135387 third with only 16 colors, use:
5314-\'
5315-\'
5388+
5389+
5390+.nf
53165391 gm animate -colors 32 cockatoo.1 -noop cockatoo.2
53175392 -colors 16 cockatoo.3
5318-\'
5319-\'
5393+.fi
5394+
53205395 \fBAnimate\fP options can appear on the command line or in your X resources
53215396 file. See \fIX(1)\fP. Options on the command line supersede values specified
53225397 in your X resources file.
@@ -5326,36 +5401,36 @@
53265401 is specified in the image. Otherwise the images will display in the order
53275402 they appear on the command line.
53285403 .SH MOUSE BUTTONS
5329-\'
5404+
53305405 Press any button to map or unmap the Command widget. See the next section
53315406 for more information about the Command widget.
53325407 .SH COMMAND WIDGET
5333-\'
5408+
53345409 The Command widget lists a number of sub-menus and commands. They are
5335-\'
5410+
53365411 \fBAnimate\fP
5337-\'
5412+
53385413 Open
53395414 Play
53405415 Step
53415416 Repeat
53425417 Auto Reverse
5343-\'
5418+
53445419 \fBSpeed\fP
5345-\'
5420+
53465421 Faster
53475422 Slower
5348-\'
5423+
53495424 \fBDirection\fP
5350-\'
5425+
53515426 Forward
53525427 Reverse
5353-\'
5428+
53545429 \fBImage Info\fP
53555430 \fBHelp\fP
53565431 \fBQuit\fP
5357-\'
5358-\'
5432+
5433+
53595434 Menu items with a indented triangle have a sub-menu. They are represented
53605435 above as the indented items. To access a sub-menu item, move the pointer
53615436 to the appropriate menu and press a button and drag. When you find the
@@ -5364,7 +5439,7 @@
53645439 particular command.
53655440 .SH KEYBOARD ACCELERATORS
53665441 .in 15
5367-\'
5442+
53685443 .in 15
53695444 .B "\fBCtl+O\fP"
53705445 .in 20
@@ -5421,23 +5496,23 @@
54215496 .in 20
54225497 Press to discard all images and exit program.
54235498 .in 15
5424-\'
5499+
54255500 .SH X RESOURCES
5426-\'
5501+
54275502 \fBAnimate\fP options can appear on the command line or in your X resource
54285503 file. Options on the command line supersede values specified in your X
54295504 resource file. See \fBX(1)\fP for more information on X resources.
5430-\'
5505+
54315506 All \fBanimate\fP options have a corresponding X resource. In addition,
54325507 the \fBanimate\fP program uses the following X resources:
54335508 .in 15
5434-\'
5509+
54355510 .in 15
54365511 .B "\fBbackground\fP \fB(\fP\fIclass\fP \fBBackground)\fP"
54375512 .in 20
54385513 \fR
54395514 .in 20
5440-\'
5515+
54415516 Specifies the preferred color to use for the Image window background. The
54425517 default is #ccc.
54435518 .in 15
@@ -5446,7 +5521,7 @@
54465521 .in 20
54475522 \fR
54485523 .in 20
5449-\'
5524+
54505525 Specifies the preferred color to use for the Image window border. The default
54515526 is #ccc.
54525527 .in 15
@@ -5455,7 +5530,7 @@
54555530 .in 20
54565531 \fR
54575532 .in 20
5458-\'
5533+
54595534 Specifies the width in pixels of the Image window border. The default is
54605535 2.
54615536 .in 15
@@ -5464,7 +5539,7 @@
54645539 .in 20
54655540 \fR
54665541 .in 20
5467-\'
5542+
54685543 Specifies the name of the preferred font to use in normal formatted text.
54695544 The default is 14 point \fIHelvetica\fP.
54705545 .in 15
@@ -5473,7 +5548,7 @@
54735548 .in 20
54745549 \fR
54755550 .in 20
5476-\'
5551+
54775552 Specifies the preferred color to use for text within the Image window.
54785553 The default is black.
54795554 .in 15
@@ -5482,7 +5557,7 @@
54825557 .in 20
54835558 \fR
54845559 .in 20
5485-\'
5560+
54865561 Specifies the preferred size and position of the image window. It is not
54875562 necessarily obeyed by all window managers.
54885563 Offsets, if present, are handled in \fIX(1)\fP style. A negative x offset is
@@ -5495,7 +5570,7 @@
54955570 .in 20
54965571 \fR
54975572 .in 20
5498-\'
5573+
54995574 Specifies the preferred size and position of the application when iconified.
55005575 It is not necessarily obeyed by all window managers.
55015576 Offsets, if present, are handled in the same manner as in class Geometry.
@@ -5505,7 +5580,7 @@
55055580 .in 20
55065581 \fR
55075582 .in 20
5508-\'
5583+
55095584 This resource indicates that you would prefer that the application's windows
55105585 initially not be visible as if the windows had be immediately iconified
55115586 by you. Window managers may choose not to honor the application's request.
@@ -5515,7 +5590,7 @@
55155590 .in 20
55165591 \fR
55175592 .in 20
5518-\'
5593+
55195594 Specify the color of windows. It is used for the backgrounds of windows,
55205595 menus, and notices. A 3D effect is achieved by using highlight and shadow
55215596 colors derived from this color. Default value: #ddd.
@@ -5525,7 +5600,7 @@
55255600 .in 20
55265601 \fR
55275602 .in 20
5528-\'
5603+
55295604 This resource specifies the name under which resources for the application
55305605 should be found. This resource is useful in shell aliases to distinguish
55315606 between invocations of an application, without resorting to creating links
@@ -5536,7 +5611,7 @@
55365611 .in 20
55375612 \fR
55385613 .in 20
5539-\'
5614+
55405615 This resource specifies whether animate should attempt use shared memory
55415616 for pixmaps. ImageMagick must be compiled with shared memory support, and
55425617 the display must support the MIT-SHM extension. Otherwise, this resource
@@ -5547,7 +5622,7 @@
55475622 .in 20
55485623 \fR
55495624 .in 20
5550-\'
5625+
55515626 Specifies the name of the preferred font to use in fixed (typewriter style)
55525627 formatted text. The default is 14 point \fICourier\fP.
55535628 .in 15
@@ -5556,15 +5631,15 @@
55565631 .in 20
55575632 \fR
55585633 .in 20
5559-\'
5634+
55605635 This resource specifies the title to be used for the Image window. This
55615636 information is sometimes used by a window manager to provide some sort
55625637 of header identifying the window. The default is the image file name.
55635638 .in 15
5564-\'
5639+
55655640 .SH GM BATCH
55665641 .SH DESCRIPTION
5567-\'
5642+
55685643 \fBbatch\fP executes an arbitary number of the utility commands
55695644 (e.g. \fBconvert\fP) in the form of a simple linear batch script in
55705645 order to improve execution efficiency, and/or to allow use as a
@@ -5578,19 +5653,21 @@
55785653 converts all files matching '*.jpg' to TIFF format while rotating each
55795654 file by 90 degrees and stripping all embedded profiles. The shell
55805655 script syntax is standard Unix shell:
5581-\'
5656+
5657+.nf
55825658 for file in *.jpg
55835659 do
55845660 outfile=`basename $file .jpg`.tiff
55855661 echo convert -verbose "'$file'" -rotate 90 \\
55865662 +profile "'*'" "'$outfile'"
55875663 done | gm batch -echo on -feedback on -
5588-\'
5589-\'
5664+.fi
5665+
55905666 We can accomplish the same as the previous example by putting all the
55915667 commands in a text file and then specifying the name of the text file
55925668 as the script to execute:
5593-\'
5669+
5670+.nf
55945671 for file in *.jpg
55955672 do
55965673 outfile=`basename $file .jpg`.tiff
@@ -5598,21 +5675,21 @@
55985675 +profile "'*'" "'$outfile'"
55995676 done > script.txt
56005677 gm batch -echo on -feedback on script.txt
5601-\'
5678+.fi
56025679 .SH OPTIONS
5603-\'
5680+
56045681 Options are processed from left to right and must appear before any filename argument.
56055682 .TP
56065683 .B "-echo \fIon|off"\fP
56075684 \fRcommand echo on or off
5608-\'
5685+
56095686 Specify \fBon\fP to enable echoing commands to standard output as
56105687 they are read or \fBoff\fP to disable. The default is
56115688 \fBoff\fP.
56125689 .TP
56135690 .B "-escape \fIunix|windows"\fP
56145691 \fRParse using unix or windows syntax
5615-\'
5692+
56165693 Commands must be parsed from the input stream and escaping needs to be
56175694 used to protect spaces or quoting characters in the input. Specify
56185695 \fBunix\fP to use unix-style command line parsing or \fBwindows\fP
@@ -5624,42 +5701,42 @@
56245701 .TP
56255702 .B "-fail \fItext"\fP
56265703 \fRtext to print if a command fails
5627-\'
5704+
56285705 When feedback is enabled, this specifies the text to print when the
56295706 command fails. The default text is \fBFAIL\fP.
56305707 .TP
56315708 .B "-feedback \fIon|off"\fP
56325709 \fRenable error feedback
5633-\'
5710+
56345711 Print text (see -pass and -fail options) feedback after each
56355712 command to indicate the result, the default is \fBoff\fP.
56365713 .TP
56375714 .B "-help"
5638-\'
5715+
56395716 Prints batch command help.
56405717 .TP
56415718 .B "-pass \fItext"\fP
56425719 \fRtext to print if a command passes
5643-\'
5720+
56445721 When feedback is enabled, this specifies the text to print when the
56455722 command passes. The default text is \fBPASS\fP.
56465723 .TP
56475724 .B "-prompt \fItext"\fP
56485725 \fRPrompt text to use for command line
5649-\'
5726+
56505727 If no filename argument was specified, a simple command prompt appears
56515728 where you may enter GraphicsMagick commands. The default prompt is
56525729 \fBGM>\fP. Use this option to change the prompt to something else.
56535730 .TP
56545731 .B "-stop-on-error \fIon|off"\fP
56555732 \fRSpecify if command processing stops on error
5656-\'
5733+
56575734 Normally command processing continues if a command encounters an
56585735 error. Specify \fB-stop-on-error on\fP to cause processing to quit
56595736 immediately on error.
56605737 .SH GM BENCHMARK
56615738 .SH DESCRIPTION
5662-\'
5739+
56635740 \fBbenchmark\fP executes an arbitrary \fBgm\fP utility command
56645741 (e.g. \fBconvert\fP) for one or more loops, and/or a specified
56655742 execution time, and reports many execution metrics. For builds using
@@ -5671,30 +5748,34 @@
56715748 .SH EXAMPLES
56725749 To obtain benchmark information for a single execution of a
56735750 command:
5674-\'
5751+
5752+.nf
56755753 gm benchmark convert input.ppm -gaussian 0x1 output.ppm
5676-\'
5754+.fi
56775755 To obtain benchmark information from 100 iterations of the
56785756 command:
5679-\'
5757+
5758+.nf
56805759 gm benchmark -iterations 100 convert input.ppm \\
56815760 -gaussian 0x1 output.ppm
5682-\'
5761+.fi
56835762 To obtain benchmark information by iterating the command until a
56845763 specified amount of time (in seconds) has been consumed:
5685-\'
5764+
5765+.nf
56865766 gm benchmark -duration 30 convert input.ppm \\
56875767 -gaussian 0x1 output.ppm
5688-\'
5768+.fi
56895769 To obtain a full performance report with an increasing number of
56905770 threads (1-32 threads, stepping the number of threads by four each
56915771 time):
5692-\'
5772+
5773+.nf
56935774 gm benchmark -duration 3 -stepthreads 4 convert \\
56945775 input.ppm -gaussian 0x2 output.ppm
5695-\'
5776+.fi
56965777 Here is the interpretation of the output:
5697-\'
5778+
56985779 \fBthreads\fP - number of threads used.
56995780 \fBiter\fP - number of command iterations executed.
57005781 \fBuser\fP - total user time consumed.
@@ -5703,7 +5784,7 @@
57035784 \fBiter/cpu\fP - amount of CPU time consumed per iteration.
57045785 \fBspeedup\fP - speedup compared with one thread.
57055786 \fBkarp-flatt\fP - Karp-Flatt measure of speedup efficiency.
5706-\'
5787+
57075788 \fIPlease note that the reported "speedup" is based on the
57085789 execution time of just one thread. A preliminary warm-up pass is used
57095790 before timing the first loop in order to ensure that the CPU is
@@ -5728,7 +5809,7 @@
57285809 elapsed.
57295810 .TP
57305811 .B "-help"
5731-\'
5812+
57325813 Prints benchmark command help.
57335814 .TP
57345815 .B "-iterations \fIloops"\fP
@@ -5751,7 +5832,7 @@
57515832 threads is taken from the standard OMP_NUM_THREADS
57525833 environment variable.
57535834 .SH GM COMPARE
5754-\'
5835+
57555836 \fBcompare\fP compares two similar images using a specified statistical
57565837 method (see \fB-metric\fP) and/or by writing a difference image
57575838 (\fB-file\fP), with the altered pixels annotated using a specified
@@ -5760,27 +5841,29 @@
57605841 image and \fIcompare-image\fP is the (possibly) altered version, which
57615842 should have the same dimensions as \fIreference-image\fP.
57625843 .SH EXAMPLES
5763-\'
5844+
57645845 To compare two images using Mean Square Error (MSE) statistical analysis
57655846 use:
5766-\'
5847+
5848+.nf
57675849 gm compare -metric mse original.miff compare.miff
5768-\'
5769-\'
5850+.fi
5851+
57705852 To create an annotated difference image use:
5771-\'
5853+
5854+.nf
57725855 gm compare -highlight-style assign -highlight-color purple \\
57735856 -file diff.miff original.miff compare.miff
5774-\'
5857+.fi
57755858 .SH OPTIONS
5776-\'
5859+
57775860 Options are processed in command line order. Any option you specify on
57785861 the command line remains in effect only for the image that follows. All
57795862 options are reset to their default values after each image is read.
5780-\'
5863+
57815864 For a more detailed description of each option, see
57825865 Options, above.
5783-\'
5866+
57845867 .TP
57855868 .B "-authenticate \fI<string>"\fP
57865869 \fRdecrypt image with this password
@@ -5853,18 +5936,18 @@
58535936 .TP
58545937 .B "-version"
58555938 \fRprint GraphicsMagick version string
5856-\'
5939+
58575940 For a more detailed description of each option, see
58585941 Options, above.
5859-\'
5942+
58605943 .SH GM COMPOSITE
5861-\'
5944+
58625945 \fBcomposite\fP composites (combines) images to create new images.
58635946 \fIbase-image\fP is the base image and \fIchange-image\fP contains the changes.
58645947 \fIouput-image\fP is the result, and normally has the same dimensions
58655948 as \fIbase-image\fP.
5866-\'
5867-\'
5949+
5950+
58685951 The optional \fImask-image\fP can be used to provide opacity information
58695952 for \fIchange-image\fP when it has none or if you want a different mask.
58705953 A mask image is typically grayscale and the same size as
@@ -5872,49 +5955,54 @@
58725955 to grayscale and the resulting intensities are used as opacity
58735956 information.
58745957 .SH EXAMPLES
5875-\'
5958+
58765959 To composite an image of a cockatoo with a perch, use:
5877-\'
5960+
5961+.nf
58785962 gm composite cockatoo.miff perch.ras composite.miff
5879-\'
5880-\'
5963+.fi
5964+
58815965 To compute the difference between images in a series, use:
5882-\'
5966+
5967+.nf
58835968 gm composite -compose difference series.2 series.1
58845969 difference.miff
5885-\'
5886-\'
5970+.fi
5971+
58875972 To composite an image of a cockatoo with a perch starting at location (100,150),
58885973 use:
5889-\'
5974+
5975+.nf
58905976 gm composite -geometry +100+150 cockatoo.miff
58915977 perch.ras composite.miff
5892-\'
5893-\'
5978+.fi
5979+
58945980 To tile a logo across your image of a cockatoo, use
5895-\'
5981+
5982+.nf
58965983 gm convert +shade 30x60 cockatoo.miff mask.miff
58975984 gm composite -compose bumpmap -tile logo.png
58985985 cockatoo.miff mask.miff composite.miff
5899-\'
5900-\'
5986+.fi
5987+
59015988 To composite a red, green, and blue color plane into a single composite image,
59025989 try
5903-\'
5990+
5991+.nf
59045992 gm composite -compose CopyGreen green.png red.png
59055993 red-green.png
59065994 gm composite -compose CopyBlue blue.png red-green.png
59075995 gm composite.png
5908-\'
5996+.fi
59095997 .SH OPTIONS
5910-\'
5998+
59115999 Options are processed in command line order. Any option you specify on
59126000 the command line remains in effect only for the image that follows. All
59136001 options are reset to their default values after each image is read.
5914-\'
6002+
59156003 For a more detailed description of each option, see
59166004 Options, above.
5917-\'
6005+
59186006 .TP
59196007 .B "-authenticate \fI<string>"\fP
59206008 \fRdecrypt image with this password
@@ -6101,18 +6189,19 @@
61016189 .TP
61026190 .B "-write \fI<filename>"\fP
61036191 \fRwrite an intermediate image [\fIconvert, composite\fP]
6104-\'
6192+
61056193 For a more detailed description of each option, see
61066194 Options, above.
6107-\'
6195+
61086196 .SH GM CONJURE
6109-\'
6197+
61106198 The Magick scripting language (MSL) will primarily benefit those that
61116199 want to accomplish custom image processing tasks but do not wish to
61126200 program, or those that do not have access to a Perl interpreter or a
61136201 compiler. The interpreter is called conjure and here is an example
61146202 script:
6115-\'
6203+
6204+.nf
61166205 <?xml version="1.0" encoding="UTF-8"?>
61176206 <image size="400x400" >
61186207 <read filename="image.gif" />
@@ -6124,22 +6213,23 @@
61246213 to %[width]x%[height].\\n" />
61256214 <write filename="image.png" />
61266215 </image>
6127-\'
6128-\'
6216+.fi
6217+
61296218 invoked with
6130-\'
6219+
6220+.nf
61316221 gm conjure -dimensions 400x400 incantation.msl
6132-\'
6133-\'
6222+.fi
6223+
61346224 All operations will closely follow the key/value pairs defined in
61356225 PerlMagick, unless otherwise noted.
61366226 .SH OPTIONS
6137-\'
6227+
61386228 Options are processed in command line order. Any option you specify on
61396229 the command line remains in effect until it is explicitly changed by specifying
61406230 the option again with a different effect, or if it is changed by a statement
61416231 in the scripting language.
6142-\'
6232+
61436233 You can define your own keyword/value pairs on the command line.
61446234 The script can then use this information when setting values by including
61456235 %[keyword] in the string. For example, if you included
@@ -6149,11 +6239,11 @@
61496239 The "%[string]" can be used either an entire string, such as
61506240 geometry="%[dimensions]" or as a part of a string such as
61516241 filename="%[basename].png".
6152-\'
6242+
61536243 The keyword can be any string except for the following reserved
61546244 strings (in any upper, lower, or mixed case variant): \fBdebug\fP,
61556245 \fBhelp\fP, and \fBverbose\fP, whose usage is described below.
6156-\'
6246+
61576247 The value can be any string. If
61586248 either the keyword or the value contains white space or any
61596249 symbols that have special meanings to your shell such as "#",
@@ -6161,15 +6251,15 @@
61616251 or
61626252 "%", enclose the string in quotation marks or use "\\" to escape the white
61636253 space and special symbols.
6164-\'
6254+
61656255 Keywords and values are case dependent. "Key",
61666256 "key",
61676257 and "KEY" would
61686258 be three different keywords.
6169-\'
6259+
61706260 For a more detailed description of each option, see
61716261 Options, above.
6172-\'
6262+
61736263 .TP
61746264 .B "-debug \fI<events>"\fP
61756265 \fRenable debug printout
@@ -6189,11 +6279,11 @@
61896279 .B "-version"
61906280 \fRprint GraphicsMagick version string
61916281 .SH MAGICK SCRIPTING LANGUAGE
6192-\'
6282+
61936283 The Magick Scripting Language (MSL) presently defines the following
61946284 elements and their attributes:
61956285 .in 15
6196-\'
6286+
61976287 .in 15
61986288 .B "<image>"
61996289 .in 20
@@ -6202,16 +6292,17 @@
62026292 background, color, id, size
62036293 .in 15
62046294 .in 20
6205-\'
6295+
62066296 Define a new image object. \fB</image>\fP destroys it. Because of
62076297 this, if you wish to reference multiple "subimages" (aka pages or
62086298 layers), you can embed one \fBimage\fP element inside of another. For
62096299 example:
6210-\'
6211-.in 15
6212-.in 20
6213-\'
6214-\'
6300+
6301+.in 15
6302+.in 20
6303+
6304+
6305+.nf
62156306 <image>
62166307 <read filename="input.png" />
62176308 <get width="base-width" height="base-height" />
@@ -6219,44 +6310,47 @@
62196310 <image />
62206311 <write filename="output.mng" />
62216312 </image>
6222-\'
6223-\'
6224-.in 15
6225-.in 20
6226-\'
6227-\'
6313+.fi
6314+
6315+.in 15
6316+.in 20
6317+
6318+
6319+.nf
62286320 <image size="400x400" />
6229-\'
6230-\'
6321+.fi
6322+
62316323 .in 15
62326324 .in 15
62336325 .B "<group>"
62346326 .in 20
62356327 \fR
62366328 .in 20
6237-\'
6329+
62386330 Define a new group of image objects. By default, images are only
62396331 valid for the life of their \fB<image>\fPelement.
6240-\'
6241-.in 15
6242-.in 20
6243-\'
6244-\'
6332+
6333+.in 15
6334+.in 20
6335+
6336+
6337+.nf
62456338 <image> -- creates the image
62466339 ..... -- do stuff with it
62476340 </image> -- dispose of the image
6248-\'
6249-\'
6250-.in 15
6251-.in 20
6252-\'
6341+.fi
6342+
6343+.in 15
6344+.in 20
6345+
62536346 However, in a group, all images in that group will stay around for the
62546347 life of the group:
6255-\'
6256-.in 15
6257-.in 20
6258-\'
6259-\'
6348+
6349+.in 15
6350+.in 20
6351+
6352+
6353+.nf
62606354 <group> -- start a group
62616355 <image> -- create an image
62626356 .... -- do stuff
@@ -6266,8 +6360,8 @@
62666360 </image> -- NOOP
62676361 <write filename="image.mng" /> -- output
62686362 </group> -- dispose of both images
6269-\'
6270-\'
6363+.fi
6364+
62716365 .in 15
62726366 .in 15
62736367 .B "<read>"
@@ -6277,29 +6371,31 @@
62776371 filename
62786372 .in 15
62796373 .in 20
6280-\'
6374+
62816375 Read a new image from a disk file.
6282-\'
6283-.in 15
6284-.in 20
6285-\'
6286-\'
6376+
6377+.in 15
6378+.in 20
6379+
6380+
6381+.nf
62876382 <read filename="image.gif" />
6288-\'
6289-\'
6290-.in 15
6291-.in 20
6292-\'
6383+.fi
6384+
6385+.in 15
6386+.in 20
6387+
62936388 To read two images use
6294-\'
6295-.in 15
6296-.in 20
6297-\'
6298-\'
6389+
6390+.in 15
6391+.in 20
6392+
6393+
6394+.nf
62996395 <read filename="image.gif" />
63006396 <read filename="image.png />
6301-\'
6302-\'
6397+.fi
6398+
63036399 .in 15
63046400 .in 15
63056401 .B "<write>"
@@ -6311,13 +6407,14 @@
63116407 .in 20
63126408 Write the image(s) to disk, either as
63136409 a single multiple-image file or multiple ones if necessary.
6314-\'
6315-.in 15
6316-.in 20
6317-\'
6318-\'
6410+
6411+.in 15
6412+.in 20
6413+
6414+
6415+.nf
63196416 <write filename=image.tiff" />
6320-\'
6417+.fi
63216418 .in 15
63226419 .B "<get>"
63236420 .in 20
@@ -6328,12 +6425,13 @@
63286425 use. Currently only \fIwidth\fP and \fIheight\fP are supported.
63296426 .in 15
63306427 .in 20
6331-\'
6332-\'
6428+
6429+
6430+.nf
63336431 <get width="base-width" height="base-height" />
63346432 <print output="Image size is %[base-width]x%[base-height].\\n" />
6335-\'
6336-\'
6433+.fi
6434+
63376435 .in 15
63386436 .in 15
63396437 .B "<set>"
@@ -6352,28 +6450,30 @@
63526450 [profilename]
63536451 .in 15
63546452 .in 20
6355-\'
6453+
63566454 Read one or more IPTC, ICC or generic profiles from file and assign to image
6357-\'
6358-.in 15
6359-.in 20
6360-\'
6361-\'
6455+
6456+.in 15
6457+.in 20
6458+
6459+
6460+.nf
63626461 <profile iptc="profile.iptc" generic="generic.dat" />
6363-\'
6364-\'
6365-.in 15
6366-.in 20
6367-\'
6462+.fi
6463+
6464+.in 15
6465+.in 20
6466+
63686467 To remove a specified profile use "!" as the filename eg
6369-\'
6370-.in 15
6371-.in 20
6372-\'
6373-\'
6468+
6469+.in 15
6470+.in 20
6471+
6472+
6473+.nf
63746474 <profile icm="!" iptc="profile.iptc" />
6375-\'
6376-\'
6475+.fi
6476+
63776477 .in 15
63786478 .in 15
63796479 .B "<border>"
@@ -6418,8 +6518,9 @@
64186518 compose, geometry, gravity, image, x, y
64196519 .in 15
64206520 .in 20
6421-\'
6422-\'
6521+
6522+
6523+.nf
64236524 <?xml version="1.0" encoding="UTF-8"?>
64246525 <group>
64256526 <image id="image_01">
@@ -6437,8 +6538,8 @@
64376538 </image>
64386539 <write filename="result.png"/>
64396540 </group>
6440-\'
6441-\'
6541+.fi
6542+
64426543 .in 15
64436544 .in 15
64446545 .B "<despeckle>"
@@ -6680,107 +6781,118 @@
66806781 .B "<trim>"
66816782 .in 20
66826783 \fR
6683-\'
6784+
66846785 .SH GM CONVERT
6685-\'
6786+
66866787 \fBConvert\fP converts an input file using one image format to an output
66876788 file with a differing image format. In addition, various types of image
66886789 processing can be performed on the converted image during the conversion
66896790 process. \fBConvert\fP recognizes the image formats listed in
66906791 \fIGraphicsMagick(1)\fP.
6691-\'
6792+
66926793 .SH EXAMPLES
6693-\'
6794+
66946795 To make a thumbnail of a JPEG image, use:
6695-\'
6796+
6797+.nf
66966798 gm convert -size 120x120 cockatoo.jpg -resize 120x120
66976799 +profile "*" thumbnail.jpg
6698-\'
6699-\'
6800+.fi
6801+
67006802 In this example, '-size 120x120' gives a hint to the JPEG decoder
67016803 that the image is going to be downscaled to 120x120, allowing it to run
67026804 faster by avoiding returning full-resolution images to GraphicsMagick for
67036805 the subsequent resizing operation. The
6704-'-resize 120x120' specifies the desired dimensions of the
6806+\'-resize 120x120' specifies the desired dimensions of the
67056807 output image. It will be scaled so its largest dimension is 120 pixels. The
6706-'+profile "*"' removes any ICM, EXIF, IPTC, or other profiles
6808+\'+profile "*"' removes any ICM, EXIF, IPTC, or other profiles
67076809 that might be present in the input and aren't needed in the thumbnail.
6708-\'
6810+
67096811 To convert a \fIMIFF\fP image of a cockatoo to a SUN raster image, use:
6710-\'
6812+
6813+.nf
67116814 gm convert cockatoo.miff sun:cockatoo.ras
6712-\'
6713-\'
6815+.fi
6816+
67146817 To convert a multi-page \fIPostScript\fP document to individual FAX pages,
67156818 use:
6716-\'
6819+
6820+.nf
67176821 gm convert -monochrome document.ps fax:page
6718-\'
6719-\'
6822+.fi
6823+
67206824 To convert a TIFF image to a \fIPostScript\fP A4 page with the image in
67216825 the lower left-hand corner, use:
6722-\'
6826+
6827+.nf
67236828 gm convert -page A4+0+0 image.tiff document.ps
6724-\'
6725-\'
6829+.fi
6830+
67266831 To convert a raw Gray image with a 128 byte header to a portable graymap,
67276832 use:
6728-\'
6833+
6834+.nf
67296835 gm convert -depth 8 -size 768x512+128 gray:raw
67306836 image.pgm
6731-\'
6732-\'
6837+.fi
6838+
67336839 In this example, "raw" is the input file. Its format is "gray" and it
67346840 has the dimensions and number of header bytes specified by the -size
67356841 option and the sample depth specified by the
67366842 -depth option. The output file is "image.pgm". The suffix ".pgm"
67376843 specifies its format.
6738-\'
6844+
67396845 To convert a Photo CD image to a TIFF image, use:
6740-\'
6846+
6847+.nf
67416848 gm convert -size 1536x1024 img0009.pcd image.tiff
67426849 gm convert img0009.pcd[4] image.tiff
6743-\'
6744-\'
6850+.fi
6851+
67456852 To create a visual image directory of all your JPEG images, use:
6746-\'
6853+
6854+.nf
67476855 gm convert 'vid:*.jpg' directory.miff
6748-\'
6749-\'
6856+.fi
6857+
67506858 To annotate an image with blue text using font 12x24 at position (100,100),
67516859 use:
6752-\'
6860+
6861+.nf
67536862 gm convert -font helvetica -fill blue
67546863 -draw "text 100,100 Cockatoo"
67556864 bird.jpg bird.miff
6756-\'
6757-\'
6865+.fi
6866+
67586867 To tile a 640x480 image with a JPEG texture with bumps use:
6759-\'
6868+
6869+.nf
67606870 gm convert -size 640x480 tile:bumps.jpg tiled.png
6761-\'
6762-\'
6871+.fi
6872+
67636873 To surround an icon with an ornamental border to use with Mosaic(1), use:
6764-\'
6874+
6875+.nf
67656876 gm convert -mattecolor "#697B8F" -frame 6x6 bird.jpg
67666877 icon.png
6767-\'
6768-\'
6878+.fi
6879+
67696880 To create a MNG animation from a DNA molecule sequence, use:
6770-\'
6881+
6882+.nf
67716883 gm convert -delay 20 dna.* dna.mng
6772-\'
6884+.fi
67736885 .SH OPTIONS
6774-\'
6886+
67756887 Options are processed in command line order. Any option you specify on
67766888 the command line remains in effect for the set of images that follows,
67776889 until the set is terminated by the appearance of any option or \fB-noop\fP.
67786890 Some options only affect the decoding of images and others only the encoding.
67796891 The latter can appear after the final group of input images.
6780-\'
6892+
67816893 For a more detailed description of each option, see
67826894 Options, above.
6783-\'
6895+
67846896 .TP
67856897 .B "-adjoin"
67866898 \fRjoin images into a single multi-image file
@@ -6794,7 +6906,7 @@
67946906 .B "-append"
67956907 \fRappend a set of images
67966908 .TP
6797-.B " \fI-asc-cdl <spec>"\fP
6909+.B "-asc-cdl \fI<spec>"\fP
67986910 \fRapply ASC CDL color transform
67996911 .TP
68006912 .B "-authenticate \fI<string>"\fP
@@ -7240,11 +7352,11 @@
72407352 .TP
72417353 .B "-write \fI<filename>"\fP
72427354 \fRwrite an intermediate image [\fIconvert, composite\fP]
7243-\'
7355+
72447356 For a more detailed description of each option, see
72457357 Options, above.
72467358 .SH GM DISPLAY
7247-\'
7359+
72487360 Display is a machine architecture independent
72497361 image processing and display program. It can display an image on any workstation
72507362 screen running an X server. \fBDisplay\fP can read and write
@@ -7254,10 +7366,10 @@
72547366 \fBPNM\fP,
72557367 \fBPhoto
72567368 CD\fP, etc.).
7257-\'
7369+
72587370 With \fBdisplay\fP, you can perform these functions on an image:
72597371 .in 15
7260-\'
7372+
72617373 o load an image from a file
72627374 o display the next image
72637375 o display the former image
@@ -7321,66 +7433,74 @@
73217433 o discard all images and exit program
73227434 o change the level of magnification
73237435 o display images specified by a World Wide Web (WWW) uniform resource locator (URL)
7324-\'
7436+
73257437 .SH EXAMPLES
7326-\'
7438+
73277439 To scale an image of a cockatoo to exactly 640 pixels in width and 480
73287440 pixels in height and position the window at location (200,200), use:
7329-\'
7441+
7442+.nf
73307443 gm display -geometry 640x480+200+200! cockatoo.miff
7331-\'
7332-\'
7444+.fi
7445+
73337446 To display an image of a cockatoo without a border centered on a backdrop,
73347447 use:
7335-\'
7448+
7449+.nf
73367450 gm display +borderwidth -backdrop cockatoo.miff
7337-\'
7338-\'
7451+.fi
7452+
73397453 To tile a slate texture onto the root window, use:
7340-\'
7454+
7455+.nf
73417456 gm display -size 1280x1024 -window root slate.png
7342-\'
7343-\'
7457+.fi
7458+
73447459 To display a visual image directory of all your JPEG images, use:
7345-\'
7460+
7461+.nf
73467462 gm display 'vid:*.jpg'
7347-\'
7348-\'
7463+.fi
7464+
73497465 To display a MAP image that is 640 pixels in width and 480 pixels in height
73507466 with 256 colors, use:
7351-\'
7467+
7468+.nf
73527469 gm display -size 640x480+256 cockatoo.map
7353-\'
7354-\'
7470+.fi
7471+
73557472 To display an image of a cockatoo specified with a \fBWorld Wide Web (WWW)\fP
73567473 uniform resource locator \fB(URL)\fP, use:
7357-\'
7474+
7475+.nf
73587476 gm display ftp://wizards.dupont.com/images/cockatoo.jpg
7359-\'
7360-\'
7477+.fi
7478+
73617479 To display histogram of an image, use:
7362-\'
7480+
7481+.nf
73637482 gm gm convert file.jpg HISTOGRAM:- | gm display -
7364-\'
7483+.fi
73657484 .SH OPTIONS
7366-\'
7485+
73677486 Options are processed in command line order. Any option you specify on
73687487 the command line remains in effect until it is explicitly changed by specifying
73697488 the option again with a different effect. For example to display three images,
73707489 the first with 32 colors, the second with an unlimited number of colors,
73717490 and the third with only 16 colors, use:
7372-\'
7491+
7492+.nf
73737493 gm display -colors 32 cockatoo.miff -noop duck.miff
73747494 -colors 16 macaw.miff
7375-\'
7376-\'
7495+.fi
7496+
73777497 \fBDisplay\fP options can appear on the command line or in your X resources
73787498 file. See \fIX(1)\fP. Options on the command line supersede values specified
73797499 in your X resources file.
7380-\'
7500+
73817501 For a more detailed description of each option, see
73827502 Options, above.
7383-\'
7503+
73847504 .TP
73857505 .B "-authenticate \fI<string>"\fP
73867506 \fRdecrypt image with this password
@@ -7622,12 +7742,12 @@
76227742 .TP
76237743 .B "-write \fI<filename>"\fP
76247744 \fRwrite the image to a file [\fIdisplay\fP]
7625-\'
7745+
76267746 For a more detailed description of each option, see
76277747 Options, above.
7628-\'
7748+
76297749 .SH MOUSE BUTTONS
7630-\'
7750+
76317751 The effects of each button press is described below. Three buttons are
76327752 required. If you have a two button mouse, button 1 and 3 are returned.
76337753 Press \fBALT\fP and button 3 to simulate button 2.
@@ -7649,14 +7769,14 @@
76497769 is a visual image directory. Choose a particular tile of the directory
76507770 and press this button and drag to select a command from a pop-up menu.
76517771 Choose from these menu items:
7652-\'
7772+
76537773 Open
76547774 Next
76557775 Former
76567776 Delete
76577777 Update
7658-\'
7659-\'
7778+
7779+
76607780 If you choose \fBOpen\fP, the image represented by the tile is displayed.
76617781 To return to the visual image directory, choose \fBNext\fP from the Command
76627782 widget (refer to Command Widget).
@@ -7668,11 +7788,11 @@
76687788 and
76697789 miff for more details.
76707790 .SH COMMAND WIDGET
7671-\'
7791+
76727792 The Command widget lists a number of sub-menus and commands. They are
7673-\'
7793+
76747794 \fBFile\fP
7675-\'
7795+
76767796 Open...
76777797 Next
76787798 Former
@@ -7683,21 +7803,21 @@
76837803 Canvas...
76847804 Visual Directory...
76857805 Quit
7686-\'
7687-\'
7688-\'
7806+
7807+
7808+
76897809 \fBEdit\fP
7690-\'
7810+
76917811 Undo
76927812 Redo
76937813 Cut
76947814 Copy
76957815 Paste
7696-\'
7697-\'
7698-\'
7816+
7817+
7818+
76997819 \fBView\fP
7700-\'
7820+
77017821 Half Size
77027822 Original Size
77037823 Double Size
@@ -7705,11 +7825,11 @@
77057825 Apply
77067826 Refresh
77077827 Restore
7708-\'
7709-\'
7710-\'
7828+
7829+
7830+
77117831 \fBTransform\fP
7712-\'
7832+
77137833 Crop
77147834 Chop
77157835 Flop
@@ -7720,11 +7840,11 @@
77207840 Shear...
77217841 Roll...
77227842 Trim Edges
7723-\'
7724-\'
7725-\'
7843+
7844+
7845+
77267846 \fBEnhance\fP
7727-\'
7847+
77287848 Hue...
77297849 Saturation...
77307850 Brightness...
@@ -7736,11 +7856,11 @@
77367856 Negate
77377857 GRAYscale
77387858 Quantize...
7739-\'
7740-\'
7741-\'
7859+
7860+
7861+
77427862 \fBEffects\fP
7743-\'
7863+
77447864 Despeckle
77457865 Emboss
77467866 Reduce Noise
@@ -7753,22 +7873,22 @@
77537873 Shade...
77547874 Raise...
77557875 Segment...
7756-\'
7757-\'
7758-\'
7876+
7877+
7878+
77597879 \fBF/X\fP
7760-\'
7880+
77617881 Solarize...
77627882 Swirl...
77637883 Implode...
77647884 Wave...
77657885 Oil Paint...
77667886 Charcoal Draw...
7767-\'
7768-\'
7769-\'
7887+
7888+
7889+
77707890 \fBImage Edit\fP
7771-\'
7891+
77727892 Annotate...
77737893 Draw...
77747894 Color...
@@ -7779,11 +7899,11 @@
77797899 Comment...
77807900 Launch...
77817901 Region of Interest...
7782-\'
7783-\'
7784-\'
7902+
7903+
7904+
77857905 \fBMiscellany\fP
7786-\'
7906+
77877907 Image Info
77887908 Zoom Image
77897909 Show Preview...
@@ -7792,17 +7912,17 @@
77927912 Background...
77937913 Slide Show
77947914 Preferences...
7795-\'
7796-\'
7797-\'
7915+
7916+
7917+
77987918 \fBHelp\fP
7799-\'
7919+
78007920 Overview
78017921 Browse Documentation
78027922 About Display
7803-\'
7804-\'
7805-\'
7923+
7924+
7925+
78067926 Menu items with a indented triangle have a sub-menu. They are represented
78077927 above as the indented items. To access a sub-menu item, move the pointer
78087928 to the appropriate menu and press button 1 and drag. When you find the
@@ -7810,30 +7930,33 @@
78107930 Move the pointer away from the sub-menu if you decide not to execute a
78117931 particular command.
78127932 .SH KEYBOARD ACCELERATORS
7813-\'
7933+
78147934 Accelerators are one or two key presses that effect a particular command.
78157935 The keyboard accelerators that
78167936 \fBdisplay\fP understands is:
7817-\'
7937+
7938+.nf
78187939 Ctl+O Press to load an image from a file.
78197940 space Press to display the next image.
7820-\'
7821-\'
7941+.fi
7942+
78227943 If the image is a multi-paged document such as a
78237944 \fIPostScript\fP document,
78247945 you can skip ahead several pages by preceding this command with a number.
78257946 For example to display the fourth page beyond the current page,
78267947 press 4space.
7827-\'
7948+
7949+.nf
78287950 backspace Press to display the former image.
7829-\'
7830-\'
7951+.fi
7952+
78317953 If the image is a multi-paged document such as a
78327954 \fIPostScript\fP document,
78337955 you can skip behind several pages by preceding this command with a number.
78347956 For example to display the fourth page preceding the current page, press
78357957 4n.
7836-\'
7958+
7959+.nf
78377960 Ctl-S Press to save the image to a file.
78387961 Ctl-P Press to print the image to a
78397962 \fIPostScript\fP printer.
@@ -7933,20 +8056,20 @@
79338056 Find Press to browse documentation about
79348057 GraphicsMagick.
79358058 1-9 Press to change the level of magnification.
7936-\'
7937-\'
8059+.fi
8060+
79388061 Use the arrow keys to move the image one pixel up, down, left, or right
79398062 within the magnify window. Be sure to first map the magnify window by pressing
79408063 button 2.
7941-\'
8064+
79428065 Press ALT and one of the arrow keys to trim off one pixel from any side
79438066 of the image.
79448067 .SH X RESOURCES
7945-\'
8068+
79468069 \fBDisplay\fP options can appear on the command line or in your X resource
79478070 file. Options on the command line supersede values specified in your X
79488071 resource file. See \fIX(1)\fP for more information on X resources.
7949-\'
8072+
79508073 Most \fBdisplay\fP options have a corresponding X resource. In addition,
79518074 \fBdisplay\fP
79528075 uses the following X resources:
@@ -8018,7 +8141,7 @@
80188141 \fR
80198142 Specifies the preferred size and position of the image window. It is not
80208143 necessarily obeyed by all window managers.
8021-\'
8144+
80228145 Offsets, if present, are handled in \fIX(1)\fP style. A negative x offset is
80238146 measured from the right edge of the screen to the right edge of the icon,
80248147 and a negative y offset is measured from the bottom edge of the screen
@@ -8028,7 +8151,7 @@
80288151 \fR
80298152 Specifies the preferred size and position of the application when iconified.
80308153 It is not necessarily obeyed by all window managers.
8031-\'
8154+
80328155 Offsets, if present, are handled in the same manner as in class Geometry.
80338156 .TP
80348157 .B "iconic \fI(class Iconic)"\fP
@@ -8104,14 +8227,15 @@
81048227 exceeds the dimensions of your server screen and you intend to pan the
81058228 image. Panning is much faster with Pixmaps than with a XImage. Pixmaps
81068229 are considered a precious resource, use them with discretion.
8107-\'
8230+
81088231 To set the geometry of the Magnify or Pan or window, use the geometry resource.
81098232 For example, to set the Pan window geometry to 256x256, use:
8110-\'
8233+
8234+.nf
81118235 gm display.pan.geometry: 256x256
8112-\'
8236+.fi
81138237 .SH IMAGE LOADING
8114-\'
8238+
81158239 To select an image to display, choose \fBOpen\fP of the \fBFile\fP sub-menu
81168240 from the Command widget. A file browser is displayed.
81178241 To choose a particular image file, move the pointer to the filename and
@@ -8122,15 +8246,15 @@
81228246 name and press the button twice quickly. A scrollbar allows a large list
81238247 of filenames to be moved through the viewing area if it exceeds the size
81248248 of the list area.
8125-\'
8249+
81268250 You can trim the list of file names by using shell globbing characters.
81278251 For example, type *.jpg to list only files that end
81288252 with .jpg.
8129-\'
8253+
81308254 To select your image from the X server screen instead of from a file, Choose
81318255 \fBGrab\fP of the \fBOpen\fP widget.
81328256 .SH VISUAL IMAGE DIRECTORY
8133-\'
8257+
81348258 To create a Visual Image Directory, choose Visual Directory of the \fBFile\fP
81358259 sub-menu from the Command widget . A file browser is
81368260 displayed. To create a Visual Image Directory from all the images in the
@@ -8141,7 +8265,7 @@
81418265 and press the button twice quickly. A scrollbar allows a large list of
81428266 filenames to be moved through the viewing area if it exceeds the size of
81438267 the list area.
8144-\'
8268+
81458269 After you select a set of files, they are turned into thumbnails and tiled
81468270 onto a single image. Now move the pointer to a particular thumbnail and
81478271 press \fBbutton 3\fP and drag. Finally, select Open. The image represented
@@ -8149,83 +8273,83 @@
81498273 the \fBFile\fP sub-menu of the Command widget to return to the Visual
81508274 Image Directory.
81518275 .SH IMAGE CUTTING
8152-\'
8276+
81538277 Note that cut information for image window is not retained for colormapped
81548278 X server visuals (e.g. \fIStaticColor\fP,
81558279 \fIStaticColor\fP, \fIGRAYScale\fP,
81568280 \fIPseudoColor\fP).
81578281 Correct cutting behavior may require a \fITrueColor\fP or \fIDirectColor\fP
81588282 visual or a \fIStandard Colormap\fP.
8159-\'
8283+
81608284 To begin, press choose \fBCut\fP of the \fBEdit\fP sub-menu from the
81618285 Command
81628286 widget. Alternatively, press
81638287 \fBF3\fP in the image window.
8164-\'
8288+
81658289 A small window appears showing the location of the cursor in the image
81668290 window. You are now in cut mode. In cut mode, the Command widget has these
81678291 options:
8168-\'
8292+
81698293 \fBHelp\fP
81708294 \fBDismiss\fP
8171-\'
8172-\'
8295+
8296+
81738297 To define a cut region, press button 1 and drag. The cut region is defined
81748298 by a highlighted rectangle that expands or contracts as it follows the
81758299 pointer. Once you are satisfied with the cut region, release the button.
81768300 You are now in rectify mode. In rectify mode, the Command widget has these
81778301 options:
8178-\'
8302+
81798303 \fBCut\fP
81808304 \fBHelp\fP
81818305 \fBDismiss\fP
8182-\'
8183-\'
8306+
8307+
81848308 You can make adjustments by moving the pointer to one of the cut rectangle
81858309 corners, pressing a button, and dragging. Finally, press Cut to commit
81868310 your copy region. To exit without cutting the image, press Dismiss.
81878311 .SH IMAGE COPYING
8188-\'
8312+
81898313 To begin, press choose \fBCopy\fP of the \fBEdit\fP sub-menu from the
81908314 Command
81918315 widget. Alternatively, press
81928316 \fBF4\fP in the image window.
8193-\'
8317+
81948318 A small window appears showing the location of the cursor in the image
81958319 window. You are now in copy mode. In copy mode, the Command widget has
81968320 these options:
8197-\'
8321+
81988322 Help
81998323 Dismiss
8200-\'
8201-\'
8324+
8325+
82028326 To define a copy region, press button 1 and drag. The copy region is defined
82038327 by a highlighted rectangle that expands or contracts as it follows the
82048328 pointer. Once you are satisfied with the copy region, release the button.
82058329 You are now in rectify mode. In rectify mode, the Command widget has these
82068330 options:
8207-\'
8331+
82088332 Copy
82098333 Help
82108334 Dismiss
8211-\'
8212-\'
8335+
8336+
82138337 You can make adjustments by moving the pointer to one of the copy rectangle
82148338 corners, pressing a button, and dragging. Finally, press Copy to commit
82158339 your copy region. To exit without copying the image, press Dismiss.
82168340 .SH IMAGE PASTING
8217-\'
8341+
82188342 To begin, press choose \fBPaste\fP of the \fBEdit\fP sub-menu from the
82198343 Command
82208344 widget. Alternatively, press
82218345 \fBF5\fP in the image window.
8222-\'
8346+
82238347 A small window appears showing the location of the cursor in the image
82248348 window. You are now in Paste mode. To exit immediately, press Dismiss.
82258349 In Paste mode, the Command widget has these options:
8226-\'
8350+
82278351 \fBOperators\fP
8228-\'
8352+
82298353 over
82308354 in
82318355 out
@@ -8239,11 +8363,11 @@
82398363 multiply
82408364 bumpmap
82418365 replace
8242-\'
8366+
82438367 \fBHelp\fP
82448368 \fBDismiss\fP
8245-\'
8246-\'
8369+
8370+
82478371 Choose a composite operation from the \fBOperators\fP sub-menu of the
82488372 Command
82498373 widget. How each operator behaves is described below. \fIimage window\fP
@@ -8323,7 +8447,7 @@
83238447 \fRThe resulting image is \fIimage window\fP replaced with
83248448 \fIimage\fP.
83258449 Here the matte information is ignored.
8326-\'
8450+
83278451 The image compositor requires a matte, or alpha channel in the image for
83288452 some operations. This extra channel usually defines a mask which represents
83298453 a sort of a cookie-cutter for the image. This is the case when matte is
@@ -8332,18 +8456,18 @@
83328456 is initialized with 0 for any pixel matching in color to pixel location
83338457 (0,0), otherwise 255. See Matte Editing for a method
83348458 of defining a matte channel.
8335-\'
8459+
83368460 Note that matte information for image window is not retained for colormapped
83378461 X server visuals (e.g. \fIStaticColor, StaticColor, GrayScale, PseudoColor\fP).
83388462 Correct compositing behavior may require a
83398463 \fITrueColor\fP or \fIDirectColor\fP
83408464 visual or a \fIStandard Colormap\fP.
8341-\'
8465+
83428466 Choosing a composite operator is optional. The default operator is replace.
83438467 However, you must choose a location to composite your image and press button
83448468 1. Press and hold the button before releasing and an outline of the image
83458469 will appear to help you identify your location.
8346-\'
8470+
83478471 The actual colors of the pasted image is saved. However, the color that
83488472 appears in image window may be different. For example, on a monochrome
83498473 screen image window will appear black or white even though your pasted
@@ -8354,80 +8478,80 @@
83548478 \fIPseudoClass\fP image to remain \fIPseudoClass\fP,
83558479 use \fB-colors\fP.
83568480 .SH IMAGE CROPPING
8357-\'
8481+
83588482 To begin, press choose \fBCrop\fP of the \fBTransform\fP submenu from
83598483 the Command widget. Alternatively,
83608484 press C in the image window.
8361-\'
8485+
83628486 A small window appears showing the location of the cursor in the image
83638487 window. You are now in crop mode. In crop mode, the Command widget has
83648488 these options:
8365-\'
8489+
83668490 \fBHelp\fP
83678491 \fBDismiss\fP
8368-\'
8369-\'
8492+
8493+
83708494 To define a cropping region, press button 1 and drag. The cropping region
83718495 is defined by a highlighted rectangle that expands or contracts as it follows
83728496 the pointer. Once you are satisfied with the cropping region, release the
83738497 button. You are now in rectify mode. In rectify mode, the Command widget
83748498 has these options:
8375-\'
8499+
83768500 \fBCrop\fP
83778501 \fBHelp\fP
83788502 \fBDismiss\fP
8379-\'
8380-\'
8503+
8504+
83818505 You can make adjustments by moving the pointer to one of the cropping rectangle
83828506 corners, pressing a button, and dragging. Finally, press Crop to commit
83838507 your cropping region. To exit without cropping the image, press Dismiss.
83848508 .SH IMAGE CHOPPING
8385-\'
8509+
83868510 An image is chopped interactively. There is no command line argument to
83878511 chop an image. To begin, choose \fBChop\fP of the \fBTransform\fP sub-menu
83888512 from the Command widget. Alternatively,
83898513 press [ in the Image window.
8390-\'
8514+
83918515 You are now in \fBChop\fP mode. To exit immediately, press
83928516 \fBDismiss\fP.
83938517 In Chop mode, the Command widget has these options:
8394-\'
8518+
83958519 \fBDirection\fP
8396-\'
8520+
83978521 horizontal
83988522 vertical
8399-\'
8523+
84008524 \fBHelp\fP
84018525 \fBDismiss\fP
8402-\'
8403-\'
8526+
8527+
84048528 If the you choose the horizontal direction (this is the default), the area
84058529 of the image between the two horizontal endpoints of the chop line is removed.
84068530 Otherwise, the area of the image between the two vertical endpoints of
84078531 the chop line is removed.
8408-\'
8532+
84098533 Select a location within the image window to begin your chop, press and
84108534 hold any button. Next, move the pointer to another location in the image.
84118535 As you move a line will connect the initial location and the pointer. When
84128536 you release the button, the area within the image to chop is determined
84138537 by which direction you choose from the Command widget.
8414-\'
8538+
84158539 To cancel the image chopping, move the pointer back to the starting point
84168540 of the line and release the button.
84178541 .SH IMAGE ROTATION
8418-\'
8542+
84198543 Press the / key to rotate the image 90 degrees or \\ to rotate -90 degrees.
84208544 To interactively choose the degree of rotation, choose
84218545 \fBRotate...\fP
84228546 of the \fBTransform\fP submenu from the Command Widget.
84238547 Alternatively, press * in the image window.
8424-\'
8548+
84258549 A small horizontal line is drawn next to the pointer. You are now in rotate
84268550 mode. To exit immediately, press Dismiss. In rotate mode, the Command widget
84278551 has these options:
8428-\'
8552+
84298553 \fBPixel Color\fP
8430-\'
8554+
84318555 black
84328556 blue
84338557 cyan
@@ -8438,48 +8562,48 @@
84388562 yellow
84398563 white
84408564 Browser...
8441-\'
8565+
84428566 \fBDirection\fP
8443-\'
8567+
84448568 horizontal
84458569 vertical
8446-\'
8570+
84478571 \fBHelp\fP
84488572 \fBDismiss\fP
8449-\'
8450-\'
8573+
8574+
84518575 Choose a background color from the Pixel Color sub-menu. Additional background
84528576 colors can be specified with the color browser. You can change the menu
84538577 colors by setting the X resources pen1 through pen9.
8454-\'
8578+
84558579 If you choose the color browser and press \fBGrab\fP, you can select the
84568580 background color by moving the pointer to the desired color on the screen
84578581 and press any button.
8458-\'
8582+
84598583 Choose a point in the image window and press this button and hold. Next,
84608584 move the pointer to another location in the image. As you move a line connects
84618585 the initial location and the pointer. When you release the button, the
84628586 degree of image rotation is determined by the slope of the line you just
84638587 drew. The slope is relative to the direction you choose from the Direction
84648588 sub-menu of the Command widget.
8465-\'
8589+
84668590 To cancel the image rotation, move the pointer back to the starting point
84678591 of the line and release the button.
84688592 .SH IMAGE ANNOTATION
8469-\'
8593+
84708594 An image is annotated interactively. There is no command line argument
84718595 to annotate an image. To begin, choose
84728596 \fBAnnotate\fP of the \fBImage
84738597 Edit\fP sub-menu from the Command widget. Alternatively,
84748598 press a in the image window.
8475-\'
8599+
84768600 A small window appears showing the location of the cursor in the image
84778601 window. You are now in annotate mode. To exit immediately, press Dismiss.
84788602 In annotate mode, the Command widget has these options:
8479-\'
8603+
84808604
84818605 \fBFont Name\fP
8482-\'
8606+
84838607
84848608 fixed
84858609
@@ -8500,10 +8624,10 @@
85008624 12x24
85018625
85028626 Browser...
8503-\'
8627+
85048628
85058629 \fBFont Color\fP
8506-\'
8630+
85078631
85088632 black
85098633
@@ -8526,10 +8650,10 @@
85268650 transparent
85278651
85288652 Browser...
8529-\'
8653+
85308654
85318655 \fBBox Color\fP
8532-\'
8656+
85338657
85348658 black
85358659
@@ -8552,10 +8676,10 @@
85528676 transparent
85538677
85548678 Browser...
8555-\'
8679+
85568680
85578681 \fBRotate Text\fP
8558-\'
8682+
85598683
85608684 -90
85618685
@@ -8574,36 +8698,36 @@
85748698 180
85758699
85768700 Dialog...
8577-\'
8701+
85788702
85798703 \fBHelp\fP
85808704
85818705 \fBDismiss\fP
8582-\'
8583-\'
8706+
8707+
85848708 Choose a font name from the \fBFont Name\fP sub-menu. Additional font
85858709 names can be specified with the font browser. You can change the menu names
85868710 by setting the X resources font1 through font9.
8587-\'
8711+
85888712 Choose a font color from the \fBFont Color\fP sub-menu. Additional font
85898713 colors can be specified with the color browser. You can change the menu
85908714 colors by setting the X resources pen1 through pen9.
8591-\'
8715+
85928716 If you select the color browser and press \fBGrab\fP, you can choose the
85938717 font color by moving the pointer to the desired color on the screen and
85948718 press any button.
8595-\'
8719+
85968720 If you choose to rotate the text, choose \fBRotate Text\fP from the menu
85978721 and select an angle. Typically you will only want to rotate one line of
85988722 text at a time. Depending on the angle you choose, subsequent lines may
85998723 end up overwriting each other.
8600-\'
8724+
86018725 Choosing a font and its color is optional. The default font is fixed and
86028726 the default color is black. However, you must choose a location to begin
86038727 entering text and press a button. An underscore character will appear at
86048728 the location of the pointer. The cursor changes to a pencil to indicate
86058729 you are in text mode. To exit immediately, press Dismiss.
8606-\'
8730+
86078731 In text mode, any key presses will display the character at the location
86088732 of the underscore and advance the underscore cursor. Enter your text and
86098733 once completed press Apply to finish your image annotation. To correct
@@ -8611,7 +8735,7 @@
86118735 \fBDELETE\fP.
86128736 Any text that exceeds the boundaries of the image window is automatically
86138737 continued onto the next line.
8614-\'
8738+
86158739 The actual color you request for the font is saved in the image. However,
86168740 the color that appears in your Image window may be different. For example,
86178741 on a monochrome screen the text will appear black or white even if you
@@ -8622,30 +8746,30 @@
86228746 to remain
86238747 \fIPseudoClass\fP, use \fB-colors\fP.
86248748 .SH IMAGE COMPOSITING
8625-\'
8749+
86268750 An image composite is created interactively. \fBThere is no command line
86278751 argument to composite an image\fP. To begin, choose \fBComposite\fP of
86288752 the \fBImage Edit\fP from the Command widget. Alternatively,
86298753 press x in the Image window.
8630-\'
8754+
86318755 First a popup window is displayed requesting you to enter an image name.
86328756 Press \fBComposite\fP, \fBGrab\fP or type a file name. Press \fBCancel\fP
86338757 if you choose not to create a composite image. When you choose \fBGrab\fP,
86348758 move the pointer to the desired window and press any button.
8635-\'
8759+
86368760 If the \fBComposite\fP image does not have any matte information, you
86378761 are informed and the file browser is displayed again. Enter the name of
86388762 a mask image. The image is typically grayscale and the same size as the
86398763 composite image. If the image is not grayscale, it is converted to grayscale
86408764 and the resulting intensities are used as matte information.
8641-\'
8765+
86428766 A small window appears showing the location of the cursor in the image
86438767 window. You are now in composite mode. To exit immediately, press Dismiss.
86448768 In composite mode, the Command widget has these options:
8645-\'
8769+
86468770
86478771 \fBOperators\fP
8648-\'
8772+
86498773
86508774 over
86518775
@@ -8670,7 +8794,7 @@
86708794 bumpmap
86718795
86728796 replace
8673-\'
8797+
86748798
86758799 \fBBlend\fP
86768800
@@ -8679,8 +8803,8 @@
86798803 \fBHelp\fP
86808804
86818805 \fBDismiss\fP
8682-\'
8683-\'
8806+
8807+
86848808 Choose a composite operation from the Operators sub-menu of the Command
86858809 widget. How each operator behaves is described below. image window is the
86868810 image currently displayed on your X server and image is the image obtained
@@ -8753,7 +8877,7 @@
87538877 The resulting image is \fIimage window\fP replaced with
87548878 \fIimage\fP.
87558879 Here the matte information is ignored.
8756-\'
8880+
87578881 The image compositor requires a matte, or alpha channel in the image for
87588882 some operations. This extra channel usually defines a mask which represents
87598883 a sort of a cookie-cutter for the image. This is the case when matte is
@@ -8762,12 +8886,12 @@
87628886 is initialized with 0 for any pixel matching in color to pixel location
87638887 (0,0), otherwise 255. See Matte Editing for a method
87648888 of defining a matte channel.
8765-\'
8889+
87668890 If you choose \fBblend\fP, the composite operator becomes \fBover\fP.
87678891 The image matte channel percent transparency is initialized to factor.
87688892 The image window is initialized to (100-factor). Where factor is the value
87698893 you specify in the Dialog widget.
8770-\'
8894+
87718895 \fBDisplace\fP shifts the image pixels as defined by a displacement map.
87728896 With this option, \fIimage\fP is used as a displacement map. Black, within
87738897 the displacement map, is a maximum positive displacement. White is a maximum
@@ -8778,19 +8902,19 @@
87788902 \fIimage\fP
87798903 is the horizontal X displacement and
87808904 \fImask\fP the vertical Y displacement.
8781-\'
8905+
87828906 Note that matte information for image window is not retained for colormapped
87838907 X server visuals (e.g.
87848908 \fIStaticColor, StaticColor, GrayScale, PseudoColor\fP).
87858909 Correct compositing behavior may require a \fITrueColor\fP or
87868910 \fIDirectColor\fP
87878911 visual or a \fIStandard Colormap\fP.
8788-\'
8912+
87898913 Choosing a composite operator is optional. The default operator is replace.
87908914 However, you must choose a location to composite your image and press button
87918915 1. Press and hold the button before releasing and an outline of the image
87928916 will appear to help you identify your location.
8793-\'
8917+
87948918 The actual colors of the composite image is saved. However, the color that
87958919 appears in image window may be different. For example, on a monochrome
87968920 screen Image window will appear black or white even though your composited
@@ -8801,20 +8925,20 @@
88018925 To force a \fIPseudoClass\fP image to remain \fIPseudoClass\fP,
88028926 use \fB-colors\fP.
88038927 .SH COLOR EDITING
8804-\'
8928+
88058929 Changing the the color of a set of pixels is performed interactively. There
88068930 is no command line argument to edit a pixel. To begin, choose \fBColor\fP
88078931 from the \fBImage Edit\fP submenu of the Command widget.
88088932 Alternatively, press c in the image window.
8809-\'
8933+
88108934 A small window appears showing the location of the cursor in the image
88118935 window. You are now in color edit mode. To exit immediately, press \fBDismiss\fP.
88128936 In color edit mode, the
88138937 \fBCommand widget\fP has these options:
8814-\'
8938+
88158939
88168940 \fBMethod\fP
8817-\'
8941+
88188942
88198943 point
88208944
@@ -8823,34 +8947,10 @@
88238947 floodfill
88248948
88258949 reset
8826-\'
8950+
88278951
88288952 \fBPixel Color\fP
8829-\'
8830-
8831-black
8832-
8833-blue
8834-
8835-cyan
8836-
8837-green
8838-
8839-gray
8840-
8841-red
8842-
8843-magenta
8844-
8845-yellow
8846-
8847-white
8848-
8849-Browser...
8850-\'
8851-
8852-\fBBorder Color\fP
8853-\'
8953+
88548954
88558955 black
88568956
@@ -8871,99 +8971,10 @@
88718971 white
88728972
88738973 Browser...
8874-\'
8875-
8876-\fBFuzz\fP
8877-\'
8878-
8879-0
8880-
8881-2
8882-
8883-4
8884-
8885-8
8886-
8887-16
8888- Dialog...
8889-\'
8890-
8891-\fBUndo\fP
8892-
8893-\fBHelp\fP
8894-
8895-\fBDismiss\fP
8896-\'
8897-\'
8898-Choose a color editing method from the \fBMethod\fP sub-menu of
8899-the Command
8900-widget. The \fBpoint method\fP recolors any pixel selected with the
8901-pointer unless the button is released. The \fBreplace method\fP recolors
8902-any pixel that matches the color of the pixel you select with a button
8903-press. \fBFloodfill\fP recolors any pixel that matches the color of the
8904-pixel you select with a button press and is a neighbor.
8905-Whereas \fBfilltoborder\fP
8906-changes the matte value of any neighbor pixel that is not the border color.
8907-Finally \fBreset\fP changes the entire image to the designated color.
8908-\'
8909-Next, choose a pixel color from the \fBPixel Color\fP sub-menu. Additional
8910-pixel colors can be specified with the color browser. You can change the
8911-menu colors by setting the X resources pen1 through
8912-pen9.
8913-\'
8914-Now press button 1 to select a pixel within the Image window to change
8915-its color. Additional pixels may be recolored as prescribed by the method
8916-you choose. additional pixels by increasing the Delta value.
8917-\'
8918-If the \fBMagnify widget\fP is mapped, it can be helpful in positioning
8919-your pointer within the image (refer to button 2). Alternatively you can
8920-select a pixel to recolor from within the \fBMagnify widget\fP. Move the
8921-pointer to the \fBMagnify widget\fP and position the pixel with the cursor
8922-control keys. Finally, press a button to recolor the selected pixel (or
8923-pixels).
8924-\'
8925-The actual color you request for the pixels is saved in the image. However,
8926-the color that appears in your Image window may be different. For example,
8927-on a monochrome screen the pixel will appear black or white even if you
8928-choose the color red as the pixel color. However, the image saved to a
8929-file with -write is written with red pixels. To assure the correct color
8930-text in the final image, any \fIPseudoClass\fP image is promoted
8931-to \fIDirectClass\fP
8932-To force a \fIPseudoClass\fP image to remain
8933-\fIPseudoClass\fP, use \fB-colors\fP.
8934-.SH MATTE EDITING
8935-\'
8936-Matte information within an image is useful for some operations such as
8937-image compositing. This extra channel usually defines
8938-a mask which represents a sort of a cookie-cutter for the image. This is
8939-the case when matte is 255 (full coverage) for pixels inside the shape,
8940-zero outside, and between zero and 255 on the boundary.
8941-\'
8942-Setting the matte information in an image is done interactively. There
8943-is no command line argument to edit a pixel. To begin, and choose \fBMatte\fP
8944-of the \fBImage Edit\fP sub-menu from the Command widget.
8945-\'
8946-Alternatively, press m in the image window.
8947-\'
8948-A small window appears showing the location of the cursor in the image
8949-window. You are now in matte edit mode. To exit immediately, press Dismiss.
8950-In matte edit mode, the Command widget has these options:
8951-\'
8952-
8953-\fBMethod\fP
8954-\'
8955-
8956-point
8957-
8958-replace
8959-
8960-floodfill
8961-
8962-reset
8963-\'
8974+
89648975
89658976 \fBBorder Color\fP
8966-\'
8977+
89678978
89688979 black
89698980
@@ -8984,10 +8995,10 @@
89848995 white
89858996
89868997 Browser...
8987-\'
8998+
89888999
89899000 \fBFuzz\fP
8990-\'
9001+
89919002
89929003 0
89939004
@@ -8999,7 +9010,120 @@
89999010
90009011 16
90019012 Dialog...
9002-\'
9013+
9014+
9015+\fBUndo\fP
9016+
9017+\fBHelp\fP
9018+
9019+\fBDismiss\fP
9020+
9021+
9022+Choose a color editing method from the \fBMethod\fP sub-menu of
9023+the Command
9024+widget. The \fBpoint method\fP recolors any pixel selected with the
9025+pointer unless the button is released. The \fBreplace method\fP recolors
9026+any pixel that matches the color of the pixel you select with a button
9027+press. \fBFloodfill\fP recolors any pixel that matches the color of the
9028+pixel you select with a button press and is a neighbor.
9029+Whereas \fBfilltoborder\fP
9030+changes the matte value of any neighbor pixel that is not the border color.
9031+Finally \fBreset\fP changes the entire image to the designated color.
9032+
9033+Next, choose a pixel color from the \fBPixel Color\fP sub-menu. Additional
9034+pixel colors can be specified with the color browser. You can change the
9035+menu colors by setting the X resources pen1 through
9036+pen9.
9037+
9038+Now press button 1 to select a pixel within the Image window to change
9039+its color. Additional pixels may be recolored as prescribed by the method
9040+you choose. additional pixels by increasing the Delta value.
9041+
9042+If the \fBMagnify widget\fP is mapped, it can be helpful in positioning
9043+your pointer within the image (refer to button 2). Alternatively you can
9044+select a pixel to recolor from within the \fBMagnify widget\fP. Move the
9045+pointer to the \fBMagnify widget\fP and position the pixel with the cursor
9046+control keys. Finally, press a button to recolor the selected pixel (or
9047+pixels).
9048+
9049+The actual color you request for the pixels is saved in the image. However,
9050+the color that appears in your Image window may be different. For example,
9051+on a monochrome screen the pixel will appear black or white even if you
9052+choose the color red as the pixel color. However, the image saved to a
9053+file with -write is written with red pixels. To assure the correct color
9054+text in the final image, any \fIPseudoClass\fP image is promoted
9055+to \fIDirectClass\fP
9056+To force a \fIPseudoClass\fP image to remain
9057+\fIPseudoClass\fP, use \fB-colors\fP.
9058+.SH MATTE EDITING
9059+
9060+Matte information within an image is useful for some operations such as
9061+image compositing. This extra channel usually defines
9062+a mask which represents a sort of a cookie-cutter for the image. This is
9063+the case when matte is 255 (full coverage) for pixels inside the shape,
9064+zero outside, and between zero and 255 on the boundary.
9065+
9066+Setting the matte information in an image is done interactively. There
9067+is no command line argument to edit a pixel. To begin, and choose \fBMatte\fP
9068+of the \fBImage Edit\fP sub-menu from the Command widget.
9069+
9070+Alternatively, press m in the image window.
9071+
9072+A small window appears showing the location of the cursor in the image
9073+window. You are now in matte edit mode. To exit immediately, press Dismiss.
9074+In matte edit mode, the Command widget has these options:
9075+
9076+
9077+\fBMethod\fP
9078+
9079+
9080+point
9081+
9082+replace
9083+
9084+floodfill
9085+
9086+reset
9087+
9088+
9089+\fBBorder Color\fP
9090+
9091+
9092+black
9093+
9094+blue
9095+
9096+cyan
9097+
9098+green
9099+
9100+gray
9101+
9102+red
9103+
9104+magenta
9105+
9106+yellow
9107+
9108+white
9109+
9110+Browser...
9111+
9112+
9113+\fBFuzz\fP
9114+
9115+
9116+0
9117+
9118+2
9119+
9120+4
9121+
9122+8
9123+
9124+16
9125+ Dialog...
9126+
90039127
90049128 \fBMatte\fP
90059129
@@ -9008,7 +9132,7 @@
90089132 \fBHelp\fP
90099133
90109134 \fBDismiss\fP
9011-\'
9135+
90129136 Choose a matte editing method from the \fBMethod\fP sub-menu of the Command
90139137 widget. The \fBpoint method\fP changes the matte value of the any
90149138 pixel selected with the pointer until the button is released. The \fBreplace
@@ -9043,19 +9167,19 @@
90439167 matte editing behavior may require a \fITrueColor\fP or \fIDirectColor\fP
90449168 visual or a \fIStandard Colormap\fP.
90459169 .SH IMAGE DRAWING
9046-\'
9170+
90479171 An image is drawn upon interactively. \fBThere is no command line argument
90489172 to draw on an image\fP. To begin, choose \fBDraw\fP of the Image \fBEdit\fP
90499173 sub-menu from the Command widget.
90509174 Alternatively, press d in the image window.
9051-\'
9175+
90529176 The cursor changes to a crosshair to indicate you are in draw mode. To
90539177 exit immediately, press Dismiss. In draw mode, the Command widget has these
90549178 options:
9055-\'
9179+
90569180
90579181 \fBPrimitive\fP
9058-\'
9182+
90599183
90609184 point
90619185
@@ -9076,10 +9200,10 @@
90769200 polygon
90779201
90789202 fill polygon
9079-\'
9203+
90809204
90819205 \fBColor\fP
9082-\'
9206+
90839207
90849208 black
90859209
@@ -9102,10 +9226,10 @@
91029226 transparent
91039227
91049228 Browser...
9105-\'
9229+
91069230
91079231 \fBStipple\fP
9108-\'
9232+
91099233
91109234 Brick
91119235
@@ -9122,10 +9246,10 @@
91229246 Opaque
91239247
91249248 Open...
9125-\'
9249+
91269250
91279251 \fBWidth\fP
9128-\'
9252+
91299253
91309254 1
91319255
@@ -9137,82 +9261,82 @@
91379261
91389262 16
91399263 Dialog...
9140-\'
9264+
91419265
91429266 \fBUndo\fP
91439267
91449268 \fBHelp\fP
91459269
91469270 \fBDismiss\fP
9147-\'
9271+
91489272 Choose a drawing primitive from the \fBPrimitive\fP sub-menu.
9149-\'
9273+
91509274 Next, choose a color from the \fBColor\fP sub-menu. Additional colors
91519275 can be specified with the color browser. You can change the menu colors
91529276 by setting the X resources pen1 through pen9. The transparent
91539277 color updates the image matte channel and is useful for image compositing.
9154-\'
9278+
91559279 If you choose the color browser and press \fBGrab\fP, you can select the
91569280 primitive color by moving the pointer to the desired color on the screen
91579281 and press any button. The transparent color updates the image matte channel
91589282 and is useful for image compositing.
9159-\'
9283+
91609284 Choose a stipple, if appropriate, from the \fBStipple\fP sub-menu. Additional
91619285 stipples can be specified with the file browser. Stipples obtained from
91629286 the file browser must be on disk in the X11 bitmap format.
9163-\'
9287+
91649288 Choose a line width, if appropriate, from the \fBWidth\fP sub-menu. To
91659289 choose a specific width select the \fBDialog\fP widget.
9166-\'
9290+
91679291 Choose a point in the image window and press button 1 and hold. Next, move
91689292 the pointer to another location in the image. As you move, a line connects
91699293 the initial location and the pointer. When you release the button, the
91709294 image is updated with the primitive you just drew. For polygons, the image
91719295 is updated when you press and release the button without moving the pointer.
9172-\'
9296+
91739297 To cancel image drawing, move the pointer back to the starting point of
91749298 the line and release the button.
91759299 .SH REGION OF INTEREST
9176-\'
9300+
91779301 To begin, press choose Region of Interest of the Pixel Transform sub-menu
91789302 from the Command widget.
91799303 Alternatively, press R in the image window.
9180-\'
9304+
91819305 A small window appears showing the location of the cursor in the image
91829306 window. You are now in region of interest mode. In region of interest mode,
91839307 the Command widget has these options:
9184-\'
9308+
91859309
91869310 \fBHelp\fP
91879311
91889312 \fBDismiss\fP
9189-\'
9190-\'
9313+
9314+
91919315 To define a region of interest, press button 1 and drag. The region of
91929316 interest is defined by a highlighted rectangle that expands or contracts
91939317 as it follows the pointer. Once you are satisfied with the region of interest,
91949318 release the button. You are now in apply mode. In apply mode the Command
91959319 widget has these options:
9196-\'
9320+
91979321
91989322 \fBFile\fP
9199-\'
9323+
92009324
92019325 Save...
92029326
92039327 Print...
9204-\'
9328+
92059329
92069330 \fBEdit\fP
9207-\'
9331+
92089332
92099333 Undo
92109334
92119335 Redo
9212-\'
9336+
92139337
92149338 \fBTransform\fP
9215-\'
9339+
92169340
92179341 Flip
92189342
@@ -9221,10 +9345,10 @@
92219345 Rotate Right
92229346
92239347 Rotate Left
9224-\'
9348+
92259349
92269350 \fBEnhance\fP
9227-\'
9351+
92289352
92299353 Hue...
92309354
@@ -9247,10 +9371,10 @@
92479371 GRAYscale
92489372
92499373 Quantize...
9250-\'
9374+
92519375
92529376 \fBEffects\fP
9253-\'
9377+
92549378
92559379 Despeckle
92569380
@@ -9275,12 +9399,12 @@
92759399 Raise...
92769400
92779401 Segment...
9278-\'
9279-\'
9280-\'
9402+
9403+
9404+
92819405
92829406 \fBF/X\fP
9283-\'
9407+
92849408
92859409 Solarize...
92869410
@@ -9293,12 +9417,12 @@
92939417 Oil Paint
92949418
92959419 Charcoal Draw...
9296-\'
9297-\'
9298-\'
9420+
9421+
9422+
92999423
93009424 \fBMiscellany\fP
9301-\'
9425+
93029426
93039427 Image Info
93049428
@@ -9309,13 +9433,13 @@
93099433 Show Histogram
93109434
93119435 Show Matte
9312-\'
9436+
93139437
93149438 \fBHelp\fP
93159439
93169440 \fBDismiss\fP
9317-\'
9318-\'
9441+
9442+
93199443 You can make adjustments to the region of interest by moving the pointer
93209444 to one of the rectangle corners, pressing a button, and dragging. Finally,
93219445 choose an image processing technique from the Command widget. You can choose
@@ -9323,7 +9447,7 @@
93239447 you can move the region of interest before applying another image processing
93249448 technique. To exit, press Dismiss.
93259449 .SH IMAGE PANNING
9326-\'
9450+
93279451 When an image exceeds the width or height of the X server screen, display
93289452 maps a small panning icon. The rectangle within the panning icon shows
93299453 the area that is currently displayed in the the image window. To pan about
@@ -9331,26 +9455,26 @@
93319455 The pan rectangle moves with the pointer and the image window is updated
93329456 to reflect the location of the rectangle within the panning icon. When
93339457 you have selected the area of the image you wish to view, release the button.
9334-\'
9458+
93359459 Use the arrow keys to pan the image one pixel up, down, left, or right
93369460 within the image window.
9337-\'
9461+
93389462 The panning icon is withdrawn if the image becomes smaller than the dimensions
93399463 of the X server screen.
93409464 .SH USER PREFERENCES
9341-\'
9465+
93429466 Preferences affect the default behavior of \fBdisplay(1)\fP. The preferences
93439467 are either true or false and are stored in your home directory
93449468 as .displayrc:
93459469 .in 15
9346-\'
9470+
93479471 .in 15
93489472 .B "
93499473 \fBdisplay image centered on a backdrop\fP"
93509474 .in 20
93519475 \fR
93529476 .in 20
9353-\'
9477+
93549478 This backdrop covers the entire workstation screen and is useful for hiding
93559479 other X window activity while viewing the image. The color of the backdrop
93569480 is specified as the background color. Refer to X Resources
@@ -9362,7 +9486,7 @@
93629486 .in 20
93639487 \fR
93649488 .in 20
9365-\'
9489+
93669490 Ask for a confirmation before exiting the \fBdisplay(1)\fP program.
93679491 .in 15
93689492 .in 15
@@ -9371,7 +9495,7 @@
93719495 .in 20
93729496 \fR
93739497 .in 20
9374-\'
9498+
93759499 If the image has a known gamma, the gamma is corrected to match that of
93769500 the X server (see the X Resource\fB displayGamma\fP).
93779501 .in 15
@@ -9381,7 +9505,7 @@
93819505 .in 20
93829506 \fR
93839507 .in 20
9384-\'
9508+
93859509 Display any warning messages.
93869510 .in 15
93879511 .in 15
@@ -9390,7 +9514,7 @@
93909514 .in 20
93919515 \fR
93929516 .in 20
9393-\'
9517+
93949518 The basic strategy of dithering is to trade intensity resolution for spatial
93959519 resolution by averaging the intensities of several neighboring pixels.
93969520 Images which suffer from severe contouring when reducing colors can be
@@ -9402,7 +9526,7 @@
94029526 .in 20
94039527 \fR
94049528 .in 20
9405-\'
9529+
94069530 This option only applies when the default X server visual is
94079531 \fIPseudoColor\fP
94089532 or \fIGRAYScale\fP. Refer to \fB-visual\fP for more details. By default,
@@ -9418,20 +9542,20 @@
94189542 .in 20
94199543 \fR
94209544 .in 20
9421-\'
9545+
94229546 Images are maintained as a XImage by default. Set this resource to True
94239547 to utilize a server Pixmap instead. This option is useful if your image
94249548 exceeds the dimensions of your server screen and you intend to pan the
94259549 image. Panning is much faster with Pixmaps than with a XImage. Pixmaps
94269550 are considered a precious resource, use them with discretion.
94279551 .in 15
9428-\'
9552+
94299553 .TP
94309554 .in 15
94319555 .in 15
94329556 .in 20
94339557 .SH GM IDENTIFY
9434-\'
9558+
94359559 \fBIdentify\fP describes the format and characteristics of one or
94369560 more image files as internally supported by the software. It will also
94379561 report if an image is incomplete or corrupt. The information
@@ -9443,15 +9567,17 @@
94439567 the image. If -verbose or +ping are provided as an option, the pixel
94449568 read rate is also displayed. An example line output from
94459569 \fBidentify\fP follows:
9446-\'
9570+
9571+.nf
94479572 images/aquarium.miff 640x480 PseudoClass 256c
94489573 308135b MIFF 0.000u 0:01
9449-\'
9450-\'
9574+.fi
9575+
94519576 If -verbose is set, expect additional output including any image
94529577 comment:
9453-\'
9454-\'
9578+
9579+
9580+.nf
94559581 Image: images/aquarium.miff
94569582 class: PseudoClass
94579583 colors: 256
@@ -9463,21 +9589,21 @@
94639589 format: MIFF
94649590 comments:
94659591 Imported from MTV raster image: aquarium.mtv
9466-\'
9467-\'
9592+.fi
9593+
94689594 For some formats, additional format-specific information about the file
94699595 will be written if the -debug coder or -debug all option
94709596 is used.
94719597 .SH IDENTIFY OPTIONS
9472-\'
9598+
94739599 Options are processed in command line order. Any option you specify on
94749600 the command line remains in effect for the set of images immediately
94759601 following, until the set is terminated by the appearance of any option
94769602 or \fB-noop\fP.
9477-\'
9603+
94789604 For a more detailed description of each option, see
94799605 Options, above.
9480-\'
9606+
94819607 .TP
94829608 .B "-authenticate \fI<string>"\fP
94839609 \fRdecrypt image with this password
@@ -9523,19 +9649,19 @@
95239649 .TP
95249650 .B "-version"
95259651 \fRprint GraphicsMagick version string
9526-\'
9652+
95279653 For a more detailed description of each option, see
95289654 Options, above.
9529-\'
9655+
95309656 .SH GM IMPORT
9531-\'
9657+
95329658 \fBImport\fP reads an image from any visible window on an X server and
95339659 outputs it as an image file. You can capture a single window, the entire
95349660 screen, or any rectangular portion of the screen.
95359661 Use \fIdisplay\fP
95369662 for redisplay, printing, editing, formatting, archiving, image processing,
95379663 etc. of the captured image.
9538-\'
9664+
95399665 The target window can be specified by id, name, or may be selected
95409666 by clicking the mouse in the desired window. If you press a button and
95419667 then drag, a rectangle will form which expands and contracts as the mouse
@@ -9543,45 +9669,49 @@
95439669 release the button. The keyboard bell is rung once at the beginning of
95449670 the screen capture and twice when it completes.
95459671 .SH EXAMPLES
9546-\'
9672+
95479673 To select an X window or an area of the screen with the mouse and save it
95489674 in the MIFF image format to a file entitled window.miff, use:
9549-\'
9675+
9676+.nf
95509677 gm import window.miff
9551-\'
9552-\'
9678+.fi
9679+
95539680 To select an X window or an area of the screen with the mouse and save it
95549681 in the Encapsulated PostScript format to include in another document, use:
9555-\'
9682+
9683+.nf
95569684 gm import figure.eps
9557-\'
9558-\'
9685+.fi
9686+
95599687 To capture the entire X server screen in the JPEG image format in a file
95609688 entitled root.jpeg, without using the mouse, use:
9561-\'
9689+
9690+.nf
95629691 gm import -window root root.jpeg
9563-\'
9564-\'
9692+.fi
9693+
95659694 To capture the 512x256 area at the upper right corner of the X server
95669695 screen in the PNG image format in a well-compressed file entitled corner.png,
95679696 without using the mouse, use:
9568-\'
9697+
9698+.nf
95699699 gm import -window root -crop 512x256-0+0 -quality 90
95709700 corner.png
9571-\'
9701+.fi
95729702 .SH OPTIONS
9573-\'
9703+
95749704 Options are processed in command line order. Any option you specify on
95759705 the command line remains in effect until it is explicitly changed by specifying
95769706 the option again with a different effect.
9577-\'
9707+
95789708 \fBImport\fP options can appear on the command line or in your
95799709 X resources file. See \fIX(1)\fP. Options on the command line supersede
95809710 values specified in your X resources file.
9581-\'
9711+
95829712 For a more detailed description of each option, see
95839713 Options, above.
9584-\'
9714+
95859715 .TP
95869716 .B "-bordercolor \fI<color>"\fP
95879717 \fRthe border color
@@ -9717,56 +9847,59 @@
97179847 .TP
97189848 .B "-version"
97199849 \fRprint GraphicsMagick version string
9720-\'
9850+
97219851 For a more detailed description of each option, see
97229852 Options, above.
9723-\'
9853+
97249854 .SH GM MOGRIFY
9725-\'
9855+
97269856 \fBMogrify\fP transforms an image or a sequence of images. These transforms
97279857 include image scaling, image rotation, color reduction, and others. Each
97289858 transmogrified image overwrites the corresponding original image, unless an
97299859 option such as
97309860 \fB-format\fP causes the output filename to be different from the input
97319861 filename.
9732-\'
9862+
97339863 The graphics formats supported by \fBmogrify\fP are listed in
97349864 \fIGraphicsMagick(1)\fP.
97359865 .SH EXAMPLES
9736-\'
9866+
97379867 To convert all the TIFF files in a particular directory to JPEG, use:
9738-\'
9868+
9869+.nf
97399870 gm mogrify -format jpeg *.tiff
9740-\'
9741-\'
9871+.fi
9872+
97429873 To convert a directory full of JPEG images to thumbnails, use:
9743-\'
9874+
9875+.nf
97449876 gm mogrify -size 120x120 *.jpg -resize 120x120 +profile "*"
9745-\'
9746-\'
9877+.fi
9878+
97479879 In this example, '-size 120x120' gives a hint to the JPEG decoder
97489880 that the images are going to be downscaled to 120x120, allowing it to run
97499881 faster by avoiding returning full-resolution images to GraphicsMagick for
97509882 the subsequent resizing operation. The
9751-'-resize 120x120' specifies the desired dimensions of the
9883+\'-resize 120x120' specifies the desired dimensions of the
97529884 output images. It will be scaled so its largest dimension is 120 pixels. The
9753-'+profile "*"' removes any ICM, EXIF, IPTC, or other profiles
9885+\'+profile "*"' removes any ICM, EXIF, IPTC, or other profiles
97549886 that might be present in the input and aren't needed in the thumbnails.
9755-\'
9887+
97569888 To scale an image of a cockatoo to exactly 640 pixels in width and 480
97579889 pixels in height, use:
9758-\'
9890+
9891+.nf
97599892 gm mogrify -resize 640x480! cockatoo.miff
9760-\'
9893+.fi
97619894 .SH OPTIONS
9762-\'
9895+
97639896 Options are processed in command line order. Any option you specify on
97649897 the command line remains in effect for the set of images that follows,
97659898 until the set is terminated by the appearance of any option or \fB-noop\fP.
9766-\'
9899+
97679900 For a more detailed description of each option, see
97689901 Options, above.
9769-\'
9902+
97709903 .TP
97719904 .B "-affine \fI<matrix>"\fP
97729905 \fRdrawing transform matrix
@@ -9774,7 +9907,7 @@
97749907 .B "-antialias"
97759908 \fRremove pixel aliasing
97769909 .TP
9777-.B " \fI-asc-cdl <spec>"\fP
9910+.B "-asc-cdl \fI<spec>"\fP
97789911 \fRapply ASC CDL color transform
97799912 .TP
97809913 .B "-authenticate \fI<string>"\fP
@@ -10187,16 +10320,16 @@
1018710320 .TP
1018810321 .B "-white-threshold \fIred[,green][,blue][,opacity]"\fP
1018910322 \fRpixels above the threshold become white
10190-\'
10323+
1019110324 For a more detailed description of each option, see
1019210325 Options, above.
10193-\'
10326+
1019410327 .SH GM MONTAGE
10195-\'
10328+
1019610329 \fBmontage\fP creates a composite image by combining several separate
1019710330 images. The images are tiled on the composite image with the name of the
1019810331 image optionally appearing just below the individual tile.
10199-\'
10332+
1020010333 The composite image is constructed in the following manner. First, each
1020110334 image specified on the command line, except for the last, is scaled to
1020210335 fit the maximum tile size. The maximum tile size by default is 120x120.
@@ -10206,7 +10339,7 @@
1020610339 for more information on command line arguments. See
1020710340 \fBX(1)\fP for more information on X resources.
1020810341 Note that the maximum tile size need not be a square.
10209-\'
10342+
1021010343 Next the composite image is initialized with the color specified by the
1021110344 \fB-background\fP
1021210345 command line argument or X resource. The width and height of the composite
@@ -10225,7 +10358,7 @@
1022510358 The label colors is determined by the \fB-background\fP and \fB-fill\fP
1022610359 command line argument or X resource. Note, that if the background and pen
1022710360 colors are the same, labels will not appear.
10228-\'
10361+
1022910362 Initially, the composite image title is placed at the top if one is specified
1023010363 (refer to \fB-fill\fP). Next, each image is set onto the composite image,
1023110364 surrounded by its border color, with its name centered just below it. The
@@ -10237,72 +10370,78 @@
1023710370 the name assigned to the composite image. By default, the image is written
1023810371 in the \fBMIFF\fP format and can be viewed or printed with
1023910372 \fIdisplay(1)\fP.
10240-\'
10241-\'
10373+
10374+
1024210375 Note, that if the number of tiles exceeds the default number of 20 (5 per
1024310376 row, 4 per column), more than one composite image is created. To ensure
1024410377 a single image is produced, use \fB-tile\fP to increase the number of
1024510378 tiles to meet or exceed the number of input images.
10246-\'
10379+
1024710380 Finally, to create one or more empty spaces in the sequence of tiles, use
1024810381 the \fB"NULL:"\fP image format.
10249-\'
10382+
1025010383 Note, a composite MIFF image displayed to an X server with
1025110384 \fBdisplay\fP
1025210385 behaves differently than other images. You can think of the composite as
1025310386 a visual image directory. Choose a particular tile of the composite and
1025410387 press a button to display it. See \fBdisplay(1)\fP and \fBmiff(5)\fP
1025510388 .SH EXAMPLES
10256-\'
10389+
1025710390 To create a montage of a cockatoo, a parrot, and a hummingbird and write
1025810391 it to a file called birds, use:
10259-\'
10392+
10393+.nf
1026010394 gm montage cockatoo.miff parrot.miff hummingbird.miff
1026110395 birds.miff
10262-\'
10263-\'
10396+.fi
10397+
1026410398 To tile several bird images so that they are at most 256 pixels in width
1026510399 and 192 pixels in height, surrounded by a red border, and separated by
1026610400 10 pixels of background color, use:
10267-\'
10401+
10402+.nf
1026810403 gm montage -geometry 256x192+10+10 -bordercolor red
1026910404 birds.* montage.miff
10270-\'
10271-\'
10405+.fi
10406+
1027210407 To create an unlabeled parrot image, 640 by 480 pixels, and surrounded
1027310408 by a border of black, use:
10274-\'
10409+
10410+.nf
1027510411 gm montage -geometry 640x480 -bordercolor black
1027610412 -label "" parrot.miff bird.miff
10277-\'
10278-\'
10413+.fi
10414+
1027910415 To create an image of an eagle with a textured background, use:
10280-\'
10416+
10417+.nf
1028110418 gm montage -texture bumps.jpg eagle.jpg eagle.png
10282-\'
10283-\'
10419+.fi
10420+
1028410421 To join several GIF images together without any extraneous graphics (e.g.
1028510422 no label, no shadowing, no surrounding tile frame), use:
10286-\'
10423+
10424+.nf
1028710425 gm montage +frame +shadow +label -tile 5x1
1028810426 -geometry 50x50+0+0 *.png joined.png
10289-\'
10427+.fi
1029010428 .SH OPTIONS
10291-\'
10429+
1029210430 Any option you specify on the command line remains in effect for the group
1029310431 of images following it, until the group is terminated by the appearance of
1029410432 any option or \fB-noop\fP. For example, to make a montage of three images,
1029510433 the first with 32 colors, the second with an unlimited number of colors, and
1029610434 the third with only 16 colors, use:
10297-\'
10298-\'
10435+
10436+
10437+.nf
1029910438 gm montage -colors 32 cockatoo.1 -noop cockatoo.2
1030010439 -colors 16 cockatoo.3 cockatoos.miff
10301-\'
10302-\'
10440+.fi
10441+
1030310442 For a more detailed description of each option, see
1030410443 Options, above.
10305-\'
10444+
1030610445 .TP
1030710446 .B "-adjoin"
1030810447 \fRjoin images into a single multi-image file
@@ -10522,89 +10661,90 @@
1052210661 .TP
1052310662 .B "-white-point \fI<x>,<y>"\fP
1052410663 \fRchromaticity white point
10525-\'
10664+
1052610665 For a more detailed description of each option, see
1052710666 Options, above.
10528-\'
10667+
1052910668 .SH X RESOURCES
10530-\'
10669+
1053110670 \fBMontage\fP options can appear on the command line or in your X resource
1053210671 file. Options on the command line supersede values specified in your X
1053310672 resource file. See \fBX(1)\fP for more information on X resources.
10534-\'
10673+
1053510674 All \fBmontage\fP options have a corresponding X resource. In addition,
1053610675 \fBmontage\fP
1053710676 uses the following X resources:
1053810677 .TP
1053910678 .B "background \fI(class Background)"\fP
1054010679 \fRbackground color
10541-\'
10680+
1054210681 Specifies the preferred color to use for the composite image background.
1054310682 The default is #ccc.
1054410683 .TP
1054510684 .B "borderColor \fI(class BorderColor)"\fP
1054610685 \fRborder color
10547-\'
10686+
1054810687 Specifies the preferred color to use for the composite image border. The
1054910688 default is #ccc.
1055010689 .TP
1055110690 .B "borderWidth \fI(class BorderWidth)"\fP
1055210691 \fRborder width
10553-\'
10692+
1055410693 Specifies the width in pixels of the composite image border. The default
1055510694 is 2.
1055610695 .TP
1055710696 .B "font \fI(class Font)"\fP
1055810697 \fRfont to use
10559-\'
10698+
1056010699 Specifies the name of the preferred font to use when displaying text within
1056110700 the composite image. The default is 9x15, fixed, or 5x8 determined by the
1056210701 composite image size.
1056310702 .TP
1056410703 .B "matteColor \fI(class MatteColor)"\fP
1056510704 \fRcolor of the frame
10566-\'
10705+
1056710706 Specify the color of an image frame. A 3D effect is achieved by using highlight
1056810707 and shadow colors derived from this color. The default value is #697B8F.
1056910708 .TP
1057010709 .B "pen \fI(class Pen)"\fP
1057110710 \fRtext color
10572-\'
10711+
1057310712 Specifies the preferred color to use for text within the composite image.
1057410713 The default is black.
1057510714 .TP
1057610715 .B "title \fI(class Title)"\fP
1057710716 \fRcomposite image title
10578-\'
10717+
1057910718 This resource specifies the title to be placed at the top of the composite
1058010719 image. The default is not to place a title at the top of the composite
1058110720 image.
1058210721 .SH GM TIME
1058310722 .SH DESCRIPTION
10584-\'
10723+
1058510724 \fBtime\fP executes an arbitrary \fBgm\fP utility command
1058610725 (e.g. \fBconvert\fP) and reports the user and elapsed time. This
1058710726 provides way to measure command execution times similar to the Unix
10588-'time' command but in a portable and consistent way.
10727+\'time' command but in a portable and consistent way.
1058910728 .SH EXAMPLES
1059010729 To obtain time information for the execution of a
1059110730 command:
10592-\'
10731+
10732+.nf
1059310733 % gm time convert input.ppm -gaussian 0x2 output.ppm
1059410734 convert input.ppm -gaussian 0x2 output.ppm 22.60s user 0.00s system 2354% cpu 0.960 total
10595-\'
10735+.fi
1059610736 Here is the interpretation of the above output:
10597-\'
10737+
1059810738 \fBuser\fP - the total user time consumed.
1059910739 \fBsystem\fP - the total system time consumed.
1060010740 \fBtotal\fP - the total elapsed time consumed.
10601-\'
10741+
1060210742 .SH OPTIONS
1060310743 The time command reqires no options other than the gm command to
1060410744 execute.
1060510745 .SH GM VERSION
1060610746 .SH DESCRIPTION
10607-\'
10747+
1060810748 \fBversion\fP displays the software release version, build quantum
1060910749 (pixel sample) depth, web site URL, copyright notice, enabled features
1061010750 support, configuration parameters, and final build options used to
@@ -10612,7 +10752,8 @@
1061210752 software was configured and the host system.
1061310753 .SH EXAMPLES
1061410754 To display the version information:
10615-\'
10755+
10756+.nf
1061610757 GraphicsMagick 1.3.37 2021-12-12 Q16 http://www.GraphicsMagick.org/
1061710758 Copyright (C) 2002-2021 GraphicsMagick Group.
1061810759 Additional copyrights and licenses apply to this software.
@@ -10654,6 +10795,6 @@
1065410795 CXXFLAGS = ...
1065510796 LDFLAGS = ...
1065610797 LIBS = ...
10657-\'
10798+.fi
1065810799 .SH OPTIONS
1065910800 The version command does not currently support any options.
diff -r 764d46677eca -r 5ad72c2bb8ff www/Changelog.html
--- a/www/Changelog.html Fri Dec 31 11:08:22 2021 -0600
+++ b/www/Changelog.html Fri Dec 31 15:20:41 2021 -0600
@@ -35,6 +35,15 @@
3535 <div class="document">
3636
3737
38+<p>2021-12-31 Bob Friesenhahn &lt;<a class="reference external" href="mailto:bfriesen&#37;&#52;&#48;simple&#46;dallas&#46;tx&#46;us">bfriesen<span>&#64;</span>simple<span>&#46;</span>dallas<span>&#46;</span>tx<span>&#46;</span>us</a>&gt;</p>
39+<blockquote>
40+<p>* doc/{gmdoc2html, gmdocselect, imdoc2man, imdocselect}: Fixes to
41+work better with both GNU sed and Solaris/Illumos sed.</p>
42+<p>* doc/GNUmakefile: Use GNU make rules to produce the full imdoc
43+list for man, html, and tex, rather than relying on a shell
44+wildcard expression, since the order produced by the shell
45+wildcard expression is indeterminate.</p>
46+</blockquote>
3847 <p>2021-12-30 Bob Friesenhahn &lt;<a class="reference external" href="mailto:bfriesen&#37;&#52;&#48;simple&#46;dallas&#46;tx&#46;us">bfriesen<span>&#64;</span>simple<span>&#46;</span>dallas<span>&#46;</span>tx<span>&#46;</span>us</a>&gt;</p>
3948 <blockquote>
4049 <p>* www/index.rst: Document that
diff -r 764d46677eca -r 5ad72c2bb8ff www/GraphicsMagick.html
--- a/www/GraphicsMagick.html Fri Dec 31 11:08:22 2021 -0600
+++ b/www/GraphicsMagick.html Fri Dec 31 15:20:41 2021 -0600
@@ -622,7 +622,7 @@
622622 ALT=">" BORDER=0 height=14
623623 width=15><b><font face="Helvetica, Arial"
624624 ><font color="#00B04F"><font size="+1">
625- <a name="details"></a> <i>-asc-cdl &lt;spec&gt;</i>
625+ <a name="details-asc-cdl"></a>-asc-cdl <i>&lt;spec&gt;</i>
626626 </font></font></font></b></td></tr></table>
627627 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply ASC CDL color transform</td></tr></table>
628628 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
@@ -2194,7 +2194,7 @@
21942194 </font></td></tr></table>
21952195 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre>
21962196 -draw 'text 100,100 "%m:%f %wx%h"'
2197-</pre></font></td></tr></table>
2197+</font></td></tr></table>
21982198 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
21992199 annotates the image with <tt>MIFF:bird.miff 512x480</tt> for an image titled
22002200 <tt>bird.miff</tt>
diff -r 764d46677eca -r 5ad72c2bb8ff www/convert.html
--- a/www/convert.html Fri Dec 31 11:08:22 2021 -0600
+++ b/www/convert.html Fri Dec 31 15:20:41 2021 -0600
@@ -267,7 +267,7 @@
267267 ALT=">" BORDER=0 height=14
268268 width=15><b><font face="Helvetica, Arial"
269269 ><font color="#00B04F"><font size="+1">
270- <a href="GraphicsMagick.html#details"></a> <i>-asc-cdl &lt;spec&gt;</i>
270+ <a href="GraphicsMagick.html#details-asc-cdl">-asc-cdl</a> <i>&lt;spec&gt;</i>
271271 </font></font></font></b></td></tr></table>
272272 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply ASC CDL color transform</td></tr></table>
273273 <table BORDER=0 WIDTH="94%">
diff -r 764d46677eca -r 5ad72c2bb8ff www/gm.html
--- a/www/gm.html Fri Dec 31 11:08:22 2021 -0600
+++ b/www/gm.html Fri Dec 31 15:20:41 2021 -0600
@@ -585,7 +585,7 @@
585585 ALT=">" BORDER=0 height=14
586586 width=15><b><font face="Helvetica, Arial"
587587 ><font color="#00B04F"><font size="+1">
588- <a name="details"></a> <i>-asc-cdl &lt;spec&gt;</i>
588+ <a name="details-asc-cdl"></a>-asc-cdl <i>&lt;spec&gt;</i>
589589 </font></font></font></b></td></tr></table>
590590 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply ASC CDL color transform</td></tr></table>
591591 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
@@ -2157,7 +2157,7 @@
21572157 </font></td></tr></table>
21582158 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre>
21592159 -draw 'text 100,100 "%m:%f %wx%h"'
2160-</pre></font></td></tr></table>
2160+</font></td></tr></table>
21612161 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">
21622162 annotates the image with <tt>MIFF:bird.miff 512x480</tt> for an image titled
21632163 <tt>bird.miff</tt>
@@ -9338,7 +9338,7 @@
93389338 ALT=">" BORDER=0 height=14
93399339 width=15><b><font face="Helvetica, Arial"
93409340 ><font color="#00B04F"><font size="+1">
9341- <a href="GraphicsMagick.html#details"></a> <i>-asc-cdl &lt;spec&gt;</i>
9341+ <a href="GraphicsMagick.html#details-asc-cdl">-asc-cdl</a> <i>&lt;spec&gt;</i>
93429342 </font></font></font></b></td></tr></table>
93439343 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply ASC CDL color transform</td></tr></table>
93449344 <table BORDER=0 WIDTH="94%">
@@ -15424,7 +15424,7 @@
1542415424 ALT=">" BORDER=0 height=14
1542515425 width=15><b><font face="Helvetica, Arial"
1542615426 ><font color="#00B04F"><font size="+1">
15427- <a href="GraphicsMagick.html#details"></a> <i>-asc-cdl &lt;spec&gt;</i>
15427+ <a href="GraphicsMagick.html#details-asc-cdl">-asc-cdl</a> <i>&lt;spec&gt;</i>
1542815428 </font></font></font></b></td></tr></table>
1542915429 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply ASC CDL color transform</td></tr></table>
1543015430 <table BORDER=0 WIDTH="94%">
@@ -18126,7 +18126,7 @@
1812618126 <table width="94%" border="0" cellspacing="0" cellpadding="8">
1812718127 <tr><td width="3%"><br></td><td>
1812818128 <p>To display the version information:
18129-<pre>
18129+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre>
1813018130 GraphicsMagick 1.3.37 2021-12-12 Q16 http://www.GraphicsMagick.org/
1813118131 Copyright (C) 2002-2021 GraphicsMagick Group.
1813218132 Additional copyrights and licenses apply to this software.
@@ -18168,7 +18168,7 @@
1816818168 CXXFLAGS = ...
1816918169 LDFLAGS = ...
1817018170 LIBS = ...
18171-</pre>
18171+</pre></font></td></tr></table>
1817218172 </td></tr></table>
1817318173 <p>
1817418174 <i><a href="#top">Back to Contents</a></i>
diff -r 764d46677eca -r 5ad72c2bb8ff www/mogrify.html
--- a/www/mogrify.html Fri Dec 31 11:08:22 2021 -0600
+++ b/www/mogrify.html Fri Dec 31 15:20:41 2021 -0600
@@ -192,7 +192,7 @@
192192 ALT=">" BORDER=0 height=14
193193 width=15><b><font face="Helvetica, Arial"
194194 ><font color="#00B04F"><font size="+1">
195- <a href="GraphicsMagick.html#details"></a> <i>-asc-cdl &lt;spec&gt;</i>
195+ <a href="GraphicsMagick.html#details-asc-cdl">-asc-cdl</a> <i>&lt;spec&gt;</i>
196196 </font></font></font></b></td></tr></table>
197197 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply ASC CDL color transform</td></tr></table>
198198 <table BORDER=0 WIDTH="94%">
diff -r 764d46677eca -r 5ad72c2bb8ff www/version.html
--- a/www/version.html Fri Dec 31 11:08:22 2021 -0600
+++ b/www/version.html Fri Dec 31 15:20:41 2021 -0600
@@ -107,7 +107,7 @@
107107 <table width="94%" border="0" cellspacing="0" cellpadding="8">
108108 <tr><td width="3%"><br></td><td>
109109 <p>To display the version information:
110-<pre>
110+<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre>
111111 GraphicsMagick 1.3.37 2021-12-12 Q16 http://www.GraphicsMagick.org/
112112 Copyright (C) 2002-2021 GraphicsMagick Group.
113113 Additional copyrights and licenses apply to this software.
@@ -149,7 +149,7 @@
149149 CXXFLAGS = ...
150150 LDFLAGS = ...
151151 LIBS = ...
152-</pre>
152+</pre></font></td></tr></table>
153153 </td></tr></table>
154154 <p>
155155 <i><a href="#top">Back to Contents</a></i>
Show on old repository browser