github.com/kaydxh/golang@v0.0.131/pkg/gocv/cgo/third_path/graphics-magick/share/doc/GraphicsMagick/www/gm.html (about) 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 2 "http://www.w3.org/TR/html4/loose.dtd"> 3 <html> 4 <head> 5 <meta HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=us-ascii"> 6 <title>GraphicsMagick GM Utility</title> 7 <style type=text/css> 8 <!-- 9 @page { size: 8.5in 11in } 10 TD P { color: #000000; font-family: "Verdana", "Arial", "Helvetica", sans-serif; font-size: 12pt } 11 P { color: #000000; font-family: "Verdana", "Arial", "Helvetica", sans-serif; font-size: 12pt } 12 A:link { color: #00B04F } 13 A:visited { color: #007B37 } 14 --> 15 </style> 16 17 </head> 18 <body LANG="en-US" TEXT="#000000" LINK="#00B04F" VLINK="#007B37" BGCOLOR="#ffffff"> 19 <a name="top"></a> 20 <table border=0 cellpadding=10 cellspacing=0 style="margin-top:-17px" width="100%"><tr><td> 21 <br> <br> 22 <table BORDER=0 WIDTH="100%"> 23 <tr> 24 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 25 SRC="images/right_triangle.png" ALT=">" BORDER=0 26 height=14 width=15><b><font face="Helvetica, Arial"><font 27 color="#00B04F"><font size="+1"> 28 <a NAME="top"></a>NAME 29 </font></font></font></b></td></tr></table> 30 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 31 <tr><td width="3%"><br></td><td> 32 <p> 33 gm - command-line utility to create, edit, compare, convert, or display images 34 <br> <br> 35 </td></tr></table> 36 <table BORDER=0 WIDTH="100%"> 37 <tr> 38 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 39 SRC="images/right_triangle.png" ALT=">" BORDER=0 40 height=14 width=15><b><font face="Helvetica, Arial"><font 41 color="#00B04F"><font size="+1"> 42 <a NAME="syno"></a>Synopsis 43 </font></font></font></b></td></tr></table> 44 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 45 <tr><td width="3%"><br></td><td> 46 <p> 47 <strong>gm animate</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>file</em> <strong>[ [</strong> 48 <em>options ...</em> <strong>]</strong> <em>file ...</em> <strong>]</strong> 49 <p> 50 <strong>gm batch</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <strong>[</strong> <em>script</em> <strong>]</strong> 51 <p> 52 <strong>gm benchmark</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> subcommand 53 <p> 54 <strong>gm compare</strong> <strong>[</strong> <em>options</em> <strong>... ]</strong> <em>reference-image</em> 55 <strong>[</strong> <em>options</em> <strong>... ]</strong> <em>compare-image</em> 56 <strong>[</strong> <em>options</em> <strong>... ]</strong> 57 <p> 58 <strong>gm composite</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>change-image base-image</em> 59 <strong>[</strong> <em>mask-image</em> <strong>]</strong> <em>output-image</em> 60 <p> 61 <strong>gm conjure</strong> <strong>[</strong> <em>options</em> <strong>]</strong> <em>script.msl</em> 62 <strong>[ [</strong> <em>options</em> <strong>]</strong> <em>script.msl</em> <strong>]</strong> 63 <p> 64 <strong>gm convert</strong> <strong>[ [</strong> <em>options ...</em> <strong>] [</strong> <em>input-file ...</em> 65 <strong>] [</strong> <em>options ...</em> <strong>] ]</strong> <em>output-file</em> 66 <p> 67 <strong>gm display</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>file ...</em> 68 <strong>[ [</strong><em>options ...</em> <strong>]</strong><em>file ...</em> <strong>]</strong> 69 <p> 70 <strong>gm identify</strong> <em>file</em> <strong>[</strong> <em>file ...</em> <strong>]</strong> 71 <p> 72 <strong>gm import</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>file</em> 73 <p> 74 <strong>gm mogrify</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>file ...</em> 75 <p> 76 <strong>gm montage</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>file</em> <strong>[ [</strong> 77 <em>options ...</em> <strong>]</strong> <em>file ...</em> <strong>]</strong> <em>output-file</em> 78 <p> 79 <strong>gm time</strong> subcommand 80 <p> 81 <strong>gm version</strong> 82 </td></tr></table> 83 <table BORDER=0 WIDTH="100%"> 84 <tr> 85 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 86 SRC="images/right_triangle.png" ALT=">" BORDER=0 87 height=14 width=15><b><font face="Helvetica, Arial"><font 88 color="#00B04F"><font size="+1"> 89 <a NAME="desc"></a>Description 90 </font></font></font></b></td></tr></table> 91 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 92 <tr><td width="3%"><br></td><td> 93 <p> 94 GraphicsMagick's <strong>gm</strong> provides a suite of utilities for creating, 95 comparing, converting, editing, and displaying images. All of the 96 utilities are provided as sub-commands of a single <strong>gm</strong> 97 executable. The <strong>gm</strong> executable returns the exit code 0 to 98 indicate success, or 1 to indicate failure: 99 <p> 100 <strong>animate</strong> 101 displays an animation (e.g. a GIF file) on any workstation display 102 running an <em>X</em> server. 103 <p> 104 <strong>batch</strong> 105 executes an arbitary number of the utility commands 106 (e.g. <strong>convert</strong>) in the form of a simple linear batch script in 107 order to improve execution efficiency, and/or to allow use as a 108 subordinate co-process under the control of an arbitrary script or 109 program. 110 <p> 111 <strong>benchmark</strong> 112 executes one of the other utility commands (e.g. <strong>convert</strong>) for a 113 specified number of iterations, or execution time, and reports 114 execution time and other profiling information such as CPU 115 utilization. <strong>Benchmark</strong> provides various operating modes 116 including executing the command with a varying number of threads, and 117 alternate reporting formats such as comma-separated value (CSV). 118 <p> 119 <strong>compare</strong> 120 compares two images and reports difference statistics according to 121 specified metrics and/or outputs an image with a visual representation 122 of the differences. It may also be used to test if images are similar 123 within a particular range and specified metric, returning a truth 124 value to the executing environment. 125 <p> 126 <strong>composite</strong> 127 composites images (blends or merges images together) to create new images. 128 <p> 129 <strong>conjure</strong> 130 interprets and executes scripts in 131 the Magick Scripting Language (MSL). 132 <p> 133 <strong>convert</strong> 134 converts an input file using one image format to an output file with 135 the same or differing image format while applying an arbitrary number 136 of image transformations. 137 <p> 138 <strong>display</strong> 139 is a machine architecture independent image processing and display 140 facility. It can display an image on any workstation display running 141 an <em>X</em> server. 142 <p> 143 <strong>identify</strong> 144 describes the format and characteristics of one or more image 145 files. It will also report if an image is incomplete or corrupt. 146 <p> 147 <strong>import</strong> 148 reads an image from any visible window on an <em>X</em> server and 149 outputs it as an image file. You can capture a single window, the 150 entire screen, or any rectangular portion of the screen. 151 <p> 152 <strong>mogrify</strong> 153 transforms an image or a sequence of images. These transforms include 154 <strong>image scaling</strong>, <strong>image rotation</strong>, <strong>color reduction</strong>, 155 and others. The transmogrified image <strong>overwrites</strong> the original 156 image. 157 <p> 158 <strong>montage</strong> 159 creates a composite by combining several separate images. The images 160 are tiled on the composite image with the name of the image optionally 161 appearing just below the individual tile. 162 <p> 163 <strong>time</strong> 164 executes a subcommand and reports the user, system, and total 165 execution time consumed. 166 <p> 167 <strong>version</strong> 168 reports the GraphicsMagick release version, maximum sample-depth, 169 copyright notice, supported features, and the options used while 170 building the software. 171 <p> 172 The <strong>GraphicsMagick</strong> utilities recognize the following image formats: 173 <br> <br> 174 <table border="0" cellspacing="0" cellpadding="2"> 175 <p> 176 <tr><td><strong>Name</strong> </td><td><strong>Mode</strong></td><td><strong>Description</strong></td></tr> 177 <tr><td><dd><img SRC="images/ball.png" ALT="*">3FR </td><td>r--</td><td>Hasselblad Photo RAW</td></tr> 178 <tr><td><dd><img SRC="images/ball.png" ALT="*">8BIM </td><td>rw-</td><td>Photoshop resource format</td></tr> 179 <tr><td><dd><img SRC="images/ball.png" ALT="*">8BIMTEXT </td><td>rw-</td><td>Photoshop resource text format</td></tr> 180 <tr><td><dd><img SRC="images/ball.png" ALT="*">8BIMWTEXT</td><td>rw-</td><td>Photoshop resource wide text format</td></tr> 181 <tr><td><dd><img SRC="images/ball.png" ALT="*">APP1 </td><td>rw-</td><td>Raw application information</td></tr> 182 <tr><td><dd><img SRC="images/ball.png" ALT="*">APP1JPEG </td><td>rw-</td><td>Raw JPEG binary data</td></tr> 183 <tr><td><dd><img SRC="images/ball.png" ALT="*">ART </td><td>r--</td><td>PF1: 1st Publisher</td></tr> 184 <tr><td><dd><img SRC="images/ball.png" ALT="*">ARW </td><td>r--</td><td>Sony Alpha DSLR RAW</td></tr> 185 <tr><td><dd><img SRC="images/ball.png" ALT="*">AVS </td><td>rw+</td><td>AVS X image</td></tr> 186 <tr><td><dd><img SRC="images/ball.png" ALT="*">BIE </td><td>rw-</td><td>Joint Bi-level Image experts Group</td></tr> 187 <tr><td> </td><td> </td><td>interchange format</td></tr> 188 <tr><td><dd><img SRC="images/ball.png" ALT="*">BMP </td><td>rw+</td><td>Microsoft Windows bitmap image</td></tr> 189 <tr><td><dd><img SRC="images/ball.png" ALT="*">BMP2 </td><td>-w-</td><td>Microsoft Windows bitmap image v2</td></tr> 190 <tr><td><dd><img SRC="images/ball.png" ALT="*">BMP3 </td><td>-w-</td><td>Microsoft Windows bitmap image v3</td></tr> 191 <tr><td><dd><img SRC="images/ball.png" ALT="*">CACHE </td><td>---</td><td>Magick Persistent Cache image format</td></tr> 192 <tr><td><dd><img SRC="images/ball.png" ALT="*">CALS </td><td>rw-</td><td>Continuous Acquisition and Life-cycle</td></tr> 193 <tr><td> </td><td> </td><td>Support Type 1 image</td></tr> 194 <tr><td><dd><img SRC="images/ball.png" ALT="*">CAPTION </td><td>r--</td><td>Caption (requires separate size info)</td></tr> 195 <tr><td><dd><img SRC="images/ball.png" ALT="*">CIN </td><td>rw-</td><td>Kodak Cineon Format</td></tr> 196 <tr><td><dd><img SRC="images/ball.png" ALT="*">CMYK </td><td>rw-</td><td>Raw cyan, magenta, yellow, and black</td></tr> 197 <tr><td> </td><td> </td><td>samples (8 or 16 bits, depending on</td></tr> 198 <tr><td> </td><td> </td><td>the image depth)</td></tr> 199 <tr><td><dd><img SRC="images/ball.png" ALT="*">CMYKA </td><td>rw-</td><td>Raw cyan, magenta, yellow, black, and</td></tr> 200 <tr><td> </td><td> </td><td>matte samples (8 or 16 bits, depending</td></tr> 201 <tr><td> </td><td> </td><td>on the image depth)</td></tr> 202 <tr><td><dd><img SRC="images/ball.png" ALT="*">CR2 </td><td>r--</td><td>Canon Photo RAW</td></tr> 203 <tr><td><dd><img SRC="images/ball.png" ALT="*">CRW </td><td>r--</td><td>Canon Photo RAW</td></tr> 204 <tr><td><dd><img SRC="images/ball.png" ALT="*">CUR </td><td>r--</td><td>Microsoft Cursor Icon</td></tr> 205 <tr><td><dd><img SRC="images/ball.png" ALT="*">CUT </td><td>r--</td><td>DR Halo</td></tr> 206 <tr><td><dd><img SRC="images/ball.png" ALT="*">DCM </td><td>r--</td><td>Digital Imaging and Communications in</td></tr> 207 <tr><td> </td><td> </td><td>Medicine image</td></tr> 208 <tr><td><dd><img SRC="images/ball.png" ALT="*">DCR </td><td>r--</td><td>Kodak Photo RAW</td></tr> 209 <tr><td><dd><img SRC="images/ball.png" ALT="*">DCX </td><td>rw+</td><td>ZSoft IBM PC multi-page Paintbrush</td></tr> 210 <tr><td><dd><img SRC="images/ball.png" ALT="*">DNG </td><td>r--</td><td>Adobe Digital Negative</td></tr> 211 <tr><td><dd><img SRC="images/ball.png" ALT="*">DPS </td><td>r--</td><td>Display PostScript Interpreter</td></tr> 212 <tr><td><dd><img SRC="images/ball.png" ALT="*">DPX </td><td>rw-</td><td>Digital Moving Picture Exchange</td></tr> 213 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPDF </td><td>rw-</td><td>Encapsulated Portable Document Format</td></tr> 214 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPI </td><td>rw-</td><td>Adobe Encapsulated PostScript</td></tr> 215 <tr><td> </td><td> </td><td>Interchange format</td></tr> 216 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPS </td><td>rw-</td><td>Adobe Encapsulated PostScript</td></tr> 217 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPS2 </td><td>-w-</td><td>Adobe Level II Encapsulated PostScript</td></tr> 218 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPS3 </td><td>-w-</td><td>Adobe Level III Encapsulated PostScript</td></tr> 219 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPSF </td><td>rw-</td><td>Adobe Encapsulated PostScript</td></tr> 220 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPSI </td><td>rw-</td><td>Adobe Encapsulated PostScript</td></tr> 221 <tr><td> </td><td> </td><td>Interchange format</td></tr> 222 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPT </td><td>rw-</td><td>Adobe Encapsulated PostScript with MS-DOS</td></tr> 223 <tr><td> </td><td> </td><td>TIFF preview</td></tr> 224 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPT2 </td><td>rw-</td><td>Adobe Level II Encapsulated PostScript</td></tr> 225 <tr><td> </td><td> </td><td>with MS-DOS TIFF preview</td></tr> 226 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPT3 </td><td>rw-</td><td>Adobe Level III Encapsulated PostScript</td></tr> 227 <tr><td> </td><td> </td><td>with MS-DOS TIFF preview</td></tr> 228 <tr><td><dd><img SRC="images/ball.png" ALT="*">EXIF </td><td>rw-</td><td>Exif digital camera binary data</td></tr> 229 <tr><td><dd><img SRC="images/ball.png" ALT="*">FAX </td><td>rw+</td><td>Group 3 FAX (Not TIFF Group3 FAX!)</td></tr> 230 <tr><td><dd><img SRC="images/ball.png" ALT="*">FITS </td><td>rw-</td><td>Flexible Image Transport System</td></tr> 231 <tr><td><dd><img SRC="images/ball.png" ALT="*">FRACTAL </td><td>r--</td><td>Plasma fractal image</td></tr> 232 <tr><td><dd><img SRC="images/ball.png" ALT="*">FPX </td><td>rw-</td><td>FlashPix Format</td></tr> 233 <tr><td><dd><img SRC="images/ball.png" ALT="*">GIF </td><td>rw+</td><td>CompuServe graphics interchange format</td></tr> 234 <tr><td><dd><img SRC="images/ball.png" ALT="*">GIF87 </td><td>rw-</td><td>CompuServe graphics interchange format</td></tr> 235 <tr><td> </td><td> </td><td>(version 87a)</td></tr> 236 <tr><td><dd><img SRC="images/ball.png" ALT="*">GRADIENT </td><td>r--</td><td>Gradual passing from one shade to</td></tr> 237 <tr><td> </td><td> </td><td>another</td></tr> 238 <tr><td><dd><img SRC="images/ball.png" ALT="*">GRAY </td><td>rw+</td><td>Raw gray samples (8/16/32 bits,</td></tr> 239 <tr><td> </td><td> </td><td>depending on the image depth)</td></tr> 240 <tr><td><dd><img SRC="images/ball.png" ALT="*">HISTOGRAM</td><td>-w-</td><td>Histogram of the image</td></tr> 241 <tr><td><dd><img SRC="images/ball.png" ALT="*">HRZ </td><td>r--</td><td>HRZ: Slow scan TV</td></tr> 242 <tr><td><dd><img SRC="images/ball.png" ALT="*">HTML </td><td>-w-</td><td>Hypertext Markup Language and a</td></tr> 243 <tr><td> </td><td> </td><td>client-side image map</td></tr> 244 <tr><td><dd><img SRC="images/ball.png" ALT="*">ICB </td><td>rw+</td><td>Truevision Targa image</td></tr> 245 <tr><td><dd><img SRC="images/ball.png" ALT="*">ICC </td><td>rw-</td><td>ICC Color Profile</td></tr> 246 <tr><td><dd><img SRC="images/ball.png" ALT="*">ICM </td><td>rw-</td><td>ICC Color Profile</td></tr> 247 <tr><td><dd><img SRC="images/ball.png" ALT="*">ICO </td><td>r--</td><td>Microsoft icon</td></tr> 248 <tr><td><dd><img SRC="images/ball.png" ALT="*">ICON </td><td>r--</td><td>Microsoft icon</td></tr> 249 <tr><td><dd><img SRC="images/ball.png" ALT="*">IDENTITY </td><td>r--</td><td>Hald CLUT identity image</td></tr> 250 <tr><td><dd><img SRC="images/ball.png" ALT="*">IMAGE </td><td>r--</td><td>GraphicsMagick Embedded Image</td></tr> 251 <tr><td><dd><img SRC="images/ball.png" ALT="*">INFO </td><td>-w+</td><td>Image descriptive information and</td></tr> 252 <tr><td> </td><td> </td><td> statistics</td></tr> 253 <tr><td><dd><img SRC="images/ball.png" ALT="*">IPTC </td><td>rw-</td><td>IPTC Newsphoto</td></tr> 254 <tr><td><dd><img SRC="images/ball.png" ALT="*">IPTCTEXT </td><td>rw-</td><td>IPTC Newsphoto text format</td></tr> 255 <tr><td><dd><img SRC="images/ball.png" ALT="*">IPTCWTEXT</td><td>rw-</td><td>IPTC Newsphoto wide text format</td></tr> 256 <tr><td><dd><img SRC="images/ball.png" ALT="*">JBG </td><td>rw+</td><td>Joint Bi-level Image experts Group</td></tr> 257 <tr><td> </td><td> </td><td>interchange format</td></tr> 258 <tr><td><dd><img SRC="images/ball.png" ALT="*">JBIG </td><td>rw+</td><td>Joint Bi-level Image experts Group</td></tr> 259 <tr><td> </td><td> </td><td>interchange format</td></tr> 260 <tr><td><dd><img SRC="images/ball.png" ALT="*">JNG </td><td>rw-</td><td>JPEG Network Graphics</td></tr> 261 <tr><td><dd><img SRC="images/ball.png" ALT="*">JP2 </td><td>rw-</td><td>JPEG-2000 JP2 File Format Syntax</td></tr> 262 <tr><td><dd><img SRC="images/ball.png" ALT="*">JPC </td><td>rw-</td><td>JPEG-2000 Code Stream Syntax</td></tr> 263 <tr><td><dd><img SRC="images/ball.png" ALT="*">JPEG </td><td>rw-</td><td>Joint Photographic Experts Group</td></tr> 264 <tr><td> </td><td> </td><td>JFIF format</td></tr> 265 <tr><td><dd><img SRC="images/ball.png" ALT="*">JPG </td><td>rw-</td><td>Joint Photographic Experts Group</td></tr> 266 <tr><td> </td><td> </td><td>JFIF format</td></tr> 267 <tr><td><dd><img SRC="images/ball.png" ALT="*">K25 </td><td>r--</td><td>Kodak Photo RAW</td></tr> 268 <tr><td><dd><img SRC="images/ball.png" ALT="*">KDC </td><td>r--</td><td>Kodak Photo RAW</td></tr> 269 <tr><td><dd><img SRC="images/ball.png" ALT="*">LABEL </td><td>r--</td><td>Text image format</td></tr> 270 <tr><td><dd><img SRC="images/ball.png" ALT="*">M2V </td><td>rw+</td><td>MPEG-2 Video Stream</td></tr> 271 <tr><td><dd><img SRC="images/ball.png" ALT="*">MAP </td><td>rw-</td><td>Colormap intensities and indices</td></tr> 272 <tr><td><dd><img SRC="images/ball.png" ALT="*">MAT </td><td>r--</td><td>MATLAB image format</td></tr> 273 <tr><td><dd><img SRC="images/ball.png" ALT="*">MATTE </td><td>-w+</td><td>MATTE format</td></tr> 274 <tr><td><dd><img SRC="images/ball.png" ALT="*">MIFF </td><td>rw+</td><td>Magick Image File Format</td></tr> 275 <tr><td><dd><img SRC="images/ball.png" ALT="*">MNG </td><td>rw+</td><td>Multiple-image Network Graphics</td></tr> 276 <tr><td><dd><img SRC="images/ball.png" ALT="*">MONO </td><td>rw-</td><td>Bi-level bitmap in least-significant-</td></tr> 277 <tr><td> </td><td> </td><td>-byte-first order</td></tr> 278 <tr><td><dd><img SRC="images/ball.png" ALT="*">MPC </td><td>rw+</td><td>Magick Persistent Cache image format</td></tr> 279 <tr><td><dd><img SRC="images/ball.png" ALT="*">MPEG </td><td>rw+</td><td>MPEG-1 Video Stream</td></tr> 280 <tr><td><dd><img SRC="images/ball.png" ALT="*">MPG </td><td>rw+</td><td>MPEG-1 Video Stream</td></tr> 281 <tr><td><dd><img SRC="images/ball.png" ALT="*">MRW </td><td>r--</td><td>Minolta Photo Raw</td></tr> 282 <tr><td><dd><img SRC="images/ball.png" ALT="*">MSL </td><td>r--</td><td>Magick Scripting Language</td></tr> 283 <tr><td><dd><img SRC="images/ball.png" ALT="*">MTV </td><td>rw+</td><td>MTV Raytracing image format</td></tr> 284 <tr><td><dd><img SRC="images/ball.png" ALT="*">MVG </td><td>rw-</td><td>Magick Vector Graphics</td></tr> 285 <tr><td><dd><img SRC="images/ball.png" ALT="*">NEF </td><td>r--</td><td>Nikon Electronic Format</td></tr> 286 <tr><td><dd><img SRC="images/ball.png" ALT="*">NULL </td><td>r--</td><td>Constant image of uniform color</td></tr> 287 <tr><td><dd><img SRC="images/ball.png" ALT="*">OTB </td><td>rw-</td><td>On-the-air bitmap</td></tr> 288 <tr><td><dd><img SRC="images/ball.png" ALT="*">P7 </td><td>rw+</td><td>Xv thumbnail format</td></tr> 289 <tr><td><dd><img SRC="images/ball.png" ALT="*">PAL </td><td>rw-</td><td>16bit/pixel interleaved YUV</td></tr> 290 <tr><td><dd><img SRC="images/ball.png" ALT="*">PALM </td><td>rw-</td><td>Palm Pixmap</td></tr> 291 <tr><td><dd><img SRC="images/ball.png" ALT="*">PBM </td><td>rw+</td><td>Portable bitmap format (black and white)</td></tr> 292 <tr><td><dd><img SRC="images/ball.png" ALT="*">PCD </td><td>rw-</td><td>Photo CD</td></tr> 293 <tr><td><dd><img SRC="images/ball.png" ALT="*">PCDS </td><td>rw-</td><td>Photo CD</td></tr> 294 <tr><td><dd><img SRC="images/ball.png" ALT="*">PCL </td><td>-w-</td><td>Page Control Language</td></tr> 295 <tr><td><dd><img SRC="images/ball.png" ALT="*">PCT </td><td>rw-</td><td>Apple Macintosh QuickDraw/PICT</td></tr> 296 <tr><td><dd><img SRC="images/ball.png" ALT="*">PCX </td><td>rw-</td><td>ZSoft IBM PC Paintbrush</td></tr> 297 <tr><td><dd><img SRC="images/ball.png" ALT="*">PDB </td><td>rw+</td><td>Palm Database ImageViewer Format</td></tr> 298 <tr><td><dd><img SRC="images/ball.png" ALT="*">PDF </td><td>rw+</td><td>Portable Document Format</td></tr> 299 <tr><td><dd><img SRC="images/ball.png" ALT="*">PEF </td><td>r--</td><td>Pentax Electronic File</td></tr> 300 <tr><td><dd><img SRC="images/ball.png" ALT="*">PFA </td><td>r--</td><td>TrueType font</td></tr> 301 <tr><td><dd><img SRC="images/ball.png" ALT="*">PFB </td><td>r--</td><td>TrueType font</td></tr> 302 <tr><td><dd><img SRC="images/ball.png" ALT="*">PGM </td><td>rw+</td><td>Portable graymap format (gray scale)</td></tr> 303 <tr><td><dd><img SRC="images/ball.png" ALT="*">PGX </td><td>r--</td><td>JPEG-2000 VM Format</td></tr> 304 <tr><td><dd><img SRC="images/ball.png" ALT="*">PICON </td><td>rw-</td><td>Personal Icon</td></tr> 305 <tr><td><dd><img SRC="images/ball.png" ALT="*">PICT </td><td>rw-</td><td>Apple Macintosh QuickDraw/PICT</td></tr> 306 <tr><td><dd><img SRC="images/ball.png" ALT="*">PIX </td><td>r--</td><td>Alias/Wavefront RLE image format</td></tr> 307 <tr><td><dd><img SRC="images/ball.png" ALT="*">PLASMA </td><td>r--</td><td>Plasma fractal image</td></tr> 308 <tr><td><dd><img SRC="images/ball.png" ALT="*">PNG </td><td>rw-</td><td>Portable Network Graphics</td></tr> 309 <tr><td><dd><img SRC="images/ball.png" ALT="*">PNG24 </td><td>rw-</td><td>Portable Network Graphics, 24 bit RGB</td></tr> 310 <tr><td> </td><td> </td><td>opaque only</td></tr> 311 <tr><td><dd><img SRC="images/ball.png" ALT="*">PNG32 </td><td>rw-</td><td>Portable Network Graphics, 32 bit RGBA</td></tr> 312 <tr><td> </td><td> </td><td>semitransparency OK</td></tr> 313 <tr><td><dd><img SRC="images/ball.png" ALT="*">PNG8 </td><td>rw-</td><td>Portable Network Graphics, 8-bit</td></tr> 314 <tr><td> </td><td> </td><td>indexed, binary transparency only</td></tr> 315 <tr><td><dd><img SRC="images/ball.png" ALT="*">PNM </td><td>rw+</td><td>Portable anymap</td></tr> 316 <tr><td><dd><img SRC="images/ball.png" ALT="*">PPM </td><td>rw+</td><td>Portable pixmap format (color)</td></tr> 317 <tr><td><dd><img SRC="images/ball.png" ALT="*">PREVIEW </td><td>-w-</td><td>Show a preview an image enhancement,</td></tr> 318 <tr><td> </td><td> </td><td>effect, or f/x</td></tr> 319 <tr><td><dd><img SRC="images/ball.png" ALT="*">PS </td><td>rw+</td><td>Adobe PostScript</td></tr> 320 <tr><td><dd><img SRC="images/ball.png" ALT="*">PS2 </td><td>-w+</td><td>Adobe Level II PostScript</td></tr> 321 <tr><td><dd><img SRC="images/ball.png" ALT="*">PS3 </td><td>-w+</td><td>Adobe Level III PostScript</td></tr> 322 <tr><td><dd><img SRC="images/ball.png" ALT="*">PSD </td><td>rw-</td><td>Adobe Photoshop bitmap</td></tr> 323 <tr><td><dd><img SRC="images/ball.png" ALT="*">PTIF </td><td>rw-</td><td>Pyramid encoded TIFF</td></tr> 324 <tr><td><dd><img SRC="images/ball.png" ALT="*">PWP </td><td>r--</td><td>Seattle Film Works</td></tr> 325 <tr><td><dd><img SRC="images/ball.png" ALT="*">RAF </td><td>r--</td><td>Fuji Photo RAW</td></tr> 326 <tr><td><dd><img SRC="images/ball.png" ALT="*">RAS </td><td>rw+</td><td>SUN Rasterfile</td></tr> 327 <tr><td><dd><img SRC="images/ball.png" ALT="*">RGB </td><td>rw+</td><td>Raw red, green, and blue samples</td></tr> 328 <tr><td><dd><img SRC="images/ball.png" ALT="*">RGBA </td><td>rw+</td><td>Raw red, green, blue, and matte samples</td></tr> 329 <tr><td><dd><img SRC="images/ball.png" ALT="*">RLA </td><td>r--</td><td>Alias/Wavefront image</td></tr> 330 <tr><td><dd><img SRC="images/ball.png" ALT="*">RLE </td><td>r--</td><td>Utah Run length encoded image</td></tr> 331 <tr><td><dd><img SRC="images/ball.png" ALT="*">SCT </td><td>r--</td><td>Scitex HandShake</td></tr> 332 <tr><td><dd><img SRC="images/ball.png" ALT="*">SFW </td><td>r--</td><td>Seattle Film Works</td></tr> 333 <tr><td><dd><img SRC="images/ball.png" ALT="*">SGI </td><td>rw+</td><td>Irix RGB image</td></tr> 334 <tr><td><dd><img SRC="images/ball.png" ALT="*">SHTML </td><td>-w-</td><td>Hypertext Markup Language and a</td></tr> 335 <tr><td> </td><td> </td><td>client-side image map</td></tr> 336 <tr><td><dd><img SRC="images/ball.png" ALT="*">STEGANO </td><td>r--</td><td>Steganographic image</td></tr> 337 <tr><td><dd><img SRC="images/ball.png" ALT="*">SUN </td><td>rw+</td><td>SUN Rasterfile</td></tr> 338 <tr><td><dd><img SRC="images/ball.png" ALT="*">SVG </td><td>rw+</td><td>Scalable Vector Gaphics</td></tr> 339 <tr><td><dd><img SRC="images/ball.png" ALT="*">TEXT </td><td>rw+</td><td>Raw text</td></tr> 340 <tr><td><dd><img SRC="images/ball.png" ALT="*">TGA </td><td>rw+</td><td>Truevision Targa image</td></tr> 341 <tr><td><dd><img SRC="images/ball.png" ALT="*">TIFF </td><td>rw+</td><td>Tagged Image File Format</td></tr> 342 <tr><td><dd><img SRC="images/ball.png" ALT="*">TILE </td><td>r--</td><td>Tile image with a texture</td></tr> 343 <tr><td><dd><img SRC="images/ball.png" ALT="*">TIM </td><td>r--</td><td>PSX TIM</td></tr> 344 <tr><td><dd><img SRC="images/ball.png" ALT="*">TOPOL </td><td>r--</td><td>TOPOL X Image</td></tr> 345 <tr><td><dd><img SRC="images/ball.png" ALT="*">TTF </td><td>r--</td><td>TrueType font</td></tr> 346 <tr><td><dd><img SRC="images/ball.png" ALT="*">TXT </td><td>rw+</td><td>Raw text</td></tr> 347 <tr><td><dd><img SRC="images/ball.png" ALT="*">UIL </td><td>-w-</td><td>X-Motif UIL table</td></tr> 348 <tr><td><dd><img SRC="images/ball.png" ALT="*">UYVY </td><td>rw-</td><td>16bit/pixel interleaved YUV</td></tr> 349 <tr><td><dd><img SRC="images/ball.png" ALT="*">VDA </td><td>rw+</td><td>Truevision Targa image</td></tr> 350 <tr><td><dd><img SRC="images/ball.png" ALT="*">VICAR </td><td>rw-</td><td>VICAR rasterfile format</td></tr> 351 <tr><td><dd><img SRC="images/ball.png" ALT="*">VID </td><td>rw+</td><td>Visual Image Directory</td></tr> 352 <tr><td><dd><img SRC="images/ball.png" ALT="*">VIFF </td><td>rw+</td><td>Khoros Visualization image</td></tr> 353 <tr><td><dd><img SRC="images/ball.png" ALT="*">VST </td><td>rw+</td><td>Truevision Targa image</td></tr> 354 <tr><td><dd><img SRC="images/ball.png" ALT="*">WBMP </td><td>rw-</td><td>Wireless Bitmap (level 0) image</td></tr> 355 <tr><td><dd><img SRC="images/ball.png" ALT="*">WMF </td><td>r--</td><td>Windows Metafile</td></tr> 356 <tr><td><dd><img SRC="images/ball.png" ALT="*">WPG </td><td>r--</td><td>Word Perfect Graphics</td></tr> 357 <tr><td><dd><img SRC="images/ball.png" ALT="*">X </td><td>rw-</td><td>X Image</td></tr> 358 <tr><td><dd><img SRC="images/ball.png" ALT="*">X3F </td><td>r--</td><td>Foveon X3 (Sigma/Polaroid) RAW</td></tr> 359 <tr><td><dd><img SRC="images/ball.png" ALT="*">XBM </td><td>rw-</td><td>X Windows system bitmap (black</td></tr> 360 <tr><td> </td><td> </td><td>and white)</td></tr> 361 <tr><td><dd><img SRC="images/ball.png" ALT="*">XC </td><td>r--</td><td>Constant image uniform color</td></tr> 362 <tr><td><dd><img SRC="images/ball.png" ALT="*">XCF </td><td>r--</td><td>GIMP image</td></tr> 363 <tr><td><dd><img SRC="images/ball.png" ALT="*">XMP </td><td>rw-</td><td>Adobe XML metadata</td></tr> 364 <tr><td><dd><img SRC="images/ball.png" ALT="*">XPM </td><td>rw-</td><td>X Windows system pixmap (color)</td></tr> 365 <tr><td><dd><img SRC="images/ball.png" ALT="*">XV </td><td>rw+</td><td>Khoros Visualization image</td></tr> 366 <tr><td><dd><img SRC="images/ball.png" ALT="*">XWD </td><td>rw-</td><td>X Windows system window dump (color)</td></tr> 367 <tr><td><dd><img SRC="images/ball.png" ALT="*">YUV </td><td>rw-</td><td>CCIR 601 4:1:1 or 4:2:2 (8-bit only)</td></tr> 368 <tr><td> </td><td> </td><td></td></tr> 369 <tr><td> Modes: </td><td> </td><td></td></tr> 370 <tr><td> </td><td>r </td><td>Read</td></tr> 371 <tr><td> </td><td>w </td><td>Write</td></tr> 372 <tr><td> </td><td>+ </td><td>Multi-image</td></tr> 373 <br> <br> 374 </table> 375 <p> 376 <em>Support for some of these formats require additional programs or libraries. 377 See <a href="README.html">README</a> 378 in the source package for where to find optional additional software</em>. 379 <p> 380 Note, a format delineated with <tt>+</tt> means that if more than one 381 image is specified, frames are combined into a single multi-image 382 file. Use <strong>+adjoin</strong> if you want a single image produced for each 383 frame. 384 <p> 385 Your installation might not support all of the formats in the list. 386 To get an accurate listing of the formats supported by your particular 387 configuration, run <tt>"gm convert -list format"</tt>. 388 <p> 389 Raw images are expected to have one byte per pixel unless <strong>gm</strong> is 390 compiled in 16-bit quantum mode or in 32-bit quantum mode. Here, the 391 raw data is expected to be stored two or four bytes per pixel, 392 respectively, in most-significant-byte-first order. For example, you 393 can tell if <strong>gm</strong> was compiled in 16-bit mode by typing "gm 394 version" without any options, and looking for "Q:16" in the first line 395 of output. 396 </td></tr></table> 397 <p> 398 <i><a href="#top">Back to Contents</a></i> 399 </p> 400 <table BORDER=0 WIDTH="100%"> 401 <tr> 402 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 403 SRC="images/right_triangle.png" ALT=">" BORDER=0 404 height=14 width=15><b><font face="Helvetica, Arial"><font 405 color="#00B04F"><font size="+1"> 406 <a NAME="files"></a>Files and Formats 407 </font></font></font></b></td></tr></table> 408 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 409 <tr><td width="3%"><br></td><td> 410 <p> 411 By default, the image format is determined by its magic number, i.e., the 412 first few bytes of the file. To specify 413 a particular image format, precede the filename with an image format name 414 and a colon (<em>i.e.</em><strong>ps:image</strong>) or specify the image type as the 415 filename suffix (<em>i.e.</em><strong>image.ps</strong>). 416 The magic number takes precedence over the filename suffix 417 and the prefix takes precedence over the magic number and the suffix 418 in input files. 419 When a file is read, its magic number is stored in the "image->magick" 420 string. 421 In output files, the prefix takes precedence over the filename suffix, 422 and the filename suffix takes precedence over the 423 "image->magick" string. 424 <br> <br> 425 <p>To read the "built-in" formats (GRANITE, H, LOGO, 426 NETSCAPE, PLASMA, and ROSE) use a prefix (including the colon) without a 427 filename or suffix. To read the XC format, follow the colon with a color 428 specification. To read the CAPTION format, follow the colon with a text 429 string or with a filename prefixed with the at symbol (<strong>@</strong>). 430 <br> <br> 431 <p> 432 When you specify <strong>X</strong> as your image type, the filename has special 433 meaning. It specifies an X window by <strong>id, name</strong>, or 434 <strong>root</strong>. If 435 no filename is specified, the window is selected by clicking the mouse 436 in the desired window. 437 <p> 438 Specify <em>input_file</em> as <strong>-</strong> for standard input, 439 <em>output_file</em> as <strong>-</strong> for standard output. 440 If <em>input_file</em> has the extension <strong>.Z</strong> or <strong>.gz</strong>, the 441 file is uncompressed with <strong>uncompress</strong> or <strong>gunzip</strong> 442 respectively. 443 If <em>output_file</em> has the extension <strong>.Z</strong> or <strong>.gz</strong>, 444 the file is compressed using with <em>compress</em> or <em>gzip</em> respectively. 445 <p> 446 Use an optional index enclosed in brackets after an input file name to 447 specify a desired subimage of a multi-resolution image format like 448 Photo CD (e.g. <tt>"img0001.pcd[4]"</tt>) or a range for MPEG images 449 (e.g. <tt>"video.mpg[50-75]"</tt>). A subimage specification can be 450 disjoint (e.g. <tt>"image.tiff[2,7,4]"</tt>). For raw images, specify 451 a subimage with a geometry (e.g. <tt>-size 640x512</tt> 452 <tt>"image.rgb[320x256+50+50]"</tt>). Surround the image name with 453 quotation marks to prevent your shell from interpreting the square 454 brackets. <p>Single images are written with the filename you 455 specify. However, multi-part images (e.g., a multi-page PostScript 456 document with <strong>+adjoin</strong> specified) may be written with the scene 457 number included as part of the filename. In order to include the scene 458 number in the filename, it is necessary to include a printf-style 459 <tt>%d</tt> format specification in the file name and use the +adjoin 460 option. For example, 461 <pre> 462 image%02d.miff 463 </pre> 464 <p> 465 writes files <em>image00.miff, image01.miff,</em> etc. Only a single 466 specification is allowed within an output filename. If more than one 467 specification is present, it will be ignored. It is best to embed the 468 scene number in the base part of the file name, not in the extension, 469 because the extension will not be a recognizeable image type. 470 <p> 471 When running a commandline utility, you can 472 prepend an at sign <tt>@</tt> to a filename to read a list of image 473 filenames from that file. This is convenient in the event you have too 474 many image filenames to fit on the command line. 475 </td></tr></table> 476 <p> 477 <i><a href="#top">Back to Contents</a></i> 478 </p> 479 <table BORDER=0 WIDTH="100%"> 480 <tr> 481 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 482 SRC="images/right_triangle.png" ALT=">" BORDER=0 483 height=14 width=15><b><font face="Helvetica, Arial"><font 484 color="#00B04F"><font size="+1"> 485 <a NAME="opti"></a>Options 486 </font></font></font></b></td></tr></table> 487 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 488 <tr><td width="3%"><br></td><td> 489 <p> 490 Options are processed in command line order. Any option you specify on 491 the command line remains in effect for the set of images that follows, 492 until the set is terminated by the appearance of any option or <strong>-noop</strong>. 493 Some options only affect the decoding of images and others only the encoding. 494 The latter can appear after the final group of input images. 495 <p> 496 This is a combined list of the command-line options used by the 497 GraphicsMagick utilities (<em>animate</em>, <em>compare</em>, 498 <em>composite</em>, <em>convert</em>, <em>display</em>, <em>identify</em>, 499 <em>import</em>, <em>mogrify</em> and <em>montage</em>). 500 <br> <br> 501 <p> 502 In this document, angle brackets ("<>") enclose variables and curly 503 brackets ("{}") enclose optional parameters. For example, 504 "<strong>-fuzz <distance>{%}</strong>" means you can use the 505 option <tt>"-fuzz 10"</tt> 506 or <tt>"-fuzz 2%"</tt>. 507 <br> <br> 508 <table BORDER=0 WIDTH="94%"> 509 <tr> 510 <td width="3%"><br></td> 511 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 512 <img SRC="images/right_triangle_option.png" 513 ALT=">" BORDER=0 height=14 514 width=15><b><font face="Helvetica, Arial" 515 ><font color="#00B04F"><font size="+1"> 516 <a name="details-adjoin"></a>-adjoin 517 </font></font></font></b></td></tr></table> 518 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>join images into a single multi-image file</td></tr></table> 519 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 520 By default, all images of an image sequence are stored in the same 521 file. However, some formats (e.g. JPEG) do not support storing more 522 than one image per file and only the first frame in an image sequence 523 will be saved unless the result is saved to separate files. Use 524 <strong>+adjoin</strong> to force saving multiple frames to multiple numbered 525 files. If <strong>+adjoin</strong> is used, then the output filename must 526 include a printf style formatting specification for the numeric part 527 of the filename. For example,</font></td></tr></table> 528 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 529 image%02d.miff 530 </pre></font></td></tr></table> 531 <table BORDER=0 WIDTH="94%"> 532 <tr> 533 <td width="3%"><br></td> 534 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 535 <img SRC="images/right_triangle_option.png" 536 ALT=">" BORDER=0 height=14 537 width=15><b><font face="Helvetica, Arial" 538 ><font color="#00B04F"><font size="+1"> 539 <a name="details-affine"></a>-affine <i><matrix></i> 540 </font></font></font></b></td></tr></table> 541 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>drawing transform matrix</td></tr></table> 542 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 543 This option provides a transform matrix <tt>{sx,rx,ry,sy,tx,ty}</tt> for 544 use by subsequent <strong>-draw</strong> or <strong>-transform</strong> options.</font></td></tr></table> 545 <table BORDER=0 WIDTH="94%"> 546 <tr> 547 <td width="3%"><br></td> 548 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 549 <img SRC="images/right_triangle_option.png" 550 ALT=">" BORDER=0 height=14 551 width=15><b><font face="Helvetica, Arial" 552 ><font color="#00B04F"><font size="+1"> 553 <a name="details-antialias"></a>-antialias 554 </font></font></font></b></td></tr></table> 555 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove pixel aliasing</td></tr></table> 556 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 557 By default antialiasing algorithms are used when drawing objects (e.g. lines) 558 or rendering vector formats (e.g. WMF and Postscript). Use +antialias to 559 disable use of antialiasing algorithms. Reasons to disable antialiasing 560 include avoiding increasing colors in the image, or improving rendering speed.</font></td></tr></table> 561 <table BORDER=0 WIDTH="94%"> 562 <tr> 563 <td width="3%"><br></td> 564 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 565 <img SRC="images/right_triangle_option.png" 566 ALT=">" BORDER=0 height=14 567 width=15><b><font face="Helvetica, Arial" 568 ><font color="#00B04F"><font size="+1"> 569 <a name="details-append"></a>-append 570 </font></font></font></b></td></tr></table> 571 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>append a set of images</td></tr></table> 572 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 573 This option creates a single image where the images in the original set 574 are stacked top-to-bottom. If they are not of the same width, 575 any narrow images will be expanded to fit using the background color. 576 Use <strong>+append</strong> to stack images left-to-right. The set of images 577 is terminated by the appearance of any option. 578 If the <strong>-append</strong> 579 option appears after all of the input images, all images are appended.</font></td></tr></table> 580 <table BORDER=0 WIDTH="94%"> 581 <tr> 582 <td width="3%"><br></td> 583 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 584 <img SRC="images/right_triangle_option.png" 585 ALT=">" BORDER=0 height=14 586 width=15><b><font face="Helvetica, Arial" 587 ><font color="#00B04F"><font size="+1"> 588 <a name="details"></a> <i>-asc-cdl <spec></i> 589 </font></font></font></b></td></tr></table> 590 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply ASC CDL color transform</td></tr></table> 591 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 592 Applies ("bakes in") the ASC CDL, which is a format for the exchange 593 of basic primary color grading information between equipment and 594 software from different manufacturers. The format defines the math for 595 three functions: slope, offset and power. Each function uses a number 596 for the red, green, and blue color channels for a total of nine 597 numbers comprising a single color decision. The tenth number 598 (optional) is for chromiance (saturation) as specified by ASC CDL 599 1.2.</font></td></tr></table> 600 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 601 The argument string is comma delimited and is in the following form 602 (but without invervening spaces or line breaks)</font></td></tr></table> 603 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 604 redslope,redoffset,redpower: 605 greenslope,greenoffset,greenpower: 606 blueslope,blueoffset,bluepower: 607 saturation 608 </pre></font></td></tr></table> 609 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 610 with the unity (no change) specification being:</font></td></tr></table> 611 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 612 "1.0,0.0,1.0:1.0,0.0,1.0:1.0,0.0,1.0:1.0" 613 </pre></font></td></tr></table> 614 <table BORDER=0 WIDTH="94%"> 615 <tr> 616 <td width="3%"><br></td> 617 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 618 <img SRC="images/right_triangle_option.png" 619 ALT=">" BORDER=0 height=14 620 width=15><b><font face="Helvetica, Arial" 621 ><font color="#00B04F"><font size="+1"> 622 <a name="details-authenticate"></a>-authenticate <i><string></i> 623 </font></font></font></b></td></tr></table> 624 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table> 625 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 626 Use this option to supply a password for decrypting an image or an 627 image sequence, if it is being read from a format such as PDF that supports 628 encryption. Encrypting images being written is not supported.</font></td></tr></table> 629 <table BORDER=0 WIDTH="94%"> 630 <tr> 631 <td width="3%"><br></td> 632 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 633 <img SRC="images/right_triangle_option.png" 634 ALT=">" BORDER=0 height=14 635 width=15><b><font face="Helvetica, Arial" 636 ><font color="#00B04F"><font size="+1"> 637 <a name="details-auto-orient"></a>-auto-orient 638 </font></font></font></b></td></tr></table> 639 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>orient (rotate) image so it is upright</td></tr></table> 640 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 641 Adjusts the image orienation so that it is suitable for viewing. Uses 642 the orientation tag obtained from the image file or as supplied by the 643 <strong>-orient</strong> option.</font></td></tr></table> 644 <table BORDER=0 WIDTH="94%"> 645 <tr> 646 <td width="3%"><br></td> 647 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 648 <img SRC="images/right_triangle_option.png" 649 ALT=">" BORDER=0 height=14 650 width=15><b><font face="Helvetica, Arial" 651 ><font color="#00B04F"><font size="+1"> 652 <a name="details-average"></a>-average 653 </font></font></font></b></td></tr></table> 654 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>average a set of images</td></tr></table> 655 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 656 The set of images 657 is terminated by the appearance of any option. 658 If the <strong>-average</strong> 659 option appears after all of the input images, all images are averaged.</font></td></tr></table> 660 <table BORDER=0 WIDTH="94%"> 661 <tr> 662 <td width="3%"><br></td> 663 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 664 <img SRC="images/right_triangle_option.png" 665 ALT=">" BORDER=0 height=14 666 width=15><b><font face="Helvetica, Arial" 667 ><font color="#00B04F"><font size="+1"> 668 <a name="details-backdrop"></a>-backdrop 669 </font></font></font></b></td></tr></table> 670 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the image centered on a backdrop.</td></tr></table> 671 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 672 This backdrop covers the entire workstation screen and is useful for hiding 673 other X window activity while viewing the image. The color of the backdrop 674 is specified as the foreground color (X11 default is black).</font></td></tr></table> 675 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">Refer to 676 "X Resources", below, 677 for details.</font></td></tr></table> 678 <table BORDER=0 WIDTH="94%"> 679 <tr> 680 <td width="3%"><br></td> 681 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 682 <img SRC="images/right_triangle_option.png" 683 ALT=">" BORDER=0 height=14 684 width=15><b><font face="Helvetica, Arial" 685 ><font color="#00B04F"><font size="+1"> 686 <a name="details-background"></a>-background <i><color></i> 687 </font></font></font></b></td></tr></table> 688 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the background color</td></tr></table> 689 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 690 The color is specified using the format described under the <strong>-fill</strong> 691 option.</font></td></tr></table> 692 <table BORDER=0 WIDTH="94%"> 693 <tr> 694 <td width="3%"><br></td> 695 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 696 <img SRC="images/right_triangle_option.png" 697 ALT=">" BORDER=0 height=14 698 width=15><b><font face="Helvetica, Arial" 699 ><font color="#00B04F"><font size="+1"> 700 <a name="details-black-threshold"></a>-black-threshold <i>red[,green][,blue][,opacity]</i> 701 </font></font></font></b></td></tr></table> 702 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pixels below the threshold become black</td></tr></table> 703 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 704 Use <strong>-black-threshold</strong> to set pixels with values below the specified 705 threshold to minimum value (black). If only one value is supplied, or the 706 red, green, and blue values are identical, then intensity thresholding is 707 used. If the color threshold values are not identical then channel-based 708 thresholding is used, and color distortion will occur. Specify a negative 709 value (e.g. -1) if you want a channel to be ignored but you do want to 710 threshold a channel later in the list. If a percent (%) symbol is 711 appended, then the values are treated as a percentage of maximum 712 range.</font></td></tr></table> 713 <table BORDER=0 WIDTH="94%"> 714 <tr> 715 <td width="3%"><br></td> 716 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 717 <img SRC="images/right_triangle_option.png" 718 ALT=">" BORDER=0 height=14 719 width=15><b><font face="Helvetica, Arial" 720 ><font color="#00B04F"><font size="+1"> 721 <a name="details-blue-primary"></a>-blue-primary <i><x>,<y></i> 722 </font></font></font></b></td></tr></table> 723 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blue chromaticity primary point</td></tr></table> 724 <table BORDER=0 WIDTH="94%"> 725 <tr> 726 <td width="3%"><br></td> 727 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 728 <img SRC="images/right_triangle_option.png" 729 ALT=">" BORDER=0 height=14 730 width=15><b><font face="Helvetica, Arial" 731 ><font color="#00B04F"><font size="+1"> 732 <a name="details-blur"></a>-blur <i><radius></i>{<i>x<sigma></i>}<i></i> 733 </font></font></font></b></td></tr></table> 734 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blur the image with a Gaussian operator</td></tr></table> 735 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 736 Blur with the given radius and 737 standard deviation (sigma).</font></td></tr></table> 738 <table BORDER=0 WIDTH="94%"> 739 <tr> 740 <td width="3%"><br></td> 741 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 742 <img SRC="images/right_triangle_option.png" 743 ALT=">" BORDER=0 height=14 744 width=15><b><font face="Helvetica, Arial" 745 ><font color="#00B04F"><font size="+1"> 746 <a name="details-border"></a>-border <i><width>x<height></i> 747 </font></font></font></b></td></tr></table> 748 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with a border of color</td></tr></table> 749 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 750 See <strong>-geometry</strong> for details 751 about the geometry specification.</font></td></tr></table> 752 <table BORDER=0 WIDTH="94%"> 753 <tr> 754 <td width="3%"><br></td> 755 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 756 <img SRC="images/right_triangle_option.png" 757 ALT=">" BORDER=0 height=14 758 width=15><b><font face="Helvetica, Arial" 759 ><font color="#00B04F"><font size="+1"> 760 <a name="details-bordercolor"></a>-bordercolor <i><color></i> 761 </font></font></font></b></td></tr></table> 762 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border color</td></tr></table> 763 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 764 The color is specified using the format described under the <strong>-fill</strong> 765 option.</font></td></tr></table> 766 <table BORDER=0 WIDTH="94%"> 767 <tr> 768 <td width="3%"><br></td> 769 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 770 <img SRC="images/right_triangle_option.png" 771 ALT=">" BORDER=0 height=14 772 width=15><b><font face="Helvetica, Arial" 773 ><font color="#00B04F"><font size="+1"> 774 -borderwidth <i><geometry></i> 775 </font></font></font></b></td></tr></table> 776 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border width</td></tr></table> 777 <table BORDER=0 WIDTH="94%"> 778 <tr> 779 <td width="3%"><br></td> 780 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 781 <img SRC="images/right_triangle_option.png" 782 ALT=">" BORDER=0 height=14 783 width=15><b><font face="Helvetica, Arial" 784 ><font color="#00B04F"><font size="+1"> 785 <a name="details-box"></a>-box <i><color></i> 786 </font></font></font></b></td></tr></table> 787 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set the color of the annotation bounding box</td></tr></table> 788 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 789 The color is specified using the format described under the <strong>-fill</strong> 790 option.</font></td></tr></table> 791 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 792 See <strong>-draw</strong> for further 793 details.</font></td></tr></table> 794 <table BORDER=0 WIDTH="94%"> 795 <tr> 796 <td width="3%"><br></td> 797 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 798 <img SRC="images/right_triangle_option.png" 799 ALT=">" BORDER=0 height=14 800 width=15><b><font face="Helvetica, Arial" 801 ><font color="#00B04F"><font size="+1"> 802 <a name="details-channel"></a>-channel <i><type></i> 803 </font></font></font></b></td></tr></table> 804 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of channel</td></tr></table> 805 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 806 Choose from: <strong>Red</strong>, <strong>Green</strong>, <strong>Blue</strong>, <strong>Opacity</strong>, 807 <strong>Matte</strong>, <strong>Cyan</strong>, <strong>Magenta</strong>, <strong>Yellow</strong>, <strong>Black</strong>, 808 or <strong>Gray</strong>.</font></td></tr></table> 809 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 810 Use this option to extract a particular <em>channel</em> from the image. 811 <strong>Opacity</strong>, 812 for example, is useful for extracting the opacity values from an image.</font></td></tr></table> 813 <table BORDER=0 WIDTH="94%"> 814 <tr> 815 <td width="3%"><br></td> 816 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 817 <img SRC="images/right_triangle_option.png" 818 ALT=">" BORDER=0 height=14 819 width=15><b><font face="Helvetica, Arial" 820 ><font color="#00B04F"><font size="+1"> 821 -charcoal <i><factor></i> 822 </font></font></font></b></td></tr></table> 823 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>simulate a charcoal drawing</td></tr></table> 824 <table BORDER=0 WIDTH="94%"> 825 <tr> 826 <td width="3%"><br></td> 827 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 828 <img SRC="images/right_triangle_option.png" 829 ALT=">" BORDER=0 height=14 830 width=15><b><font face="Helvetica, Arial" 831 ><font color="#00B04F"><font size="+1"> 832 <a name="details-chop"></a>-chop <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i> 833 </font></font></font></b></td></tr></table> 834 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove pixels from the interior of an image</td></tr></table> 835 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 836 <em>Width</em> and <em>height</em> give the number of columns and rows to remove, 837 and <em>x</em> and <em>y</em> are offsets that give the location of the 838 leftmost column and topmost row to remove.</font></td></tr></table> 839 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 840 The <em>x</em> offset normally specifies the leftmost column to remove. 841 If the <strong>-gravity</strong> option is present with <em>NorthEast, East,</em> 842 or <em>SouthEast</em> 843 gravity, it gives the distance leftward from the right edge 844 of the image to the rightmost column to remove. Similarly, the <em>y</em> offset 845 normally specifies the topmost row to remove, but if 846 the <strong>-gravity</strong> option is present with <em>SouthWest, South,</em> 847 or <em>SouthEast</em> 848 gravity, it specifies the distance upward from the bottom edge of the 849 image to the bottom row to remove.</font></td></tr></table> 850 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 851 The <strong>-chop</strong> option removes entire rows and columns, 852 and moves the remaining corner blocks leftward and upward to close the gaps.</font></td></tr></table> 853 <table BORDER=0 WIDTH="94%"> 854 <tr> 855 <td width="3%"><br></td> 856 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 857 <img SRC="images/right_triangle_option.png" 858 ALT=">" BORDER=0 height=14 859 width=15><b><font face="Helvetica, Arial" 860 ><font color="#00B04F"><font size="+1"> 861 <a name="details-clip"></a>-clip 862 </font></font></font></b></td></tr></table> 863 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply the clipping path, if one is present</td></tr></table> 864 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 865 If a clipping path is present, it will be applied to subsequent operations.</font></td></tr></table> 866 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 867 For example, if you type the following command:</font></td></tr></table> 868 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 869 gm convert -clip -negate cockatoo.tif negated.tif 870 </pre></font></td></tr></table> 871 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 872 only the pixels within the clipping path are negated.</font></td></tr></table> 873 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 874 The <strong>-clip</strong> feature requires the XML library. If the XML library 875 is not present, the option is ignored.</font></td></tr></table> 876 <table BORDER=0 WIDTH="94%"> 877 <tr> 878 <td width="3%"><br></td> 879 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 880 <img SRC="images/right_triangle_option.png" 881 ALT=">" BORDER=0 height=14 882 width=15><b><font face="Helvetica, Arial" 883 ><font color="#00B04F"><font size="+1"> 884 <a name="details-coalesce"></a>-coalesce 885 </font></font></font></b></td></tr></table> 886 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>merge a sequence of images</td></tr></table> 887 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 888 Each image N in the sequence after Image 0 is replaced with the image 889 created by flattening images 0 through N.</font></td></tr></table> 890 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 891 The set of images 892 is terminated by the appearance of any option. 893 If the <strong>-coalesce</strong> 894 option appears after all of the input images, all images are coalesced.</font></td></tr></table> 895 <table BORDER=0 WIDTH="94%"> 896 <tr> 897 <td width="3%"><br></td> 898 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 899 <img SRC="images/right_triangle_option.png" 900 ALT=">" BORDER=0 height=14 901 width=15><b><font face="Helvetica, Arial" 902 ><font color="#00B04F"><font size="+1"> 903 <a name="details-colorize"></a>-colorize <i><value></i> 904 </font></font></font></b></td></tr></table> 905 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>colorize the image with the pen color</td></tr></table> 906 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 907 Specify the amount of colorization as a percentage. You can apply separate 908 colorization values to the red, green, and blue channels of the image with 909 a colorization value list delimited with slashes (e.g. 0/0/50).</font></td></tr></table> 910 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 911 The <strong>-colorize</strong> option may be used in conjunction with <strong>-modulate</strong> 912 to produce a nice sepia toned image like:</font></td></tr></table> 913 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 914 gm convert input.ppm -modulate 115,0,100 \ 915 -colorize 7,21,50 output.ppm. 916 </pre></font></td></tr></table> 917 <table BORDER=0 WIDTH="94%"> 918 <tr> 919 <td width="3%"><br></td> 920 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 921 <img SRC="images/right_triangle_option.png" 922 ALT=">" BORDER=0 height=14 923 width=15><b><font face="Helvetica, Arial" 924 ><font color="#00B04F"><font size="+1"> 925 <a name="details-colormap"></a>-colormap <i><type></i> 926 </font></font></font></b></td></tr></table> 927 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>define the colormap type</td></tr></table> 928 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 929 Choose between <strong>shared</strong> or <strong>private</strong>.</font></td></tr></table> 930 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 931 This option only applies when the default X server visual is <em>PseudoColor</em> 932 or <em>GRAYScale</em>. Refer to <strong>-visual</strong> for more details. By default, 933 a shared colormap is allocated. The image shares colors with other X clients. 934 Some image colors could be approximated, therefore your image may look 935 very different than intended. Choose <strong>Private</strong> and the image colors 936 appear exactly as they are defined. However, other clients may 937 go <em>technicolor</em> when the image colormap is installed.</font></td></tr></table> 938 <table BORDER=0 WIDTH="94%"> 939 <tr> 940 <td width="3%"><br></td> 941 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 942 <img SRC="images/right_triangle_option.png" 943 ALT=">" BORDER=0 height=14 944 width=15><b><font face="Helvetica, Arial" 945 ><font color="#00B04F"><font size="+1"> 946 <a name="details-colors"></a>-colors <i><value></i> 947 </font></font></font></b></td></tr></table> 948 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table> 949 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 950 The actual number of colors in the image may be less than your request, 951 but never more. Note, this is a color reduction option. Images with less 952 unique colors than specified with this option will have any duplicate or 953 unused colors removed. The ordering of an existing color palette may be 954 altered. When converting an image from color to grayscale, convert the 955 image to the gray colorspace before reducing the number of colors since 956 doing so is most efficient. Refer to <a 957 href="quantize.html">quantize</a> for more details.</font></td></tr></table> 958 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 959 Note, options <strong>-dither</strong>, <strong>-colorspace</strong>, and <strong>-treedepth</strong> 960 affect the color reduction algorithm.</font></td></tr></table> 961 <table BORDER=0 WIDTH="94%"> 962 <tr> 963 <td width="3%"><br></td> 964 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 965 <img SRC="images/right_triangle_option.png" 966 ALT=">" BORDER=0 height=14 967 width=15><b><font face="Helvetica, Arial" 968 ><font color="#00B04F"><font size="+1"> 969 <a name="details-colorspace"></a>-colorspace <i><value></i> 970 </font></font></font></b></td></tr></table> 971 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table> 972 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 973 Choices are: 974 <strong>CineonLog</strong>, <strong>CMYK</strong>, <strong>GRAY</strong>, <strong>HSL</strong>, <strong>HWB</strong>, 975 <strong>OHTA</strong>, <strong>RGB</strong>, <strong>Rec601Luma</strong>, <strong>Rec709Luma</strong>, 976 <strong>Rec601YCbCr</strong>, <strong>Rec709YCbCr</strong>, <strong>Transparent</strong>, <strong>XYZ</strong>, 977 <strong>YCbCr</strong>, <strong>YIQ</strong>, <strong>YPbPr</strong>, or <strong>YUV</strong>.</font></td></tr></table> 978 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 979 Color reduction, by default, takes place in the RGB color space. Empirical 980 evidence suggests that distances in color spaces such as YUV or YIQ correspond 981 to perceptual color differences more closely than do distances in RGB space. 982 These color spaces may give better results when color reducing an image. 983 Refer to <a href="quantize.html">quantize</a> for more details.</font></td></tr></table> 984 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">Two gray colorspaces are supported. The <strong>Rec601Luma</strong> space is 985 based on the recommendations for legacy NTSC television (ITU-R 986 BT.601-5). The <strong>Rec709Luma</strong> space is based on the 987 recommendations for HDTV (Rec. ITU-R BT.709-5) and is suitable for use 988 with computer graphics, and for contemporary CRT displays. The 989 <strong>GRAY</strong> colorspace currently selects the <strong>Rec601Luma</strong> 990 colorspace by default for backwards compatibly reasons. This default 991 may be re-considered in the future. 992 </font></td></tr></table> 993 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">Two YCbCr colorspaces are supported. The <strong>Rec601YCbCr</strong> space is 994 based on the recommendations for legacy NTSC television (ITU-R BT.601-5). The 995 <strong>Rec709CbCr</strong> space is based on the recommendations for HDTV (Rec. 996 ITU-R BT.709-5) and is suitable for suitable for use with computer 997 graphics, and for contemporary CRT displays. The <strong>YCbCr</strong> colorspace 998 specification is equivalent to<strong>Rec601YCbCr</strong>. 999 </font></td></tr></table> 1000 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1001 The <strong>Transparent</strong> color space behaves uniquely in that it preserves 1002 the matte channel of the image if it exists.</font></td></tr></table> 1003 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1004 The <strong>-colors</strong> or <strong>-monochrome</strong> option, or saving to a file 1005 format which requires color reduction, is required for this option to 1006 take effect.</font></td></tr></table> 1007 <table BORDER=0 WIDTH="94%"> 1008 <tr> 1009 <td width="3%"><br></td> 1010 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1011 <img SRC="images/right_triangle_option.png" 1012 ALT=">" BORDER=0 height=14 1013 width=15><b><font face="Helvetica, Arial" 1014 ><font color="#00B04F"><font size="+1"> 1015 <a name="details-comment"></a>-comment <i><string></i> 1016 </font></font></font></b></td></tr></table> 1017 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with a comment</td></tr></table> 1018 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1019 Use this option to assign a specific comment to the image, when writing 1020 to an image format that supports comments. You can include the 1021 image filename, type, width, height, or other image attribute by embedding 1022 special format characters listed under the <strong>-format</strong> option. 1023 The comment is not drawn on the image, but is embedded in the image 1024 datastream via a "Comment" tag or similar mechanism. If you want the 1025 comment to be visible on the image itself, use the <strong>-draw</strong> option 1026 instead.</font></td></tr></table> 1027 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1028 For example,</font></td></tr></table> 1029 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 1030 -comment "%m:%f %wx%h" 1031 </pre></font></td></tr></table> 1032 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1033 produces an image comment of <strong>MIFF:bird.miff 512x480</strong> for an image 1034 titled <strong>bird.miff</strong> and whose width is 512 and height is 480.</font></td></tr></table> 1035 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1036 If the first character of <em>string</em> is <em>@</em>, the image comment 1037 is read from a file titled by the remaining characters in the string. 1038 Please note that if the string comes from an untrusted source that it 1039 should be sanitized before use since otherwise the content of an 1040 arbitrary readable file could be incorporated in a comment in the 1041 output file (a security risk).</font></td></tr></table> 1042 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1043 If the -comment option appears multiple times, only the last comment is 1044 stored.</font></td></tr></table> 1045 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1046 In PNG images, the comment is stored in a <strong>tEXt</strong> or <strong>zTXt</strong> chunk 1047 with the keyword "comment".</font></td></tr></table> 1048 <table BORDER=0 WIDTH="94%"> 1049 <tr> 1050 <td width="3%"><br></td> 1051 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1052 <img SRC="images/right_triangle_option.png" 1053 ALT=">" BORDER=0 height=14 1054 width=15><b><font face="Helvetica, Arial" 1055 ><font color="#00B04F"><font size="+1"> 1056 <a name="details-compose"></a>-compose <i><operator></i> 1057 </font></font></font></b></td></tr></table> 1058 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image composition</td></tr></table> 1059 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1060 The description of composition uses abstract terminology in order to 1061 allow the the description to be more clear, while avoiding constant 1062 values which are specific to a particular build configuration. Each image 1063 pixel is represented by red, green, and blue levels (which are equal for 1064 a gray pixel). MaxRGB is the maximum integral value which may be stored 1065 in the red, green, or blue channels of the image. Each image pixel may 1066 also optionally (if the image matte channel is enabled) have an 1067 associated level of opacity (ranging from opaque to transparent), which 1068 may be used to determine the influence of the pixel color when 1069 compositing the pixel with another image pixel. If the image matte 1070 channel is disabled, then all pixels in the image are treated as opaque. 1071 The color of an <em>opaque</em> pixel is fully visible while the color of a 1072 <em>transparent</em> pixel color is entirely absent (pixel color is ignored).</font></td></tr></table> 1073 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1074 By definition, raster images have a rectangular shape. All image rows are 1075 of equal length, and all image columns have the same number of rows. By 1076 treating the opacity channel as a visual "mask" the rectangular image may 1077 be given a "shape" by treating the opacity channel as a cookie-cutter for 1078 the image. Pixels within the shape are opaque, while pixels outside the 1079 shape are transparent. Pixels on the boundary of the shape may be between 1080 opaque and transparent in order to provide antialiasing (visually smooth 1081 edges). The description of the composition operators use this concept of 1082 image "shape" in order to make the description of the operators easier to 1083 understand. While it is convenient to describe the operators in terms of 1084 "shapes" they are by no means limited to mask-style operations since they 1085 are based on continuous floating-point mathematics rather than simple 1086 boolean operations.</font></td></tr></table> 1087 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1088 By default, the <em>Over</em> composite operator is used. The following 1089 composite operators are available:</font></td></tr></table> 1090 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 1091 Over 1092 In 1093 Out 1094 Atop 1095 Xor 1096 Plus 1097 Minus 1098 Add 1099 Subtract 1100 Difference 1101 Divide 1102 Multiply 1103 Bumpmap 1104 Copy 1105 CopyRed 1106 CopyGreen 1107 CopyBlue 1108 CopyOpacity 1109 CopyCyan 1110 CopyMagenta 1111 CopyYellow 1112 CopyBlack 1113 </pre></font></td></tr></table> 1114 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1115 The behavior of each operator is described below.</font></td></tr></table> 1116 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1117 <dl> 1118 <dt>Over</dt> 1119 <dd>The result will be the union of the two image shapes, with opaque areas 1120 of <em>change-image</em> obscuring <em>base-image</em> in the region of 1121 overlap. 1122 </dd> 1123 <dt>In</dt> 1124 <dd>The result is simply <em>change-image</em> cut by the shape of 1125 <em>base-image</em>. None of the image data of <em>base-image</em> will be in 1126 the result. 1127 </dd> 1128 <dt>Out</dt> 1129 <dd>The resulting image is <em>change-image</em> with the shape of 1130 <em>base-image</em> cut out. 1131 </dd> 1132 <dt>Atop</dt> 1133 <dd>The result is the same shape as <em>base-image</em>, with 1134 <em>change-image</em> obscuring <em>base-image</em> where the image shapes 1135 overlap. Note this differs from <strong>over</strong> because the portion of 1136 <em>change-image</em> outside <em>base-image</em>'s shape does not appear in 1137 the result. 1138 </dd> 1139 <dt>Xor</dt> 1140 <dd>The result is the image data from both <em>change-image</em> and 1141 <em>base-image</em> that is outside the overlap region. The overlap region 1142 will be blank. 1143 </dd> 1144 <dt>Plus</dt> 1145 <dd>The result is just the sum of the image data. Output values are cropped 1146 to MaxRGB (no overflow). This operation is independent of the matte 1147 channels. 1148 </dd> 1149 <dt>Minus</dt> 1150 <dd>The result of <em>change-image</em> - <em>base-image</em>, with underflow 1151 cropped to zero. The matte channel is ignored (set to opaque, full 1152 coverage). 1153 </dd> 1154 <dt>Add</dt> 1155 <dd>The result of <em>change-image</em> + <em>base-image</em>, with overflow 1156 wrapping around (<em>mod</em> MaxRGB+1). 1157 </dd> 1158 <dt>Subtract</dt> 1159 <dd>The result of <em>change-image</em> - <em>base-image</em>, with underflow 1160 wrapping around (<em>mod</em> MaxRGB+1). The <strong>add</strong> and <strong>subtract</strong> 1161 operators can be used to perform reversible transformations. 1162 </dd> 1163 <dt>Difference</dt> 1164 <dd>The result of abs(<em>change-image</em> - <em>base-image</em>). This is 1165 useful for comparing two very similar images. 1166 </dd> 1167 <dt>Divide</dt> 1168 <dd>The result of <em>change-image</em> / <em>base-image</em>. This is useful 1169 for improving the readability of text on unevenly illuminated photos (by 1170 using a gaussian blurred copy of change-image as base-image). 1171 </dd> 1172 <dt>Multiply</dt> 1173 <dd>The result of <em>change-image</em> * <em>base-image</em>. This is useful for 1174 the creation of drop-shadows. 1175 </dd> 1176 <dt>Bumpmap</dt> 1177 <dd>The result <em>base-image</em> shaded by <em>change-image</em>. 1178 </dd> 1179 <dt>Copy</dt> 1180 <dd>The resulting image is <em>base-image</em> replaced with 1181 <em>change-image</em>. Here the matte information is ignored. 1182 </dd> 1183 <dt>CopyRed</dt> 1184 <dd>The resulting image is the red channel in <em>base-image</em> replaced with 1185 the red channel in <em>change-image</em>. The other channels are copied 1186 untouched. 1187 </dd> 1188 <dt>CopyGreen</dt> 1189 <dd>The resulting image is the green channel in <em>base-image</em> replaced 1190 with the green channel in <em>change-image</em>. The other channels are 1191 copied untouched. 1192 </dd> 1193 <dt>CopyBlue</dt> 1194 <dd>The resulting image is the blue channel in <em>base-image</em> replaced 1195 with the blue channel in <em>change-image</em>. The other channels are 1196 copied untouched. 1197 </dd> 1198 <dt>CopyOpacity</dt> 1199 <dd>The resulting image is the opacity channel in <em>base-image</em> replaced 1200 with the opacity channel in <em>change-image</em>. The other channels are 1201 copied untouched. 1202 </dd> 1203 <dt>CopyCyan</dt> 1204 <dd>The resulting image is the cyan channel in <em>base-image</em> replaced 1205 with the cyan channel in <em>change-image</em>. The other channels are 1206 copied untouched. Use of this operator requires that base-image be in 1207 CMYK(A) colorspace. 1208 </dd> 1209 <dt>CopyMagenta</dt> 1210 <dd>The resulting image is the magenta channel in <em>base-image</em> 1211 replaced with the magenta channel in <em>change-image</em>. The other 1212 channels are copied untouched. Use of this operator requires that 1213 base-image be in CMYK(A) colorspace. 1214 </dd> 1215 <dt>CopyYellow</dt> 1216 <dd>The resulting image is the yellow channel in <em>base-image</em> 1217 replaced with the yellow channel in <em>change-image</em>. The other 1218 channels are copied untouched. Use of this operator requires that 1219 base-image be in CMYK(A) colorspace. 1220 </dd> 1221 <dt>CopyBlack</dt> 1222 <dd>The resulting image is the black channel in <em>base-image</em> 1223 replaced with the black channel in <em>change-image</em>. The other 1224 channels are copied untouched. Use of this operator requires that 1225 base-image be in CMYK(A) colorspace. If change-image is not in CMYK 1226 space, then the change-image pixel intensities are used. 1227 </dd> 1228 </dl> 1229 </font></td></tr></table> 1230 <table BORDER=0 WIDTH="94%"> 1231 <tr> 1232 <td width="3%"><br></td> 1233 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1234 <img SRC="images/right_triangle_option.png" 1235 ALT=">" BORDER=0 height=14 1236 width=15><b><font face="Helvetica, Arial" 1237 ><font color="#00B04F"><font size="+1"> 1238 <a name="details-compress"></a>-compress <i><type></i> 1239 </font></font></font></b></td></tr></table> 1240 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image compression</td></tr></table> 1241 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1242 Choices are: <em>None</em>, <em>BZip</em>, <em>Fax</em>, 1243 <em>Group3</em>, <em>Group4</em>, 1244 <em>JPEG</em>, <em>Lossless</em>, 1245 <em>LZW</em>, <em>RLE</em>, <em>Zip</em>, <em>LZMA</em>, <em>JPEG2000</em>, 1246 <em>JPEG2000</em>, <em>JBIG</em>, <em>JBIG2</em>, <em>WebP</em>, or <em>ZSTD</em>. 1247 </font></td></tr></table> 1248 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1249 Specify <strong>+compress</strong> to store the binary image in an uncompressed format. 1250 The default is the compression type of the specified image file.</font></td></tr></table> 1251 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1252 <em>"Lossless"</em> refers to lossless JPEG, which is only available if 1253 the JPEG library has been patched to support it. Use of lossless JPEG is 1254 generally not recommended.</font></td></tr></table> 1255 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1256 Use the <strong>-quality</strong> option to set the compression level to be used 1257 by the JPEG, JPEG-2000, PNG, MIFF, MPEG, and TIFF encoders. Use the 1258 <strong>-sampling-factor</strong> option to set the sampling factor to be used 1259 by the DPX, JPEG, MPEG, and YUV encoders for downsampling the chroma 1260 channels.</font></td></tr></table> 1261 <table BORDER=0 WIDTH="94%"> 1262 <tr> 1263 <td width="3%"><br></td> 1264 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1265 <img SRC="images/right_triangle_option.png" 1266 ALT=">" BORDER=0 height=14 1267 width=15><b><font face="Helvetica, Arial" 1268 ><font color="#00B04F"><font size="+1"> 1269 <a name="details-contrast"></a>-contrast 1270 </font></font></font></b></td></tr></table> 1271 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enhance or reduce the image contrast</td></tr></table> 1272 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1273 This option enhances the intensity differences between the lighter and 1274 darker elements of the image. Use <strong>-contrast</strong> to enhance 1275 the image 1276 or <strong>+contrast</strong> to reduce the image contrast. 1277 </font></td></tr></table> 1278 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1279 For a more pronounced effect you can repeat the option:</font></td></tr></table> 1280 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 1281 gm convert rose: -contrast -contrast rose_c2.png 1282 </pre></font></td></tr></table> 1283 <table BORDER=0 WIDTH="94%"> 1284 <tr> 1285 <td width="3%"><br></td> 1286 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1287 <img SRC="images/right_triangle_option.png" 1288 ALT=">" BORDER=0 height=14 1289 width=15><b><font face="Helvetica, Arial" 1290 ><font color="#00B04F"><font size="+1"> 1291 <a name="details-convolve"></a>-convolve <i><kernel></i> 1292 </font></font></font></b></td></tr></table> 1293 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>convolve image with the specified convolution kernel</td></tr></table> 1294 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1295 The kernel is specified as a comma-separated list of floating point 1296 values, ordered left-to right, starting with the top row. The order of 1297 the kernel is determined by the square root of the number of entries. 1298 Presently only square kernels are supported.</font></td></tr></table> 1299 <table BORDER=0 WIDTH="94%"> 1300 <tr> 1301 <td width="3%"><br></td> 1302 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1303 <img SRC="images/right_triangle_option.png" 1304 ALT=">" BORDER=0 height=14 1305 width=15><b><font face="Helvetica, Arial" 1306 ><font color="#00B04F"><font size="+1"> 1307 <a name="details-create-directories"></a>-create-directories 1308 </font></font></font></b></td></tr></table> 1309 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create output directory if required</td></tr></table> 1310 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1311 Use this option with <strong>-output-directory</strong> if the input paths contain 1312 subdirectories and it is desired to create similar subdirectories in the 1313 output directory. Without this option, <strong>mogrify</strong> will fail if the 1314 required output directory does not exist.</font></td></tr></table> 1315 <table BORDER=0 WIDTH="94%"> 1316 <tr> 1317 <td width="3%"><br></td> 1318 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1319 <img SRC="images/right_triangle_option.png" 1320 ALT=">" BORDER=0 height=14 1321 width=15><b><font face="Helvetica, Arial" 1322 ><font color="#00B04F"><font size="+1"> 1323 <a name="details-crop"></a>-crop <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i> 1324 </font></font></font></b></td></tr></table> 1325 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the cropped image</td></tr></table> 1326 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1327 See <strong>-geometry</strong> for details 1328 about the geometry specification.</font></td></tr></table> 1329 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1330 The width and height give the size of the image that remains after cropping, 1331 and <em>x</em> and <em>y</em> are offsets that give the location of the top left 1332 corner of the cropped 1333 image with respect to the original image. To specify the amount to be 1334 removed, use <strong>-shave</strong> instead.</font></td></tr></table> 1335 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1336 If the <em>x</em> and <em>y</em> offsets are present, a single image is 1337 generated, consisting of the pixels from the cropping region. 1338 The offsets specify the location of the upper left corner of 1339 the cropping region measured downward and rightward with respect to the 1340 upper left corner of the image. 1341 If the <strong>-gravity</strong> option is present with <em>NorthEast, East,</em> 1342 or <em>SouthEast</em> 1343 gravity, it gives the distance leftward from the right edge 1344 of the image to the right edge of the cropping region. Similarly, if 1345 the <strong>-gravity</strong> option is present with <em>SouthWest, South,</em> 1346 or <em>SouthEast</em> 1347 gravity, the distance is measured upward between the bottom 1348 edges.</font></td></tr></table> 1349 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1350 If the <em>x</em> and <em>y</em> offsets are omitted, a set of tiles of the 1351 specified geometry, covering the entire input image, is generated. The 1352 rightmost tiles and the bottom tiles are smaller if the 1353 specified geometry extends beyond the dimensions of the input image.</font></td></tr></table> 1354 <table BORDER=0 WIDTH="94%"> 1355 <tr> 1356 <td width="3%"><br></td> 1357 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1358 <img SRC="images/right_triangle_option.png" 1359 ALT=">" BORDER=0 height=14 1360 width=15><b><font face="Helvetica, Arial" 1361 ><font color="#00B04F"><font size="+1"> 1362 <a name="details-cycle"></a>-cycle <i><amount></i> 1363 </font></font></font></b></td></tr></table> 1364 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>displace image colormap by amount</td></tr></table> 1365 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1366 <em>Amount</em> defines the number of positions each colormap entry isshifted. 1367 </font></td></tr></table> 1368 <table BORDER=0 WIDTH="94%"> 1369 <tr> 1370 <td width="3%"><br></td> 1371 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1372 <img SRC="images/right_triangle_option.png" 1373 ALT=">" BORDER=0 height=14 1374 width=15><b><font face="Helvetica, Arial" 1375 ><font color="#00B04F"><font size="+1"> 1376 -debug <i><events></i> 1377 </font></font></font></b></td></tr></table> 1378 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table> 1379 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1380 The <tt>events</tt> parameter specifies which events are to be logged. It 1381 can be either <tt>None</tt>, <tt>All</tt>, or a comma-separated list 1382 consisting of one or more of the following domains: 1383 <tt>Annotate</tt>, 1384 <tt>Blob</tt>, 1385 <tt>Cache</tt>, 1386 <tt>Coder</tt>, 1387 <tt>Configure</tt>, 1388 <tt>Deprecate</tt>, 1389 <tt>Error</tt>, 1390 <tt>Exception</tt>, 1391 <tt>FatalError</tt>, 1392 <tt>Information</tt>, 1393 <tt>Locale</tt>, 1394 <tt>Option</tt>, 1395 <tt>Render</tt>, 1396 <tt>Resource</tt>, 1397 <tt>TemporaryFile</tt>, 1398 <tt>Transform</tt>, 1399 <tt>User</tt>. 1400 <tt>Warning</tt>, or 1401 <tt>X11</tt>, 1402 For example, to log cache and blob events, use</font></td></tr></table> 1403 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 1404 gm convert -debug "Cache,Blob" rose: rose.png 1405 </pre></font></td></tr></table> 1406 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1407 The "User" domain is normally empty, but developers can log "User" events 1408 in their private copy of GraphicsMagick.</font></td></tr></table> 1409 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1410 Use the <strong>-log</strong> option to specify the format for debugging output.</font></td></tr></table> 1411 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1412 Use <strong>+debug</strong> to turn off all logging.</font></td></tr></table> 1413 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1414 An alternative to using <strong>-debug</strong> is to use the <strong>MAGICK_DEBUG</strong> 1415 environment variable. The allowed values for the <strong>MAGICK_DEBUG</strong> 1416 environment variable are the same as for the <strong>-debug</strong> option.</font></td></tr></table> 1417 <table BORDER=0 WIDTH="94%"> 1418 <tr> 1419 <td width="3%"><br></td> 1420 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1421 <img SRC="images/right_triangle_option.png" 1422 ALT=">" BORDER=0 height=14 1423 width=15><b><font face="Helvetica, Arial" 1424 ><font color="#00B04F"><font size="+1"> 1425 <a name="details-deconstruct"></a>-deconstruct 1426 </font></font></font></b></td></tr></table> 1427 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>break down an image sequence into constituent parts</td></tr></table> 1428 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1429 This option compares each image with the next in a sequence and 1430 returns the maximum bounding region of any pixel differences it discovers. 1431 This method can undo a coalesced sequence returned by the 1432 <strong>-coalesce</strong> option, and is useful for removing redundant information 1433 from a GIF or MNG animation.</font></td></tr></table> 1434 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1435 The sequence of images 1436 is terminated by the appearance of any option. 1437 If the <strong>-deconstruct</strong> 1438 option appears after all of the input images, all images are deconstructed.</font></td></tr></table> 1439 <table BORDER=0 WIDTH="94%"> 1440 <tr> 1441 <td width="3%"><br></td> 1442 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1443 <img SRC="images/right_triangle_option.png" 1444 ALT=">" BORDER=0 height=14 1445 width=15><b><font face="Helvetica, Arial" 1446 ><font color="#00B04F"><font size="+1"> 1447 <a name="details-define"></a>-define <i><key></i>{<i>=<value></i>}<i>,...</i> 1448 </font></font></font></b></td></tr></table> 1449 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table> 1450 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">This option creates one or more definitions for coders and 1451 decoders to use while reading and writing image data. Definitions 1452 may be passed to coders and decoders to control options that are 1453 specific to certain image formats. If <em>value</em> is missing for a 1454 definition, an empty-valued definition of a flag will be created with 1455 that name. This is used to control on/off options. Use <tt>+define 1456 <key>,...</tt> to remove definitions previously created. Use 1457 <tt>+define "*"</tt> to remove all existing definitions.</font></td></tr></table> 1458 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1459 The following definitions may be created:</font></td></tr></table> 1460 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1461 <dl> 1462 <dt>cineon:colorspace={rgb|cineonlog}</dt> 1463 <dd>Use the cineon:colorspace option when reading a Cineon file to 1464 specify the colorspace the Cineon file uses. This overrides the colorspace 1465 type implied by the DPX header (if any). 1466 </dd> 1467 <dt>dpx:bits-per-sample=<value></dt> 1468 <dd>If the dpx:bits-per-sample key is defined, GraphicsMagick will write 1469 DPX images with the specified bits per sample, overriding any existing 1470 depth value. If this option is not specified, then the value is based on 1471 the existing image depth value from the original image file. The DPX 1472 standard supports bits per sample values of 1, 8, 10, 12, and 16. Many 1473 DPX readers demand a sample size of 10 bits with type A padding (see 1474 below). 1475 </dd> 1476 <dt>dpx:colorspace={rgb|cineonlog}</dt> 1477 <dd>Use the dpx:colorspace option when reading a DPX file to 1478 specify the colorspace the DPX file uses. This overrides the colorspace 1479 type implied by the DPX header (if any). 1480 </dd> 1481 <dt>dpx:packing-method={packed|a|b|lsbpad|msbpad}</dt> 1482 <dd>DPX samples are output within 32-bit words. They may be tightly 1483 packed end-to-end within the words ("packed"), padded with null bits to 1484 the right of the sample ("a" or "lsbpad"), or padded with null bits to the 1485 left of the sample ("b" or "msbpad"). This option only has an effect for 1486 sample sizes of 10 or 12 bits. If samples are not packed, the DPX 1487 standard recommends type A padding. Many DPX readers demand a sample size 1488 of 10 bits with type A padding. 1489 </dd> 1490 <dt>dpx:pixel-endian={lsb|msb}</dt> 1491 <dd>Allows the user to specify the endian order of the pixels when 1492 reading or writing the DPX files. Sometimes this is useful if the file is 1493 (or must be) written incorrectly so that the file header and the pixels 1494 use different endianness. 1495 </dd> 1496 <dt>dpx:swap-samples={true|false}</dt> 1497 <dd>GraphicsMagick strives to adhere to the DPX standard but certain 1498 aspects of the standard can be quite confusing. As a result, some 10-bit 1499 DPX files have Red and Blue interchanged, or Cb and Cr interchanged due 1500 to an different interpretation of the standard, or getting the wires 1501 crossed. The swap-samples option may be supplied when reading or writing 1502 in order to read or write using the necessary sample order. 1503 </dd> 1504 <dt>gradient:direction={South|North|West|East|NorthWest|NorthEast|SouthWest|SouthEast}</dt> 1505 <dd>By default, the gradient coder produces a gradient from top to 1506 bottom ("South"). Since GraphicsMagick 1.3.35, the gradient direction 1507 may be specified to produce gradient vectors according to a 1508 gravity-like specification. The arguments are <strong>South</strong> (Top to 1509 Bottom), <strong>North</strong> (Bottom to Top), <strong>West</strong> (Right to Left), 1510 <strong>East</strong> (Left to Right), <strong>NorthWest</strong> (Bottom-Right to 1511 Top-Left), <strong>NorthEast</strong> (Bottom-Left to Top-Right), 1512 <strong>SouthWest</strong> (Top-Right Bottom-Left), and <strong>SouthEast</strong> 1513 (Top-Left to Bottom-Right). 1514 </dd> 1515 <dt>jp2:rate=<value></dt> 1516 <dd>Specify the compression factor to use while writing JPEG-2000 1517 files. The compression factor is the reciprocal of the compression 1518 ratio. The valid range is 0.0 to 1.0, with 1.0 indicating lossless 1519 compression. If defined, this value overrides the -quality 1520 setting. The default quality setting of 75 results in a rate value of 1521 0.06641. 1522 </dd> 1523 <dt>jpeg:block-smoothing={true|false}</dt> 1524 <dd>Enables or disables block smoothing when reading a JPEG file 1525 (default enabled). 1526 </dd> 1527 <dt>jpeg:dct-method=<value></dt> 1528 <dd>Selects the IJG JPEG library DCT implementation to use. The 1529 encoding implementations vary in speed and encoding error. The 1530 available choices for <strong>value</strong> are <strong>islow</strong>, <strong>ifast</strong>, 1531 <strong>float</strong>, <strong>default</strong> and <strong>fastest</strong>. Note that 1532 <strong>fastest</strong> might not necessarily be fastest on your CPU, depending 1533 on the choices made when the JPEG library was built and how your CPU 1534 behaves. 1535 </dd> 1536 <dt>jpeg:fancy-upsampling={true|false}</dt> 1537 <dd>Enables or disables fancy upsampling when reading a JPEG file 1538 (default enabled). 1539 </dd> 1540 <dt>jpeg:max-scan-number=<value></dt> 1541 <dd>Specifies an integer value for the maximum number of progressive 1542 scans allowed in a JPEG file. The default maximum is 100 scans. This 1543 limit is imposed due to a weakness in the JPEG standard which allows 1544 small JPEG files to take many minutes or hours to be read. 1545 </dd> 1546 <dt>jpeg:max-warnings=<value></dt> 1547 <dd>Specifies an integer value for how many warnings are allowed for 1548 any given error type before being promoted to a hard error. JPEG 1549 files producing excessive warnings indicate a problem with the file. 1550 </dd> 1551 <dt>jpeg:optimize-coding={true|false}</dt> 1552 <dd>Selects if huffman encoding should be used. Huffman encoding is enabled 1553 by default, but may be disabled for very large images since it encoding 1554 requires that the entire image be buffered in memory. Huffman encoding 1555 produces smaller JPEG files at the expense of added compression time and 1556 memory consumption. 1557 </dd> 1558 <dt>jpeg:preserve-settings</dt> 1559 <dd>If the jpeg:preserve-settings flag is defined, the JPEG encoder will 1560 use the same "quality" and "sampling-factor" settings that were found 1561 in the input file, if the input was in JPEG format. These settings are 1562 also preserved if the input is a JPEG file and the output is a JNG 1563 file. If the colorspace of the output file differs from that of the 1564 input file, the quality setting is preserved but the sampling-factors 1565 are not. 1566 </dd> 1567 <dt>pcl:fit-to-page</dt> 1568 <dd>If the pcl:fit-to-page flag is defined, then the printer is 1569 requested to scale the image to fit the page size (width and/or 1570 height).</dd> 1571 <dt>mng:maximum-loops=<value></dt> 1572 <dd>mng:maximum-loops specifies the maximum number of loops allowed to 1573 be specified by a MNG LOOP chunk. Without an imposed limit, a MNG file 1574 could request up to 2147483647 loops, which could run for a very long 1575 time. The current default limit is 512 loops. 1576 </dd> 1577 <dt>pdf:use-cropbox={true|false}</dt> 1578 <dd>If the pdf:use-cropbox flag is set to <strong>true</strong>, then 1579 Ghostscript is requested to apply the PDF crop box. 1580 </dd> 1581 <dt>pdf:stop-on-error={true|false}</dt> 1582 <dd>If the pdf:stop-on-error flag is set to <strong>true</strong>, then 1583 Ghostscript is requested to stop processing the PDF when the first 1584 error is encountered. Otherwise it will attempt to process all 1585 requested pages. 1586 </dd> 1587 <dt>ps:imagemask</dt> 1588 <dd>If the ps:imagemask flag is defined, the PS3 and EPS3 coders will 1589 create Postscript files that render bilevel images with the Postscript 1590 imagemask operator instead of the image operator. 1591 </dd> 1592 <dt>ptif:minimum-geometry=<geometry></dt> 1593 <dd>If the ptif:minimum-geometry key is defined, GraphicsMagick will 1594 use it to determine the minimum frame size to output when writing a 1595 pyramid TIFF file (a TIFF file containing a succession of reduced 1596 versions of the first frame). The default minimum geometry is 32x32. 1597 </dd> 1598 <dt>tiff:alpha={unspecified|associated|unassociated}</dt> 1599 <dd>Specify the TIFF alpha channel type when reading or writing TIFF files, 1600 overriding the normal value. The default alpha channel type for new files 1601 is unspecified alpha. Existing alpha settings are preserved when 1602 converting from one TIFF file to another. When a TIFF file uses 1603 associated alpha, the image pixels are pre-multiplied (i.e. altered) with 1604 the alpha channel. Files with "associated" alpha appear as if they were 1605 alpha composited on a black background when the matte channel is 1606 disabled. If the unassociated alpha type is selected, then the alpha 1607 channel is saved without altering the pixels. Photoshop recognizes 1608 associated alpha as transparency information, if the file is saved with 1609 unassociated alpha, the alpha information is loaded as an independent 1610 channel. Note that for many years, ImageMagick and GraphicsMagick marked 1611 TIFF files as using associated alpha, without properly pre-multiplying 1612 the pixels. 1613 </dd> 1614 <dt>tiff:fill-order={msb2lsb|lsb2msb}</dt> 1615 <dd>If the tiff:fill-order key is defined, GraphicsMagick will use it to 1616 determine the bit fill order used while writing TIFF files. The normal default 1617 is "msb2lsb", which matches the native bit order of all modern CPUs. The 1618 only exception to this is when Group3 or Group4 FAX compression is 1619 requested since FAX machines send data in bit-reversed order and 1620 therefore RFC 2301 recommends using reverse order. 1621 </dd> 1622 <dt>tiff:group-three-options=<value></dt> 1623 <dd>If the tiff:group-three-options key is defined, GraphicsMagick 1624 will use it to set the group3 options tag when writing 1625 group3-compressed TIFF. Please see the TIFF specification for the 1626 usage of this tag. The default value is 4. 1627 </dd> 1628 <dt>tiff:ignore-tags=<tags></dt> 1629 <dd>If the tiff:ignore-tags key is defined, then it is used as a list 1630 of comma-delimited integer TIFF tag values to ignore while reading the 1631 TIFF file. This is useful in order to be able to read files which 1632 which otherwise fail to read due to problems with TIFF tags. Note 1633 that some TIFF tags are required in order to be able to read the image 1634 data at all. 1635 </dd> 1636 <dt>tiff:report-warnings={false|true}</dt> 1637 <dd>If the tiff:report-warnings key is defined and set to <strong>true</strong>, 1638 then TIFF warnings are reported as a warning exception rather than as 1639 a coder log message. Such warnings are reported after the image has 1640 been read or written. Most TIFF warnings are benign but sometimes 1641 they may help deduce problems with the TIFF file, or help detect that 1642 the TIFF file requires a special application to read successfully due 1643 to the use of proprietary or specialized extensions. 1644 </dd> 1645 <dt>tiff:sample-format={unsigned|ieeefp}</dt> 1646 <dd>If the tiff:sample-format key is defined, GraphicsMagick will use it to 1647 determine the sample format used while writing TIFF files. The default is 1648 "unsigned". Specify "ieeefp" in order to write floating-point TIFF 1649 files with float (32-bit) or double (64-bit) values. Use the 1650 tiff:bits-per-sample define to determine the type of floating-point value 1651 to use. 1652 </dd> 1653 <dt>tiff:max-sample-value=<value></dt> 1654 <dd>If the tiff:max-sample-value key is defined, GraphicsMagick will use the 1655 assigned value as the maximum floating point value while reading or 1656 writing IEEE floating point TIFFs. Otherwise the maximum value is 1.0 or 1657 the value obtained from the file's SMaxSampleValue tag (if present). The 1658 floating point data is currently not scanned in advance to determine a 1659 best maximum sample value so if the range is not 1.0, or the 1660 SMaxSampleValue tag is not present, it may be necessary to 1661 (intelligently) use this parameter to properly read a file. 1662 </dd> 1663 <dt>tiff:min-sample-value=<value></dt> 1664 <dd>If the tiff:min-sample-value key is defined, GraphicsMagick will use 1665 the assigned value as the minimum floating point value while reading or 1666 writing IEEE floating point TIFFs. Otherwise the minimum value is 0.0 or 1667 the value obtained from the file's SMinSampleValue tag (if present). 1668 </dd> 1669 <dt>tiff:bits-per-sample=<value></dt> 1670 <dd>If the tiff:bits-per-sample key is defined, GraphicsMagick will write 1671 images with the specified bits per sample, overriding any existing depth 1672 value. Value may be any in the range of 1 to 32, or 64 when the default 1673 'unsigned' format is written, or 16/32/24/64 if IEEEFP format is written. 1674 Please note that the baseline TIFF 6.0 specification only requires 1675 readers to handle certain powers of two, and the values to be handled 1676 depend on the nature of the image (e.g. colormapped, grayscale, RGB, CMYK). 1677 </dd> 1678 <dt>tiff:samples-per-pixel=<value></dt> 1679 <dd>If the tiff:samples-per-pixel key is defined to a value, the TIFF coder 1680 will write TIFF images with the defined samples per pixel, overriding any 1681 value stored in the image. This option should not normally be used. 1682 </dd> 1683 <dt>tiff:rows-per-strip=<value></dt> 1684 <dd>Allows the user to specify the number of rows per TIFF strip. 1685 Rounded up to a multiple of 16 when using JPEG compression. Ignored when 1686 using tiles. 1687 </dd> 1688 <dt>tiff:strip-per-page=true</dt> 1689 <dd>Requests that the image is written in a single TIFF strip. This is 1690 normally the default when group3 or group4 compression is requested 1691 within reasonable limits. Requesting a single strip for large images may 1692 result in failure due to resource consumption in the writer or reader. 1693 </dd> 1694 <dt>tiff:tile</dt> 1695 <dd>Enable writing tiled TIFF (rather than stripped) using the default tile 1696 size. Tiled TIFF organizes the image as an array of smaller images 1697 (tiles) in order to enable random access. 1698 </dd> 1699 <dt>tiff:tile-geometry=<width>x<height></dt> 1700 <dd>Specify the tile size to use while writing tiled TIFF. Width and 1701 height should be a multiple of 16. If the value is not a multiple of 16, 1702 then it will be rounded down. Enables tiled TIFF if it has not already 1703 been enabled. GraphicsMagick does not use tiled storage internally so 1704 tiles need to be converted back and forth from the internal 1705 scanline-oriented storage to tile-oriented storage. Testing with typical 1706 RGB images shows that useful square tile size values range from 128x128 1707 to 1024x1024. Large images which require using a disk-based pixel cache 1708 benefit from large tile sizes while images which fit in memory work well 1709 with smaller tile sizes. 1710 </dd> 1711 <dt>tiff:tile-width=<width></dt> 1712 <dd>Specify the tile width to use while writing tiled TIFF. The tile height 1713 is then defaulted to an appropriate size. Width should be a multiple of 1714 16. If the value is not a multiple of 16, then it will be rounded down. 1715 Enables tiled TIFF if it has not already been enabled. 1716 </dd> 1717 <dt>tiff:tile-height=<height></dt> 1718 <dd>Specify the tile height to use while writing tiled TIFF. The tile width 1719 is then defaulted to an appropriate size. Height should be a multiple of 1720 16. If the value is not a multiple of 16, then it will be rounded down. 1721 Enables tiled TIFF if it has not already been enabled. 1722 </dd> 1723 <dt>tiff:webp-lossless={TRUE|FALSE}</dt> 1724 <dd>Specify a value of <strong>TRUE</strong> to enable lossless mode while 1725 writing WebP-compressed TIFF files. The WebP <strong>webp:lossless</strong> 1726 option may also be used. The quality factor set by the 1727 <strong>-quality</strong> option may be used to influence the level of effort 1728 expended while compressing. 1729 </dd> 1730 <dt>tiff:zstd-compress-level=<value></dt> 1731 <dd>Specify the compression level to use while writing Zstd-compressed 1732 TIFF files. The valid range is 1 to 22. If this define is not 1733 specified, then the 'quality' value is used such that the default 1734 quality setting of 75 is translated to a compress level of 9 such that 1735 'quality' has a useful range of 10-184 if used for this purpose. 1736 </dd> 1737 <dt>webp:lossless={true|false}</dt> 1738 <dd>Enable lossless encoding. 1739 </dd> 1740 <dt>webp:method={0-6}</dt> 1741 <dd>Quality/speed trade-off. 1742 </dd> 1743 <dt>webp:image-hint={default,graph,photo,picture}</dt> 1744 <dd>Hint for image type. 1745 </dd> 1746 <dt>webp:target-size=<integer></dt> 1747 <dd>Target size in bytes. 1748 </dd> 1749 <dt>webp:target-psnr=<float></dt> 1750 <dd>Minimal distortion to try to achieve. 1751 </dd> 1752 <dt>webp:segments={1-4}</dt> 1753 <dd>Maximum number of segments to use. 1754 </dd> 1755 <dt>webp:sns-strength={0-100}</dt> 1756 <dd>Spatial Noise Shaping. 1757 </dd> 1758 <dt>webp:filter-strength={0-100}</dt> 1759 <dd>Filter strength. 1760 </dd> 1761 <dt>webp:filter-sharpness={0-7}</dt> 1762 <dd>Filter sharpness. 1763 </dd> 1764 <dt>webp:filter-type={0,1}</dt> 1765 <dd>Filtering type. 0 = simple, 1 = strong (only used if 1766 filter-strength > 0 or autofilter is enabled). 1767 </dd> 1768 <dt>webp:auto-filter={true|false}</dt> 1769 <dd>Auto adjust filter's strength. 1770 </dd> 1771 <dt>webp:alpha-compression=<integer></dt> 1772 <dd>Algorithm for encoding the alpha plane (0 = none, 1 = compressed 1773 with WebP lossless). Default is 1. 1774 </dd> 1775 <dt>webp:alpha-filtering=<integer></dt> 1776 <dd>Predictive filtering method for alpha plane. 0: none, 1: fast, 2: 1777 best. Default is 1. 1778 </dd> 1779 <dt>webp:alpha-quality={0-100}</dt> 1780 <dd>Between 0 (smallest size) and 100 (lossless). Default is 100. 1781 </dd> 1782 <dt>webp:pass=[1..10]</dt> 1783 <dd>Number of entropy-analysis passes. 1784 </dd> 1785 <dt>webp:show-compressed={true|false}</dt> 1786 <dd>Export the compressed picture back. In-loop filtering is not 1787 applied. 1788 </dd> 1789 <dt>webp:preprocessing=[0,1,2]</dt> 1790 <dd>0=none, 1=segment-smooth, 2=pseudo-random dithering 1791 </dd> 1792 <dt>webp:partitions=[0-3]</dt> 1793 <dd>log2(number of token partitions) in [0..3]. Default is 0 for 1794 easier progressive decoding. 1795 </dd> 1796 <dt>webp:partition-limit={0-100}</dt> 1797 <dd>Quality degradation allowed to fit the 512k limit on prediction 1798 modes coding (0: no degradation, 100: maximum possible 1799 degradation). 1800 </dd> 1801 <dt>webp:emulate-jpeg-size={true|false}</dt> 1802 <dd>If true, compression parameters will be remapped to better match 1803 the expected output size from JPEG compression. Generally, the output 1804 size will be similar but the degradation will be lower. 1805 </dd> 1806 <dt>webp:thread-level=<integer></dt> 1807 <dd>If non-zero, try and use multi-threaded encoding. 1808 </dd> 1809 <dt>webp:low-memory={true|false}</dt> 1810 <dd>If set, reduce memory usage (but increase CPU use) 1811 </dd> 1812 <dt>webp:use-sharp-yuv={true|false}</dt> 1813 <dd>If set, if needed, use sharp (and slow) RGB->YUV conversion 1814 </dd> 1815 </dl> 1816 </font></td></tr></table> 1817 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1818 For example, to create a postscript file that will render only the black 1819 pixels of a bilevel image, use:</font></td></tr></table> 1820 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 1821 gm convert bilevel.tif -define ps:imagemask eps3:stencil.ps 1822 </pre></font></td></tr></table> 1823 <table BORDER=0 WIDTH="94%"> 1824 <tr> 1825 <td width="3%"><br></td> 1826 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1827 <img SRC="images/right_triangle_option.png" 1828 ALT=">" BORDER=0 height=14 1829 width=15><b><font face="Helvetica, Arial" 1830 ><font color="#00B04F"><font size="+1"> 1831 <a name="details-delay"></a>-delay <i><1/100ths of a second></i> 1832 </font></font></font></b></td></tr></table> 1833 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the next image after pausing</td></tr></table> 1834 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1835 This option is useful for regulating the animation of image sequences 1836 <em>Delay/100</em> seconds must expire before the display 1837 of the next image. The default is no delay between each showing of the 1838 image sequence. The maximum delay is 65535.</font></td></tr></table> 1839 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1840 You can specify a delay range (e.g. <em>-delay 10-500</em>) which sets the 1841 minimum and maximum delay.</font></td></tr></table> 1842 <table BORDER=0 WIDTH="94%"> 1843 <tr> 1844 <td width="3%"><br></td> 1845 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1846 <img SRC="images/right_triangle_option.png" 1847 ALT=">" BORDER=0 height=14 1848 width=15><b><font face="Helvetica, Arial" 1849 ><font color="#00B04F"><font size="+1"> 1850 <a name="details-density"></a>-density <i><width>x<height></i> 1851 </font></font></font></b></td></tr></table> 1852 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table> 1853 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">This option specifies the image resolution to store while encoding a 1854 raster image or the canvas resolution while rendering (reading) vector 1855 formats such as Postscript, PDF, WMF, and SVG into a raster image. Image 1856 resolution provides the unit of measure to apply when rendering to an 1857 output device or raster image. The default unit of measure is in dots 1858 per inch (DPI). The <strong>-units</strong> option may be used to select dots per 1859 centimeter instead.</font></td></tr></table> 1860 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> The default resolution is 72 dots per inch, which is equivalent to 1861 one point per pixel (Macintosh and Postscript standard). Computer 1862 screens are normally 72 or 96 dots per inch while printers typically 1863 support 150, 300, 600, or 1200 dots per inch. To determine the 1864 resolution of your display, use a ruler to measure the width of your 1865 screen in inches, and divide by the number of horizontal pixels (1024 on 1866 a 1024x768 display).</font></td></tr></table> 1867 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">If the file format supports it, this option may be used to update 1868 the stored image resolution. Note that Photoshop stores and obtains 1869 image resolution from a proprietary embedded profile. If this profile is 1870 not stripped from the image, then Photoshop will continue to treat the 1871 image using its former resolution, ignoring the image resolution 1872 specified in the standard file header.</font></td></tr></table> 1873 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">The density option is an attribute and does not alter the underlying 1874 raster image. It may be used to adjust the rendered size for desktop 1875 publishing purposes by adjusting the scale applied to the pixels. To 1876 resize the image so that it is the same size at a different resolution, 1877 use the <strong>-resample</strong> option.</font></td></tr></table> 1878 <table BORDER=0 WIDTH="94%"> 1879 <tr> 1880 <td width="3%"><br></td> 1881 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1882 <img SRC="images/right_triangle_option.png" 1883 ALT=">" BORDER=0 height=14 1884 width=15><b><font face="Helvetica, Arial" 1885 ><font color="#00B04F"><font size="+1"> 1886 <a name="details-depth"></a>-depth <i><value></i> 1887 </font></font></font></b></td></tr></table> 1888 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table> 1889 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1890 This is the number of bits of color to preserve in the image. Any value 1891 between 1 and <strong>QuantumDepth</strong> (build option) may be specified, 1892 although 8 or 16 are the most common values. Use this option to specify 1893 the depth of raw images whose depth is unknown such as GRAY, RGB, or 1894 CMYK, or to change the depth of any image after it has been read.</font></td></tr></table> 1895 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">The depth option is applied to the pixels immediately so it may be 1896 used as a form of simple compression by discarding the least significant 1897 bits. Reducing the depth in advance may speed up color quantization, and 1898 help create smaller file sizes when using a compression algorithm like 1899 LZW or ZIP.</font></td></tr></table> 1900 <table BORDER=0 WIDTH="94%"> 1901 <tr> 1902 <td width="3%"><br></td> 1903 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1904 <img SRC="images/right_triangle_option.png" 1905 ALT=">" BORDER=0 height=14 1906 width=15><b><font face="Helvetica, Arial" 1907 ><font color="#00B04F"><font size="+1"> 1908 -descend 1909 </font></font></font></b></td></tr></table> 1910 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>obtain image by descending window hierarchy</td></tr></table> 1911 <table BORDER=0 WIDTH="94%"> 1912 <tr> 1913 <td width="3%"><br></td> 1914 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1915 <img SRC="images/right_triangle_option.png" 1916 ALT=">" BORDER=0 height=14 1917 width=15><b><font face="Helvetica, Arial" 1918 ><font color="#00B04F"><font size="+1"> 1919 -despeckle 1920 </font></font></font></b></td></tr></table> 1921 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>reduce the speckles within an image</td></tr></table> 1922 <table BORDER=0 WIDTH="94%"> 1923 <tr> 1924 <td width="3%"><br></td> 1925 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1926 <img SRC="images/right_triangle_option.png" 1927 ALT=">" BORDER=0 height=14 1928 width=15><b><font face="Helvetica, Arial" 1929 ><font color="#00B04F"><font size="+1"> 1930 <a name="details-displace"></a>-displace <i><horizontal scale>x<vertical scale></i> 1931 </font></font></font></b></td></tr></table> 1932 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shift image pixels as defined by a displacement map</td></tr></table> 1933 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1934 With this option, <em>composite image</em> is used as a displacement map. Black, 1935 within the displacement map, is a maximum positive displacement. White is a 1936 maximum negative displacement and middle gray is neutral. The displacement 1937 is scaled to determine the pixel shift. By default, the displacement applies 1938 in both the horizontal and vertical directions. However, if you specify 1939 <em>mask</em>, <em>composite image</em> is the horizontal X displacement and 1940 <em>mask</em> the vertical Y displacement.</font></td></tr></table> 1941 <table BORDER=0 WIDTH="94%"> 1942 <tr> 1943 <td width="3%"><br></td> 1944 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1945 <img SRC="images/right_triangle_option.png" 1946 ALT=">" BORDER=0 height=14 1947 width=15><b><font face="Helvetica, Arial" 1948 ><font color="#00B04F"><font size="+1"> 1949 <a name="details-display"></a>-display <i><host:display[.screen]></i> 1950 </font></font></font></b></td></tr></table> 1951 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table> 1952 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1953 This option is used with convert for 1954 obtaining image or font from this X server. See <em>X(1)</em>.</font></td></tr></table> 1955 <table BORDER=0 WIDTH="94%"> 1956 <tr> 1957 <td width="3%"><br></td> 1958 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1959 <img SRC="images/right_triangle_option.png" 1960 ALT=">" BORDER=0 height=14 1961 width=15><b><font face="Helvetica, Arial" 1962 ><font color="#00B04F"><font size="+1"> 1963 <a name="details-dispose"></a>-dispose <i><method></i> 1964 </font></font></font></b></td></tr></table> 1965 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table> 1966 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1967 The Disposal Method indicates the way in which the graphic is to 1968 be treated after being displayed.</font></td></tr></table> 1969 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1970 Here are the valid methods:</font></td></tr></table> 1971 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 1972 Undefined No disposal specified. 1973 None Do not dispose between frames. 1974 Background Overwrite the image area with 1975 the background color. 1976 Previous Overwrite the image area with 1977 what was there prior to rendering 1978 the image. 1979 </pre></font></td></tr></table> 1980 <table BORDER=0 WIDTH="94%"> 1981 <tr> 1982 <td width="3%"><br></td> 1983 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1984 <img SRC="images/right_triangle_option.png" 1985 ALT=">" BORDER=0 height=14 1986 width=15><b><font face="Helvetica, Arial" 1987 ><font color="#00B04F"><font size="+1"> 1988 <a name="details-dissolve"></a>-dissolve <i><percent></i> 1989 </font></font></font></b></td></tr></table> 1990 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>dissolve an image into another by the given percent</td></tr></table> 1991 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1992 The opacity of the composite image is multiplied by the given percent, 1993 then it is composited over the main image.</font></td></tr></table> 1994 <table BORDER=0 WIDTH="94%"> 1995 <tr> 1996 <td width="3%"><br></td> 1997 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1998 <img SRC="images/right_triangle_option.png" 1999 ALT=">" BORDER=0 height=14 2000 width=15><b><font face="Helvetica, Arial" 2001 ><font color="#00B04F"><font size="+1"> 2002 <a name="details-dither"></a>-dither 2003 </font></font></font></b></td></tr></table> 2004 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table> 2005 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2006 The basic strategy of dithering is to trade intensity resolution for spatial 2007 resolution by averaging the intensities of several neighboring pixels. 2008 Images which suffer from severe contouring when reducing colors can be 2009 improved with this option.</font></td></tr></table> 2010 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2011 The <strong>-colors</strong> or <strong>-monochrome</strong> option is required for this option 2012 to take effect.</font></td></tr></table> 2013 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2014 Use <strong>+dither</strong> to turn off dithering and to render PostScript 2015 without text or graphic aliasing. Disabling dithering often (but not 2016 always) leads to decreased processing time.</font></td></tr></table> 2017 <table BORDER=0 WIDTH="94%"> 2018 <tr> 2019 <td width="3%"><br></td> 2020 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2021 <img SRC="images/right_triangle_option.png" 2022 ALT=">" BORDER=0 height=14 2023 width=15><b><font face="Helvetica, Arial" 2024 ><font color="#00B04F"><font size="+1"> 2025 <a name="details-draw"></a>-draw <i><string></i> 2026 </font></font></font></b></td></tr></table> 2027 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with one or more graphic primitives</td></tr></table> 2028 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2029 Use this option to annotate an image with one or more graphic primitives. 2030 The primitives include shapes, text, transformations, 2031 and pixel operations. The shape primitives are</font></td></tr></table> 2032 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2033 point x,y 2034 line x0,y0 x1,y1 2035 rectangle x0,y0 x1,y1 2036 roundRectangle x0,y0 x1,y1 wc,hc 2037 arc x0,y0 x1,y1 a0,a1 2038 ellipse x0,y0 rx,ry a0,a1 2039 circle x0,y0 x1,y1 2040 polyline x0,y0 ... xn,yn 2041 polygon x0,y0 ... xn,yn 2042 Bezier x0,y0 ... xn,yn 2043 path path specification 2044 image operator x0,y0 w,h filename 2045 </pre></font></td></tr></table> 2046 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2047 The text primitive is</font></td></tr></table> 2048 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2049 text x0,y0 string 2050 </pre></font></td></tr></table> 2051 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2052 The text gravity primitive is</font></td></tr></table> 2053 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2054 gravity NorthWest, North, NorthEast, West, Center, 2055 East, SouthWest, South, or SouthEast 2056 </pre></font></td></tr></table> 2057 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2058 The text gravity primitive only affects the placement of text and 2059 does not interact with the other primitives. It is equivalent to 2060 using the <strong>-gravity</strong> commandline option, except that it is 2061 limited in scope to the <strong>-draw</strong> option in which it appears.</font></td></tr></table> 2062 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2063 The transformation primitives are</font></td></tr></table> 2064 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2065 rotate degrees 2066 translate dx,dy 2067 scale sx,sy 2068 skewX degrees 2069 skewY degrees 2070 </pre></font></td></tr></table> 2071 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2072 The pixel operation primitives are</font></td></tr></table> 2073 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2074 color x0,y0 method 2075 matte x0,y0 method 2076 </pre></font></td></tr></table> 2077 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2078 The shape primitives are drawn in the color specified in the preceding 2079 <strong>-stroke</strong> option. Except for the <strong>line</strong> and <strong>point</strong> 2080 primitives, they are filled with the color specified in the preceding 2081 <strong>-fill</strong> option. For unfilled shapes, use <tt>-fill none</tt></font></td></tr></table>. 2082 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2083 <strong>Point</strong> requires a single coordinate.</font></td></tr></table> 2084 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2085 <strong>Line</strong> requires a start and end coordinate.</font></td></tr></table> 2086 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2087 <strong>Rectangle</strong> 2088 expects an upper left and lower right coordinate.</font></td></tr></table> 2089 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2090 <strong>RoundRectangle</strong> has the upper left and lower right coordinates 2091 and the width and height of the corners.</font></td></tr></table> 2092 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2093 <strong>Circle</strong> has a center coordinate and a coordinate for 2094 the outer edge.</font></td></tr></table> 2095 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2096 Use <strong>Arc</strong> to inscribe an elliptical arc within 2097 a rectangle. Arcs require a start and end point as well as the degree 2098 of rotation (e.g. 130,30 200,100 45,90).</font></td></tr></table> 2099 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2100 Use <strong>Ellipse</strong> to draw a partial ellipse 2101 centered at the given point with the x-axis and y-axis radius 2102 and start and end of arc in degrees (e.g. 100,100 100,150 0,360).</font></td></tr></table> 2103 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2104 Finally, <strong>polyline</strong> and <strong>polygon</strong> require 2105 three or more coordinates to define its boundaries. 2106 Coordinates are integers separated by an optional comma. For example, 2107 to define a circle centered at 100,100 2108 that extends to 150,150 use:</font></td></tr></table> 2109 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2110 -draw 'circle 100,100 150,150' 2111 </pre></font></td></tr></table> 2112 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2113 <strong>Paths</strong> 2114 (See <a href="http://www.w3.org/TR/SVG/paths.html">Paths</a>) 2115 represent an outline of an object which is defined in terms of 2116 moveto (set a new current point), lineto (draw a straight line), 2117 curveto (draw a curve using a cubic Bezier), arc (elliptical or 2118 circular arc) and closepath (close the current shape by drawing a line 2119 to the last moveto) elements. Compound paths (i.e., a path with 2120 subpaths, each consisting of a single moveto followed by one or more 2121 line or curve operations) are possible to allow effects such as 2122 "donut holes" in objects.</font></td></tr></table> 2123 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2124 Use <strong>image</strong> to composite an image with another image. Follow the 2125 image keyword with the composite operator, image location, image size, 2126 and filename:</font></td></tr></table> 2127 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2128 -draw 'image Over 100,100 225,225 image.jpg' 2129 </pre></font></td></tr></table> 2130 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2131 You can use 0,0 for the image size, which means to use the actual 2132 dimensions found in the image header. Otherwise, it will 2133 be scaled to the given dimensions. 2134 See <strong>-compose</strong> for a description of the composite operators.</font></td></tr></table> 2135 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2136 Use <strong>text</strong> to annotate an image with text. Follow the text 2137 coordinates with a string. If the string has embedded spaces, enclose it 2138 in single or double quotes. Optionally you can include the image 2139 filename, type, width, height, or other image attribute by embedding 2140 special format character. See <strong>-comment</strong> for details.</font></td></tr></table> 2141 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2142 For example, 2143 </font></td></tr></table> 2144 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2145 -draw 'text 100,100 "%m:%f %wx%h"' 2146 </pre></font></td></tr></table> 2147 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2148 annotates the image with <tt>MIFF:bird.miff 512x480</tt> for an image titled 2149 <tt>bird.miff</tt> 2150 and whose width is 512 and height is 480.</font></td></tr></table> 2151 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2152 If the first character of <em>string</em> is <em>@</em>, the text is read 2153 from a file titled by the remaining characters in the string. Please 2154 note that if the string comes from an untrusted source that it should 2155 be sanitized before use (a security risk).</font></td></tr></table> 2156 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2157 <strong>Rotate</strong> rotates subsequent shape primitives and text primitives about 2158 the origin of the main image. If the <strong>-region</strong> option precedes the 2159 <strong>-draw</strong> option, the origin for transformations is the upper left 2160 corner of the region.</font></td></tr></table> 2161 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2162 <strong>Translate</strong> translates them.</font></td></tr></table> 2163 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2164 <strong>Scale</strong> scales them.</font></td></tr></table> 2165 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2166 <strong>SkewX</strong> and <strong>SkewY</strong> skew them with respect to the origin of 2167 the main image or the region.</font></td></tr></table> 2168 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2169 The transformations modify the current affine matrix, which is initialized 2170 from the initial affine matrix defined by the <strong>-affine</strong> option. 2171 Transformations are cumulative within the <strong>-draw</strong> option. 2172 The initial affine matrix is not affected; that matrix is only changed by the 2173 appearance of another <strong>-affine</strong> option. If another <strong>-draw</strong> 2174 option appears, the current affine matrix is reinitialized from 2175 the initial affine matrix.</font></td></tr></table> 2176 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2177 Use <strong>color</strong> to change the color of a pixel to the fill color (see 2178 <strong>-fill</strong>). Follow the pixel coordinate 2179 with a method:</font></td></tr></table> 2180 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2181 point 2182 replace 2183 floodfill 2184 filltoborder 2185 reset 2186 </pre></font></td></tr></table> 2187 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2188 Consider the target pixel as that specified by your coordinate. The 2189 <strong>point</strong> 2190 method recolors the target pixel. The <strong>replace</strong> method recolors any 2191 pixel that matches the color of the target pixel. 2192 <strong>Floodfill</strong> recolors 2193 any pixel that matches the color of the target pixel and is a neighbor, 2194 whereas <strong>filltoborder</strong> recolors any neighbor pixel that is not the 2195 border color. Finally, <strong>reset</strong> recolors all pixels.</font></td></tr></table> 2196 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2197 Use <strong>matte</strong> to the change the pixel matte value to transparent. Follow 2198 the pixel coordinate with a method (see the <strong>color</strong> primitive for 2199 a description of methods). The <strong>point</strong> method changes the matte value 2200 of the target pixel. The <strong>replace</strong> method changes the matte value 2201 of any pixel that matches the color of the target pixel. <strong>Floodfill</strong> 2202 changes the matte value of any pixel that matches the color of the target 2203 pixel and is a neighbor, whereas 2204 <strong>filltoborder</strong> changes the matte 2205 value of any neighbor pixel that is not the border color (<strong>-bordercolor</strong>). 2206 Finally <strong>reset</strong> changes the matte value of all pixels.</font></td></tr></table> 2207 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2208 You can set the primitive color, font, and font bounding box 2209 color with 2210 <strong>-fill</strong>, <strong>-font</strong>, and <strong>-box</strong> respectively. Options 2211 are processed in command line order so be sure to use these 2212 options <em>before</em> the <strong>-draw</strong> option.</font></td></tr></table> 2213 <table BORDER=0 WIDTH="94%"> 2214 <tr> 2215 <td width="3%"><br></td> 2216 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2217 <img SRC="images/right_triangle_option.png" 2218 ALT=">" BORDER=0 height=14 2219 width=15><b><font face="Helvetica, Arial" 2220 ><font color="#00B04F"><font size="+1"> 2221 -edge <i><radius></i> 2222 </font></font></font></b></td></tr></table> 2223 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>detect edges within an image</td></tr></table> 2224 <table BORDER=0 WIDTH="94%"> 2225 <tr> 2226 <td width="3%"><br></td> 2227 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2228 <img SRC="images/right_triangle_option.png" 2229 ALT=">" BORDER=0 height=14 2230 width=15><b><font face="Helvetica, Arial" 2231 ><font color="#00B04F"><font size="+1"> 2232 -emboss <i><radius></i> 2233 </font></font></font></b></td></tr></table> 2234 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>emboss an image</td></tr></table> 2235 <table BORDER=0 WIDTH="94%"> 2236 <tr> 2237 <td width="3%"><br></td> 2238 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2239 <img SRC="images/right_triangle_option.png" 2240 ALT=">" BORDER=0 height=14 2241 width=15><b><font face="Helvetica, Arial" 2242 ><font color="#00B04F"><font size="+1"> 2243 <a name="details-encoding"></a>-encoding <i><type></i> 2244 </font></font></font></b></td></tr></table> 2245 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the text encoding</td></tr></table> 2246 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2247 Choose from <em>AdobeCustom, AdobeExpert, AdobeStandard, AppleRoman, 2248 BIG5, GB2312, Latin 2, None, SJIScode, Symbol, Unicode, Wansung.</em></font></td></tr></table> 2249 <table BORDER=0 WIDTH="94%"> 2250 <tr> 2251 <td width="3%"><br></td> 2252 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2253 <img SRC="images/right_triangle_option.png" 2254 ALT=">" BORDER=0 height=14 2255 width=15><b><font face="Helvetica, Arial" 2256 ><font color="#00B04F"><font size="+1"> 2257 <a name="details-endian"></a>-endian <i><type></i> 2258 </font></font></font></b></td></tr></table> 2259 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify endianness (MSB, LSB, or Native) of image</td></tr></table> 2260 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2261 <em>MSB</em> indicates big-endian (e.g. SPARC, Motorola 68K) while 2262 <em>LSB</em> indicates little-endian (e.g. Intel 'x86, VAX) byte 2263 ordering. <em>Native</em> indicates to use the normal ordering for the 2264 current CPU. This option currently only influences the CMYK, DPX, 2265 GRAY, RGB, and TIFF, formats.</font></td></tr></table> 2266 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2267 Use <strong>+endian</strong> to revert to unspecified endianness.</font></td></tr></table> 2268 <table BORDER=0 WIDTH="94%"> 2269 <tr> 2270 <td width="3%"><br></td> 2271 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2272 <img SRC="images/right_triangle_option.png" 2273 ALT=">" BORDER=0 height=14 2274 width=15><b><font face="Helvetica, Arial" 2275 ><font color="#00B04F"><font size="+1"> 2276 -enhance 2277 </font></font></font></b></td></tr></table> 2278 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a digital filter to enhance a noisy image</td></tr></table> 2279 <table BORDER=0 WIDTH="94%"> 2280 <tr> 2281 <td width="3%"><br></td> 2282 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2283 <img SRC="images/right_triangle_option.png" 2284 ALT=">" BORDER=0 height=14 2285 width=15><b><font face="Helvetica, Arial" 2286 ><font color="#00B04F"><font size="+1"> 2287 -equalize 2288 </font></font></font></b></td></tr></table> 2289 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform histogram equalization to the image</td></tr></table> 2290 <table BORDER=0 WIDTH="94%"> 2291 <tr> 2292 <td width="3%"><br></td> 2293 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2294 <img SRC="images/right_triangle_option.png" 2295 ALT=">" BORDER=0 height=14 2296 width=15><b><font face="Helvetica, Arial" 2297 ><font color="#00B04F"><font size="+1"> 2298 <a name="details-extent"></a>-extent <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i> 2299 </font></font></font></b></td></tr></table> 2300 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>composite image on background color canvas image</td></tr></table> 2301 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2302 This option composites the image on a new background color 2303 (<strong>-background</strong>) canvas image of size <width>x<height>. The 2304 existing image content is composited at the position specified by 2305 geometry x and y offset and/or desired gravity (<strong>-gravity</strong>) using 2306 the current image compose (<strong>-compose</strong>) method. Image content 2307 which falls outside the bounds of the new image dimensions is 2308 discarded.</font></td></tr></table> 2309 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2310 For example, this command creates a thumbnail of an image, and centers 2311 it on a red color backdrop image, offsetting the canvas ten pixels to 2312 the left and five pixels up, with respect to the thumbnail:</font></td></tr></table> 2313 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2314 gm convert infile.jpg -thumbnail 120x80 -background red -gravity center \ 2315 -extent 140x100-10-5 outfile.jpg 2316 </pre></font></td></tr></table> 2317 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2318 This command reduces or expands a JPEG image to fit on an 800x600 2319 display: </font></td></tr></table> 2320 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2321 gm convert -size 800x600 input.jpg \ 2322 -resize 800x600 -background black \ 2323 -compose Copy -gravity center \ 2324 -extent 800x600 \ 2325 -quality 92 output.jpg 2326 </pre></font></td></tr></table> 2327 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2328 If the aspect ratio of the input image isn't exactly 4:3, then the 2329 image is centered on an 800x600 black canvas. </font></td></tr></table> 2330 <table BORDER=0 WIDTH="94%"> 2331 <tr> 2332 <td width="3%"><br></td> 2333 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2334 <img SRC="images/right_triangle_option.png" 2335 ALT=">" BORDER=0 height=14 2336 width=15><b><font face="Helvetica, Arial" 2337 ><font color="#00B04F"><font size="+1"> 2338 <a name="details-file"></a>-file <i><filename></i> 2339 </font></font></font></b></td></tr></table> 2340 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>write annotated difference image to file</td></tr></table> 2341 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2342 If <strong>-file</strong> is specified, then an annotated difference image is 2343 generated and written to the specified file. Pixels which differ between 2344 the <strong>reference</strong> and <strong>compare</strong> images are modified from those in 2345 the <strong>compare</strong> image so that the changed pixels become more obvious. 2346 Some images may require use of an alternative highlight style (see 2347 <strong>-highlight-style</strong>) or highlight color (see <strong>-highlight-color</strong>) 2348 before the changes are obvious.</font></td></tr></table> 2349 <table BORDER=0 WIDTH="94%"> 2350 <tr> 2351 <td width="3%"><br></td> 2352 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2353 <img SRC="images/right_triangle_option.png" 2354 ALT=">" BORDER=0 height=14 2355 width=15><b><font face="Helvetica, Arial" 2356 ><font color="#00B04F"><font size="+1"> 2357 <a name="details-fill"></a>-fill <i><color></i> 2358 </font></font></font></b></td></tr></table> 2359 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color to use when filling a graphic primitive</td></tr></table> 2360 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2361 Colors are represented in GraphicsMagick in the same form used by SVG. Use "gm convert -list color" to list named colors:</font></td></tr></table> 2362 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2363 name (named color) 2364 #RGB (hex numbers, 4 bits each) 2365 #RRGGBB (8 bits each) 2366 #RRRGGGBBB (12 bits each) 2367 #RRRRGGGGBBBB (16 bits each) 2368 #RGBA (4 bits each) 2369 #RRGGBBAA (8 bits each) 2370 #RRRGGGBBBAAA (12 bits each) 2371 #RRRRGGGGBBBBAAAA (16 bits each) 2372 rgb(r,g,b) (r,g,b are decimal numbers) 2373 rgba(r,g,b,a) (r,g,b,a are decimal numbers) 2374 </pre></font></td></tr></table> 2375 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2376 Enclose the color specification in quotation marks to prevent the "#" 2377 or the parentheses from being interpreted by your shell.</font></td></tr></table> 2378 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2379 For example,</font></td></tr></table> 2380 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2381 gm convert -fill blue ... 2382 gm convert -fill "#ddddff" ... 2383 gm convert -fill "rgb(65000,65000,65535)" ... 2384 </pre></font></td></tr></table> 2385 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2386 The shorter forms are scaled up, if necessary by replication. For example, 2387 #3af, #33aaff, and #3333aaaaffff are all equivalent.</font></td></tr></table> 2388 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2389 See <strong>-draw</strong> for further details.</font></td></tr></table> 2390 <table BORDER=0 WIDTH="94%"> 2391 <tr> 2392 <td width="3%"><br></td> 2393 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2394 <img SRC="images/right_triangle_option.png" 2395 ALT=">" BORDER=0 height=14 2396 width=15><b><font face="Helvetica, Arial" 2397 ><font color="#00B04F"><font size="+1"> 2398 <a name="details-filter"></a>-filter <i><type></i> 2399 </font></font></font></b></td></tr></table> 2400 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this type of filter when resizing an image</td></tr></table> 2401 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2402 Use this option to affect the resizing operation of an image (see 2403 <strong>-geometry</strong>). 2404 Choose from these filters (ordered by approximate increasing CPU 2405 time):</font></td></tr></table> 2406 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2407 Point 2408 Box 2409 Triangle 2410 Hermite 2411 Hanning 2412 Hamming 2413 Blackman 2414 Gaussian 2415 Quadratic 2416 Cubic 2417 Catrom 2418 Mitchell 2419 Lanczos 2420 Bessel 2421 Sinc 2422 </pre></font></td></tr></table> 2423 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2424 The default filter is automatically selected to provide the best quality 2425 while consuming a reasonable amount of time. The <strong>Mitchell</strong> filter 2426 is used if the image supports a palette, supports a matte channel, or is 2427 being enlarged, otherwise the <strong>Lanczos</strong> filter is used.</font></td></tr></table> 2428 <table BORDER=0 WIDTH="94%"> 2429 <tr> 2430 <td width="3%"><br></td> 2431 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2432 <img SRC="images/right_triangle_option.png" 2433 ALT=">" BORDER=0 height=14 2434 width=15><b><font face="Helvetica, Arial" 2435 ><font color="#00B04F"><font size="+1"> 2436 <a name="details-flatten"></a>-flatten 2437 </font></font></font></b></td></tr></table> 2438 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>flatten a sequence of images</td></tr></table> 2439 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2440 In some file formats (e.g. Photoshop's PSD) complex images may be 2441 represented by "layers" (independent images) which must be composited 2442 in order to obtain the final rendition. The <strong>-flatten</strong> option 2443 accomplishes this composition. The sequence of images is replaced by 2444 a single image created by compositing each image in turn, while 2445 respecting composition operators and page offsets. While 2446 <strong>-flatten</strong> is immediately useful for eliminating layers, it is 2447 also useful as a general-purpose composition tool.</font></td></tr></table> 2448 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2449 The sequence of images is terminated by the appearance of any option. 2450 If the <strong>-flatten</strong> option appears after all of the input images, 2451 all images are flattened. Also see <strong>-mosaic</strong> which is similar to 2452 <strong>-flatten</strong> except that it adds a suitably-sized canvas base 2453 image.</font></td></tr></table> 2454 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2455 For example, this composites an image on top of a 640x400 transparent 2456 black canvas image:</font></td></tr></table> 2457 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2458 gm convert -size 640x300 xc:transparent \ 2459 -compose over -page +0-100 \ 2460 frame.png -flatten output.png 2461 </pre></font></td></tr></table> 2462 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2463 and this flattens a Photoshop PSD file:</font></td></tr></table> 2464 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2465 gm convert input.psd -flatten output.png 2466 </pre></font></td></tr></table> 2467 <table BORDER=0 WIDTH="94%"> 2468 <tr> 2469 <td width="3%"><br></td> 2470 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2471 <img SRC="images/right_triangle_option.png" 2472 ALT=">" BORDER=0 height=14 2473 width=15><b><font face="Helvetica, Arial" 2474 ><font color="#00B04F"><font size="+1"> 2475 <a name="details-flip"></a>-flip 2476 </font></font></font></b></td></tr></table> 2477 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table> 2478 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2479 reflect the scanlines in the vertical direction.</font></td></tr></table> 2480 <table BORDER=0 WIDTH="94%"> 2481 <tr> 2482 <td width="3%"><br></td> 2483 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2484 <img SRC="images/right_triangle_option.png" 2485 ALT=">" BORDER=0 height=14 2486 width=15><b><font face="Helvetica, Arial" 2487 ><font color="#00B04F"><font size="+1"> 2488 <a name="details-flop"></a>-flop 2489 </font></font></font></b></td></tr></table> 2490 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table> 2491 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2492 reflect the scanlines in the horizontal direction.</font></td></tr></table> 2493 <table BORDER=0 WIDTH="94%"> 2494 <tr> 2495 <td width="3%"><br></td> 2496 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2497 <img SRC="images/right_triangle_option.png" 2498 ALT=">" BORDER=0 height=14 2499 width=15><b><font face="Helvetica, Arial" 2500 ><font color="#00B04F"><font size="+1"> 2501 <a name="details-font"></a>-font <i><name></i> 2502 </font></font></font></b></td></tr></table> 2503 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this font when annotating the image with text</td></tr></table> 2504 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2505 You can tag a font to specify whether it is a PostScript, TrueType, or X11 2506 font. For example, <tt>Arial.ttf</tt> is a TrueType font, <tt>ps:helvetica</tt> 2507 is PostScript, and <tt>x:fixed</tt> is X11.</font></td></tr></table> 2508 <table BORDER=0 WIDTH="94%"> 2509 <tr> 2510 <td width="3%"><br></td> 2511 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2512 <img SRC="images/right_triangle_option.png" 2513 ALT=">" BORDER=0 height=14 2514 width=15><b><font face="Helvetica, Arial" 2515 ><font color="#00B04F"><font size="+1"> 2516 <a name="details-foreground"></a>-foreground <i><color></i> 2517 </font></font></font></b></td></tr></table> 2518 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>define the foreground color</td></tr></table> 2519 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2520 The color is specified using the format described under the <strong>-fill</strong> 2521 option.</font></td></tr></table> 2522 <table BORDER=0 WIDTH="94%"> 2523 <tr> 2524 <td width="3%"><br></td> 2525 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2526 <img SRC="images/right_triangle_option.png" 2527 ALT=">" BORDER=0 height=14 2528 width=15><b><font face="Helvetica, Arial" 2529 ><font color="#00B04F"><font size="+1"> 2530 <a name="details-format"></a>-format <i><type></i> 2531 </font></font></font></b></td></tr></table> 2532 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image format type</td></tr></table> 2533 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2534 When used with the <strong>mogrify</strong> utility, 2535 this option will convert any image to the image format you specify. 2536 See <em>GraphicsMagick(1)</em> for a list of image format types supported by 2537 <strong>GraphicsMagick</strong>, or see the output of 'gm -list format'.</font></td></tr></table> 2538 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2539 By default the file is written to its original name. However, if the 2540 filename extension matches a supported format, the extension is replaced 2541 with the image format type specified with <strong>-format</strong>. For example, 2542 if you specify <em>tiff</em> as the format type and the input image 2543 filename is <em>image.gif</em>, the output image filename becomes 2544 <em>image.tiff</em>.</font></td></tr></table> 2545 <table BORDER=0 WIDTH="94%"> 2546 <tr> 2547 <td width="3%"><br></td> 2548 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2549 <img SRC="images/right_triangle_option.png" 2550 ALT=">" BORDER=0 height=14 2551 width=15><b><font face="Helvetica, Arial" 2552 ><font color="#00B04F"><font size="+1"> 2553 <a name="details-format"></a>-format <i><string></i> 2554 </font></font></font></b></td></tr></table> 2555 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>output formatted image characteristics</td></tr></table> 2556 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2557 When used with the <strong>identify</strong> utility, or the <strong>convert</strong> 2558 utility with output written to the 'info:-' file specification, use 2559 this option to print information about the image in a format of your 2560 choosing. You can include the image filename, type, width, height, 2561 Exif data, or other image attributes by embedding special format 2562 characters:</font></td></tr></table> 2563 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2564 %b file size 2565 %c comment 2566 %d directory 2567 %e filename extension 2568 %f filename 2569 %g page dimensions and offsets 2570 %h height 2571 %i input filename 2572 %k number of unique colors 2573 %l label 2574 %m magick 2575 %n number of scenes 2576 %o output filename 2577 %p page number 2578 %q image bit depth 2579 %r image type description 2580 %s scene number 2581 %t top of filename 2582 %u unique temporary filename 2583 %w width 2584 %x horizontal resolution 2585 %y vertical resolution 2586 %A transparency supported 2587 %C compression type 2588 %D GIF disposal method 2589 %G Original width and height 2590 %H page height 2591 %M original filename specification 2592 %O page offset (x,y) 2593 %P page dimensions (width,height) 2594 %Q compression quality 2595 %T time delay (in centi-seconds) 2596 %U resolution units 2597 %W page width 2598 %X page horizontal offset (x) 2599 %Y page vertical offset (y) 2600 %@ trim bounding box 2601 %# signature 2602 \n newline 2603 \r carriage return 2604 %% % 2605 </pre></font></td></tr></table> 2606 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2607 For example,</font></td></tr></table> 2608 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2609 -format "%m:%f %wx%h" 2610 </pre></font></td></tr></table> 2611 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2612 displays <strong>MIFF:bird.miff 512x480</strong> for an image 2613 titled <strong>bird.miff</strong> and whose width is 512 and height is 480.</font></td></tr></table> 2614 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2615 If the first character of <em>string</em> is <strong>@</strong>, the format is 2616 read from a file titled by the remaining characters in the string. 2617 Please note that if the string comes from an untrusted source that it 2618 should be sanitized before use since this may be used to incorporate 2619 any readable file on the system (a security risk).</font></td></tr></table> 2620 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2621 The values of image type (<strong>%r</strong>) which may be returned include:</font></td></tr></table> 2622 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2623 Bilevel 2624 Grayscale 2625 GrayscaleMatte 2626 Palette 2627 PaletteMatte 2628 TrueColor 2629 TrueColorMatte 2630 ColorSeparation 2631 ColorSeparationMatte 2632 Optimize 2633 </pre></font></td></tr></table> 2634 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2635 You can also use the following special formatting syntax to print Exif 2636 information contained in the file:</font></td></tr></table> 2637 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2638 %[EXIF:<tag>] 2639 </pre></font></td></tr></table> 2640 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2641 Where "<tag>" may be one of the following:</font></td></tr></table> 2642 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2643 * (print all Exif tags, in keyword=data format) 2644 ! (print all Exif tags, in tag_number format) 2645 #hhhh (print data for Exif tag #hhhh) 2646 ImageWidth 2647 ImageLength 2648 BitsPerSample 2649 Compression 2650 PhotometricInterpretation 2651 FillOrder 2652 DocumentName 2653 ImageDescription 2654 Make 2655 Model 2656 StripOffsets 2657 Orientation 2658 SamplesPerPixel 2659 RowsPerStrip 2660 StripByteCounts 2661 XResolution 2662 YResolution 2663 PlanarConfiguration 2664 ResolutionUnit 2665 TransferFunction 2666 Software 2667 DateTime 2668 Artist 2669 WhitePoint 2670 PrimaryChromaticities 2671 TransferRange 2672 JPEGProc 2673 JPEGInterchangeFormat 2674 JPEGInterchangeFormatLength 2675 YCbCrCoefficients 2676 YCbCrSubSampling 2677 YCbCrPositioning 2678 ReferenceBlackWhite 2679 CFARepeatPatternDim 2680 CFAPattern 2681 BatteryLevel 2682 Copyright 2683 ExposureTime 2684 FNumber 2685 IPTC/NAA 2686 ExifOffset 2687 InterColorProfile 2688 ExposureProgram 2689 SpectralSensitivity 2690 GPSInfo 2691 ISOSpeedRatings 2692 OECF 2693 ExifVersion 2694 DateTimeOriginal 2695 DateTimeDigitized 2696 ComponentsConfiguration 2697 CompressedBitsPerPixel 2698 ShutterSpeedValue 2699 ApertureValue 2700 BrightnessValue 2701 ExposureBiasValue 2702 MaxApertureValue 2703 SubjectDistance 2704 MeteringMode 2705 LightSource 2706 Flash 2707 FocalLength 2708 MakerNote 2709 UserComment 2710 SubSecTime 2711 SubSecTimeOriginal 2712 SubSecTimeDigitized 2713 FlashPixVersion 2714 ColorSpace 2715 ExifImageWidth 2716 ExifImageLength 2717 InteroperabilityOffset 2718 FlashEnergy 2719 SpatialFrequencyResponse 2720 FocalPlaneXResolution 2721 FocalPlaneYResolution 2722 FocalPlaneResolutionUnit 2723 SubjectLocation 2724 ExposureIndex 2725 SensingMethod 2726 FileSource 2727 SceneType 2728 </pre></font></td></tr></table> 2729 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2730 JPEG specific information (from reading a JPEG file) may be obtained 2731 like this:</font></td></tr></table> 2732 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2733 %[JPEG-<tag>] 2734 </pre></font></td></tr></table> 2735 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2736 Where "<tag>" may be one of the following:</font></td></tr></table> 2737 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2738 * (all JPEG-related tags, in 2739 keyword=data format) 2740 Quality IJG JPEG "quality" estimate 2741 Colorspace JPEG colorspace numeric ID 2742 Colorspace-Name JPEG colorspace name 2743 Sampling-factors JPEG sampling factors 2744 </pre></font></td></tr></table> 2745 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2746 Please note that JPEG has no notion of "quality" and that the quality 2747 metric used by, and estimated by the software is based on the quality 2748 metric established by IJG JPEG 6b. Other encoders (e.g. that used by 2749 Adobe Photoshop) use different encoding metrics.</font></td></tr></table> 2750 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2751 Surround the format specification with quotation marks to prevent your shell 2752 from misinterpreting any spaces and square brackets.</font></td></tr></table> 2753 <table BORDER=0 WIDTH="94%"> 2754 <tr> 2755 <td width="3%"><br></td> 2756 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2757 <img SRC="images/right_triangle_option.png" 2758 ALT=">" BORDER=0 height=14 2759 width=15><b><font face="Helvetica, Arial" 2760 ><font color="#00B04F"><font size="+1"> 2761 <a name="details-frame"></a>-frame <i><width>x<height>+<outer bevel width>+<inner bevel width></i> 2762 </font></font></font></b></td></tr></table> 2763 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with an ornamental border</td></tr></table> 2764 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2765 See <strong>-geometry</strong> for details about the geometry 2766 specification. The <strong>-frame</strong> option is not affected by the 2767 <strong>-gravity</strong> option.</font></td></tr></table> 2768 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2769 The color of the border is specified with the <strong>-mattecolor</strong> 2770 command line option.</font></td></tr></table> 2771 <table BORDER=0 WIDTH="94%"> 2772 <tr> 2773 <td width="3%"><br></td> 2774 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2775 <img SRC="images/right_triangle_option.png" 2776 ALT=">" BORDER=0 height=14 2777 width=15><b><font face="Helvetica, Arial" 2778 ><font color="#00B04F"><font size="+1"> 2779 -frame 2780 </font></font></font></b></td></tr></table> 2781 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>include the X window frame in the imported image</td></tr></table> 2782 <table BORDER=0 WIDTH="94%"> 2783 <tr> 2784 <td width="3%"><br></td> 2785 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2786 <img SRC="images/right_triangle_option.png" 2787 ALT=">" BORDER=0 height=14 2788 width=15><b><font face="Helvetica, Arial" 2789 ><font color="#00B04F"><font size="+1"> 2790 <a name="details-fuzz"></a>-fuzz <i><distance></i>{<i>%</i>}<i></i> 2791 </font></font></font></b></td></tr></table> 2792 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>colors within this Euclidean distance are considered equal</td></tr></table> 2793 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2794 A number of algorithms search for a target color. By default the color 2795 must be exact. Use this option to match colors that are close (in 2796 Euclidean distance) to the target color in RGB 3D space. For example, 2797 if you want to automatically trim the edges of an image with 2798 <strong>-trim</strong> but the image was scanned and the target background color 2799 may differ by a small amount. This option can account for these 2800 differences.</font></td></tr></table> 2801 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2802 The <em>distance</em> can be in absolute intensity units or, by appending 2803 <em>"%"</em>, as a percentage of the maximum possible intensity (255, 2804 65535, or 4294967295).</font></td></tr></table> 2805 <table BORDER=0 WIDTH="94%"> 2806 <tr> 2807 <td width="3%"><br></td> 2808 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2809 <img SRC="images/right_triangle_option.png" 2810 ALT=">" BORDER=0 height=14 2811 width=15><b><font face="Helvetica, Arial" 2812 ><font color="#00B04F"><font size="+1"> 2813 <a name="details-gamma"></a>-gamma <i><value></i> 2814 </font></font></font></b></td></tr></table> 2815 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>level of gamma correction</td></tr></table> 2816 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2817 The same color image displayed on two different workstations may look 2818 different due to differences in the display monitor. Use gamma 2819 correction to adjust for this color difference. Reasonable values extend 2820 from <strong>0.8</strong> to <strong>2.3</strong>. Gamma less than 1.0 darkens the image and 2821 gamma greater than 1.0 lightens it. Large adjustments to image gamma may 2822 result in the loss of some image information if the pixel quantum size 2823 is only eight bits (quantum range 0 to 255).</font></td></tr></table> 2824 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2825 You can apply separate gamma values to the red, green, and blue channels 2826 of the image with a gamma value list delimited with slashes 2827 (e.g., <strong>1.7</strong>/<strong>2.3</strong>/<strong>1.2</strong>).</font></td></tr></table> 2828 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2829 Use <strong>+gamma</strong> <em>value</em> 2830 to set the image gamma level without actually adjusting 2831 the image pixels. This option is useful if the image is of a known gamma 2832 but not set as an image attribute (e.g. PNG images).</font></td></tr></table> 2833 <table BORDER=0 WIDTH="94%"> 2834 <tr> 2835 <td width="3%"><br></td> 2836 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2837 <img SRC="images/right_triangle_option.png" 2838 ALT=">" BORDER=0 height=14 2839 width=15><b><font face="Helvetica, Arial" 2840 ><font color="#00B04F"><font size="+1"> 2841 <a name="details-gaussian"></a>-gaussian <i><radius></i>{<i>x<sigma></i>}<i></i> 2842 </font></font></font></b></td></tr></table> 2843 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blur the image with a Gaussian operator</td></tr></table> 2844 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2845 Use the given radius and standard deviation (sigma).</font></td></tr></table> 2846 <table BORDER=0 WIDTH="94%"> 2847 <tr> 2848 <td width="3%"><br></td> 2849 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2850 <img SRC="images/right_triangle_option.png" 2851 ALT=">" BORDER=0 height=14 2852 width=15><b><font face="Helvetica, Arial" 2853 ><font color="#00B04F"><font size="+1"> 2854 <a name="details-geometry"></a>-geometry <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i>^</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 2855 </font></font></font></b></td></tr></table> 2856 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify dimension, offset, and resize options.</td></tr></table> 2857 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2858 The <strong>-geometry</strong> option is used for a number of different 2859 purposes, depending on the utility it is used with.</font></td></tr></table> 2860 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2861 For the X11 commands ('animate', 'display', and 'import'), it 2862 specifies the preferred size and location of the Image window. By 2863 default, the window size is the image size and the location is chosen 2864 by you (or your window manager) when it is mapped.</font></td></tr></table> 2865 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> For the 'import', 'convert', 'mogrify' utility commands it may be 2866 used to specify the desired size when resizing an image. In this 2867 case, symbols representing resize options may be appended to the 2868 geometry string to influence how the resize request is treated.</font></td></tr></table> 2869 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2870 See later notes corresponding to usage by particular commands. The 2871 following notes apply to when <strong>-geometry</strong> is used to express a 2872 resize request, taking into account the current properties of the 2873 image.</font></td></tr></table> 2874 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2875 By default, the width and height are maximum values. That is, the 2876 image is expanded or contracted to fit the width and height value 2877 while maintaining the aspect ratio of the image.</font></td></tr></table> 2878 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2879 Append a ^ to the geometry so that the image aspect ratio is 2880 maintained when the image is resized, but the resulting width or 2881 height are treated as minimum values rather than maximum values.</font></td></tr></table> 2882 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2883 Append a ! (exclamation point) to the geometry to force the image size to 2884 exactly the size you specify. For example, if you specify 2885 <tt>640x480!</tt> the image width is set to 640 pixels and height to 2886 480.</font></td></tr></table> 2887 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2888 If only the width is specified, without the trailing 'x', then height 2889 is set to width (e.g., <tt>-geometry 100</tt> is the same as 2890 <tt>-geometry 100x100</tt>). If only the width is specified but with 2891 the trailing 'x', then width assumes the value and the height is 2892 chosen to maintain the aspect ratio of the image. Similarly, if only 2893 the height is specified prefixed by 'x' (e.g., <tt>-geometry 2894 x256</tt>), the width is chosen to maintain the aspect ratio.</font></td></tr></table> 2895 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2896 To specify a percentage width or height instead, append %. The image size 2897 is multiplied by the width and height percentages to obtain the final image 2898 dimensions. To increase the size of an image, use a value greater than 2899 100 (e.g. 125%). To decrease an image's size, use a percentage less than 2900 100.</font></td></tr></table> 2901 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2902 Use <tt>@</tt> to specify the maximum area in pixels of an image.</font></td></tr></table> 2903 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2904 Use <tt>></tt> to change the dimensions of the image <em>only</em> if 2905 its width or height exceeds the geometry specification. <tt><</tt> resizes 2906 the image <em>only</em> if both of its dimensions are less than the geometry 2907 specification. For example, 2908 if you specify <tt>'640x480>'</tt> and the image size is 256x256, the image 2909 size does not change. However, if the image is 512x512 or 1024x1024, it is 2910 resized to 480x480. Enclose the geometry specification in quotation marks to 2911 prevent the <tt><</tt> or <tt>></tt> from being interpreted by your shell 2912 as a file redirection.</font></td></tr></table> 2913 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2914 When used with <em>animate</em> and <em>display</em>, offsets are handled in 2915 the same manner as in <em>X(1)</em> and the <strong>-gravity</strong> option is not used. 2916 If the <em>x</em> is negative, the offset is measured leftward 2917 from the right edge of the 2918 screen to the right edge of the image being displayed. 2919 Similarly, negative <em>y</em> is measured between the bottom edges. The 2920 offsets are not affected by "%"; they are always measured in pixels.</font></td></tr></table> 2921 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2922 When used as a <em>composite</em> option, <strong>-geometry</strong> 2923 gives the dimensions of the image and its location with respect 2924 to the composite image. If the <strong>-gravity</strong> option is present 2925 with <em>NorthEast, East,</em> or <em>SouthEast</em> gravity, the <em>x</em> 2926 represents the distance from the right edge of the image to the right edge of 2927 the composite image. Similarly, if the <strong>-gravity</strong> option is present 2928 with <em>SouthWest, South,</em> or <em>SouthEast</em> gravity, <em>y</em> 2929 is measured between the bottom edges. Accordingly, a positive offset will 2930 never point in the direction outside of the image. The 2931 offsets are not affected by "%"; they are always measured in pixels. 2932 To specify the dimensions of the composite image, use the <strong>-resize</strong> 2933 option.</font></td></tr></table> 2934 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2935 When used as a <em>convert</em>, <em>import</em> or <em>mogrify</em> option, 2936 <strong>-geometry</strong> is synonymous with <strong>-resize</strong> and 2937 specifies the size of the output image. The offsets, if present, are ignored.</font></td></tr></table> 2938 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2939 When used as a <em>montage</em> option, <strong>-geometry</strong> specifies the image 2940 size and border size for each tile; default is 256x256+0+0. Negative 2941 offsets (border dimensions) are meaningless. The <strong>-gravity</strong> 2942 option affects the placement of the image within the tile; the default 2943 gravity for this purpose is <em>Center</em>. If the "%" sign appears in 2944 the geometry specification, the tile size is the specified percentage of 2945 the original dimensions of the first tile. 2946 To specify the dimensions of the montage, use the <strong>-resize</strong> 2947 option.</font></td></tr></table> 2948 <table BORDER=0 WIDTH="94%"> 2949 <tr> 2950 <td width="3%"><br></td> 2951 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2952 <img SRC="images/right_triangle_option.png" 2953 ALT=">" BORDER=0 height=14 2954 width=15><b><font face="Helvetica, Arial" 2955 ><font color="#00B04F"><font size="+1"> 2956 <a name="details-gravity"></a>-gravity <i><type></i> 2957 </font></font></font></b></td></tr></table> 2958 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>direction primitive gravitates to when annotating the image.</td></tr></table> 2959 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2960 Choices are: NorthWest, North, 2961 NorthEast, West, Center, East, SouthWest, South, SouthEast.</font></td></tr></table> 2962 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2963 The direction you choose specifies where to position the text 2964 when annotating 2965 the image. For example <em>Center</em> gravity forces the text to be centered 2966 within the image. By default, the image gravity is <em>NorthWest</em>. 2967 See <strong>-draw</strong> for more details about graphic primitives. Only the 2968 text primitive is affected by the <strong>-gravity</strong> option.</font></td></tr></table> 2969 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2970 The <strong>-gravity</strong> option is also used in concert with the <strong>-geometry</strong> 2971 option and other options that take <strong><geometry></strong> as a parameter, such 2972 as the <strong>-crop</strong> option. See <strong>-geometry</strong> for details of how the 2973 <strong>-gravity</strong> option interacts with the 2974 <strong><x></strong> and <strong><y></strong> parameters of a geometry 2975 specification.</font></td></tr></table> 2976 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2977 When used as an option to <em>composite</em>, <strong>-gravity</strong> 2978 gives the direction that the image gravitates within the composite.</font></td></tr></table> 2979 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2980 When used as an option to <em>montage</em>, <strong>-gravity</strong> gives the direction 2981 that an image gravitates within a tile. The default gravity is <em>Center</em> 2982 for this purpose.</font></td></tr></table> 2983 <table BORDER=0 WIDTH="94%"> 2984 <tr> 2985 <td width="3%"><br></td> 2986 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2987 <img SRC="images/right_triangle_option.png" 2988 ALT=">" BORDER=0 height=14 2989 width=15><b><font face="Helvetica, Arial" 2990 ><font color="#00B04F"><font size="+1"> 2991 <a name="details-green-primary"></a>-green-primary <i><x>,<y></i> 2992 </font></font></font></b></td></tr></table> 2993 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>green chromaticity primary point</td></tr></table> 2994 <table BORDER=0 WIDTH="94%"> 2995 <tr> 2996 <td width="3%"><br></td> 2997 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2998 <img SRC="images/right_triangle_option.png" 2999 ALT=">" BORDER=0 height=14 3000 width=15><b><font face="Helvetica, Arial" 3001 ><font color="#00B04F"><font size="+1"> 3002 -hald-clut <i><clut></i> 3003 </font></font></font></b></td></tr></table> 3004 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a Hald CLUT to the image</td></tr></table> 3005 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3006 A Hald CLUT ("Color Look-Up Table") is a special square color image 3007 which contains a look-up table for red, green, and blue. The size of 3008 the Hald CLUT image is determined by its order. The width (and 3009 height) of a Hald CLUT is the cube of the order. For example, a Hald 3010 CLUT of order 8 is 512x512 pixels (262,144 colors) and of order 16 is 3011 4096x4096 (16,777,216 colors). A special CLUT is the identity CLUT 3012 which which causes no change to the input image. In order to use the 3013 Hald CLUT, one takes an identity CLUT and adjusts its colors in some 3014 way. The modified CLUT can then be used to transform any number of 3015 images in an identical way.</font></td></tr></table> 3016 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3017 GraphicsMagick contains a built-in identity CLUT generator via the 3018 <strong>IDENTITY</strong> coder. For example reading from the file name 3019 </strong>IDENTITY:8</strong> returns an identity CLUT of order 8. Typical Hald 3020 CLUT identity images have an order of between 8 and 16. The default 3021 order for the <strong>IDENTITY</strong> CLUT generator is 8. Interpolation is 3022 used so it is not usually necessary for CLUT images to be very large. 3023 The PNG file format is ideal for storing Hald CLUT images because it 3024 compresses them very well.</font></td></tr></table> 3025 <table BORDER=0 WIDTH="94%"> 3026 <tr> 3027 <td width="3%"><br></td> 3028 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3029 <img SRC="images/right_triangle_option.png" 3030 ALT=">" BORDER=0 height=14 3031 width=15><b><font face="Helvetica, Arial" 3032 ><font color="#00B04F"><font size="+1"> 3033 -help 3034 </font></font></font></b></td></tr></table> 3035 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table> 3036 <table BORDER=0 WIDTH="94%"> 3037 <tr> 3038 <td width="3%"><br></td> 3039 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3040 <img SRC="images/right_triangle_option.png" 3041 ALT=">" BORDER=0 height=14 3042 width=15><b><font face="Helvetica, Arial" 3043 ><font color="#00B04F"><font size="+1"> 3044 <a name="details-highlight-color"></a>-highlight-color <i><color></i> 3045 </font></font></font></b></td></tr></table> 3046 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pixel annotation color</td></tr></table> 3047 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3048 Specifies the color to use when annotating difference pixels.</font></td></tr></table> 3049 <table BORDER=0 WIDTH="94%"> 3050 <tr> 3051 <td width="3%"><br></td> 3052 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3053 <img SRC="images/right_triangle_option.png" 3054 ALT=">" BORDER=0 height=14 3055 width=15><b><font face="Helvetica, Arial" 3056 ><font color="#00B04F"><font size="+1"> 3057 <a name="details-highlight-style"></a>-highlight-style <i><style></i> 3058 </font></font></font></b></td></tr></table> 3059 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pixel annotation style</td></tr></table> 3060 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3061 Specifies the pixel difference annotation style used to draw attention to 3062 changed pixels. May be one of <strong>Assign</strong>, <strong>Threshold</strong>, 3063 <strong>Tint</strong>, or <strong>XOR</strong>; where <strong>Assign</strong> replaces the pixel with 3064 the highlight color (see <strong>-highlight-color</strong>), <strong>Threshold</strong> 3065 replaces the pixel with black or white based on the difference in 3066 intensity, <strong>Tint</strong> alpha tints the pixel with the highlight color, 3067 and <strong>XOR</strong> does an XOR between the pixel and the highlight color.</font></td></tr></table> 3068 <table BORDER=0 WIDTH="94%"> 3069 <tr> 3070 <td width="3%"><br></td> 3071 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3072 <img SRC="images/right_triangle_option.png" 3073 ALT=">" BORDER=0 height=14 3074 width=15><b><font face="Helvetica, Arial" 3075 ><font color="#00B04F"><font size="+1"> 3076 <a name="details-iconGeometry"></a>-iconGeometry <i><geometry></i> 3077 </font></font></font></b></td></tr></table> 3078 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the icon geometry</td></tr></table> 3079 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3080 Offsets, if present in the geometry specification, are handled in 3081 the same manner as the <strong>-geometry</strong> option, using X11 style to handle 3082 negative offsets.</font></td></tr></table> 3083 <table BORDER=0 WIDTH="94%"> 3084 <tr> 3085 <td width="3%"><br></td> 3086 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3087 <img SRC="images/right_triangle_option.png" 3088 ALT=">" BORDER=0 height=14 3089 width=15><b><font face="Helvetica, Arial" 3090 ><font color="#00B04F"><font size="+1"> 3091 -iconic 3092 </font></font></font></b></td></tr></table> 3093 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>iconic animation</td></tr></table> 3094 <table BORDER=0 WIDTH="94%"> 3095 <tr> 3096 <td width="3%"><br></td> 3097 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3098 <img SRC="images/right_triangle_option.png" 3099 ALT=">" BORDER=0 height=14 3100 width=15><b><font face="Helvetica, Arial" 3101 ><font color="#00B04F"><font size="+1"> 3102 -immutable 3103 </font></font></font></b></td></tr></table> 3104 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make image immutable</td></tr></table> 3105 <table BORDER=0 WIDTH="94%"> 3106 <tr> 3107 <td width="3%"><br></td> 3108 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3109 <img SRC="images/right_triangle_option.png" 3110 ALT=">" BORDER=0 height=14 3111 width=15><b><font face="Helvetica, Arial" 3112 ><font color="#00B04F"><font size="+1"> 3113 -implode <i><factor></i> 3114 </font></font></font></b></td></tr></table> 3115 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>implode image pixels about the center</td></tr></table> 3116 <table BORDER=0 WIDTH="94%"> 3117 <tr> 3118 <td width="3%"><br></td> 3119 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3120 <img SRC="images/right_triangle_option.png" 3121 ALT=">" BORDER=0 height=14 3122 width=15><b><font face="Helvetica, Arial" 3123 ><font color="#00B04F"><font size="+1"> 3124 <a name="details-intent"></a>-intent <i><type></i> 3125 </font></font></font></b></td></tr></table> 3126 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this type of rendering intent when managing the image color</td></tr></table> 3127 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3128 Use this option to affect the the color management operation of an image (see 3129 <strong>-profile</strong>). 3130 Choose from these intents: 3131 <strong>Absolute, Perceptual, Relative, Saturation</strong>.</font></td></tr></table> 3132 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3133 The default intent is undefined.</font></td></tr></table> 3134 <table BORDER=0 WIDTH="94%"> 3135 <tr> 3136 <td width="3%"><br></td> 3137 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3138 <img SRC="images/right_triangle_option.png" 3139 ALT=">" BORDER=0 height=14 3140 width=15><b><font face="Helvetica, Arial" 3141 ><font color="#00B04F"><font size="+1"> 3142 <a name="details-interlace"></a>-interlace <i><type></i> 3143 </font></font></font></b></td></tr></table> 3144 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table> 3145 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3146 Choices are: <strong>None, Line, Plane,</strong> 3147 or <strong>Partition</strong>. The default is <strong>None</strong>.</font></td></tr></table> 3148 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3149 This option is used to specify the type of interlacing scheme for raw image 3150 formats such as <strong>RGB</strong> or <strong>YUV</strong>.</font></td></tr></table><table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3151 <strong>None</strong> means do not interlace 3152 (RGBRGBRGBRGBRGBRGB...),</font></td></tr></table> 3153 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3154 <strong>Line</strong> uses scanline interlacing 3155 (RRR...GGG...BBB...RRR...GGG...BBB...), 3156 and</font></td></tr></table><table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3157 <strong>Plane</strong> uses plane interlacing (RRRRRR...GGGGGG...BBBBBB...).</font></td></tr></table> 3158 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3159 <strong>Partition</strong> 3160 is like plane except the different planes are saved to individual files 3161 (e.g. image.R, image.G, and image.B).</font></td></tr></table> 3162 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3163 Use <strong>Line</strong> to create an <strong>interlaced PNG</strong> or <strong> GIF</strong> or 3164 <strong>progressive JPEG</strong> image.</font></td></tr></table> 3165 <table BORDER=0 WIDTH="94%"> 3166 <tr> 3167 <td width="3%"><br></td> 3168 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3169 <img SRC="images/right_triangle_option.png" 3170 ALT=">" BORDER=0 height=14 3171 width=15><b><font face="Helvetica, Arial" 3172 ><font color="#00B04F"><font size="+1"> 3173 <a name="details-label"></a>-label <i><name></i> 3174 </font></font></font></b></td></tr></table> 3175 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign a label to an image</td></tr></table> 3176 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3177 Use this option to assign a specific label to the image, when writing 3178 to an image format that supports labels, such as TIFF, PNG, MIFF, or 3179 PostScript. You can include the the image filename, type, width, height, 3180 or other image attribute by embedding special format character. A label 3181 is not drawn on the image, but is embedded in the image datastream via 3182 a "Label" tag or similar mechanism. If you want the 3183 label to be visible on the image itself, use the <strong>-draw</strong> option. 3184 See <strong>-comment</strong> for details.</font></td></tr></table> 3185 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3186 For example,</font></td></tr></table> 3187 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 3188 -label "%m:%f %wx%h" 3189 </pre></font></td></tr></table> 3190 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3191 produces an image label of <strong>MIFF:bird.miff 512x480</strong> for an image titled 3192 <strong>bird.miff</strong> 3193 and whose width is 512 and height is 480.</font></td></tr></table> 3194 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3195 If the first character of <em>string</em> is <em>@</em>, the image label 3196 is read from a file titled by the remaining characters in the string. 3197 Please note that if the string comes from an untrusted source that it 3198 should be sanitized before use since otherwise the content of an 3199 arbitrary readable file might be incorporated into the image 3200 label (a security risk).</font></td></tr></table> 3201 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3202 If the -label option appears multiple times, only the last label is 3203 stored.</font></td></tr></table> 3204 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3205 In PNG images, the label is stored in a <strong>tEXt</strong> or <strong>zTXt</strong> chunk 3206 with the keyword "label".</font></td></tr></table> 3207 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3208 When converting to <em>PostScript</em>, use this option to specify a header 3209 string to print above the image. Specify the label font with 3210 <strong>-font</strong>.</font></td></tr></table> 3211 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3212 When creating a montage, by default the label associated with an image 3213 is displayed with the corresponding tile in the montage. Use the 3214 <strong>+label</strong> option to suppress this behavior.</font></td></tr></table> 3215 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3216 </font></td></tr></table> 3217 <table BORDER=0 WIDTH="94%"> 3218 <tr> 3219 <td width="3%"><br></td> 3220 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3221 <img SRC="images/right_triangle_option.png" 3222 ALT=">" BORDER=0 height=14 3223 width=15><b><font face="Helvetica, Arial" 3224 ><font color="#00B04F"><font size="+1"> 3225 <a name="details-lat"></a>-lat <i><width>x<height></i>{<i>+-</i>}<i><offset></i>{<i>%</i>}<i></i> 3226 </font></font></font></b></td></tr></table> 3227 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform local adaptive thresholding</td></tr></table> 3228 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3229 Perform local adaptive thresholding using the specified width, height, 3230 and offset. The offset is a distance in sample space from the mean, 3231 as an absolute integer ranging from 0 to the maximum sample value or 3232 as a percentage. If the percent option is supplied, then the offset 3233 is computed as a percentage of the quantum range. It is strongly 3234 recommended to use the percent option so that results are not 3235 sensitive to pixel quantum depth.</font></td></tr></table> 3236 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3237 For example,</font></td></tr></table> 3238 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 3239 -colorspace gray -lat "10x10-5%" 3240 </pre></font></td></tr></table> 3241 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3242 will help clarify a scanned grayscale or color document, producing a 3243 bi-level equivalent.</font></td></tr></table> 3244 <table BORDER=0 WIDTH="94%"> 3245 <tr> 3246 <td width="3%"><br></td> 3247 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3248 <img SRC="images/right_triangle_option.png" 3249 ALT=">" BORDER=0 height=14 3250 width=15><b><font face="Helvetica, Arial" 3251 ><font color="#00B04F"><font size="+1"> 3252 <a name="details-level"></a>-level <i><black_point></i>{<i>,<gamma></i>}<i></i>{<i>,<white_point></i>}<i></i>{<i>%</i>}<i></i> 3253 </font></font></font></b></td></tr></table> 3254 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>adjust the level of image contrast</td></tr></table> 3255 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3256 Give one, two or three values delimited with commas: black-point, gamma, 3257 white-point (e.g. 10,1.0,250 or 2%,0.5,98%). The black and white 3258 points range from 0 to MaxRGB or from 0 to 100%; if the white point is 3259 omitted it is set to MaxRGB-black_point. If a "%" sign is present 3260 anywhere in the string, the black and white points are percentages of 3261 MaxRGB. Gamma is an exponent that ranges from 0.1 to 10.; if it is 3262 omitted, the default of 1.0 (no gamma correction) is assumed. This 3263 interface works similar to Photoshop's "Image->Adjustments->Levels..." 3264 "Input Levels" interface.</font></td></tr></table> 3265 <table BORDER=0 WIDTH="94%"> 3266 <tr> 3267 <td width="3%"><br></td> 3268 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3269 <img SRC="images/right_triangle_option.png" 3270 ALT=">" BORDER=0 height=14 3271 width=15><b><font face="Helvetica, Arial" 3272 ><font color="#00B04F"><font size="+1"> 3273 <a name="details-limit"></a>-limit <i><type> <value></i> 3274 </font></font></font></b></td></tr></table> 3275 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table> 3276 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3277 By default, resource limits are estimated based on the available 3278 resources of the system. The resource limits are <strong>Disk</strong>, maximum 3279 total disk space consumed; <strong>File</strong>, maximum number of file 3280 descriptors allowed to be open at once; <strong>Map</strong>, maximum total 3281 number of file bytes which may be memory mapped; <strong>Memory</strong>, 3282 maximum total number of bytes of heap memory used for image storage; 3283 <strong>Pixels</strong>, maximum absolute image size (per image); <strong>Width</strong>, 3284 maximum image pixels width; <strong>Height</strong>, maximum image pixels 3285 height; and <strong>Threads</strong>, the maximum number of worker threads to 3286 use per OpenMP thread team.</font></td></tr></table> 3287 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3288 These resource limits are used to decide if (for a given image) the 3289 decoded image ("pixel cache") should be stored in heap memory (RAM), 3290 in a memory-mapped disk file, or in a disk file accessed via 3291 read/write I/O. The number of total pixels in one image, and/or the 3292 width/height, may also be limited in order to force the reading, or 3293 creation of images larger than the limit (in pixels) to intentionally 3294 fail. The disk limit establishes an overall limit since using the disk 3295 is the means of last resort. When the disk limit has been reached, no 3296 more images may be read.</font></td></tr></table> 3297 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3298 The value argument is an absolute value, but may have standard binary 3299 suffix characters applied ('K', 'M', 'G', 'T', 'P', 'E') to apply a 3300 scaling to the value (based on a multiplier of 1024). Any additional 3301 characters are ignored. For example, <tt>'-limit Pixels 10MP'</tt> limits 3302 the maximum image size to 10 megapixels and <tt>'-limit memory 32MB 3303 -limit map 64MB'</tt> limits memory and memory mapped files to 32 3304 megabytes and 64 megabytes respectively.</font></td></tr></table> 3305 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3306 Resource limits may also be set using environment variables. The 3307 environment variables <strong>MAGICK_LIMIT_DISK</strong>, 3308 <strong>MAGICK_LIMIT_FILES</strong>, <strong>MAGICK_LIMIT_MAP</strong>, 3309 <strong>MAGICK_LIMIT_MEMORY</strong>, <strong>MAGICK_LIMIT_PIXELS</strong>, 3310 <strong>MAGICK_LIMIT_WIDTH</strong>, <strong>MAGICK_LIMIT_HEIGHT</strong>,and 3311 <strong>OMP_NUM_THREADS</strong> may be used to set the limits for disk space, 3312 open files, memory mapped size, heap memory, per-image pixels, image 3313 width, image height, and threads respectively.</font></td></tr></table> 3314 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3315 Use the option <tt>-list resource</tt> list the current limits.</font></td></tr></table> 3316 <table BORDER=0 WIDTH="94%"> 3317 <tr> 3318 <td width="3%"><br></td> 3319 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3320 <img SRC="images/right_triangle_option.png" 3321 ALT=">" BORDER=0 height=14 3322 width=15><b><font face="Helvetica, Arial" 3323 ><font color="#00B04F"><font size="+1"> 3324 -linewidth 3325 </font></font></font></b></td></tr></table> 3326 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the line width for subsequent draw operations</td></tr></table> 3327 <table BORDER=0 WIDTH="94%"> 3328 <tr> 3329 <td width="3%"><br></td> 3330 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3331 <img SRC="images/right_triangle_option.png" 3332 ALT=">" BORDER=0 height=14 3333 width=15><b><font face="Helvetica, Arial" 3334 ><font color="#00B04F"><font size="+1"> 3335 <a name="details-list"></a>-list <i><type></i> 3336 </font></font></font></b></td></tr></table> 3337 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of list</td></tr></table> 3338 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3339 Choices are: <strong>Color</strong>, <strong>Delegate</strong>, <strong>Format</strong>, <strong>Magic</strong>, 3340 <strong>Module</strong>, <strong>Resource</strong>, or <strong>Type</strong>. The <strong>Module</strong> option 3341 is only available if GraphicsMagick was built to support loadable modules.</font></td></tr></table> 3342 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3343 This option lists information about the GraphicsMagick configuration.</font></td></tr></table> 3344 <table BORDER=0 WIDTH="94%"> 3345 <tr> 3346 <td width="3%"><br></td> 3347 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3348 <img SRC="images/right_triangle_option.png" 3349 ALT=">" BORDER=0 height=14 3350 width=15><b><font face="Helvetica, Arial" 3351 ><font color="#00B04F"><font size="+1"> 3352 <a name="details-log"></a>-log <i><string></i> 3353 </font></font></font></b></td></tr></table> 3354 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table> 3355 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3356 This option specifies the format for the log printed when the <strong>-debug</strong> 3357 option is active.</font></td></tr></table> 3358 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3359 You can display the following components by embedding 3360 special format characters:</font></td></tr></table> 3361 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 3362 %d domain 3363 %e event 3364 %f function 3365 %l line 3366 %m module 3367 %p process ID 3368 %r real CPU time 3369 %t wall clock time 3370 %u user CPU time 3371 %% percent sign 3372 \n newline 3373 \r carriage return 3374 </pre></font></td></tr></table> 3375 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3376 For example:</font></td></tr></table> 3377 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 3378 gm convert -debug coders -log "%u %m:%l %e" in.gif out.png 3379 </pre></font></td></tr></table> 3380 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3381 The default behavior is to print all of the components.</font></td></tr></table> 3382 <table BORDER=0 WIDTH="94%"> 3383 <tr> 3384 <td width="3%"><br></td> 3385 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3386 <img SRC="images/right_triangle_option.png" 3387 ALT=">" BORDER=0 height=14 3388 width=15><b><font face="Helvetica, Arial" 3389 ><font color="#00B04F"><font size="+1"> 3390 <a name="details-loop"></a>-loop <i><iterations></i> 3391 </font></font></font></b></td></tr></table> 3392 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add Netscape loop extension to your GIF animation</td></tr></table> 3393 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3394 A value other than zero forces the animation to repeat itself up to 3395 <em>iterations</em> 3396 times.</font></td></tr></table> 3397 <table BORDER=0 WIDTH="94%"> 3398 <tr> 3399 <td width="3%"><br></td> 3400 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3401 <img SRC="images/right_triangle_option.png" 3402 ALT=">" BORDER=0 height=14 3403 width=15><b><font face="Helvetica, Arial" 3404 ><font color="#00B04F"><font size="+1"> 3405 -magnify 3406 </font></font></font></b></td></tr></table> 3407 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>magnify the image</td></tr></table> 3408 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3409 The image size is doubled using linear interpolation.</font></td></tr></table> 3410 <table BORDER=0 WIDTH="94%"> 3411 <tr> 3412 <td width="3%"><br></td> 3413 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3414 <img SRC="images/right_triangle_option.png" 3415 ALT=">" BORDER=0 height=14 3416 width=15><b><font face="Helvetica, Arial" 3417 ><font color="#00B04F"><font size="+1"> 3418 -magnify <i><factor></i> 3419 </font></font></font></b></td></tr></table> 3420 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>magnify the image</td></tr></table> 3421 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3422 The displayed image is magnified by <strong>factor</strong>.</font></td></tr></table> 3423 <table BORDER=0 WIDTH="94%"> 3424 <tr> 3425 <td width="3%"><br></td> 3426 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3427 <img SRC="images/right_triangle_option.png" 3428 ALT=">" BORDER=0 height=14 3429 width=15><b><font face="Helvetica, Arial" 3430 ><font color="#00B04F"><font size="+1"> 3431 <a name="details-map"></a>-map <i><filename></i> 3432 </font></font></font></b></td></tr></table> 3433 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>choose a particular set of colors from this image</td></tr></table> 3434 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3435 [<em>convert</em> or <em>mogrify</em>]</font></td></tr></table> 3436 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3437 By default, color reduction chooses an optimal set of colors that best 3438 represent the original image. Alternatively, you can choose a particular 3439 set of colors from an image file with this option.</font></td></tr></table> 3440 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3441 Use 3442 <strong>+map</strong> to reduce 3443 all images in the image sequence that follows to a single optimal set of colors 3444 that best represent all the images. The sequence of images 3445 is terminated by the appearance of any option. 3446 If the <strong>+map</strong> 3447 option appears after all of the input images, all images are mapped.</font></td></tr></table> 3448 <table BORDER=0 WIDTH="94%"> 3449 <tr> 3450 <td width="3%"><br></td> 3451 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3452 <img SRC="images/right_triangle_option.png" 3453 ALT=">" BORDER=0 height=14 3454 width=15><b><font face="Helvetica, Arial" 3455 ><font color="#00B04F"><font size="+1"> 3456 <a name="details-map"></a>-map <i><type></i> 3457 </font></font></font></b></td></tr></table> 3458 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display image using this type.</td></tr></table> 3459 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3460 [<em>animate</em> or <em>display</em>]</font></td></tr></table> 3461 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3462 Choose from these <em>Standard Colormap</em> types:</font></td></tr></table> 3463 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 3464 best 3465 default 3466 gray 3467 red 3468 green 3469 blue 3470 </pre></font></td></tr></table> 3471 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3472 The <em>X server</em> must support the <em>Standard Colormap</em> you choose, 3473 otherwise an error occurs. Use <strong>list</strong> as the type and <strong>display</strong> 3474 searches the list of colormap types in <strong>top-to-bottom</strong> order until 3475 one is located. See <em>xstdcmap(1)</em> for one way of creating Standard 3476 Colormaps.</font></td></tr></table> 3477 <table BORDER=0 WIDTH="94%"> 3478 <tr> 3479 <td width="3%"><br></td> 3480 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3481 <img SRC="images/right_triangle_option.png" 3482 ALT=">" BORDER=0 height=14 3483 width=15><b><font face="Helvetica, Arial" 3484 ><font color="#00B04F"><font size="+1"> 3485 <a name="details-mask"></a>-mask <i><filename></i> 3486 </font></font></font></b></td></tr></table> 3487 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify a clipping mask</td></tr></table> 3488 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3489 The image read from the file is used as a clipping mask. It must have 3490 the same dimensions as the image being masked.</font></td></tr></table> 3491 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3492 If the mask image contains an opacity channel, the opacity of each 3493 pixel is used to define the mask. Otherwise, the intensity (gray 3494 level) of each pixel is used. Unmasked (black) pixels are modified 3495 while masked pixels (not black) are protected from alteration.</font></td></tr></table> 3496 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3497 Use <strong>+mask</strong> to remove the clipping mask.</font></td></tr></table> 3498 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3499 It is not necessary to use <strong>-clip</strong> to activate the mask; <strong>-clip</strong> 3500 is implied by <strong>-mask</strong>.</font></td></tr></table> 3501 <table BORDER=0 WIDTH="94%"> 3502 <tr> 3503 <td width="3%"><br></td> 3504 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3505 <img SRC="images/right_triangle_option.png" 3506 ALT=">" BORDER=0 height=14 3507 width=15><b><font face="Helvetica, Arial" 3508 ><font color="#00B04F"><font size="+1"> 3509 <a name="details-matte"></a>-matte 3510 </font></font></font></b></td></tr></table> 3511 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table> 3512 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3513 If the image does not have a matte channel, create an opaque one.</font></td></tr></table> 3514 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3515 Use <strong>+matte</strong> to ignore the matte channel and to avoid writing a 3516 matte channel in the output file.</font></td></tr></table> 3517 <table BORDER=0 WIDTH="94%"> 3518 <tr> 3519 <td width="3%"><br></td> 3520 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3521 <img SRC="images/right_triangle_option.png" 3522 ALT=">" BORDER=0 height=14 3523 width=15><b><font face="Helvetica, Arial" 3524 ><font color="#00B04F"><font size="+1"> 3525 <a name="details-mattecolor"></a>-mattecolor <i><color></i> 3526 </font></font></font></b></td></tr></table> 3527 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the color to be used with the <strong>-frame</strong> option</td></tr></table> 3528 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3529 The color is specified using the format described under the <strong>-fill</strong> 3530 option.</font></td></tr></table> 3531 <table BORDER=0 WIDTH="94%"> 3532 <tr> 3533 <td width="3%"><br></td> 3534 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3535 <img SRC="images/right_triangle_option.png" 3536 ALT=">" BORDER=0 height=14 3537 width=15><b><font face="Helvetica, Arial" 3538 ><font color="#00B04F"><font size="+1"> 3539 <a name="details-maximum-error"></a>-maximum-error <i><limit></i> 3540 </font></font></font></b></td></tr></table> 3541 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the maximum amount of total image error</td></tr></table> 3542 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3543 Specifies the maximum amount of total image error (based on comparison 3544 using a specified metric) before an error ("image difference exceeds 3545 limit") is reported. The error is reported via a non-zero command 3546 execution return status.</font></td></tr></table> 3547 <table BORDER=0 WIDTH="94%"> 3548 <tr> 3549 <td width="3%"><br></td> 3550 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3551 <img SRC="images/right_triangle_option.png" 3552 ALT=">" BORDER=0 height=14 3553 width=15><b><font face="Helvetica, Arial" 3554 ><font color="#00B04F"><font size="+1"> 3555 -median <i><radius></i> 3556 </font></font></font></b></td></tr></table> 3557 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a median filter to the image</td></tr></table> 3558 <table BORDER=0 WIDTH="94%"> 3559 <tr> 3560 <td width="3%"><br></td> 3561 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3562 <img SRC="images/right_triangle_option.png" 3563 ALT=">" BORDER=0 height=14 3564 width=15><b><font face="Helvetica, Arial" 3565 ><font color="#00B04F"><font size="+1"> 3566 -metric <i><metric></i> 3567 </font></font></font></b></td></tr></table> 3568 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>comparison metric (MAE, MSE, PAE, PSNR, RMSE)</td></tr></table> 3569 <table BORDER=0 WIDTH="94%"> 3570 <tr> 3571 <td width="3%"><br></td> 3572 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3573 <img SRC="images/right_triangle_option.png" 3574 ALT=">" BORDER=0 height=14 3575 width=15><b><font face="Helvetica, Arial" 3576 ><font color="#00B04F"><font size="+1"> 3577 -minify <i><factor></i> 3578 </font></font></font></b></td></tr></table> 3579 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>minify the image</td></tr></table> 3580 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3581 The image size is halved using linear interpolation.</font></td></tr></table> 3582 <table BORDER=0 WIDTH="94%"> 3583 <tr> 3584 <td width="3%"><br></td> 3585 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3586 <img SRC="images/right_triangle_option.png" 3587 ALT=">" BORDER=0 height=14 3588 width=15><b><font face="Helvetica, Arial" 3589 ><font color="#00B04F"><font size="+1"> 3590 -mode <i><value></i> 3591 </font></font></font></b></td></tr></table> 3592 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>mode of operation</td></tr></table> 3593 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3594 The available montage modes are <strong>frame</strong> to place the images in a 3595 rectangular grid while adding a decorative frame with dropshadow, 3596 <strong>unframe</strong> to place undecorated images in a rectangular grid, and 3597 <strong>concatenate</strong> to pack the images closely together without any 3598 well-defined grid or decoration. </font></td></tr></table> 3599 <table BORDER=0 WIDTH="94%"> 3600 <tr> 3601 <td width="3%"><br></td> 3602 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3603 <img SRC="images/right_triangle_option.png" 3604 ALT=">" BORDER=0 height=14 3605 width=15><b><font face="Helvetica, Arial" 3606 ><font color="#00B04F"><font size="+1"> 3607 <a name="details-modulate"></a>-modulate <i>brightness[,saturation[,hue]]</i> 3608 </font></font></font></b></td></tr></table> 3609 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>vary the brightness, saturation, and hue of an image</td></tr></table> 3610 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3611 Specify the percent change in brightness, color saturation, and 3612 hue separated by commas. Default argument values are 100 percent, 3613 resulting in no change. For example, to increase the color brightness 3614 by 20% and decrease the color saturation by 10% and leave the hue 3615 unchanged, use: <strong>-modulate 120,90</strong>.</font></td></tr></table> 3616 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3617 Hue is the percentage of absolute rotation from the current 3618 position. For example 50 results in a counter-clockwise rotation of 90 3619 degrees, 150 results in a clockwise rotation of 90 degrees, with 0 and 3620 200 both resulting in a rotation of 180 degrees.</font></td></tr></table> 3621 <table BORDER=0 WIDTH="94%"> 3622 <tr> 3623 <td width="3%"><br></td> 3624 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3625 <img SRC="images/right_triangle_option.png" 3626 ALT=">" BORDER=0 height=14 3627 width=15><b><font face="Helvetica, Arial" 3628 ><font color="#00B04F"><font size="+1"> 3629 -monitor 3630 </font></font></font></b></td></tr></table> 3631 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>show progress indication</td></tr></table> 3632 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3633 A simple command-line progress indication is shown while the command is 3634 running. The process indication shows the operation currently being 3635 performed and the percent completed. Commands using X11 may replace the 3636 command line progress indication with a graphical one once an image has 3637 been displayed.</font></td></tr></table> 3638 <table BORDER=0 WIDTH="94%"> 3639 <tr> 3640 <td width="3%"><br></td> 3641 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3642 <img SRC="images/right_triangle_option.png" 3643 ALT=">" BORDER=0 height=14 3644 width=15><b><font face="Helvetica, Arial" 3645 ><font color="#00B04F"><font size="+1"> 3646 -monochrome 3647 </font></font></font></b></td></tr></table> 3648 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table> 3649 <table BORDER=0 WIDTH="94%"> 3650 <tr> 3651 <td width="3%"><br></td> 3652 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3653 <img SRC="images/right_triangle_option.png" 3654 ALT=">" BORDER=0 height=14 3655 width=15><b><font face="Helvetica, Arial" 3656 ><font color="#00B04F"><font size="+1"> 3657 <a name="details-morph"></a>-morph <i><frames></i> 3658 </font></font></font></b></td></tr></table> 3659 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>morphs an image sequence</td></tr></table> 3660 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3661 Both the image pixels and size are linearly interpolated to give the appearance 3662 of a meta-morphosis from one image to the next.</font></td></tr></table> 3663 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3664 The sequence of images 3665 is terminated by the appearance of any option. 3666 If the <strong>-morph</strong> 3667 option appears after all of the input images, all images are morphed.</font></td></tr></table> 3668 <table BORDER=0 WIDTH="94%"> 3669 <tr> 3670 <td width="3%"><br></td> 3671 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3672 <img SRC="images/right_triangle_option.png" 3673 ALT=">" BORDER=0 height=14 3674 width=15><b><font face="Helvetica, Arial" 3675 ><font color="#00B04F"><font size="+1"> 3676 <a name="details-mosaic"></a>-mosaic 3677 </font></font></font></b></td></tr></table> 3678 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a mosaic from an image or an image sequence</td></tr></table> 3679 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3680 The <strong>-mosaic</strong> option provides a flexible way to composite one or 3681 more images onto a solid-color canvas image. It works similar to 3682 <strong>-flatten</strong> except that a base canvas image is automatically 3683 created with a suitable size given the image size, page dimensions, 3684 and page offsets of images to be composited. The color of the base 3685 canvas image may be set via the <strong>-background</strong> option. The 3686 default canvas color is 'white', but 'black' or 'transparent' may be 3687 more suitable depending on the composition algorithm requested.</font></td></tr></table> 3688 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3689 The <strong>-compose</strong> option may be used to specify the composition 3690 algorithm to use when compositing the subsequent image on the base 3691 canvas.</font></td></tr></table> 3692 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3693 The <strong>-page</strong> option can be used to establish the dimensions of the 3694 mosaic and to position the subsequent image within the mosaic. If the 3695 <strong>-page</strong> argument does not specify width and height, then the 3696 canvas dimensions are evaluated based on the image sizes and 3697 offsets.</font></td></tr></table> 3698 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3699 The sequence of images is terminated by the appearance of any option. 3700 If the <strong>-mosaic</strong> option appears after all of the input images, 3701 all images are included in the mosaic.</font></td></tr></table> 3702 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3703 The following is an example of composing an image based on red, green, 3704 and blue layers extracted from a sequence of images and pasted on the 3705 canvas image at specified offsets:</font></td></tr></table> 3706 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 3707 gm convert -background black \ 3708 -compose CopyRed -page +0-100 red.png \ 3709 -compose CopyGreen -page +0+40 green.png \ 3710 -compose CopyBlue -page +0+180 blue.png \ 3711 -mosaic output.png 3712 </pre></font></td></tr></table> 3713 <table BORDER=0 WIDTH="94%"> 3714 <tr> 3715 <td width="3%"><br></td> 3716 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3717 <img SRC="images/right_triangle_option.png" 3718 ALT=">" BORDER=0 height=14 3719 width=15><b><font face="Helvetica, Arial" 3720 ><font color="#00B04F"><font size="+1"> 3721 <a name="details-motion-blur"></a>-motion-blur <i><radius></i>{<i>x<sigma></i>}<i></i>{<i>+angle</i>}<i></i> 3722 </font></font></font></b></td></tr></table> 3723 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Simulate motion blur</td></tr></table> 3724 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3725 Simulate motion blur by convolving the image with a Gaussian operator of 3726 the given radius and standard deviation (sigma). For reasonable results, 3727 radius should be larger than sigma. If radius is zero, then a suitable 3728 radius is automatically selected based on sigma. The angle specifies the 3729 angle that the object is coming from (side which is blurred).</font></td></tr></table> 3730 <table BORDER=0 WIDTH="94%"> 3731 <tr> 3732 <td width="3%"><br></td> 3733 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3734 <img SRC="images/right_triangle_option.png" 3735 ALT=">" BORDER=0 height=14 3736 width=15><b><font face="Helvetica, Arial" 3737 ><font color="#00B04F"><font size="+1"> 3738 -name 3739 </font></font></font></b></td></tr></table> 3740 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name an image</td></tr></table> 3741 <table BORDER=0 WIDTH="94%"> 3742 <tr> 3743 <td width="3%"><br></td> 3744 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3745 <img SRC="images/right_triangle_option.png" 3746 ALT=">" BORDER=0 height=14 3747 width=15><b><font face="Helvetica, Arial" 3748 ><font color="#00B04F"><font size="+1"> 3749 <a name="details-negate"></a>-negate 3750 </font></font></font></b></td></tr></table> 3751 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>replace every pixel with its complementary color</td></tr></table> 3752 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3753 The red, green, and blue intensities of an image are negated. 3754 White becomes black, 3755 yellow becomes blue, etc. 3756 Use <strong>+negate</strong> 3757 to only negate the grayscale pixels of the image.</font></td></tr></table> 3758 <table BORDER=0 WIDTH="94%"> 3759 <tr> 3760 <td width="3%"><br></td> 3761 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3762 <img SRC="images/right_triangle_option.png" 3763 ALT=">" BORDER=0 height=14 3764 width=15><b><font face="Helvetica, Arial" 3765 ><font color="#00B04F"><font size="+1"> 3766 <a name="details-noise"></a>-noise <i><radius|type></i> 3767 </font></font></font></b></td></tr></table> 3768 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add or reduce noise in an image</td></tr></table> 3769 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3770 The principal function of noise peak elimination filter is to smooth the 3771 objects within an image without losing edge information and without creating 3772 undesired structures. The central idea of the algorithm is to replace a 3773 pixel with its next neighbor in value within a pixel window, if this pixel 3774 has been found to be noise. A pixel is defined as noise if and only if 3775 this pixel is a maximum or minimum within the pixel window.</font></td></tr></table> 3776 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3777 Use <strong>radius</strong> to specify the width of the neighborhood.</font></td></tr></table> 3778 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3779 Use <strong>+noise</strong> followed by a noise type to add noise to an image. 3780 The noise added modulates the existing image pixels. Choose from these 3781 noise types:</font></td></tr></table> 3782 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 3783 Uniform 3784 Gaussian 3785 Multiplicative 3786 Impulse 3787 Laplacian 3788 Poisson 3789 Random (uniform distribution) 3790 </pre></font></td></tr></table> 3791 <table BORDER=0 WIDTH="94%"> 3792 <tr> 3793 <td width="3%"><br></td> 3794 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3795 <img SRC="images/right_triangle_option.png" 3796 ALT=">" BORDER=0 height=14 3797 width=15><b><font face="Helvetica, Arial" 3798 ><font color="#00B04F"><font size="+1"> 3799 <a name="details-noop"></a>-noop 3800 </font></font></font></b></td></tr></table> 3801 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>NOOP (no option)</td></tr></table> 3802 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3803 The <strong>-noop</strong> option can be used to terminate a group of images 3804 and reset all options to their default values, when no other option is 3805 desired.</font></td></tr></table> 3806 <table BORDER=0 WIDTH="94%"> 3807 <tr> 3808 <td width="3%"><br></td> 3809 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3810 <img SRC="images/right_triangle_option.png" 3811 ALT=">" BORDER=0 height=14 3812 width=15><b><font face="Helvetica, Arial" 3813 ><font color="#00B04F"><font size="+1"> 3814 <a name="details-normalize"></a>-normalize 3815 </font></font></font></b></td></tr></table> 3816 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform image to span the full range of color values</td></tr></table> 3817 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3818 This is a contrast enhancement technique based on the image histogram.</font></td></tr></table> 3819 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3820 When computing the contrast enhancement values, the histogram edges 3821 are truncated so that the majority of the image pixels are considered 3822 in the constrast enhancement, and outliers (e.g. random noise or 3823 minute details) are ignored. The default is that 0.1 percent of the 3824 histogram entries are ignored. The percentage of the histogram to 3825 ignore may be specified by using the <strong>-set</strong> option with the 3826 <strong>histogram-threshold</strong> parameter similar to <strong>-set 3827 histogram-threshold 0.01</strong> to specify 0.01 percent. Use 0 percent 3828 to use the entire histogram, with possibly diminished contrast 3829 enhancement.</font></td></tr></table> 3830 <table BORDER=0 WIDTH="94%"> 3831 <tr> 3832 <td width="3%"><br></td> 3833 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3834 <img SRC="images/right_triangle_option.png" 3835 ALT=">" BORDER=0 height=14 3836 width=15><b><font face="Helvetica, Arial" 3837 ><font color="#00B04F"><font size="+1"> 3838 <a name="details-opaque"></a>-opaque <i><color></i> 3839 </font></font></font></b></td></tr></table> 3840 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>change this color to the pen color within the image</td></tr></table> 3841 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3842 The color is specified using the format described under the 3843 <strong>-fill</strong> option. The color is replaced if it is identical to the 3844 target color, or close enough to the target color in a 3D space as 3845 defined by the Euclidean distance specified by <strong>-fuzz</strong>.</font></td></tr></table> 3846 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3847 See <strong>-fill</strong> and <strong>-fuzz</strong> for more details.</font></td></tr></table> 3848 <table BORDER=0 WIDTH="94%"> 3849 <tr> 3850 <td width="3%"><br></td> 3851 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3852 <img SRC="images/right_triangle_option.png" 3853 ALT=">" BORDER=0 height=14 3854 width=15><b><font face="Helvetica, Arial" 3855 ><font color="#00B04F"><font size="+1"> 3856 <a name="details-operator"></a>-operator <i>channel operator rvalue[%]</i> 3857 </font></font></font></b></td></tr></table> 3858 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a mathematical, bitwise, or value operator to an image channel</td></tr></table> 3859 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3860 Apply a low-level mathematical, bitwise, or value operator to a selected 3861 image channel or all image channels. Operations which result in negative 3862 results are reset to zero, and operations which overflow the available 3863 range are reset to the maximum possible value.</font></td></tr></table> 3864 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3865 Select a channel from: <strong>Red</strong>, <strong>Green</strong>, <strong>Blue</strong>, 3866 <strong>Opacity</strong>, <strong>Matte</strong>, <strong>Cyan</strong>, <strong>Magenta</strong>, <strong>Yellow</strong>, 3867 <strong>Black</strong>, <strong>All</strong>, or <strong>Gray</strong>. <strong>All</strong> only modifies the 3868 color channels and does not modify the <strong>Opacity</strong> channel. Except for 3869 the threshold operators, <strong>All</strong> operates on each channel 3870 independently so that operations are on a per-channel basis.</font></td></tr></table> 3871 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3872 <strong>Gray</strong> treats the color channels as a grayscale intensity and 3873 performs the requested operation on the equivalent pixel intensity so the 3874 result is a gray image.</font></td></tr></table> 3875 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">Select an operator from <strong>Add</strong>, <strong>And</strong>, <strong>Assign</strong>, 3876 <strong>Depth</strong>, <strong>Divide</strong>, <strong>Gamma</strong>, <strong>Negate</strong>, 3877 <strong>LShift</strong>, <strong>Log</strong>, <strong>Max</strong>, <strong>Min</strong>, <strong>Multiply</strong>, 3878 <strong>Or</strong>, <strong>Pow</strong> <strong>RShift</strong>, <strong>Subtract</strong>, 3879 <strong>Threshold</strong>, <strong>Threshold-White</strong>, 3880 <strong>Threshold-White-Negate</strong>, <strong>Threshold-Black</strong>, 3881 <strong>Threshold-Black-Negate</strong>, <strong>Xor</strong>, <strong>Noise-Gaussian</strong>, 3882 <strong>Noise-Impulse</strong>, <strong>Noise-Laplacian</strong>, 3883 <strong>Noise-Multiplicative</strong>, <strong>Noise-Poisson</strong>, 3884 <strong>Noise-Random</strong>, and <strong>Noise-Uniform</strong>.</font></td></tr></table> 3885 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3886 Rvalue may be any floating point or integer value. Normally rvalue will 3887 be in the range of 0 to MaxRGB, where MaxRGB is the largest quantum value 3888 supported by the GraphicsMagick build (255, 65535, or 4294967295) but 3889 values outside this range are useful for some arithmetic operations. 3890 Arguments to logical or bit-wise operations are rounded to a positive 3891 integral value prior to use. If a percent (<strong>%</strong>) symbol is appended 3892 to the argument, then the argument has a range of 0 to 100 percent.</font></td></tr></table> 3893 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3894 The following is a description of the operators:</font></td></tr></table> 3895 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3896 <dl> 3897 <dt>Add</dt> 3898 <dd>Result is rvalue added to channel value. 3899 </dd> 3900 <dt>And</dt> 3901 <dd>Result is the logical AND of rvalue with channel value. 3902 </dd> 3903 <dt>Assign</dt> 3904 <dd>Result is rvalue. 3905 </dd> 3906 <dt>Depth</dt> 3907 <dd>Result is channel value adjusted so that it may be (approximately) 3908 stored in the specified number of bits without additional loss. 3909 </dd> 3910 <dt>Divide</dt> 3911 <dd>Result is channel value divided by rvalue. 3912 </dd> 3913 <dt>Gamma</dt> 3914 <dd>Result is channel value gamma adjusted by rvalue. 3915 </dd> 3916 <dt>LShift</dt> 3917 <dd>Result is channel value bitwise left shifted by rvalue bits. 3918 </dd> 3919 <dt>Log</dt> 3920 <dd>Result is computed as log(value*rvalue+1)/log(rvalue+1). 3921 </dd> 3922 <dt>Max</dt> 3923 <dd>Result is assigned to rvalue if rvalue is greater than value. 3924 </dd> 3925 <dt>Min</dt> 3926 <dd>Result is assigned to rvalue if rvalue is less than value. 3927 </dd> 3928 <dt>Multiply</dt> 3929 <dd>Result is channel value multiplied by rvalue. 3930 </dd> 3931 <dt>Negate</dt> 3932 <dd>Result is inverse of channel value (like a film negative). An rvalue 3933 must be supplied but is currently not used. Inverting the image twice 3934 results in the original image. 3935 </dd> 3936 <dt>Or</dt> 3937 <dd>Result is the logical OR of rvalue with channel value. 3938 </dd> 3939 <dt>Pow</dt> 3940 <dd>Result is computed as pow(value,rvalue). Similar to Gamma except that 3941 rvalue is not inverted. 3942 </dd> 3943 <dt>RShift</dt> 3944 <dd>Result is channel value bitwise right shifted by rvalue bits. 3945 </dd> 3946 <dt>Subtract</dt> 3947 <dd>Result is channel value minus rvalue. 3948 </dd> 3949 <dt>Threshold</dt> 3950 <dd>Result is maximum (white) if channel value is greater than rvalue, 3951 or minimum (black) if it is less than or equal to rvalue. If <strong>all</strong> 3952 channels are specified, then thresholding is done based on computed pixel 3953 intensity. 3954 </dd> 3955 <dt>Threshold-white</dt> 3956 <dd>Result is maximum (white) if channel value is greater than rvalue and 3957 is unchanged if it is less than or equal to rvalue. This can be used to 3958 remove apparent noise from the bright parts of an image. If <strong>all</strong> 3959 channels are specified, then thresholding is done based on computed pixel 3960 intensity. 3961 </dd> 3962 <dt>Threshold-White-Negate</dt> 3963 <dd>Result is set to black if channel value is greater than 3964 rvalue and is unchanged if it is less than or equal to rvalue. If 3965 <strong>all</strong> channels are specified, then thresholding is done based on 3966 computed pixel intensity. 3967 </dd> 3968 <dt>Threshold-black</dt> 3969 <dd>Result is minimum (black) if channel value is less than than rvalue 3970 and is unchanged if it is greater than or equal to rvalue. This can be 3971 used to remove apparent noise from the dark parts of an image. If 3972 <strong>all</strong> channels are specified, then thresholding is done based on 3973 computed pixel intensity. 3974 </dd> 3975 <dt>Threshold-Black-Negate</dt> 3976 <dd>Result is set to white if channel value is less than than 3977 rvalue and is unchanged if it is greater than or equal to rvalue. If 3978 <strong>all</strong> channels are specified, then thresholding is done based on 3979 computed pixel intensity. 3980 </dd> 3981 <dt>Xor</dt> 3982 <dd>Result is the logical XOR of rvalue with channel value. An 3983 interesting property of XOR is that performing the same operation twice 3984 results in the original value. 3985 </dd> 3986 <dt>Noise-Gaussian</dt> 3987 <dd>Result is the current channel value modulated with gaussian noise 3988 according to the intensity specified by rvalue. 3989 </dd> 3990 <dt>Noise-Impulse</dt> 3991 <dd>Result is the current channel value modulated with impulse noise 3992 according to the intensity specified by rvalue. 3993 </dd> 3994 <dt>Noise-Laplacian</dt> 3995 <dd>Result is the current channel value modulated with laplacian noise 3996 according to the intensity specified by rvalue. 3997 </dd> 3998 <dt>Noise-Multiplicative</dt> 3999 <dd>Result is the current channel value modulated with multiplicative 4000 gaussian noise according to the intensity specified by rvalue. 4001 </dd> 4002 <dt>Noise-Poisson</dt> 4003 <dd>Result is the current channel value modulated with poisson noise 4004 according to the intensity specified by rvalue. 4005 </dd> 4006 <dt>Noise-Random</dt> 4007 <dd>Result is the current channel value modulated with random (uniform 4008 distribution) noise according to the intensity specified by rvalue. 4009 The initial noise intensity (rvalue=1.0) is the range of one pixel 4010 quantum span. 4011 </dd> 4012 <dt>Noise-Uniform</dt> 4013 <dd>Result is the channel value with uniform noise applied according to 4014 the intensity specified by rvalue. 4015 </dd> 4016 </dl> 4017 </font></td></tr></table> 4018 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4019 As an example, the <strong>Assign</strong> operator assigns a fixed value to a 4020 channel. For example, this command sets the red channel to the mid-range 4021 value:</font></td></tr></table> 4022 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4023 gm convert in.bmp -operator red assign "50%" out.bmp 4024 </pre></font></td></tr></table> 4025 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4026 The following applies 50% thresholding to the image and returns a gray 4027 image:</font></td></tr></table> 4028 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4029 gm convert in.bmp -operator gray threshold "50%" out.bmp 4030 </pre></font></td></tr></table> 4031 <table BORDER=0 WIDTH="94%"> 4032 <tr> 4033 <td width="3%"><br></td> 4034 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4035 <img SRC="images/right_triangle_option.png" 4036 ALT=">" BORDER=0 height=14 4037 width=15><b><font face="Helvetica, Arial" 4038 ><font color="#00B04F"><font size="+1"> 4039 <a name="details-ordered-dither"></a>-ordered-dither <i><channeltype> <NxN></i> 4040 </font></font></font></b></td></tr></table> 4041 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>ordered dither the image</td></tr></table> 4042 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4043 The channel or channels specified in the <strong>channeltype</strong> argument are 4044 reduced to binary, using an ordered dither method. The choices for 4045 <strong>channeltype</strong> are <strong>All</strong>, <strong>Intensity</strong>, <strong>Red</strong>, 4046 <strong>Green</strong>, <strong>Blue</strong>, <strong>Cyan</strong>, <strong>Magenta</strong>, <strong>Yellow</strong>, 4047 <strong>Black</strong>, and <strong>Opacity</strong></font></td></tr></table> 4048 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4049 When <strong>channeltype</strong> is "All", the color samples are dithered into 4050 a gray level and then that gray level is stored in the three color 4051 channels. Separately, the opacity channel is dithered into a bilevel 4052 opacity value which is stored in the opacity channel.</font></td></tr></table> 4053 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4054 When <strong>channeltype</strong> is "Intensity", only the color samples are 4055 dithered. When <strong>channeltype</strong> is "opacity" or "matte", only the 4056 opacity channel is dithered. When a color channel is specified, only that 4057 channel is dithered.</font></td></tr></table> 4058 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4059 The choices for N are 2 through 7. The image is divided into 4060 NxN pixel tiles. In each tile, some or all pixels are turned to 4061 white depending on their intensity. For each N, (N**2)+1 levels 4062 of gray can be represented. For N == 2, 3, or 4, the pixels 4063 are turned to white in an order that maximizes dispersion (i.e., 4064 reduces granularity), while 4065 for N == 5, 6, and 7, they are turned to white in an order that 4066 creates a roughly circular black blob in the middle of each tile. 4067 An attractive "half-tone" looking image can be obtained by first 4068 rotating the image 45 degrees, performing a 5x5 ordered-dither 4069 operation, then rotating it back to the original orientation and 4070 cropping to the original image dimensions. If the original image 4071 is gamma-encoded, it is adviseable to convert it to linear intensity 4072 first, e.g., with the "-gamma 0.45455" option.</font></td></tr></table> 4073 <table BORDER=0 WIDTH="94%"> 4074 <tr> 4075 <td width="3%"><br></td> 4076 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4077 <img SRC="images/right_triangle_option.png" 4078 ALT=">" BORDER=0 height=14 4079 width=15><b><font face="Helvetica, Arial" 4080 ><font color="#00B04F"><font size="+1"> 4081 <a name="details-output-directory"></a>-output-directory <i><directory></i> 4082 </font></font></font></b></td></tr></table> 4083 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>output files to directory</td></tr></table> 4084 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4085 Use -output-directory to specify a directory under which to write the 4086 output files. Normally mogrify overwrites the input files, but with 4087 this option the output files may be written to a different directory 4088 tree so that the input files are preserved. The algorithm used 4089 preserves all of the input path specification in the output path so 4090 that the user-specified input path (including any sub-directory part) 4091 is appended to the output path. If the input file lacks an extension, 4092 then a suitable extension is automatically added to the output file. 4093 The user is responsible for creating the output directory specified as 4094 an argument, but subdirectories will be created as needed if the 4095 <strong>-create-directories</strong> option is supplied. This option may be 4096 used to apply transformations on files from one directory and write 4097 the transformed files to a different directory. In conjunction with 4098 <strong>-create-directories</strong>, this option is designed to support 4099 transforming whole directory trees of files provided that the relative 4100 path of the input file is included as part the list of filenames.</font></td></tr></table> 4101 <table BORDER=0 WIDTH="94%"> 4102 <tr> 4103 <td width="3%"><br></td> 4104 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4105 <img SRC="images/right_triangle_option.png" 4106 ALT=">" BORDER=0 height=14 4107 width=15><b><font face="Helvetica, Arial" 4108 ><font color="#00B04F"><font size="+1"> 4109 <a name="details-orient"></a>-orient <i><orientation></i> 4110 </font></font></font></b></td></tr></table> 4111 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Set the image orientation attribute</td></tr></table> 4112 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4113 Sets the image orientation attribute. The image orientation attribute 4114 is compatible with the TIFF orientation tag (and the EXIF orientation 4115 tag). Accepted values are <strong>undefined</strong>, <strong>TopLeft</strong>, 4116 <strong>TopRight</strong>, <strong>BottomRight</strong>, <strong>BottomLeft</strong>, 4117 <strong>LeftTop</strong>, <strong>RightTop</strong>, <strong>RightBottom</strong>, 4118 <strong>LeftBottom</strong>, and hyphenated versions thereof 4119 (e.g. <strong>left-bottom</strong>). Please note that GraphicsMagick does not 4120 include an EXIF editor so if an EXIF profile is written to the output 4121 image, the value in the EXIF profile might not match the image. It is 4122 possible for an image file to indicate its orientation in several 4123 different ways simultaneously.</font></td></tr></table> 4124 <table BORDER=0 WIDTH="94%"> 4125 <tr> 4126 <td width="3%"><br></td> 4127 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4128 <img SRC="images/right_triangle_option.png" 4129 ALT=">" BORDER=0 height=14 4130 width=15><b><font face="Helvetica, Arial" 4131 ><font color="#00B04F"><font size="+1"> 4132 <a name="details-page"></a>-page <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 4133 </font></font></font></b></td></tr></table> 4134 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>size and location of an image canvas</td></tr></table> 4135 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4136 Use this option to specify the dimensions of the 4137 <em>PostScript</em> page 4138 in dots per inch or a TEXT page in pixels. The choices for a PostScript 4139 page are:</font></td></tr></table> 4140 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4141 11x17 792 1224 4142 Ledger 1224 792 4143 Legal 612 1008 4144 Letter 612 792 4145 LetterSmall 612 792 4146 ArchE 2592 3456 4147 ArchD 1728 2592 4148 ArchC 1296 1728 4149 ArchB 864 1296 4150 ArchA 648 864 4151 A0 2380 3368 4152 A1 1684 2380 4153 A2 1190 1684 4154 A3 842 1190 4155 A4 595 842 4156 A4Small 595 842 4157 A5 421 595 4158 A6 297 421 4159 A7 210 297 4160 A8 148 210 4161 A9 105 148 4162 A10 74 105 4163 B0 2836 4008 4164 B1 2004 2836 4165 B2 1418 2004 4166 B3 1002 1418 4167 B4 709 1002 4168 B5 501 709 4169 C0 2600 3677 4170 C1 1837 2600 4171 C2 1298 1837 4172 C3 918 1298 4173 C4 649 918 4174 C5 459 649 4175 C6 323 459 4176 Flsa 612 936 4177 Flse 612 936 4178 HalfLetter 396 612 4179 </pre></font></td></tr></table> 4180 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4181 For convenience you can specify the page size by media (e.g. A4, Ledger, 4182 etc.). Otherwise, <strong>-page</strong> behaves much like 4183 <strong>-geometry</strong> (e.g. <tt>-page letter+43+43></tt>).</font></td></tr></table> 4184 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4185 This option is also used to place subimages when writing to a multi-image 4186 format that supports offsets, such as GIF89 and MNG. When used for this 4187 purpose the offsets are always measured from the 4188 top left corner of the canvas and are not affected by the <strong>-gravity</strong> 4189 option. 4190 To position a GIF or MNG image, use <strong>-page</strong><em>{+-}<x>{+-}<y></em> 4191 (e.g. -page +100+200). When writing to a MNG file, a <strong>-page</strong> 4192 option appearing ahead of the first image in the sequence with nonzero 4193 width and height defines the width and height values that are written in 4194 the <strong>MHDR</strong> chunk. Otherwise, the MNG width and height are computed 4195 from the bounding box that contains all images in the sequence. When 4196 writing a GIF89 file, only the bounding box method is used to determine its 4197 dimensions.</font></td></tr></table> 4198 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4199 For a PostScript page, the image is sized as in <strong>-geometry</strong> and positioned 4200 relative to the lower left hand corner of the page by 4201 {+-}<<strong>x</strong><em>offset</em>>{+-}<<strong>y</strong> 4202 <em>offset></em>. Use 4203 <tt>-page 612x792></tt>, for example, to center the 4204 image within the page. If the image size exceeds the PostScript page, it 4205 is reduced to fit the page. 4206 The default gravity for the <strong>-page</strong> 4207 option is <em>NorthWest</em>, i.e., positive <strong>x</strong> and 4208 <strong>y</strong> <em>offset</em> are measured rightward and downward from the top 4209 left corner of the page, unless the <strong>-gravity</strong> option is present with 4210 a value other than <em>NorthWest</em>.</font></td></tr></table> 4211 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4212 The default page dimensions for a TEXT image is 612x792.</font></td></tr></table> 4213 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4214 This option is used in concert with <strong>-density</strong>.</font></td></tr></table> 4215 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4216 Use <strong>+page</strong> to remove the page settings for an image.</font></td></tr></table> 4217 <table BORDER=0 WIDTH="94%"> 4218 <tr> 4219 <td width="3%"><br></td> 4220 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4221 <img SRC="images/right_triangle_option.png" 4222 ALT=">" BORDER=0 height=14 4223 width=15><b><font face="Helvetica, Arial" 4224 ><font color="#00B04F"><font size="+1"> 4225 <a name="details-paint"></a>-paint <i><radius></i> 4226 </font></font></font></b></td></tr></table> 4227 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>simulate an oil painting</td></tr></table> 4228 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4229 Each pixel is replaced by the most frequent color in a circular neighborhood 4230 whose width is specified with <em>radius</em>.</font></td></tr></table> 4231 <table BORDER=0 WIDTH="94%"> 4232 <tr> 4233 <td width="3%"><br></td> 4234 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4235 <img SRC="images/right_triangle_option.png" 4236 ALT=">" BORDER=0 height=14 4237 width=15><b><font face="Helvetica, Arial" 4238 ><font color="#00B04F"><font size="+1"> 4239 <a name="details-pause"></a>-pause <i><seconds></i> 4240 </font></font></font></b></td></tr></table> 4241 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pause between animation loops [animate]</td></tr></table> 4242 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4243 Pause for the specified number of seconds before repeating the 4244 animation.</font></td></tr></table> 4245 <table BORDER=0 WIDTH="94%"> 4246 <tr> 4247 <td width="3%"><br></td> 4248 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4249 <img SRC="images/right_triangle_option.png" 4250 ALT=">" BORDER=0 height=14 4251 width=15><b><font face="Helvetica, Arial" 4252 ><font color="#00B04F"><font size="+1"> 4253 <a name="details-pause"></a>-pause <i><seconds></i> 4254 </font></font></font></b></td></tr></table> 4255 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pause between snapshots [import]</td></tr></table> 4256 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4257 Pause for the specified number of seconds before taking the next 4258 snapshot.</font></td></tr></table> 4259 <table BORDER=0 WIDTH="94%"> 4260 <tr> 4261 <td width="3%"><br></td> 4262 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4263 <img SRC="images/right_triangle_option.png" 4264 ALT=">" BORDER=0 height=14 4265 width=15><b><font face="Helvetica, Arial" 4266 ><font color="#00B04F"><font size="+1"> 4267 <a name="details-pen"></a>-pen <i><color></i> 4268 </font></font></font></b></td></tr></table> 4269 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -fill option)</td></tr></table> 4270 <table BORDER=0 WIDTH="94%"> 4271 <tr> 4272 <td width="3%"><br></td> 4273 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4274 <img SRC="images/right_triangle_option.png" 4275 ALT=">" BORDER=0 height=14 4276 width=15><b><font face="Helvetica, Arial" 4277 ><font color="#00B04F"><font size="+1"> 4278 -ping 4279 </font></font></font></b></td></tr></table> 4280 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>efficiently determine image characteristics</td></tr></table> 4281 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4282 Use this option to disable reading the image pixels so that image 4283 characteristics such as the image dimensions may be obtained very 4284 quickly. For identify, use +ping to force reading the image pixels so 4285 that the pixel read rate may be included in the displayed information.</font></td></tr></table> 4286 <table BORDER=0 WIDTH="94%"> 4287 <tr> 4288 <td width="3%"><br></td> 4289 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4290 <img SRC="images/right_triangle_option.png" 4291 ALT=">" BORDER=0 height=14 4292 width=15><b><font face="Helvetica, Arial" 4293 ><font color="#00B04F"><font size="+1"> 4294 -pointsize <i><value></i> 4295 </font></font></font></b></td></tr></table> 4296 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pointsize of the PostScript, X11, or TrueType font</td></tr></table> 4297 <table BORDER=0 WIDTH="94%"> 4298 <tr> 4299 <td width="3%"><br></td> 4300 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4301 <img SRC="images/right_triangle_option.png" 4302 ALT=">" BORDER=0 height=14 4303 width=15><b><font face="Helvetica, Arial" 4304 ><font color="#00B04F"><font size="+1"> 4305 <a name="details-preview"></a>-preview <i><type></i> 4306 </font></font></font></b></td></tr></table> 4307 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>image preview type</td></tr></table> 4308 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4309 Use this option to affect the preview operation of an image (e.g. 4310 <tt>convert file.png -preview Gamma Preview:gamma.png</tt>). Choose 4311 from these previews:</font></td></tr></table> 4312 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4313 Rotate 4314 Shear 4315 Roll 4316 Hue 4317 Saturation 4318 Brightness 4319 Gamma 4320 Spiff 4321 Dull 4322 Grayscale 4323 Quantize 4324 Despeckle 4325 ReduceNoise 4326 AddNoise 4327 Sharpen 4328 Blur 4329 Threshold 4330 EdgeDetect 4331 Spread 4332 Shade 4333 Raise 4334 Segment 4335 Solarize 4336 Swirl 4337 Implode 4338 Wave 4339 OilPaint 4340 CharcoalDrawing 4341 JPEG 4342 </pre></font></td></tr></table> 4343 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4344 The default preview is <strong>JPEG</strong>.</font></td></tr></table> 4345 <table BORDER=0 WIDTH="94%"> 4346 <tr> 4347 <td width="3%"><br></td> 4348 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4349 <img SRC="images/right_triangle_option.png" 4350 ALT=">" BORDER=0 height=14 4351 width=15><b><font face="Helvetica, Arial" 4352 ><font color="#00B04F"><font size="+1"> 4353 <a name="details-process"></a>-process <i><command></i> 4354 </font></font></font></b></td></tr></table> 4355 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>process a sequence of images using a process module</td></tr></table> 4356 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4357 The command argument has the form <strong>module=arg1,arg2,arg3,...,argN</strong> 4358 where <strong>module</strong> is the name of the module to invoke (e.g. "analyze") 4359 and arg1,arg2,arg3,...,argN are an arbitrary number of arguments to 4360 pass to the process module.</font></td></tr></table><table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4361 The sequence of images 4362 is terminated by the appearance of any option.</font></td></tr></table> 4363 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4364 If the <strong>-process</strong> 4365 option appears after all of the input images, all images are processed.</font></td></tr></table> 4366 <table BORDER=0 WIDTH="94%"> 4367 <tr> 4368 <td width="3%"><br></td> 4369 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4370 <img SRC="images/right_triangle_option.png" 4371 ALT=">" BORDER=0 height=14 4372 width=15><b><font face="Helvetica, Arial" 4373 ><font color="#00B04F"><font size="+1"> 4374 <a name="details-profile"></a>-profile <i><filename></i> 4375 </font></font></font></b></td></tr></table> 4376 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add ICM, IPTC, or generic profile to image</td></tr></table> 4377 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4378 <tt>-profile filename</tt> adds an ICM (ICC color management), IPTC 4379 (newswire information), or a generic (including Exif) profile to the image 4380 </font></td></tr></table>. 4381 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4382 Use <tt>+profile icm</tt>, <tt>+profile iptc</tt>, or 4383 <tt>+profile profile_name</tt> to remove the respective profile. 4384 Multiple profiles may be listed, separated by commas. Profiles may be 4385 excluded from subsequent listed matches by preceding their name with 4386 an exclamation point. For example, <tt>+profile '!icm,*'</tt> strips 4387 all profiles except for the ICM profile. Use <tt>identify 4388 -verbose</tt> to find out what profiles are in the image file. Use 4389 <tt>+profile "*"</tt> to remove all profiles.</font></td></tr></table> 4390 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">Writing the image to a format that does not support profiles will 4391 of course also cause all profiles to be removed. The JPEG and PNG 4392 formats will store any profiles that have been read and not removed. 4393 In JPEG they are stored in APP1 markers, and in PNG they are stored 4394 as hex-coded binary in compressed zTXt chunks, except for the iCC 4395 chunk which is stored in the iCCP chunk.</font></td></tr></table> 4396 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4397 To extract a profile, the <strong>-profile</strong> option is not used. Instead, 4398 simply write the file to an image 4399 format such as <em>APP1, 8BIM, ICM,</em> or <em>IPTC</em>.</font></td></tr></table> 4400 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4401 For example, to extract the Exif data (which is stored in JPEG files 4402 in the <em>APP1</em> profile), use 4403 </font></td></tr></table> 4404 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4405 gm convert cockatoo.jpg exifdata.app1 4406 </pre></font></td></tr></table> 4407 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">Note that GraphicsMagick does not attempt to update any profile to 4408 reflect changes made to the image, e.g., rotation from portrait to landscape 4409 orientation, so it is possible that the preserved profile may contain 4410 invalid data.</font></td></tr></table> 4411 <table BORDER=0 WIDTH="94%"> 4412 <tr> 4413 <td width="3%"><br></td> 4414 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4415 <img SRC="images/right_triangle_option.png" 4416 ALT=">" BORDER=0 height=14 4417 width=15><b><font face="Helvetica, Arial" 4418 ><font color="#00B04F"><font size="+1"> 4419 <a name="details-preserve-timestamp"></a>-preserve-timestamp 4420 </font></font></font></b></td></tr></table> 4421 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preserve the original timestamps of the file</td></tr></table> 4422 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4423 Use this option to preserve the original modification and access 4424 timestamps of the file, even if it has been modified.</font></td></tr></table> 4425 <table BORDER=0 WIDTH="94%"> 4426 <tr> 4427 <td width="3%"><br></td> 4428 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4429 <img SRC="images/right_triangle_option.png" 4430 ALT=">" BORDER=0 height=14 4431 width=15><b><font face="Helvetica, Arial" 4432 ><font color="#00B04F"><font size="+1"> 4433 <a name="details+progress"></a>+progress 4434 </font></font></font></b></td></tr></table> 4435 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>disable progress monitor and busy cursor</td></tr></table> 4436 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4437 By default, when an image is displayed, a progress monitor bar is shown 4438 in the top left corner of an existing image display window, and the 4439 current cursor is replaced with an hourglass cursor. Use <strong>+progress</strong> 4440 to disable the progress monitor and busy cursor during display operations. 4441 While the progress monitor is disabled for all operations, the busy 4442 cursor continues to be enabled for non-display operations such as image 4443 processing. This option is useful for non-interactive display operations, 4444 or when a "clean" look is desired.</font></td></tr></table> 4445 <table BORDER=0 WIDTH="94%"> 4446 <tr> 4447 <td width="3%"><br></td> 4448 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4449 <img SRC="images/right_triangle_option.png" 4450 ALT=">" BORDER=0 height=14 4451 width=15><b><font face="Helvetica, Arial" 4452 ><font color="#00B04F"><font size="+1"> 4453 <a name="details-quality"></a>-quality <i><value></i> 4454 </font></font></font></b></td></tr></table> 4455 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>JPEG/MIFF/PNG/TIFF compression level</td></tr></table> 4456 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> For the JPEG and MPEG image formats, quality is 0 (lowest image 4457 quality and highest compression) to 100 (best quality but least 4458 effective compression). The default quality is 75. Use the 4459 <strong>-sampling-factor</strong> option to specify the factors for chroma 4460 downsampling. To use the same quality value as that found by the JPEG 4461 decoder, use the <tt>-define jpeg:preserve-settings</tt> flag.</font></td></tr></table> 4462 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4463 For the MIFF image format, and the TIFF format while using ZIP 4464 compression, quality/10 is the zlib compression level, which is 0 (worst 4465 but fastest compression) to 9 (best but slowest). It has no effect on the 4466 image appearance, since the compression is always lossless.</font></td></tr></table> 4467 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4468 For the JPEG-2000 image format, quality is mapped using a non-linear 4469 equation to the compression ratio required by the Jasper library. This 4470 non-linear equation is intended to loosely approximate the quality 4471 provided by the JPEG v1 format. The default quality value 75 results in 4472 a request for 16:1 compression. The quality value 100 results in 4473 a request for non-lossy compression.</font></td></tr></table> 4474 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4475 For the MNG and PNG image formats, the quality value sets the zlib compression 4476 level (quality / 10) and filter-type (quality % 10). Compression levels 4477 range from 0 (fastest compression) to 100 (best but slowest). For compression 4478 level 0, the Huffman-only strategy is used, which is fastest but not 4479 necessarily the worst compression.</font></td></tr></table> 4480 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4481 If 4482 filter-type is 4 or less, the specified filter-type is used for all scanlines:</font></td></tr></table> 4483 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4484 0: none 4485 1: sub 4486 2: up 4487 3: average 4488 4: Paeth 4489 </pre></font></td></tr></table> 4490 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4491 If filter-type is 5, adaptive filtering is used when quality is greater 4492 than 50 and the image does not have a color map, otherwise no filtering 4493 is used.</font></td></tr></table> 4494 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4495 If filter-type is 6, adaptive filtering 4496 with <em>minimum-sum-of-absolute-values</em> 4497 is used.</font></td></tr></table> 4498 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4499 Only if the output is MNG, if filter-type is 7, the LOCO color transformation 4500 and adaptive filtering with <em>minimum-sum-of-absolute-values</em> 4501 are used.</font></td></tr></table> 4502 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4503 The default is quality is 75, which means nearly the best compression with 4504 adaptive filtering. The quality setting has no effect on the appearance 4505 of PNG and MNG images, since the compression is always lossless.</font></td></tr></table> 4506 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4507 For further information, see the <a href="http://www.w3.org/TR/">PNG</a> 4508 specification.</font></td></tr></table> 4509 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4510 When writing a JNG image with transparency, two quality values are required, 4511 one for the main image and one for the grayscale image that conveys the 4512 opacity channel. These are written as a single integer equal to the main 4513 image quality plus 1000 times the opacity quality. For example, if you 4514 want to use quality 75 for the main image and quality 90 to compress 4515 the opacity data, use <tt>-quality 90075</tt>.</font></td></tr></table> 4516 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4517 For the PNM family of formats (PNM, PGM, and PPM) specify a quality 4518 factor of zero in order to obtain the ASCII variant of the format. Note 4519 that -compress <em>none</em> used to be used to trigger ASCII output but 4520 provided the opposite result of what was expected as compared with other 4521 formats.</font></td></tr></table> 4522 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4523 For the TIFF format, the JPEG, WebP, Zip, and Zstd compression 4524 algorithms are influenced by the quality value. JPEG and WebP provide 4525 lossy compression so higher quality produces a larger file with less 4526 degradation. The Zip and Zstd compression algorithms (and WebP in 4527 lossless mode) are lossless and for these algorithms a higher 4528 'quality' means to work harder to produce a smaller file, but with no 4529 difference in image quality.</font></td></tr></table> 4530 <table BORDER=0 WIDTH="94%"> 4531 <tr> 4532 <td width="3%"><br></td> 4533 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4534 <img SRC="images/right_triangle_option.png" 4535 ALT=">" BORDER=0 height=14 4536 width=15><b><font face="Helvetica, Arial" 4537 ><font color="#00B04F"><font size="+1"> 4538 <a name="details-raise"></a>-raise <i><width>x<height></i> 4539 </font></font></font></b></td></tr></table> 4540 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>lighten or darken image edges</td></tr></table> 4541 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4542 This will create a 3-D effect. See <strong>-geometry</strong> for details 4543 details about the geometry specification. Offsets are not used.</font></td></tr></table> 4544 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4545 Use <strong>-raise</strong> to create a raised effect, otherwise use <strong>+raise</strong>.</font></td></tr></table> 4546 <table BORDER=0 WIDTH="94%"> 4547 <tr> 4548 <td width="3%"><br></td> 4549 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4550 <img SRC="images/right_triangle_option.png" 4551 ALT=">" BORDER=0 height=14 4552 width=15><b><font face="Helvetica, Arial" 4553 ><font color="#00B04F"><font size="+1"> 4554 <a name="details-random-threshold"></a>-random-threshold <i><channeltype> <LOWxHIGH></i> 4555 </font></font></font></b></td></tr></table> 4556 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>random threshold the image</td></tr></table> 4557 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4558 The channel or channels specified in the <channeltype> argument are 4559 reduced to binary, using an random-threshold method. The choices for 4560 <strong>channeltype</strong> are <strong>All</strong>, <strong>Intensity</strong>, <strong>Red</strong>, 4561 <strong>Green</strong>, <strong>Blue</strong>, <strong>Cyan</strong>, <strong>Magenta</strong>, <strong>Yellow</strong>, 4562 <strong>Black</strong>, and <strong>Opacity</strong></font></td></tr></table> 4563 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4564 When <strong>channeltype</strong> is "All", the color samples are thresholded into 4565 a graylevel and then that gray level is stored in the three color 4566 channels. Separately, the opacity channel is thresholded into a bilevel 4567 opacity value which is stored in the opacity channel. For each pixel, a 4568 new random number is used to establish the threshold to be used. The 4569 threshold never exceeds the specified maximum (HIGH) and is never less 4570 than the specified minimum (LOW).</font></td></tr></table> 4571 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4572 When <strong>channeltype</strong> is "intensity", only the color samples are 4573 thresholded. When <strong>channeltype</strong> is "opacity" or "matte", only the 4574 opacity channel is thresholded. The other named channels only threshold 4575 the associated channel.</font></td></tr></table> 4576 <table BORDER=0 WIDTH="94%"> 4577 <tr> 4578 <td width="3%"><br></td> 4579 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4580 <img SRC="images/right_triangle_option.png" 4581 ALT=">" BORDER=0 height=14 4582 width=15><b><font face="Helvetica, Arial" 4583 ><font color="#00B04F"><font size="+1"> 4584 <a name="details-recolor"></a>-recolor <i><matrix></i> 4585 </font></font></font></b></td></tr></table> 4586 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a color translation matrix to image channels</td></tr></table> 4587 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4588 A user supplied color translation matrix (expressed as a text string) 4589 is used to translate/blend the image channels based on weightings in a 4590 supplied matrix which may be of order 3 (color channels only), 4 4591 (color channels plus opacity), or 5 (color channels plus opacity and 4592 offset). Values in the columns of the matrix (red, green, blue, 4593 opacity) are used as multipliers with the existing channel values and 4594 added together according to the rows of the matrix. Matrix values are 4595 floating point and may be negative. The offset column (column 5) is 4596 purely additive and is scaled such that 0.0 to 1.0 represents the 4597 maximum quantum range (but values are not limited to this range). The 4598 math for the color translation matrix is similar to that used by Adobe 4599 Flash except that the offset is scaled to 1.0 (divide Flash offset by 4600 255 for use with GraphicsMagick) so that the results are independent 4601 of quantum depth.</font></td></tr></table> 4602 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4603 An <strong>identity</strong> matrix exists for each matrix order which 4604 results in no change to the image. The translation matrix should be 4605 based on an alteration of the identity matrix.</font></td></tr></table> 4606 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4607 Identity matrix of order 3</font></td></tr></table> 4608 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4609 1 0 0 4610 0 1 0 4611 0 0 1 4612 </pre></font></td></tr></table> 4613 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4614 which may be formatted into a convenient matrix argument similar to 4615 (comma is treated as white space):</font></td></tr></table> 4616 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4617 -recolor "1 0 0, 0 1 0, 0 0 1" 4618 </pre></font></td></tr></table> 4619 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4620 Identity matrix of order 4</font></td></tr></table> 4621 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4622 1 0 0 0 4623 0 1 0 0 4624 0 0 1 0 4625 0 0 0 1 4626 </pre></font></td></tr></table> 4627 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4628 Identity matrix of order 5. The last row is required to exist 4629 for the purpose of parsing, but is otherwise not used.</font></td></tr></table> 4630 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4631 1 0 0 0 0 4632 0 1 0 0 0 4633 0 0 1 0 0 4634 0 0 0 1 0 4635 0 0 0 0 1 4636 </pre></font></td></tr></table> 4637 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4638 As an example, an image wrongly in BGR channel order may be converted 4639 to RGB using this matrix (blue->red, red->blue):</font></td></tr></table> 4640 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4641 0 0 1 4642 0 1 0 4643 1 0 0 4644 </pre></font></td></tr></table> 4645 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4646 and an RGB image using standard Rec.709 primaries may be converted 4647 to grayscale using this matrix of standard weighting factors:</font></td></tr></table> 4648 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4649 0.2126 0.7152 0.0722 4650 0.2126 0.7152 0.0722 4651 0.2126 0.7152 0.0722 4652 </pre></font></td></tr></table> 4653 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4654 and contrast may be reduced by scaling down by 80% and adding a 10% 4655 offset:</font></td></tr></table> 4656 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4657 0.8 0.0 0.0 0.0 0.1 4658 0.0 0.8 0.0 0.0 0.1 4659 0.0 0.0 0.8 0.0 0.1 4660 0.0 0.0 0.0 0.8 0.1 4661 0.0 0.0 0.0 0.0 1.0 4662 </pre></font></td></tr></table> 4663 <table BORDER=0 WIDTH="94%"> 4664 <tr> 4665 <td width="3%"><br></td> 4666 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4667 <img SRC="images/right_triangle_option.png" 4668 ALT=">" BORDER=0 height=14 4669 width=15><b><font face="Helvetica, Arial" 4670 ><font color="#00B04F"><font size="+1"> 4671 <a name="details-red-primary"></a>-red-primary <i><x>,<y></i> 4672 </font></font></font></b></td></tr></table> 4673 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>red chromaticity primary point</td></tr></table> 4674 <table BORDER=0 WIDTH="94%"> 4675 <tr> 4676 <td width="3%"><br></td> 4677 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4678 <img SRC="images/right_triangle_option.png" 4679 ALT=">" BORDER=0 height=14 4680 width=15><b><font face="Helvetica, Arial" 4681 ><font color="#00B04F"><font size="+1"> 4682 <a name="details-region"></a>-region <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i> 4683 </font></font></font></b></td></tr></table> 4684 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply options to a portion of the image</td></tr></table> 4685 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4686 The <em>x</em> and <em>y</em> offsets are treated in the same manner as in <strong>-crop</strong></font></td></tr></table>. 4687 <table BORDER=0 WIDTH="94%"> 4688 <tr> 4689 <td width="3%"><br></td> 4690 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4691 <img SRC="images/right_triangle_option.png" 4692 ALT=">" BORDER=0 height=14 4693 width=15><b><font face="Helvetica, Arial" 4694 ><font color="#00B04F"><font size="+1"> 4695 <a name="details-remote"></a>-remote 4696 </font></font></font></b></td></tr></table> 4697 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform a X11 remote operation</td></tr></table> 4698 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4699 The <strong>-remote</strong> command sends a command to a "gm display" or "gm 4700 animate" which is already running. The only command recognized at this 4701 time is the name of an image file to load. This capability is very 4702 useful to load new images without needing to restart GraphicsMagick 4703 (e.g. for a slide-show or to use GraphicsMagick as the display engine 4704 for a different GUI). Also see the <strong>+progress</strong> option for a way 4705 to disable progress indication for a clean look while loading new images.</font></td></tr></table> 4706 <table BORDER=0 WIDTH="94%"> 4707 <tr> 4708 <td width="3%"><br></td> 4709 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4710 <img SRC="images/right_triangle_option.png" 4711 ALT=">" BORDER=0 height=14 4712 width=15><b><font face="Helvetica, Arial" 4713 ><font color="#00B04F"><font size="+1"> 4714 <a name="details-render"></a>-render 4715 </font></font></font></b></td></tr></table> 4716 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>render vector operations</td></tr></table> 4717 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4718 Use <strong>+render</strong> to turn off rendering vector operations. This is 4719 useful when saving the result to vector formats such as MVG or SVG.</font></td></tr></table> 4720 <table BORDER=0 WIDTH="94%"> 4721 <tr> 4722 <td width="3%"><br></td> 4723 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4724 <img SRC="images/right_triangle_option.png" 4725 ALT=">" BORDER=0 height=14 4726 width=15><b><font face="Helvetica, Arial" 4727 ><font color="#00B04F"><font size="+1"> 4728 <a name="details-repage"></a>-repage <i> <width>x<height>+xoff+yoff[!]</i> 4729 </font></font></font></b></td></tr></table> 4730 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Adjust image page offsets</td></tr></table> 4731 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4732 Adjust the current image page canvas and position based on a relative 4733 page specification. This option may be used to change the location of 4734 a subframe (e.g. part of an animation) prior to composition. If the 4735 geometry specification is absolute (includes a '!'), then the offset 4736 adjustment is absolute and there is no adjustment to page width and 4737 height, otherwise the page width and height values are also adjusted 4738 based on the current image dimensions. Use <strong>+repage</strong> to set the 4739 image page offsets to default.</font></td></tr></table> 4740 <table BORDER=0 WIDTH="94%"> 4741 <tr> 4742 <td width="3%"><br></td> 4743 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4744 <img SRC="images/right_triangle_option.png" 4745 ALT=">" BORDER=0 height=14 4746 width=15><b><font face="Helvetica, Arial" 4747 ><font color="#00B04F"><font size="+1"> 4748 <a name="details-resample"></a>-resample <i><horizontal>x<vertical></i> 4749 </font></font></font></b></td></tr></table> 4750 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Resample image to specified horizontal and vertical resolution</td></tr></table> 4751 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4752 Resize the image so that its rendered size remains the same as the 4753 original at the specified target resolution. Either the current image 4754 resolution units or the previously set with <strong>-units</strong> are used to 4755 interpret the argument. For example, if a 300 DPI image renders at 3 4756 inches by 2 inches on a 300 DPI device, when the image has been 4757 resampled to 72 DPI, it will render at 3 inches by 2 inches on a 72 4758 DPI device. Note that only a small number of image formats 4759 (e.g. JPEG, PNG, and TIFF) are capable of storing the image 4760 resolution. For formats which do not support an image resolution, the 4761 original resolution of the image must be specified via <strong>-density</strong> 4762 on the command line prior to specifying the resample resolution.</font></td></tr></table> 4763 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4764 Note that Photoshop stores and obtains image resolution from a 4765 proprietary embedded profile. If this profile exists in the image, 4766 then Photoshop will continue to treat the image using its former 4767 resolution, ignoring the image resolution specified in the standard 4768 file header.</font></td></tr></table> 4769 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4770 Some image formats (e.g. PNG) require use of metric or english units 4771 so even if the original image used a particular unit system, if it is 4772 saved to a different format prior to resampling, then it may be 4773 necessary to specify the desired resolution units using <strong>-units</strong> 4774 since the original units may have been lost. In other words, do not 4775 assume that the resolution units are restored if the image has been 4776 saved to a file.</font></td></tr></table> 4777 <table BORDER=0 WIDTH="94%"> 4778 <tr> 4779 <td width="3%"><br></td> 4780 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4781 <img SRC="images/right_triangle_option.png" 4782 ALT=">" BORDER=0 height=14 4783 width=15><b><font face="Helvetica, Arial" 4784 ><font color="#00B04F"><font size="+1"> 4785 <a name="details-resize"></a>-resize <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 4786 </font></font></font></b></td></tr></table> 4787 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image</td></tr></table> 4788 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4789 This is an alias for the <strong>-geometry</strong> option and it behaves in the 4790 same manner. If the <strong>-filter</strong> option precedes the <strong>-resize</strong> 4791 option, the specified filter is used.</font></td></tr></table> 4792 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4793 There are some exceptions:</font></td></tr></table> 4794 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4795 When used as a <em>composite</em> option, <strong>-resize</strong> conveys the 4796 preferred size of the output image, while <strong>-geometry</strong> conveys the 4797 size and placement of the <em>composite image</em> within the main 4798 image.</font></td></tr></table> 4799 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4800 When used as a <em>montage</em> option, <strong>-resize</strong> conveys the preferred 4801 size of the montage, while <strong>-geometry</strong> conveys 4802 information about the tiles.</font></td></tr></table> 4803 <table BORDER=0 WIDTH="94%"> 4804 <tr> 4805 <td width="3%"><br></td> 4806 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4807 <img SRC="images/right_triangle_option.png" 4808 ALT=">" BORDER=0 height=14 4809 width=15><b><font face="Helvetica, Arial" 4810 ><font color="#00B04F"><font size="+1"> 4811 <a name="details-roll"></a>-roll <i></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i> 4812 </font></font></font></b></td></tr></table> 4813 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>roll an image vertically or horizontally</td></tr></table> 4814 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4815 See <strong>-geometry</strong> for details the geometry specification. The 4816 <em>x</em> and <em>y</em> offsets are not affected by the <strong>-gravity</strong> 4817 option.</font></td></tr></table> 4818 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4819 A negative <em>x</em> offset rolls the image left-to-right. A negative 4820 <em>y</em> offset rolls the image top-to-bottom.</font></td></tr></table> 4821 <table BORDER=0 WIDTH="94%"> 4822 <tr> 4823 <td width="3%"><br></td> 4824 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4825 <img SRC="images/right_triangle_option.png" 4826 ALT=">" BORDER=0 height=14 4827 width=15><b><font face="Helvetica, Arial" 4828 ><font color="#00B04F"><font size="+1"> 4829 <a name="details-rotate"></a>-rotate <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 4830 </font></font></font></b></td></tr></table> 4831 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>rotate the image</td></tr></table> 4832 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4833 Positive angles rotate the image in a clockwise direction while 4834 negative angles rotate counter-clockwise.</font></td></tr></table> 4835 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4836 Use <tt>></tt> to rotate the image only if its width exceeds the 4837 height. <tt><</tt> rotates the image <em>only</em> if its width is less 4838 than the height. For example, if you specify <tt>-rotate "-90>"</tt> 4839 and the image size is 480x640, the image is not rotated. However, if 4840 the image is 640x480, it is rotated by -90 degrees. If you use 4841 <tt>></tt> or <tt><</tt>, enclose it in quotation marks to prevent it 4842 from being misinterpreted as a file redirection.</font></td></tr></table> 4843 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4844 Empty triangles left over from rotating the image are filled with the 4845 color defined as <strong>background</strong> (class <strong>backgroundColor</strong>). 4846 The color is specified using the format described under the 4847 <strong>-fill</strong> option.</font></td></tr></table> 4848 <table BORDER=0 WIDTH="94%"> 4849 <tr> 4850 <td width="3%"><br></td> 4851 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4852 <img SRC="images/right_triangle_option.png" 4853 ALT=">" BORDER=0 height=14 4854 width=15><b><font face="Helvetica, Arial" 4855 ><font color="#00B04F"><font size="+1"> 4856 <a name="details-sample"></a>-sample <i><geometry></i> 4857 </font></font></font></b></td></tr></table> 4858 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>scale image using pixel sampling</td></tr></table> 4859 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4860 See <strong>-geometry</strong> for details about 4861 the geometry specification. 4862 <strong>-sample</strong> ignores the <strong>-filter</strong> selection if the <strong>-filter</strong> option 4863 is present. Offsets, if present in the geometry string, are ignored, and 4864 the <strong>-gravity</strong> option has no effect.</font></td></tr></table> 4865 <table BORDER=0 WIDTH="94%"> 4866 <tr> 4867 <td width="3%"><br></td> 4868 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4869 <img SRC="images/right_triangle_option.png" 4870 ALT=">" BORDER=0 height=14 4871 width=15><b><font face="Helvetica, Arial" 4872 ><font color="#00B04F"><font size="+1"> 4873 <a name="details-sampling-factor"></a>-sampling-factor <i><horizontal_factor>x<vertical_factor></i> 4874 </font></font></font></b></td></tr></table> 4875 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chroma subsampling factors</td></tr></table> 4876 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4877 This option specifies the sampling factors to be used by the DPX, JPEG, 4878 MPEG, or YUV encoders for chroma downsampling. The sampling factor must 4879 be specified while reading the raw YUV format since it is not preserved 4880 in the file header.</font></td></tr></table> 4881 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">Industry-standard video subsampling notation such as "4:2:2" may also 4882 be used to specify the sampling factors. "4:2:2" is equivalent to a 4883 specification of "2x1"</font></td></tr></table> 4884 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4885 The JPEG decoder obtains the original sampling factors (and quality 4886 settings) when a JPEG file is read. To re-use the original sampling 4887 factors (and quality setting) when JPEG is output, use the <tt>-define 4888 jpeg:preserve-settings</tt> flag.</font></td></tr></table> 4889 <table BORDER=0 WIDTH="94%"> 4890 <tr> 4891 <td width="3%"><br></td> 4892 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4893 <img SRC="images/right_triangle_option.png" 4894 ALT=">" BORDER=0 height=14 4895 width=15><b><font face="Helvetica, Arial" 4896 ><font color="#00B04F"><font size="+1"> 4897 <a name="details-scale"></a>-scale <i><geometry></i> 4898 </font></font></font></b></td></tr></table> 4899 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>scale the image.</td></tr></table> 4900 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4901 See <strong>-geometry</strong> for details about 4902 the geometry specification. <strong>-scale</strong> uses a simpler, faster algorithm, 4903 and it ignores the <strong>-filter</strong> selection if the <strong>-filter</strong> option 4904 is present. Offsets, if present in the geometry string, are ignored, and 4905 the <strong>-gravity</strong> option has no effect.</font></td></tr></table> 4906 <table BORDER=0 WIDTH="94%"> 4907 <tr> 4908 <td width="3%"><br></td> 4909 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4910 <img SRC="images/right_triangle_option.png" 4911 ALT=">" BORDER=0 height=14 4912 width=15><b><font face="Helvetica, Arial" 4913 ><font color="#00B04F"><font size="+1"> 4914 <a name="details-scene"></a>-scene <i><value></i> 4915 </font></font></font></b></td></tr></table> 4916 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set scene number</td></tr></table> 4917 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4918 This option sets the scene number of an image or the first image in 4919 an image sequence.</font></td></tr></table> 4920 <table BORDER=0 WIDTH="94%"> 4921 <tr> 4922 <td width="3%"><br></td> 4923 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4924 <img SRC="images/right_triangle_option.png" 4925 ALT=">" BORDER=0 height=14 4926 width=15><b><font face="Helvetica, Arial" 4927 ><font color="#00B04F"><font size="+1"> 4928 <a name="details-scenes"></a>-scenes <i><value-value></i> 4929 </font></font></font></b></td></tr></table> 4930 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>range of image scene numbers to read</td></tr></table> 4931 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4932 Each image in the range is read 4933 with the filename followed by a period (<strong>.</strong>) and the decimal scene 4934 number. You 4935 can change this behavior by embedding a <strong>%d, %0Nd, %o, %0No, %x, or %0Nx 4936 printf</strong> format specification in the file name. For example,</font></td></tr></table> 4937 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4938 gm montage -scenes 5-7 image.miff montage.miff 4939 </pre></font></td></tr></table> 4940 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4941 makes a montage of files image.miff.5, image.miff.6, and image.miff.7, and</font></td></tr></table> 4942 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4943 gm animate -scenes 0-12 image%02d.miff 4944 </pre></font></td></tr></table> 4945 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4946 animates files image00.miff, image01.miff, through image12.miff.</font></td></tr></table> 4947 <table BORDER=0 WIDTH="94%"> 4948 <tr> 4949 <td width="3%"><br></td> 4950 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4951 <img SRC="images/right_triangle_option.png" 4952 ALT=">" BORDER=0 height=14 4953 width=15><b><font face="Helvetica, Arial" 4954 ><font color="#00B04F"><font size="+1"> 4955 <a name="details-screen"></a>-screen 4956 </font></font></font></b></td></tr></table> 4957 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the screen to capture</td></tr></table> 4958 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4959 This option indicates that the GetImage request used to obtain the image 4960 should be done on the root window, rather than directly on the specified 4961 window. In this way, you can obtain pieces of other windows that overlap 4962 the specified window, and more importantly, you can capture menus or other 4963 popups that are independent windows but appear over the specified window.</font></td></tr></table> 4964 <table BORDER=0 WIDTH="94%"> 4965 <tr> 4966 <td width="3%"><br></td> 4967 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4968 <img SRC="images/right_triangle_option.png" 4969 ALT=">" BORDER=0 height=14 4970 width=15><b><font face="Helvetica, Arial" 4971 ><font color="#00B04F"><font size="+1"> 4972 <a name="details-set"></a>-set <i><attribute> <value></i> 4973 </font></font></font></b></td></tr></table> 4974 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set an image attribute</td></tr></table> 4975 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4976 Set a named image attribute. The attribute is set on the current 4977 (previously specified on command line) image.</font></td></tr></table> 4978 <table BORDER=0 WIDTH="94%"> 4979 <tr> 4980 <td width="3%"><br></td> 4981 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4982 <img SRC="images/right_triangle_option.png" 4983 ALT=">" BORDER=0 height=14 4984 width=15><b><font face="Helvetica, Arial" 4985 ><font color="#00B04F"><font size="+1"> 4986 <a name="details+set"></a>+set <i><attribute></i> 4987 </font></font></font></b></td></tr></table> 4988 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>unset an image attribute</td></tr></table> 4989 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4990 Unset a named image attribute. The attribute is removed from the current 4991 (previously specified on command line) image.</font></td></tr></table> 4992 <table BORDER=0 WIDTH="94%"> 4993 <tr> 4994 <td width="3%"><br></td> 4995 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4996 <img SRC="images/right_triangle_option.png" 4997 ALT=">" BORDER=0 height=14 4998 width=15><b><font face="Helvetica, Arial" 4999 ><font color="#00B04F"><font size="+1"> 5000 <a name="details-segment"></a>-segment <i><cluster threshold>x<smoothing threshold></i> 5001 </font></font></font></b></td></tr></table> 5002 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>segment an image</td></tr></table> 5003 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5004 Segment an image by analyzing the histograms of the color components and 5005 identifying units that are homogeneous with the fuzzy c-means technique.</font></td></tr></table> 5006 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5007 Segmentation is a very useful fast and and approximate color quantization 5008 algorithm for scanned printed pages or scanned cartoons. It may also be 5009 used as a special effect. Specify <em>cluster threshold</em> as the minimum 5010 percentage of total pixels in a cluster before it is considered valid. 5011 For huge images containing small detail, this may need to be a tiny 5012 fraction of a percent (e.g. 0.015) so that important detail is not lost. 5013 <em>Smoothing threshold</em> eliminates noise in the second derivative of 5014 the histogram. As the value is increased, you can expect a smoother 5015 second derivative. The default is 1.5. Add the <em>-verbose</em> option to 5016 see a dump of cluster statistics given the parameters used. The 5017 statistics may be used as a guide to help fine tune the options.</font></td></tr></table> 5018 <table BORDER=0 WIDTH="94%"> 5019 <tr> 5020 <td width="3%"><br></td> 5021 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5022 <img SRC="images/right_triangle_option.png" 5023 ALT=">" BORDER=0 height=14 5024 width=15><b><font face="Helvetica, Arial" 5025 ><font color="#00B04F"><font size="+1"> 5026 <a name="details-shade"></a>-shade <i><azimuth>x<elevation></i> 5027 </font></font></font></b></td></tr></table> 5028 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shade the image using a distant light source</td></tr></table> 5029 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5030 Specify <em>azimuth</em> and <em>elevation</em> as the position of the light 5031 source. Use <strong>+shade</strong> to return the shading results as a grayscale 5032 image.</font></td></tr></table> 5033 <table BORDER=0 WIDTH="94%"> 5034 <tr> 5035 <td width="3%"><br></td> 5036 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5037 <img SRC="images/right_triangle_option.png" 5038 ALT=">" BORDER=0 height=14 5039 width=15><b><font face="Helvetica, Arial" 5040 ><font color="#00B04F"><font size="+1"> 5041 -shadow <i><radius></i>{<i>x<sigma></i>}<i></i> 5042 </font></font></font></b></td></tr></table> 5043 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shadow the montage</td></tr></table> 5044 <table BORDER=0 WIDTH="94%"> 5045 <tr> 5046 <td width="3%"><br></td> 5047 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5048 <img SRC="images/right_triangle_option.png" 5049 ALT=">" BORDER=0 height=14 5050 width=15><b><font face="Helvetica, Arial" 5051 ><font color="#00B04F"><font size="+1"> 5052 <a name="details-shared-memory"></a>-shared-memory 5053 </font></font></font></b></td></tr></table> 5054 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use shared memory</td></tr></table> 5055 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5056 This option specifies whether the utility should attempt to use shared 5057 memory for pixmaps. GraphicsMagick must be compiled with shared 5058 memory support, and the display must support the <em>MIT-SHM</em> 5059 extension. Otherwise, this option is ignored. The default is 5060 <strong>True</strong>.</font></td></tr></table> 5061 <table BORDER=0 WIDTH="94%"> 5062 <tr> 5063 <td width="3%"><br></td> 5064 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5065 <img SRC="images/right_triangle_option.png" 5066 ALT=">" BORDER=0 height=14 5067 width=15><b><font face="Helvetica, Arial" 5068 ><font color="#00B04F"><font size="+1"> 5069 <a name="details-sharpen"></a>-sharpen <i><radius></i>{<i>x<sigma></i>}<i></i> 5070 </font></font></font></b></td></tr></table> 5071 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image</td></tr></table> 5072 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5073 Use a Gaussian operator of the given radius and standard deviation 5074 (sigma).</font></td></tr></table> 5075 <table BORDER=0 WIDTH="94%"> 5076 <tr> 5077 <td width="3%"><br></td> 5078 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5079 <img SRC="images/right_triangle_option.png" 5080 ALT=">" BORDER=0 height=14 5081 width=15><b><font face="Helvetica, Arial" 5082 ><font color="#00B04F"><font size="+1"> 5083 <a name="details-shave"></a>-shave <i><width>x<height></i>{<i>%</i>}<i></i> 5084 </font></font></font></b></td></tr></table> 5085 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shave pixels from the image edges</td></tr></table> 5086 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5087 Specify the width of the region to be removed from both 5088 sides of the image and the height of the regions to be removed from 5089 top and bottom.</font></td></tr></table> 5090 <table BORDER=0 WIDTH="94%"> 5091 <tr> 5092 <td width="3%"><br></td> 5093 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5094 <img SRC="images/right_triangle_option.png" 5095 ALT=">" BORDER=0 height=14 5096 width=15><b><font face="Helvetica, Arial" 5097 ><font color="#00B04F"><font size="+1"> 5098 <a name="details-shear"></a>-shear <i><x degrees>x<y degrees></i> 5099 </font></font></font></b></td></tr></table> 5100 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shear the image along the X or Y axis</td></tr></table> 5101 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5102 Use the specified positive or negative shear angle.</font></td></tr></table> 5103 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5104 Shearing slides one edge of an image along the X or Y axis, creating a 5105 parallelogram. An X direction shear slides an edge along the X axis, 5106 while a Y direction shear slides an edge along the Y axis. The amount 5107 of the shear is controlled by a shear angle. For X direction shears, 5108 <em>x degrees</em> is measured relative to the Y axis, and similarly, 5109 for Y direction shears <em>y degrees</em> is measured relative to the X 5110 axis.</font></td></tr></table> 5111 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5112 Empty triangles left over from shearing the image are filled with the 5113 color defined as <strong>background</strong> (class <strong>backgroundColor</strong>). 5114 The color is specified using the format described under the 5115 <strong>-fill</strong> option.</font></td></tr></table> 5116 <table BORDER=0 WIDTH="94%"> 5117 <tr> 5118 <td width="3%"><br></td> 5119 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5120 <img SRC="images/right_triangle_option.png" 5121 ALT=">" BORDER=0 height=14 5122 width=15><b><font face="Helvetica, Arial" 5123 ><font color="#00B04F"><font size="+1"> 5124 -silent 5125 </font></font></font></b></td></tr></table> 5126 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>operate silently</td></tr></table> 5127 <table BORDER=0 WIDTH="94%"> 5128 <tr> 5129 <td width="3%"><br></td> 5130 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5131 <img SRC="images/right_triangle_option.png" 5132 ALT=">" BORDER=0 height=14 5133 width=15><b><font face="Helvetica, Arial" 5134 ><font color="#00B04F"><font size="+1"> 5135 <a name="details-size"></a>-size <i><width>x<height></i>{<i>+offset</i>}<i></i> 5136 </font></font></font></b></td></tr></table> 5137 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table> 5138 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5139 Use this option to specify the width and height of raw images whose 5140 dimensions are unknown such as <strong>GRAY</strong>, <strong>RGB</strong>, or 5141 <strong>CMYK</strong>. In addition to width and height, use <strong>-size</strong> with an 5142 offset to skip any header information in the image or tell the number 5143 of colors in a <strong>MAP</strong> image file, (e.g. -size 640x512+256).</font></td></tr></table> 5144 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5145 For Photo CD images, choose from these sizes:</font></td></tr></table> 5146 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 5147 192x128 5148 384x256 5149 768x512 5150 1536x1024 5151 3072x2048 5152 </pre></font></td></tr></table> 5153 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5154 Finally, use this option to choose a particular resolution layer of a JBIG 5155 or JPEG image (e.g. -size 1024x768).</font></td></tr></table> 5156 <table BORDER=0 WIDTH="94%"> 5157 <tr> 5158 <td width="3%"><br></td> 5159 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5160 <img SRC="images/right_triangle_option.png" 5161 ALT=">" BORDER=0 height=14 5162 width=15><b><font face="Helvetica, Arial" 5163 ><font color="#00B04F"><font size="+1"> 5164 <a name="details-snaps"></a>-snaps <i><value></i> 5165 </font></font></font></b></td></tr></table> 5166 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>number of screen snapshots</td></tr></table> 5167 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5168 Use this option 5169 to grab more than one image from the X server screen, to create 5170 an animation sequence.</font></td></tr></table> 5171 <table BORDER=0 WIDTH="94%"> 5172 <tr> 5173 <td width="3%"><br></td> 5174 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5175 <img SRC="images/right_triangle_option.png" 5176 ALT=">" BORDER=0 height=14 5177 width=15><b><font face="Helvetica, Arial" 5178 ><font color="#00B04F"><font size="+1"> 5179 <a name="details-solarize"></a>-solarize <i><factor></i> 5180 </font></font></font></b></td></tr></table> 5181 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>negate all pixels above the threshold level</td></tr></table> 5182 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5183 Specify <em>factor</em> as the 5184 percent threshold of the intensity (0 - 99.9%).</font></td></tr></table> 5185 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5186 This option produces a <em>solarization</em> effect seen when exposing a 5187 photographic film to light during the development process.</font></td></tr></table> 5188 <table BORDER=0 WIDTH="94%"> 5189 <tr> 5190 <td width="3%"><br></td> 5191 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5192 <img SRC="images/right_triangle_option.png" 5193 ALT=">" BORDER=0 height=14 5194 width=15><b><font face="Helvetica, Arial" 5195 ><font color="#00B04F"><font size="+1"> 5196 <a name="details-spread"></a>-spread <i><amount></i> 5197 </font></font></font></b></td></tr></table> 5198 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>displace image pixels by a random amount</td></tr></table> 5199 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5200 <em>Amount</em> defines the size of the neighborhood around each pixel to 5201 choose a candidate pixel to swap.</font></td></tr></table> 5202 <table BORDER=0 WIDTH="94%"> 5203 <tr> 5204 <td width="3%"><br></td> 5205 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5206 <img SRC="images/right_triangle_option.png" 5207 ALT=">" BORDER=0 height=14 5208 width=15><b><font face="Helvetica, Arial" 5209 ><font color="#00B04F"><font size="+1"> 5210 <a name="details-stegano"></a>-stegano <i><offset></i> 5211 </font></font></font></b></td></tr></table> 5212 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>hide watermark within an image</td></tr></table> 5213 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5214 Use an offset to start the image hiding some number of pixels from the 5215 beginning of the image. Note this offset and the image size. You will 5216 need this information to recover the steganographic image 5217 (e.g. display -size 320x256+35 stegano:image.png).</font></td></tr></table> 5218 <table BORDER=0 WIDTH="94%"> 5219 <tr> 5220 <td width="3%"><br></td> 5221 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5222 <img SRC="images/right_triangle_option.png" 5223 ALT=">" BORDER=0 height=14 5224 width=15><b><font face="Helvetica, Arial" 5225 ><font color="#00B04F"><font size="+1"> 5226 <a name="details-stereo"></a>-stereo 5227 </font></font></font></b></td></tr></table> 5228 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>composite two images to create a stereo anaglyph</td></tr></table> 5229 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5230 The left side of the stereo pair is saved as the red channel of the output 5231 image. The right side is saved as the green channel. Red-green stereo 5232 glasses are required to properly view the stereo image.</font></td></tr></table> 5233 <table BORDER=0 WIDTH="94%"> 5234 <tr> 5235 <td width="3%"><br></td> 5236 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5237 <img SRC="images/right_triangle_option.png" 5238 ALT=">" BORDER=0 height=14 5239 width=15><b><font face="Helvetica, Arial" 5240 ><font color="#00B04F"><font size="+1"> 5241 <a name="details-strip"></a>-strip 5242 </font></font></font></b></td></tr></table> 5243 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove all profiles and text attributes from the image</td></tr></table> 5244 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5245 All embedded profiles and text attributes are stripped from the image. 5246 This is useful for images used for the web, or when output files need 5247 to be as small as possible</font></td></tr></table> 5248 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5249 Be careful not to use this option to remove author, copyright, and 5250 license information that you are required to retain when redistributing 5251 an image.</font></td></tr></table> 5252 <table BORDER=0 WIDTH="94%"> 5253 <tr> 5254 <td width="3%"><br></td> 5255 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5256 <img SRC="images/right_triangle_option.png" 5257 ALT=">" BORDER=0 height=14 5258 width=15><b><font face="Helvetica, Arial" 5259 ><font color="#00B04F"><font size="+1"> 5260 <a name="details-stroke"></a>-stroke <i><color></i> 5261 </font></font></font></b></td></tr></table> 5262 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color to use when stroking a graphic primitive</td></tr></table> 5263 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5264 The color is specified using the format described under the <strong>-fill</strong> 5265 option.</font></td></tr></table> 5266 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5267 See <strong>-draw</strong> for further details.</font></td></tr></table> 5268 <table BORDER=0 WIDTH="94%"> 5269 <tr> 5270 <td width="3%"><br></td> 5271 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5272 <img SRC="images/right_triangle_option.png" 5273 ALT=">" BORDER=0 height=14 5274 width=15><b><font face="Helvetica, Arial" 5275 ><font color="#00B04F"><font size="+1"> 5276 <a name="details-strokewidth"></a>-strokewidth <i><value></i> 5277 </font></font></font></b></td></tr></table> 5278 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set the stroke width</td></tr></table> 5279 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5280 See <strong>-draw</strong> for further details.</font></td></tr></table> 5281 <table BORDER=0 WIDTH="94%"> 5282 <tr> 5283 <td width="3%"><br></td> 5284 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5285 <img SRC="images/right_triangle_option.png" 5286 ALT=">" BORDER=0 height=14 5287 width=15><b><font face="Helvetica, Arial" 5288 ><font color="#00B04F"><font size="+1"> 5289 <a name="details-swirl"></a>-swirl <i><degrees></i> 5290 </font></font></font></b></td></tr></table> 5291 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>swirl image pixels about the center</td></tr></table> 5292 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5293 <em>Degrees</em> defines the tightness of the swirl.</font></td></tr></table> 5294 <table BORDER=0 WIDTH="94%"> 5295 <tr> 5296 <td width="3%"><br></td> 5297 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5298 <img SRC="images/right_triangle_option.png" 5299 ALT=">" BORDER=0 height=14 5300 width=15><b><font face="Helvetica, Arial" 5301 ><font color="#00B04F"><font size="+1"> 5302 <a name="details-text-font"></a>-text-font <i><name></i> 5303 </font></font></font></b></td></tr></table> 5304 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>font for writing fixed-width text</td></tr></table> 5305 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5306 Specifies the name of the preferred font to use in fixed (typewriter style) 5307 formatted text. The default is 14 point <em>Courier</em>.</font></td></tr></table> 5308 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5309 You can tag a font to specify whether it is a PostScript, TrueType, or 5310 X11 font. For example, <tt>Courier.ttf</tt> is a TrueType font 5311 and <tt>x:fixed</tt> is X11.</font></td></tr></table> 5312 <table BORDER=0 WIDTH="94%"> 5313 <tr> 5314 <td width="3%"><br></td> 5315 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5316 <img SRC="images/right_triangle_option.png" 5317 ALT=">" BORDER=0 height=14 5318 width=15><b><font face="Helvetica, Arial" 5319 ><font color="#00B04F"><font size="+1"> 5320 -texture <i><filename></i> 5321 </font></font></font></b></td></tr></table> 5322 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name of texture to tile onto the image background</td></tr></table> 5323 <table BORDER=0 WIDTH="94%"> 5324 <tr> 5325 <td width="3%"><br></td> 5326 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5327 <img SRC="images/right_triangle_option.png" 5328 ALT=">" BORDER=0 height=14 5329 width=15><b><font face="Helvetica, Arial" 5330 ><font color="#00B04F"><font size="+1"> 5331 <a name="details-threshold"></a>-threshold <i><value></i>{<i>%</i>}<i></i> 5332 </font></font></font></b></td></tr></table> 5333 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>threshold the image</td></tr></table> 5334 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5335 Modify the image such that any pixel sample with an intensity value 5336 greater than the threshold is assigned the maximum intensity (white), or 5337 otherwise is assigned the minimum intensity (black). If a percent prefix 5338 is applied, then the threshold is a percentage of the available range.</font></td></tr></table> 5339 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5340 To efficiently create a black and white image from a color image, use</font></td></tr></table> 5341 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 5342 gm convert -threshold 50% in.png out.png 5343 </pre></font></td></tr></table> 5344 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5345 The optimum threshold value depends on the nature of the image.</font></td></tr></table> 5346 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">In order to threshold individual channels, use the <strong>-operator</strong> 5347 subcommand with it's <strong>Threshold</strong>, <strong>Threshold-White</strong>, or 5348 <strong>Threshold-Black</strong> options.</font></td></tr></table> 5349 <table BORDER=0 WIDTH="94%"> 5350 <tr> 5351 <td width="3%"><br></td> 5352 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5353 <img SRC="images/right_triangle_option.png" 5354 ALT=">" BORDER=0 height=14 5355 width=15><b><font face="Helvetica, Arial" 5356 ><font color="#00B04F"><font size="+1"> 5357 <a name="details-thumbnail"></a>-thumbnail <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 5358 </font></font></font></b></td></tr></table> 5359 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image (quickly)</td></tr></table> 5360 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5361 The <strong>-thumbnail</strong> command resizes the image as quickly as 5362 possible, with more concern for speed than resulting image quality. 5363 Regardless, resulting image quality should be acceptable for many 5364 uses. It is primarily intended to be used to generate smaller 5365 versions of the image, but may also be used to enlarge the image. The 5366 <strong>-thumbnail</strong> <strong>geometry</strong> argument observes the same syntax 5367 and rules as it does for <strong>-resize</strong>.</font></td></tr></table> 5368 <table BORDER=0 WIDTH="94%"> 5369 <tr> 5370 <td width="3%"><br></td> 5371 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5372 <img SRC="images/right_triangle_option.png" 5373 ALT=">" BORDER=0 height=14 5374 width=15><b><font face="Helvetica, Arial" 5375 ><font color="#00B04F"><font size="+1"> 5376 -tile <i><filename></i> 5377 </font></font></font></b></td></tr></table> 5378 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tile image when filling a graphic primitive</td></tr></table> 5379 <table BORDER=0 WIDTH="94%"> 5380 <tr> 5381 <td width="3%"><br></td> 5382 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5383 <img SRC="images/right_triangle_option.png" 5384 ALT=">" BORDER=0 height=14 5385 width=15><b><font face="Helvetica, Arial" 5386 ><font color="#00B04F"><font size="+1"> 5387 -tile <i><geometry></i> 5388 </font></font></font></b></td></tr></table> 5389 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>layout of images [<em>montage</em>]</td></tr></table> 5390 <table BORDER=0 WIDTH="94%"> 5391 <tr> 5392 <td width="3%"><br></td> 5393 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5394 <img SRC="images/right_triangle_option.png" 5395 ALT=">" BORDER=0 height=14 5396 width=15><b><font face="Helvetica, Arial" 5397 ><font color="#00B04F"><font size="+1"> 5398 <a name="details-title"></a>-title <i><string></i> 5399 </font></font></font></b></td></tr></table> 5400 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign title to displayed image [<em>animate, display, montage</em>]</td></tr></table> 5401 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5402 Use this option to assign a specific title to the image. This is 5403 assigned to the image window and is typically displayed in the window 5404 title bar. Optionally you can include the image filename, type, 5405 width, height, Exif data, or other image attribute by embedding 5406 special format characters described under the <strong>-format</strong> 5407 option.</font></td></tr></table> 5408 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5409 For example,</font></td></tr></table> 5410 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 5411 -title "%m:%f %wx%h" 5412 </pre></font></td></tr></table> 5413 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5414 produces an image title of <tt>MIFF:bird.miff 512x480</tt> for an image 5415 titled <tt>bird.miff</tt> and whose width is 512 and height is 480.</font></td></tr></table> 5416 <table BORDER=0 WIDTH="94%"> 5417 <tr> 5418 <td width="3%"><br></td> 5419 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5420 <img SRC="images/right_triangle_option.png" 5421 ALT=">" BORDER=0 height=14 5422 width=15><b><font face="Helvetica, Arial" 5423 ><font color="#00B04F"><font size="+1"> 5424 <a name="details-transform"></a>-transform 5425 </font></font></font></b></td></tr></table> 5426 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image</td></tr></table> 5427 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5428 This option applies the transformation matrix from a previous 5429 <strong>-affine</strong> option.</font></td></tr></table> 5430 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 5431 gm convert -affine 2,2,-2,2,0,0 -transform bird.ppm bird.jpg 5432 </pre></font></td></tr></table> 5433 <table BORDER=0 WIDTH="94%"> 5434 <tr> 5435 <td width="3%"><br></td> 5436 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5437 <img SRC="images/right_triangle_option.png" 5438 ALT=">" BORDER=0 height=14 5439 width=15><b><font face="Helvetica, Arial" 5440 ><font color="#00B04F"><font size="+1"> 5441 <a name="details-transparent"></a>-transparent <i><color></i> 5442 </font></font></font></b></td></tr></table> 5443 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make this color transparent within the image</td></tr></table> 5444 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5445 The color is specified using the format described under the <strong>-fill</strong> 5446 option.</font></td></tr></table> 5447 <table BORDER=0 WIDTH="94%"> 5448 <tr> 5449 <td width="3%"><br></td> 5450 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5451 <img SRC="images/right_triangle_option.png" 5452 ALT=">" BORDER=0 height=14 5453 width=15><b><font face="Helvetica, Arial" 5454 ><font color="#00B04F"><font size="+1"> 5455 <a name="details-treedepth"></a>-treedepth <i><value></i> 5456 </font></font></font></b></td></tr></table> 5457 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tree depth for the color reduction algorithm</td></tr></table> 5458 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5459 Normally, this integer value is zero or one. A value of zero or one 5460 causes the use of an optimal tree depth for the color reduction 5461 algorithm</font></td></tr></table> 5462 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5463 An optimal depth generally allows the best representation of the source 5464 image with the fastest computational speed and the least amount of memory. 5465 However, the default depth is inappropriate for some images. To assure 5466 the best representation, try values between 2 and 8 for this parameter. 5467 Refer to 5468 <a href="quantize.html">quantize</a> for more details.</font></td></tr></table> 5469 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5470 The <strong>-colors</strong> or <strong>-monochrome</strong> option, or writing to an image 5471 format which requires color reduction, is required for this option to 5472 take effect.</font></td></tr></table> 5473 <table BORDER=0 WIDTH="94%"> 5474 <tr> 5475 <td width="3%"><br></td> 5476 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5477 <img SRC="images/right_triangle_option.png" 5478 ALT=">" BORDER=0 height=14 5479 width=15><b><font face="Helvetica, Arial" 5480 ><font color="#00B04F"><font size="+1"> 5481 <a name="details-trim"></a>-trim 5482 </font></font></font></b></td></tr></table> 5483 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table> 5484 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5485 This option removes any edges that are exactly the same color as the 5486 corner pixels. Use <strong>-fuzz</strong> to make <strong>-trim</strong> remove edges that 5487 are nearly the same color as the corner pixels.</font></td></tr></table> 5488 <table BORDER=0 WIDTH="94%"> 5489 <tr> 5490 <td width="3%"><br></td> 5491 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5492 <img SRC="images/right_triangle_option.png" 5493 ALT=">" BORDER=0 height=14 5494 width=15><b><font face="Helvetica, Arial" 5495 ><font color="#00B04F"><font size="+1"> 5496 <a name="details-type"></a>-type <i><type></i> 5497 </font></font></font></b></td></tr></table> 5498 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image type</td></tr></table> 5499 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5500 Choose from: 5501 <strong>Bilevel</strong>, <strong>Grayscale</strong>, <strong>Palette</strong>, 5502 <strong>PaletteMatte</strong>, <strong>TrueColor</strong>, <strong>TrueColorMatte</strong>, 5503 <strong>ColorSeparation</strong>, <strong>ColorSeparationMatte</strong>, or <strong>Optimize</strong>.</font></td></tr></table> 5504 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5505 Normally, when a format supports different subformats such as bilevel, 5506 grayscale, palette, truecolor, and truecolor+alpha, the encoder will try 5507 to choose a suitable subformat based on the nature of the image. The 5508 <strong>-type</strong> option may be used to tailor the output subformat. By 5509 default the output subformat is based on readily available image 5510 information and is usually similar to the input format.</font></td></tr></table> 5511 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5512 Specify <tt>-type Optimize</tt> in order to enable inspecting all pixels 5513 (if necessary) in order to find the most efficient subformat. Inspecting 5514 all of the pixels may be slow for very large images, particularly if they 5515 are stored in a disk cache. If an RGB image contains only gray pixels, 5516 then every pixel in the image must be inspected in order to decide that 5517 the image is actually grayscale!</font></td></tr></table> 5518 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5519 Sometimes a specific subformat is desired. For example, to force a JPEG 5520 image to be written in TrueColor RGB format even though only gray pixels 5521 are present, use</font></td></tr></table> 5522 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 5523 gm convert bird.pgm -type TrueColor bird.jpg 5524 </pre></font></td></tr></table> 5525 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5526 Similarly, using <tt>-type TrueColorMatte</tt> will force the encoder to 5527 write an alpha channel even though the image is opaque, if the output 5528 format supports transparency.</font></td></tr></table> 5529 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5530 Some pseudo-formats (e.g. the XC format) will respect the requested 5531 type if it occurs previously on the command line. For example, to obtain 5532 a DirectClass solid color canvas image rather than PsuedoClass, use</font></td></tr></table> 5533 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 5534 gm convert -size 640x480 -type TrueColor xc:red red.miff 5535 </pre></font></td></tr></table> 5536 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5537 Likewise, specify <strong>-type</strong> <strong>Bilevel</strong>, <strong>Grayscale</strong>, 5538 <strong>TrueColor</strong>, or <strong>TrueColorMatte</strong> prior to reading a Postscript 5539 (or PDF file) in order to influence the type of image that Ghostcript 5540 returns. Reading performance will be dramatically improved for 5541 black/white Postscript if <strong>Bilevel</strong> is specified, and will be 5542 considerably faster if <strong>Grayscale</strong> is specified.</font></td></tr></table> 5543 <table BORDER=0 WIDTH="94%"> 5544 <tr> 5545 <td width="3%"><br></td> 5546 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5547 <img SRC="images/right_triangle_option.png" 5548 ALT=">" BORDER=0 height=14 5549 width=15><b><font face="Helvetica, Arial" 5550 ><font color="#00B04F"><font size="+1"> 5551 <a name="details-update"></a>-update <i><seconds></i> 5552 </font></font></font></b></td></tr></table> 5553 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 5554 detect when image file is modified and redisplay.</td></tr></table> 5555 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5556 Suppose that while you are displaying an image the file that is currently 5557 displayed is over-written. 5558 <strong>display</strong> will automatically detect that 5559 the input file has been changed and update the displayed image accordingly.</font></td></tr></table> 5560 <table BORDER=0 WIDTH="94%"> 5561 <tr> 5562 <td width="3%"><br></td> 5563 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5564 <img SRC="images/right_triangle_option.png" 5565 ALT=">" BORDER=0 height=14 5566 width=15><b><font face="Helvetica, Arial" 5567 ><font color="#00B04F"><font size="+1"> 5568 <a name="details-units"></a>-units <i><type></i> 5569 </font></font></font></b></td></tr></table> 5570 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the units of image resolution</td></tr></table> 5571 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5572 Choose from: <strong>Undefined</strong>, <strong>PixelsPerInch</strong>, or 5573 <strong>PixelsPerCentimeter</strong>. This option is normally used in conjunction 5574 with the <strong>-density</strong> option.</font></td></tr></table> 5575 <table BORDER=0 WIDTH="94%"> 5576 <tr> 5577 <td width="3%"><br></td> 5578 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5579 <img SRC="images/right_triangle_option.png" 5580 ALT=">" BORDER=0 height=14 5581 width=15><b><font face="Helvetica, Arial" 5582 ><font color="#00B04F"><font size="+1"> 5583 <a name="details-unsharp"></a>-unsharp <i><radius></i>{<i>x<sigma></i>}<i></i>{<i>+<amount></i>}<i></i>{<i>+<threshold></i>}<i></i> 5584 </font></font></font></b></td></tr></table> 5585 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image with an unsharp mask operator</td></tr></table> 5586 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5587 The <strong>-unsharp</strong> option sharpens an image. The image is convolved 5588 with a Gaussian operator of the given radius and standard deviation 5589 (sigma). For reasonable results, radius should be larger than sigma. Use 5590 a radius of 0 to have the method select a suitable radius.</font></td></tr></table> 5591 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5592 The parameters are:</font></td></tr></table> 5593 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5594 <dl> 5595 <dt>radius</dt> 5596 <dd> 5597 The radius of the Gaussian, in pixels, not counting the center pixel (default 0). 5598 </dd> 5599 <dt>sigma</dt> 5600 <dd> 5601 The standard deviation of the Gaussian, in pixels (default 1.0). 5602 </dd> 5603 <dt>amount</dt> 5604 <dd> 5605 The percentage of the difference between the original and the blur image that 5606 is added back into the original (default 1.0). 5607 </dd> 5608 <dt>threshold</dt> 5609 <dd> 5610 The threshold, as a fraction of MaxRGB, needed to apply the difference 5611 amount (default 0.05). 5612 </dd> 5613 </dl> 5614 </font></td></tr></table> 5615 <table BORDER=0 WIDTH="94%"> 5616 <tr> 5617 <td width="3%"><br></td> 5618 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5619 <img SRC="images/right_triangle_option.png" 5620 ALT=">" BORDER=0 height=14 5621 width=15><b><font face="Helvetica, Arial" 5622 ><font color="#00B04F"><font size="+1"> 5623 -use-pixmap 5624 </font></font></font></b></td></tr></table> 5625 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use the pixmap</td></tr></table> 5626 <table BORDER=0 WIDTH="94%"> 5627 <tr> 5628 <td width="3%"><br></td> 5629 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5630 <img SRC="images/right_triangle_option.png" 5631 ALT=">" BORDER=0 height=14 5632 width=15><b><font face="Helvetica, Arial" 5633 ><font color="#00B04F"><font size="+1"> 5634 <a name="details-verbose"></a>-verbose 5635 </font></font></font></b></td></tr></table> 5636 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table> 5637 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5638 This information is printed: image scene number; image name; image size; 5639 the image class (<em>DirectClass</em> or <em>PseudoClass</em>); the total 5640 number of unique colors; and the number of seconds to read and transform 5641 the image. If the image is <em>DirectClass</em>, the total number of unique 5642 colors is not displayed unless <strong>-verbose</strong> is specified twice since 5643 it may take quite a long time to compute, particularly for deep images. 5644 If the image is <em>PseudoClass</em> then its pixels are defined by indexes 5645 into a colormap. If the image is <em>DirectClass</em> then each pixel 5646 includes a complete and independent color specification.</font></td></tr></table> 5647 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5648 If <strong>-colors</strong> is also specified, the total unique colors in the image 5649 and color reduction error values are printed. Refer to <a href="quantize.html">quantize</a> 5650 for a description of these values.</font></td></tr></table> 5651 <table BORDER=0 WIDTH="94%"> 5652 <tr> 5653 <td width="3%"><br></td> 5654 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5655 <img SRC="images/right_triangle_option.png" 5656 ALT=">" BORDER=0 height=14 5657 width=15><b><font face="Helvetica, Arial" 5658 ><font color="#00B04F"><font size="+1"> 5659 <a name="details-version"></a>-version 5660 </font></font></font></b></td></tr></table> 5661 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table> 5662 <table BORDER=0 WIDTH="94%"> 5663 <tr> 5664 <td width="3%"><br></td> 5665 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5666 <img SRC="images/right_triangle_option.png" 5667 ALT=">" BORDER=0 height=14 5668 width=15><b><font face="Helvetica, Arial" 5669 ><font color="#00B04F"><font size="+1"> 5670 -view <i><string></i> 5671 </font></font></font></b></td></tr></table> 5672 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>FlashPix viewing parameters</td></tr></table> 5673 <table BORDER=0 WIDTH="94%"> 5674 <tr> 5675 <td width="3%"><br></td> 5676 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5677 <img SRC="images/right_triangle_option.png" 5678 ALT=">" BORDER=0 height=14 5679 width=15><b><font face="Helvetica, Arial" 5680 ><font color="#00B04F"><font size="+1"> 5681 <a name="details-virtual-pixel"></a>-virtual-pixel <i><method></i> 5682 </font></font></font></b></td></tr></table> 5683 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify contents of "virtual pixels"</td></tr></table> 5684 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5685 This option 5686 defines "virtual pixels" for use in operations that can access pixels outside 5687 the boundaries of an image.</font></td></tr></table> 5688 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5689 Choose from these methods:</font></td></tr></table> 5690 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5691 <dl> 5692 <dt>Constant</dt> 5693 <dd> 5694 Use the image background color. 5695 </dd> 5696 <dt>Edge</dt> 5697 <dd> 5698 Extend the edge pixel toward infinity (default). 5699 </dd> 5700 <dt>Mirror</dt> 5701 <dd> 5702 Mirror the image. 5703 </dd> 5704 <dt>Tile</dt> 5705 <dd> 5706 Tile the image. 5707 </dd> 5708 </dl> 5709 </font></td></tr></table> 5710 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5711 This option affects operations that use 5712 virtual pixels such as <strong>-blur</strong>, <strong>-sharpen</strong>, <strong>-wave</strong>, etc.</font></td></tr></table> 5713 <table BORDER=0 WIDTH="94%"> 5714 <tr> 5715 <td width="3%"><br></td> 5716 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5717 <img SRC="images/right_triangle_option.png" 5718 ALT=">" BORDER=0 height=14 5719 width=15><b><font face="Helvetica, Arial" 5720 ><font color="#00B04F"><font size="+1"> 5721 <a name="details-visual"></a>-visual <i><type></i> 5722 </font></font></font></b></td></tr></table> 5723 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>animate images using this X visual type</td></tr></table> 5724 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5725 Choose from these visual classes:</font></td></tr></table> 5726 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 5727 StaticGray 5728 GrayScale 5729 StaticColor 5730 PseudoColor 5731 TrueColor 5732 DirectColor 5733 default 5734 visual id 5735 </pre></font></td></tr></table> 5736 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5737 The X server must support the visual you choose, otherwise an error occurs. 5738 If a visual is not specified, the visual class that can display the most 5739 simultaneous colors on the default screen is chosen.</font></td></tr></table> 5740 <table BORDER=0 WIDTH="94%"> 5741 <tr> 5742 <td width="3%"><br></td> 5743 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5744 <img SRC="images/right_triangle_option.png" 5745 ALT=">" BORDER=0 height=14 5746 width=15><b><font face="Helvetica, Arial" 5747 ><font color="#00B04F"><font size="+1"> 5748 -watermark <i><brightness>x<saturation></i> 5749 </font></font></font></b></td></tr></table> 5750 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>percent brightness and saturation of a watermark</td></tr></table> 5751 <table BORDER=0 WIDTH="94%"> 5752 <tr> 5753 <td width="3%"><br></td> 5754 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5755 <img SRC="images/right_triangle_option.png" 5756 ALT=">" BORDER=0 height=14 5757 width=15><b><font face="Helvetica, Arial" 5758 ><font color="#00B04F"><font size="+1"> 5759 <a name="details-wave"></a>-wave <i><amplitude>x<wavelength></i> 5760 </font></font></font></b></td></tr></table> 5761 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>alter an image along a sine wave</td></tr></table> 5762 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5763 Specify <em>amplitude</em> and <em>wavelength</em> 5764 of the wave.</font></td></tr></table> 5765 <table BORDER=0 WIDTH="94%"> 5766 <tr> 5767 <td width="3%"><br></td> 5768 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5769 <img SRC="images/right_triangle_option.png" 5770 ALT=">" BORDER=0 height=14 5771 width=15><b><font face="Helvetica, Arial" 5772 ><font color="#00B04F"><font size="+1"> 5773 <a name="details-white-point"></a>-white-point <i><x>,<y></i> 5774 </font></font></font></b></td></tr></table> 5775 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chromaticity white point</td></tr></table> 5776 <table BORDER=0 WIDTH="94%"> 5777 <tr> 5778 <td width="3%"><br></td> 5779 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5780 <img SRC="images/right_triangle_option.png" 5781 ALT=">" BORDER=0 height=14 5782 width=15><b><font face="Helvetica, Arial" 5783 ><font color="#00B04F"><font size="+1"> 5784 <a name="details-white-threshold"></a>-white-threshold <i>red[,green][,blue][,opacity]</i> 5785 </font></font></font></b></td></tr></table> 5786 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pixels above the threshold become white</td></tr></table> 5787 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5788 Use <strong>-white-threshold</strong> to set pixels with values above the specified 5789 threshold to maximum value (white). If only one value is supplied, or the 5790 red, green, and blue values are identical, then intensity thresholding is 5791 used. If the color threshold values are not identical then channel-based 5792 thresholding is used, and color distortion will occur. Specify a negative 5793 value (e.g. -1) if you want a channel to be ignored but you do want to 5794 threshold a channel later in the list. If a percent (%) symbol is 5795 appended, then the values are treated as a percentage of maximum 5796 range.</font></td></tr></table> 5797 <table BORDER=0 WIDTH="94%"> 5798 <tr> 5799 <td width="3%"><br></td> 5800 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5801 <img SRC="images/right_triangle_option.png" 5802 ALT=">" BORDER=0 height=14 5803 width=15><b><font face="Helvetica, Arial" 5804 ><font color="#00B04F"><font size="+1"> 5805 <a name="details-window"></a>-window <i><id></i> 5806 </font></font></font></b></td></tr></table> 5807 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make image the background of a window</td></tr></table> 5808 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5809 <em>id</em> can be a window id or name. Specify <strong>root</strong> to 5810 select X's root window as the target window.</font></td></tr></table> 5811 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5812 By default the image is tiled onto the background of the target 5813 window. If <strong>backdrop</strong> or <strong>-geometry</strong> are 5814 specified, the image is surrounded by the background color. Refer to 5815 <strong>X RESOURCES</strong> for details.</font></td></tr></table> 5816 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5817 The image will not display on the root window if the image has more 5818 unique colors than the target window colormap allows. Use 5819 <strong>-colors</strong> to reduce the number of colors.</font></td></tr></table> 5820 <table BORDER=0 WIDTH="94%"> 5821 <tr> 5822 <td width="3%"><br></td> 5823 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5824 <img SRC="images/right_triangle_option.png" 5825 ALT=">" BORDER=0 height=14 5826 width=15><b><font face="Helvetica, Arial" 5827 ><font color="#00B04F"><font size="+1"> 5828 -window-group 5829 </font></font></font></b></td></tr></table> 5830 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the window group</td></tr></table> 5831 <table BORDER=0 WIDTH="94%"> 5832 <tr> 5833 <td width="3%"><br></td> 5834 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5835 <img SRC="images/right_triangle_option.png" 5836 ALT=">" BORDER=0 height=14 5837 width=15><b><font face="Helvetica, Arial" 5838 ><font color="#00B04F"><font size="+1"> 5839 <a name="details-write"></a>-write <i><filename></i> 5840 </font></font></font></b></td></tr></table> 5841 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>write an intermediate image [<em>convert, composite</em>]</td></tr></table> 5842 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5843 The current image is written to the specified filename and then 5844 processing continues using that image. The following is an example of how 5845 several sizes of an image may be generated in one command (repeat as 5846 often as needed):</font></td></tr></table> 5847 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 5848 gm convert input.jpg -resize 50% -write input50.jpg \ 5849 -resize 25% input25.jpg 5850 </pre></font></td></tr></table> 5851 <table BORDER=0 WIDTH="94%"> 5852 <tr> 5853 <td width="3%"><br></td> 5854 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5855 <img SRC="images/right_triangle_option.png" 5856 ALT=">" BORDER=0 height=14 5857 width=15><b><font face="Helvetica, Arial" 5858 ><font color="#00B04F"><font size="+1"> 5859 <a name="details-write"></a>-write <i><filename></i> 5860 </font></font></font></b></td></tr></table> 5861 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>write the image to a file [<em>display</em>]</td></tr></table> 5862 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5863 If <em>filename</em> already exists, you will be prompted as to whether it should 5864 be overwritten.</font></td></tr></table> 5865 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5866 By default, the image is written in the format that it was read in as. 5867 To specify a particular image format, prefix <em>filename</em> with the 5868 image type and a colon (e.g., ps:image) or specify the image type as 5869 the filename suffix (e.g., image.ps). Specify file as - for standard 5870 output. If file has the extension <strong>.Z</strong> or <strong>.gz</strong>, the file 5871 size is <strong>compressed</strong> using compress or <strong>gzip</strong> 5872 respectively. Precede the image file name with | to pipe to a system 5873 command.</font></td></tr></table> 5874 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5875 Use <strong>-compress</strong> to specify the type of image compression.</font></td></tr></table> 5876 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5877 The equivalent X resource for this option is 5878 <strong>writeFilename</strong> (class <strong>WriteFilename</strong>). 5879 See 5880 "X Resources", below, 5881 for details.</font></td></tr></table> 5882 </td></tr></table> 5883 <p> 5884 <i><a href="#top">Back to Contents</a></i> 5885 </p> 5886 <table BORDER=0 WIDTH="100%"> 5887 <tr> 5888 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 5889 SRC="images/right_triangle.png" ALT=">" BORDER=0 5890 height=14 width=15><b><font face="Helvetica, Arial"><font 5891 color="#00B04F"><font size="+1"> 5892 <a NAME="envi"></a>Environment 5893 </font></font></font></b></td></tr></table> 5894 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 5895 <tr><td width="3%"><br></td><td> 5896 <table BORDER=0 WIDTH="94%"> 5897 <tr> 5898 <td width="3%"><br></td> 5899 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5900 <img SRC="images/right_triangle_option.png" 5901 ALT=">" BORDER=0 height=14 5902 width=15><b><font face="Helvetica, Arial" 5903 ><font color="#00B04F"><font size="+1"> 5904 COLUMNS 5905 </font></font></font></b></td></tr></table> 5906 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Output screen width. Used when formatting text for the screen. Many 5907 Unix systems keep this shell variable up to date, but it may need to be 5908 explicitly exported in order for GraphicsMagick to see it.</td></tr></table> 5909 <table BORDER=0 WIDTH="94%"> 5910 <tr> 5911 <td width="3%"><br></td> 5912 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5913 <img SRC="images/right_triangle_option.png" 5914 ALT=">" BORDER=0 height=14 5915 width=15><b><font face="Helvetica, Arial" 5916 ><font color="#00B04F"><font size="+1"> 5917 DISPLAY 5918 </font></font></font></b></td></tr></table> 5919 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>X11 display ID (host, display number, and screen in the form 5920 hostname:display.screen).</td></tr></table> 5921 <table BORDER=0 WIDTH="94%"> 5922 <tr> 5923 <td width="3%"><br></td> 5924 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5925 <img SRC="images/right_triangle_option.png" 5926 ALT=">" BORDER=0 height=14 5927 width=15><b><font face="Helvetica, Arial" 5928 ><font color="#00B04F"><font size="+1"> 5929 HOME 5930 </font></font></font></b></td></tr></table> 5931 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Location of user's home directory. For security reasons, now only 5932 observed by "uninstalled" builds of GraphicsMagick which do not have 5933 their location hard-coded or set by an installer. When supported, 5934 GraphicsMagick searches for configuration files in $HOME/.magick if 5935 the directory exists. See <strong>MAGICK_CODER_MODULE_PATH</strong>, 5936 <strong>MAGICK_CONFIGURE_PATH</strong>, and <strong>MAGICK_FILTER_MODULE_PATH</strong> if 5937 more flexibility is needed.</td></tr></table> 5938 <table BORDER=0 WIDTH="94%"> 5939 <tr> 5940 <td width="3%"><br></td> 5941 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5942 <img SRC="images/right_triangle_option.png" 5943 ALT=">" BORDER=0 height=14 5944 width=15><b><font face="Helvetica, Arial" 5945 ><font color="#00B04F"><font size="+1"> 5946 MAGICK_ACCESS_MONITOR 5947 </font></font></font></b></td></tr></table> 5948 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>When set to <strong>TRUE</strong>, command line monitor mode (enabled by 5949 <strong>-monitor</strong>) will also show files accessed (including temporary 5950 files) and any external commands which are executed. This is useful 5951 for debugging, but also illustrates arguments made available to an 5952 access handler registered by the 5953 <strong>MagickSetConfirmAccessHandler()</strong> C library function.</td></tr></table> 5954 <table BORDER=0 WIDTH="94%"> 5955 <tr> 5956 <td width="3%"><br></td> 5957 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5958 <img SRC="images/right_triangle_option.png" 5959 ALT=">" BORDER=0 height=14 5960 width=15><b><font face="Helvetica, Arial" 5961 ><font color="#00B04F"><font size="+1"> 5962 MAGICK_CODER_STABILITY 5963 </font></font></font></b></td></tr></table> 5964 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>The minimum coder stability level before it will be used. The 5965 available levels are <strong>PRIMARY</strong>, <strong>STABLE</strong>, <strong>UNSTABLE</strong>, 5966 and <strong>BROKEN</strong>. The default minimum level is <strong>UNSTABLE</strong>, 5967 which means that all available working coders will be used. The 5968 purpose of this option is to reduce the security exposure (or apparent 5969 complexity) due to the huge number of formats supported. Coders at the 5970 <strong>PRIMARY</strong> level are commonly used formats with very well 5971 maintained implementations. Coders at the <strong>STABLE</strong> level are 5972 reasonably well maintained but represent less used formats. Coders at 5973 the <strong>UNSTABLE</strong> level either have weak implementations, the file 5974 format itself is weak, or the probability the coder will be needed is 5975 vanishingly small. Coders at the <strong>BROKEN</strong> level are known to 5976 often not work properly or might not be useful in their current state 5977 at all.</td></tr></table> 5978 <table BORDER=0 WIDTH="94%"> 5979 <tr> 5980 <td width="3%"><br></td> 5981 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5982 <img SRC="images/right_triangle_option.png" 5983 ALT=">" BORDER=0 height=14 5984 width=15><b><font face="Helvetica, Arial" 5985 ><font color="#00B04F"><font size="+1"> 5986 MAGICK_CODER_MODULE_PATH 5987 </font></font></font></b></td></tr></table> 5988 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Search path to use when searching for image format coder modules. 5989 This path allows the user to arbitrarily extend the image formats 5990 supported by GraphicsMagick by adding loadable modules to an arbitrary 5991 location rather than copying them into the GraphicsMagick installation 5992 directory. The formatting of the search path is similar to operating 5993 system search paths (i.e. colon delimited for Unix, and semi-colon 5994 delimited for Microsoft Windows). This user specified search path is used 5995 before trying the default search path.</td></tr></table> 5996 <table BORDER=0 WIDTH="94%"> 5997 <tr> 5998 <td width="3%"><br></td> 5999 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6000 <img SRC="images/right_triangle_option.png" 6001 ALT=">" BORDER=0 height=14 6002 width=15><b><font face="Helvetica, Arial" 6003 ><font color="#00B04F"><font size="+1"> 6004 MAGICK_CONFIGURE_PATH 6005 </font></font></font></b></td></tr></table> 6006 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Search path to use when searching for configuration (.mgk) files. 6007 The formatting of the search path is similar to operating system search 6008 paths (i.e. colon delimited for Unix, and semi-colon delimited for 6009 Microsoft Windows). This user specified search path is used before trying 6010 the default search path.</td></tr></table> 6011 <table BORDER=0 WIDTH="94%"> 6012 <tr> 6013 <td width="3%"><br></td> 6014 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6015 <img SRC="images/right_triangle_option.png" 6016 ALT=">" BORDER=0 height=14 6017 width=15><b><font face="Helvetica, Arial" 6018 ><font color="#00B04F"><font size="+1"> 6019 MAGICK_DEBUG 6020 </font></font></font></b></td></tr></table> 6021 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Debug options (see <strong>-debug</strong> for details). Setting the 6022 configure debug option via an environment variable 6023 (e.g. <strong>MAGICK_DEBUG=configure</strong>) is necessary to see the complete 6024 initialization process, which includes searching for configuration 6025 files.</td></tr></table> 6026 <table BORDER=0 WIDTH="94%"> 6027 <tr> 6028 <td width="3%"><br></td> 6029 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6030 <img SRC="images/right_triangle_option.png" 6031 ALT=">" BORDER=0 height=14 6032 width=15><b><font face="Helvetica, Arial" 6033 ><font color="#00B04F"><font size="+1"> 6034 MAGICK_FILTER_MODULE_PATH 6035 </font></font></font></b></td></tr></table> 6036 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Search path to use when searching for filter process modules 6037 (invoked via <strong>-process</strong>). This path allows the user to arbitrarily 6038 extend GraphicsMagick's image processing functionality by adding loadable 6039 modules to an arbitrary location rather than copying them into the 6040 GraphicsMagick installation directory. The formatting of the search path 6041 is similar to operating system search paths (i.e. colon delimited for 6042 Unix, and semi-colon delimited for Microsoft Windows). This user 6043 specified search path is used before trying the default search path.</td></tr></table> 6044 <table BORDER=0 WIDTH="94%"> 6045 <tr> 6046 <td width="3%"><br></td> 6047 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6048 <img SRC="images/right_triangle_option.png" 6049 ALT=">" BORDER=0 height=14 6050 width=15><b><font face="Helvetica, Arial" 6051 ><font color="#00B04F"><font size="+1"> 6052 MAGICK_GHOSTSCRIPT_PATH 6053 </font></font></font></b></td></tr></table> 6054 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>For Microsoft Windows, specify the path to the Ghostscript 6055 installation rather than searching for it via the Windows registry. 6056 This helps in case Ghostscript is not installed via the Ghostscript 6057 Windows installer or the user wants more control over the Ghostscript 6058 used.</td></tr></table> 6059 <table BORDER=0 WIDTH="94%"> 6060 <tr> 6061 <td width="3%"><br></td> 6062 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6063 <img SRC="images/right_triangle_option.png" 6064 ALT=">" BORDER=0 height=14 6065 width=15><b><font face="Helvetica, Arial" 6066 ><font color="#00B04F"><font size="+1"> 6067 MAGICK_HOME 6068 </font></font></font></b></td></tr></table> 6069 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Path to top of GraphicsMagick installation directory. Only observed 6070 by "uninstalled" builds of GraphicsMagick which do not have their location 6071 hard-coded or set by an installer.</td></tr></table> 6072 <table BORDER=0 WIDTH="94%"> 6073 <tr> 6074 <td width="3%"><br></td> 6075 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6076 <img SRC="images/right_triangle_option.png" 6077 ALT=">" BORDER=0 height=14 6078 width=15><b><font face="Helvetica, Arial" 6079 ><font color="#00B04F"><font size="+1"> 6080 MAGICK_MMAP_READ 6081 </font></font></font></b></td></tr></table> 6082 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>If <strong>MAGICK_MMAP_READ</strong> is set to <strong>TRUE</strong>, GraphicsMagick 6083 will attempt to memory-map the input file for reading. This usually 6084 substantially improves repeated read performance since the file is 6085 already in memory after the first time it has been read. However, 6086 testing shows that performance may be reduced for files accessed for 6087 the first time since data is accessed via page-faults (upon first 6088 access) and many operating systems fail to do sequential read-ahead of 6089 memory mapped files, and particularly if those files are accessed over 6090 a network. If many large input files are read, then enabling this 6091 option may harm performance by overloading the operating system's VM 6092 system as it then needs to free unmapped pages and map new ones.</td></tr></table> 6093 <table BORDER=0 WIDTH="94%"> 6094 <tr> 6095 <td width="3%"><br></td> 6096 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6097 <img SRC="images/right_triangle_option.png" 6098 ALT=">" BORDER=0 height=14 6099 width=15><b><font face="Helvetica, Arial" 6100 ><font color="#00B04F"><font size="+1"> 6101 MAGICK_IO_FSYNC 6102 </font></font></font></b></td></tr></table> 6103 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>If <strong>MAGICK_IO_FSYNC</strong> is set to <strong>TRUE</strong>, then GraphicsMagick 6104 will request that the output file is fully flushed and synchronized to 6105 disk when it is closed. This incurs a performance penalty, but has the 6106 benefit that if the power fails or the system crashes, the file should be 6107 valid on disk. If image files are referenced from a database, then this 6108 option helps assure that the files referenced by the database are 6109 valid.</td></tr></table> 6110 <table BORDER=0 WIDTH="94%"> 6111 <tr> 6112 <td width="3%"><br></td> 6113 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6114 <img SRC="images/right_triangle_option.png" 6115 ALT=">" BORDER=0 height=14 6116 width=15><b><font face="Helvetica, Arial" 6117 ><font color="#00B04F"><font size="+1"> 6118 MAGICK_IOBUF_SIZE 6119 </font></font></font></b></td></tr></table> 6120 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>The amount of I/O buffering (in bytes) to use when reading and 6121 writing encoded files. The default is 16384, which is observed to work 6122 well for many cases. The best value for a local filesystem is usually the 6123 the native filesystem block size (e.g. 4096, 8192, or even 131,072 for 6124 ZFS) in order to minimize the number of physical disk I/O operations. 6125 I/O performance to files accessed over a network may benefit 6126 significantly by tuning this option. Larger values are not necessarily 6127 better (they may be slower!), and there is rarely any benefit from using 6128 values larger than 32768. Use convert's <strong>-verbose</strong> option in order 6129 to evaluate read and write rates in pixels per second while keeping in 6130 mind that the operating system will try to cache files in RAM.</td></tr></table> 6131 <table BORDER=0 WIDTH="94%"> 6132 <tr> 6133 <td width="3%"><br></td> 6134 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6135 <img SRC="images/right_triangle_option.png" 6136 ALT=">" BORDER=0 height=14 6137 width=15><b><font face="Helvetica, Arial" 6138 ><font color="#00B04F"><font size="+1"> 6139 MAGICK_LIMIT_DISK 6140 </font></font></font></b></td></tr></table> 6141 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum amount of disk space allowed for use by the pixel cache.</td></tr></table> 6142 <table BORDER=0 WIDTH="94%"> 6143 <tr> 6144 <td width="3%"><br></td> 6145 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6146 <img SRC="images/right_triangle_option.png" 6147 ALT=">" BORDER=0 height=14 6148 width=15><b><font face="Helvetica, Arial" 6149 ><font color="#00B04F"><font size="+1"> 6150 MAGICK_LIMIT_FILES 6151 </font></font></font></b></td></tr></table> 6152 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum number of open files.</td></tr></table> 6153 <table BORDER=0 WIDTH="94%"> 6154 <tr> 6155 <td width="3%"><br></td> 6156 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6157 <img SRC="images/right_triangle_option.png" 6158 ALT=">" BORDER=0 height=14 6159 width=15><b><font face="Helvetica, Arial" 6160 ><font color="#00B04F"><font size="+1"> 6161 MAGICK_LIMIT_MAP 6162 </font></font></font></b></td></tr></table> 6163 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum size of a memory mapped file allocation. A memory mapped 6164 file consumes memory when the file is accessed, although the system 6165 may reclaim such memory when needed.</td></tr></table> 6166 <table BORDER=0 WIDTH="94%"> 6167 <tr> 6168 <td width="3%"><br></td> 6169 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6170 <img SRC="images/right_triangle_option.png" 6171 ALT=">" BORDER=0 height=14 6172 width=15><b><font face="Helvetica, Arial" 6173 ><font color="#00B04F"><font size="+1"> 6174 MAGICK_LIMIT_MEMORY 6175 </font></font></font></b></td></tr></table> 6176 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum amount of memory to allocate from the heap.</td></tr></table> 6177 <table BORDER=0 WIDTH="94%"> 6178 <tr> 6179 <td width="3%"><br></td> 6180 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6181 <img SRC="images/right_triangle_option.png" 6182 ALT=">" BORDER=0 height=14 6183 width=15><b><font face="Helvetica, Arial" 6184 ><font color="#00B04F"><font size="+1"> 6185 MAGICK_LIMIT_PIXELS 6186 </font></font></font></b></td></tr></table> 6187 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum number of total pixels (image rows times image colums) to 6188 allow for any image which is requested to be created or read. This is 6189 useful to place a limit on how large an image may be. If the input 6190 image file has image dimensions larger than the pixel limit, then the 6191 image memory allocation is denied and an error is returned 6192 immediately. This is a per-image limit and does not limit the total 6193 number of pixels due to multiple image frames/pages (e.g. multi-page 6194 document or an animation).</td></tr></table> 6195 <table BORDER=0 WIDTH="94%"> 6196 <tr> 6197 <td width="3%"><br></td> 6198 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6199 <img SRC="images/right_triangle_option.png" 6200 ALT=">" BORDER=0 height=14 6201 width=15><b><font face="Helvetica, Arial" 6202 ><font color="#00B04F"><font size="+1"> 6203 MAGICK_LIMIT_WIDTH 6204 </font></font></font></b></td></tr></table> 6205 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum pixel width of an image read, or created.</td></tr></table> 6206 <table BORDER=0 WIDTH="94%"> 6207 <tr> 6208 <td width="3%"><br></td> 6209 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6210 <img SRC="images/right_triangle_option.png" 6211 ALT=">" BORDER=0 height=14 6212 width=15><b><font face="Helvetica, Arial" 6213 ><font color="#00B04F"><font size="+1"> 6214 MAGICK_LIMIT_HEIGHT 6215 </font></font></font></b></td></tr></table> 6216 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum pixel height of an image read, or created.</td></tr></table> 6217 <table BORDER=0 WIDTH="94%"> 6218 <tr> 6219 <td width="3%"><br></td> 6220 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6221 <img SRC="images/right_triangle_option.png" 6222 ALT=">" BORDER=0 height=14 6223 width=15><b><font face="Helvetica, Arial" 6224 ><font color="#00B04F"><font size="+1"> 6225 MAGICK_TMPDIR 6226 </font></font></font></b></td></tr></table> 6227 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Path to directory where GraphicsMagick should write temporary 6228 files. The default is to use the system default, or the location set by 6229 <strong>TMPDIR</strong>.</td></tr></table> 6230 <table BORDER=0 WIDTH="94%"> 6231 <tr> 6232 <td width="3%"><br></td> 6233 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6234 <img SRC="images/right_triangle_option.png" 6235 ALT=">" BORDER=0 height=14 6236 width=15><b><font face="Helvetica, Arial" 6237 ><font color="#00B04F"><font size="+1"> 6238 TMPDIR 6239 </font></font></font></b></td></tr></table> 6240 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>For POSIX-compatible systems (Unix-compatible), the path to the 6241 directory where all applications should write temporary files. 6242 Overridden by <strong>MAGICK_TMPDIR</strong> if it is set.</td></tr></table> 6243 <table BORDER=0 WIDTH="94%"> 6244 <tr> 6245 <td width="3%"><br></td> 6246 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6247 <img SRC="images/right_triangle_option.png" 6248 ALT=">" BORDER=0 height=14 6249 width=15><b><font face="Helvetica, Arial" 6250 ><font color="#00B04F"><font size="+1"> 6251 TMP <i>or TEMP</i> 6252 </font></font></font></b></td></tr></table> 6253 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>For Microsoft Windows, the path to the directory where applications 6254 should write temporary files. Overridden by <strong>MAGICK_TMPDIR</strong> if it 6255 is set.</td></tr></table> 6256 <table BORDER=0 WIDTH="94%"> 6257 <tr> 6258 <td width="3%"><br></td> 6259 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6260 <img SRC="images/right_triangle_option.png" 6261 ALT=">" BORDER=0 height=14 6262 width=15><b><font face="Helvetica, Arial" 6263 ><font color="#00B04F"><font size="+1"> 6264 OMP_NUM_THREADS 6265 </font></font></font></b></td></tr></table> 6266 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>As per the OpenMP standard, this specifies the number of threads to 6267 use in parallel regions. Some compilers default the number of threads to 6268 use to the number of processor cores available while others default to 6269 just one thread. See the OpenMP specification for other standard 6270 adjustments and your compiler's manual for vendor-specific settings.</td></tr></table> 6271 </td></tr></table> 6272 <p> 6273 <i><a href="#top">Back to Contents</a></i> 6274 </p> 6275 <table BORDER=0 WIDTH="100%"> 6276 <tr> 6277 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 6278 SRC="images/right_triangle.png" ALT=">" BORDER=0 6279 height=14 width=15><b><font face="Helvetica, Arial"><font 6280 color="#00B04F"><font size="+1"> 6281 <a NAME="file"></a>Configuration Files 6282 </font></font></font></b></td></tr></table> 6283 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 6284 <tr><td width="3%"><br></td><td> 6285 <p>GraphicsMagick uses a number of XML format configuration files: 6286 <table BORDER=0 WIDTH="94%"> 6287 <tr> 6288 <td width="3%"><br></td> 6289 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6290 <img SRC="images/right_triangle_option.png" 6291 ALT=">" BORDER=0 height=14 6292 width=15><b><font face="Helvetica, Arial" 6293 ><font color="#00B04F"><font size="+1"> 6294 colors.mgk 6295 </font></font></font></b></td></tr></table> 6296 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>colors configuration file</td></tr></table> 6297 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 6298 <?xml version="1.0"?> 6299 <colormap> 6300 <color name="AliceBlue" red="240" green="248" blue="255" 6301 compliance="SVG, X11, XPM" /> 6302 </colormap> 6303 </pre></font></td></tr></table> 6304 <table BORDER=0 WIDTH="94%"> 6305 <tr> 6306 <td width="3%"><br></td> 6307 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6308 <img SRC="images/right_triangle_option.png" 6309 ALT=">" BORDER=0 height=14 6310 width=15><b><font face="Helvetica, Arial" 6311 ><font color="#00B04F"><font size="+1"> 6312 delegates.mgk 6313 </font></font></font></b></td></tr></table> 6314 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>delegates configuration file</td></tr></table> 6315 <table BORDER=0 WIDTH="94%"> 6316 <tr> 6317 <td width="3%"><br></td> 6318 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6319 <img SRC="images/right_triangle_option.png" 6320 ALT=">" BORDER=0 height=14 6321 width=15><b><font face="Helvetica, Arial" 6322 ><font color="#00B04F"><font size="+1"> 6323 log.mgk 6324 </font></font></font></b></td></tr></table> 6325 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>logging configuration file</td></tr></table> 6326 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 6327 <?xml version="1.0"?> 6328 <magicklog> 6329 <log events="None" /> 6330 <log output="stdout" /> 6331 <log filename="Magick-%d.log" /> 6332 <log generations="3" /> 6333 <log limit="2000" /> 6334 <log format="%t %r %u %p %m/%f/%l/%d:\n %e" /> 6335 </magicklog> 6336 </pre></font></td></tr></table> 6337 <table BORDER=0 WIDTH="94%"> 6338 <tr> 6339 <td width="3%"><br></td> 6340 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6341 <img SRC="images/right_triangle_option.png" 6342 ALT=">" BORDER=0 height=14 6343 width=15><b><font face="Helvetica, Arial" 6344 ><font color="#00B04F"><font size="+1"> 6345 modules.mgk 6346 </font></font></font></b></td></tr></table> 6347 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>loadable modules configuration file</td></tr></table> 6348 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 6349 <?xml version="1.0"?> 6350 <modulemap> 6351 <module magick="8BIM" name="META" /> 6352 </modulemap> 6353 </pre></font></td></tr></table> 6354 <table BORDER=0 WIDTH="94%"> 6355 <tr> 6356 <td width="3%"><br></td> 6357 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6358 <img SRC="images/right_triangle_option.png" 6359 ALT=">" BORDER=0 height=14 6360 width=15><b><font face="Helvetica, Arial" 6361 ><font color="#00B04F"><font size="+1"> 6362 type.mgk 6363 </font></font></font></b></td></tr></table> 6364 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>master type (fonts) configuration file</td></tr></table> 6365 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 6366 <?xml version="1.0"?> 6367 <typemap> 6368 <<strong></strong>include file="type-windows.mgk" /> 6369 <type 6370 name="AvantGarde-Book" 6371 fullname="AvantGarde Book" 6372 family="AvantGarde" 6373 foundry="URW" 6374 weight="400" 6375 style="normal" 6376 stretch="normal" 6377 format="type1" 6378 metrics="/usr/local/share/ghostscript/fonts/a010013l.afm" 6379 glyphs="/usr/local/share/ghostscript/fonts/a010013l.pfb" 6380 /> 6381 </typemap> 6382 </pre></font></td></tr></table> 6383 </td></tr></table> 6384 <p> 6385 <i><a href="#top">Back to Contents</a></i> 6386 </p> 6387 <br> <br> 6388 <table BORDER=0 WIDTH="100%"> 6389 <tr> 6390 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 6391 SRC="images/right_triangle.png" ALT=">" BORDER=0 6392 height=14 width=15><b><font face="Helvetica, Arial"><font 6393 color="#00B04F"><font size="+1"> 6394 <a NAME="animate"></a>gm animate 6395 </font></font></font></b></td></tr></table> 6396 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 6397 <tr><td width="3%"><br></td><td> 6398 <p> 6399 <strong>Animate</strong> displays a sequence of images on any workstation display 6400 running an X server. <strong>animate</strong> first determines the hardware capabilities 6401 of the workstation. If the number of unique colors in an image is less 6402 than or equal to the number the workstation can support, the image is displayed 6403 in an X window. Otherwise the number of colors in the image is first reduced 6404 to match the color resolution of the workstation before it is displayed. 6405 <p> 6406 This means that a continuous-tone 24 bits-per-pixel image can display on 6407 a 8 bit pseudo-color device or monochrome device. In most instances the 6408 reduced color image closely resembles the original. Alternatively, a monochrome 6409 or pseudo-color image sequence can display on a continuous-tone 24 bits-per-pixel 6410 device. 6411 <p> 6412 To help prevent color flashing on X server visuals that have colormaps, 6413 <strong>animate</strong> 6414 creates a single colormap from the image sequence. This can be rather time 6415 consuming. You can speed this operation up by reducing the colors in the 6416 image before you "animate" them. Use <strong>mogrify</strong> to color reduce the 6417 images to a single colormap. See <strong>mogrify(1)</strong> for details. Alternatively, 6418 you can use a Standard Colormap; or a static, direct, or true color visual. 6419 You can define a Standard Colormap with <em>xstdcmap</em>. See <strong>xstdcmap(1)</strong> 6420 for details. This method is recommended for colormapped X server because 6421 it eliminates the need to compute a global colormap. 6422 </td></tr></table> 6423 <p> 6424 <i><a href="#top">Back to Contents</a></i> 6425 </p> 6426 <table BORDER=0 WIDTH="100%"> 6427 <tr> 6428 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 6429 SRC="images/right_triangle.png" ALT=">" BORDER=0 6430 height=14 width=15><b><font face="Helvetica, Arial"><font 6431 color="#00B04F"><font size="+1"> 6432 <a NAME="exam"></a>Examples 6433 </font></font></font></b></td></tr></table> 6434 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 6435 <tr><td width="3%"><br></td><td> 6436 <p> 6437 To animate a set of images of a cockatoo, use: 6438 <pre> 6439 gm animate cockatoo.* 6440 </pre> 6441 <p> 6442 To animate a cockatoo image sequence while using the Standard Colormap 6443 <em>best</em>, use: 6444 <pre> 6445 xstdcmap -best 6446 gm animate -map best cockatoo.* 6447 </pre> 6448 <p> 6449 To animate an image of a cockatoo without a border centered on a backdrop, 6450 use: 6451 <br> <br> 6452 <pre> 6453 gm animate +borderwidth -backdrop cockatoo.* 6454 </pre> 6455 </td></tr></table> 6456 <p> 6457 <i><a href="#top">Back to Contents</a></i> 6458 </p> 6459 <table BORDER=0 WIDTH="100%"> 6460 <tr> 6461 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 6462 SRC="images/right_triangle.png" ALT=">" BORDER=0 6463 height=14 width=15><b><font face="Helvetica, Arial"><font 6464 color="#00B04F"><font size="+1"> 6465 <a NAME="opti"></a>Options 6466 </font></font></font></b></td></tr></table> 6467 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 6468 <tr><td width="3%"><br></td><td> 6469 <p> 6470 For a more detailed description of each option, see 6471 Options, above. 6472 <br> <br> 6473 <table BORDER=0 WIDTH="94%"> 6474 <tr> 6475 <td width="3%"><br></td> 6476 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6477 <img SRC="images/right_triangle_option.png" 6478 ALT=">" BORDER=0 height=14 6479 width=15><b><font face="Helvetica, Arial" 6480 ><font color="#00B04F"><font size="+1"> 6481 <a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i><string></i> 6482 </font></font></font></b></td></tr></table> 6483 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table> 6484 <table BORDER=0 WIDTH="94%"> 6485 <tr> 6486 <td width="3%"><br></td> 6487 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6488 <img SRC="images/right_triangle_option.png" 6489 ALT=">" BORDER=0 height=14 6490 width=15><b><font face="Helvetica, Arial" 6491 ><font color="#00B04F"><font size="+1"> 6492 <a href="GraphicsMagick.html#details-backdrop">-backdrop</a> 6493 </font></font></font></b></td></tr></table> 6494 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the image centered on a backdrop.</td></tr></table> 6495 <table BORDER=0 WIDTH="94%"> 6496 <tr> 6497 <td width="3%"><br></td> 6498 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6499 <img SRC="images/right_triangle_option.png" 6500 ALT=">" BORDER=0 height=14 6501 width=15><b><font face="Helvetica, Arial" 6502 ><font color="#00B04F"><font size="+1"> 6503 <a href="GraphicsMagick.html#details-background">-background</a> <i><color></i> 6504 </font></font></font></b></td></tr></table> 6505 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the background color</td></tr></table> 6506 <table BORDER=0 WIDTH="94%"> 6507 <tr> 6508 <td width="3%"><br></td> 6509 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6510 <img SRC="images/right_triangle_option.png" 6511 ALT=">" BORDER=0 height=14 6512 width=15><b><font face="Helvetica, Arial" 6513 ><font color="#00B04F"><font size="+1"> 6514 <a href="GraphicsMagick.html#details-bordercolor">-bordercolor</a> <i><color></i> 6515 </font></font></font></b></td></tr></table> 6516 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border color</td></tr></table> 6517 <table BORDER=0 WIDTH="94%"> 6518 <tr> 6519 <td width="3%"><br></td> 6520 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6521 <img SRC="images/right_triangle_option.png" 6522 ALT=">" BORDER=0 height=14 6523 width=15><b><font face="Helvetica, Arial" 6524 ><font color="#00B04F"><font size="+1"> 6525 -borderwidth <i><geometry></i> 6526 </font></font></font></b></td></tr></table> 6527 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border width</td></tr></table> 6528 <table BORDER=0 WIDTH="94%"> 6529 <tr> 6530 <td width="3%"><br></td> 6531 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6532 <img SRC="images/right_triangle_option.png" 6533 ALT=">" BORDER=0 height=14 6534 width=15><b><font face="Helvetica, Arial" 6535 ><font color="#00B04F"><font size="+1"> 6536 <a href="GraphicsMagick.html#details-chop">-chop</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i> 6537 </font></font></font></b></td></tr></table> 6538 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove pixels from the interior of an image</td></tr></table> 6539 <table BORDER=0 WIDTH="94%"> 6540 <tr> 6541 <td width="3%"><br></td> 6542 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6543 <img SRC="images/right_triangle_option.png" 6544 ALT=">" BORDER=0 height=14 6545 width=15><b><font face="Helvetica, Arial" 6546 ><font color="#00B04F"><font size="+1"> 6547 <a href="GraphicsMagick.html#details-colormap">-colormap</a> <i><type></i> 6548 </font></font></font></b></td></tr></table> 6549 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>define the colormap type</td></tr></table> 6550 <table BORDER=0 WIDTH="94%"> 6551 <tr> 6552 <td width="3%"><br></td> 6553 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6554 <img SRC="images/right_triangle_option.png" 6555 ALT=">" BORDER=0 height=14 6556 width=15><b><font face="Helvetica, Arial" 6557 ><font color="#00B04F"><font size="+1"> 6558 <a href="GraphicsMagick.html#details-colors">-colors</a> <i><value></i> 6559 </font></font></font></b></td></tr></table> 6560 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table> 6561 <table BORDER=0 WIDTH="94%"> 6562 <tr> 6563 <td width="3%"><br></td> 6564 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6565 <img SRC="images/right_triangle_option.png" 6566 ALT=">" BORDER=0 height=14 6567 width=15><b><font face="Helvetica, Arial" 6568 ><font color="#00B04F"><font size="+1"> 6569 <a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i><value></i> 6570 </font></font></font></b></td></tr></table> 6571 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table> 6572 <table BORDER=0 WIDTH="94%"> 6573 <tr> 6574 <td width="3%"><br></td> 6575 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6576 <img SRC="images/right_triangle_option.png" 6577 ALT=">" BORDER=0 height=14 6578 width=15><b><font face="Helvetica, Arial" 6579 ><font color="#00B04F"><font size="+1"> 6580 <a href="GraphicsMagick.html#details-crop">-crop</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i> 6581 </font></font></font></b></td></tr></table> 6582 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the cropped image</td></tr></table> 6583 <table BORDER=0 WIDTH="94%"> 6584 <tr> 6585 <td width="3%"><br></td> 6586 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6587 <img SRC="images/right_triangle_option.png" 6588 ALT=">" BORDER=0 height=14 6589 width=15><b><font face="Helvetica, Arial" 6590 ><font color="#00B04F"><font size="+1"> 6591 -debug <i><events></i> 6592 </font></font></font></b></td></tr></table> 6593 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table> 6594 <table BORDER=0 WIDTH="94%"> 6595 <tr> 6596 <td width="3%"><br></td> 6597 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6598 <img SRC="images/right_triangle_option.png" 6599 ALT=">" BORDER=0 height=14 6600 width=15><b><font face="Helvetica, Arial" 6601 ><font color="#00B04F"><font size="+1"> 6602 <a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i> 6603 </font></font></font></b></td></tr></table> 6604 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table> 6605 <table BORDER=0 WIDTH="94%"> 6606 <tr> 6607 <td width="3%"><br></td> 6608 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6609 <img SRC="images/right_triangle_option.png" 6610 ALT=">" BORDER=0 height=14 6611 width=15><b><font face="Helvetica, Arial" 6612 ><font color="#00B04F"><font size="+1"> 6613 <a href="GraphicsMagick.html#details-delay">-delay</a> <i><1/100ths of a second></i> 6614 </font></font></font></b></td></tr></table> 6615 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the next image after pausing</td></tr></table> 6616 <table BORDER=0 WIDTH="94%"> 6617 <tr> 6618 <td width="3%"><br></td> 6619 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6620 <img SRC="images/right_triangle_option.png" 6621 ALT=">" BORDER=0 height=14 6622 width=15><b><font face="Helvetica, Arial" 6623 ><font color="#00B04F"><font size="+1"> 6624 <a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i> 6625 </font></font></font></b></td></tr></table> 6626 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table> 6627 <table BORDER=0 WIDTH="94%"> 6628 <tr> 6629 <td width="3%"><br></td> 6630 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6631 <img SRC="images/right_triangle_option.png" 6632 ALT=">" BORDER=0 height=14 6633 width=15><b><font face="Helvetica, Arial" 6634 ><font color="#00B04F"><font size="+1"> 6635 <a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i> 6636 </font></font></font></b></td></tr></table> 6637 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table> 6638 <table BORDER=0 WIDTH="94%"> 6639 <tr> 6640 <td width="3%"><br></td> 6641 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6642 <img SRC="images/right_triangle_option.png" 6643 ALT=">" BORDER=0 height=14 6644 width=15><b><font face="Helvetica, Arial" 6645 ><font color="#00B04F"><font size="+1"> 6646 <a href="GraphicsMagick.html#details-display">-display</a> <i><host:display[.screen]></i> 6647 </font></font></font></b></td></tr></table> 6648 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table> 6649 <table BORDER=0 WIDTH="94%"> 6650 <tr> 6651 <td width="3%"><br></td> 6652 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6653 <img SRC="images/right_triangle_option.png" 6654 ALT=">" BORDER=0 height=14 6655 width=15><b><font face="Helvetica, Arial" 6656 ><font color="#00B04F"><font size="+1"> 6657 <a href="GraphicsMagick.html#details-dispose">-dispose</a> <i><method></i> 6658 </font></font></font></b></td></tr></table> 6659 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table> 6660 <table BORDER=0 WIDTH="94%"> 6661 <tr> 6662 <td width="3%"><br></td> 6663 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6664 <img SRC="images/right_triangle_option.png" 6665 ALT=">" BORDER=0 height=14 6666 width=15><b><font face="Helvetica, Arial" 6667 ><font color="#00B04F"><font size="+1"> 6668 <a href="GraphicsMagick.html#details-dither">-dither</a> 6669 </font></font></font></b></td></tr></table> 6670 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table> 6671 <table BORDER=0 WIDTH="94%"> 6672 <tr> 6673 <td width="3%"><br></td> 6674 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6675 <img SRC="images/right_triangle_option.png" 6676 ALT=">" BORDER=0 height=14 6677 width=15><b><font face="Helvetica, Arial" 6678 ><font color="#00B04F"><font size="+1"> 6679 <a href="GraphicsMagick.html#details-font">-font</a> <i><name></i> 6680 </font></font></font></b></td></tr></table> 6681 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this font when annotating the image with text</td></tr></table> 6682 <table BORDER=0 WIDTH="94%"> 6683 <tr> 6684 <td width="3%"><br></td> 6685 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6686 <img SRC="images/right_triangle_option.png" 6687 ALT=">" BORDER=0 height=14 6688 width=15><b><font face="Helvetica, Arial" 6689 ><font color="#00B04F"><font size="+1"> 6690 <a href="GraphicsMagick.html#details-foreground">-foreground</a> <i><color></i> 6691 </font></font></font></b></td></tr></table> 6692 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>define the foreground color</td></tr></table> 6693 <table BORDER=0 WIDTH="94%"> 6694 <tr> 6695 <td width="3%"><br></td> 6696 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6697 <img SRC="images/right_triangle_option.png" 6698 ALT=">" BORDER=0 height=14 6699 width=15><b><font face="Helvetica, Arial" 6700 ><font color="#00B04F"><font size="+1"> 6701 <a href="GraphicsMagick.html#details-gamma">-gamma</a> <i><value></i> 6702 </font></font></font></b></td></tr></table> 6703 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>level of gamma correction</td></tr></table> 6704 <table BORDER=0 WIDTH="94%"> 6705 <tr> 6706 <td width="3%"><br></td> 6707 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6708 <img SRC="images/right_triangle_option.png" 6709 ALT=">" BORDER=0 height=14 6710 width=15><b><font face="Helvetica, Arial" 6711 ><font color="#00B04F"><font size="+1"> 6712 <a href="GraphicsMagick.html#details-geometry">-geometry</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i>^</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 6713 </font></font></font></b></td></tr></table> 6714 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify dimension, offset, and resize options.</td></tr></table> 6715 <table BORDER=0 WIDTH="94%"> 6716 <tr> 6717 <td width="3%"><br></td> 6718 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6719 <img SRC="images/right_triangle_option.png" 6720 ALT=">" BORDER=0 height=14 6721 width=15><b><font face="Helvetica, Arial" 6722 ><font color="#00B04F"><font size="+1"> 6723 -help 6724 </font></font></font></b></td></tr></table> 6725 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table> 6726 <table BORDER=0 WIDTH="94%"> 6727 <tr> 6728 <td width="3%"><br></td> 6729 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6730 <img SRC="images/right_triangle_option.png" 6731 ALT=">" BORDER=0 height=14 6732 width=15><b><font face="Helvetica, Arial" 6733 ><font color="#00B04F"><font size="+1"> 6734 <a href="GraphicsMagick.html#details-iconGeometry">-iconGeometry</a> <i><geometry></i> 6735 </font></font></font></b></td></tr></table> 6736 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the icon geometry</td></tr></table> 6737 <table BORDER=0 WIDTH="94%"> 6738 <tr> 6739 <td width="3%"><br></td> 6740 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6741 <img SRC="images/right_triangle_option.png" 6742 ALT=">" BORDER=0 height=14 6743 width=15><b><font face="Helvetica, Arial" 6744 ><font color="#00B04F"><font size="+1"> 6745 -iconic 6746 </font></font></font></b></td></tr></table> 6747 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>iconic animation</td></tr></table> 6748 <table BORDER=0 WIDTH="94%"> 6749 <tr> 6750 <td width="3%"><br></td> 6751 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6752 <img SRC="images/right_triangle_option.png" 6753 ALT=">" BORDER=0 height=14 6754 width=15><b><font face="Helvetica, Arial" 6755 ><font color="#00B04F"><font size="+1"> 6756 <a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i> 6757 </font></font></font></b></td></tr></table> 6758 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table> 6759 <table BORDER=0 WIDTH="94%"> 6760 <tr> 6761 <td width="3%"><br></td> 6762 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6763 <img SRC="images/right_triangle_option.png" 6764 ALT=">" BORDER=0 height=14 6765 width=15><b><font face="Helvetica, Arial" 6766 ><font color="#00B04F"><font size="+1"> 6767 <a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i> 6768 </font></font></font></b></td></tr></table> 6769 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table> 6770 <table BORDER=0 WIDTH="94%"> 6771 <tr> 6772 <td width="3%"><br></td> 6773 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6774 <img SRC="images/right_triangle_option.png" 6775 ALT=">" BORDER=0 height=14 6776 width=15><b><font face="Helvetica, Arial" 6777 ><font color="#00B04F"><font size="+1"> 6778 <a href="GraphicsMagick.html#details-log">-log</a> <i><string></i> 6779 </font></font></font></b></td></tr></table> 6780 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table> 6781 <table BORDER=0 WIDTH="94%"> 6782 <tr> 6783 <td width="3%"><br></td> 6784 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6785 <img SRC="images/right_triangle_option.png" 6786 ALT=">" BORDER=0 height=14 6787 width=15><b><font face="Helvetica, Arial" 6788 ><font color="#00B04F"><font size="+1"> 6789 <a href="GraphicsMagick.html#details-map">-map</a> <i><type></i> 6790 </font></font></font></b></td></tr></table> 6791 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display image using this type.</td></tr></table> 6792 <table BORDER=0 WIDTH="94%"> 6793 <tr> 6794 <td width="3%"><br></td> 6795 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6796 <img SRC="images/right_triangle_option.png" 6797 ALT=">" BORDER=0 height=14 6798 width=15><b><font face="Helvetica, Arial" 6799 ><font color="#00B04F"><font size="+1"> 6800 <a href="GraphicsMagick.html#details-matte">-matte</a> 6801 </font></font></font></b></td></tr></table> 6802 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table> 6803 <table BORDER=0 WIDTH="94%"> 6804 <tr> 6805 <td width="3%"><br></td> 6806 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6807 <img SRC="images/right_triangle_option.png" 6808 ALT=">" BORDER=0 height=14 6809 width=15><b><font face="Helvetica, Arial" 6810 ><font color="#00B04F"><font size="+1"> 6811 <a href="GraphicsMagick.html#details-mattecolor">-mattecolor</a> <i><color></i> 6812 </font></font></font></b></td></tr></table> 6813 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the color to be used with the <strong>-frame</strong> option</td></tr></table> 6814 <table BORDER=0 WIDTH="94%"> 6815 <tr> 6816 <td width="3%"><br></td> 6817 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6818 <img SRC="images/right_triangle_option.png" 6819 ALT=">" BORDER=0 height=14 6820 width=15><b><font face="Helvetica, Arial" 6821 ><font color="#00B04F"><font size="+1"> 6822 -monitor 6823 </font></font></font></b></td></tr></table> 6824 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>show progress indication</td></tr></table> 6825 <table BORDER=0 WIDTH="94%"> 6826 <tr> 6827 <td width="3%"><br></td> 6828 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6829 <img SRC="images/right_triangle_option.png" 6830 ALT=">" BORDER=0 height=14 6831 width=15><b><font face="Helvetica, Arial" 6832 ><font color="#00B04F"><font size="+1"> 6833 -monochrome 6834 </font></font></font></b></td></tr></table> 6835 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table> 6836 <table BORDER=0 WIDTH="94%"> 6837 <tr> 6838 <td width="3%"><br></td> 6839 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6840 <img SRC="images/right_triangle_option.png" 6841 ALT=">" BORDER=0 height=14 6842 width=15><b><font face="Helvetica, Arial" 6843 ><font color="#00B04F"><font size="+1"> 6844 -name 6845 </font></font></font></b></td></tr></table> 6846 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name an image</td></tr></table> 6847 <table BORDER=0 WIDTH="94%"> 6848 <tr> 6849 <td width="3%"><br></td> 6850 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6851 <img SRC="images/right_triangle_option.png" 6852 ALT=">" BORDER=0 height=14 6853 width=15><b><font face="Helvetica, Arial" 6854 ><font color="#00B04F"><font size="+1"> 6855 <a href="GraphicsMagick.html#details-noop">-noop</a> 6856 </font></font></font></b></td></tr></table> 6857 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>NOOP (no option)</td></tr></table> 6858 <table BORDER=0 WIDTH="94%"> 6859 <tr> 6860 <td width="3%"><br></td> 6861 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6862 <img SRC="images/right_triangle_option.png" 6863 ALT=">" BORDER=0 height=14 6864 width=15><b><font face="Helvetica, Arial" 6865 ><font color="#00B04F"><font size="+1"> 6866 <a href="GraphicsMagick.html#details-pause">-pause</a> <i><seconds></i> 6867 </font></font></font></b></td></tr></table> 6868 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pause between animation loops [animate]</td></tr></table> 6869 <table BORDER=0 WIDTH="94%"> 6870 <tr> 6871 <td width="3%"><br></td> 6872 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6873 <img SRC="images/right_triangle_option.png" 6874 ALT=">" BORDER=0 height=14 6875 width=15><b><font face="Helvetica, Arial" 6876 ><font color="#00B04F"><font size="+1"> 6877 <a href="GraphicsMagick.html#details-remote">-remote</a> 6878 </font></font></font></b></td></tr></table> 6879 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform a X11 remote operation</td></tr></table> 6880 <table BORDER=0 WIDTH="94%"> 6881 <tr> 6882 <td width="3%"><br></td> 6883 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6884 <img SRC="images/right_triangle_option.png" 6885 ALT=">" BORDER=0 height=14 6886 width=15><b><font face="Helvetica, Arial" 6887 ><font color="#00B04F"><font size="+1"> 6888 <a href="GraphicsMagick.html#details-rotate">-rotate</a> <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 6889 </font></font></font></b></td></tr></table> 6890 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>rotate the image</td></tr></table> 6891 <table BORDER=0 WIDTH="94%"> 6892 <tr> 6893 <td width="3%"><br></td> 6894 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6895 <img SRC="images/right_triangle_option.png" 6896 ALT=">" BORDER=0 height=14 6897 width=15><b><font face="Helvetica, Arial" 6898 ><font color="#00B04F"><font size="+1"> 6899 <a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i> 6900 </font></font></font></b></td></tr></table> 6901 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chroma subsampling factors</td></tr></table> 6902 <table BORDER=0 WIDTH="94%"> 6903 <tr> 6904 <td width="3%"><br></td> 6905 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6906 <img SRC="images/right_triangle_option.png" 6907 ALT=">" BORDER=0 height=14 6908 width=15><b><font face="Helvetica, Arial" 6909 ><font color="#00B04F"><font size="+1"> 6910 <a href="GraphicsMagick.html#details-scenes">-scenes</a> <i><value-value></i> 6911 </font></font></font></b></td></tr></table> 6912 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>range of image scene numbers to read</td></tr></table> 6913 <table BORDER=0 WIDTH="94%"> 6914 <tr> 6915 <td width="3%"><br></td> 6916 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6917 <img SRC="images/right_triangle_option.png" 6918 ALT=">" BORDER=0 height=14 6919 width=15><b><font face="Helvetica, Arial" 6920 ><font color="#00B04F"><font size="+1"> 6921 <a href="GraphicsMagick.html#details-shared-memory">-shared-memory</a> 6922 </font></font></font></b></td></tr></table> 6923 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use shared memory</td></tr></table> 6924 <table BORDER=0 WIDTH="94%"> 6925 <tr> 6926 <td width="3%"><br></td> 6927 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6928 <img SRC="images/right_triangle_option.png" 6929 ALT=">" BORDER=0 height=14 6930 width=15><b><font face="Helvetica, Arial" 6931 ><font color="#00B04F"><font size="+1"> 6932 <a href="GraphicsMagick.html#details-size">-size</a> <i><width>x<height></i>{<i>+offset</i>}<i></i> 6933 </font></font></font></b></td></tr></table> 6934 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table> 6935 <table BORDER=0 WIDTH="94%"> 6936 <tr> 6937 <td width="3%"><br></td> 6938 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6939 <img SRC="images/right_triangle_option.png" 6940 ALT=">" BORDER=0 height=14 6941 width=15><b><font face="Helvetica, Arial" 6942 ><font color="#00B04F"><font size="+1"> 6943 <a href="GraphicsMagick.html#details-text-font">-text-font</a> <i><name></i> 6944 </font></font></font></b></td></tr></table> 6945 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>font for writing fixed-width text</td></tr></table> 6946 <table BORDER=0 WIDTH="94%"> 6947 <tr> 6948 <td width="3%"><br></td> 6949 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6950 <img SRC="images/right_triangle_option.png" 6951 ALT=">" BORDER=0 height=14 6952 width=15><b><font face="Helvetica, Arial" 6953 ><font color="#00B04F"><font size="+1"> 6954 <a href="GraphicsMagick.html#details-title">-title</a> <i><string></i> 6955 </font></font></font></b></td></tr></table> 6956 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign title to displayed image [<em>animate, display, montage</em>]</td></tr></table> 6957 <table BORDER=0 WIDTH="94%"> 6958 <tr> 6959 <td width="3%"><br></td> 6960 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6961 <img SRC="images/right_triangle_option.png" 6962 ALT=">" BORDER=0 height=14 6963 width=15><b><font face="Helvetica, Arial" 6964 ><font color="#00B04F"><font size="+1"> 6965 <a href="GraphicsMagick.html#details-treedepth">-treedepth</a> <i><value></i> 6966 </font></font></font></b></td></tr></table> 6967 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tree depth for the color reduction algorithm</td></tr></table> 6968 <table BORDER=0 WIDTH="94%"> 6969 <tr> 6970 <td width="3%"><br></td> 6971 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6972 <img SRC="images/right_triangle_option.png" 6973 ALT=">" BORDER=0 height=14 6974 width=15><b><font face="Helvetica, Arial" 6975 ><font color="#00B04F"><font size="+1"> 6976 <a href="GraphicsMagick.html#details-trim">-trim</a> 6977 </font></font></font></b></td></tr></table> 6978 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table> 6979 <table BORDER=0 WIDTH="94%"> 6980 <tr> 6981 <td width="3%"><br></td> 6982 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6983 <img SRC="images/right_triangle_option.png" 6984 ALT=">" BORDER=0 height=14 6985 width=15><b><font face="Helvetica, Arial" 6986 ><font color="#00B04F"><font size="+1"> 6987 <a href="GraphicsMagick.html#details-type">-type</a> <i><type></i> 6988 </font></font></font></b></td></tr></table> 6989 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image type</td></tr></table> 6990 <table BORDER=0 WIDTH="94%"> 6991 <tr> 6992 <td width="3%"><br></td> 6993 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6994 <img SRC="images/right_triangle_option.png" 6995 ALT=">" BORDER=0 height=14 6996 width=15><b><font face="Helvetica, Arial" 6997 ><font color="#00B04F"><font size="+1"> 6998 <a href="GraphicsMagick.html#details-verbose">-verbose</a> 6999 </font></font></font></b></td></tr></table> 7000 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table> 7001 <table BORDER=0 WIDTH="94%"> 7002 <tr> 7003 <td width="3%"><br></td> 7004 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7005 <img SRC="images/right_triangle_option.png" 7006 ALT=">" BORDER=0 height=14 7007 width=15><b><font face="Helvetica, Arial" 7008 ><font color="#00B04F"><font size="+1"> 7009 <a href="GraphicsMagick.html#details-version">-version</a> 7010 </font></font></font></b></td></tr></table> 7011 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table> 7012 <table BORDER=0 WIDTH="94%"> 7013 <tr> 7014 <td width="3%"><br></td> 7015 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7016 <img SRC="images/right_triangle_option.png" 7017 ALT=">" BORDER=0 height=14 7018 width=15><b><font face="Helvetica, Arial" 7019 ><font color="#00B04F"><font size="+1"> 7020 <a href="GraphicsMagick.html#details-visual">-visual</a> <i><type></i> 7021 </font></font></font></b></td></tr></table> 7022 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>animate images using this X visual type</td></tr></table> 7023 <table BORDER=0 WIDTH="94%"> 7024 <tr> 7025 <td width="3%"><br></td> 7026 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7027 <img SRC="images/right_triangle_option.png" 7028 ALT=">" BORDER=0 height=14 7029 width=15><b><font face="Helvetica, Arial" 7030 ><font color="#00B04F"><font size="+1"> 7031 <a href="GraphicsMagick.html#details-window">-window</a> <i><id></i> 7032 </font></font></font></b></td></tr></table> 7033 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make image the background of a window</td></tr></table> 7034 <p> 7035 For a more detailed description of each option, see 7036 Options, above. 7037 <br> <br> 7038 <p> 7039 Any option you specify on the command line remains in effect for the group 7040 of images following it, until the group is terminated by the appearance of 7041 any option or <strong>-noop</strong>. For example, to animate three images, the first 7042 with 32 colors, the second with an unlimited number of colors, and the 7043 third with only 16 colors, use: 7044 <br> <br> 7045 <pre> 7046 gm animate -colors 32 cockatoo.1 -noop cockatoo.2 7047 -colors 16 cockatoo.3 7048 </pre> 7049 <p> 7050 <strong>Animate</strong> options can appear on the command line or in your X resources 7051 file. See <em>X(1)</em>. Options on the command line supersede values specified 7052 in your X resources file. 7053 <p>Image filenames may appear in any order on the command line if the image 7054 format is <em>MIFF</em> (refer to <strong>miff(5)</strong> and the 7055 <strong>scene</strong> keyword 7056 is specified in the image. Otherwise the images will display in the order 7057 they appear on the command line. 7058 </td></tr></table> 7059 <p> 7060 <i><a href="#top">Back to Contents</a></i> 7061 </p> 7062 <table BORDER=0 WIDTH="100%"> 7063 <tr> 7064 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7065 SRC="images/right_triangle.png" ALT=">" BORDER=0 7066 height=14 width=15><b><font face="Helvetica, Arial"><font 7067 color="#00B04F"><font size="+1"> 7068 <a NAME="mous"></a>Mouse Buttons 7069 </font></font></font></b></td></tr></table> 7070 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7071 <tr><td width="3%"><br></td><td> 7072 <p> 7073 Press any button to map or unmap the Command widget. See the next section 7074 for more information about the Command widget. 7075 </td></tr></table> 7076 <p> 7077 <i><a href="#top">Back to Contents</a></i> 7078 </p> 7079 <table BORDER=0 WIDTH="100%"> 7080 <tr> 7081 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7082 SRC="images/right_triangle.png" ALT=">" BORDER=0 7083 height=14 width=15><b><font face="Helvetica, Arial"><font 7084 color="#00B04F"><font size="+1"> 7085 <a NAME="comm"></a>Command Widget 7086 </font></font></font></b></td></tr></table> 7087 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7088 <tr><td width="3%"><br></td><td> 7089 <p> 7090 The Command widget lists a number of sub-menus and commands. They are 7091 <ul> 7092 <li><strong>Animate</strong> 7093 <ul> 7094 <li> Open 7095 <li> Play 7096 <li> Step 7097 <li> Repeat 7098 <li> Auto Reverse 7099 </ul> 7100 <li><strong>Speed</strong> 7101 <ul> 7102 <li> Faster 7103 <li> Slower 7104 </ul> 7105 <li><strong>Direction</strong> 7106 <ul> 7107 <li> Forward 7108 <li> Reverse 7109 </ul> 7110 <li><strong>Image Info</strong> 7111 <li><strong>Help</strong> 7112 <li><strong>Quit</strong> 7113 </ul> 7114 <p> 7115 Menu items with a indented triangle have a sub-menu. They are represented 7116 above as the indented items. To access a sub-menu item, move the pointer 7117 to the appropriate menu and press a button and drag. When you find the 7118 desired sub-menu item, release the button and the command is executed. 7119 Move the pointer away from the sub-menu if you decide not to execute a 7120 particular command. 7121 </td></tr></table> 7122 <p> 7123 <i><a href="#top">Back to Contents</a></i> 7124 </p> 7125 <table BORDER=0 WIDTH="100%"> 7126 <tr> 7127 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7128 SRC="images/right_triangle.png" ALT=">" BORDER=0 7129 height=14 width=15><b><font face="Helvetica, Arial"><font 7130 color="#00B04F"><font size="+1"> 7131 <a NAME="keyb"></a>Keyboard Accelerators 7132 </font></font></font></b></td></tr></table> 7133 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7134 <tr><td width="3%"><br></td><td> 7135 <dl> 7136 <dt><strong>Ctl+O</strong></dt> 7137 <dd>Press to load an image from a file.</dd> 7138 <dt><strong>space</strong></dt> 7139 <dd>Press to display the next image in the sequence.</dd> 7140 <dt><strong><</strong></dt> 7141 <dd>Press to speed-up the display of the images. Refer to 7142 <strong>-delay</strong> for more information.</dd> 7143 <dt><strong>></strong></dt> 7144 <dd>Press to slow the display of the images. Refer to 7145 <strong>-delay</strong> for more information.</dd> 7146 <dt><strong>?</strong></dt> 7147 <dd>Press to display information about the image. Press 7148 any key or button to erase the information.</dd> 7149 <dd>This information is printed: image name; image size; 7150 and the total number of unique colors in the image.</dd> 7151 <dt><strong>F1</strong></dt> 7152 <dd>Press to display helpful information about <strong>animate(1)</strong>.</dd> 7153 <dt><strong>Ctl-q</strong></dt> 7154 <dd>Press to discard all images and exit program.</dd> 7155 </dl> 7156 </td></tr></table> 7157 <p> 7158 <i><a href="#top">Back to Contents</a></i> 7159 </p> 7160 <table BORDER=0 WIDTH="100%"> 7161 <tr> 7162 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7163 SRC="images/right_triangle.png" ALT=">" BORDER=0 7164 height=14 width=15><b><font face="Helvetica, Arial"><font 7165 color="#00B04F"><font size="+1"> 7166 <a NAME="xres"></a>X Resources 7167 </font></font></font></b></td></tr></table> 7168 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7169 <tr><td width="3%"><br></td><td> 7170 <p> 7171 <strong>Animate</strong> options can appear on the command line or in your X resource 7172 file. Options on the command line supersede values specified in your X 7173 resource file. See <strong>X(1)</strong> for more information on X resources. 7174 <p> 7175 All <strong>animate</strong> options have a corresponding X resource. In addition, 7176 the <strong>animate</strong> program uses the following X resources: 7177 <dl> 7178 <dt><strong>background</strong> <strong>(</strong><em>class</em> <strong>Background)</strong></dt> 7179 <dd> 7180 Specifies the preferred color to use for the Image window background. The 7181 default is #ccc.</dd> 7182 <dt><strong>borderColor</strong> <strong>(</strong><em>class</em> <strong>BorderColor)</strong></dt> 7183 <dd> 7184 Specifies the preferred color to use for the Image window border. The default 7185 is #ccc.</dd> 7186 <dt><strong>borderWidth</strong> <strong>(</strong><em>class</em> <strong>BorderWidth)</strong></dt> 7187 <dd> 7188 Specifies the width in pixels of the Image window border. The default is 7189 2.</dd> 7190 <dt><strong>font</strong> <strong>(</strong><em>class</em> <strong>Font</strong> <strong>or</strong> <strong>FontList)</strong></dt> 7191 <dd> 7192 Specifies the name of the preferred font to use in normal formatted text. 7193 The default is 14 point <em>Helvetica</em>.</dd> 7194 <dt><strong>foreground</strong> <strong>(</strong><em>class</em> <strong>Foreground)</strong></dt> 7195 <dd> 7196 Specifies the preferred color to use for text within the Image window. 7197 The default is black.</dd> 7198 <dt><strong>geometry</strong> <strong>(</strong><em>class</em> <strong>geometry)</strong></dt> 7199 <dd> 7200 Specifies the preferred size and position of the image window. It is not 7201 necessarily obeyed by all window managers. 7202 Offsets, if present, are handled in <em>X(1)</em> style. A negative x offset is 7203 measured from the right edge of the screen to the right edge of the icon, 7204 and a negative y offset is measured from the bottom edge of the screen 7205 to the bottom edge of the icon.</dd> 7206 <dt><strong>iconGeometry</strong> <strong>(</strong><em>class</em> <strong>IconGeometry)</strong></dt> 7207 <dd> 7208 Specifies the preferred size and position of the application when iconified. 7209 It is not necessarily obeyed by all window managers. 7210 Offsets, if present, are handled in the same manner as in class Geometry.</dd> 7211 <dt><strong>iconic</strong> <strong>(</strong><em>class</em> <strong>Iconic)</strong></dt> 7212 <dd> 7213 This resource indicates that you would prefer that the application's windows 7214 initially not be visible as if the windows had be immediately iconified 7215 by you. Window managers may choose not to honor the application's request.</dd> 7216 <dt><strong>matteColor</strong> <strong>(</strong><em>class</em> <strong>MatteColor)</strong></dt> 7217 <dd> 7218 Specify the color of windows. It is used for the backgrounds of windows, 7219 menus, and notices. A 3D effect is achieved by using highlight and shadow 7220 colors derived from this color. Default value: #ddd.</dd> 7221 <dt><strong>name</strong> <strong>(</strong><em>class</em> <strong>Name)</strong></dt> 7222 <dd> 7223 This resource specifies the name under which resources for the application 7224 should be found. This resource is useful in shell aliases to distinguish 7225 between invocations of an application, without resorting to creating links 7226 to alter the executable file name. The default is the application name.</dd> 7227 <dt><strong>sharedMemory</strong> <strong>(</strong><em>class</em> <strong>SharedMemory)</strong></dt> 7228 <dd> 7229 This resource specifies whether animate should attempt use shared memory 7230 for pixmaps. ImageMagick must be compiled with shared memory support, and 7231 the display must support the MIT-SHM extension. Otherwise, this resource 7232 is ignored. The default is True.</dd> 7233 <dt><strong>text_font</strong> <strong>(</strong><em>class</em> <strong>textFont)</strong></dt> 7234 <dd> 7235 Specifies the name of the preferred font to use in fixed (typewriter style) 7236 formatted text. The default is 14 point <em>Courier</em>.</dd> 7237 <dt><strong>title</strong> <strong>(</strong><em>class</em> <strong>Title)</strong></dt> 7238 <dd> 7239 This resource specifies the title to be used for the Image window. This 7240 information is sometimes used by a window manager to provide some sort 7241 of header identifying the window. The default is the image file name.</dd> 7242 </dl> 7243 </td></tr></table> 7244 <p> 7245 <i><a href="#top">Back to Contents</a></i> 7246 </p> 7247 <br> <br> 7248 <table BORDER=0 WIDTH="100%"> 7249 <tr> 7250 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7251 SRC="images/right_triangle.png" ALT=">" BORDER=0 7252 height=14 width=15><b><font face="Helvetica, Arial"><font 7253 color="#00B04F"><font size="+1"> 7254 <a NAME="batch"></a>gm batch 7255 </font></font></font></b></td></tr></table> 7256 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7257 <tr><td width="3%"><br></td><td> 7258 <table BORDER=0 WIDTH="100%"> 7259 <tr> 7260 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7261 SRC="images/right_triangle.png" ALT=">" BORDER=0 7262 height=14 width=15><b><font face="Helvetica, Arial"><font 7263 color="#00B04F"><font size="+1"> 7264 <a NAME="batch-desc"></a>Description 7265 </font></font></font></b></td></tr></table> 7266 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7267 <tr><td width="3%"><br></td><td> 7268 <p> 7269 <strong>batch</strong> executes an arbitary number of the utility commands 7270 (e.g. <strong>convert</strong>) in the form of a simple linear batch script in 7271 order to improve execution efficiency, and/or to allow use as a 7272 subordinate co-process under the control of an arbitrary script or 7273 program. 7274 </td></tr></table> 7275 <table BORDER=0 WIDTH="100%"> 7276 <tr> 7277 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7278 SRC="images/right_triangle.png" ALT=">" BORDER=0 7279 height=14 width=15><b><font face="Helvetica, Arial"><font 7280 color="#00B04F"><font size="+1"> 7281 <a NAME="batch-exam"></a>Examples 7282 </font></font></font></b></td></tr></table> 7283 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7284 <tr><td width="3%"><br></td><td> 7285 <p> To drive <strong>'gm batch'</strong> using a shell script (or a program 7286 written in any language), have the script/program send commands to 'gm 7287 batch' via its standard input. Specify that standard input should be 7288 used by using <strong>'-'</strong> as the file name. The following example 7289 converts all files matching '*.jpg' to TIFF format while rotating each 7290 file by 90 degrees and stripping all embedded profiles. The shell 7291 script syntax is standard Unix shell: 7292 <pre> 7293 for file in *.jpg 7294 do 7295 outfile=`basename $file .jpg`.tiff 7296 echo convert -verbose "'$file'" -rotate 90 \ 7297 +profile "'*'" "'$outfile'" 7298 done | gm batch -echo on -feedback on - 7299 </pre> 7300 <p> 7301 We can accomplish the same as the previous example by putting all the 7302 commands in a text file and then specifying the name of the text file 7303 as the script to execute: 7304 <pre> 7305 for file in *.jpg 7306 do 7307 outfile=`basename $file .jpg`.tiff 7308 echo convert -verbose "'$file'" -rotate 90 \ 7309 +profile "'*'" "'$outfile'" 7310 done > script.txt 7311 gm batch -echo on -feedback on script.txt 7312 </pre> 7313 </td></tr></table> 7314 <p> 7315 <i><a href="#top">Back to Contents</a></i> 7316 </p> 7317 <table BORDER=0 WIDTH="100%"> 7318 <tr> 7319 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7320 SRC="images/right_triangle.png" ALT=">" BORDER=0 7321 height=14 width=15><b><font face="Helvetica, Arial"><font 7322 color="#00B04F"><font size="+1"> 7323 <a NAME="batch-opti"></a>Options 7324 </font></font></font></b></td></tr></table> 7325 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7326 <tr><td width="3%"><br></td><td> 7327 <p> 7328 Options are processed from left to right and must appear before any filename argument. 7329 <table BORDER=0 WIDTH="94%"> 7330 <tr> 7331 <td width="3%"><br></td> 7332 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7333 <img SRC="images/right_triangle_option.png" 7334 ALT=">" BORDER=0 height=14 7335 width=15><b><font face="Helvetica, Arial" 7336 ><font color="#00B04F"><font size="+1"> 7337 -echo <i>on|off</i> 7338 </font></font></font></b></td></tr></table> 7339 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>command echo on or off</td></tr></table> 7340 <p> 7341 Specify <strong>on</strong> to enable echoing commands to standard output as 7342 they are read or <strong>off</strong> to disable. The default is 7343 <strong>off</strong>. 7344 <table BORDER=0 WIDTH="94%"> 7345 <tr> 7346 <td width="3%"><br></td> 7347 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7348 <img SRC="images/right_triangle_option.png" 7349 ALT=">" BORDER=0 height=14 7350 width=15><b><font face="Helvetica, Arial" 7351 ><font color="#00B04F"><font size="+1"> 7352 -escape <i>unix|windows</i> 7353 </font></font></font></b></td></tr></table> 7354 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Parse using unix or windows syntax</td></tr></table> 7355 <p> 7356 Commands must be parsed from the input stream and escaping needs to be 7357 used to protect spaces or quoting characters in the input. Specify 7358 <strong>unix</strong> to use unix-style command line parsing or <strong>windows</strong> 7359 for Microsoft Windows command shell style parsing. The default depends 7360 on if the software is compiled for Microsoft Windows or for a 7361 Unix-type system (including Cygwin on Microsoft Windows). It is 7362 recommended to use unix syntax because it is more powerful and more 7363 portable. 7364 <table BORDER=0 WIDTH="94%"> 7365 <tr> 7366 <td width="3%"><br></td> 7367 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7368 <img SRC="images/right_triangle_option.png" 7369 ALT=">" BORDER=0 height=14 7370 width=15><b><font face="Helvetica, Arial" 7371 ><font color="#00B04F"><font size="+1"> 7372 -fail <i>text</i> 7373 </font></font></font></b></td></tr></table> 7374 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>text to print if a command fails</td></tr></table> 7375 <p> 7376 When feedback is enabled, this specifies the text to print when the 7377 command fails. The default text is <strong>FAIL</strong>. 7378 <table BORDER=0 WIDTH="94%"> 7379 <tr> 7380 <td width="3%"><br></td> 7381 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7382 <img SRC="images/right_triangle_option.png" 7383 ALT=">" BORDER=0 height=14 7384 width=15><b><font face="Helvetica, Arial" 7385 ><font color="#00B04F"><font size="+1"> 7386 -feedback <i>on|off</i> 7387 </font></font></font></b></td></tr></table> 7388 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable error feedback</td></tr></table> 7389 <p> 7390 Print text (see -pass and -fail options) feedback after each 7391 command to indicate the result, the default is <strong>off</strong>. 7392 <table BORDER=0 WIDTH="94%"> 7393 <tr> 7394 <td width="3%"><br></td> 7395 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7396 <img SRC="images/right_triangle_option.png" 7397 ALT=">" BORDER=0 height=14 7398 width=15><b><font face="Helvetica, Arial" 7399 ><font color="#00B04F"><font size="+1"> 7400 -help 7401 </font></font></font></b></td></tr></table> 7402 <p> 7403 Prints batch command help. 7404 <table BORDER=0 WIDTH="94%"> 7405 <tr> 7406 <td width="3%"><br></td> 7407 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7408 <img SRC="images/right_triangle_option.png" 7409 ALT=">" BORDER=0 height=14 7410 width=15><b><font face="Helvetica, Arial" 7411 ><font color="#00B04F"><font size="+1"> 7412 -pass <i>text</i> 7413 </font></font></font></b></td></tr></table> 7414 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>text to print if a command passes</td></tr></table> 7415 <p> 7416 When feedback is enabled, this specifies the text to print when the 7417 command passes. The default text is <strong>PASS</strong>. 7418 <table BORDER=0 WIDTH="94%"> 7419 <tr> 7420 <td width="3%"><br></td> 7421 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7422 <img SRC="images/right_triangle_option.png" 7423 ALT=">" BORDER=0 height=14 7424 width=15><b><font face="Helvetica, Arial" 7425 ><font color="#00B04F"><font size="+1"> 7426 -prompt <i>text</i> 7427 </font></font></font></b></td></tr></table> 7428 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Prompt text to use for command line</td></tr></table> 7429 <p> 7430 If no filename argument was specified, a simple command prompt appears 7431 where you may enter GraphicsMagick commands. The default prompt is 7432 <strong>GM></strong>. Use this option to change the prompt to something else. 7433 <table BORDER=0 WIDTH="94%"> 7434 <tr> 7435 <td width="3%"><br></td> 7436 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7437 <img SRC="images/right_triangle_option.png" 7438 ALT=">" BORDER=0 height=14 7439 width=15><b><font face="Helvetica, Arial" 7440 ><font color="#00B04F"><font size="+1"> 7441 -stop-on-error <i>on|off</i> 7442 </font></font></font></b></td></tr></table> 7443 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify if command processing stops on error</td></tr></table> 7444 <p> 7445 Normally command processing continues if a command encounters an 7446 error. Specify <strong>-stop-on-error on</strong> to cause processing to quit 7447 immediately on error. 7448 </td></tr></table> 7449 </td></tr></table> 7450 <br> <br> 7451 <table BORDER=0 WIDTH="100%"> 7452 <tr> 7453 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7454 SRC="images/right_triangle.png" ALT=">" BORDER=0 7455 height=14 width=15><b><font face="Helvetica, Arial"><font 7456 color="#00B04F"><font size="+1"> 7457 <a NAME="benchmark"></a>gm benchmark 7458 </font></font></font></b></td></tr></table> 7459 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7460 <tr><td width="3%"><br></td><td> 7461 <table BORDER=0 WIDTH="100%"> 7462 <tr> 7463 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7464 SRC="images/right_triangle.png" ALT=">" BORDER=0 7465 height=14 width=15><b><font face="Helvetica, Arial"><font 7466 color="#00B04F"><font size="+1"> 7467 <a NAME="bench-desc"></a>Description 7468 </font></font></font></b></td></tr></table> 7469 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7470 <tr><td width="3%"><br></td><td> 7471 <p> 7472 <strong>benchmark</strong> executes an arbitrary <strong>gm</strong> utility command 7473 (e.g. <strong>convert</strong>) for one or more loops, and/or a specified 7474 execution time, and reports many execution metrics. For builds using 7475 OpenMP, a mode is provided to execute the benchmark with an increasing 7476 number of threads and provide a report of speedup and multi-thread 7477 execution efficiency. If <strong>benchmark</strong> is used to execute a 7478 command without any additional benchmark options, then the command is 7479 run once. 7480 </td></tr></table> 7481 <table BORDER=0 WIDTH="100%"> 7482 <tr> 7483 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7484 SRC="images/right_triangle.png" ALT=">" BORDER=0 7485 height=14 width=15><b><font face="Helvetica, Arial"><font 7486 color="#00B04F"><font size="+1"> 7487 <a NAME="bench-exam"></a>Examples 7488 </font></font></font></b></td></tr></table> 7489 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7490 <tr><td width="3%"><br></td><td> 7491 <p>To obtain benchmark information for a single execution of a 7492 command: 7493 <pre> 7494 gm benchmark convert input.ppm -gaussian 0x1 output.ppm 7495 </pre> 7496 <p>To obtain benchmark information from 100 iterations of the 7497 command: 7498 <pre> 7499 gm benchmark -iterations 100 convert input.ppm \ 7500 -gaussian 0x1 output.ppm 7501 </pre> 7502 <p>To obtain benchmark information by iterating the command until a 7503 specified amount of time (in seconds) has been consumed: 7504 <pre> 7505 gm benchmark -duration 30 convert input.ppm \ 7506 -gaussian 0x1 output.ppm 7507 </pre> 7508 <p>To obtain a full performance report with an increasing number of 7509 threads (1-32 threads, stepping the number of threads by four each 7510 time): 7511 <pre> 7512 gm benchmark -duration 3 -stepthreads 4 convert \ 7513 input.ppm -gaussian 0x2 output.ppm 7514 </pre> 7515 <p>Here is the interpretation of the output: 7516 <ul> 7517 <li><strong>threads</strong> - number of threads used. 7518 <li><strong>iter</strong> - number of command iterations executed. 7519 <li><strong>user</strong> - total user time consumed. 7520 <li><strong>total</strong> - total elapsed time consumed. 7521 <li><strong>iter/s</strong> - number of command iterations per second. 7522 <li><strong>iter/cpu</strong> - amount of CPU time consumed per iteration. 7523 <li><strong>speedup</strong> - speedup compared with one thread. 7524 <li><strong>karp-flatt</strong> - Karp-Flatt measure of speedup efficiency. 7525 </ul> 7526 <p><em>Please note that the reported "speedup" is based on the 7527 execution time of just one thread. A preliminary warm-up pass is used 7528 before timing the first loop in order to ensure that the CPU is 7529 brought out of power-saving modes and that system caches are warmed 7530 up. Most modern CPUs provide a "turbo" mode where the CPU clock speed 7531 is increased (e.g. by a factor of two) when only one or two cores are 7532 active. If the CPU grows excessively hot (due to insufficient 7533 cooling), then it may dial back its clock rates as a form of thermal 7534 management. These factors result in an under-reporting of speedup 7535 compared to if "turbo" mode was disabled and the CPU does not need to 7536 worry about thermal management. The <strong>powertop</strong> utility available 7537 under Linux and Solaris provides a way to observe CPU core clock rates 7538 while a benchmark is running.</em> 7539 </td></tr></table> 7540 <p> 7541 <i><a href="#top">Back to Contents</a></i> 7542 </p> 7543 <table BORDER=0 WIDTH="100%"> 7544 <tr> 7545 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7546 SRC="images/right_triangle.png" ALT=">" BORDER=0 7547 height=14 width=15><b><font face="Helvetica, Arial"><font 7548 color="#00B04F"><font size="+1"> 7549 <a NAME="bench-opti"></a>Options 7550 </font></font></font></b></td></tr></table> 7551 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7552 <tr><td width="3%"><br></td><td> 7553 <p> Options are processed from left to right and must appear before 7554 any argument. 7555 <table BORDER=0 WIDTH="94%"> 7556 <tr> 7557 <td width="3%"><br></td> 7558 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7559 <img SRC="images/right_triangle_option.png" 7560 ALT=">" BORDER=0 height=14 7561 width=15><b><font face="Helvetica, Arial" 7562 ><font color="#00B04F"><font size="+1"> 7563 -duration <i>duration</i> 7564 </font></font></font></b></td></tr></table> 7565 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>duration to run benchmark</td></tr></table> 7566 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">Specify the number of seconds to run the benchmark. The command is 7567 executed repeatedly until the specified amount of time has 7568 elapsed.</font></td></tr></table> 7569 <table BORDER=0 WIDTH="94%"> 7570 <tr> 7571 <td width="3%"><br></td> 7572 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7573 <img SRC="images/right_triangle_option.png" 7574 ALT=">" BORDER=0 height=14 7575 width=15><b><font face="Helvetica, Arial" 7576 ><font color="#00B04F"><font size="+1"> 7577 -help 7578 </font></font></font></b></td></tr></table> 7579 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 7580 Prints benchmark command help.</font></td></tr></table> 7581 <table BORDER=0 WIDTH="94%"> 7582 <tr> 7583 <td width="3%"><br></td> 7584 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7585 <img SRC="images/right_triangle_option.png" 7586 ALT=">" BORDER=0 height=14 7587 width=15><b><font face="Helvetica, Arial" 7588 ><font color="#00B04F"><font size="+1"> 7589 -iterations <i>loops</i> 7590 </font></font></font></b></td></tr></table> 7591 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>number of command iterations</td></tr></table> 7592 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">Specify the number of iterations to run the benchmark. The command 7593 is executed repeatedly until the specified number of iterations has 7594 been reached.</font></td></tr></table> 7595 <table BORDER=0 WIDTH="94%"> 7596 <tr> 7597 <td width="3%"><br></td> 7598 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7599 <img SRC="images/right_triangle_option.png" 7600 ALT=">" BORDER=0 height=14 7601 width=15><b><font face="Helvetica, Arial" 7602 ><font color="#00B04F"><font size="+1"> 7603 -rawcsv 7604 </font></font></font></b></td></tr></table> 7605 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Print results in CSV format</td></tr></table> 7606 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">Print results in a comma-separated value (CSV) format which is easy 7607 to parse for plotting or importing into a spreadsheet or database. 7608 The values reported are <strong>threads</strong>, <strong>iterations</strong>, 7609 <strong>user_time</strong>, and <strong>elapsed_time</strong>.</font></td></tr></table> 7610 <table BORDER=0 WIDTH="94%"> 7611 <tr> 7612 <td width="3%"><br></td> 7613 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7614 <img SRC="images/right_triangle_option.png" 7615 ALT=">" BORDER=0 height=14 7616 width=15><b><font face="Helvetica, Arial" 7617 ><font color="#00B04F"><font size="+1"> 7618 -stepthreads <i>step</i> 7619 </font></font></font></b></td></tr></table> 7620 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>execute a per-thread benchmark ramp</td></tr></table> 7621 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> Execute a per-thread benchmark ramp, incrementing the number of 7622 threads at each step by the specified value. The maximum number of 7623 threads is taken from the standard <tt>OMP_NUM_THREADS</tt> 7624 environment variable.</font></td></tr></table> 7625 </td></tr></table> 7626 </td></tr></table> 7627 <br> <br> 7628 <table BORDER=0 WIDTH="100%"> 7629 <tr> 7630 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7631 SRC="images/right_triangle.png" ALT=">" BORDER=0 7632 height=14 width=15><b><font face="Helvetica, Arial"><font 7633 color="#00B04F"><font size="+1"> 7634 <a NAME="compare"></a>gm compare 7635 </font></font></font></b></td></tr></table> 7636 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7637 <tr><td width="3%"><br></td><td> 7638 <p> 7639 <strong>compare</strong> compares two similar images using a specified statistical 7640 method (see <strong>-metric</strong>) and/or by writing a difference image 7641 (<strong>-file</strong>), with the altered pixels annotated using a specified 7642 method (see <strong>-highlight-style</strong>) and color (see 7643 <strong>-highlight-color</strong>). <p><em>Reference-image</em> is the original 7644 image and <em>compare-image</em> is the (possibly) altered version, which 7645 should have the same dimensions as <em>reference-image</em>. 7646 </td></tr></table> 7647 <table BORDER=0 WIDTH="100%"> 7648 <tr> 7649 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7650 SRC="images/right_triangle.png" ALT=">" BORDER=0 7651 height=14 width=15><b><font face="Helvetica, Arial"><font 7652 color="#00B04F"><font size="+1"> 7653 <a NAME="comp-exam"></a>Examples 7654 </font></font></font></b></td></tr></table> 7655 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7656 <tr><td width="3%"><br></td><td> 7657 <p> 7658 To compare two images using Mean Square Error (MSE) statistical analysis 7659 use: 7660 <pre> 7661 gm compare -metric mse original.miff compare.miff 7662 </pre> 7663 <p> 7664 To create an annotated difference image use: 7665 <pre> 7666 gm compare -highlight-style assign -highlight-color purple \ 7667 -file diff.miff original.miff compare.miff 7668 </pre> 7669 </td></tr></table> 7670 <p> 7671 <i><a href="#top">Back to Contents</a></i> 7672 </p> 7673 <table BORDER=0 WIDTH="100%"> 7674 <tr> 7675 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7676 SRC="images/right_triangle.png" ALT=">" BORDER=0 7677 height=14 width=15><b><font face="Helvetica, Arial"><font 7678 color="#00B04F"><font size="+1"> 7679 <a NAME="comp-opti"></a>Options 7680 </font></font></font></b></td></tr></table> 7681 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7682 <tr><td width="3%"><br></td><td> 7683 <p> 7684 Options are processed in command line order. Any option you specify on 7685 the command line remains in effect only for the image that follows. All 7686 options are reset to their default values after each image is read. 7687 <p> 7688 For a more detailed description of each option, see 7689 Options, above. 7690 <br> <br> 7691 <table BORDER=0 WIDTH="94%"> 7692 <tr> 7693 <td width="3%"><br></td> 7694 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7695 <img SRC="images/right_triangle_option.png" 7696 ALT=">" BORDER=0 height=14 7697 width=15><b><font face="Helvetica, Arial" 7698 ><font color="#00B04F"><font size="+1"> 7699 <a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i><string></i> 7700 </font></font></font></b></td></tr></table> 7701 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table> 7702 <table BORDER=0 WIDTH="94%"> 7703 <tr> 7704 <td width="3%"><br></td> 7705 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7706 <img SRC="images/right_triangle_option.png" 7707 ALT=">" BORDER=0 height=14 7708 width=15><b><font face="Helvetica, Arial" 7709 ><font color="#00B04F"><font size="+1"> 7710 <a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i><value></i> 7711 </font></font></font></b></td></tr></table> 7712 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table> 7713 <table BORDER=0 WIDTH="94%"> 7714 <tr> 7715 <td width="3%"><br></td> 7716 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7717 <img SRC="images/right_triangle_option.png" 7718 ALT=">" BORDER=0 height=14 7719 width=15><b><font face="Helvetica, Arial" 7720 ><font color="#00B04F"><font size="+1"> 7721 -debug <i><events></i> 7722 </font></font></font></b></td></tr></table> 7723 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table> 7724 <table BORDER=0 WIDTH="94%"> 7725 <tr> 7726 <td width="3%"><br></td> 7727 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7728 <img SRC="images/right_triangle_option.png" 7729 ALT=">" BORDER=0 height=14 7730 width=15><b><font face="Helvetica, Arial" 7731 ><font color="#00B04F"><font size="+1"> 7732 <a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i> 7733 </font></font></font></b></td></tr></table> 7734 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table> 7735 <table BORDER=0 WIDTH="94%"> 7736 <tr> 7737 <td width="3%"><br></td> 7738 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7739 <img SRC="images/right_triangle_option.png" 7740 ALT=">" BORDER=0 height=14 7741 width=15><b><font face="Helvetica, Arial" 7742 ><font color="#00B04F"><font size="+1"> 7743 <a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i> 7744 </font></font></font></b></td></tr></table> 7745 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table> 7746 <table BORDER=0 WIDTH="94%"> 7747 <tr> 7748 <td width="3%"><br></td> 7749 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7750 <img SRC="images/right_triangle_option.png" 7751 ALT=">" BORDER=0 height=14 7752 width=15><b><font face="Helvetica, Arial" 7753 ><font color="#00B04F"><font size="+1"> 7754 <a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i> 7755 </font></font></font></b></td></tr></table> 7756 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table> 7757 <table BORDER=0 WIDTH="94%"> 7758 <tr> 7759 <td width="3%"><br></td> 7760 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7761 <img SRC="images/right_triangle_option.png" 7762 ALT=">" BORDER=0 height=14 7763 width=15><b><font face="Helvetica, Arial" 7764 ><font color="#00B04F"><font size="+1"> 7765 <a href="GraphicsMagick.html#details-display">-display</a> <i><host:display[.screen]></i> 7766 </font></font></font></b></td></tr></table> 7767 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table> 7768 <table BORDER=0 WIDTH="94%"> 7769 <tr> 7770 <td width="3%"><br></td> 7771 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7772 <img SRC="images/right_triangle_option.png" 7773 ALT=">" BORDER=0 height=14 7774 width=15><b><font face="Helvetica, Arial" 7775 ><font color="#00B04F"><font size="+1"> 7776 <a href="GraphicsMagick.html#details-endian">-endian</a> <i><type></i> 7777 </font></font></font></b></td></tr></table> 7778 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify endianness (MSB, LSB, or Native) of image</td></tr></table> 7779 <table BORDER=0 WIDTH="94%"> 7780 <tr> 7781 <td width="3%"><br></td> 7782 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7783 <img SRC="images/right_triangle_option.png" 7784 ALT=">" BORDER=0 height=14 7785 width=15><b><font face="Helvetica, Arial" 7786 ><font color="#00B04F"><font size="+1"> 7787 <a href="GraphicsMagick.html#details-file">-file</a> <i><filename></i> 7788 </font></font></font></b></td></tr></table> 7789 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>write annotated difference image to file</td></tr></table> 7790 <table BORDER=0 WIDTH="94%"> 7791 <tr> 7792 <td width="3%"><br></td> 7793 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7794 <img SRC="images/right_triangle_option.png" 7795 ALT=">" BORDER=0 height=14 7796 width=15><b><font face="Helvetica, Arial" 7797 ><font color="#00B04F"><font size="+1"> 7798 -help 7799 </font></font></font></b></td></tr></table> 7800 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table> 7801 <table BORDER=0 WIDTH="94%"> 7802 <tr> 7803 <td width="3%"><br></td> 7804 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7805 <img SRC="images/right_triangle_option.png" 7806 ALT=">" BORDER=0 height=14 7807 width=15><b><font face="Helvetica, Arial" 7808 ><font color="#00B04F"><font size="+1"> 7809 <a href="GraphicsMagick.html#details-highlight-color">-highlight-color</a> <i><color></i> 7810 </font></font></font></b></td></tr></table> 7811 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pixel annotation color</td></tr></table> 7812 <table BORDER=0 WIDTH="94%"> 7813 <tr> 7814 <td width="3%"><br></td> 7815 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7816 <img SRC="images/right_triangle_option.png" 7817 ALT=">" BORDER=0 height=14 7818 width=15><b><font face="Helvetica, Arial" 7819 ><font color="#00B04F"><font size="+1"> 7820 <a href="GraphicsMagick.html#details-highlight-style">-highlight-style</a> <i><style></i> 7821 </font></font></font></b></td></tr></table> 7822 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pixel annotation style</td></tr></table> 7823 <table BORDER=0 WIDTH="94%"> 7824 <tr> 7825 <td width="3%"><br></td> 7826 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7827 <img SRC="images/right_triangle_option.png" 7828 ALT=">" BORDER=0 height=14 7829 width=15><b><font face="Helvetica, Arial" 7830 ><font color="#00B04F"><font size="+1"> 7831 <a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i> 7832 </font></font></font></b></td></tr></table> 7833 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table> 7834 <table BORDER=0 WIDTH="94%"> 7835 <tr> 7836 <td width="3%"><br></td> 7837 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7838 <img SRC="images/right_triangle_option.png" 7839 ALT=">" BORDER=0 height=14 7840 width=15><b><font face="Helvetica, Arial" 7841 ><font color="#00B04F"><font size="+1"> 7842 <a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i> 7843 </font></font></font></b></td></tr></table> 7844 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table> 7845 <table BORDER=0 WIDTH="94%"> 7846 <tr> 7847 <td width="3%"><br></td> 7848 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7849 <img SRC="images/right_triangle_option.png" 7850 ALT=">" BORDER=0 height=14 7851 width=15><b><font face="Helvetica, Arial" 7852 ><font color="#00B04F"><font size="+1"> 7853 <a href="GraphicsMagick.html#details-log">-log</a> <i><string></i> 7854 </font></font></font></b></td></tr></table> 7855 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table> 7856 <table BORDER=0 WIDTH="94%"> 7857 <tr> 7858 <td width="3%"><br></td> 7859 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7860 <img SRC="images/right_triangle_option.png" 7861 ALT=">" BORDER=0 height=14 7862 width=15><b><font face="Helvetica, Arial" 7863 ><font color="#00B04F"><font size="+1"> 7864 <a href="GraphicsMagick.html#details-matte">-matte</a> 7865 </font></font></font></b></td></tr></table> 7866 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table> 7867 <table BORDER=0 WIDTH="94%"> 7868 <tr> 7869 <td width="3%"><br></td> 7870 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7871 <img SRC="images/right_triangle_option.png" 7872 ALT=">" BORDER=0 height=14 7873 width=15><b><font face="Helvetica, Arial" 7874 ><font color="#00B04F"><font size="+1"> 7875 <a href="GraphicsMagick.html#details-maximum-error">-maximum-error</a> <i><limit></i> 7876 </font></font></font></b></td></tr></table> 7877 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the maximum amount of total image error</td></tr></table> 7878 <table BORDER=0 WIDTH="94%"> 7879 <tr> 7880 <td width="3%"><br></td> 7881 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7882 <img SRC="images/right_triangle_option.png" 7883 ALT=">" BORDER=0 height=14 7884 width=15><b><font face="Helvetica, Arial" 7885 ><font color="#00B04F"><font size="+1"> 7886 -metric <i><metric></i> 7887 </font></font></font></b></td></tr></table> 7888 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>comparison metric (MAE, MSE, PAE, PSNR, RMSE)</td></tr></table> 7889 <table BORDER=0 WIDTH="94%"> 7890 <tr> 7891 <td width="3%"><br></td> 7892 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7893 <img SRC="images/right_triangle_option.png" 7894 ALT=">" BORDER=0 height=14 7895 width=15><b><font face="Helvetica, Arial" 7896 ><font color="#00B04F"><font size="+1"> 7897 -monitor 7898 </font></font></font></b></td></tr></table> 7899 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>show progress indication</td></tr></table> 7900 <table BORDER=0 WIDTH="94%"> 7901 <tr> 7902 <td width="3%"><br></td> 7903 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7904 <img SRC="images/right_triangle_option.png" 7905 ALT=">" BORDER=0 height=14 7906 width=15><b><font face="Helvetica, Arial" 7907 ><font color="#00B04F"><font size="+1"> 7908 <a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i> 7909 </font></font></font></b></td></tr></table> 7910 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chroma subsampling factors</td></tr></table> 7911 <table BORDER=0 WIDTH="94%"> 7912 <tr> 7913 <td width="3%"><br></td> 7914 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7915 <img SRC="images/right_triangle_option.png" 7916 ALT=">" BORDER=0 height=14 7917 width=15><b><font face="Helvetica, Arial" 7918 ><font color="#00B04F"><font size="+1"> 7919 <a href="GraphicsMagick.html#details-size">-size</a> <i><width>x<height></i>{<i>+offset</i>}<i></i> 7920 </font></font></font></b></td></tr></table> 7921 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table> 7922 <table BORDER=0 WIDTH="94%"> 7923 <tr> 7924 <td width="3%"><br></td> 7925 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7926 <img SRC="images/right_triangle_option.png" 7927 ALT=">" BORDER=0 height=14 7928 width=15><b><font face="Helvetica, Arial" 7929 ><font color="#00B04F"><font size="+1"> 7930 <a href="GraphicsMagick.html#details-type">-type</a> <i><type></i> 7931 </font></font></font></b></td></tr></table> 7932 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image type</td></tr></table> 7933 <table BORDER=0 WIDTH="94%"> 7934 <tr> 7935 <td width="3%"><br></td> 7936 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7937 <img SRC="images/right_triangle_option.png" 7938 ALT=">" BORDER=0 height=14 7939 width=15><b><font face="Helvetica, Arial" 7940 ><font color="#00B04F"><font size="+1"> 7941 <a href="GraphicsMagick.html#details-verbose">-verbose</a> 7942 </font></font></font></b></td></tr></table> 7943 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table> 7944 <table BORDER=0 WIDTH="94%"> 7945 <tr> 7946 <td width="3%"><br></td> 7947 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 7948 <img SRC="images/right_triangle_option.png" 7949 ALT=">" BORDER=0 height=14 7950 width=15><b><font face="Helvetica, Arial" 7951 ><font color="#00B04F"><font size="+1"> 7952 <a href="GraphicsMagick.html#details-version">-version</a> 7953 </font></font></font></b></td></tr></table> 7954 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table> 7955 <p> 7956 For a more detailed description of each option, see 7957 Options, above. 7958 <br> <br> 7959 </td></tr></table> 7960 <br> <br> 7961 <table BORDER=0 WIDTH="100%"> 7962 <tr> 7963 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7964 SRC="images/right_triangle.png" ALT=">" BORDER=0 7965 height=14 width=15><b><font face="Helvetica, Arial"><font 7966 color="#00B04F"><font size="+1"> 7967 <a NAME="composite"></a>gm composite 7968 </font></font></font></b></td></tr></table> 7969 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7970 <tr><td width="3%"><br></td><td> 7971 <p> 7972 <strong>composite</strong> composites (combines) images to create new images. 7973 <p><em>base-image</em> is the base image and <em>change-image</em> contains the changes. 7974 <em>ouput-image</em> is the result, and normally has the same dimensions 7975 as <em>base-image</em>. 7976 <br> <br> 7977 <p> 7978 The optional <em>mask-image</em> can be used to provide opacity information 7979 for <em>change-image</em> when it has none or if you want a different mask. 7980 A mask image is typically grayscale and the same size as 7981 <strong>base-image</strong>. If <em>mask-image</em> is not grayscale, it is converted 7982 to grayscale and the resulting intensities are used as opacity 7983 information. 7984 </td></tr></table> 7985 <table BORDER=0 WIDTH="100%"> 7986 <tr> 7987 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 7988 SRC="images/right_triangle.png" ALT=">" BORDER=0 7989 height=14 width=15><b><font face="Helvetica, Arial"><font 7990 color="#00B04F"><font size="+1"> 7991 <a NAME="comp-exam"></a>Examples 7992 </font></font></font></b></td></tr></table> 7993 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 7994 <tr><td width="3%"><br></td><td> 7995 <p> 7996 To composite an image of a cockatoo with a perch, use: 7997 <pre> 7998 gm composite cockatoo.miff perch.ras composite.miff 7999 </pre> 8000 <p> 8001 To compute the difference between images in a series, use: 8002 <pre> 8003 gm composite -compose difference series.2 series.1 8004 difference.miff 8005 </pre> 8006 <p> 8007 To composite an image of a cockatoo with a perch starting at location (100,150), 8008 use: 8009 <pre> 8010 gm composite -geometry +100+150 cockatoo.miff 8011 perch.ras composite.miff 8012 </pre> 8013 <p> 8014 To tile a logo across your image of a cockatoo, use 8015 <pre> 8016 gm convert +shade 30x60 cockatoo.miff mask.miff 8017 gm composite -compose bumpmap -tile logo.png 8018 cockatoo.miff mask.miff composite.miff 8019 </pre> 8020 <p> 8021 To composite a red, green, and blue color plane into a single composite image, 8022 try 8023 <pre> 8024 gm composite -compose CopyGreen green.png red.png 8025 red-green.png 8026 gm composite -compose CopyBlue blue.png red-green.png 8027 gm composite.png 8028 </pre> 8029 </td></tr></table> 8030 <p> 8031 <i><a href="#top">Back to Contents</a></i> 8032 </p> 8033 <table BORDER=0 WIDTH="100%"> 8034 <tr> 8035 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 8036 SRC="images/right_triangle.png" ALT=">" BORDER=0 8037 height=14 width=15><b><font face="Helvetica, Arial"><font 8038 color="#00B04F"><font size="+1"> 8039 <a NAME="comp-opti"></a>Options 8040 </font></font></font></b></td></tr></table> 8041 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 8042 <tr><td width="3%"><br></td><td> 8043 <p> 8044 Options are processed in command line order. Any option you specify on 8045 the command line remains in effect only for the image that follows. All 8046 options are reset to their default values after each image is read. 8047 <p> 8048 For a more detailed description of each option, see 8049 Options, above. 8050 <br> <br> 8051 <table BORDER=0 WIDTH="94%"> 8052 <tr> 8053 <td width="3%"><br></td> 8054 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8055 <img SRC="images/right_triangle_option.png" 8056 ALT=">" BORDER=0 height=14 8057 width=15><b><font face="Helvetica, Arial" 8058 ><font color="#00B04F"><font size="+1"> 8059 <a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i><string></i> 8060 </font></font></font></b></td></tr></table> 8061 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table> 8062 <table BORDER=0 WIDTH="94%"> 8063 <tr> 8064 <td width="3%"><br></td> 8065 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8066 <img SRC="images/right_triangle_option.png" 8067 ALT=">" BORDER=0 height=14 8068 width=15><b><font face="Helvetica, Arial" 8069 ><font color="#00B04F"><font size="+1"> 8070 <a href="GraphicsMagick.html#details-background">-background</a> <i><color></i> 8071 </font></font></font></b></td></tr></table> 8072 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the background color</td></tr></table> 8073 <table BORDER=0 WIDTH="94%"> 8074 <tr> 8075 <td width="3%"><br></td> 8076 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8077 <img SRC="images/right_triangle_option.png" 8078 ALT=">" BORDER=0 height=14 8079 width=15><b><font face="Helvetica, Arial" 8080 ><font color="#00B04F"><font size="+1"> 8081 <a href="GraphicsMagick.html#details-blue-primary">-blue-primary</a> <i><x>,<y></i> 8082 </font></font></font></b></td></tr></table> 8083 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blue chromaticity primary point</td></tr></table> 8084 <table BORDER=0 WIDTH="94%"> 8085 <tr> 8086 <td width="3%"><br></td> 8087 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8088 <img SRC="images/right_triangle_option.png" 8089 ALT=">" BORDER=0 height=14 8090 width=15><b><font face="Helvetica, Arial" 8091 ><font color="#00B04F"><font size="+1"> 8092 <a href="GraphicsMagick.html#details-colors">-colors</a> <i><value></i> 8093 </font></font></font></b></td></tr></table> 8094 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table> 8095 <table BORDER=0 WIDTH="94%"> 8096 <tr> 8097 <td width="3%"><br></td> 8098 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8099 <img SRC="images/right_triangle_option.png" 8100 ALT=">" BORDER=0 height=14 8101 width=15><b><font face="Helvetica, Arial" 8102 ><font color="#00B04F"><font size="+1"> 8103 <a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i><value></i> 8104 </font></font></font></b></td></tr></table> 8105 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table> 8106 <table BORDER=0 WIDTH="94%"> 8107 <tr> 8108 <td width="3%"><br></td> 8109 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8110 <img SRC="images/right_triangle_option.png" 8111 ALT=">" BORDER=0 height=14 8112 width=15><b><font face="Helvetica, Arial" 8113 ><font color="#00B04F"><font size="+1"> 8114 <a href="GraphicsMagick.html#details-comment">-comment</a> <i><string></i> 8115 </font></font></font></b></td></tr></table> 8116 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with a comment</td></tr></table> 8117 <table BORDER=0 WIDTH="94%"> 8118 <tr> 8119 <td width="3%"><br></td> 8120 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8121 <img SRC="images/right_triangle_option.png" 8122 ALT=">" BORDER=0 height=14 8123 width=15><b><font face="Helvetica, Arial" 8124 ><font color="#00B04F"><font size="+1"> 8125 <a href="GraphicsMagick.html#details-compose">-compose</a> <i><operator></i> 8126 </font></font></font></b></td></tr></table> 8127 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image composition</td></tr></table> 8128 <table BORDER=0 WIDTH="94%"> 8129 <tr> 8130 <td width="3%"><br></td> 8131 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8132 <img SRC="images/right_triangle_option.png" 8133 ALT=">" BORDER=0 height=14 8134 width=15><b><font face="Helvetica, Arial" 8135 ><font color="#00B04F"><font size="+1"> 8136 <a href="GraphicsMagick.html#details-compress">-compress</a> <i><type></i> 8137 </font></font></font></b></td></tr></table> 8138 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image compression</td></tr></table> 8139 <table BORDER=0 WIDTH="94%"> 8140 <tr> 8141 <td width="3%"><br></td> 8142 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8143 <img SRC="images/right_triangle_option.png" 8144 ALT=">" BORDER=0 height=14 8145 width=15><b><font face="Helvetica, Arial" 8146 ><font color="#00B04F"><font size="+1"> 8147 -debug <i><events></i> 8148 </font></font></font></b></td></tr></table> 8149 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table> 8150 <table BORDER=0 WIDTH="94%"> 8151 <tr> 8152 <td width="3%"><br></td> 8153 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8154 <img SRC="images/right_triangle_option.png" 8155 ALT=">" BORDER=0 height=14 8156 width=15><b><font face="Helvetica, Arial" 8157 ><font color="#00B04F"><font size="+1"> 8158 <a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i> 8159 </font></font></font></b></td></tr></table> 8160 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table> 8161 <table BORDER=0 WIDTH="94%"> 8162 <tr> 8163 <td width="3%"><br></td> 8164 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8165 <img SRC="images/right_triangle_option.png" 8166 ALT=">" BORDER=0 height=14 8167 width=15><b><font face="Helvetica, Arial" 8168 ><font color="#00B04F"><font size="+1"> 8169 <a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i> 8170 </font></font></font></b></td></tr></table> 8171 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table> 8172 <table BORDER=0 WIDTH="94%"> 8173 <tr> 8174 <td width="3%"><br></td> 8175 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8176 <img SRC="images/right_triangle_option.png" 8177 ALT=">" BORDER=0 height=14 8178 width=15><b><font face="Helvetica, Arial" 8179 ><font color="#00B04F"><font size="+1"> 8180 <a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i> 8181 </font></font></font></b></td></tr></table> 8182 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table> 8183 <table BORDER=0 WIDTH="94%"> 8184 <tr> 8185 <td width="3%"><br></td> 8186 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8187 <img SRC="images/right_triangle_option.png" 8188 ALT=">" BORDER=0 height=14 8189 width=15><b><font face="Helvetica, Arial" 8190 ><font color="#00B04F"><font size="+1"> 8191 <a href="GraphicsMagick.html#details-displace">-displace</a> <i><horizontal scale>x<vertical scale></i> 8192 </font></font></font></b></td></tr></table> 8193 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shift image pixels as defined by a displacement map</td></tr></table> 8194 <table BORDER=0 WIDTH="94%"> 8195 <tr> 8196 <td width="3%"><br></td> 8197 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8198 <img SRC="images/right_triangle_option.png" 8199 ALT=">" BORDER=0 height=14 8200 width=15><b><font face="Helvetica, Arial" 8201 ><font color="#00B04F"><font size="+1"> 8202 <a href="GraphicsMagick.html#details-display">-display</a> <i><host:display[.screen]></i> 8203 </font></font></font></b></td></tr></table> 8204 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table> 8205 <table BORDER=0 WIDTH="94%"> 8206 <tr> 8207 <td width="3%"><br></td> 8208 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8209 <img SRC="images/right_triangle_option.png" 8210 ALT=">" BORDER=0 height=14 8211 width=15><b><font face="Helvetica, Arial" 8212 ><font color="#00B04F"><font size="+1"> 8213 <a href="GraphicsMagick.html#details-dispose">-dispose</a> <i><method></i> 8214 </font></font></font></b></td></tr></table> 8215 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table> 8216 <table BORDER=0 WIDTH="94%"> 8217 <tr> 8218 <td width="3%"><br></td> 8219 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8220 <img SRC="images/right_triangle_option.png" 8221 ALT=">" BORDER=0 height=14 8222 width=15><b><font face="Helvetica, Arial" 8223 ><font color="#00B04F"><font size="+1"> 8224 <a href="GraphicsMagick.html#details-dissolve">-dissolve</a> <i><percent></i> 8225 </font></font></font></b></td></tr></table> 8226 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>dissolve an image into another by the given percent</td></tr></table> 8227 <table BORDER=0 WIDTH="94%"> 8228 <tr> 8229 <td width="3%"><br></td> 8230 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8231 <img SRC="images/right_triangle_option.png" 8232 ALT=">" BORDER=0 height=14 8233 width=15><b><font face="Helvetica, Arial" 8234 ><font color="#00B04F"><font size="+1"> 8235 <a href="GraphicsMagick.html#details-dither">-dither</a> 8236 </font></font></font></b></td></tr></table> 8237 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table> 8238 <table BORDER=0 WIDTH="94%"> 8239 <tr> 8240 <td width="3%"><br></td> 8241 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8242 <img SRC="images/right_triangle_option.png" 8243 ALT=">" BORDER=0 height=14 8244 width=15><b><font face="Helvetica, Arial" 8245 ><font color="#00B04F"><font size="+1"> 8246 <a href="GraphicsMagick.html#details-encoding">-encoding</a> <i><type></i> 8247 </font></font></font></b></td></tr></table> 8248 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the text encoding</td></tr></table> 8249 <table BORDER=0 WIDTH="94%"> 8250 <tr> 8251 <td width="3%"><br></td> 8252 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8253 <img SRC="images/right_triangle_option.png" 8254 ALT=">" BORDER=0 height=14 8255 width=15><b><font face="Helvetica, Arial" 8256 ><font color="#00B04F"><font size="+1"> 8257 <a href="GraphicsMagick.html#details-endian">-endian</a> <i><type></i> 8258 </font></font></font></b></td></tr></table> 8259 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify endianness (MSB, LSB, or Native) of image</td></tr></table> 8260 <table BORDER=0 WIDTH="94%"> 8261 <tr> 8262 <td width="3%"><br></td> 8263 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8264 <img SRC="images/right_triangle_option.png" 8265 ALT=">" BORDER=0 height=14 8266 width=15><b><font face="Helvetica, Arial" 8267 ><font color="#00B04F"><font size="+1"> 8268 <a href="GraphicsMagick.html#details-filter">-filter</a> <i><type></i> 8269 </font></font></font></b></td></tr></table> 8270 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this type of filter when resizing an image</td></tr></table> 8271 <table BORDER=0 WIDTH="94%"> 8272 <tr> 8273 <td width="3%"><br></td> 8274 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8275 <img SRC="images/right_triangle_option.png" 8276 ALT=">" BORDER=0 height=14 8277 width=15><b><font face="Helvetica, Arial" 8278 ><font color="#00B04F"><font size="+1"> 8279 <a href="GraphicsMagick.html#details-font">-font</a> <i><name></i> 8280 </font></font></font></b></td></tr></table> 8281 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this font when annotating the image with text</td></tr></table> 8282 <table BORDER=0 WIDTH="94%"> 8283 <tr> 8284 <td width="3%"><br></td> 8285 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8286 <img SRC="images/right_triangle_option.png" 8287 ALT=">" BORDER=0 height=14 8288 width=15><b><font face="Helvetica, Arial" 8289 ><font color="#00B04F"><font size="+1"> 8290 <a href="GraphicsMagick.html#details-geometry">-geometry</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i>^</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 8291 </font></font></font></b></td></tr></table> 8292 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify dimension, offset, and resize options.</td></tr></table> 8293 <table BORDER=0 WIDTH="94%"> 8294 <tr> 8295 <td width="3%"><br></td> 8296 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8297 <img SRC="images/right_triangle_option.png" 8298 ALT=">" BORDER=0 height=14 8299 width=15><b><font face="Helvetica, Arial" 8300 ><font color="#00B04F"><font size="+1"> 8301 <a href="GraphicsMagick.html#details-gravity">-gravity</a> <i><type></i> 8302 </font></font></font></b></td></tr></table> 8303 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>direction primitive gravitates to when annotating the image.</td></tr></table> 8304 <table BORDER=0 WIDTH="94%"> 8305 <tr> 8306 <td width="3%"><br></td> 8307 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8308 <img SRC="images/right_triangle_option.png" 8309 ALT=">" BORDER=0 height=14 8310 width=15><b><font face="Helvetica, Arial" 8311 ><font color="#00B04F"><font size="+1"> 8312 <a href="GraphicsMagick.html#details-green-primary">-green-primary</a> <i><x>,<y></i> 8313 </font></font></font></b></td></tr></table> 8314 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>green chromaticity primary point</td></tr></table> 8315 <table BORDER=0 WIDTH="94%"> 8316 <tr> 8317 <td width="3%"><br></td> 8318 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8319 <img SRC="images/right_triangle_option.png" 8320 ALT=">" BORDER=0 height=14 8321 width=15><b><font face="Helvetica, Arial" 8322 ><font color="#00B04F"><font size="+1"> 8323 -help 8324 </font></font></font></b></td></tr></table> 8325 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table> 8326 <table BORDER=0 WIDTH="94%"> 8327 <tr> 8328 <td width="3%"><br></td> 8329 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8330 <img SRC="images/right_triangle_option.png" 8331 ALT=">" BORDER=0 height=14 8332 width=15><b><font face="Helvetica, Arial" 8333 ><font color="#00B04F"><font size="+1"> 8334 <a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i> 8335 </font></font></font></b></td></tr></table> 8336 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table> 8337 <table BORDER=0 WIDTH="94%"> 8338 <tr> 8339 <td width="3%"><br></td> 8340 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8341 <img SRC="images/right_triangle_option.png" 8342 ALT=">" BORDER=0 height=14 8343 width=15><b><font face="Helvetica, Arial" 8344 ><font color="#00B04F"><font size="+1"> 8345 <a href="GraphicsMagick.html#details-label">-label</a> <i><name></i> 8346 </font></font></font></b></td></tr></table> 8347 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign a label to an image</td></tr></table> 8348 <table BORDER=0 WIDTH="94%"> 8349 <tr> 8350 <td width="3%"><br></td> 8351 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8352 <img SRC="images/right_triangle_option.png" 8353 ALT=">" BORDER=0 height=14 8354 width=15><b><font face="Helvetica, Arial" 8355 ><font color="#00B04F"><font size="+1"> 8356 <a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i> 8357 </font></font></font></b></td></tr></table> 8358 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table> 8359 <table BORDER=0 WIDTH="94%"> 8360 <tr> 8361 <td width="3%"><br></td> 8362 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8363 <img SRC="images/right_triangle_option.png" 8364 ALT=">" BORDER=0 height=14 8365 width=15><b><font face="Helvetica, Arial" 8366 ><font color="#00B04F"><font size="+1"> 8367 <a href="GraphicsMagick.html#details-log">-log</a> <i><string></i> 8368 </font></font></font></b></td></tr></table> 8369 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table> 8370 <table BORDER=0 WIDTH="94%"> 8371 <tr> 8372 <td width="3%"><br></td> 8373 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8374 <img SRC="images/right_triangle_option.png" 8375 ALT=">" BORDER=0 height=14 8376 width=15><b><font face="Helvetica, Arial" 8377 ><font color="#00B04F"><font size="+1"> 8378 <a href="GraphicsMagick.html#details-matte">-matte</a> 8379 </font></font></font></b></td></tr></table> 8380 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table> 8381 <table BORDER=0 WIDTH="94%"> 8382 <tr> 8383 <td width="3%"><br></td> 8384 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8385 <img SRC="images/right_triangle_option.png" 8386 ALT=">" BORDER=0 height=14 8387 width=15><b><font face="Helvetica, Arial" 8388 ><font color="#00B04F"><font size="+1"> 8389 -monitor 8390 </font></font></font></b></td></tr></table> 8391 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>show progress indication</td></tr></table> 8392 <table BORDER=0 WIDTH="94%"> 8393 <tr> 8394 <td width="3%"><br></td> 8395 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8396 <img SRC="images/right_triangle_option.png" 8397 ALT=">" BORDER=0 height=14 8398 width=15><b><font face="Helvetica, Arial" 8399 ><font color="#00B04F"><font size="+1"> 8400 -monochrome 8401 </font></font></font></b></td></tr></table> 8402 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table> 8403 <table BORDER=0 WIDTH="94%"> 8404 <tr> 8405 <td width="3%"><br></td> 8406 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8407 <img SRC="images/right_triangle_option.png" 8408 ALT=">" BORDER=0 height=14 8409 width=15><b><font face="Helvetica, Arial" 8410 ><font color="#00B04F"><font size="+1"> 8411 <a href="GraphicsMagick.html#details-negate">-negate</a> 8412 </font></font></font></b></td></tr></table> 8413 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>replace every pixel with its complementary color</td></tr></table> 8414 <table BORDER=0 WIDTH="94%"> 8415 <tr> 8416 <td width="3%"><br></td> 8417 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8418 <img SRC="images/right_triangle_option.png" 8419 ALT=">" BORDER=0 height=14 8420 width=15><b><font face="Helvetica, Arial" 8421 ><font color="#00B04F"><font size="+1"> 8422 <a href="GraphicsMagick.html#details-page">-page</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 8423 </font></font></font></b></td></tr></table> 8424 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>size and location of an image canvas</td></tr></table> 8425 <table BORDER=0 WIDTH="94%"> 8426 <tr> 8427 <td width="3%"><br></td> 8428 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8429 <img SRC="images/right_triangle_option.png" 8430 ALT=">" BORDER=0 height=14 8431 width=15><b><font face="Helvetica, Arial" 8432 ><font color="#00B04F"><font size="+1"> 8433 <a href="GraphicsMagick.html#details-profile">-profile</a> <i><filename></i> 8434 </font></font></font></b></td></tr></table> 8435 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add ICM, IPTC, or generic profile to image</td></tr></table> 8436 <table BORDER=0 WIDTH="94%"> 8437 <tr> 8438 <td width="3%"><br></td> 8439 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8440 <img SRC="images/right_triangle_option.png" 8441 ALT=">" BORDER=0 height=14 8442 width=15><b><font face="Helvetica, Arial" 8443 ><font color="#00B04F"><font size="+1"> 8444 <a href="GraphicsMagick.html#details-quality">-quality</a> <i><value></i> 8445 </font></font></font></b></td></tr></table> 8446 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>JPEG/MIFF/PNG/TIFF compression level</td></tr></table> 8447 <table BORDER=0 WIDTH="94%"> 8448 <tr> 8449 <td width="3%"><br></td> 8450 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8451 <img SRC="images/right_triangle_option.png" 8452 ALT=">" BORDER=0 height=14 8453 width=15><b><font face="Helvetica, Arial" 8454 ><font color="#00B04F"><font size="+1"> 8455 <a href="GraphicsMagick.html#details-recolor">-recolor</a> <i><matrix></i> 8456 </font></font></font></b></td></tr></table> 8457 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a color translation matrix to image channels</td></tr></table> 8458 <table BORDER=0 WIDTH="94%"> 8459 <tr> 8460 <td width="3%"><br></td> 8461 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8462 <img SRC="images/right_triangle_option.png" 8463 ALT=">" BORDER=0 height=14 8464 width=15><b><font face="Helvetica, Arial" 8465 ><font color="#00B04F"><font size="+1"> 8466 <a href="GraphicsMagick.html#details-red-primary">-red-primary</a> <i><x>,<y></i> 8467 </font></font></font></b></td></tr></table> 8468 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>red chromaticity primary point</td></tr></table> 8469 <table BORDER=0 WIDTH="94%"> 8470 <tr> 8471 <td width="3%"><br></td> 8472 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8473 <img SRC="images/right_triangle_option.png" 8474 ALT=">" BORDER=0 height=14 8475 width=15><b><font face="Helvetica, Arial" 8476 ><font color="#00B04F"><font size="+1"> 8477 <a href="GraphicsMagick.html#details-render">-render</a> 8478 </font></font></font></b></td></tr></table> 8479 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>render vector operations</td></tr></table> 8480 <table BORDER=0 WIDTH="94%"> 8481 <tr> 8482 <td width="3%"><br></td> 8483 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8484 <img SRC="images/right_triangle_option.png" 8485 ALT=">" BORDER=0 height=14 8486 width=15><b><font face="Helvetica, Arial" 8487 ><font color="#00B04F"><font size="+1"> 8488 <a href="GraphicsMagick.html#details-repage">-repage</a> <i> <width>x<height>+xoff+yoff[!]</i> 8489 </font></font></font></b></td></tr></table> 8490 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Adjust image page offsets</td></tr></table> 8491 <table BORDER=0 WIDTH="94%"> 8492 <tr> 8493 <td width="3%"><br></td> 8494 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8495 <img SRC="images/right_triangle_option.png" 8496 ALT=">" BORDER=0 height=14 8497 width=15><b><font face="Helvetica, Arial" 8498 ><font color="#00B04F"><font size="+1"> 8499 <a href="GraphicsMagick.html#details-resize">-resize</a> <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 8500 </font></font></font></b></td></tr></table> 8501 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image</td></tr></table> 8502 <table BORDER=0 WIDTH="94%"> 8503 <tr> 8504 <td width="3%"><br></td> 8505 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8506 <img SRC="images/right_triangle_option.png" 8507 ALT=">" BORDER=0 height=14 8508 width=15><b><font face="Helvetica, Arial" 8509 ><font color="#00B04F"><font size="+1"> 8510 <a href="GraphicsMagick.html#details-rotate">-rotate</a> <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 8511 </font></font></font></b></td></tr></table> 8512 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>rotate the image</td></tr></table> 8513 <table BORDER=0 WIDTH="94%"> 8514 <tr> 8515 <td width="3%"><br></td> 8516 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8517 <img SRC="images/right_triangle_option.png" 8518 ALT=">" BORDER=0 height=14 8519 width=15><b><font face="Helvetica, Arial" 8520 ><font color="#00B04F"><font size="+1"> 8521 <a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i> 8522 </font></font></font></b></td></tr></table> 8523 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chroma subsampling factors</td></tr></table> 8524 <table BORDER=0 WIDTH="94%"> 8525 <tr> 8526 <td width="3%"><br></td> 8527 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8528 <img SRC="images/right_triangle_option.png" 8529 ALT=">" BORDER=0 height=14 8530 width=15><b><font face="Helvetica, Arial" 8531 ><font color="#00B04F"><font size="+1"> 8532 <a href="GraphicsMagick.html#details-scene">-scene</a> <i><value></i> 8533 </font></font></font></b></td></tr></table> 8534 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set scene number</td></tr></table> 8535 <table BORDER=0 WIDTH="94%"> 8536 <tr> 8537 <td width="3%"><br></td> 8538 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8539 <img SRC="images/right_triangle_option.png" 8540 ALT=">" BORDER=0 height=14 8541 width=15><b><font face="Helvetica, Arial" 8542 ><font color="#00B04F"><font size="+1"> 8543 <a href="GraphicsMagick.html#details-set">-set</a> <i><attribute> <value></i> 8544 </font></font></font></b></td></tr></table> 8545 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set an image attribute</td></tr></table> 8546 <table BORDER=0 WIDTH="94%"> 8547 <tr> 8548 <td width="3%"><br></td> 8549 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8550 <img SRC="images/right_triangle_option.png" 8551 ALT=">" BORDER=0 height=14 8552 width=15><b><font face="Helvetica, Arial" 8553 ><font color="#00B04F"><font size="+1"> 8554 <a href="GraphicsMagick.html#details+set">+set</a> <i><attribute></i> 8555 </font></font></font></b></td></tr></table> 8556 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>unset an image attribute</td></tr></table> 8557 <table BORDER=0 WIDTH="94%"> 8558 <tr> 8559 <td width="3%"><br></td> 8560 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8561 <img SRC="images/right_triangle_option.png" 8562 ALT=">" BORDER=0 height=14 8563 width=15><b><font face="Helvetica, Arial" 8564 ><font color="#00B04F"><font size="+1"> 8565 <a href="GraphicsMagick.html#details-sharpen">-sharpen</a> <i><radius></i>{<i>x<sigma></i>}<i></i> 8566 </font></font></font></b></td></tr></table> 8567 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image</td></tr></table> 8568 <table BORDER=0 WIDTH="94%"> 8569 <tr> 8570 <td width="3%"><br></td> 8571 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8572 <img SRC="images/right_triangle_option.png" 8573 ALT=">" BORDER=0 height=14 8574 width=15><b><font face="Helvetica, Arial" 8575 ><font color="#00B04F"><font size="+1"> 8576 <a href="GraphicsMagick.html#details-size">-size</a> <i><width>x<height></i>{<i>+offset</i>}<i></i> 8577 </font></font></font></b></td></tr></table> 8578 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table> 8579 <table BORDER=0 WIDTH="94%"> 8580 <tr> 8581 <td width="3%"><br></td> 8582 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8583 <img SRC="images/right_triangle_option.png" 8584 ALT=">" BORDER=0 height=14 8585 width=15><b><font face="Helvetica, Arial" 8586 ><font color="#00B04F"><font size="+1"> 8587 <a href="GraphicsMagick.html#details-stegano">-stegano</a> <i><offset></i> 8588 </font></font></font></b></td></tr></table> 8589 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>hide watermark within an image</td></tr></table> 8590 <table BORDER=0 WIDTH="94%"> 8591 <tr> 8592 <td width="3%"><br></td> 8593 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8594 <img SRC="images/right_triangle_option.png" 8595 ALT=">" BORDER=0 height=14 8596 width=15><b><font face="Helvetica, Arial" 8597 ><font color="#00B04F"><font size="+1"> 8598 <a href="GraphicsMagick.html#details-stereo">-stereo</a> 8599 </font></font></font></b></td></tr></table> 8600 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>composite two images to create a stereo anaglyph</td></tr></table> 8601 <table BORDER=0 WIDTH="94%"> 8602 <tr> 8603 <td width="3%"><br></td> 8604 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8605 <img SRC="images/right_triangle_option.png" 8606 ALT=">" BORDER=0 height=14 8607 width=15><b><font face="Helvetica, Arial" 8608 ><font color="#00B04F"><font size="+1"> 8609 <a href="GraphicsMagick.html#details-strip">-strip</a> 8610 </font></font></font></b></td></tr></table> 8611 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove all profiles and text attributes from the image</td></tr></table> 8612 <table BORDER=0 WIDTH="94%"> 8613 <tr> 8614 <td width="3%"><br></td> 8615 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8616 <img SRC="images/right_triangle_option.png" 8617 ALT=">" BORDER=0 height=14 8618 width=15><b><font face="Helvetica, Arial" 8619 ><font color="#00B04F"><font size="+1"> 8620 <a href="GraphicsMagick.html#details-thumbnail">-thumbnail</a> <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 8621 </font></font></font></b></td></tr></table> 8622 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image (quickly)</td></tr></table> 8623 <table BORDER=0 WIDTH="94%"> 8624 <tr> 8625 <td width="3%"><br></td> 8626 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8627 <img SRC="images/right_triangle_option.png" 8628 ALT=">" BORDER=0 height=14 8629 width=15><b><font face="Helvetica, Arial" 8630 ><font color="#00B04F"><font size="+1"> 8631 <a href="GraphicsMagick.html#details-treedepth">-treedepth</a> <i><value></i> 8632 </font></font></font></b></td></tr></table> 8633 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tree depth for the color reduction algorithm</td></tr></table> 8634 <table BORDER=0 WIDTH="94%"> 8635 <tr> 8636 <td width="3%"><br></td> 8637 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8638 <img SRC="images/right_triangle_option.png" 8639 ALT=">" BORDER=0 height=14 8640 width=15><b><font face="Helvetica, Arial" 8641 ><font color="#00B04F"><font size="+1"> 8642 <a href="GraphicsMagick.html#details-trim">-trim</a> 8643 </font></font></font></b></td></tr></table> 8644 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table> 8645 <table BORDER=0 WIDTH="94%"> 8646 <tr> 8647 <td width="3%"><br></td> 8648 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8649 <img SRC="images/right_triangle_option.png" 8650 ALT=">" BORDER=0 height=14 8651 width=15><b><font face="Helvetica, Arial" 8652 ><font color="#00B04F"><font size="+1"> 8653 <a href="GraphicsMagick.html#details-type">-type</a> <i><type></i> 8654 </font></font></font></b></td></tr></table> 8655 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image type</td></tr></table> 8656 <table BORDER=0 WIDTH="94%"> 8657 <tr> 8658 <td width="3%"><br></td> 8659 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8660 <img SRC="images/right_triangle_option.png" 8661 ALT=">" BORDER=0 height=14 8662 width=15><b><font face="Helvetica, Arial" 8663 ><font color="#00B04F"><font size="+1"> 8664 <a href="GraphicsMagick.html#details-units">-units</a> <i><type></i> 8665 </font></font></font></b></td></tr></table> 8666 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the units of image resolution</td></tr></table> 8667 <table BORDER=0 WIDTH="94%"> 8668 <tr> 8669 <td width="3%"><br></td> 8670 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8671 <img SRC="images/right_triangle_option.png" 8672 ALT=">" BORDER=0 height=14 8673 width=15><b><font face="Helvetica, Arial" 8674 ><font color="#00B04F"><font size="+1"> 8675 <a href="GraphicsMagick.html#details-unsharp">-unsharp</a> <i><radius></i>{<i>x<sigma></i>}<i></i>{<i>+<amount></i>}<i></i>{<i>+<threshold></i>}<i></i> 8676 </font></font></font></b></td></tr></table> 8677 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image with an unsharp mask operator</td></tr></table> 8678 <table BORDER=0 WIDTH="94%"> 8679 <tr> 8680 <td width="3%"><br></td> 8681 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8682 <img SRC="images/right_triangle_option.png" 8683 ALT=">" BORDER=0 height=14 8684 width=15><b><font face="Helvetica, Arial" 8685 ><font color="#00B04F"><font size="+1"> 8686 <a href="GraphicsMagick.html#details-verbose">-verbose</a> 8687 </font></font></font></b></td></tr></table> 8688 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table> 8689 <table BORDER=0 WIDTH="94%"> 8690 <tr> 8691 <td width="3%"><br></td> 8692 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8693 <img SRC="images/right_triangle_option.png" 8694 ALT=">" BORDER=0 height=14 8695 width=15><b><font face="Helvetica, Arial" 8696 ><font color="#00B04F"><font size="+1"> 8697 <a href="GraphicsMagick.html#details-version">-version</a> 8698 </font></font></font></b></td></tr></table> 8699 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table> 8700 <table BORDER=0 WIDTH="94%"> 8701 <tr> 8702 <td width="3%"><br></td> 8703 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8704 <img SRC="images/right_triangle_option.png" 8705 ALT=">" BORDER=0 height=14 8706 width=15><b><font face="Helvetica, Arial" 8707 ><font color="#00B04F"><font size="+1"> 8708 -watermark <i><brightness>x<saturation></i> 8709 </font></font></font></b></td></tr></table> 8710 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>percent brightness and saturation of a watermark</td></tr></table> 8711 <table BORDER=0 WIDTH="94%"> 8712 <tr> 8713 <td width="3%"><br></td> 8714 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8715 <img SRC="images/right_triangle_option.png" 8716 ALT=">" BORDER=0 height=14 8717 width=15><b><font face="Helvetica, Arial" 8718 ><font color="#00B04F"><font size="+1"> 8719 <a href="GraphicsMagick.html#details-white-point">-white-point</a> <i><x>,<y></i> 8720 </font></font></font></b></td></tr></table> 8721 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chromaticity white point</td></tr></table> 8722 <table BORDER=0 WIDTH="94%"> 8723 <tr> 8724 <td width="3%"><br></td> 8725 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8726 <img SRC="images/right_triangle_option.png" 8727 ALT=">" BORDER=0 height=14 8728 width=15><b><font face="Helvetica, Arial" 8729 ><font color="#00B04F"><font size="+1"> 8730 <a href="GraphicsMagick.html#details-write">-write</a> <i><filename></i> 8731 </font></font></font></b></td></tr></table> 8732 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>write an intermediate image [<em>convert, composite</em>]</td></tr></table> 8733 <p> 8734 For a more detailed description of each option, see 8735 Options, above. 8736 <br> <br> 8737 </td></tr></table> 8738 <br> <br> 8739 <table BORDER=0 WIDTH="100%"> 8740 <tr> 8741 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 8742 SRC="images/right_triangle.png" ALT=">" BORDER=0 8743 height=14 width=15><b><font face="Helvetica, Arial"><font 8744 color="#00B04F"><font size="+1"> 8745 <a NAME="conjure"></a>gm conjure 8746 </font></font></font></b></td></tr></table> 8747 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 8748 <tr><td width="3%"><br></td><td> 8749 <p> 8750 The Magick scripting language (MSL) will primarily benefit those that 8751 want to accomplish custom image processing tasks but do not wish to 8752 program, or those that do not have access to a Perl interpreter or a 8753 compiler. The interpreter is called conjure and here is an example 8754 script: 8755 <pre> 8756 <?xml version="1.0" encoding="UTF-8"?> 8757 <image size="400x400" > 8758 <read filename="image.gif" /> 8759 <get width="base-width" height="base-height" /> 8760 <resize geometry="%[dimensions]" /> 8761 <get width="width" height="height" /> 8762 <print output= 8763 "Image sized from %[base-width]x%[base-height] 8764 to %[width]x%[height].\n" /> 8765 <write filename="image.png" /> 8766 </image> 8767 </pre> 8768 <p> 8769 invoked with 8770 <pre> 8771 gm conjure -dimensions 400x400 incantation.msl 8772 </pre> 8773 <p> 8774 All operations will closely follow the key/value pairs defined in 8775 PerlMagick, unless otherwise noted. 8776 </td></tr></table> 8777 <p> 8778 <i><a href="#top">Back to Contents</a></i> 8779 </p> 8780 <table BORDER=0 WIDTH="100%"> 8781 <tr> 8782 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 8783 SRC="images/right_triangle.png" ALT=">" BORDER=0 8784 height=14 width=15><b><font face="Helvetica, Arial"><font 8785 color="#00B04F"><font size="+1"> 8786 <a NAME="conj-opti"></a>Options 8787 </font></font></font></b></td></tr></table> 8788 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 8789 <tr><td width="3%"><br></td><td> 8790 <p> 8791 Options are processed in command line order. Any option you specify on 8792 the command line remains in effect until it is explicitly changed by specifying 8793 the option again with a different effect, or if it is changed by a statement 8794 in the scripting language. 8795 <p> 8796 You can define your own keyword/value pairs on the command line. 8797 The script can then use this information when setting values by including 8798 %[keyword] in the string. For example, if you included 8799 "-dimensions 400x400" on the command line, as illustrated above, 8800 then any string 8801 containing "%[dimensions]" would have 400x400 substituted. 8802 The "%[string]" can be used either an entire string, such as 8803 geometry="%[dimensions]" or as a part of a string such as 8804 filename="%[basename].png". 8805 <p> 8806 The keyword can be any string except for the following reserved 8807 strings (in any upper, lower, or mixed case variant): <strong>debug</strong>, 8808 <strong>help</strong>, and <strong>verbose</strong>, whose usage is described below. 8809 <p> 8810 The value can be any string. If 8811 either the keyword or the value contains white space or any 8812 symbols that have special meanings to your shell such as "#", 8813 "|", 8814 or 8815 "%", enclose the string in quotation marks or use "\" to escape the white 8816 space and special symbols. 8817 <p> 8818 Keywords and values are case dependent. "Key", 8819 "key", 8820 and "KEY" would 8821 be three different keywords. 8822 <p> 8823 For a more detailed description of each option, see 8824 Options, above. 8825 <br> <br> 8826 <table BORDER=0 WIDTH="94%"> 8827 <tr> 8828 <td width="3%"><br></td> 8829 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8830 <img SRC="images/right_triangle_option.png" 8831 ALT=">" BORDER=0 height=14 8832 width=15><b><font face="Helvetica, Arial" 8833 ><font color="#00B04F"><font size="+1"> 8834 -debug <i><events></i> 8835 </font></font></font></b></td></tr></table> 8836 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table> 8837 <table BORDER=0 WIDTH="94%"> 8838 <tr> 8839 <td width="3%"><br></td> 8840 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8841 <img SRC="images/right_triangle_option.png" 8842 ALT=">" BORDER=0 height=14 8843 width=15><b><font face="Helvetica, Arial" 8844 ><font color="#00B04F"><font size="+1"> 8845 <a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i> 8846 </font></font></font></b></td></tr></table> 8847 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table> 8848 <table BORDER=0 WIDTH="94%"> 8849 <tr> 8850 <td width="3%"><br></td> 8851 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8852 <img SRC="images/right_triangle_option.png" 8853 ALT=">" BORDER=0 height=14 8854 width=15><b><font face="Helvetica, Arial" 8855 ><font color="#00B04F"><font size="+1"> 8856 -help 8857 </font></font></font></b></td></tr></table> 8858 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table> 8859 <table BORDER=0 WIDTH="94%"> 8860 <tr> 8861 <td width="3%"><br></td> 8862 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8863 <img SRC="images/right_triangle_option.png" 8864 ALT=">" BORDER=0 height=14 8865 width=15><b><font face="Helvetica, Arial" 8866 ><font color="#00B04F"><font size="+1"> 8867 <a href="GraphicsMagick.html#details-log">-log</a> <i><string></i> 8868 </font></font></font></b></td></tr></table> 8869 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table> 8870 <table BORDER=0 WIDTH="94%"> 8871 <tr> 8872 <td width="3%"><br></td> 8873 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8874 <img SRC="images/right_triangle_option.png" 8875 ALT=">" BORDER=0 height=14 8876 width=15><b><font face="Helvetica, Arial" 8877 ><font color="#00B04F"><font size="+1"> 8878 <a href="GraphicsMagick.html#details-verbose">-verbose</a> 8879 </font></font></font></b></td></tr></table> 8880 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table> 8881 <table BORDER=0 WIDTH="94%"> 8882 <tr> 8883 <td width="3%"><br></td> 8884 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 8885 <img SRC="images/right_triangle_option.png" 8886 ALT=">" BORDER=0 height=14 8887 width=15><b><font face="Helvetica, Arial" 8888 ><font color="#00B04F"><font size="+1"> 8889 <a href="GraphicsMagick.html#details-version">-version</a> 8890 </font></font></font></b></td></tr></table> 8891 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table> 8892 </td></tr></table> 8893 <p> 8894 <i><a href="#top">Back to Contents</a></i> 8895 </p> 8896 <table BORDER=0 WIDTH="100%"> 8897 <tr> 8898 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 8899 SRC="images/right_triangle.png" ALT=">" BORDER=0 8900 height=14 width=15><b><font face="Helvetica, Arial"><font 8901 color="#00B04F"><font size="+1"> 8902 <a NAME="conj-msl"></a>Magick Scripting Language 8903 </font></font></font></b></td></tr></table> 8904 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 8905 <tr><td width="3%"><br></td><td> 8906 <p> 8907 The Magick Scripting Language (MSL) presently defines the following 8908 elements and their attributes: 8909 <dl> 8910 <dt><image></dt> 8911 <dd>background, color, id, size</dd> 8912 <dd> 8913 Define a new image object. <strong></image></strong> destroys it. Because of 8914 this, if you wish to reference multiple "subimages" (aka pages or 8915 layers), you can embed one <strong>image</strong> element inside of another. For 8916 example: 8917 </dd> 8918 <dd> 8919 <pre> 8920 <image> 8921 <read filename="input.png" /> 8922 <get width="base-width" height="base-height" /> 8923 <image height="base-height" width="base-width"> 8924 <image /> 8925 <write filename="output.mng" /> 8926 </image> 8927 </pre> 8928 </dd> 8929 <dd> 8930 <pre> 8931 <image size="400x400" /> 8932 </pre> 8933 </dd> 8934 <dt><group></dt> 8935 <dd> 8936 Define a new group of image objects. By default, images are only 8937 valid for the life of their <strong><image></strong>element. 8938 </dd> 8939 <dd> 8940 <pre> 8941 <image> -- creates the image 8942 ..... -- do stuff with it 8943 </image> -- dispose of the image 8944 </pre> 8945 </dd> 8946 <dd> 8947 However, in a group, all images in that group will stay around for the 8948 life of the group: 8949 </dd> 8950 <dd> 8951 <pre> 8952 <group> -- start a group 8953 <image> -- create an image 8954 .... -- do stuff 8955 </image> -- NOOP 8956 <image> -- create another image 8957 .... -- do more stuff 8958 </image> -- NOOP 8959 <write filename="image.mng" /> -- output 8960 </group> -- dispose of both images 8961 </pre> 8962 </dd> 8963 <dt><read></dt> 8964 <dd>filename</dd> 8965 <dd> 8966 Read a new image from a disk file. 8967 </dd> 8968 <dd> 8969 <pre> 8970 <read filename="image.gif" /> 8971 </pre> 8972 </dd> 8973 <dd> 8974 To read two images use 8975 </dd> 8976 <dd> 8977 <pre> 8978 <read filename="image.gif" /> 8979 <read filename="image.png /> 8980 </pre> 8981 </dd> 8982 <dt><write></dt> 8983 <dd>filename</dd> 8984 <dd>Write the image(s) to disk, either as 8985 a single multiple-image file or multiple ones if necessary. 8986 </dd> 8987 <dd> 8988 <pre> 8989 <write filename=image.tiff" /> 8990 </pre> 8991 <dt><get></dt> 8992 <dd>Get any attribute recognized by 8993 PerlMagick's GetAttribute() and stores it as an image attribute for later 8994 use. Currently only <em>width</em> and <em>height</em> are supported.</dd> 8995 <dd> 8996 <pre> 8997 <get width="base-width" height="base-height" /> 8998 <print output="Image size is %[base-width]x%[base-height].\n" /> 8999 </pre> 9000 </dd> 9001 <dt><set></dt> 9002 <dd>background, bordercolor, clip-mask, colorspace, density, 9003 magick, mattecolor, opacity. Set an attribute recognized by 9004 PerlMagick's GetAttribute().</dd> 9005 <dt><profile></dt> 9006 <dd>[profilename]</dd> 9007 <dd> 9008 Read one or more IPTC, ICC or generic profiles from file and assign to image 9009 </dd> 9010 <dd> 9011 <pre> 9012 <profile iptc="profile.iptc" generic="generic.dat" /> 9013 </pre> 9014 </dd> 9015 <dd> 9016 To remove a specified profile use "!" as the filename eg 9017 </dd> 9018 <dd> 9019 <pre> 9020 <profile icm="!" iptc="profile.iptc" /> 9021 </pre> 9022 </dd> 9023 <dt><border></dt> 9024 <dd>fill, geometry, height, width</dd> 9025 <dt><blur></dt> 9026 <dd>radius, sigma</dd> 9027 <dt><charcoal></dt> 9028 <dd>radius, sigma</dd> 9029 <dt><chop></dt> 9030 <dd>geometry, height, width, x, y</dd> 9031 <dt><crop></dt> 9032 <dd>geometry, height, width, x, y</dd> 9033 <dt><composite></dt> 9034 <dd>compose, geometry, gravity, image, x, y</dd> 9035 <dd> 9036 <pre> 9037 <?xml version="1.0" encoding="UTF-8"?> 9038 <group> 9039 <image id="image_01"> 9040 <read filename="cloud3.gif"/> 9041 <resize geometry="250x90"/> 9042 </image> 9043 <image id="image_02"> 9044 <read filename="cloud4.gif"/> 9045 <resize geometry="190x100"/> 9046 </image> 9047 <image> 9048 <read filename="background.jpg"/> 9049 <composite image="image_01" geometry="+740+470"/> 9050 <composite image="image_02" geometry="+390+415"/> 9051 </image> 9052 <write filename="result.png"/> 9053 </group> 9054 </pre> 9055 </dd> 9056 <dt><despeckle></dt> 9057 <dt><emboss></dt> 9058 <dd>radius, sigma</dd> 9059 <dt><enhance></dt> 9060 <dt><equalize></dt> 9061 <dt><edge></dt> 9062 <dd>radius</dd> 9063 <dt><flip></dt> 9064 <dt><flop></dt> 9065 <dt><frame></dt> 9066 <dd>fill, geometry, height, width, x, y, inner, outer</dd> 9067 <dt><flatten></dt> 9068 <dt><get></dt> 9069 <dd>height, width</dd> 9070 <dt><gamma></dt> 9071 <dd>red, green, blue</dd> 9072 <dt><image></dt> 9073 <dd>background, color, id, size</dd> 9074 <dt><implode></dt> 9075 <dd>amount</dd> 9076 <dt><magnify></dt> 9077 <dt><minify></dt> 9078 <dt><medianfilter></dt> 9079 <dd>radius</dd> 9080 <dt><normalize></dt> 9081 <dt><oilpaint></dt> 9082 <dd>radius</dd> 9083 <dt><print></dt> 9084 <dd>output</dd> 9085 <dt><profile></dt> 9086 <dd>[profilename]</dd> 9087 <dt><read></dt> 9088 <dt><resize></dt> 9089 <dd>blur, filter, geometry, height, width</dd> 9090 <dt><roll></dt> 9091 <dd>geometry, x, y</dd> 9092 <dt><rotate></dt> 9093 <dd>degrees</dd> 9094 <dt><reducenoise></dt> 9095 <dd>radius</dd> 9096 <dt><sample></dt> 9097 <dd>geometry, height, width</dd> 9098 <dt><scale></dt> 9099 <dd>geometry, height, width</dd> 9100 <dt><sharpen></dt> 9101 <dd>radius, sigma</dd> 9102 <dt><shave></dt> 9103 <dd>geometry, height, width</dd> 9104 <dt><shear></dt> 9105 <dd>x, y</dd> 9106 <dt><solarize></dt> 9107 <dd>threshold</dd> 9108 <dt><spread></dt> 9109 <dd>radius</dd> 9110 <dt><stegano></dt> 9111 <dd>image</dd> 9112 <dt><stereo></dt> 9113 <dd>image</dd> 9114 <dt><swirl></dt> 9115 <dd>degrees</dd> 9116 <dt><texture></dt> 9117 <dd>image</dd> 9118 <dt><threshold></dt> 9119 <dd>threshold</dd> 9120 <dt><transparent></dt> 9121 <dd>color</dd> 9122 <dt><trim></dt> 9123 </dl> 9124 </td></tr></table> 9125 <br> <br> 9126 <table BORDER=0 WIDTH="100%"> 9127 <tr> 9128 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 9129 SRC="images/right_triangle.png" ALT=">" BORDER=0 9130 height=14 width=15><b><font face="Helvetica, Arial"><font 9131 color="#00B04F"><font size="+1"> 9132 <a convert="top"></a>gm convert 9133 </font></font></font></b></td></tr></table> 9134 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 9135 <tr><td width="3%"><br></td><td> 9136 <p> 9137 <strong>Convert</strong> converts an input file using one image format to an output 9138 file with a differing image format. In addition, various types of image 9139 processing can be performed on the converted image during the conversion 9140 process. <strong>Convert</strong> recognizes the image formats listed in 9141 <em>GraphicsMagick(1)</em>. 9142 <br> <br> 9143 </td></tr></table> 9144 <p> 9145 <i><a href="#top">Back to Contents</a></i> 9146 </p> 9147 <table BORDER=0 WIDTH="100%"> 9148 <tr> 9149 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 9150 SRC="images/right_triangle.png" ALT=">" BORDER=0 9151 height=14 width=15><b><font face="Helvetica, Arial"><font 9152 color="#00B04F"><font size="+1"> 9153 <a NAME="conv-exam"></a>Examples 9154 </font></font></font></b></td></tr></table> 9155 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 9156 <tr><td width="3%"><br></td><td> 9157 <p> 9158 To make a thumbnail of a JPEG image, use: 9159 <pre> 9160 gm convert -size 120x120 cockatoo.jpg -resize 120x120 9161 +profile "*" thumbnail.jpg 9162 </pre> 9163 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 9164 In this example, <tt>'-size 120x120'</tt> gives a hint to the JPEG decoder 9165 that the image is going to be downscaled to 120x120, allowing it to run 9166 faster by avoiding returning full-resolution images to GraphicsMagick for 9167 the subsequent resizing operation. The 9168 <tt>'-resize 120x120'</tt> specifies the desired dimensions of the 9169 output image. It will be scaled so its largest dimension is 120 pixels. The 9170 <tt>'+profile "*"'</tt> removes any ICM, EXIF, IPTC, or other profiles 9171 that might be present in the input and aren't needed in the thumbnail.</font></td></tr></table> 9172 <p> 9173 To convert a <em>MIFF</em> image of a cockatoo to a SUN raster image, use: 9174 <pre> 9175 gm convert cockatoo.miff sun:cockatoo.ras 9176 </pre> 9177 <p> 9178 To convert a multi-page <em>PostScript</em> document to individual FAX pages, 9179 use: 9180 <pre> 9181 gm convert -monochrome document.ps fax:page 9182 </pre> 9183 <p> 9184 To convert a TIFF image to a <em>PostScript</em> A4 page with the image in 9185 the lower left-hand corner, use: 9186 <pre> 9187 gm convert -page A4+0+0 image.tiff document.ps 9188 </pre> 9189 <p> 9190 To convert a raw Gray image with a 128 byte header to a portable graymap, 9191 use: 9192 <pre> 9193 gm convert -depth 8 -size 768x512+128 gray:raw 9194 image.pgm 9195 </pre> 9196 <p> 9197 In this example, "raw" is the input file. Its format is "gray" and it 9198 has the dimensions and number of header bytes specified by the -size 9199 option and the sample depth specified by the 9200 -depth option. The output file is "image.pgm". The suffix ".pgm" 9201 specifies its format. 9202 <p> 9203 To convert a Photo CD image to a TIFF image, use: 9204 <pre> 9205 gm convert -size 1536x1024 img0009.pcd image.tiff 9206 gm convert img0009.pcd[4] image.tiff 9207 </pre> 9208 <p> 9209 To create a visual image directory of all your JPEG images, use: 9210 <pre> 9211 gm convert 'vid:*.jpg' directory.miff 9212 </pre> 9213 <p> 9214 To annotate an image with blue text using font 12x24 at position (100,100), 9215 use: 9216 <pre> 9217 gm convert -font helvetica -fill blue 9218 -draw "text 100,100 Cockatoo" 9219 bird.jpg bird.miff 9220 </pre> 9221 <p> 9222 To tile a 640x480 image with a JPEG texture with bumps use: 9223 <pre> 9224 gm convert -size 640x480 tile:bumps.jpg tiled.png 9225 </pre> 9226 <p> 9227 To surround an icon with an ornamental border to use with Mosaic(1), use: 9228 <pre> 9229 gm convert -mattecolor "#697B8F" -frame 6x6 bird.jpg 9230 icon.png 9231 </pre> 9232 <p> 9233 To create a MNG animation from a DNA molecule sequence, use: 9234 <pre> 9235 gm convert -delay 20 dna.* dna.mng 9236 </pre> 9237 </td></tr></table> 9238 <p> 9239 <i><a href="#top">Back to Contents</a></i> 9240 </p> 9241 <table BORDER=0 WIDTH="100%"> 9242 <tr> 9243 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 9244 SRC="images/right_triangle.png" ALT=">" BORDER=0 9245 height=14 width=15><b><font face="Helvetica, Arial"><font 9246 color="#00B04F"><font size="+1"> 9247 <a NAME="conv-opti"></a>Options 9248 </font></font></font></b></td></tr></table> 9249 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 9250 <tr><td width="3%"><br></td><td> 9251 <p> 9252 Options are processed in command line order. Any option you specify on 9253 the command line remains in effect for the set of images that follows, 9254 until the set is terminated by the appearance of any option or <strong>-noop</strong>. 9255 Some options only affect the decoding of images and others only the encoding. 9256 The latter can appear after the final group of input images. 9257 <p> 9258 For a more detailed description of each option, see 9259 Options, above. 9260 <br> <br> 9261 <table BORDER=0 WIDTH="94%"> 9262 <tr> 9263 <td width="3%"><br></td> 9264 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9265 <img SRC="images/right_triangle_option.png" 9266 ALT=">" BORDER=0 height=14 9267 width=15><b><font face="Helvetica, Arial" 9268 ><font color="#00B04F"><font size="+1"> 9269 <a href="GraphicsMagick.html#details-adjoin">-adjoin</a> 9270 </font></font></font></b></td></tr></table> 9271 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>join images into a single multi-image file</td></tr></table> 9272 <table BORDER=0 WIDTH="94%"> 9273 <tr> 9274 <td width="3%"><br></td> 9275 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9276 <img SRC="images/right_triangle_option.png" 9277 ALT=">" BORDER=0 height=14 9278 width=15><b><font face="Helvetica, Arial" 9279 ><font color="#00B04F"><font size="+1"> 9280 <a href="GraphicsMagick.html#details-affine">-affine</a> <i><matrix></i> 9281 </font></font></font></b></td></tr></table> 9282 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>drawing transform matrix</td></tr></table> 9283 <table BORDER=0 WIDTH="94%"> 9284 <tr> 9285 <td width="3%"><br></td> 9286 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9287 <img SRC="images/right_triangle_option.png" 9288 ALT=">" BORDER=0 height=14 9289 width=15><b><font face="Helvetica, Arial" 9290 ><font color="#00B04F"><font size="+1"> 9291 <a href="GraphicsMagick.html#details-antialias">-antialias</a> 9292 </font></font></font></b></td></tr></table> 9293 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove pixel aliasing</td></tr></table> 9294 <table BORDER=0 WIDTH="94%"> 9295 <tr> 9296 <td width="3%"><br></td> 9297 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9298 <img SRC="images/right_triangle_option.png" 9299 ALT=">" BORDER=0 height=14 9300 width=15><b><font face="Helvetica, Arial" 9301 ><font color="#00B04F"><font size="+1"> 9302 <a href="GraphicsMagick.html#details-append">-append</a> 9303 </font></font></font></b></td></tr></table> 9304 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>append a set of images</td></tr></table> 9305 <table BORDER=0 WIDTH="94%"> 9306 <tr> 9307 <td width="3%"><br></td> 9308 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9309 <img SRC="images/right_triangle_option.png" 9310 ALT=">" BORDER=0 height=14 9311 width=15><b><font face="Helvetica, Arial" 9312 ><font color="#00B04F"><font size="+1"> 9313 <a href="GraphicsMagick.html#details"></a> <i>-asc-cdl <spec></i> 9314 </font></font></font></b></td></tr></table> 9315 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply ASC CDL color transform</td></tr></table> 9316 <table BORDER=0 WIDTH="94%"> 9317 <tr> 9318 <td width="3%"><br></td> 9319 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9320 <img SRC="images/right_triangle_option.png" 9321 ALT=">" BORDER=0 height=14 9322 width=15><b><font face="Helvetica, Arial" 9323 ><font color="#00B04F"><font size="+1"> 9324 <a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i><string></i> 9325 </font></font></font></b></td></tr></table> 9326 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table> 9327 <table BORDER=0 WIDTH="94%"> 9328 <tr> 9329 <td width="3%"><br></td> 9330 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9331 <img SRC="images/right_triangle_option.png" 9332 ALT=">" BORDER=0 height=14 9333 width=15><b><font face="Helvetica, Arial" 9334 ><font color="#00B04F"><font size="+1"> 9335 <a href="GraphicsMagick.html#details-auto-orient">-auto-orient</a> 9336 </font></font></font></b></td></tr></table> 9337 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>orient (rotate) image so it is upright</td></tr></table> 9338 <table BORDER=0 WIDTH="94%"> 9339 <tr> 9340 <td width="3%"><br></td> 9341 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9342 <img SRC="images/right_triangle_option.png" 9343 ALT=">" BORDER=0 height=14 9344 width=15><b><font face="Helvetica, Arial" 9345 ><font color="#00B04F"><font size="+1"> 9346 <a href="GraphicsMagick.html#details-average">-average</a> 9347 </font></font></font></b></td></tr></table> 9348 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>average a set of images</td></tr></table> 9349 <table BORDER=0 WIDTH="94%"> 9350 <tr> 9351 <td width="3%"><br></td> 9352 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9353 <img SRC="images/right_triangle_option.png" 9354 ALT=">" BORDER=0 height=14 9355 width=15><b><font face="Helvetica, Arial" 9356 ><font color="#00B04F"><font size="+1"> 9357 <a href="GraphicsMagick.html#details-background">-background</a> <i><color></i> 9358 </font></font></font></b></td></tr></table> 9359 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the background color</td></tr></table> 9360 <table BORDER=0 WIDTH="94%"> 9361 <tr> 9362 <td width="3%"><br></td> 9363 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9364 <img SRC="images/right_triangle_option.png" 9365 ALT=">" BORDER=0 height=14 9366 width=15><b><font face="Helvetica, Arial" 9367 ><font color="#00B04F"><font size="+1"> 9368 <a href="GraphicsMagick.html#details-black-threshold">-black-threshold</a> <i>red[,green][,blue][,opacity]</i> 9369 </font></font></font></b></td></tr></table> 9370 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pixels below the threshold become black</td></tr></table> 9371 <table BORDER=0 WIDTH="94%"> 9372 <tr> 9373 <td width="3%"><br></td> 9374 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9375 <img SRC="images/right_triangle_option.png" 9376 ALT=">" BORDER=0 height=14 9377 width=15><b><font face="Helvetica, Arial" 9378 ><font color="#00B04F"><font size="+1"> 9379 <a href="GraphicsMagick.html#details-blue-primary">-blue-primary</a> <i><x>,<y></i> 9380 </font></font></font></b></td></tr></table> 9381 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blue chromaticity primary point</td></tr></table> 9382 <table BORDER=0 WIDTH="94%"> 9383 <tr> 9384 <td width="3%"><br></td> 9385 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9386 <img SRC="images/right_triangle_option.png" 9387 ALT=">" BORDER=0 height=14 9388 width=15><b><font face="Helvetica, Arial" 9389 ><font color="#00B04F"><font size="+1"> 9390 <a href="GraphicsMagick.html#details-blur">-blur</a> <i><radius></i>{<i>x<sigma></i>}<i></i> 9391 </font></font></font></b></td></tr></table> 9392 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blur the image with a Gaussian operator</td></tr></table> 9393 <table BORDER=0 WIDTH="94%"> 9394 <tr> 9395 <td width="3%"><br></td> 9396 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9397 <img SRC="images/right_triangle_option.png" 9398 ALT=">" BORDER=0 height=14 9399 width=15><b><font face="Helvetica, Arial" 9400 ><font color="#00B04F"><font size="+1"> 9401 <a href="GraphicsMagick.html#details-border">-border</a> <i><width>x<height></i> 9402 </font></font></font></b></td></tr></table> 9403 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with a border of color</td></tr></table> 9404 <table BORDER=0 WIDTH="94%"> 9405 <tr> 9406 <td width="3%"><br></td> 9407 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9408 <img SRC="images/right_triangle_option.png" 9409 ALT=">" BORDER=0 height=14 9410 width=15><b><font face="Helvetica, Arial" 9411 ><font color="#00B04F"><font size="+1"> 9412 <a href="GraphicsMagick.html#details-bordercolor">-bordercolor</a> <i><color></i> 9413 </font></font></font></b></td></tr></table> 9414 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border color</td></tr></table> 9415 <table BORDER=0 WIDTH="94%"> 9416 <tr> 9417 <td width="3%"><br></td> 9418 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9419 <img SRC="images/right_triangle_option.png" 9420 ALT=">" BORDER=0 height=14 9421 width=15><b><font face="Helvetica, Arial" 9422 ><font color="#00B04F"><font size="+1"> 9423 <a href="GraphicsMagick.html#details-box">-box</a> <i><color></i> 9424 </font></font></font></b></td></tr></table> 9425 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set the color of the annotation bounding box</td></tr></table> 9426 <table BORDER=0 WIDTH="94%"> 9427 <tr> 9428 <td width="3%"><br></td> 9429 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9430 <img SRC="images/right_triangle_option.png" 9431 ALT=">" BORDER=0 height=14 9432 width=15><b><font face="Helvetica, Arial" 9433 ><font color="#00B04F"><font size="+1"> 9434 <a href="GraphicsMagick.html#details-channel">-channel</a> <i><type></i> 9435 </font></font></font></b></td></tr></table> 9436 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of channel</td></tr></table> 9437 <table BORDER=0 WIDTH="94%"> 9438 <tr> 9439 <td width="3%"><br></td> 9440 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9441 <img SRC="images/right_triangle_option.png" 9442 ALT=">" BORDER=0 height=14 9443 width=15><b><font face="Helvetica, Arial" 9444 ><font color="#00B04F"><font size="+1"> 9445 -charcoal <i><factor></i> 9446 </font></font></font></b></td></tr></table> 9447 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>simulate a charcoal drawing</td></tr></table> 9448 <table BORDER=0 WIDTH="94%"> 9449 <tr> 9450 <td width="3%"><br></td> 9451 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9452 <img SRC="images/right_triangle_option.png" 9453 ALT=">" BORDER=0 height=14 9454 width=15><b><font face="Helvetica, Arial" 9455 ><font color="#00B04F"><font size="+1"> 9456 <a href="GraphicsMagick.html#details-chop">-chop</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i> 9457 </font></font></font></b></td></tr></table> 9458 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove pixels from the interior of an image</td></tr></table> 9459 <table BORDER=0 WIDTH="94%"> 9460 <tr> 9461 <td width="3%"><br></td> 9462 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9463 <img SRC="images/right_triangle_option.png" 9464 ALT=">" BORDER=0 height=14 9465 width=15><b><font face="Helvetica, Arial" 9466 ><font color="#00B04F"><font size="+1"> 9467 <a href="GraphicsMagick.html#details-clip">-clip</a> 9468 </font></font></font></b></td></tr></table> 9469 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply the clipping path, if one is present</td></tr></table> 9470 <table BORDER=0 WIDTH="94%"> 9471 <tr> 9472 <td width="3%"><br></td> 9473 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9474 <img SRC="images/right_triangle_option.png" 9475 ALT=">" BORDER=0 height=14 9476 width=15><b><font face="Helvetica, Arial" 9477 ><font color="#00B04F"><font size="+1"> 9478 <a href="GraphicsMagick.html#details-coalesce">-coalesce</a> 9479 </font></font></font></b></td></tr></table> 9480 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>merge a sequence of images</td></tr></table> 9481 <table BORDER=0 WIDTH="94%"> 9482 <tr> 9483 <td width="3%"><br></td> 9484 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9485 <img SRC="images/right_triangle_option.png" 9486 ALT=">" BORDER=0 height=14 9487 width=15><b><font face="Helvetica, Arial" 9488 ><font color="#00B04F"><font size="+1"> 9489 <a href="GraphicsMagick.html#details-colorize">-colorize</a> <i><value></i> 9490 </font></font></font></b></td></tr></table> 9491 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>colorize the image with the pen color</td></tr></table> 9492 <table BORDER=0 WIDTH="94%"> 9493 <tr> 9494 <td width="3%"><br></td> 9495 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9496 <img SRC="images/right_triangle_option.png" 9497 ALT=">" BORDER=0 height=14 9498 width=15><b><font face="Helvetica, Arial" 9499 ><font color="#00B04F"><font size="+1"> 9500 <a href="GraphicsMagick.html#details-colors">-colors</a> <i><value></i> 9501 </font></font></font></b></td></tr></table> 9502 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table> 9503 <table BORDER=0 WIDTH="94%"> 9504 <tr> 9505 <td width="3%"><br></td> 9506 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9507 <img SRC="images/right_triangle_option.png" 9508 ALT=">" BORDER=0 height=14 9509 width=15><b><font face="Helvetica, Arial" 9510 ><font color="#00B04F"><font size="+1"> 9511 <a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i><value></i> 9512 </font></font></font></b></td></tr></table> 9513 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table> 9514 <table BORDER=0 WIDTH="94%"> 9515 <tr> 9516 <td width="3%"><br></td> 9517 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9518 <img SRC="images/right_triangle_option.png" 9519 ALT=">" BORDER=0 height=14 9520 width=15><b><font face="Helvetica, Arial" 9521 ><font color="#00B04F"><font size="+1"> 9522 <a href="GraphicsMagick.html#details-comment">-comment</a> <i><string></i> 9523 </font></font></font></b></td></tr></table> 9524 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with a comment</td></tr></table> 9525 <table BORDER=0 WIDTH="94%"> 9526 <tr> 9527 <td width="3%"><br></td> 9528 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9529 <img SRC="images/right_triangle_option.png" 9530 ALT=">" BORDER=0 height=14 9531 width=15><b><font face="Helvetica, Arial" 9532 ><font color="#00B04F"><font size="+1"> 9533 <a href="GraphicsMagick.html#details-compose">-compose</a> <i><operator></i> 9534 </font></font></font></b></td></tr></table> 9535 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image composition</td></tr></table> 9536 <table BORDER=0 WIDTH="94%"> 9537 <tr> 9538 <td width="3%"><br></td> 9539 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9540 <img SRC="images/right_triangle_option.png" 9541 ALT=">" BORDER=0 height=14 9542 width=15><b><font face="Helvetica, Arial" 9543 ><font color="#00B04F"><font size="+1"> 9544 <a href="GraphicsMagick.html#details-compress">-compress</a> <i><type></i> 9545 </font></font></font></b></td></tr></table> 9546 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image compression</td></tr></table> 9547 <table BORDER=0 WIDTH="94%"> 9548 <tr> 9549 <td width="3%"><br></td> 9550 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9551 <img SRC="images/right_triangle_option.png" 9552 ALT=">" BORDER=0 height=14 9553 width=15><b><font face="Helvetica, Arial" 9554 ><font color="#00B04F"><font size="+1"> 9555 <a href="GraphicsMagick.html#details-contrast">-contrast</a> 9556 </font></font></font></b></td></tr></table> 9557 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enhance or reduce the image contrast</td></tr></table> 9558 <table BORDER=0 WIDTH="94%"> 9559 <tr> 9560 <td width="3%"><br></td> 9561 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9562 <img SRC="images/right_triangle_option.png" 9563 ALT=">" BORDER=0 height=14 9564 width=15><b><font face="Helvetica, Arial" 9565 ><font color="#00B04F"><font size="+1"> 9566 <a href="GraphicsMagick.html#details-convolve">-convolve</a> <i><kernel></i> 9567 </font></font></font></b></td></tr></table> 9568 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>convolve image with the specified convolution kernel</td></tr></table> 9569 <table BORDER=0 WIDTH="94%"> 9570 <tr> 9571 <td width="3%"><br></td> 9572 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9573 <img SRC="images/right_triangle_option.png" 9574 ALT=">" BORDER=0 height=14 9575 width=15><b><font face="Helvetica, Arial" 9576 ><font color="#00B04F"><font size="+1"> 9577 <a href="GraphicsMagick.html#details-crop">-crop</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i> 9578 </font></font></font></b></td></tr></table> 9579 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the cropped image</td></tr></table> 9580 <table BORDER=0 WIDTH="94%"> 9581 <tr> 9582 <td width="3%"><br></td> 9583 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9584 <img SRC="images/right_triangle_option.png" 9585 ALT=">" BORDER=0 height=14 9586 width=15><b><font face="Helvetica, Arial" 9587 ><font color="#00B04F"><font size="+1"> 9588 <a href="GraphicsMagick.html#details-cycle">-cycle</a> <i><amount></i> 9589 </font></font></font></b></td></tr></table> 9590 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>displace image colormap by amount</td></tr></table> 9591 <table BORDER=0 WIDTH="94%"> 9592 <tr> 9593 <td width="3%"><br></td> 9594 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9595 <img SRC="images/right_triangle_option.png" 9596 ALT=">" BORDER=0 height=14 9597 width=15><b><font face="Helvetica, Arial" 9598 ><font color="#00B04F"><font size="+1"> 9599 -debug <i><events></i> 9600 </font></font></font></b></td></tr></table> 9601 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table> 9602 <table BORDER=0 WIDTH="94%"> 9603 <tr> 9604 <td width="3%"><br></td> 9605 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9606 <img SRC="images/right_triangle_option.png" 9607 ALT=">" BORDER=0 height=14 9608 width=15><b><font face="Helvetica, Arial" 9609 ><font color="#00B04F"><font size="+1"> 9610 <a href="GraphicsMagick.html#details-deconstruct">-deconstruct</a> 9611 </font></font></font></b></td></tr></table> 9612 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>break down an image sequence into constituent parts</td></tr></table> 9613 <table BORDER=0 WIDTH="94%"> 9614 <tr> 9615 <td width="3%"><br></td> 9616 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9617 <img SRC="images/right_triangle_option.png" 9618 ALT=">" BORDER=0 height=14 9619 width=15><b><font face="Helvetica, Arial" 9620 ><font color="#00B04F"><font size="+1"> 9621 <a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i> 9622 </font></font></font></b></td></tr></table> 9623 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table> 9624 <table BORDER=0 WIDTH="94%"> 9625 <tr> 9626 <td width="3%"><br></td> 9627 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9628 <img SRC="images/right_triangle_option.png" 9629 ALT=">" BORDER=0 height=14 9630 width=15><b><font face="Helvetica, Arial" 9631 ><font color="#00B04F"><font size="+1"> 9632 <a href="GraphicsMagick.html#details-delay">-delay</a> <i><1/100ths of a second></i> 9633 </font></font></font></b></td></tr></table> 9634 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the next image after pausing</td></tr></table> 9635 <table BORDER=0 WIDTH="94%"> 9636 <tr> 9637 <td width="3%"><br></td> 9638 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9639 <img SRC="images/right_triangle_option.png" 9640 ALT=">" BORDER=0 height=14 9641 width=15><b><font face="Helvetica, Arial" 9642 ><font color="#00B04F"><font size="+1"> 9643 <a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i> 9644 </font></font></font></b></td></tr></table> 9645 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table> 9646 <table BORDER=0 WIDTH="94%"> 9647 <tr> 9648 <td width="3%"><br></td> 9649 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9650 <img SRC="images/right_triangle_option.png" 9651 ALT=">" BORDER=0 height=14 9652 width=15><b><font face="Helvetica, Arial" 9653 ><font color="#00B04F"><font size="+1"> 9654 <a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i> 9655 </font></font></font></b></td></tr></table> 9656 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table> 9657 <table BORDER=0 WIDTH="94%"> 9658 <tr> 9659 <td width="3%"><br></td> 9660 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9661 <img SRC="images/right_triangle_option.png" 9662 ALT=">" BORDER=0 height=14 9663 width=15><b><font face="Helvetica, Arial" 9664 ><font color="#00B04F"><font size="+1"> 9665 -despeckle 9666 </font></font></font></b></td></tr></table> 9667 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>reduce the speckles within an image</td></tr></table> 9668 <table BORDER=0 WIDTH="94%"> 9669 <tr> 9670 <td width="3%"><br></td> 9671 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9672 <img SRC="images/right_triangle_option.png" 9673 ALT=">" BORDER=0 height=14 9674 width=15><b><font face="Helvetica, Arial" 9675 ><font color="#00B04F"><font size="+1"> 9676 <a href="GraphicsMagick.html#details-display">-display</a> <i><host:display[.screen]></i> 9677 </font></font></font></b></td></tr></table> 9678 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table> 9679 <table BORDER=0 WIDTH="94%"> 9680 <tr> 9681 <td width="3%"><br></td> 9682 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9683 <img SRC="images/right_triangle_option.png" 9684 ALT=">" BORDER=0 height=14 9685 width=15><b><font face="Helvetica, Arial" 9686 ><font color="#00B04F"><font size="+1"> 9687 <a href="GraphicsMagick.html#details-dispose">-dispose</a> <i><method></i> 9688 </font></font></font></b></td></tr></table> 9689 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table> 9690 <table BORDER=0 WIDTH="94%"> 9691 <tr> 9692 <td width="3%"><br></td> 9693 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9694 <img SRC="images/right_triangle_option.png" 9695 ALT=">" BORDER=0 height=14 9696 width=15><b><font face="Helvetica, Arial" 9697 ><font color="#00B04F"><font size="+1"> 9698 <a href="GraphicsMagick.html#details-dither">-dither</a> 9699 </font></font></font></b></td></tr></table> 9700 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table> 9701 <table BORDER=0 WIDTH="94%"> 9702 <tr> 9703 <td width="3%"><br></td> 9704 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9705 <img SRC="images/right_triangle_option.png" 9706 ALT=">" BORDER=0 height=14 9707 width=15><b><font face="Helvetica, Arial" 9708 ><font color="#00B04F"><font size="+1"> 9709 <a href="GraphicsMagick.html#details-draw">-draw</a> <i><string></i> 9710 </font></font></font></b></td></tr></table> 9711 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with one or more graphic primitives</td></tr></table> 9712 <table BORDER=0 WIDTH="94%"> 9713 <tr> 9714 <td width="3%"><br></td> 9715 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9716 <img SRC="images/right_triangle_option.png" 9717 ALT=">" BORDER=0 height=14 9718 width=15><b><font face="Helvetica, Arial" 9719 ><font color="#00B04F"><font size="+1"> 9720 -edge <i><radius></i> 9721 </font></font></font></b></td></tr></table> 9722 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>detect edges within an image</td></tr></table> 9723 <table BORDER=0 WIDTH="94%"> 9724 <tr> 9725 <td width="3%"><br></td> 9726 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9727 <img SRC="images/right_triangle_option.png" 9728 ALT=">" BORDER=0 height=14 9729 width=15><b><font face="Helvetica, Arial" 9730 ><font color="#00B04F"><font size="+1"> 9731 -emboss <i><radius></i> 9732 </font></font></font></b></td></tr></table> 9733 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>emboss an image</td></tr></table> 9734 <table BORDER=0 WIDTH="94%"> 9735 <tr> 9736 <td width="3%"><br></td> 9737 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9738 <img SRC="images/right_triangle_option.png" 9739 ALT=">" BORDER=0 height=14 9740 width=15><b><font face="Helvetica, Arial" 9741 ><font color="#00B04F"><font size="+1"> 9742 <a href="GraphicsMagick.html#details-encoding">-encoding</a> <i><type></i> 9743 </font></font></font></b></td></tr></table> 9744 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the text encoding</td></tr></table> 9745 <table BORDER=0 WIDTH="94%"> 9746 <tr> 9747 <td width="3%"><br></td> 9748 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9749 <img SRC="images/right_triangle_option.png" 9750 ALT=">" BORDER=0 height=14 9751 width=15><b><font face="Helvetica, Arial" 9752 ><font color="#00B04F"><font size="+1"> 9753 <a href="GraphicsMagick.html#details-endian">-endian</a> <i><type></i> 9754 </font></font></font></b></td></tr></table> 9755 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify endianness (MSB, LSB, or Native) of image</td></tr></table> 9756 <table BORDER=0 WIDTH="94%"> 9757 <tr> 9758 <td width="3%"><br></td> 9759 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9760 <img SRC="images/right_triangle_option.png" 9761 ALT=">" BORDER=0 height=14 9762 width=15><b><font face="Helvetica, Arial" 9763 ><font color="#00B04F"><font size="+1"> 9764 -enhance 9765 </font></font></font></b></td></tr></table> 9766 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a digital filter to enhance a noisy image</td></tr></table> 9767 <table BORDER=0 WIDTH="94%"> 9768 <tr> 9769 <td width="3%"><br></td> 9770 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9771 <img SRC="images/right_triangle_option.png" 9772 ALT=">" BORDER=0 height=14 9773 width=15><b><font face="Helvetica, Arial" 9774 ><font color="#00B04F"><font size="+1"> 9775 -equalize 9776 </font></font></font></b></td></tr></table> 9777 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform histogram equalization to the image</td></tr></table> 9778 <table BORDER=0 WIDTH="94%"> 9779 <tr> 9780 <td width="3%"><br></td> 9781 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9782 <img SRC="images/right_triangle_option.png" 9783 ALT=">" BORDER=0 height=14 9784 width=15><b><font face="Helvetica, Arial" 9785 ><font color="#00B04F"><font size="+1"> 9786 <a href="GraphicsMagick.html#details-extent">-extent</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i> 9787 </font></font></font></b></td></tr></table> 9788 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>composite image on background color canvas image</td></tr></table> 9789 <table BORDER=0 WIDTH="94%"> 9790 <tr> 9791 <td width="3%"><br></td> 9792 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9793 <img SRC="images/right_triangle_option.png" 9794 ALT=">" BORDER=0 height=14 9795 width=15><b><font face="Helvetica, Arial" 9796 ><font color="#00B04F"><font size="+1"> 9797 <a href="GraphicsMagick.html#details-fill">-fill</a> <i><color></i> 9798 </font></font></font></b></td></tr></table> 9799 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color to use when filling a graphic primitive</td></tr></table> 9800 <table BORDER=0 WIDTH="94%"> 9801 <tr> 9802 <td width="3%"><br></td> 9803 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9804 <img SRC="images/right_triangle_option.png" 9805 ALT=">" BORDER=0 height=14 9806 width=15><b><font face="Helvetica, Arial" 9807 ><font color="#00B04F"><font size="+1"> 9808 <a href="GraphicsMagick.html#details-filter">-filter</a> <i><type></i> 9809 </font></font></font></b></td></tr></table> 9810 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this type of filter when resizing an image</td></tr></table> 9811 <table BORDER=0 WIDTH="94%"> 9812 <tr> 9813 <td width="3%"><br></td> 9814 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9815 <img SRC="images/right_triangle_option.png" 9816 ALT=">" BORDER=0 height=14 9817 width=15><b><font face="Helvetica, Arial" 9818 ><font color="#00B04F"><font size="+1"> 9819 <a href="GraphicsMagick.html#details-flatten">-flatten</a> 9820 </font></font></font></b></td></tr></table> 9821 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>flatten a sequence of images</td></tr></table> 9822 <table BORDER=0 WIDTH="94%"> 9823 <tr> 9824 <td width="3%"><br></td> 9825 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9826 <img SRC="images/right_triangle_option.png" 9827 ALT=">" BORDER=0 height=14 9828 width=15><b><font face="Helvetica, Arial" 9829 ><font color="#00B04F"><font size="+1"> 9830 <a href="GraphicsMagick.html#details-flip">-flip</a> 9831 </font></font></font></b></td></tr></table> 9832 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table> 9833 <table BORDER=0 WIDTH="94%"> 9834 <tr> 9835 <td width="3%"><br></td> 9836 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9837 <img SRC="images/right_triangle_option.png" 9838 ALT=">" BORDER=0 height=14 9839 width=15><b><font face="Helvetica, Arial" 9840 ><font color="#00B04F"><font size="+1"> 9841 <a href="GraphicsMagick.html#details-flop">-flop</a> 9842 </font></font></font></b></td></tr></table> 9843 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table> 9844 <table BORDER=0 WIDTH="94%"> 9845 <tr> 9846 <td width="3%"><br></td> 9847 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9848 <img SRC="images/right_triangle_option.png" 9849 ALT=">" BORDER=0 height=14 9850 width=15><b><font face="Helvetica, Arial" 9851 ><font color="#00B04F"><font size="+1"> 9852 <a href="GraphicsMagick.html#details-font">-font</a> <i><name></i> 9853 </font></font></font></b></td></tr></table> 9854 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this font when annotating the image with text</td></tr></table> 9855 <table BORDER=0 WIDTH="94%"> 9856 <tr> 9857 <td width="3%"><br></td> 9858 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9859 <img SRC="images/right_triangle_option.png" 9860 ALT=">" BORDER=0 height=14 9861 width=15><b><font face="Helvetica, Arial" 9862 ><font color="#00B04F"><font size="+1"> 9863 <a href="GraphicsMagick.html#details-format">-format</a> <i><string></i> 9864 </font></font></font></b></td></tr></table> 9865 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>output formatted image characteristics</td></tr></table> 9866 <table BORDER=0 WIDTH="94%"> 9867 <tr> 9868 <td width="3%"><br></td> 9869 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9870 <img SRC="images/right_triangle_option.png" 9871 ALT=">" BORDER=0 height=14 9872 width=15><b><font face="Helvetica, Arial" 9873 ><font color="#00B04F"><font size="+1"> 9874 <a href="GraphicsMagick.html#details-frame">-frame</a> <i><width>x<height>+<outer bevel width>+<inner bevel width></i> 9875 </font></font></font></b></td></tr></table> 9876 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with an ornamental border</td></tr></table> 9877 <table BORDER=0 WIDTH="94%"> 9878 <tr> 9879 <td width="3%"><br></td> 9880 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9881 <img SRC="images/right_triangle_option.png" 9882 ALT=">" BORDER=0 height=14 9883 width=15><b><font face="Helvetica, Arial" 9884 ><font color="#00B04F"><font size="+1"> 9885 <a href="GraphicsMagick.html#details-fuzz">-fuzz</a> <i><distance></i>{<i>%</i>}<i></i> 9886 </font></font></font></b></td></tr></table> 9887 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>colors within this Euclidean distance are considered equal</td></tr></table> 9888 <table BORDER=0 WIDTH="94%"> 9889 <tr> 9890 <td width="3%"><br></td> 9891 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9892 <img SRC="images/right_triangle_option.png" 9893 ALT=">" BORDER=0 height=14 9894 width=15><b><font face="Helvetica, Arial" 9895 ><font color="#00B04F"><font size="+1"> 9896 <a href="GraphicsMagick.html#details-gamma">-gamma</a> <i><value></i> 9897 </font></font></font></b></td></tr></table> 9898 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>level of gamma correction</td></tr></table> 9899 <table BORDER=0 WIDTH="94%"> 9900 <tr> 9901 <td width="3%"><br></td> 9902 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9903 <img SRC="images/right_triangle_option.png" 9904 ALT=">" BORDER=0 height=14 9905 width=15><b><font face="Helvetica, Arial" 9906 ><font color="#00B04F"><font size="+1"> 9907 <a href="GraphicsMagick.html#details-gaussian">-gaussian</a> <i><radius></i>{<i>x<sigma></i>}<i></i> 9908 </font></font></font></b></td></tr></table> 9909 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blur the image with a Gaussian operator</td></tr></table> 9910 <table BORDER=0 WIDTH="94%"> 9911 <tr> 9912 <td width="3%"><br></td> 9913 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9914 <img SRC="images/right_triangle_option.png" 9915 ALT=">" BORDER=0 height=14 9916 width=15><b><font face="Helvetica, Arial" 9917 ><font color="#00B04F"><font size="+1"> 9918 <a href="GraphicsMagick.html#details-geometry">-geometry</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i>^</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 9919 </font></font></font></b></td></tr></table> 9920 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify dimension, offset, and resize options.</td></tr></table> 9921 <table BORDER=0 WIDTH="94%"> 9922 <tr> 9923 <td width="3%"><br></td> 9924 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9925 <img SRC="images/right_triangle_option.png" 9926 ALT=">" BORDER=0 height=14 9927 width=15><b><font face="Helvetica, Arial" 9928 ><font color="#00B04F"><font size="+1"> 9929 <a href="GraphicsMagick.html#details-gravity">-gravity</a> <i><type></i> 9930 </font></font></font></b></td></tr></table> 9931 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>direction primitive gravitates to when annotating the image.</td></tr></table> 9932 <table BORDER=0 WIDTH="94%"> 9933 <tr> 9934 <td width="3%"><br></td> 9935 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9936 <img SRC="images/right_triangle_option.png" 9937 ALT=">" BORDER=0 height=14 9938 width=15><b><font face="Helvetica, Arial" 9939 ><font color="#00B04F"><font size="+1"> 9940 <a href="GraphicsMagick.html#details-green-primary">-green-primary</a> <i><x>,<y></i> 9941 </font></font></font></b></td></tr></table> 9942 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>green chromaticity primary point</td></tr></table> 9943 <table BORDER=0 WIDTH="94%"> 9944 <tr> 9945 <td width="3%"><br></td> 9946 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9947 <img SRC="images/right_triangle_option.png" 9948 ALT=">" BORDER=0 height=14 9949 width=15><b><font face="Helvetica, Arial" 9950 ><font color="#00B04F"><font size="+1"> 9951 -hald-clut <i><clut></i> 9952 </font></font></font></b></td></tr></table> 9953 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a Hald CLUT to the image</td></tr></table> 9954 <table BORDER=0 WIDTH="94%"> 9955 <tr> 9956 <td width="3%"><br></td> 9957 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9958 <img SRC="images/right_triangle_option.png" 9959 ALT=">" BORDER=0 height=14 9960 width=15><b><font face="Helvetica, Arial" 9961 ><font color="#00B04F"><font size="+1"> 9962 -help 9963 </font></font></font></b></td></tr></table> 9964 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table> 9965 <table BORDER=0 WIDTH="94%"> 9966 <tr> 9967 <td width="3%"><br></td> 9968 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9969 <img SRC="images/right_triangle_option.png" 9970 ALT=">" BORDER=0 height=14 9971 width=15><b><font face="Helvetica, Arial" 9972 ><font color="#00B04F"><font size="+1"> 9973 -implode <i><factor></i> 9974 </font></font></font></b></td></tr></table> 9975 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>implode image pixels about the center</td></tr></table> 9976 <table BORDER=0 WIDTH="94%"> 9977 <tr> 9978 <td width="3%"><br></td> 9979 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9980 <img SRC="images/right_triangle_option.png" 9981 ALT=">" BORDER=0 height=14 9982 width=15><b><font face="Helvetica, Arial" 9983 ><font color="#00B04F"><font size="+1"> 9984 <a href="GraphicsMagick.html#details-intent">-intent</a> <i><type></i> 9985 </font></font></font></b></td></tr></table> 9986 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this type of rendering intent when managing the image color</td></tr></table> 9987 <table BORDER=0 WIDTH="94%"> 9988 <tr> 9989 <td width="3%"><br></td> 9990 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 9991 <img SRC="images/right_triangle_option.png" 9992 ALT=">" BORDER=0 height=14 9993 width=15><b><font face="Helvetica, Arial" 9994 ><font color="#00B04F"><font size="+1"> 9995 <a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i> 9996 </font></font></font></b></td></tr></table> 9997 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table> 9998 <table BORDER=0 WIDTH="94%"> 9999 <tr> 10000 <td width="3%"><br></td> 10001 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10002 <img SRC="images/right_triangle_option.png" 10003 ALT=">" BORDER=0 height=14 10004 width=15><b><font face="Helvetica, Arial" 10005 ><font color="#00B04F"><font size="+1"> 10006 <a href="GraphicsMagick.html#details-label">-label</a> <i><name></i> 10007 </font></font></font></b></td></tr></table> 10008 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign a label to an image</td></tr></table> 10009 <table BORDER=0 WIDTH="94%"> 10010 <tr> 10011 <td width="3%"><br></td> 10012 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10013 <img SRC="images/right_triangle_option.png" 10014 ALT=">" BORDER=0 height=14 10015 width=15><b><font face="Helvetica, Arial" 10016 ><font color="#00B04F"><font size="+1"> 10017 <a href="GraphicsMagick.html#details-lat">-lat</a> <i><width>x<height></i>{<i>+-</i>}<i><offset></i>{<i>%</i>}<i></i> 10018 </font></font></font></b></td></tr></table> 10019 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform local adaptive thresholding</td></tr></table> 10020 <table BORDER=0 WIDTH="94%"> 10021 <tr> 10022 <td width="3%"><br></td> 10023 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10024 <img SRC="images/right_triangle_option.png" 10025 ALT=">" BORDER=0 height=14 10026 width=15><b><font face="Helvetica, Arial" 10027 ><font color="#00B04F"><font size="+1"> 10028 <a href="GraphicsMagick.html#details-level">-level</a> <i><black_point></i>{<i>,<gamma></i>}<i></i>{<i>,<white_point></i>}<i></i>{<i>%</i>}<i></i> 10029 </font></font></font></b></td></tr></table> 10030 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>adjust the level of image contrast</td></tr></table> 10031 <table BORDER=0 WIDTH="94%"> 10032 <tr> 10033 <td width="3%"><br></td> 10034 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10035 <img SRC="images/right_triangle_option.png" 10036 ALT=">" BORDER=0 height=14 10037 width=15><b><font face="Helvetica, Arial" 10038 ><font color="#00B04F"><font size="+1"> 10039 <a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i> 10040 </font></font></font></b></td></tr></table> 10041 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table> 10042 <table BORDER=0 WIDTH="94%"> 10043 <tr> 10044 <td width="3%"><br></td> 10045 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10046 <img SRC="images/right_triangle_option.png" 10047 ALT=">" BORDER=0 height=14 10048 width=15><b><font face="Helvetica, Arial" 10049 ><font color="#00B04F"><font size="+1"> 10050 <a href="GraphicsMagick.html#details-list">-list</a> <i><type></i> 10051 </font></font></font></b></td></tr></table> 10052 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of list</td></tr></table> 10053 <table BORDER=0 WIDTH="94%"> 10054 <tr> 10055 <td width="3%"><br></td> 10056 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10057 <img SRC="images/right_triangle_option.png" 10058 ALT=">" BORDER=0 height=14 10059 width=15><b><font face="Helvetica, Arial" 10060 ><font color="#00B04F"><font size="+1"> 10061 <a href="GraphicsMagick.html#details-log">-log</a> <i><string></i> 10062 </font></font></font></b></td></tr></table> 10063 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table> 10064 <table BORDER=0 WIDTH="94%"> 10065 <tr> 10066 <td width="3%"><br></td> 10067 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10068 <img SRC="images/right_triangle_option.png" 10069 ALT=">" BORDER=0 height=14 10070 width=15><b><font face="Helvetica, Arial" 10071 ><font color="#00B04F"><font size="+1"> 10072 <a href="GraphicsMagick.html#details-loop">-loop</a> <i><iterations></i> 10073 </font></font></font></b></td></tr></table> 10074 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add Netscape loop extension to your GIF animation</td></tr></table> 10075 <table BORDER=0 WIDTH="94%"> 10076 <tr> 10077 <td width="3%"><br></td> 10078 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10079 <img SRC="images/right_triangle_option.png" 10080 ALT=">" BORDER=0 height=14 10081 width=15><b><font face="Helvetica, Arial" 10082 ><font color="#00B04F"><font size="+1"> 10083 -magnify 10084 </font></font></font></b></td></tr></table> 10085 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>magnify the image</td></tr></table> 10086 <table BORDER=0 WIDTH="94%"> 10087 <tr> 10088 <td width="3%"><br></td> 10089 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10090 <img SRC="images/right_triangle_option.png" 10091 ALT=">" BORDER=0 height=14 10092 width=15><b><font face="Helvetica, Arial" 10093 ><font color="#00B04F"><font size="+1"> 10094 <a href="GraphicsMagick.html#details-map">-map</a> <i><filename></i> 10095 </font></font></font></b></td></tr></table> 10096 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>choose a particular set of colors from this image</td></tr></table> 10097 <table BORDER=0 WIDTH="94%"> 10098 <tr> 10099 <td width="3%"><br></td> 10100 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10101 <img SRC="images/right_triangle_option.png" 10102 ALT=">" BORDER=0 height=14 10103 width=15><b><font face="Helvetica, Arial" 10104 ><font color="#00B04F"><font size="+1"> 10105 <a href="GraphicsMagick.html#details-mask">-mask</a> <i><filename></i> 10106 </font></font></font></b></td></tr></table> 10107 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify a clipping mask</td></tr></table> 10108 <table BORDER=0 WIDTH="94%"> 10109 <tr> 10110 <td width="3%"><br></td> 10111 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10112 <img SRC="images/right_triangle_option.png" 10113 ALT=">" BORDER=0 height=14 10114 width=15><b><font face="Helvetica, Arial" 10115 ><font color="#00B04F"><font size="+1"> 10116 <a href="GraphicsMagick.html#details-matte">-matte</a> 10117 </font></font></font></b></td></tr></table> 10118 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table> 10119 <table BORDER=0 WIDTH="94%"> 10120 <tr> 10121 <td width="3%"><br></td> 10122 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10123 <img SRC="images/right_triangle_option.png" 10124 ALT=">" BORDER=0 height=14 10125 width=15><b><font face="Helvetica, Arial" 10126 ><font color="#00B04F"><font size="+1"> 10127 <a href="GraphicsMagick.html#details-mattecolor">-mattecolor</a> <i><color></i> 10128 </font></font></font></b></td></tr></table> 10129 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the color to be used with the <strong>-frame</strong> option</td></tr></table> 10130 <table BORDER=0 WIDTH="94%"> 10131 <tr> 10132 <td width="3%"><br></td> 10133 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10134 <img SRC="images/right_triangle_option.png" 10135 ALT=">" BORDER=0 height=14 10136 width=15><b><font face="Helvetica, Arial" 10137 ><font color="#00B04F"><font size="+1"> 10138 -median <i><radius></i> 10139 </font></font></font></b></td></tr></table> 10140 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a median filter to the image</td></tr></table> 10141 <table BORDER=0 WIDTH="94%"> 10142 <tr> 10143 <td width="3%"><br></td> 10144 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10145 <img SRC="images/right_triangle_option.png" 10146 ALT=">" BORDER=0 height=14 10147 width=15><b><font face="Helvetica, Arial" 10148 ><font color="#00B04F"><font size="+1"> 10149 -minify <i><factor></i> 10150 </font></font></font></b></td></tr></table> 10151 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>minify the image</td></tr></table> 10152 <table BORDER=0 WIDTH="94%"> 10153 <tr> 10154 <td width="3%"><br></td> 10155 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10156 <img SRC="images/right_triangle_option.png" 10157 ALT=">" BORDER=0 height=14 10158 width=15><b><font face="Helvetica, Arial" 10159 ><font color="#00B04F"><font size="+1"> 10160 <a href="GraphicsMagick.html#details-modulate">-modulate</a> <i>brightness[,saturation[,hue]]</i> 10161 </font></font></font></b></td></tr></table> 10162 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>vary the brightness, saturation, and hue of an image</td></tr></table> 10163 <table BORDER=0 WIDTH="94%"> 10164 <tr> 10165 <td width="3%"><br></td> 10166 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10167 <img SRC="images/right_triangle_option.png" 10168 ALT=">" BORDER=0 height=14 10169 width=15><b><font face="Helvetica, Arial" 10170 ><font color="#00B04F"><font size="+1"> 10171 -monitor 10172 </font></font></font></b></td></tr></table> 10173 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>show progress indication</td></tr></table> 10174 <table BORDER=0 WIDTH="94%"> 10175 <tr> 10176 <td width="3%"><br></td> 10177 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10178 <img SRC="images/right_triangle_option.png" 10179 ALT=">" BORDER=0 height=14 10180 width=15><b><font face="Helvetica, Arial" 10181 ><font color="#00B04F"><font size="+1"> 10182 -monochrome 10183 </font></font></font></b></td></tr></table> 10184 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table> 10185 <table BORDER=0 WIDTH="94%"> 10186 <tr> 10187 <td width="3%"><br></td> 10188 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10189 <img SRC="images/right_triangle_option.png" 10190 ALT=">" BORDER=0 height=14 10191 width=15><b><font face="Helvetica, Arial" 10192 ><font color="#00B04F"><font size="+1"> 10193 <a href="GraphicsMagick.html#details-morph">-morph</a> <i><frames></i> 10194 </font></font></font></b></td></tr></table> 10195 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>morphs an image sequence</td></tr></table> 10196 <table BORDER=0 WIDTH="94%"> 10197 <tr> 10198 <td width="3%"><br></td> 10199 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10200 <img SRC="images/right_triangle_option.png" 10201 ALT=">" BORDER=0 height=14 10202 width=15><b><font face="Helvetica, Arial" 10203 ><font color="#00B04F"><font size="+1"> 10204 <a href="GraphicsMagick.html#details-mosaic">-mosaic</a> 10205 </font></font></font></b></td></tr></table> 10206 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a mosaic from an image or an image sequence</td></tr></table> 10207 <table BORDER=0 WIDTH="94%"> 10208 <tr> 10209 <td width="3%"><br></td> 10210 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10211 <img SRC="images/right_triangle_option.png" 10212 ALT=">" BORDER=0 height=14 10213 width=15><b><font face="Helvetica, Arial" 10214 ><font color="#00B04F"><font size="+1"> 10215 <a href="GraphicsMagick.html#details-motion-blur">-motion-blur</a> <i><radius></i>{<i>x<sigma></i>}<i></i>{<i>+angle</i>}<i></i> 10216 </font></font></font></b></td></tr></table> 10217 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Simulate motion blur</td></tr></table> 10218 <table BORDER=0 WIDTH="94%"> 10219 <tr> 10220 <td width="3%"><br></td> 10221 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10222 <img SRC="images/right_triangle_option.png" 10223 ALT=">" BORDER=0 height=14 10224 width=15><b><font face="Helvetica, Arial" 10225 ><font color="#00B04F"><font size="+1"> 10226 <a href="GraphicsMagick.html#details-negate">-negate</a> 10227 </font></font></font></b></td></tr></table> 10228 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>replace every pixel with its complementary color</td></tr></table> 10229 <table BORDER=0 WIDTH="94%"> 10230 <tr> 10231 <td width="3%"><br></td> 10232 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10233 <img SRC="images/right_triangle_option.png" 10234 ALT=">" BORDER=0 height=14 10235 width=15><b><font face="Helvetica, Arial" 10236 ><font color="#00B04F"><font size="+1"> 10237 <a href="GraphicsMagick.html#details-noise">-noise</a> <i><radius|type></i> 10238 </font></font></font></b></td></tr></table> 10239 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add or reduce noise in an image</td></tr></table> 10240 <table BORDER=0 WIDTH="94%"> 10241 <tr> 10242 <td width="3%"><br></td> 10243 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10244 <img SRC="images/right_triangle_option.png" 10245 ALT=">" BORDER=0 height=14 10246 width=15><b><font face="Helvetica, Arial" 10247 ><font color="#00B04F"><font size="+1"> 10248 <a href="GraphicsMagick.html#details-noop">-noop</a> 10249 </font></font></font></b></td></tr></table> 10250 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>NOOP (no option)</td></tr></table> 10251 <table BORDER=0 WIDTH="94%"> 10252 <tr> 10253 <td width="3%"><br></td> 10254 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10255 <img SRC="images/right_triangle_option.png" 10256 ALT=">" BORDER=0 height=14 10257 width=15><b><font face="Helvetica, Arial" 10258 ><font color="#00B04F"><font size="+1"> 10259 <a href="GraphicsMagick.html#details-normalize">-normalize</a> 10260 </font></font></font></b></td></tr></table> 10261 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform image to span the full range of color values</td></tr></table> 10262 <table BORDER=0 WIDTH="94%"> 10263 <tr> 10264 <td width="3%"><br></td> 10265 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10266 <img SRC="images/right_triangle_option.png" 10267 ALT=">" BORDER=0 height=14 10268 width=15><b><font face="Helvetica, Arial" 10269 ><font color="#00B04F"><font size="+1"> 10270 <a href="GraphicsMagick.html#details-opaque">-opaque</a> <i><color></i> 10271 </font></font></font></b></td></tr></table> 10272 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>change this color to the pen color within the image</td></tr></table> 10273 <table BORDER=0 WIDTH="94%"> 10274 <tr> 10275 <td width="3%"><br></td> 10276 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10277 <img SRC="images/right_triangle_option.png" 10278 ALT=">" BORDER=0 height=14 10279 width=15><b><font face="Helvetica, Arial" 10280 ><font color="#00B04F"><font size="+1"> 10281 <a href="GraphicsMagick.html#details-operator">-operator</a> <i>channel operator rvalue[%]</i> 10282 </font></font></font></b></td></tr></table> 10283 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a mathematical, bitwise, or value operator to an image channel</td></tr></table> 10284 <table BORDER=0 WIDTH="94%"> 10285 <tr> 10286 <td width="3%"><br></td> 10287 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10288 <img SRC="images/right_triangle_option.png" 10289 ALT=">" BORDER=0 height=14 10290 width=15><b><font face="Helvetica, Arial" 10291 ><font color="#00B04F"><font size="+1"> 10292 <a href="GraphicsMagick.html#details-ordered-dither">-ordered-dither</a> <i><channeltype> <NxN></i> 10293 </font></font></font></b></td></tr></table> 10294 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>ordered dither the image</td></tr></table> 10295 <table BORDER=0 WIDTH="94%"> 10296 <tr> 10297 <td width="3%"><br></td> 10298 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10299 <img SRC="images/right_triangle_option.png" 10300 ALT=">" BORDER=0 height=14 10301 width=15><b><font face="Helvetica, Arial" 10302 ><font color="#00B04F"><font size="+1"> 10303 <a href="GraphicsMagick.html#details-orient">-orient</a> <i><orientation></i> 10304 </font></font></font></b></td></tr></table> 10305 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Set the image orientation attribute</td></tr></table> 10306 <table BORDER=0 WIDTH="94%"> 10307 <tr> 10308 <td width="3%"><br></td> 10309 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10310 <img SRC="images/right_triangle_option.png" 10311 ALT=">" BORDER=0 height=14 10312 width=15><b><font face="Helvetica, Arial" 10313 ><font color="#00B04F"><font size="+1"> 10314 <a href="GraphicsMagick.html#details-page">-page</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 10315 </font></font></font></b></td></tr></table> 10316 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>size and location of an image canvas</td></tr></table> 10317 <table BORDER=0 WIDTH="94%"> 10318 <tr> 10319 <td width="3%"><br></td> 10320 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10321 <img SRC="images/right_triangle_option.png" 10322 ALT=">" BORDER=0 height=14 10323 width=15><b><font face="Helvetica, Arial" 10324 ><font color="#00B04F"><font size="+1"> 10325 <a href="GraphicsMagick.html#details-paint">-paint</a> <i><radius></i> 10326 </font></font></font></b></td></tr></table> 10327 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>simulate an oil painting</td></tr></table> 10328 <table BORDER=0 WIDTH="94%"> 10329 <tr> 10330 <td width="3%"><br></td> 10331 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10332 <img SRC="images/right_triangle_option.png" 10333 ALT=">" BORDER=0 height=14 10334 width=15><b><font face="Helvetica, Arial" 10335 ><font color="#00B04F"><font size="+1"> 10336 <a href="GraphicsMagick.html#details-pen">-pen</a> <i><color></i> 10337 </font></font></font></b></td></tr></table> 10338 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -fill option)</td></tr></table> 10339 <table BORDER=0 WIDTH="94%"> 10340 <tr> 10341 <td width="3%"><br></td> 10342 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10343 <img SRC="images/right_triangle_option.png" 10344 ALT=">" BORDER=0 height=14 10345 width=15><b><font face="Helvetica, Arial" 10346 ><font color="#00B04F"><font size="+1"> 10347 -ping 10348 </font></font></font></b></td></tr></table> 10349 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>efficiently determine image characteristics</td></tr></table> 10350 <table BORDER=0 WIDTH="94%"> 10351 <tr> 10352 <td width="3%"><br></td> 10353 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10354 <img SRC="images/right_triangle_option.png" 10355 ALT=">" BORDER=0 height=14 10356 width=15><b><font face="Helvetica, Arial" 10357 ><font color="#00B04F"><font size="+1"> 10358 -pointsize <i><value></i> 10359 </font></font></font></b></td></tr></table> 10360 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pointsize of the PostScript, X11, or TrueType font</td></tr></table> 10361 <table BORDER=0 WIDTH="94%"> 10362 <tr> 10363 <td width="3%"><br></td> 10364 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10365 <img SRC="images/right_triangle_option.png" 10366 ALT=">" BORDER=0 height=14 10367 width=15><b><font face="Helvetica, Arial" 10368 ><font color="#00B04F"><font size="+1"> 10369 <a href="GraphicsMagick.html#details-preview">-preview</a> <i><type></i> 10370 </font></font></font></b></td></tr></table> 10371 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>image preview type</td></tr></table> 10372 <table BORDER=0 WIDTH="94%"> 10373 <tr> 10374 <td width="3%"><br></td> 10375 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10376 <img SRC="images/right_triangle_option.png" 10377 ALT=">" BORDER=0 height=14 10378 width=15><b><font face="Helvetica, Arial" 10379 ><font color="#00B04F"><font size="+1"> 10380 <a href="GraphicsMagick.html#details-process">-process</a> <i><command></i> 10381 </font></font></font></b></td></tr></table> 10382 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>process a sequence of images using a process module</td></tr></table> 10383 <table BORDER=0 WIDTH="94%"> 10384 <tr> 10385 <td width="3%"><br></td> 10386 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10387 <img SRC="images/right_triangle_option.png" 10388 ALT=">" BORDER=0 height=14 10389 width=15><b><font face="Helvetica, Arial" 10390 ><font color="#00B04F"><font size="+1"> 10391 <a href="GraphicsMagick.html#details-profile">-profile</a> <i><filename></i> 10392 </font></font></font></b></td></tr></table> 10393 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add ICM, IPTC, or generic profile to image</td></tr></table> 10394 <table BORDER=0 WIDTH="94%"> 10395 <tr> 10396 <td width="3%"><br></td> 10397 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10398 <img SRC="images/right_triangle_option.png" 10399 ALT=">" BORDER=0 height=14 10400 width=15><b><font face="Helvetica, Arial" 10401 ><font color="#00B04F"><font size="+1"> 10402 <a href="GraphicsMagick.html#details-quality">-quality</a> <i><value></i> 10403 </font></font></font></b></td></tr></table> 10404 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>JPEG/MIFF/PNG/TIFF compression level</td></tr></table> 10405 <table BORDER=0 WIDTH="94%"> 10406 <tr> 10407 <td width="3%"><br></td> 10408 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10409 <img SRC="images/right_triangle_option.png" 10410 ALT=">" BORDER=0 height=14 10411 width=15><b><font face="Helvetica, Arial" 10412 ><font color="#00B04F"><font size="+1"> 10413 <a href="GraphicsMagick.html#details-raise">-raise</a> <i><width>x<height></i> 10414 </font></font></font></b></td></tr></table> 10415 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>lighten or darken image edges</td></tr></table> 10416 <table BORDER=0 WIDTH="94%"> 10417 <tr> 10418 <td width="3%"><br></td> 10419 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10420 <img SRC="images/right_triangle_option.png" 10421 ALT=">" BORDER=0 height=14 10422 width=15><b><font face="Helvetica, Arial" 10423 ><font color="#00B04F"><font size="+1"> 10424 <a href="GraphicsMagick.html#details-random-threshold">-random-threshold</a> <i><channeltype> <LOWxHIGH></i> 10425 </font></font></font></b></td></tr></table> 10426 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>random threshold the image</td></tr></table> 10427 <table BORDER=0 WIDTH="94%"> 10428 <tr> 10429 <td width="3%"><br></td> 10430 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10431 <img SRC="images/right_triangle_option.png" 10432 ALT=">" BORDER=0 height=14 10433 width=15><b><font face="Helvetica, Arial" 10434 ><font color="#00B04F"><font size="+1"> 10435 <a href="GraphicsMagick.html#details-recolor">-recolor</a> <i><matrix></i> 10436 </font></font></font></b></td></tr></table> 10437 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a color translation matrix to image channels</td></tr></table> 10438 <table BORDER=0 WIDTH="94%"> 10439 <tr> 10440 <td width="3%"><br></td> 10441 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10442 <img SRC="images/right_triangle_option.png" 10443 ALT=">" BORDER=0 height=14 10444 width=15><b><font face="Helvetica, Arial" 10445 ><font color="#00B04F"><font size="+1"> 10446 <a href="GraphicsMagick.html#details-red-primary">-red-primary</a> <i><x>,<y></i> 10447 </font></font></font></b></td></tr></table> 10448 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>red chromaticity primary point</td></tr></table> 10449 <table BORDER=0 WIDTH="94%"> 10450 <tr> 10451 <td width="3%"><br></td> 10452 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10453 <img SRC="images/right_triangle_option.png" 10454 ALT=">" BORDER=0 height=14 10455 width=15><b><font face="Helvetica, Arial" 10456 ><font color="#00B04F"><font size="+1"> 10457 <a href="GraphicsMagick.html#details-region">-region</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i> 10458 </font></font></font></b></td></tr></table> 10459 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply options to a portion of the image</td></tr></table> 10460 <table BORDER=0 WIDTH="94%"> 10461 <tr> 10462 <td width="3%"><br></td> 10463 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10464 <img SRC="images/right_triangle_option.png" 10465 ALT=">" BORDER=0 height=14 10466 width=15><b><font face="Helvetica, Arial" 10467 ><font color="#00B04F"><font size="+1"> 10468 <a href="GraphicsMagick.html#details-render">-render</a> 10469 </font></font></font></b></td></tr></table> 10470 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>render vector operations</td></tr></table> 10471 <table BORDER=0 WIDTH="94%"> 10472 <tr> 10473 <td width="3%"><br></td> 10474 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10475 <img SRC="images/right_triangle_option.png" 10476 ALT=">" BORDER=0 height=14 10477 width=15><b><font face="Helvetica, Arial" 10478 ><font color="#00B04F"><font size="+1"> 10479 <a href="GraphicsMagick.html#details-repage">-repage</a> <i> <width>x<height>+xoff+yoff[!]</i> 10480 </font></font></font></b></td></tr></table> 10481 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Adjust image page offsets</td></tr></table> 10482 <table BORDER=0 WIDTH="94%"> 10483 <tr> 10484 <td width="3%"><br></td> 10485 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10486 <img SRC="images/right_triangle_option.png" 10487 ALT=">" BORDER=0 height=14 10488 width=15><b><font face="Helvetica, Arial" 10489 ><font color="#00B04F"><font size="+1"> 10490 <a href="GraphicsMagick.html#details-resample">-resample</a> <i><horizontal>x<vertical></i> 10491 </font></font></font></b></td></tr></table> 10492 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Resample image to specified horizontal and vertical resolution</td></tr></table> 10493 <table BORDER=0 WIDTH="94%"> 10494 <tr> 10495 <td width="3%"><br></td> 10496 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10497 <img SRC="images/right_triangle_option.png" 10498 ALT=">" BORDER=0 height=14 10499 width=15><b><font face="Helvetica, Arial" 10500 ><font color="#00B04F"><font size="+1"> 10501 <a href="GraphicsMagick.html#details-resize">-resize</a> <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 10502 </font></font></font></b></td></tr></table> 10503 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image</td></tr></table> 10504 <table BORDER=0 WIDTH="94%"> 10505 <tr> 10506 <td width="3%"><br></td> 10507 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10508 <img SRC="images/right_triangle_option.png" 10509 ALT=">" BORDER=0 height=14 10510 width=15><b><font face="Helvetica, Arial" 10511 ><font color="#00B04F"><font size="+1"> 10512 <a href="GraphicsMagick.html#details-roll">-roll</a> <i></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i> 10513 </font></font></font></b></td></tr></table> 10514 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>roll an image vertically or horizontally</td></tr></table> 10515 <table BORDER=0 WIDTH="94%"> 10516 <tr> 10517 <td width="3%"><br></td> 10518 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10519 <img SRC="images/right_triangle_option.png" 10520 ALT=">" BORDER=0 height=14 10521 width=15><b><font face="Helvetica, Arial" 10522 ><font color="#00B04F"><font size="+1"> 10523 <a href="GraphicsMagick.html#details-rotate">-rotate</a> <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 10524 </font></font></font></b></td></tr></table> 10525 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>rotate the image</td></tr></table> 10526 <table BORDER=0 WIDTH="94%"> 10527 <tr> 10528 <td width="3%"><br></td> 10529 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10530 <img SRC="images/right_triangle_option.png" 10531 ALT=">" BORDER=0 height=14 10532 width=15><b><font face="Helvetica, Arial" 10533 ><font color="#00B04F"><font size="+1"> 10534 <a href="GraphicsMagick.html#details-sample">-sample</a> <i><geometry></i> 10535 </font></font></font></b></td></tr></table> 10536 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>scale image using pixel sampling</td></tr></table> 10537 <table BORDER=0 WIDTH="94%"> 10538 <tr> 10539 <td width="3%"><br></td> 10540 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10541 <img SRC="images/right_triangle_option.png" 10542 ALT=">" BORDER=0 height=14 10543 width=15><b><font face="Helvetica, Arial" 10544 ><font color="#00B04F"><font size="+1"> 10545 <a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i> 10546 </font></font></font></b></td></tr></table> 10547 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chroma subsampling factors</td></tr></table> 10548 <table BORDER=0 WIDTH="94%"> 10549 <tr> 10550 <td width="3%"><br></td> 10551 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10552 <img SRC="images/right_triangle_option.png" 10553 ALT=">" BORDER=0 height=14 10554 width=15><b><font face="Helvetica, Arial" 10555 ><font color="#00B04F"><font size="+1"> 10556 <a href="GraphicsMagick.html#details-scale">-scale</a> <i><geometry></i> 10557 </font></font></font></b></td></tr></table> 10558 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>scale the image.</td></tr></table> 10559 <table BORDER=0 WIDTH="94%"> 10560 <tr> 10561 <td width="3%"><br></td> 10562 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10563 <img SRC="images/right_triangle_option.png" 10564 ALT=">" BORDER=0 height=14 10565 width=15><b><font face="Helvetica, Arial" 10566 ><font color="#00B04F"><font size="+1"> 10567 <a href="GraphicsMagick.html#details-scene">-scene</a> <i><value></i> 10568 </font></font></font></b></td></tr></table> 10569 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set scene number</td></tr></table> 10570 <table BORDER=0 WIDTH="94%"> 10571 <tr> 10572 <td width="3%"><br></td> 10573 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10574 <img SRC="images/right_triangle_option.png" 10575 ALT=">" BORDER=0 height=14 10576 width=15><b><font face="Helvetica, Arial" 10577 ><font color="#00B04F"><font size="+1"> 10578 <a href="GraphicsMagick.html#details-set">-set</a> <i><attribute> <value></i> 10579 </font></font></font></b></td></tr></table> 10580 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set an image attribute</td></tr></table> 10581 <table BORDER=0 WIDTH="94%"> 10582 <tr> 10583 <td width="3%"><br></td> 10584 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10585 <img SRC="images/right_triangle_option.png" 10586 ALT=">" BORDER=0 height=14 10587 width=15><b><font face="Helvetica, Arial" 10588 ><font color="#00B04F"><font size="+1"> 10589 <a href="GraphicsMagick.html#details+set">+set</a> <i><attribute></i> 10590 </font></font></font></b></td></tr></table> 10591 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>unset an image attribute</td></tr></table> 10592 <table BORDER=0 WIDTH="94%"> 10593 <tr> 10594 <td width="3%"><br></td> 10595 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10596 <img SRC="images/right_triangle_option.png" 10597 ALT=">" BORDER=0 height=14 10598 width=15><b><font face="Helvetica, Arial" 10599 ><font color="#00B04F"><font size="+1"> 10600 <a href="GraphicsMagick.html#details-segment">-segment</a> <i><cluster threshold>x<smoothing threshold></i> 10601 </font></font></font></b></td></tr></table> 10602 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>segment an image</td></tr></table> 10603 <table BORDER=0 WIDTH="94%"> 10604 <tr> 10605 <td width="3%"><br></td> 10606 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10607 <img SRC="images/right_triangle_option.png" 10608 ALT=">" BORDER=0 height=14 10609 width=15><b><font face="Helvetica, Arial" 10610 ><font color="#00B04F"><font size="+1"> 10611 <a href="GraphicsMagick.html#details-shade">-shade</a> <i><azimuth>x<elevation></i> 10612 </font></font></font></b></td></tr></table> 10613 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shade the image using a distant light source</td></tr></table> 10614 <table BORDER=0 WIDTH="94%"> 10615 <tr> 10616 <td width="3%"><br></td> 10617 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10618 <img SRC="images/right_triangle_option.png" 10619 ALT=">" BORDER=0 height=14 10620 width=15><b><font face="Helvetica, Arial" 10621 ><font color="#00B04F"><font size="+1"> 10622 <a href="GraphicsMagick.html#details-sharpen">-sharpen</a> <i><radius></i>{<i>x<sigma></i>}<i></i> 10623 </font></font></font></b></td></tr></table> 10624 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image</td></tr></table> 10625 <table BORDER=0 WIDTH="94%"> 10626 <tr> 10627 <td width="3%"><br></td> 10628 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10629 <img SRC="images/right_triangle_option.png" 10630 ALT=">" BORDER=0 height=14 10631 width=15><b><font face="Helvetica, Arial" 10632 ><font color="#00B04F"><font size="+1"> 10633 <a href="GraphicsMagick.html#details-shave">-shave</a> <i><width>x<height></i>{<i>%</i>}<i></i> 10634 </font></font></font></b></td></tr></table> 10635 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shave pixels from the image edges</td></tr></table> 10636 <table BORDER=0 WIDTH="94%"> 10637 <tr> 10638 <td width="3%"><br></td> 10639 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10640 <img SRC="images/right_triangle_option.png" 10641 ALT=">" BORDER=0 height=14 10642 width=15><b><font face="Helvetica, Arial" 10643 ><font color="#00B04F"><font size="+1"> 10644 <a href="GraphicsMagick.html#details-shear">-shear</a> <i><x degrees>x<y degrees></i> 10645 </font></font></font></b></td></tr></table> 10646 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shear the image along the X or Y axis</td></tr></table> 10647 <table BORDER=0 WIDTH="94%"> 10648 <tr> 10649 <td width="3%"><br></td> 10650 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10651 <img SRC="images/right_triangle_option.png" 10652 ALT=">" BORDER=0 height=14 10653 width=15><b><font face="Helvetica, Arial" 10654 ><font color="#00B04F"><font size="+1"> 10655 <a href="GraphicsMagick.html#details-size">-size</a> <i><width>x<height></i>{<i>+offset</i>}<i></i> 10656 </font></font></font></b></td></tr></table> 10657 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table> 10658 <table BORDER=0 WIDTH="94%"> 10659 <tr> 10660 <td width="3%"><br></td> 10661 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10662 <img SRC="images/right_triangle_option.png" 10663 ALT=">" BORDER=0 height=14 10664 width=15><b><font face="Helvetica, Arial" 10665 ><font color="#00B04F"><font size="+1"> 10666 <a href="GraphicsMagick.html#details-solarize">-solarize</a> <i><factor></i> 10667 </font></font></font></b></td></tr></table> 10668 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>negate all pixels above the threshold level</td></tr></table> 10669 <table BORDER=0 WIDTH="94%"> 10670 <tr> 10671 <td width="3%"><br></td> 10672 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10673 <img SRC="images/right_triangle_option.png" 10674 ALT=">" BORDER=0 height=14 10675 width=15><b><font face="Helvetica, Arial" 10676 ><font color="#00B04F"><font size="+1"> 10677 <a href="GraphicsMagick.html#details-spread">-spread</a> <i><amount></i> 10678 </font></font></font></b></td></tr></table> 10679 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>displace image pixels by a random amount</td></tr></table> 10680 <table BORDER=0 WIDTH="94%"> 10681 <tr> 10682 <td width="3%"><br></td> 10683 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10684 <img SRC="images/right_triangle_option.png" 10685 ALT=">" BORDER=0 height=14 10686 width=15><b><font face="Helvetica, Arial" 10687 ><font color="#00B04F"><font size="+1"> 10688 <a href="GraphicsMagick.html#details-strip">-strip</a> 10689 </font></font></font></b></td></tr></table> 10690 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove all profiles and text attributes from the image</td></tr></table> 10691 <table BORDER=0 WIDTH="94%"> 10692 <tr> 10693 <td width="3%"><br></td> 10694 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10695 <img SRC="images/right_triangle_option.png" 10696 ALT=">" BORDER=0 height=14 10697 width=15><b><font face="Helvetica, Arial" 10698 ><font color="#00B04F"><font size="+1"> 10699 <a href="GraphicsMagick.html#details-stroke">-stroke</a> <i><color></i> 10700 </font></font></font></b></td></tr></table> 10701 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color to use when stroking a graphic primitive</td></tr></table> 10702 <table BORDER=0 WIDTH="94%"> 10703 <tr> 10704 <td width="3%"><br></td> 10705 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10706 <img SRC="images/right_triangle_option.png" 10707 ALT=">" BORDER=0 height=14 10708 width=15><b><font face="Helvetica, Arial" 10709 ><font color="#00B04F"><font size="+1"> 10710 <a href="GraphicsMagick.html#details-strokewidth">-strokewidth</a> <i><value></i> 10711 </font></font></font></b></td></tr></table> 10712 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set the stroke width</td></tr></table> 10713 <table BORDER=0 WIDTH="94%"> 10714 <tr> 10715 <td width="3%"><br></td> 10716 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10717 <img SRC="images/right_triangle_option.png" 10718 ALT=">" BORDER=0 height=14 10719 width=15><b><font face="Helvetica, Arial" 10720 ><font color="#00B04F"><font size="+1"> 10721 <a href="GraphicsMagick.html#details-swirl">-swirl</a> <i><degrees></i> 10722 </font></font></font></b></td></tr></table> 10723 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>swirl image pixels about the center</td></tr></table> 10724 <table BORDER=0 WIDTH="94%"> 10725 <tr> 10726 <td width="3%"><br></td> 10727 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10728 <img SRC="images/right_triangle_option.png" 10729 ALT=">" BORDER=0 height=14 10730 width=15><b><font face="Helvetica, Arial" 10731 ><font color="#00B04F"><font size="+1"> 10732 -texture <i><filename></i> 10733 </font></font></font></b></td></tr></table> 10734 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name of texture to tile onto the image background</td></tr></table> 10735 <table BORDER=0 WIDTH="94%"> 10736 <tr> 10737 <td width="3%"><br></td> 10738 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10739 <img SRC="images/right_triangle_option.png" 10740 ALT=">" BORDER=0 height=14 10741 width=15><b><font face="Helvetica, Arial" 10742 ><font color="#00B04F"><font size="+1"> 10743 <a href="GraphicsMagick.html#details-threshold">-threshold</a> <i><value></i>{<i>%</i>}<i></i> 10744 </font></font></font></b></td></tr></table> 10745 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>threshold the image</td></tr></table> 10746 <table BORDER=0 WIDTH="94%"> 10747 <tr> 10748 <td width="3%"><br></td> 10749 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10750 <img SRC="images/right_triangle_option.png" 10751 ALT=">" BORDER=0 height=14 10752 width=15><b><font face="Helvetica, Arial" 10753 ><font color="#00B04F"><font size="+1"> 10754 <a href="GraphicsMagick.html#details-thumbnail">-thumbnail</a> <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 10755 </font></font></font></b></td></tr></table> 10756 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image (quickly)</td></tr></table> 10757 <table BORDER=0 WIDTH="94%"> 10758 <tr> 10759 <td width="3%"><br></td> 10760 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10761 <img SRC="images/right_triangle_option.png" 10762 ALT=">" BORDER=0 height=14 10763 width=15><b><font face="Helvetica, Arial" 10764 ><font color="#00B04F"><font size="+1"> 10765 -tile <i><filename></i> 10766 </font></font></font></b></td></tr></table> 10767 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tile image when filling a graphic primitive</td></tr></table> 10768 <table BORDER=0 WIDTH="94%"> 10769 <tr> 10770 <td width="3%"><br></td> 10771 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10772 <img SRC="images/right_triangle_option.png" 10773 ALT=">" BORDER=0 height=14 10774 width=15><b><font face="Helvetica, Arial" 10775 ><font color="#00B04F"><font size="+1"> 10776 <a href="GraphicsMagick.html#details-transform">-transform</a> 10777 </font></font></font></b></td></tr></table> 10778 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image</td></tr></table> 10779 <table BORDER=0 WIDTH="94%"> 10780 <tr> 10781 <td width="3%"><br></td> 10782 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10783 <img SRC="images/right_triangle_option.png" 10784 ALT=">" BORDER=0 height=14 10785 width=15><b><font face="Helvetica, Arial" 10786 ><font color="#00B04F"><font size="+1"> 10787 <a href="GraphicsMagick.html#details-transparent">-transparent</a> <i><color></i> 10788 </font></font></font></b></td></tr></table> 10789 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make this color transparent within the image</td></tr></table> 10790 <table BORDER=0 WIDTH="94%"> 10791 <tr> 10792 <td width="3%"><br></td> 10793 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10794 <img SRC="images/right_triangle_option.png" 10795 ALT=">" BORDER=0 height=14 10796 width=15><b><font face="Helvetica, Arial" 10797 ><font color="#00B04F"><font size="+1"> 10798 <a href="GraphicsMagick.html#details-treedepth">-treedepth</a> <i><value></i> 10799 </font></font></font></b></td></tr></table> 10800 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tree depth for the color reduction algorithm</td></tr></table> 10801 <table BORDER=0 WIDTH="94%"> 10802 <tr> 10803 <td width="3%"><br></td> 10804 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10805 <img SRC="images/right_triangle_option.png" 10806 ALT=">" BORDER=0 height=14 10807 width=15><b><font face="Helvetica, Arial" 10808 ><font color="#00B04F"><font size="+1"> 10809 <a href="GraphicsMagick.html#details-trim">-trim</a> 10810 </font></font></font></b></td></tr></table> 10811 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table> 10812 <table BORDER=0 WIDTH="94%"> 10813 <tr> 10814 <td width="3%"><br></td> 10815 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10816 <img SRC="images/right_triangle_option.png" 10817 ALT=">" BORDER=0 height=14 10818 width=15><b><font face="Helvetica, Arial" 10819 ><font color="#00B04F"><font size="+1"> 10820 <a href="GraphicsMagick.html#details-type">-type</a> <i><type></i> 10821 </font></font></font></b></td></tr></table> 10822 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image type</td></tr></table> 10823 <table BORDER=0 WIDTH="94%"> 10824 <tr> 10825 <td width="3%"><br></td> 10826 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10827 <img SRC="images/right_triangle_option.png" 10828 ALT=">" BORDER=0 height=14 10829 width=15><b><font face="Helvetica, Arial" 10830 ><font color="#00B04F"><font size="+1"> 10831 <a href="GraphicsMagick.html#details-units">-units</a> <i><type></i> 10832 </font></font></font></b></td></tr></table> 10833 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the units of image resolution</td></tr></table> 10834 <table BORDER=0 WIDTH="94%"> 10835 <tr> 10836 <td width="3%"><br></td> 10837 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10838 <img SRC="images/right_triangle_option.png" 10839 ALT=">" BORDER=0 height=14 10840 width=15><b><font face="Helvetica, Arial" 10841 ><font color="#00B04F"><font size="+1"> 10842 <a href="GraphicsMagick.html#details-unsharp">-unsharp</a> <i><radius></i>{<i>x<sigma></i>}<i></i>{<i>+<amount></i>}<i></i>{<i>+<threshold></i>}<i></i> 10843 </font></font></font></b></td></tr></table> 10844 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image with an unsharp mask operator</td></tr></table> 10845 <table BORDER=0 WIDTH="94%"> 10846 <tr> 10847 <td width="3%"><br></td> 10848 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10849 <img SRC="images/right_triangle_option.png" 10850 ALT=">" BORDER=0 height=14 10851 width=15><b><font face="Helvetica, Arial" 10852 ><font color="#00B04F"><font size="+1"> 10853 -use-pixmap 10854 </font></font></font></b></td></tr></table> 10855 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use the pixmap</td></tr></table> 10856 <table BORDER=0 WIDTH="94%"> 10857 <tr> 10858 <td width="3%"><br></td> 10859 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10860 <img SRC="images/right_triangle_option.png" 10861 ALT=">" BORDER=0 height=14 10862 width=15><b><font face="Helvetica, Arial" 10863 ><font color="#00B04F"><font size="+1"> 10864 <a href="GraphicsMagick.html#details-verbose">-verbose</a> 10865 </font></font></font></b></td></tr></table> 10866 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table> 10867 <table BORDER=0 WIDTH="94%"> 10868 <tr> 10869 <td width="3%"><br></td> 10870 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10871 <img SRC="images/right_triangle_option.png" 10872 ALT=">" BORDER=0 height=14 10873 width=15><b><font face="Helvetica, Arial" 10874 ><font color="#00B04F"><font size="+1"> 10875 <a href="GraphicsMagick.html#details-version">-version</a> 10876 </font></font></font></b></td></tr></table> 10877 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table> 10878 <table BORDER=0 WIDTH="94%"> 10879 <tr> 10880 <td width="3%"><br></td> 10881 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10882 <img SRC="images/right_triangle_option.png" 10883 ALT=">" BORDER=0 height=14 10884 width=15><b><font face="Helvetica, Arial" 10885 ><font color="#00B04F"><font size="+1"> 10886 -view <i><string></i> 10887 </font></font></font></b></td></tr></table> 10888 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>FlashPix viewing parameters</td></tr></table> 10889 <table BORDER=0 WIDTH="94%"> 10890 <tr> 10891 <td width="3%"><br></td> 10892 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10893 <img SRC="images/right_triangle_option.png" 10894 ALT=">" BORDER=0 height=14 10895 width=15><b><font face="Helvetica, Arial" 10896 ><font color="#00B04F"><font size="+1"> 10897 <a href="GraphicsMagick.html#details-virtual-pixel">-virtual-pixel</a> <i><method></i> 10898 </font></font></font></b></td></tr></table> 10899 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify contents of "virtual pixels"</td></tr></table> 10900 <table BORDER=0 WIDTH="94%"> 10901 <tr> 10902 <td width="3%"><br></td> 10903 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10904 <img SRC="images/right_triangle_option.png" 10905 ALT=">" BORDER=0 height=14 10906 width=15><b><font face="Helvetica, Arial" 10907 ><font color="#00B04F"><font size="+1"> 10908 <a href="GraphicsMagick.html#details-wave">-wave</a> <i><amplitude>x<wavelength></i> 10909 </font></font></font></b></td></tr></table> 10910 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>alter an image along a sine wave</td></tr></table> 10911 <table BORDER=0 WIDTH="94%"> 10912 <tr> 10913 <td width="3%"><br></td> 10914 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10915 <img SRC="images/right_triangle_option.png" 10916 ALT=">" BORDER=0 height=14 10917 width=15><b><font face="Helvetica, Arial" 10918 ><font color="#00B04F"><font size="+1"> 10919 <a href="GraphicsMagick.html#details-white-point">-white-point</a> <i><x>,<y></i> 10920 </font></font></font></b></td></tr></table> 10921 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chromaticity white point</td></tr></table> 10922 <table BORDER=0 WIDTH="94%"> 10923 <tr> 10924 <td width="3%"><br></td> 10925 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10926 <img SRC="images/right_triangle_option.png" 10927 ALT=">" BORDER=0 height=14 10928 width=15><b><font face="Helvetica, Arial" 10929 ><font color="#00B04F"><font size="+1"> 10930 <a href="GraphicsMagick.html#details-white-threshold">-white-threshold</a> <i>red[,green][,blue][,opacity]</i> 10931 </font></font></font></b></td></tr></table> 10932 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pixels above the threshold become white</td></tr></table> 10933 <table BORDER=0 WIDTH="94%"> 10934 <tr> 10935 <td width="3%"><br></td> 10936 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 10937 <img SRC="images/right_triangle_option.png" 10938 ALT=">" BORDER=0 height=14 10939 width=15><b><font face="Helvetica, Arial" 10940 ><font color="#00B04F"><font size="+1"> 10941 <a href="GraphicsMagick.html#details-write">-write</a> <i><filename></i> 10942 </font></font></font></b></td></tr></table> 10943 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>write an intermediate image [<em>convert, composite</em>]</td></tr></table> 10944 <p> 10945 For a more detailed description of each option, see 10946 Options, above. 10947 <br> <br> 10948 <table BORDER=0 WIDTH="100%"> 10949 <tr> 10950 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 10951 SRC="images/right_triangle.png" ALT=">" BORDER=0 10952 height=14 width=15><b><font face="Helvetica, Arial"><font 10953 color="#00B04F"><font size="+1"> 10954 <a NAME="display"></a>gm display 10955 </font></font></font></b></td></tr></table> 10956 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 10957 <tr><td width="3%"><br></td><td> 10958 <p> 10959 Display is a machine architecture independent 10960 image processing and display program. It can display an image on any workstation 10961 screen running an X server. <strong>Display</strong> can read and write 10962 <strong>many</strong> 10963 of the more popular image <a href="formats.html">formats</a> (e.g. <strong>JPEG</strong>, 10964 <strong>TIFF</strong>, 10965 <strong>PNM</strong>, 10966 <strong>Photo 10967 CD</strong>, etc.). 10968 <p> 10969 With <strong>display</strong>, you can perform these functions on an image: 10970 <dl> 10971 <dd><img SRC="images/ball.png" ALT="*">load an image from a file 10972 <dd><img SRC="images/ball.png" ALT="*">display the next image 10973 <dd><img SRC="images/ball.png" ALT="*">display the former image 10974 <dd><img SRC="images/ball.png" ALT="*">display a sequence of images as a slide show 10975 <dd><img SRC="images/ball.png" ALT="*">write the image to a file 10976 <dd><img SRC="images/ball.png" ALT="*">print the image to a <em>PostScript</em> printer 10977 <dd><img SRC="images/ball.png" ALT="*">delete the image file 10978 <dd><img SRC="images/ball.png" ALT="*">create a Visual Image Directory 10979 <dd><img SRC="images/ball.png" ALT="*">select the image to display by its thumbnail rather than name 10980 <dd><img SRC="images/ball.png" ALT="*">undo last image transformation 10981 <dd><img SRC="images/ball.png" ALT="*">copy a region of the image 10982 <dd><img SRC="images/ball.png" ALT="*">paste a region to the image 10983 <dd><img SRC="images/ball.png" ALT="*">restore the image to its original size 10984 <dd><img SRC="images/ball.png" ALT="*">refresh the image 10985 <dd><img SRC="images/ball.png" ALT="*">half the image size 10986 <dd><img SRC="images/ball.png" ALT="*">double the image size 10987 <dd><img SRC="images/ball.png" ALT="*">resize the image 10988 <dd><img SRC="images/ball.png" ALT="*">crop the image 10989 <dd><img SRC="images/ball.png" ALT="*">cut the image 10990 <dd><img SRC="images/ball.png" ALT="*">flop image in the horizontal direction 10991 <dd><img SRC="images/ball.png" ALT="*">flip image in the vertical direction 10992 <dd><img SRC="images/ball.png" ALT="*">rotate the image 90 degrees clockwise 10993 <dd><img SRC="images/ball.png" ALT="*">rotate the image 90 degrees counter-clockwise 10994 <dd><img SRC="images/ball.png" ALT="*">rotate the image 10995 <dd><img SRC="images/ball.png" ALT="*">shear the image 10996 <dd><img SRC="images/ball.png" ALT="*">roll the image 10997 <dd><img SRC="images/ball.png" ALT="*">trim the image edges 10998 <dd><img SRC="images/ball.png" ALT="*">invert the colors of the image 10999 <dd><img SRC="images/ball.png" ALT="*">vary the color brightness 11000 <dd><img SRC="images/ball.png" ALT="*">vary the color saturation 11001 <dd><img SRC="images/ball.png" ALT="*">vary the image hue 11002 <dd><img SRC="images/ball.png" ALT="*">gamma correct the image 11003 <dd><img SRC="images/ball.png" ALT="*">sharpen the image contrast 11004 <dd><img SRC="images/ball.png" ALT="*">dull the image contrast 11005 <dd><img SRC="images/ball.png" ALT="*">perform histogram equalization on the image 11006 <dd><img SRC="images/ball.png" ALT="*">perform histogram normalization on the image 11007 <dd><img SRC="images/ball.png" ALT="*">negate the image colors 11008 <dd><img SRC="images/ball.png" ALT="*">convert the image to grayscale 11009 <dd><img SRC="images/ball.png" ALT="*">set the maximum number of unique colors in the image 11010 <dd><img SRC="images/ball.png" ALT="*">reduce the speckles within an image 11011 <dd><img SRC="images/ball.png" ALT="*">eliminate peak noise from an image 11012 <dd><img SRC="images/ball.png" ALT="*">detect edges within the image 11013 <dd><img SRC="images/ball.png" ALT="*">emboss an image 11014 <dd><img SRC="images/ball.png" ALT="*">segment the image by color 11015 <dd><img SRC="images/ball.png" ALT="*">simulate an oil painting 11016 <dd><img SRC="images/ball.png" ALT="*">simulate a charcoal drawing 11017 <dd><img SRC="images/ball.png" ALT="*">annotate the image with text 11018 <dd><img SRC="images/ball.png" ALT="*">draw on the image 11019 <dd><img SRC="images/ball.png" ALT="*">edit an image pixel color 11020 <dd><img SRC="images/ball.png" ALT="*">edit the image matte information 11021 <dd><img SRC="images/ball.png" ALT="*">composite an image with another 11022 <dd><img SRC="images/ball.png" ALT="*">add a border to the image 11023 <dd><img SRC="images/ball.png" ALT="*">surround image with an ornamental border 11024 <dd><img SRC="images/ball.png" ALT="*">apply image processing techniques to a region of interest 11025 <dd><img SRC="images/ball.png" ALT="*">display information about the image 11026 <dd><img SRC="images/ball.png" ALT="*">zoom a portion of the image 11027 <dd><img SRC="images/ball.png" ALT="*">show a histogram of the image 11028 <dd><img SRC="images/ball.png" ALT="*">display image to background of a window 11029 <dd><img SRC="images/ball.png" ALT="*">set user preferences 11030 <dd><img SRC="images/ball.png" ALT="*">display information about this program 11031 <dd><img SRC="images/ball.png" ALT="*">discard all images and exit program 11032 <dd><img SRC="images/ball.png" ALT="*">change the level of magnification 11033 <dd><img SRC="images/ball.png" ALT="*">display images specified by a World Wide Web (WWW) uniform resource locator (URL) 11034 </dl> 11035 </td></tr></table> 11036 <p> 11037 <i><a href="#top">Back to Contents</a></i> 11038 </p> 11039 <table BORDER=0 WIDTH="100%"> 11040 <tr> 11041 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 11042 SRC="images/right_triangle.png" ALT=">" BORDER=0 11043 height=14 width=15><b><font face="Helvetica, Arial"><font 11044 color="#00B04F"><font size="+1"> 11045 <a NAME="disp-exam"></a>Examples 11046 </font></font></font></b></td></tr></table> 11047 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 11048 <tr><td width="3%"><br></td><td> 11049 <p> 11050 To scale an image of a cockatoo to exactly 640 pixels in width and 480 11051 pixels in height and position the window at location (200,200), use: 11052 <pre> 11053 gm display -geometry 640x480+200+200! cockatoo.miff 11054 </pre> 11055 <p> 11056 To display an image of a cockatoo without a border centered on a backdrop, 11057 use: 11058 <pre> 11059 gm display +borderwidth -backdrop cockatoo.miff 11060 </pre> 11061 <p> 11062 To tile a slate texture onto the root window, use: 11063 <pre> 11064 gm display -size 1280x1024 -window root slate.png 11065 </pre> 11066 <p> 11067 To display a visual image directory of all your JPEG images, use: 11068 <pre> 11069 gm display 'vid:*.jpg' 11070 </pre> 11071 <p> 11072 To display a MAP image that is 640 pixels in width and 480 pixels in height 11073 with 256 colors, use: 11074 <pre> 11075 gm display -size 640x480+256 cockatoo.map 11076 </pre> 11077 <p> 11078 To display an image of a cockatoo specified with a <strong>World Wide Web (WWW)</strong> 11079 uniform resource locator <strong>(URL)</strong>, use: 11080 <pre> 11081 gm display ftp://wizards.dupont.com/images/cockatoo.jpg 11082 </pre> 11083 <p> 11084 To display histogram of an image, use: 11085 <pre> 11086 gm gm convert file.jpg HISTOGRAM:- | gm display - 11087 </pre> 11088 </td></tr></table> 11089 <p> 11090 <i><a href="#top">Back to Contents</a></i> 11091 </p> 11092 <table BORDER=0 WIDTH="100%"> 11093 <tr> 11094 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 11095 SRC="images/right_triangle.png" ALT=">" BORDER=0 11096 height=14 width=15><b><font face="Helvetica, Arial"><font 11097 color="#00B04F"><font size="+1"> 11098 <a NAME="disp-opti"></a>Options 11099 </font></font></font></b></td></tr></table> 11100 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 11101 <tr><td width="3%"><br></td><td> 11102 <p> 11103 Options are processed in command line order. Any option you specify on 11104 the command line remains in effect until it is explicitly changed by specifying 11105 the option again with a different effect. For example to display three images, 11106 the first with 32 colors, the second with an unlimited number of colors, 11107 and the third with only 16 colors, use: 11108 <pre> 11109 gm display -colors 32 cockatoo.miff -noop duck.miff 11110 -colors 16 macaw.miff 11111 </pre> 11112 <p> 11113 <strong>Display</strong> options can appear on the command line or in your X resources 11114 file. See <em>X(1)</em>. Options on the command line supersede values specified 11115 in your X resources file. 11116 <p> 11117 For a more detailed description of each option, see 11118 Options, above. 11119 <br> <br> 11120 <table BORDER=0 WIDTH="94%"> 11121 <tr> 11122 <td width="3%"><br></td> 11123 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11124 <img SRC="images/right_triangle_option.png" 11125 ALT=">" BORDER=0 height=14 11126 width=15><b><font face="Helvetica, Arial" 11127 ><font color="#00B04F"><font size="+1"> 11128 <a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i><string></i> 11129 </font></font></font></b></td></tr></table> 11130 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table> 11131 <table BORDER=0 WIDTH="94%"> 11132 <tr> 11133 <td width="3%"><br></td> 11134 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11135 <img SRC="images/right_triangle_option.png" 11136 ALT=">" BORDER=0 height=14 11137 width=15><b><font face="Helvetica, Arial" 11138 ><font color="#00B04F"><font size="+1"> 11139 <a href="GraphicsMagick.html#details-backdrop">-backdrop</a> 11140 </font></font></font></b></td></tr></table> 11141 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the image centered on a backdrop.</td></tr></table> 11142 <table BORDER=0 WIDTH="94%"> 11143 <tr> 11144 <td width="3%"><br></td> 11145 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11146 <img SRC="images/right_triangle_option.png" 11147 ALT=">" BORDER=0 height=14 11148 width=15><b><font face="Helvetica, Arial" 11149 ><font color="#00B04F"><font size="+1"> 11150 <a href="GraphicsMagick.html#details-background">-background</a> <i><color></i> 11151 </font></font></font></b></td></tr></table> 11152 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the background color</td></tr></table> 11153 <table BORDER=0 WIDTH="94%"> 11154 <tr> 11155 <td width="3%"><br></td> 11156 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11157 <img SRC="images/right_triangle_option.png" 11158 ALT=">" BORDER=0 height=14 11159 width=15><b><font face="Helvetica, Arial" 11160 ><font color="#00B04F"><font size="+1"> 11161 <a href="GraphicsMagick.html#details-border">-border</a> <i><width>x<height></i> 11162 </font></font></font></b></td></tr></table> 11163 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with a border of color</td></tr></table> 11164 <table BORDER=0 WIDTH="94%"> 11165 <tr> 11166 <td width="3%"><br></td> 11167 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11168 <img SRC="images/right_triangle_option.png" 11169 ALT=">" BORDER=0 height=14 11170 width=15><b><font face="Helvetica, Arial" 11171 ><font color="#00B04F"><font size="+1"> 11172 <a href="GraphicsMagick.html#details-bordercolor">-bordercolor</a> <i><color></i> 11173 </font></font></font></b></td></tr></table> 11174 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border color</td></tr></table> 11175 <table BORDER=0 WIDTH="94%"> 11176 <tr> 11177 <td width="3%"><br></td> 11178 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11179 <img SRC="images/right_triangle_option.png" 11180 ALT=">" BORDER=0 height=14 11181 width=15><b><font face="Helvetica, Arial" 11182 ><font color="#00B04F"><font size="+1"> 11183 -borderwidth <i><geometry></i> 11184 </font></font></font></b></td></tr></table> 11185 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border width</td></tr></table> 11186 <table BORDER=0 WIDTH="94%"> 11187 <tr> 11188 <td width="3%"><br></td> 11189 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11190 <img SRC="images/right_triangle_option.png" 11191 ALT=">" BORDER=0 height=14 11192 width=15><b><font face="Helvetica, Arial" 11193 ><font color="#00B04F"><font size="+1"> 11194 <a href="GraphicsMagick.html#details-colormap">-colormap</a> <i><type></i> 11195 </font></font></font></b></td></tr></table> 11196 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>define the colormap type</td></tr></table> 11197 <table BORDER=0 WIDTH="94%"> 11198 <tr> 11199 <td width="3%"><br></td> 11200 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11201 <img SRC="images/right_triangle_option.png" 11202 ALT=">" BORDER=0 height=14 11203 width=15><b><font face="Helvetica, Arial" 11204 ><font color="#00B04F"><font size="+1"> 11205 <a href="GraphicsMagick.html#details-colors">-colors</a> <i><value></i> 11206 </font></font></font></b></td></tr></table> 11207 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table> 11208 <table BORDER=0 WIDTH="94%"> 11209 <tr> 11210 <td width="3%"><br></td> 11211 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11212 <img SRC="images/right_triangle_option.png" 11213 ALT=">" BORDER=0 height=14 11214 width=15><b><font face="Helvetica, Arial" 11215 ><font color="#00B04F"><font size="+1"> 11216 <a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i><value></i> 11217 </font></font></font></b></td></tr></table> 11218 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table> 11219 <table BORDER=0 WIDTH="94%"> 11220 <tr> 11221 <td width="3%"><br></td> 11222 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11223 <img SRC="images/right_triangle_option.png" 11224 ALT=">" BORDER=0 height=14 11225 width=15><b><font face="Helvetica, Arial" 11226 ><font color="#00B04F"><font size="+1"> 11227 <a href="GraphicsMagick.html#details-comment">-comment</a> <i><string></i> 11228 </font></font></font></b></td></tr></table> 11229 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with a comment</td></tr></table> 11230 <table BORDER=0 WIDTH="94%"> 11231 <tr> 11232 <td width="3%"><br></td> 11233 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11234 <img SRC="images/right_triangle_option.png" 11235 ALT=">" BORDER=0 height=14 11236 width=15><b><font face="Helvetica, Arial" 11237 ><font color="#00B04F"><font size="+1"> 11238 <a href="GraphicsMagick.html#details-compress">-compress</a> <i><type></i> 11239 </font></font></font></b></td></tr></table> 11240 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image compression</td></tr></table> 11241 <table BORDER=0 WIDTH="94%"> 11242 <tr> 11243 <td width="3%"><br></td> 11244 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11245 <img SRC="images/right_triangle_option.png" 11246 ALT=">" BORDER=0 height=14 11247 width=15><b><font face="Helvetica, Arial" 11248 ><font color="#00B04F"><font size="+1"> 11249 <a href="GraphicsMagick.html#details-contrast">-contrast</a> 11250 </font></font></font></b></td></tr></table> 11251 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enhance or reduce the image contrast</td></tr></table> 11252 <table BORDER=0 WIDTH="94%"> 11253 <tr> 11254 <td width="3%"><br></td> 11255 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11256 <img SRC="images/right_triangle_option.png" 11257 ALT=">" BORDER=0 height=14 11258 width=15><b><font face="Helvetica, Arial" 11259 ><font color="#00B04F"><font size="+1"> 11260 <a href="GraphicsMagick.html#details-crop">-crop</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i> 11261 </font></font></font></b></td></tr></table> 11262 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the cropped image</td></tr></table> 11263 <table BORDER=0 WIDTH="94%"> 11264 <tr> 11265 <td width="3%"><br></td> 11266 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11267 <img SRC="images/right_triangle_option.png" 11268 ALT=">" BORDER=0 height=14 11269 width=15><b><font face="Helvetica, Arial" 11270 ><font color="#00B04F"><font size="+1"> 11271 -debug <i><events></i> 11272 </font></font></font></b></td></tr></table> 11273 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table> 11274 <table BORDER=0 WIDTH="94%"> 11275 <tr> 11276 <td width="3%"><br></td> 11277 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11278 <img SRC="images/right_triangle_option.png" 11279 ALT=">" BORDER=0 height=14 11280 width=15><b><font face="Helvetica, Arial" 11281 ><font color="#00B04F"><font size="+1"> 11282 <a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i> 11283 </font></font></font></b></td></tr></table> 11284 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table> 11285 <table BORDER=0 WIDTH="94%"> 11286 <tr> 11287 <td width="3%"><br></td> 11288 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11289 <img SRC="images/right_triangle_option.png" 11290 ALT=">" BORDER=0 height=14 11291 width=15><b><font face="Helvetica, Arial" 11292 ><font color="#00B04F"><font size="+1"> 11293 <a href="GraphicsMagick.html#details-delay">-delay</a> <i><1/100ths of a second></i> 11294 </font></font></font></b></td></tr></table> 11295 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the next image after pausing</td></tr></table> 11296 <table BORDER=0 WIDTH="94%"> 11297 <tr> 11298 <td width="3%"><br></td> 11299 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11300 <img SRC="images/right_triangle_option.png" 11301 ALT=">" BORDER=0 height=14 11302 width=15><b><font face="Helvetica, Arial" 11303 ><font color="#00B04F"><font size="+1"> 11304 <a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i> 11305 </font></font></font></b></td></tr></table> 11306 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table> 11307 <table BORDER=0 WIDTH="94%"> 11308 <tr> 11309 <td width="3%"><br></td> 11310 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11311 <img SRC="images/right_triangle_option.png" 11312 ALT=">" BORDER=0 height=14 11313 width=15><b><font face="Helvetica, Arial" 11314 ><font color="#00B04F"><font size="+1"> 11315 <a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i> 11316 </font></font></font></b></td></tr></table> 11317 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table> 11318 <table BORDER=0 WIDTH="94%"> 11319 <tr> 11320 <td width="3%"><br></td> 11321 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11322 <img SRC="images/right_triangle_option.png" 11323 ALT=">" BORDER=0 height=14 11324 width=15><b><font face="Helvetica, Arial" 11325 ><font color="#00B04F"><font size="+1"> 11326 -despeckle 11327 </font></font></font></b></td></tr></table> 11328 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>reduce the speckles within an image</td></tr></table> 11329 <table BORDER=0 WIDTH="94%"> 11330 <tr> 11331 <td width="3%"><br></td> 11332 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11333 <img SRC="images/right_triangle_option.png" 11334 ALT=">" BORDER=0 height=14 11335 width=15><b><font face="Helvetica, Arial" 11336 ><font color="#00B04F"><font size="+1"> 11337 <a href="GraphicsMagick.html#details-display">-display</a> <i><host:display[.screen]></i> 11338 </font></font></font></b></td></tr></table> 11339 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table> 11340 <table BORDER=0 WIDTH="94%"> 11341 <tr> 11342 <td width="3%"><br></td> 11343 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11344 <img SRC="images/right_triangle_option.png" 11345 ALT=">" BORDER=0 height=14 11346 width=15><b><font face="Helvetica, Arial" 11347 ><font color="#00B04F"><font size="+1"> 11348 <a href="GraphicsMagick.html#details-dispose">-dispose</a> <i><method></i> 11349 </font></font></font></b></td></tr></table> 11350 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table> 11351 <table BORDER=0 WIDTH="94%"> 11352 <tr> 11353 <td width="3%"><br></td> 11354 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11355 <img SRC="images/right_triangle_option.png" 11356 ALT=">" BORDER=0 height=14 11357 width=15><b><font face="Helvetica, Arial" 11358 ><font color="#00B04F"><font size="+1"> 11359 <a href="GraphicsMagick.html#details-dither">-dither</a> 11360 </font></font></font></b></td></tr></table> 11361 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table> 11362 <table BORDER=0 WIDTH="94%"> 11363 <tr> 11364 <td width="3%"><br></td> 11365 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11366 <img SRC="images/right_triangle_option.png" 11367 ALT=">" BORDER=0 height=14 11368 width=15><b><font face="Helvetica, Arial" 11369 ><font color="#00B04F"><font size="+1"> 11370 -edge <i><radius></i> 11371 </font></font></font></b></td></tr></table> 11372 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>detect edges within an image</td></tr></table> 11373 <table BORDER=0 WIDTH="94%"> 11374 <tr> 11375 <td width="3%"><br></td> 11376 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11377 <img SRC="images/right_triangle_option.png" 11378 ALT=">" BORDER=0 height=14 11379 width=15><b><font face="Helvetica, Arial" 11380 ><font color="#00B04F"><font size="+1"> 11381 <a href="GraphicsMagick.html#details-endian">-endian</a> <i><type></i> 11382 </font></font></font></b></td></tr></table> 11383 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify endianness (MSB, LSB, or Native) of image</td></tr></table> 11384 <table BORDER=0 WIDTH="94%"> 11385 <tr> 11386 <td width="3%"><br></td> 11387 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11388 <img SRC="images/right_triangle_option.png" 11389 ALT=">" BORDER=0 height=14 11390 width=15><b><font face="Helvetica, Arial" 11391 ><font color="#00B04F"><font size="+1"> 11392 -enhance 11393 </font></font></font></b></td></tr></table> 11394 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a digital filter to enhance a noisy image</td></tr></table> 11395 <table BORDER=0 WIDTH="94%"> 11396 <tr> 11397 <td width="3%"><br></td> 11398 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11399 <img SRC="images/right_triangle_option.png" 11400 ALT=">" BORDER=0 height=14 11401 width=15><b><font face="Helvetica, Arial" 11402 ><font color="#00B04F"><font size="+1"> 11403 <a href="GraphicsMagick.html#details-filter">-filter</a> <i><type></i> 11404 </font></font></font></b></td></tr></table> 11405 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this type of filter when resizing an image</td></tr></table> 11406 <table BORDER=0 WIDTH="94%"> 11407 <tr> 11408 <td width="3%"><br></td> 11409 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11410 <img SRC="images/right_triangle_option.png" 11411 ALT=">" BORDER=0 height=14 11412 width=15><b><font face="Helvetica, Arial" 11413 ><font color="#00B04F"><font size="+1"> 11414 <a href="GraphicsMagick.html#details-flip">-flip</a> 11415 </font></font></font></b></td></tr></table> 11416 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table> 11417 <table BORDER=0 WIDTH="94%"> 11418 <tr> 11419 <td width="3%"><br></td> 11420 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11421 <img SRC="images/right_triangle_option.png" 11422 ALT=">" BORDER=0 height=14 11423 width=15><b><font face="Helvetica, Arial" 11424 ><font color="#00B04F"><font size="+1"> 11425 <a href="GraphicsMagick.html#details-flop">-flop</a> 11426 </font></font></font></b></td></tr></table> 11427 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table> 11428 <table BORDER=0 WIDTH="94%"> 11429 <tr> 11430 <td width="3%"><br></td> 11431 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11432 <img SRC="images/right_triangle_option.png" 11433 ALT=">" BORDER=0 height=14 11434 width=15><b><font face="Helvetica, Arial" 11435 ><font color="#00B04F"><font size="+1"> 11436 <a href="GraphicsMagick.html#details-font">-font</a> <i><name></i> 11437 </font></font></font></b></td></tr></table> 11438 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this font when annotating the image with text</td></tr></table> 11439 <table BORDER=0 WIDTH="94%"> 11440 <tr> 11441 <td width="3%"><br></td> 11442 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11443 <img SRC="images/right_triangle_option.png" 11444 ALT=">" BORDER=0 height=14 11445 width=15><b><font face="Helvetica, Arial" 11446 ><font color="#00B04F"><font size="+1"> 11447 <a href="GraphicsMagick.html#details-foreground">-foreground</a> <i><color></i> 11448 </font></font></font></b></td></tr></table> 11449 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>define the foreground color</td></tr></table> 11450 <table BORDER=0 WIDTH="94%"> 11451 <tr> 11452 <td width="3%"><br></td> 11453 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11454 <img SRC="images/right_triangle_option.png" 11455 ALT=">" BORDER=0 height=14 11456 width=15><b><font face="Helvetica, Arial" 11457 ><font color="#00B04F"><font size="+1"> 11458 <a href="GraphicsMagick.html#details-frame">-frame</a> <i><width>x<height>+<outer bevel width>+<inner bevel width></i> 11459 </font></font></font></b></td></tr></table> 11460 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with an ornamental border</td></tr></table> 11461 <table BORDER=0 WIDTH="94%"> 11462 <tr> 11463 <td width="3%"><br></td> 11464 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11465 <img SRC="images/right_triangle_option.png" 11466 ALT=">" BORDER=0 height=14 11467 width=15><b><font face="Helvetica, Arial" 11468 ><font color="#00B04F"><font size="+1"> 11469 <a href="GraphicsMagick.html#details-gamma">-gamma</a> <i><value></i> 11470 </font></font></font></b></td></tr></table> 11471 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>level of gamma correction</td></tr></table> 11472 <table BORDER=0 WIDTH="94%"> 11473 <tr> 11474 <td width="3%"><br></td> 11475 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11476 <img SRC="images/right_triangle_option.png" 11477 ALT=">" BORDER=0 height=14 11478 width=15><b><font face="Helvetica, Arial" 11479 ><font color="#00B04F"><font size="+1"> 11480 <a href="GraphicsMagick.html#details-geometry">-geometry</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i>^</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 11481 </font></font></font></b></td></tr></table> 11482 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify dimension, offset, and resize options.</td></tr></table> 11483 <table BORDER=0 WIDTH="94%"> 11484 <tr> 11485 <td width="3%"><br></td> 11486 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11487 <img SRC="images/right_triangle_option.png" 11488 ALT=">" BORDER=0 height=14 11489 width=15><b><font face="Helvetica, Arial" 11490 ><font color="#00B04F"><font size="+1"> 11491 -help 11492 </font></font></font></b></td></tr></table> 11493 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table> 11494 <table BORDER=0 WIDTH="94%"> 11495 <tr> 11496 <td width="3%"><br></td> 11497 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11498 <img SRC="images/right_triangle_option.png" 11499 ALT=">" BORDER=0 height=14 11500 width=15><b><font face="Helvetica, Arial" 11501 ><font color="#00B04F"><font size="+1"> 11502 <a href="GraphicsMagick.html#details-iconGeometry">-iconGeometry</a> <i><geometry></i> 11503 </font></font></font></b></td></tr></table> 11504 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the icon geometry</td></tr></table> 11505 <table BORDER=0 WIDTH="94%"> 11506 <tr> 11507 <td width="3%"><br></td> 11508 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11509 <img SRC="images/right_triangle_option.png" 11510 ALT=">" BORDER=0 height=14 11511 width=15><b><font face="Helvetica, Arial" 11512 ><font color="#00B04F"><font size="+1"> 11513 -iconic 11514 </font></font></font></b></td></tr></table> 11515 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>iconic animation</td></tr></table> 11516 <table BORDER=0 WIDTH="94%"> 11517 <tr> 11518 <td width="3%"><br></td> 11519 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11520 <img SRC="images/right_triangle_option.png" 11521 ALT=">" BORDER=0 height=14 11522 width=15><b><font face="Helvetica, Arial" 11523 ><font color="#00B04F"><font size="+1"> 11524 -immutable 11525 </font></font></font></b></td></tr></table> 11526 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make image immutable</td></tr></table> 11527 <table BORDER=0 WIDTH="94%"> 11528 <tr> 11529 <td width="3%"><br></td> 11530 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11531 <img SRC="images/right_triangle_option.png" 11532 ALT=">" BORDER=0 height=14 11533 width=15><b><font face="Helvetica, Arial" 11534 ><font color="#00B04F"><font size="+1"> 11535 <a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i> 11536 </font></font></font></b></td></tr></table> 11537 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table> 11538 <table BORDER=0 WIDTH="94%"> 11539 <tr> 11540 <td width="3%"><br></td> 11541 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11542 <img SRC="images/right_triangle_option.png" 11543 ALT=">" BORDER=0 height=14 11544 width=15><b><font face="Helvetica, Arial" 11545 ><font color="#00B04F"><font size="+1"> 11546 <a href="GraphicsMagick.html#details-label">-label</a> <i><name></i> 11547 </font></font></font></b></td></tr></table> 11548 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign a label to an image</td></tr></table> 11549 <table BORDER=0 WIDTH="94%"> 11550 <tr> 11551 <td width="3%"><br></td> 11552 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11553 <img SRC="images/right_triangle_option.png" 11554 ALT=">" BORDER=0 height=14 11555 width=15><b><font face="Helvetica, Arial" 11556 ><font color="#00B04F"><font size="+1"> 11557 <a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i> 11558 </font></font></font></b></td></tr></table> 11559 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table> 11560 <table BORDER=0 WIDTH="94%"> 11561 <tr> 11562 <td width="3%"><br></td> 11563 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11564 <img SRC="images/right_triangle_option.png" 11565 ALT=">" BORDER=0 height=14 11566 width=15><b><font face="Helvetica, Arial" 11567 ><font color="#00B04F"><font size="+1"> 11568 <a href="GraphicsMagick.html#details-log">-log</a> <i><string></i> 11569 </font></font></font></b></td></tr></table> 11570 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table> 11571 <table BORDER=0 WIDTH="94%"> 11572 <tr> 11573 <td width="3%"><br></td> 11574 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11575 <img SRC="images/right_triangle_option.png" 11576 ALT=">" BORDER=0 height=14 11577 width=15><b><font face="Helvetica, Arial" 11578 ><font color="#00B04F"><font size="+1"> 11579 -magnify <i><factor></i> 11580 </font></font></font></b></td></tr></table> 11581 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>magnify the image</td></tr></table> 11582 <table BORDER=0 WIDTH="94%"> 11583 <tr> 11584 <td width="3%"><br></td> 11585 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11586 <img SRC="images/right_triangle_option.png" 11587 ALT=">" BORDER=0 height=14 11588 width=15><b><font face="Helvetica, Arial" 11589 ><font color="#00B04F"><font size="+1"> 11590 <a href="GraphicsMagick.html#details-map">-map</a> <i><type></i> 11591 </font></font></font></b></td></tr></table> 11592 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display image using this type.</td></tr></table> 11593 <table BORDER=0 WIDTH="94%"> 11594 <tr> 11595 <td width="3%"><br></td> 11596 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11597 <img SRC="images/right_triangle_option.png" 11598 ALT=">" BORDER=0 height=14 11599 width=15><b><font face="Helvetica, Arial" 11600 ><font color="#00B04F"><font size="+1"> 11601 <a href="GraphicsMagick.html#details-matte">-matte</a> 11602 </font></font></font></b></td></tr></table> 11603 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table> 11604 <table BORDER=0 WIDTH="94%"> 11605 <tr> 11606 <td width="3%"><br></td> 11607 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11608 <img SRC="images/right_triangle_option.png" 11609 ALT=">" BORDER=0 height=14 11610 width=15><b><font face="Helvetica, Arial" 11611 ><font color="#00B04F"><font size="+1"> 11612 <a href="GraphicsMagick.html#details-mattecolor">-mattecolor</a> <i><color></i> 11613 </font></font></font></b></td></tr></table> 11614 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the color to be used with the <strong>-frame</strong> option</td></tr></table> 11615 <table BORDER=0 WIDTH="94%"> 11616 <tr> 11617 <td width="3%"><br></td> 11618 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11619 <img SRC="images/right_triangle_option.png" 11620 ALT=">" BORDER=0 height=14 11621 width=15><b><font face="Helvetica, Arial" 11622 ><font color="#00B04F"><font size="+1"> 11623 -monitor 11624 </font></font></font></b></td></tr></table> 11625 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>show progress indication</td></tr></table> 11626 <table BORDER=0 WIDTH="94%"> 11627 <tr> 11628 <td width="3%"><br></td> 11629 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11630 <img SRC="images/right_triangle_option.png" 11631 ALT=">" BORDER=0 height=14 11632 width=15><b><font face="Helvetica, Arial" 11633 ><font color="#00B04F"><font size="+1"> 11634 -monochrome 11635 </font></font></font></b></td></tr></table> 11636 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table> 11637 <table BORDER=0 WIDTH="94%"> 11638 <tr> 11639 <td width="3%"><br></td> 11640 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11641 <img SRC="images/right_triangle_option.png" 11642 ALT=">" BORDER=0 height=14 11643 width=15><b><font face="Helvetica, Arial" 11644 ><font color="#00B04F"><font size="+1"> 11645 -name 11646 </font></font></font></b></td></tr></table> 11647 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name an image</td></tr></table> 11648 <table BORDER=0 WIDTH="94%"> 11649 <tr> 11650 <td width="3%"><br></td> 11651 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11652 <img SRC="images/right_triangle_option.png" 11653 ALT=">" BORDER=0 height=14 11654 width=15><b><font face="Helvetica, Arial" 11655 ><font color="#00B04F"><font size="+1"> 11656 <a href="GraphicsMagick.html#details-negate">-negate</a> 11657 </font></font></font></b></td></tr></table> 11658 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>replace every pixel with its complementary color</td></tr></table> 11659 <table BORDER=0 WIDTH="94%"> 11660 <tr> 11661 <td width="3%"><br></td> 11662 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11663 <img SRC="images/right_triangle_option.png" 11664 ALT=">" BORDER=0 height=14 11665 width=15><b><font face="Helvetica, Arial" 11666 ><font color="#00B04F"><font size="+1"> 11667 <a href="GraphicsMagick.html#details-noop">-noop</a> 11668 </font></font></font></b></td></tr></table> 11669 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>NOOP (no option)</td></tr></table> 11670 <table BORDER=0 WIDTH="94%"> 11671 <tr> 11672 <td width="3%"><br></td> 11673 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11674 <img SRC="images/right_triangle_option.png" 11675 ALT=">" BORDER=0 height=14 11676 width=15><b><font face="Helvetica, Arial" 11677 ><font color="#00B04F"><font size="+1"> 11678 <a href="GraphicsMagick.html#details-page">-page</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 11679 </font></font></font></b></td></tr></table> 11680 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>size and location of an image canvas</td></tr></table> 11681 <table BORDER=0 WIDTH="94%"> 11682 <tr> 11683 <td width="3%"><br></td> 11684 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11685 <img SRC="images/right_triangle_option.png" 11686 ALT=">" BORDER=0 height=14 11687 width=15><b><font face="Helvetica, Arial" 11688 ><font color="#00B04F"><font size="+1"> 11689 <a href="GraphicsMagick.html#details+progress">+progress</a> 11690 </font></font></font></b></td></tr></table> 11691 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>disable progress monitor and busy cursor</td></tr></table> 11692 <table BORDER=0 WIDTH="94%"> 11693 <tr> 11694 <td width="3%"><br></td> 11695 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11696 <img SRC="images/right_triangle_option.png" 11697 ALT=">" BORDER=0 height=14 11698 width=15><b><font face="Helvetica, Arial" 11699 ><font color="#00B04F"><font size="+1"> 11700 <a href="GraphicsMagick.html#details-quality">-quality</a> <i><value></i> 11701 </font></font></font></b></td></tr></table> 11702 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>JPEG/MIFF/PNG/TIFF compression level</td></tr></table> 11703 <table BORDER=0 WIDTH="94%"> 11704 <tr> 11705 <td width="3%"><br></td> 11706 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11707 <img SRC="images/right_triangle_option.png" 11708 ALT=">" BORDER=0 height=14 11709 width=15><b><font face="Helvetica, Arial" 11710 ><font color="#00B04F"><font size="+1"> 11711 <a href="GraphicsMagick.html#details-raise">-raise</a> <i><width>x<height></i> 11712 </font></font></font></b></td></tr></table> 11713 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>lighten or darken image edges</td></tr></table> 11714 <table BORDER=0 WIDTH="94%"> 11715 <tr> 11716 <td width="3%"><br></td> 11717 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11718 <img SRC="images/right_triangle_option.png" 11719 ALT=">" BORDER=0 height=14 11720 width=15><b><font face="Helvetica, Arial" 11721 ><font color="#00B04F"><font size="+1"> 11722 <a href="GraphicsMagick.html#details-remote">-remote</a> 11723 </font></font></font></b></td></tr></table> 11724 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform a X11 remote operation</td></tr></table> 11725 <table BORDER=0 WIDTH="94%"> 11726 <tr> 11727 <td width="3%"><br></td> 11728 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11729 <img SRC="images/right_triangle_option.png" 11730 ALT=">" BORDER=0 height=14 11731 width=15><b><font face="Helvetica, Arial" 11732 ><font color="#00B04F"><font size="+1"> 11733 <a href="GraphicsMagick.html#details-roll">-roll</a> <i></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i> 11734 </font></font></font></b></td></tr></table> 11735 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>roll an image vertically or horizontally</td></tr></table> 11736 <table BORDER=0 WIDTH="94%"> 11737 <tr> 11738 <td width="3%"><br></td> 11739 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11740 <img SRC="images/right_triangle_option.png" 11741 ALT=">" BORDER=0 height=14 11742 width=15><b><font face="Helvetica, Arial" 11743 ><font color="#00B04F"><font size="+1"> 11744 <a href="GraphicsMagick.html#details-rotate">-rotate</a> <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 11745 </font></font></font></b></td></tr></table> 11746 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>rotate the image</td></tr></table> 11747 <table BORDER=0 WIDTH="94%"> 11748 <tr> 11749 <td width="3%"><br></td> 11750 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11751 <img SRC="images/right_triangle_option.png" 11752 ALT=">" BORDER=0 height=14 11753 width=15><b><font face="Helvetica, Arial" 11754 ><font color="#00B04F"><font size="+1"> 11755 <a href="GraphicsMagick.html#details-sample">-sample</a> <i><geometry></i> 11756 </font></font></font></b></td></tr></table> 11757 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>scale image using pixel sampling</td></tr></table> 11758 <table BORDER=0 WIDTH="94%"> 11759 <tr> 11760 <td width="3%"><br></td> 11761 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11762 <img SRC="images/right_triangle_option.png" 11763 ALT=">" BORDER=0 height=14 11764 width=15><b><font face="Helvetica, Arial" 11765 ><font color="#00B04F"><font size="+1"> 11766 <a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i> 11767 </font></font></font></b></td></tr></table> 11768 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chroma subsampling factors</td></tr></table> 11769 <table BORDER=0 WIDTH="94%"> 11770 <tr> 11771 <td width="3%"><br></td> 11772 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11773 <img SRC="images/right_triangle_option.png" 11774 ALT=">" BORDER=0 height=14 11775 width=15><b><font face="Helvetica, Arial" 11776 ><font color="#00B04F"><font size="+1"> 11777 <a href="GraphicsMagick.html#details-scenes">-scenes</a> <i><value-value></i> 11778 </font></font></font></b></td></tr></table> 11779 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>range of image scene numbers to read</td></tr></table> 11780 <table BORDER=0 WIDTH="94%"> 11781 <tr> 11782 <td width="3%"><br></td> 11783 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11784 <img SRC="images/right_triangle_option.png" 11785 ALT=">" BORDER=0 height=14 11786 width=15><b><font face="Helvetica, Arial" 11787 ><font color="#00B04F"><font size="+1"> 11788 <a href="GraphicsMagick.html#details-set">-set</a> <i><attribute> <value></i> 11789 </font></font></font></b></td></tr></table> 11790 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set an image attribute</td></tr></table> 11791 <table BORDER=0 WIDTH="94%"> 11792 <tr> 11793 <td width="3%"><br></td> 11794 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11795 <img SRC="images/right_triangle_option.png" 11796 ALT=">" BORDER=0 height=14 11797 width=15><b><font face="Helvetica, Arial" 11798 ><font color="#00B04F"><font size="+1"> 11799 <a href="GraphicsMagick.html#details+set">+set</a> <i><attribute></i> 11800 </font></font></font></b></td></tr></table> 11801 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>unset an image attribute</td></tr></table> 11802 <table BORDER=0 WIDTH="94%"> 11803 <tr> 11804 <td width="3%"><br></td> 11805 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11806 <img SRC="images/right_triangle_option.png" 11807 ALT=">" BORDER=0 height=14 11808 width=15><b><font face="Helvetica, Arial" 11809 ><font color="#00B04F"><font size="+1"> 11810 <a href="GraphicsMagick.html#details-segment">-segment</a> <i><cluster threshold>x<smoothing threshold></i> 11811 </font></font></font></b></td></tr></table> 11812 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>segment an image</td></tr></table> 11813 <table BORDER=0 WIDTH="94%"> 11814 <tr> 11815 <td width="3%"><br></td> 11816 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11817 <img SRC="images/right_triangle_option.png" 11818 ALT=">" BORDER=0 height=14 11819 width=15><b><font face="Helvetica, Arial" 11820 ><font color="#00B04F"><font size="+1"> 11821 <a href="GraphicsMagick.html#details-shared-memory">-shared-memory</a> 11822 </font></font></font></b></td></tr></table> 11823 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use shared memory</td></tr></table> 11824 <table BORDER=0 WIDTH="94%"> 11825 <tr> 11826 <td width="3%"><br></td> 11827 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11828 <img SRC="images/right_triangle_option.png" 11829 ALT=">" BORDER=0 height=14 11830 width=15><b><font face="Helvetica, Arial" 11831 ><font color="#00B04F"><font size="+1"> 11832 <a href="GraphicsMagick.html#details-sharpen">-sharpen</a> <i><radius></i>{<i>x<sigma></i>}<i></i> 11833 </font></font></font></b></td></tr></table> 11834 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image</td></tr></table> 11835 <table BORDER=0 WIDTH="94%"> 11836 <tr> 11837 <td width="3%"><br></td> 11838 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11839 <img SRC="images/right_triangle_option.png" 11840 ALT=">" BORDER=0 height=14 11841 width=15><b><font face="Helvetica, Arial" 11842 ><font color="#00B04F"><font size="+1"> 11843 <a href="GraphicsMagick.html#details-size">-size</a> <i><width>x<height></i>{<i>+offset</i>}<i></i> 11844 </font></font></font></b></td></tr></table> 11845 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table> 11846 <table BORDER=0 WIDTH="94%"> 11847 <tr> 11848 <td width="3%"><br></td> 11849 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11850 <img SRC="images/right_triangle_option.png" 11851 ALT=">" BORDER=0 height=14 11852 width=15><b><font face="Helvetica, Arial" 11853 ><font color="#00B04F"><font size="+1"> 11854 <a href="GraphicsMagick.html#details-text-font">-text-font</a> <i><name></i> 11855 </font></font></font></b></td></tr></table> 11856 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>font for writing fixed-width text</td></tr></table> 11857 <table BORDER=0 WIDTH="94%"> 11858 <tr> 11859 <td width="3%"><br></td> 11860 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11861 <img SRC="images/right_triangle_option.png" 11862 ALT=">" BORDER=0 height=14 11863 width=15><b><font face="Helvetica, Arial" 11864 ><font color="#00B04F"><font size="+1"> 11865 -texture <i><filename></i> 11866 </font></font></font></b></td></tr></table> 11867 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name of texture to tile onto the image background</td></tr></table> 11868 <table BORDER=0 WIDTH="94%"> 11869 <tr> 11870 <td width="3%"><br></td> 11871 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11872 <img SRC="images/right_triangle_option.png" 11873 ALT=">" BORDER=0 height=14 11874 width=15><b><font face="Helvetica, Arial" 11875 ><font color="#00B04F"><font size="+1"> 11876 <a href="GraphicsMagick.html#details-title">-title</a> <i><string></i> 11877 </font></font></font></b></td></tr></table> 11878 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign title to displayed image [<em>animate, display, montage</em>]</td></tr></table> 11879 <table BORDER=0 WIDTH="94%"> 11880 <tr> 11881 <td width="3%"><br></td> 11882 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11883 <img SRC="images/right_triangle_option.png" 11884 ALT=">" BORDER=0 height=14 11885 width=15><b><font face="Helvetica, Arial" 11886 ><font color="#00B04F"><font size="+1"> 11887 <a href="GraphicsMagick.html#details-treedepth">-treedepth</a> <i><value></i> 11888 </font></font></font></b></td></tr></table> 11889 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tree depth for the color reduction algorithm</td></tr></table> 11890 <table BORDER=0 WIDTH="94%"> 11891 <tr> 11892 <td width="3%"><br></td> 11893 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11894 <img SRC="images/right_triangle_option.png" 11895 ALT=">" BORDER=0 height=14 11896 width=15><b><font face="Helvetica, Arial" 11897 ><font color="#00B04F"><font size="+1"> 11898 <a href="GraphicsMagick.html#details-trim">-trim</a> 11899 </font></font></font></b></td></tr></table> 11900 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table> 11901 <table BORDER=0 WIDTH="94%"> 11902 <tr> 11903 <td width="3%"><br></td> 11904 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11905 <img SRC="images/right_triangle_option.png" 11906 ALT=">" BORDER=0 height=14 11907 width=15><b><font face="Helvetica, Arial" 11908 ><font color="#00B04F"><font size="+1"> 11909 <a href="GraphicsMagick.html#details-type">-type</a> <i><type></i> 11910 </font></font></font></b></td></tr></table> 11911 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image type</td></tr></table> 11912 <table BORDER=0 WIDTH="94%"> 11913 <tr> 11914 <td width="3%"><br></td> 11915 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11916 <img SRC="images/right_triangle_option.png" 11917 ALT=">" BORDER=0 height=14 11918 width=15><b><font face="Helvetica, Arial" 11919 ><font color="#00B04F"><font size="+1"> 11920 <a href="GraphicsMagick.html#details-update">-update</a> <i><seconds></i> 11921 </font></font></font></b></td></tr></table> 11922 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 11923 detect when image file is modified and redisplay.</td></tr></table> 11924 <table BORDER=0 WIDTH="94%"> 11925 <tr> 11926 <td width="3%"><br></td> 11927 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11928 <img SRC="images/right_triangle_option.png" 11929 ALT=">" BORDER=0 height=14 11930 width=15><b><font face="Helvetica, Arial" 11931 ><font color="#00B04F"><font size="+1"> 11932 -use-pixmap 11933 </font></font></font></b></td></tr></table> 11934 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use the pixmap</td></tr></table> 11935 <table BORDER=0 WIDTH="94%"> 11936 <tr> 11937 <td width="3%"><br></td> 11938 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11939 <img SRC="images/right_triangle_option.png" 11940 ALT=">" BORDER=0 height=14 11941 width=15><b><font face="Helvetica, Arial" 11942 ><font color="#00B04F"><font size="+1"> 11943 <a href="GraphicsMagick.html#details-verbose">-verbose</a> 11944 </font></font></font></b></td></tr></table> 11945 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table> 11946 <table BORDER=0 WIDTH="94%"> 11947 <tr> 11948 <td width="3%"><br></td> 11949 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11950 <img SRC="images/right_triangle_option.png" 11951 ALT=">" BORDER=0 height=14 11952 width=15><b><font face="Helvetica, Arial" 11953 ><font color="#00B04F"><font size="+1"> 11954 <a href="GraphicsMagick.html#details-version">-version</a> 11955 </font></font></font></b></td></tr></table> 11956 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table> 11957 <table BORDER=0 WIDTH="94%"> 11958 <tr> 11959 <td width="3%"><br></td> 11960 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11961 <img SRC="images/right_triangle_option.png" 11962 ALT=">" BORDER=0 height=14 11963 width=15><b><font face="Helvetica, Arial" 11964 ><font color="#00B04F"><font size="+1"> 11965 <a href="GraphicsMagick.html#details-visual">-visual</a> <i><type></i> 11966 </font></font></font></b></td></tr></table> 11967 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>animate images using this X visual type</td></tr></table> 11968 <table BORDER=0 WIDTH="94%"> 11969 <tr> 11970 <td width="3%"><br></td> 11971 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11972 <img SRC="images/right_triangle_option.png" 11973 ALT=">" BORDER=0 height=14 11974 width=15><b><font face="Helvetica, Arial" 11975 ><font color="#00B04F"><font size="+1"> 11976 <a href="GraphicsMagick.html#details-window">-window</a> <i><id></i> 11977 </font></font></font></b></td></tr></table> 11978 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make image the background of a window</td></tr></table> 11979 <table BORDER=0 WIDTH="94%"> 11980 <tr> 11981 <td width="3%"><br></td> 11982 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11983 <img SRC="images/right_triangle_option.png" 11984 ALT=">" BORDER=0 height=14 11985 width=15><b><font face="Helvetica, Arial" 11986 ><font color="#00B04F"><font size="+1"> 11987 -window-group 11988 </font></font></font></b></td></tr></table> 11989 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the window group</td></tr></table> 11990 <table BORDER=0 WIDTH="94%"> 11991 <tr> 11992 <td width="3%"><br></td> 11993 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 11994 <img SRC="images/right_triangle_option.png" 11995 ALT=">" BORDER=0 height=14 11996 width=15><b><font face="Helvetica, Arial" 11997 ><font color="#00B04F"><font size="+1"> 11998 <a href="GraphicsMagick.html#details-write">-write</a> <i><filename></i> 11999 </font></font></font></b></td></tr></table> 12000 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>write the image to a file [<em>display</em>]</td></tr></table> 12001 <p> 12002 For a more detailed description of each option, see 12003 Options, above. 12004 <br> <br> 12005 </td></tr></table> 12006 <p> 12007 <i><a href="#top">Back to Contents</a></i> 12008 </p> 12009 <table BORDER=0 WIDTH="100%"> 12010 <tr> 12011 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 12012 SRC="images/right_triangle.png" ALT=">" BORDER=0 12013 height=14 width=15><b><font face="Helvetica, Arial"><font 12014 color="#00B04F"><font size="+1"> 12015 <a NAME="disp-mous"></a>Mouse Buttons 12016 </font></font></font></b></td></tr></table> 12017 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 12018 <tr><td width="3%"><br></td><td> 12019 <p> 12020 The effects of each button press is described below. Three buttons are 12021 required. If you have a two button mouse, button 1 and 3 are returned. 12022 Press <strong>ALT</strong> and button 3 to simulate button 2. 12023 <table BORDER=0 WIDTH="94%"> 12024 <tr> 12025 <td width="3%"><br></td> 12026 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12027 <img SRC="images/right_triangle_option.png" 12028 ALT=">" BORDER=0 height=14 12029 width=15><b><font face="Helvetica, Arial" 12030 ><font color="#00B04F"><font size="+1"> 12031 1 12032 </font></font></font></b></td></tr></table> 12033 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12034 Press this button to map or unmap the <a href="#disp-comm">Command 12035 widget</a> . See the next section for more information about the Command 12036 widget.</td></tr></table> 12037 <table BORDER=0 WIDTH="94%"> 12038 <tr> 12039 <td width="3%"><br></td> 12040 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12041 <img SRC="images/right_triangle_option.png" 12042 ALT=">" BORDER=0 height=14 12043 width=15><b><font face="Helvetica, Arial" 12044 ><font color="#00B04F"><font size="+1"> 12045 2 12046 </font></font></font></b></td></tr></table> 12047 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12048 Press and drag to define a region of the image to magnify.</td></tr></table> 12049 <table BORDER=0 WIDTH="94%"> 12050 <tr> 12051 <td width="3%"><br></td> 12052 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12053 <img SRC="images/right_triangle_option.png" 12054 ALT=">" BORDER=0 height=14 12055 width=15><b><font face="Helvetica, Arial" 12056 ><font color="#00B04F"><font size="+1"> 12057 3 12058 </font></font></font></b></td></tr></table> 12059 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12060 Press and drag to choose from a select set of <strong>display(1)</strong> 12061 commands. This button behaves differently if the image being displayed 12062 is a visual image directory. Choose a particular tile of the directory 12063 and press this button and drag to select a command from a pop-up menu. 12064 Choose from these menu items:</td></tr></table> 12065 <ul> 12066 <li>Open 12067 <li>Next 12068 <li>Former 12069 <li>Delete 12070 <li>Update 12071 </ul> 12072 <p> 12073 If you choose <strong>Open</strong>, the image represented by the tile is displayed. 12074 To return to the visual image directory, choose <strong>Next</strong> from the Command 12075 widget (refer to <a href="#disp-comm">Command Widget</a>). 12076 <strong>Next</strong> and <strong>Former</strong> 12077 moves to the next or former image respectively. Choose <strong>Delete</strong> to 12078 delete a particular image tile. Finally, choose <strong>Update</strong> to synchronize 12079 all the image tiles with their respective images. See 12080 <a href="montage.html">montage</a> 12081 and 12082 <a href="miff.html">miff</a> for more details. 12083 </td></tr></table> 12084 <p> 12085 <i><a href="#top">Back to Contents</a></i> 12086 </p> 12087 <table BORDER=0 WIDTH="100%"> 12088 <tr> 12089 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 12090 SRC="images/right_triangle.png" ALT=">" BORDER=0 12091 height=14 width=15><b><font face="Helvetica, Arial"><font 12092 color="#00B04F"><font size="+1"> 12093 <a NAME="disp-comm"></a>Command Widget 12094 </font></font></font></b></td></tr></table> 12095 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 12096 <tr><td width="3%"><br></td><td> 12097 <p> 12098 The Command widget lists a number of sub-menus and commands. They are 12099 <ul> 12100 <li><strong>File</strong> 12101 <ul> 12102 <li>Open... 12103 <li>Next 12104 <li>Former 12105 <li>Select... 12106 <li>Save... 12107 <li>Print... 12108 <li>Delete... 12109 <li>Canvas... 12110 <li>Visual Directory... 12111 <li>Quit 12112 </ul> 12113 </ul> 12114 <ul> 12115 <li><strong>Edit</strong> 12116 <ul> 12117 <li>Undo 12118 <li>Redo 12119 <li>Cut 12120 <li>Copy 12121 <li>Paste 12122 </ul> 12123 </ul> 12124 <ul> 12125 <li><strong>View</strong> 12126 <ul> 12127 <li>Half Size 12128 <li>Original Size 12129 <li>Double Size 12130 <li>Resize... 12131 <li>Apply 12132 <li>Refresh 12133 <li>Restore 12134 </ul> 12135 </ul> 12136 <ul> 12137 <li><strong>Transform</strong> 12138 <ul> 12139 <li>Crop 12140 <li>Chop 12141 <li>Flop 12142 <li>Flip 12143 <li>Rotate Right 12144 <li>Rotate Left 12145 <li>Rotate... 12146 <li>Shear... 12147 <li>Roll... 12148 <li>Trim Edges 12149 </ul> 12150 </ul> 12151 <ul> 12152 <li><strong>Enhance</strong> 12153 <ul> 12154 <li>Hue... 12155 <li>Saturation... 12156 <li>Brightness... 12157 <li>Gamma... 12158 <li>Spiff... 12159 <li>Dull 12160 <li>Equalize 12161 <li>Normalize 12162 <li>Negate 12163 <li>GRAYscale 12164 <li>Quantize... 12165 </ul> 12166 </ul> 12167 <ul> 12168 <li><strong>Effects</strong> 12169 <ul> 12170 <li>Despeckle 12171 <li>Emboss 12172 <li>Reduce Noise 12173 <li>Add Noise 12174 <li>Sharpen... 12175 <li>Blur... 12176 <li>Threshold... 12177 <li>Edge Detect... 12178 <li>Spread... 12179 <li>Shade... 12180 <li>Raise... 12181 <li>Segment... 12182 </ul> 12183 </ul> 12184 <ul> 12185 <li><strong>F/X</strong> 12186 <ul> 12187 <li>Solarize... 12188 <li>Swirl... 12189 <li>Implode... 12190 <li>Wave... 12191 <li>Oil Paint... 12192 <li>Charcoal Draw... 12193 </ul> 12194 </ul> 12195 <ul> 12196 <li><strong>Image Edit</strong> 12197 <ul> 12198 <li>Annotate... 12199 <li>Draw... 12200 <li>Color... 12201 <li>Matte... 12202 <li>Composite... 12203 <li>Add Border... 12204 <li>Add Frame... 12205 <li>Comment... 12206 <li>Launch... 12207 <li>Region of Interest... 12208 </ul> 12209 </ul> 12210 <ul> 12211 <li><strong>Miscellany</strong> 12212 <ul> 12213 <li>Image Info 12214 <li>Zoom Image 12215 <li>Show Preview... 12216 <li>Show Histogram 12217 <li>Show Matte 12218 <li>Background... 12219 <li>Slide Show 12220 <li>Preferences... 12221 </ul> 12222 </ul> 12223 <ul> 12224 <li><strong>Help</strong> 12225 <ul> 12226 <li>Overview 12227 <li>Browse Documentation 12228 <li>About Display 12229 </ul> 12230 </ul> 12231 <p> 12232 Menu items with a indented triangle have a sub-menu. They are represented 12233 above as the indented items. To access a sub-menu item, move the pointer 12234 to the appropriate menu and press button 1 and drag. When you find the 12235 desired sub-menu item, release the button and the command is executed. 12236 Move the pointer away from the sub-menu if you decide not to execute a 12237 particular command. 12238 </td></tr></table> 12239 <p> 12240 <i><a href="#top">Back to Contents</a></i> 12241 </p> 12242 <table BORDER=0 WIDTH="100%"> 12243 <tr> 12244 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 12245 SRC="images/right_triangle.png" ALT=">" BORDER=0 12246 height=14 width=15><b><font face="Helvetica, Arial"><font 12247 color="#00B04F"><font size="+1"> 12248 <a NAME="disp-keyb"></a>Keyboard Accelerators 12249 </font></font></font></b></td></tr></table> 12250 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 12251 <tr><td width="3%"><br></td><td> 12252 <p> 12253 Accelerators are one or two key presses that effect a particular command. 12254 The keyboard accelerators that 12255 <strong>display</strong> understands is: 12256 <pre> 12257 Ctl+O Press to <a href="#disp-imlo">load</a> an image from a file. 12258 space Press to display the next image. 12259 </pre> 12260 <p> 12261 If the image is a multi-paged document such as a 12262 <em>PostScript</em> document, 12263 you can skip ahead several pages by preceding this command with a number. 12264 For example to display the fourth page beyond the current page, 12265 press <tt>4space</tt>. 12266 <pre> 12267 backspace Press to display the former image. 12268 </pre> 12269 <p> 12270 If the image is a multi-paged document such as a 12271 <em>PostScript</em> document, 12272 you can skip behind several pages by preceding this command with a number. 12273 For example to display the fourth page preceding the current page, press 12274 4n. 12275 <pre> 12276 Ctl-S Press to save the image to a file. 12277 Ctl-P Press to print the image to a 12278 <em>PostScript</em> printer. 12279 Ctl-D Press to delete an image file. 12280 Ctl-N Press to create a blank canvas. 12281 Ctl-Q Press to discard all images and exit program. 12282 Ctl+Z Press to undo last image transformation. 12283 Ctl+R Press to redo last image transformation. 12284 Ctl-X Press to <a href="#disp-imcu">cut</a> a region of 12285 the image. 12286 Ctl-C Press to <a href="#disp-imco">copy</a> a region of 12287 the image. 12288 Ctl-V Press to <a href="#disp-impa">paste</a> a region to 12289 the image. 12290 < Press to halve the image size. 12291 . Press to return to the original image size. 12292 > Press to double the image size. 12293 % Press to resize the image to a width and height 12294 you specify. 12295 Cmd-A Press to make any image transformations 12296 permanent. 12297 By default, any image size transformations are 12298 applied to the original image to create the 12299 image displayed on the X server. However, the 12300 transformations are not permanent (i.e. the 12301 original image does not change size only the 12302 X image does). For example, if you press ">" 12303 the X image will appear to double in size, but 12304 the original image will in fact remain the same 12305 size. To force the original image to double in 12306 size, press ">" followed by "Cmd-A". 12307 @ Press to refresh the image window. 12308 C Press to <a href="#disp-imcr">crop</a> the image. 12309 [ Press to <a href="#disp-imch">chop</a> the image. 12310 H Press to flop image in the horizontal direction. 12311 V Press to flip image in the vertical direction. 12312 / Press to rotate the image 90 degrees clockwise. 12313 \ Press to rotate the image 90 degrees 12314 counter-clockwise. 12315 * Press to <a href="#disp-imro">rotate</a> the image 12316 the number of degrees you specify. 12317 S Press to shear the image the number of degrees 12318 you specify. 12319 R Press to roll the image. 12320 T Press to trim the image edges. 12321 Shft-H Press to vary the color hue. 12322 Shft-S Press to vary the color saturation. 12323 Shft-L Press to vary the image brightness. 12324 Shft-G Press to gamma correct the image. 12325 Shft-C Press to spiff up the image contrast. 12326 Shft-Z Press to dull the image contrast. 12327 = Press to perform histogram equalization on 12328 the image. 12329 Shft-N Press to perform histogram normalization on 12330 the image. 12331 Shft-~ Press to negate the colors of the image. 12332 . Press to convert the image colors to gray. 12333 Shft-# Press to set the maximum number of unique 12334 colors in the image. 12335 F2 Press to reduce the speckles in an image. 12336 F2 Press to emboss an image. 12337 F4 Press to eliminate peak noise from an image. 12338 F5 Press to add noise to an image. 12339 F6 Press to sharpen an image. 12340 F7 Press to blur image an image. 12341 F8 Press to threshold the image. 12342 F9 Press to detect edges within an image. 12343 F10 Press to displace pixels by a random amount. 12344 F11 Press to shade the image using a distant light 12345 source. 12346 F12 Press to lighten or darken image edges to 12347 create a 3-D effect. 12348 F13 Press to segment the image by color. 12349 Meta-S Press to swirl image pixels about the center. 12350 Meta-I Press to implode image pixels about the center. 12351 Meta-W Press to alter an image along a sine wave. 12352 Meta-P Press to simulate an oil painting. 12353 Meta-C Press to simulate a charcoal drawing. 12354 Alt-X Press to <a href="#disp-imcomp">composite</a> the image 12355 with another. 12356 Alt-A Press to <a href="#disp-iman">annotate</a> the image with text. 12357 Alt-D Press to <a href="#disp-imdr">draw</a> a line on the image. 12358 Alt-P Press to <a href="#disp-cole">edit an image pixel color</a>. 12359 Alt-M Press to <a href="#disp-matt">edit the image matte</a> information. 12360 Alt-X Press to <a href="#disp-imcomp">composite</a> the image with another. 12361 Alt-A Press to add a border to the image. 12362 Alt-F Press to add a ornamental frame to the image. 12363 Alt-Shft-! Press to add an image comment. 12364 Ctl-A Press to apply image processing techniques to a 12365 region of interest. 12366 Shft-? Press to display information about the image. 12367 Shft-+ Press to map the zoom image window. 12368 Shft-P Press to preview an image enhancement, effect, 12369 or f/x. 12370 F1 Press to display helpful information about 12371 the "display" utility. 12372 Find Press to browse documentation about 12373 GraphicsMagick. 12374 1-9 Press to change the level of magnification. 12375 </pre> 12376 <p> 12377 Use the arrow keys to move the image one pixel up, down, left, or right 12378 within the magnify window. Be sure to first map the magnify window by pressing 12379 button 2. 12380 <p> 12381 Press ALT and one of the arrow keys to trim off one pixel from any side 12382 of the image. 12383 </td></tr></table> 12384 <p> 12385 <i><a href="#top">Back to Contents</a></i> 12386 </p> 12387 <table BORDER=0 WIDTH="100%"> 12388 <tr> 12389 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 12390 SRC="images/right_triangle.png" ALT=">" BORDER=0 12391 height=14 width=15><b><font face="Helvetica, Arial"><font 12392 color="#00B04F"><font size="+1"> 12393 <a NAME="disp-xres"></a>X Resources 12394 </font></font></font></b></td></tr></table> 12395 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 12396 <tr><td width="3%"><br></td><td> 12397 <p> 12398 <strong>Display</strong> options can appear on the command line or in your X resource 12399 file. Options on the command line supersede values specified in your X 12400 resource file. See <em>X(1)</em> for more information on X resources. 12401 <p> 12402 Most <strong>display</strong> options have a corresponding X resource. In addition, 12403 <strong>display</strong> 12404 uses the following X resources: 12405 <table BORDER=0 WIDTH="94%"> 12406 <tr> 12407 <td width="3%"><br></td> 12408 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12409 <img SRC="images/right_triangle_option.png" 12410 ALT=">" BORDER=0 height=14 12411 width=15><b><font face="Helvetica, Arial" 12412 ><font color="#00B04F"><font size="+1"> 12413 background <i>(class Background)</i> 12414 </font></font></font></b></td></tr></table> 12415 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12416 Specifies the preferred color to use for the Image window background. The 12417 default is #ccc.</td></tr></table> 12418 <table BORDER=0 WIDTH="94%"> 12419 <tr> 12420 <td width="3%"><br></td> 12421 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12422 <img SRC="images/right_triangle_option.png" 12423 ALT=">" BORDER=0 height=14 12424 width=15><b><font face="Helvetica, Arial" 12425 ><font color="#00B04F"><font size="+1"> 12426 borderColor <i>(class BorderColor)</i> 12427 </font></font></font></b></td></tr></table> 12428 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12429 Specifies the preferred color to use for the Image window border. The default 12430 is #ccc.</td></tr></table> 12431 <table BORDER=0 WIDTH="94%"> 12432 <tr> 12433 <td width="3%"><br></td> 12434 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12435 <img SRC="images/right_triangle_option.png" 12436 ALT=">" BORDER=0 height=14 12437 width=15><b><font face="Helvetica, Arial" 12438 ><font color="#00B04F"><font size="+1"> 12439 borderWidth <i>(class BorderWidth)</i> 12440 </font></font></font></b></td></tr></table> 12441 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12442 Specifies the width in pixels of the image window border. The default is 12443 2.</td></tr></table> 12444 <table BORDER=0 WIDTH="94%"> 12445 <tr> 12446 <td width="3%"><br></td> 12447 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12448 <img SRC="images/right_triangle_option.png" 12449 ALT=">" BORDER=0 height=14 12450 width=15><b><font face="Helvetica, Arial" 12451 ><font color="#00B04F"><font size="+1"> 12452 browseCommand <i>(class browseCommand)</i> 12453 </font></font></font></b></td></tr></table> 12454 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12455 Specifies the name of the preferred browser when displaying GraphicsMagick 12456 documentation. The default is <tt>netscape %s</tt>.</td></tr></table> 12457 <table BORDER=0 WIDTH="94%"> 12458 <tr> 12459 <td width="3%"><br></td> 12460 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12461 <img SRC="images/right_triangle_option.png" 12462 ALT=">" BORDER=0 height=14 12463 width=15><b><font face="Helvetica, Arial" 12464 ><font color="#00B04F"><font size="+1"> 12465 confirmExit <i>(class ConfirmExit)</i> 12466 </font></font></font></b></td></tr></table> 12467 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12468 <strong>Display</strong> pops up a dialog box to confirm exiting the program when 12469 exiting the program. Set this resource to <tt>False</tt> to exit without 12470 a confirmation.</td></tr></table> 12471 <table BORDER=0 WIDTH="94%"> 12472 <tr> 12473 <td width="3%"><br></td> 12474 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12475 <img SRC="images/right_triangle_option.png" 12476 ALT=">" BORDER=0 height=14 12477 width=15><b><font face="Helvetica, Arial" 12478 ><font color="#00B04F"><font size="+1"> 12479 displayGamma <i>(class DisplayGamma)</i> 12480 </font></font></font></b></td></tr></table> 12481 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12482 Specifies the gamma of the X server.</td></tr></table> 12483 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12484 You can apply separate gamma values to the red, green, and blue channels 12485 of the image with a gamma value list delineated with slashes (i.e. 1.7/2.3/1.2).</td></tr></table> 12486 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12487 The default is 2.2.</td></tr></table> 12488 <table BORDER=0 WIDTH="94%"> 12489 <tr> 12490 <td width="3%"><br></td> 12491 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12492 <img SRC="images/right_triangle_option.png" 12493 ALT=">" BORDER=0 height=14 12494 width=15><b><font face="Helvetica, Arial" 12495 ><font color="#00B04F"><font size="+1"> 12496 displayWarnings <i>(class DisplayWarnings)</i> 12497 </font></font></font></b></td></tr></table> 12498 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12499 <strong>Display</strong> pops up a dialog box whenever a warning message occurs. 12500 Set this resource to <tt>False</tt> to ignore warning messages.</td></tr></table> 12501 <table BORDER=0 WIDTH="94%"> 12502 <tr> 12503 <td width="3%"><br></td> 12504 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12505 <img SRC="images/right_triangle_option.png" 12506 ALT=">" BORDER=0 height=14 12507 width=15><b><font face="Helvetica, Arial" 12508 ><font color="#00B04F"><font size="+1"> 12509 font <i>(class FontList)</i> 12510 </font></font></font></b></td></tr></table> 12511 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12512 Specifies the name of the preferred font to use in normal formatted text. 12513 The default is 14 point Helvetica.</td></tr></table> 12514 <table BORDER=0 WIDTH="94%"> 12515 <tr> 12516 <td width="3%"><br></td> 12517 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12518 <img SRC="images/right_triangle_option.png" 12519 ALT=">" BORDER=0 height=14 12520 width=15><b><font face="Helvetica, Arial" 12521 ><font color="#00B04F"><font size="+1"> 12522 font[1-9] <i>(class Font[1-9])</i> 12523 </font></font></font></b></td></tr></table> 12524 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12525 Specifies the name of the preferred font to use when 12526 <a href="#disp-iman">annotating</a> 12527 the image window with text. The default fonts are fixed, variable, 5x8, 12528 6x10, 7x13bold, 8x13bold, 9x15bold, 10x20, and 12x24.</td></tr></table> 12529 <table BORDER=0 WIDTH="94%"> 12530 <tr> 12531 <td width="3%"><br></td> 12532 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12533 <img SRC="images/right_triangle_option.png" 12534 ALT=">" BORDER=0 height=14 12535 width=15><b><font face="Helvetica, Arial" 12536 ><font color="#00B04F"><font size="+1"> 12537 foreground <i>(class Foreground)</i> 12538 </font></font></font></b></td></tr></table> 12539 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12540 Specifies the preferred color to use for text within the image window. 12541 The default is black.</td></tr></table> 12542 <table BORDER=0 WIDTH="94%"> 12543 <tr> 12544 <td width="3%"><br></td> 12545 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12546 <img SRC="images/right_triangle_option.png" 12547 ALT=">" BORDER=0 height=14 12548 width=15><b><font face="Helvetica, Arial" 12549 ><font color="#00B04F"><font size="+1"> 12550 gammaCorrect <i>(class gammaCorrect)</i> 12551 </font></font></font></b></td></tr></table> 12552 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12553 This resource, if true, will lighten or darken an image of known gamma 12554 to match the gamma of the display (see resource <strong>displayGamma</strong>). The 12555 default is True.</td></tr></table> 12556 <table BORDER=0 WIDTH="94%"> 12557 <tr> 12558 <td width="3%"><br></td> 12559 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12560 <img SRC="images/right_triangle_option.png" 12561 ALT=">" BORDER=0 height=14 12562 width=15><b><font face="Helvetica, Arial" 12563 ><font color="#00B04F"><font size="+1"> 12564 geometry <i>(class Geometry)</i> 12565 </font></font></font></b></td></tr></table> 12566 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12567 Specifies the preferred size and position of the image window. It is not 12568 necessarily obeyed by all window managers.</td></tr></table> 12569 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 12570 Offsets, if present, are handled in <em>X(1)</em> style. A negative x offset is 12571 measured from the right edge of the screen to the right edge of the icon, 12572 and a negative y offset is measured from the bottom edge of the screen 12573 to the bottom edge of the icon.</font></td></tr></table> 12574 <table BORDER=0 WIDTH="94%"> 12575 <tr> 12576 <td width="3%"><br></td> 12577 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12578 <img SRC="images/right_triangle_option.png" 12579 ALT=">" BORDER=0 height=14 12580 width=15><b><font face="Helvetica, Arial" 12581 ><font color="#00B04F"><font size="+1"> 12582 iconGeometry <i>(class IconGeometry)</i> 12583 </font></font></font></b></td></tr></table> 12584 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12585 Specifies the preferred size and position of the application when iconified. 12586 It is not necessarily obeyed by all window managers.</td></tr></table> 12587 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 12588 Offsets, if present, are handled in the same manner as in class Geometry.</font></td></tr></table> 12589 <table BORDER=0 WIDTH="94%"> 12590 <tr> 12591 <td width="3%"><br></td> 12592 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12593 <img SRC="images/right_triangle_option.png" 12594 ALT=">" BORDER=0 height=14 12595 width=15><b><font face="Helvetica, Arial" 12596 ><font color="#00B04F"><font size="+1"> 12597 iconic <i>(class Iconic)</i> 12598 </font></font></font></b></td></tr></table> 12599 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12600 This resource indicates that you would prefer that the application's windows 12601 initially not be visible as if the windows had be immediately iconified 12602 by you. Window managers may choose not to honor the application's request.</td></tr></table> 12603 <table BORDER=0 WIDTH="94%"> 12604 <tr> 12605 <td width="3%"><br></td> 12606 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12607 <img SRC="images/right_triangle_option.png" 12608 ALT=">" BORDER=0 height=14 12609 width=15><b><font face="Helvetica, Arial" 12610 ><font color="#00B04F"><font size="+1"> 12611 magnify <i>(class Magnify)</i> 12612 </font></font></font></b></td></tr></table> 12613 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12614 specifies an integral factor by which the image should be enlarged. The 12615 default is 3.</td></tr></table> 12616 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12617 This value only affects the magnification window which is invoked with 12618 <a href="#disp-mous">button</a> 12619 number 3 after the image is displayed.</td></tr></table> 12620 <table BORDER=0 WIDTH="94%"> 12621 <tr> 12622 <td width="3%"><br></td> 12623 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12624 <img SRC="images/right_triangle_option.png" 12625 ALT=">" BORDER=0 height=14 12626 width=15><b><font face="Helvetica, Arial" 12627 ><font color="#00B04F"><font size="+1"> 12628 matteColor <i>(class MatteColor)</i> 12629 </font></font></font></b></td></tr></table> 12630 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12631 Specify the color of windows. It is used for the backgrounds of windows, 12632 menus, and notices. A 3D effect is achieved by using highlight and shadow 12633 colors derived from this color. Default value: #697B8F.</td></tr></table> 12634 <table BORDER=0 WIDTH="94%"> 12635 <tr> 12636 <td width="3%"><br></td> 12637 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12638 <img SRC="images/right_triangle_option.png" 12639 ALT=">" BORDER=0 height=14 12640 width=15><b><font face="Helvetica, Arial" 12641 ><font color="#00B04F"><font size="+1"> 12642 name <i>(class Name)</i> 12643 </font></font></font></b></td></tr></table> 12644 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12645 This resource specifies the name under which resources for the application 12646 should be found. This resource is useful in shell aliases to distinguish 12647 between invocations of an application, without resorting to creating links 12648 to alter the executable file name. The default is the application name.</td></tr></table> 12649 <table BORDER=0 WIDTH="94%"> 12650 <tr> 12651 <td width="3%"><br></td> 12652 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12653 <img SRC="images/right_triangle_option.png" 12654 ALT=">" BORDER=0 height=14 12655 width=15><b><font face="Helvetica, Arial" 12656 ><font color="#00B04F"><font size="+1"> 12657 pen[1-9] <i>(class Pen[1-9])</i> 12658 </font></font></font></b></td></tr></table> 12659 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12660 Specifies the color of the preferred font to use when 12661 <a href="#disp-iman">annotating</a> 12662 the image window with text. The default colors are black, blue, green, 12663 cyan, gray, red, magenta, yellow, and white.</td></tr></table> 12664 <table BORDER=0 WIDTH="94%"> 12665 <tr> 12666 <td width="3%"><br></td> 12667 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12668 <img SRC="images/right_triangle_option.png" 12669 ALT=">" BORDER=0 height=14 12670 width=15><b><font face="Helvetica, Arial" 12671 ><font color="#00B04F"><font size="+1"> 12672 printCommand <i>(class PrintCommand)</i> 12673 </font></font></font></b></td></tr></table> 12674 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12675 This command is executed whenever Print is issued. In general, it is the 12676 command to print <em>PostScript</em> to your printer. Default value: <tt>lp 12677 -c -s %i</tt>.</td></tr></table> 12678 <table BORDER=0 WIDTH="94%"> 12679 <tr> 12680 <td width="3%"><br></td> 12681 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12682 <img SRC="images/right_triangle_option.png" 12683 ALT=">" BORDER=0 height=14 12684 width=15><b><font face="Helvetica, Arial" 12685 ><font color="#00B04F"><font size="+1"> 12686 sharedMemory <i>(class SharedMemory)</i> 12687 </font></font></font></b></td></tr></table> 12688 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12689 This resource specifies whether display should attempt use shared memory 12690 for pixmaps. GraphicsMagick must be compiled with shared memory support, 12691 and the display must support the MIT-SHM extension. Otherwise, this 12692 resource is ignored. The default is True.</td></tr></table> 12693 <table BORDER=0 WIDTH="94%"> 12694 <tr> 12695 <td width="3%"><br></td> 12696 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12697 <img SRC="images/right_triangle_option.png" 12698 ALT=">" BORDER=0 height=14 12699 width=15><b><font face="Helvetica, Arial" 12700 ><font color="#00B04F"><font size="+1"> 12701 textFont <i>(class textFont)</i> 12702 </font></font></font></b></td></tr></table> 12703 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12704 Specifies the name of the preferred font to use in fixed (typewriter style) 12705 formatted text. The default is 14 point Courier.</td></tr></table> 12706 <table BORDER=0 WIDTH="94%"> 12707 <tr> 12708 <td width="3%"><br></td> 12709 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12710 <img SRC="images/right_triangle_option.png" 12711 ALT=">" BORDER=0 height=14 12712 width=15><b><font face="Helvetica, Arial" 12713 ><font color="#00B04F"><font size="+1"> 12714 title <i>(class Title)</i> 12715 </font></font></font></b></td></tr></table> 12716 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12717 This resource specifies the title to be used for the image window. This 12718 information is sometimes used by a window manager to provide a header identifying 12719 the window. The default is the image file name.</td></tr></table> 12720 <table BORDER=0 WIDTH="94%"> 12721 <tr> 12722 <td width="3%"><br></td> 12723 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12724 <img SRC="images/right_triangle_option.png" 12725 ALT=">" BORDER=0 height=14 12726 width=15><b><font face="Helvetica, Arial" 12727 ><font color="#00B04F"><font size="+1"> 12728 undoCache <i>(class UndoCache)</i> 12729 </font></font></font></b></td></tr></table> 12730 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12731 Specifies, in mega-bytes, the amount of memory in the undo edit cache. 12732 Each time you modify the image it is saved in the undo edit cache as long 12733 as memory is available. You can subsequently <em>undo</em> one or more of 12734 these transformations. The default is 16 Megabytes.</td></tr></table> 12735 <table BORDER=0 WIDTH="94%"> 12736 <tr> 12737 <td width="3%"><br></td> 12738 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12739 <img SRC="images/right_triangle_option.png" 12740 ALT=">" BORDER=0 height=14 12741 width=15><b><font face="Helvetica, Arial" 12742 ><font color="#00B04F"><font size="+1"> 12743 usePixmap <i>(class UsePixmap)</i> 12744 </font></font></font></b></td></tr></table> 12745 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12746 Images are maintained as a XImage by default. Set this resource to True 12747 to utilize a server Pixmap instead. This option is useful if your image 12748 exceeds the dimensions of your server screen and you intend to pan the 12749 image. Panning is much faster with Pixmaps than with a XImage. Pixmaps 12750 are considered a precious resource, use them with discretion.</td></tr></table> 12751 <p> 12752 To set the geometry of the Magnify or Pan or window, use the geometry resource. 12753 For example, to set the Pan window geometry to 256x256, use: 12754 <pre> 12755 gm display.pan.geometry: 256x256 12756 </pre> 12757 </td></tr></table> 12758 <p> 12759 <i><a href="#top">Back to Contents</a></i> 12760 </p> 12761 <table BORDER=0 WIDTH="100%"> 12762 <tr> 12763 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 12764 SRC="images/right_triangle.png" ALT=">" BORDER=0 12765 height=14 width=15><b><font face="Helvetica, Arial"><font 12766 color="#00B04F"><font size="+1"> 12767 <a NAME="disp-imlo"></a>Image Loading 12768 </font></font></font></b></td></tr></table> 12769 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 12770 <tr><td width="3%"><br></td><td> 12771 <p> 12772 To select an image to display, choose <strong>Open</strong> of the <strong>File</strong> sub-menu 12773 from the <a href="#disp-comm">Command widget</a>. A file browser is displayed. 12774 To choose a particular image file, move the pointer to the filename and 12775 press any button. The filename is copied to the text window. Next, press 12776 <strong>Open</strong> 12777 or press the <strong>RETURN</strong> key. Alternatively, you can type the image file 12778 name directly into the text window. To descend directories, choose a directory 12779 name and press the button twice quickly. A scrollbar allows a large list 12780 of filenames to be moved through the viewing area if it exceeds the size 12781 of the list area. 12782 <p> 12783 You can trim the list of file names by using shell globbing characters. 12784 For example, type <tt>*.jpg</tt> to list only files that end 12785 with <tt>.jpg</tt>. 12786 <p> 12787 To select your image from the X server screen instead of from a file, Choose 12788 <strong>Grab</strong> of the <strong>Open</strong> widget. 12789 </td></tr></table> 12790 <p> 12791 <i><a href="#top">Back to Contents</a></i> 12792 </p> 12793 <table BORDER=0 WIDTH="100%"> 12794 <tr> 12795 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 12796 SRC="images/right_triangle.png" ALT=">" BORDER=0 12797 height=14 width=15><b><font face="Helvetica, Arial"><font 12798 color="#00B04F"><font size="+1"> 12799 <a NAME="disp-visu"></a>Visual Image Directory 12800 </font></font></font></b></td></tr></table> 12801 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 12802 <tr><td width="3%"><br></td><td> 12803 <p> 12804 To create a Visual Image Directory, choose Visual Directory of the <strong>File</strong> 12805 sub-menu from the <a href="#disp-comm">Command widget</a> . A file browser is 12806 displayed. To create a Visual Image Directory from all the images in the 12807 current directory, press <strong>Directory</strong> or press the <strong>RETURN key</strong>. 12808 Alternatively, you can select a set of image names by using shell globbing 12809 characters. For example, type <tt>*.jpg</tt> to include only files that 12810 end with <tt>.jpg</tt>. To descend directories, choose a directory name 12811 and press the button twice quickly. A scrollbar allows a large list of 12812 filenames to be moved through the viewing area if it exceeds the size of 12813 the list area. 12814 <p> 12815 After you select a set of files, they are turned into thumbnails and tiled 12816 onto a single image. Now move the pointer to a particular thumbnail and 12817 press <strong>button 3</strong> and drag. Finally, select Open. The image represented 12818 by the thumbnail is displayed at its full size. Choose <strong>Next</strong> from 12819 the <strong>File</strong> sub-menu of the Command widget to return to the Visual 12820 Image Directory. 12821 </td></tr></table> 12822 <p> 12823 <i><a href="#top">Back to Contents</a></i> 12824 </p> 12825 <table BORDER=0 WIDTH="100%"> 12826 <tr> 12827 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 12828 SRC="images/right_triangle.png" ALT=">" BORDER=0 12829 height=14 width=15><b><font face="Helvetica, Arial"><font 12830 color="#00B04F"><font size="+1"> 12831 <a NAME="disp-imcu"></a>Image Cutting 12832 </font></font></font></b></td></tr></table> 12833 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 12834 <tr><td width="3%"><br></td><td> 12835 <p> 12836 Note that cut information for image window is not retained for colormapped 12837 X server visuals (e.g. <em>StaticColor</em>, 12838 <em>StaticColor</em>, <em>GRAYScale</em>, 12839 <em>PseudoColor</em>). 12840 Correct cutting behavior may require a <em>TrueColor</em> or <em>DirectColor</em> 12841 visual or a <em>Standard Colormap</em>. 12842 <p> 12843 To begin, press choose <strong>Cut</strong> of the <strong>Edit</strong> sub-menu from the 12844 <a href="#disp-comm">Command 12845 widget</a>. Alternatively, press 12846 <strong>F3</strong> in the image window. 12847 <p> 12848 A small window appears showing the location of the cursor in the image 12849 window. You are now in cut mode. In cut mode, the Command widget has these 12850 options: 12851 <ul> 12852 <li><strong>Help</strong> 12853 <li><strong>Dismiss</strong> 12854 </ul> 12855 <p> 12856 To define a cut region, press button 1 and drag. The cut region is defined 12857 by a highlighted rectangle that expands or contracts as it follows the 12858 pointer. Once you are satisfied with the cut region, release the button. 12859 You are now in rectify mode. In rectify mode, the Command widget has these 12860 options: 12861 <ul> 12862 <li><strong>Cut</strong> 12863 <li><strong>Help</strong> 12864 <li><strong>Dismiss</strong> 12865 </ul> 12866 <p> 12867 You can make adjustments by moving the pointer to one of the cut rectangle 12868 corners, pressing a button, and dragging. Finally, press Cut to commit 12869 your copy region. To exit without cutting the image, press Dismiss. 12870 </td></tr></table> 12871 <p> 12872 <i><a href="#top">Back to Contents</a></i> 12873 </p> 12874 <table BORDER=0 WIDTH="100%"> 12875 <tr> 12876 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 12877 SRC="images/right_triangle.png" ALT=">" BORDER=0 12878 height=14 width=15><b><font face="Helvetica, Arial"><font 12879 color="#00B04F"><font size="+1"> 12880 <a NAME="disp-imco"></a>Image Copying 12881 </font></font></font></b></td></tr></table> 12882 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 12883 <tr><td width="3%"><br></td><td> 12884 <p> 12885 To begin, press choose <strong>Copy</strong> of the <strong>Edit</strong> sub-menu from the 12886 <a href="#disp-comm">Command 12887 widget</a>. Alternatively, press 12888 <strong>F4</strong> in the image window. 12889 <p> 12890 A small window appears showing the location of the cursor in the image 12891 window. You are now in copy mode. In copy mode, the Command widget has 12892 these options: 12893 <ul> 12894 <li>Help 12895 <li>Dismiss 12896 </ul> 12897 <p> 12898 To define a copy region, press button 1 and drag. The copy region is defined 12899 by a highlighted rectangle that expands or contracts as it follows the 12900 pointer. Once you are satisfied with the copy region, release the button. 12901 You are now in rectify mode. In rectify mode, the Command widget has these 12902 options: 12903 <ul> 12904 <li>Copy 12905 <li>Help 12906 <li>Dismiss 12907 </ul> 12908 <p> 12909 You can make adjustments by moving the pointer to one of the copy rectangle 12910 corners, pressing a button, and dragging. Finally, press Copy to commit 12911 your copy region. To exit without copying the image, press Dismiss. 12912 </td></tr></table> 12913 <p> 12914 <i><a href="#top">Back to Contents</a></i> 12915 </p> 12916 <table BORDER=0 WIDTH="100%"> 12917 <tr> 12918 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 12919 SRC="images/right_triangle.png" ALT=">" BORDER=0 12920 height=14 width=15><b><font face="Helvetica, Arial"><font 12921 color="#00B04F"><font size="+1"> 12922 <a NAME="disp-impas"></a>Image Pasting 12923 </font></font></font></b></td></tr></table> 12924 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 12925 <tr><td width="3%"><br></td><td> 12926 <p> 12927 To begin, press choose <strong>Paste</strong> of the <strong>Edit</strong> sub-menu from the 12928 <a href="#disp-comm">Command 12929 widget</a>. Alternatively, press 12930 <strong>F5</strong> in the image window. 12931 <p> 12932 A small window appears showing the location of the cursor in the image 12933 window. You are now in Paste mode. To exit immediately, press Dismiss. 12934 In Paste mode, the Command widget has these options: 12935 <ul> 12936 <li><strong>Operators</strong> 12937 <ul> 12938 <li>over 12939 <li>in 12940 <li>out 12941 <li>atop 12942 <li>xor 12943 <li>plus 12944 <li>minus 12945 <li>add 12946 <li>subtract 12947 <li>difference 12948 <li>multiply 12949 <li>bumpmap 12950 <li>replace 12951 </ul> 12952 <li><strong>Help</strong> 12953 <li><strong>Dismiss</strong> 12954 </ul> 12955 <p> 12956 Choose a composite operation from the <strong>Operators</strong> sub-menu of the 12957 <a href="#disp-comm">Command 12958 widget</a>. How each operator behaves is described below. <em>image window</em> 12959 is the image currently displayed on your X server and <em>image</em> is the 12960 image obtained with the File Browser widget. 12961 <table BORDER=0 WIDTH="94%"> 12962 <tr> 12963 <td width="3%"><br></td> 12964 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12965 <img SRC="images/right_triangle_option.png" 12966 ALT=">" BORDER=0 height=14 12967 width=15><b><font face="Helvetica, Arial" 12968 ><font color="#00B04F"><font size="+1"> 12969 over 12970 </font></font></font></b></td></tr></table> 12971 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12972 The result is the union of the two image shapes, with <em>image</em> obscuring 12973 <em>image 12974 window</em> in the region of overlap.</td></tr></table> 12975 <table BORDER=0 WIDTH="94%"> 12976 <tr> 12977 <td width="3%"><br></td> 12978 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12979 <img SRC="images/right_triangle_option.png" 12980 ALT=">" BORDER=0 height=14 12981 width=15><b><font face="Helvetica, Arial" 12982 ><font color="#00B04F"><font size="+1"> 12983 in 12984 </font></font></font></b></td></tr></table> 12985 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 12986 The result is simply <em>image</em> cut by the shape of 12987 <em>image window</em>. 12988 None of the image data of image window is in the result.</td></tr></table> 12989 <table BORDER=0 WIDTH="94%"> 12990 <tr> 12991 <td width="3%"><br></td> 12992 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 12993 <img SRC="images/right_triangle_option.png" 12994 ALT=">" BORDER=0 height=14 12995 width=15><b><font face="Helvetica, Arial" 12996 ><font color="#00B04F"><font size="+1"> 12997 out 12998 </font></font></font></b></td></tr></table> 12999 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13000 The resulting image is <em>image</em> with the shape of 13001 <em>image window</em> 13002 cut out.</td></tr></table> 13003 <table BORDER=0 WIDTH="94%"> 13004 <tr> 13005 <td width="3%"><br></td> 13006 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13007 <img SRC="images/right_triangle_option.png" 13008 ALT=">" BORDER=0 height=14 13009 width=15><b><font face="Helvetica, Arial" 13010 ><font color="#00B04F"><font size="+1"> 13011 atop 13012 </font></font></font></b></td></tr></table> 13013 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13014 The result is the same shape as <em>image window</em>, with 13015 <em>image</em> 13016 obscuring <em>image window</em> where the image shapes overlap. Note this 13017 differs from over because the portion of image outside 13018 <em>image window</em>'s 13019 shape does not appear in the result.</td></tr></table> 13020 <table BORDER=0 WIDTH="94%"> 13021 <tr> 13022 <td width="3%"><br></td> 13023 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13024 <img SRC="images/right_triangle_option.png" 13025 ALT=">" BORDER=0 height=14 13026 width=15><b><font face="Helvetica, Arial" 13027 ><font color="#00B04F"><font size="+1"> 13028 xor 13029 </font></font></font></b></td></tr></table> 13030 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13031 The result is the image data from both <em>image</em> and 13032 <em>image window</em> 13033 that is outside the overlap region. The overlap region is blank.</td></tr></table> 13034 <table BORDER=0 WIDTH="94%"> 13035 <tr> 13036 <td width="3%"><br></td> 13037 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13038 <img SRC="images/right_triangle_option.png" 13039 ALT=">" BORDER=0 height=14 13040 width=15><b><font face="Helvetica, Arial" 13041 ><font color="#00B04F"><font size="+1"> 13042 plus 13043 </font></font></font></b></td></tr></table> 13044 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13045 The result is just the sum of the image data. Output values are cropped 13046 to the maximum value (no overflow). This operation is independent of the 13047 matte channels.</td></tr></table> 13048 <table BORDER=0 WIDTH="94%"> 13049 <tr> 13050 <td width="3%"><br></td> 13051 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13052 <img SRC="images/right_triangle_option.png" 13053 ALT=">" BORDER=0 height=14 13054 width=15><b><font face="Helvetica, Arial" 13055 ><font color="#00B04F"><font size="+1"> 13056 minus 13057 </font></font></font></b></td></tr></table> 13058 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13059 The result of <em>image</em> - <em>image window</em>, with underflow cropped 13060 to zero. The matte channel is ignored (set to opaque, full coverage).</td></tr></table> 13061 <table BORDER=0 WIDTH="94%"> 13062 <tr> 13063 <td width="3%"><br></td> 13064 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13065 <img SRC="images/right_triangle_option.png" 13066 ALT=">" BORDER=0 height=14 13067 width=15><b><font face="Helvetica, Arial" 13068 ><font color="#00B04F"><font size="+1"> 13069 add 13070 </font></font></font></b></td></tr></table> 13071 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13072 The result of <em>image</em> + <em>image window</em>, with overflow wrapping 13073 around (mod MaxRGB+1).</td></tr></table> 13074 <table BORDER=0 WIDTH="94%"> 13075 <tr> 13076 <td width="3%"><br></td> 13077 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13078 <img SRC="images/right_triangle_option.png" 13079 ALT=">" BORDER=0 height=14 13080 width=15><b><font face="Helvetica, Arial" 13081 ><font color="#00B04F"><font size="+1"> 13082 subtract 13083 </font></font></font></b></td></tr></table> 13084 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13085 The result of <em>image</em> - <em>image window</em>, with underflow wrapping 13086 around (mod MaxRGB+1). The add and subtract operators can be used to perform 13087 reversible transformations.</td></tr></table> 13088 <table BORDER=0 WIDTH="94%"> 13089 <tr> 13090 <td width="3%"><br></td> 13091 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13092 <img SRC="images/right_triangle_option.png" 13093 ALT=">" BORDER=0 height=14 13094 width=15><b><font face="Helvetica, Arial" 13095 ><font color="#00B04F"><font size="+1"> 13096 difference 13097 </font></font></font></b></td></tr></table> 13098 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13099 The result of abs(<em>image</em> - <em>image window</em>). This is useful for 13100 comparing two very similar images.</td></tr></table> 13101 <table BORDER=0 WIDTH="94%"> 13102 <tr> 13103 <td width="3%"><br></td> 13104 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13105 <img SRC="images/right_triangle_option.png" 13106 ALT=">" BORDER=0 height=14 13107 width=15><b><font face="Helvetica, Arial" 13108 ><font color="#00B04F"><font size="+1"> 13109 multiply 13110 </font></font></font></b></td></tr></table> 13111 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13112 The result of <em>image</em> * <em>image window</em>. This is useful for 13113 the creation of drop-shadows.</td></tr></table> 13114 <table BORDER=0 WIDTH="94%"> 13115 <tr> 13116 <td width="3%"><br></td> 13117 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13118 <img SRC="images/right_triangle_option.png" 13119 ALT=">" BORDER=0 height=14 13120 width=15><b><font face="Helvetica, Arial" 13121 ><font color="#00B04F"><font size="+1"> 13122 bumpmap 13123 </font></font></font></b></td></tr></table> 13124 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13125 The result of <em>image window</em> shaded by <em>window</em>.</td></tr></table> 13126 <table BORDER=0 WIDTH="94%"> 13127 <tr> 13128 <td width="3%"><br></td> 13129 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13130 <img SRC="images/right_triangle_option.png" 13131 ALT=">" BORDER=0 height=14 13132 width=15><b><font face="Helvetica, Arial" 13133 ><font color="#00B04F"><font size="+1"> 13134 replace 13135 </font></font></font></b></td></tr></table> 13136 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>The resulting image is <em>image window</em> replaced with 13137 <em>image</em>. 13138 Here the matte information is ignored.</td></tr></table> 13139 <p> 13140 The image compositor requires a matte, or alpha channel in the image for 13141 some operations. This extra channel usually defines a mask which represents 13142 a sort of a cookie-cutter for the image. This is the case when matte is 13143 255 (full coverage) for pixels inside the shape, zero outside, and between 13144 zero and 255 on the boundary. If image does not have a matte channel, it 13145 is initialized with 0 for any pixel matching in color to pixel location 13146 (0,0), otherwise 255. See <a href="#disp-matt">Matte Editing</a> for a method 13147 of defining a matte channel. 13148 <p> 13149 Note that matte information for image window is not retained for colormapped 13150 X server visuals (e.g. <em>StaticColor, StaticColor, GrayScale, PseudoColor</em>). 13151 Correct compositing behavior may require a 13152 <em>TrueColor</em> or <em>DirectColor</em> 13153 visual or a <em>Standard Colormap</em>. 13154 <p> 13155 Choosing a composite operator is optional. The default operator is replace. 13156 However, you must choose a location to composite your image and press button 13157 1. Press and hold the button before releasing and an outline of the image 13158 will appear to help you identify your location. 13159 <p> 13160 The actual colors of the pasted image is saved. However, the color that 13161 appears in image window may be different. For example, on a monochrome 13162 screen image window will appear black or white even though your pasted 13163 image may have many colors. If the image is saved to a file it is written 13164 with the correct colors. To assure the correct colors are saved in the 13165 final image, any <em>PseudoClass</em> image is promoted to <em>DirectClass</em>. 13166 To force a 13167 <em>PseudoClass</em> image to remain <em>PseudoClass</em>, 13168 use <strong>-colors</strong>. 13169 </td></tr></table> 13170 <p> 13171 <i><a href="#top">Back to Contents</a></i> 13172 </p> 13173 <table BORDER=0 WIDTH="100%"> 13174 <tr> 13175 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 13176 SRC="images/right_triangle.png" ALT=">" BORDER=0 13177 height=14 width=15><b><font face="Helvetica, Arial"><font 13178 color="#00B04F"><font size="+1"> 13179 <a NAME="disp-imcr"></a>Image Cropping 13180 </font></font></font></b></td></tr></table> 13181 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 13182 <tr><td width="3%"><br></td><td> 13183 <p> 13184 To begin, press choose <strong>Crop</strong> of the <strong>Transform</strong> submenu from 13185 the <a href="#disp-comm">Command widget</a>. Alternatively, 13186 <a href="#disp-keyb">press</a> C in the image window. 13187 <p> 13188 A small window appears showing the location of the cursor in the image 13189 window. You are now in crop mode. In crop mode, the Command widget has 13190 these options: 13191 <ul> 13192 <li><strong>Help</strong> 13193 <li><strong>Dismiss</strong> 13194 </ul> 13195 <p> 13196 To define a cropping region, press button 1 and drag. The cropping region 13197 is defined by a highlighted rectangle that expands or contracts as it follows 13198 the pointer. Once you are satisfied with the cropping region, release the 13199 button. You are now in rectify mode. In rectify mode, the Command widget 13200 has these options: 13201 <ul> 13202 <li><strong>Crop</strong> 13203 <li><strong>Help</strong> 13204 <li><strong>Dismiss</strong> 13205 </ul> 13206 <p> 13207 You can make adjustments by moving the pointer to one of the cropping rectangle 13208 corners, pressing a button, and dragging. Finally, press Crop to commit 13209 your cropping region. To exit without cropping the image, press Dismiss. 13210 </td></tr></table> 13211 <p> 13212 <i><a href="#top">Back to Contents</a></i> 13213 </p> 13214 <table BORDER=0 WIDTH="100%"> 13215 <tr> 13216 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 13217 SRC="images/right_triangle.png" ALT=">" BORDER=0 13218 height=14 width=15><b><font face="Helvetica, Arial"><font 13219 color="#00B04F"><font size="+1"> 13220 <a NAME="disp-imch"></a>Image Chopping 13221 </font></font></font></b></td></tr></table> 13222 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 13223 <tr><td width="3%"><br></td><td> 13224 <p> 13225 An image is chopped interactively. There is no command line argument to 13226 chop an image. To begin, choose <strong>Chop</strong> of the <strong>Transform</strong> sub-menu 13227 from the <a href="#disp-comm">Command widget</a>. Alternatively, 13228 <a href="#disp-keyb">press</a> [ in the Image window. 13229 <p> 13230 You are now in <strong>Chop</strong> mode. To exit immediately, press 13231 <strong>Dismiss</strong>. 13232 In Chop mode, the Command widget has these options: 13233 <ul> 13234 <li><strong>Direction</strong> 13235 <ul> 13236 <li>horizontal 13237 <li>vertical 13238 </ul> 13239 <li><strong>Help</strong> 13240 <li><strong>Dismiss</strong> 13241 </ul> 13242 <p> 13243 If the you choose the horizontal direction (this is the default), the area 13244 of the image between the two horizontal endpoints of the chop line is removed. 13245 Otherwise, the area of the image between the two vertical endpoints of 13246 the chop line is removed. 13247 <p> 13248 Select a location within the image window to begin your chop, press and 13249 hold any button. Next, move the pointer to another location in the image. 13250 As you move a line will connect the initial location and the pointer. When 13251 you release the button, the area within the image to chop is determined 13252 by which direction you choose from the Command widget. 13253 <p> 13254 To cancel the image chopping, move the pointer back to the starting point 13255 of the line and release the button. 13256 </td></tr></table> 13257 <p> 13258 <i><a href="#top">Back to Contents</a></i> 13259 </p> 13260 <table BORDER=0 WIDTH="100%"> 13261 <tr> 13262 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 13263 SRC="images/right_triangle.png" ALT=">" BORDER=0 13264 height=14 width=15><b><font face="Helvetica, Arial"><font 13265 color="#00B04F"><font size="+1"> 13266 <a NAME="disp-imro"></a>Image Rotation 13267 </font></font></font></b></td></tr></table> 13268 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 13269 <tr><td width="3%"><br></td><td> 13270 <p> 13271 Press the / key to rotate the image 90 degrees or \ to rotate -90 degrees. 13272 To interactively choose the degree of rotation, choose 13273 <strong>Rotate...</strong> 13274 of the <strong>Transform</strong> submenu from the <a href="#disp-comm">Command Widget</a>. 13275 Alternatively, <a href="#disp-keyb">press</a> * in the image window. 13276 <p> 13277 A small horizontal line is drawn next to the pointer. You are now in rotate 13278 mode. To exit immediately, press Dismiss. In rotate mode, the Command widget 13279 has these options: 13280 <ul> 13281 <li><strong>Pixel Color</strong> 13282 <ul> 13283 <li>black 13284 <li>blue 13285 <li>cyan 13286 <li>green 13287 <li>gray 13288 <li>red 13289 <li>magenta 13290 <li>yellow 13291 <li>white 13292 <li>Browser... 13293 </ul> 13294 <li><strong>Direction</strong> 13295 <ul> 13296 <li>horizontal 13297 <li>vertical 13298 </ul> 13299 <li><strong>Help</strong> 13300 <li><strong>Dismiss</strong> 13301 </ul> 13302 <p> 13303 Choose a background color from the Pixel Color sub-menu. Additional background 13304 colors can be specified with the color browser. You can change the menu 13305 colors by setting the <a href="#disp-xres">X resources</a> pen1 through pen9. 13306 <p> 13307 If you choose the color browser and press <strong>Grab</strong>, you can select the 13308 background color by moving the pointer to the desired color on the screen 13309 and press any button. 13310 <p> 13311 Choose a point in the image window and press this button and hold. Next, 13312 move the pointer to another location in the image. As you move a line connects 13313 the initial location and the pointer. When you release the button, the 13314 degree of image rotation is determined by the slope of the line you just 13315 drew. The slope is relative to the direction you choose from the Direction 13316 sub-menu of the Command widget. 13317 <p> 13318 To cancel the image rotation, move the pointer back to the starting point 13319 of the line and release the button. 13320 </td></tr></table> 13321 <p> 13322 <i><a href="#top">Back to Contents</a></i> 13323 </p> 13324 <p> 13325 <i><a href="#top">Back to Contents</a></i> 13326 </p> 13327 <table BORDER=0 WIDTH="100%"> 13328 <tr> 13329 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 13330 SRC="images/right_triangle.png" ALT=">" BORDER=0 13331 height=14 width=15><b><font face="Helvetica, Arial"><font 13332 color="#00B04F"><font size="+1"> 13333 <a NAME="disp-iman"></a>Image Annotation 13334 </font></font></font></b></td></tr></table> 13335 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 13336 <tr><td width="3%"><br></td><td> 13337 <p> 13338 An image is annotated interactively. There is no command line argument 13339 to annotate an image. To begin, choose 13340 <strong>Annotate</strong> of the <strong>Image 13341 Edit</strong> sub-menu from the <a href="#disp-comm">Command widget</a>. Alternatively, 13342 <a href="#disp-keyb">press</a> a in the image window. 13343 <p> 13344 A small window appears showing the location of the cursor in the image 13345 window. You are now in annotate mode. To exit immediately, press Dismiss. 13346 In annotate mode, the Command widget has these options: 13347 <ul> 13348 <li> 13349 <strong>Font Name</strong> 13350 <ul> 13351 <li> 13352 fixed 13353 <li> 13354 variable 13355 <li> 13356 5x8 13357 <li> 13358 6x10 13359 <li> 13360 7x13bold 13361 <li> 13362 8x13bold 13363 <li> 13364 9x15bold 13365 <li> 13366 10x20 13367 <li> 13368 12x24 13369 <li> 13370 Browser... 13371 </ul> 13372 <li> 13373 <strong>Font Color</strong> 13374 <ul> 13375 <li> 13376 black 13377 <li> 13378 blue 13379 <li> 13380 cyan 13381 <li> 13382 green 13383 <li> 13384 gray 13385 <li> 13386 red 13387 <li> 13388 magenta 13389 <li> 13390 yellow 13391 <li> 13392 white 13393 <li> 13394 transparent 13395 <li> 13396 Browser... 13397 </ul> 13398 <li> 13399 <strong>Box Color</strong> 13400 <ul> 13401 <li> 13402 black 13403 <li> 13404 blue 13405 <li> 13406 cyan 13407 <li> 13408 green 13409 <li> 13410 gray 13411 <li> 13412 red 13413 <li> 13414 magenta 13415 <li> 13416 yellow 13417 <li> 13418 white 13419 <li> 13420 transparent 13421 <li> 13422 Browser... 13423 </ul> 13424 <li> 13425 <strong>Rotate Text</strong> 13426 <ul> 13427 <li> 13428 -90 13429 <li> 13430 -45 13431 <li> 13432 -30 13433 <li> 13434 0 13435 <li> 13436 30 13437 <li> 13438 45 13439 <li> 13440 90 13441 <li> 13442 180 13443 <li> 13444 Dialog... 13445 </ul> 13446 <li> 13447 <strong>Help</strong> 13448 <li> 13449 <strong>Dismiss</strong> 13450 </ul> 13451 <p> 13452 Choose a font name from the <strong>Font Name</strong> sub-menu. Additional font 13453 names can be specified with the font browser. You can change the menu names 13454 by setting the <a href="#disp-xres">X resources</a> font1 through font9. 13455 <p> 13456 Choose a font color from the <strong>Font Color</strong> sub-menu. Additional font 13457 colors can be specified with the color browser. You can change the menu 13458 colors by setting the <a href="#disp-xres">X resources</a> pen1 through pen9. 13459 <p> 13460 If you select the color browser and press <strong>Grab</strong>, you can choose the 13461 font color by moving the pointer to the desired color on the screen and 13462 press any button. 13463 <p> 13464 If you choose to rotate the text, choose <strong>Rotate Text</strong> from the menu 13465 and select an angle. Typically you will only want to rotate one line of 13466 text at a time. Depending on the angle you choose, subsequent lines may 13467 end up overwriting each other. 13468 <p> 13469 Choosing a font and its color is optional. The default font is fixed and 13470 the default color is black. However, you must choose a location to begin 13471 entering text and press a button. An underscore character will appear at 13472 the location of the pointer. The cursor changes to a pencil to indicate 13473 you are in text mode. To exit immediately, press Dismiss. 13474 <p> 13475 In text mode, any key presses will display the character at the location 13476 of the underscore and advance the underscore cursor. Enter your text and 13477 once completed press Apply to finish your image annotation. To correct 13478 errors press <strong>BACK SPACE</strong>. To delete an entire line of text, press 13479 <strong>DELETE</strong>. 13480 Any text that exceeds the boundaries of the image window is automatically 13481 continued onto the next line. 13482 <p> 13483 The actual color you request for the font is saved in the image. However, 13484 the color that appears in your Image window may be different. For example, 13485 on a monochrome screen the text will appear black or white even if you 13486 choose the color red as the font color. However, the image saved to a file 13487 with <strong>-write</strong> is written with red lettering. To assure the correct 13488 color text in the final image, any <em>PseudoClass</em> image is promoted 13489 to <em>DirectClass</em> (see miff(5)). To force a <em>PseudoClass</em> image 13490 to remain 13491 <em>PseudoClass</em>, use <strong>-colors</strong>. 13492 </td></tr></table> 13493 <p> 13494 <i><a href="#top">Back to Contents</a></i> 13495 </p> 13496 <table BORDER=0 WIDTH="100%"> 13497 <tr> 13498 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 13499 SRC="images/right_triangle.png" ALT=">" BORDER=0 13500 height=14 width=15><b><font face="Helvetica, Arial"><font 13501 color="#00B04F"><font size="+1"> 13502 <a NAME="disp-imcomp"></a>Image Compositing 13503 </font></font></font></b></td></tr></table> 13504 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 13505 <tr><td width="3%"><br></td><td> 13506 <p> 13507 An image composite is created interactively. <strong>There is no command line 13508 argument to composite an image</strong>. To begin, choose <strong>Composite</strong> of 13509 the <strong>Image Edit</strong> from the <a href="#disp-comm">Command widget</a>. Alternatively, 13510 <a href="#disp-keyb">press</a> x in the Image window. 13511 <p> 13512 First a popup window is displayed requesting you to enter an image name. 13513 Press <strong>Composite</strong>, <strong>Grab</strong> or type a file name. Press <strong>Cancel</strong> 13514 if you choose not to create a composite image. When you choose <strong>Grab</strong>, 13515 move the pointer to the desired window and press any button. 13516 <p> 13517 If the <strong>Composite</strong> image does not have any matte information, you 13518 are informed and the file browser is displayed again. Enter the name of 13519 a mask image. The image is typically grayscale and the same size as the 13520 composite image. If the image is not grayscale, it is converted to grayscale 13521 and the resulting intensities are used as matte information. 13522 <p> 13523 A small window appears showing the location of the cursor in the image 13524 window. You are now in composite mode. To exit immediately, press Dismiss. 13525 In composite mode, the Command widget has these options: 13526 <ul> 13527 <li> 13528 <strong>Operators</strong> 13529 <ul> 13530 <li> 13531 over 13532 <li> 13533 in 13534 <li> 13535 out 13536 <li> 13537 atop 13538 <li> 13539 xor 13540 <li> 13541 plus 13542 <li> 13543 minus 13544 <li> 13545 add 13546 <li> 13547 subtract 13548 <li> 13549 difference 13550 <li> 13551 bumpmap 13552 <li> 13553 replace 13554 </ul> 13555 <li> 13556 <strong>Blend</strong> 13557 <li> 13558 <strong>Displace</strong> 13559 <li> 13560 <strong>Help</strong> 13561 <li> 13562 <strong>Dismiss</strong> 13563 </ul> 13564 <p> 13565 Choose a composite operation from the Operators sub-menu of the Command 13566 widget. How each operator behaves is described below. image window is the 13567 image currently displayed on your X server and image is the image obtained 13568 <table BORDER=0 WIDTH="94%"> 13569 <tr> 13570 <td width="3%"><br></td> 13571 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13572 <img SRC="images/right_triangle_option.png" 13573 ALT=">" BORDER=0 height=14 13574 width=15><b><font face="Helvetica, Arial" 13575 ><font color="#00B04F"><font size="+1"> 13576 over 13577 </font></font></font></b></td></tr></table> 13578 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13579 The result is the union of the two image shapes, with <em>image</em> obscuring 13580 <em>image 13581 window</em> in the region of overlap.</td></tr></table> 13582 <table BORDER=0 WIDTH="94%"> 13583 <tr> 13584 <td width="3%"><br></td> 13585 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13586 <img SRC="images/right_triangle_option.png" 13587 ALT=">" BORDER=0 height=14 13588 width=15><b><font face="Helvetica, Arial" 13589 ><font color="#00B04F"><font size="+1"> 13590 in 13591 </font></font></font></b></td></tr></table> 13592 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13593 The result is simply <em>image</em> cut by the shape of 13594 <em>image window</em>. 13595 None of the image data of image window is in the result.</td></tr></table> 13596 <table BORDER=0 WIDTH="94%"> 13597 <tr> 13598 <td width="3%"><br></td> 13599 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13600 <img SRC="images/right_triangle_option.png" 13601 ALT=">" BORDER=0 height=14 13602 width=15><b><font face="Helvetica, Arial" 13603 ><font color="#00B04F"><font size="+1"> 13604 out 13605 </font></font></font></b></td></tr></table> 13606 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13607 The resulting image is <em>image</em> with the shape of 13608 <em>image window</em> 13609 cut out.</td></tr></table> 13610 <table BORDER=0 WIDTH="94%"> 13611 <tr> 13612 <td width="3%"><br></td> 13613 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13614 <img SRC="images/right_triangle_option.png" 13615 ALT=">" BORDER=0 height=14 13616 width=15><b><font face="Helvetica, Arial" 13617 ><font color="#00B04F"><font size="+1"> 13618 atop 13619 </font></font></font></b></td></tr></table> 13620 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13621 The result is the same shape as <em>image window</em>, with 13622 <em>image</em> 13623 obscuring <em>image window</em> where the image shapes overlap. Note this 13624 differs from over because the portion of image outside 13625 <em>image window</em>'s 13626 shape does not appear in the result.</td></tr></table> 13627 <table BORDER=0 WIDTH="94%"> 13628 <tr> 13629 <td width="3%"><br></td> 13630 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13631 <img SRC="images/right_triangle_option.png" 13632 ALT=">" BORDER=0 height=14 13633 width=15><b><font face="Helvetica, Arial" 13634 ><font color="#00B04F"><font size="+1"> 13635 xor 13636 </font></font></font></b></td></tr></table> 13637 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13638 The result is the image data from both <em>image</em> and 13639 <em>image window</em> 13640 that is outside the overlap region. The overlap region is blank.</td></tr></table> 13641 <table BORDER=0 WIDTH="94%"> 13642 <tr> 13643 <td width="3%"><br></td> 13644 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13645 <img SRC="images/right_triangle_option.png" 13646 ALT=">" BORDER=0 height=14 13647 width=15><b><font face="Helvetica, Arial" 13648 ><font color="#00B04F"><font size="+1"> 13649 plus 13650 </font></font></font></b></td></tr></table> 13651 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13652 The result is just the sum of the image data. Output values are cropped 13653 to 255 (no overflow). This operation is independent of the matte channels.</td></tr></table> 13654 <table BORDER=0 WIDTH="94%"> 13655 <tr> 13656 <td width="3%"><br></td> 13657 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13658 <img SRC="images/right_triangle_option.png" 13659 ALT=">" BORDER=0 height=14 13660 width=15><b><font face="Helvetica, Arial" 13661 ><font color="#00B04F"><font size="+1"> 13662 minus 13663 </font></font></font></b></td></tr></table> 13664 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13665 The result of <em>image</em> - <em>image window</em>, with underflow cropped 13666 to zero. The matte channel is ignored (set to 255, full coverage).</td></tr></table> 13667 <table BORDER=0 WIDTH="94%"> 13668 <tr> 13669 <td width="3%"><br></td> 13670 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13671 <img SRC="images/right_triangle_option.png" 13672 ALT=">" BORDER=0 height=14 13673 width=15><b><font face="Helvetica, Arial" 13674 ><font color="#00B04F"><font size="+1"> 13675 add 13676 </font></font></font></b></td></tr></table> 13677 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13678 The result of <em>image</em> + <em>image window</em>, with overflow wrapping 13679 around (mod 256).</td></tr></table> 13680 <table BORDER=0 WIDTH="94%"> 13681 <tr> 13682 <td width="3%"><br></td> 13683 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13684 <img SRC="images/right_triangle_option.png" 13685 ALT=">" BORDER=0 height=14 13686 width=15><b><font face="Helvetica, Arial" 13687 ><font color="#00B04F"><font size="+1"> 13688 subtract 13689 </font></font></font></b></td></tr></table> 13690 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13691 The result of <em>image</em> - <em>image window</em>, with underflow wrapping 13692 around (mod 256). The add and subtract operators can be used to perform 13693 reversible transformations.</td></tr></table> 13694 <table BORDER=0 WIDTH="94%"> 13695 <tr> 13696 <td width="3%"><br></td> 13697 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13698 <img SRC="images/right_triangle_option.png" 13699 ALT=">" BORDER=0 height=14 13700 width=15><b><font face="Helvetica, Arial" 13701 ><font color="#00B04F"><font size="+1"> 13702 difference 13703 </font></font></font></b></td></tr></table> 13704 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13705 The result of abs(<em>image</em> - <em>image window</em>). This is useful for 13706 comparing two very similar images.</td></tr></table> 13707 <table BORDER=0 WIDTH="94%"> 13708 <tr> 13709 <td width="3%"><br></td> 13710 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13711 <img SRC="images/right_triangle_option.png" 13712 ALT=">" BORDER=0 height=14 13713 width=15><b><font face="Helvetica, Arial" 13714 ><font color="#00B04F"><font size="+1"> 13715 bumpmap 13716 </font></font></font></b></td></tr></table> 13717 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13718 The result of <em>image window</em> shaded by <em>window</em>.</td></tr></table> 13719 <table BORDER=0 WIDTH="94%"> 13720 <tr> 13721 <td width="3%"><br></td> 13722 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 13723 <img SRC="images/right_triangle_option.png" 13724 ALT=">" BORDER=0 height=14 13725 width=15><b><font face="Helvetica, Arial" 13726 ><font color="#00B04F"><font size="+1"> 13727 replace 13728 </font></font></font></b></td></tr></table> 13729 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 13730 The resulting image is <em>image window</em> replaced with 13731 <em>image</em>. 13732 Here the matte information is ignored.</td></tr></table> 13733 <p> 13734 The image compositor requires a matte, or alpha channel in the image for 13735 some operations. This extra channel usually defines a mask which represents 13736 a sort of a cookie-cutter for the image. This is the case when matte is 13737 255 (full coverage) for pixels inside the shape, zero outside, and between 13738 zero and 255 on the boundary. If image does not have a matte channel, it 13739 is initialized with 0 for any pixel matching in color to pixel location 13740 (0,0), otherwise 255. See <a href="#disp-matt">Matte Editing</a> for a method 13741 of defining a matte channel. 13742 <p> 13743 If you choose <strong>blend</strong>, the composite operator becomes <strong>over</strong>. 13744 The image matte channel percent transparency is initialized to factor. 13745 The image window is initialized to (100-factor). Where factor is the value 13746 you specify in the Dialog widget. 13747 <p> 13748 <strong>Displace</strong> shifts the image pixels as defined by a displacement map. 13749 With this option, <em>image</em> is used as a displacement map. Black, within 13750 the displacement map, is a maximum positive displacement. White is a maximum 13751 negative displacement and middle gray is neutral. The displacement is scaled 13752 to determine the pixel shift. By default, the displacement applies in both 13753 the horizontal and vertical directions. However, if you specify 13754 <em>mask</em>, 13755 <em>image</em> 13756 is the horizontal X displacement and 13757 <em>mask</em> the vertical Y displacement. 13758 <p> 13759 Note that matte information for image window is not retained for colormapped 13760 X server visuals (e.g. 13761 <em>StaticColor, StaticColor, GrayScale, PseudoColor</em>). 13762 Correct compositing behavior may require a <em>TrueColor</em> or 13763 <em>DirectColor</em> 13764 visual or a <em>Standard Colormap</em>. 13765 <p> 13766 Choosing a composite operator is optional. The default operator is replace. 13767 However, you must choose a location to composite your image and press button 13768 1. Press and hold the button before releasing and an outline of the image 13769 will appear to help you identify your location. 13770 <p> 13771 The actual colors of the composite image is saved. However, the color that 13772 appears in image window may be different. For example, on a monochrome 13773 screen Image window will appear black or white even though your composited 13774 image may have many colors. If the image is saved to a file it is written 13775 with the correct colors. To assure the correct colors are saved in the 13776 final image, any PseudoClass image is promoted to <em>DirectClass</em> (see 13777 <a href="miff.html">miff</a>). 13778 To force a <em>PseudoClass</em> image to remain <em>PseudoClass</em>, 13779 use <strong>-colors</strong>. 13780 </td></tr></table> 13781 <p> 13782 <i><a href="#top">Back to Contents</a></i> 13783 </p> 13784 <table BORDER=0 WIDTH="100%"> 13785 <tr> 13786 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 13787 SRC="images/right_triangle.png" ALT=">" BORDER=0 13788 height=14 width=15><b><font face="Helvetica, Arial"><font 13789 color="#00B04F"><font size="+1"> 13790 <a NAME="disp-cole"></a>Color Editing 13791 </font></font></font></b></td></tr></table> 13792 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 13793 <tr><td width="3%"><br></td><td> 13794 <p> 13795 Changing the the color of a set of pixels is performed interactively. There 13796 is no command line argument to edit a pixel. To begin, choose <strong>Color</strong> 13797 from the <strong>Image Edit</strong> submenu of the <a href="#disp-comm">Command widget</a>. 13798 Alternatively, <a href="#disp-keyb">press</a> c in the image window. 13799 <p> 13800 A small window appears showing the location of the cursor in the image 13801 window. You are now in color edit mode. To exit immediately, press <strong>Dismiss</strong>. 13802 In color edit mode, the 13803 <strong>Command widget</strong> has these options: 13804 <ul> 13805 <li> 13806 <strong>Method</strong> 13807 <ul> 13808 <li> 13809 point 13810 <li> 13811 replace 13812 <li> 13813 floodfill 13814 <li> 13815 reset 13816 </ul> 13817 <li> 13818 <strong>Pixel Color</strong> 13819 <ul> 13820 <li> 13821 black 13822 <li> 13823 blue 13824 <li> 13825 cyan 13826 <li> 13827 green 13828 <li> 13829 gray 13830 <li> 13831 red 13832 <li> 13833 magenta 13834 <li> 13835 yellow 13836 <li> 13837 white 13838 <li> 13839 Browser... 13840 </ul> 13841 <li> 13842 <strong>Border Color</strong> 13843 <ul> 13844 <li> 13845 black 13846 <li> 13847 blue 13848 <li> 13849 cyan 13850 <li> 13851 green 13852 <li> 13853 gray 13854 <li> 13855 red 13856 <li> 13857 magenta 13858 <li> 13859 yellow 13860 <li> 13861 white 13862 <li> 13863 Browser... 13864 </ul> 13865 <li> 13866 <strong>Fuzz</strong> 13867 <ul> 13868 <li> 13869 0 13870 <li> 13871 2 13872 <li> 13873 4 13874 <li> 13875 8 13876 <li> 13877 16 13878 <li>Dialog... 13879 </ul> 13880 <li> 13881 <strong>Undo</strong> 13882 <li> 13883 <strong>Help</strong> 13884 <li> 13885 <strong>Dismiss</strong> 13886 </ul> 13887 <p> 13888 Choose a color editing method from the <strong>Method</strong> sub-menu of 13889 the <a href="#disp-comm">Command 13890 widget</a>. The <strong>point method</strong> recolors any pixel selected with the 13891 pointer unless the button is released. The <strong>replace method</strong> recolors 13892 any pixel that matches the color of the pixel you select with a button 13893 press. <strong>Floodfill</strong> recolors any pixel that matches the color of the 13894 pixel you select with a button press and is a neighbor. 13895 Whereas <strong>filltoborder</strong> 13896 changes the matte value of any neighbor pixel that is not the border color. 13897 Finally <strong>reset</strong> changes the entire image to the designated color. 13898 <p> 13899 Next, choose a pixel color from the <strong>Pixel Color</strong> sub-menu. Additional 13900 pixel colors can be specified with the color browser. You can change the 13901 menu colors by setting the <a href="#disp-xres">X resources</a> pen1 through 13902 pen9. 13903 <p> 13904 Now press button 1 to select a pixel within the Image window to change 13905 its color. Additional pixels may be recolored as prescribed by the method 13906 you choose. additional pixels by increasing the Delta value. 13907 <p> 13908 If the <strong>Magnify widget</strong> is mapped, it can be helpful in positioning 13909 your pointer within the image (refer to button 2). Alternatively you can 13910 select a pixel to recolor from within the <strong>Magnify widget</strong>. Move the 13911 pointer to the <strong>Magnify widget</strong> and position the pixel with the cursor 13912 control keys. Finally, press a button to recolor the selected pixel (or 13913 pixels). 13914 <p> 13915 The actual color you request for the pixels is saved in the image. However, 13916 the color that appears in your Image window may be different. For example, 13917 on a monochrome screen the pixel will appear black or white even if you 13918 choose the color red as the pixel color. However, the image saved to a 13919 file with -write is written with red pixels. To assure the correct color 13920 text in the final image, any <em>PseudoClass</em> image is promoted 13921 to <em>DirectClass</em> 13922 To force a <em>PseudoClass</em> image to remain 13923 <em>PseudoClass</em>, use <strong>-colors</strong>. 13924 </td></tr></table> 13925 <p> 13926 <i><a href="#top">Back to Contents</a></i> 13927 </p> 13928 <table BORDER=0 WIDTH="100%"> 13929 <tr> 13930 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 13931 SRC="images/right_triangle.png" ALT=">" BORDER=0 13932 height=14 width=15><b><font face="Helvetica, Arial"><font 13933 color="#00B04F"><font size="+1"> 13934 <a NAME="disp-matt"></a>Matte Editing 13935 </font></font></font></b></td></tr></table> 13936 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 13937 <tr><td width="3%"><br></td><td> 13938 <p> 13939 Matte information within an image is useful for some operations such as 13940 image <a href="#disp-imcomp">compositing</a>. This extra channel usually defines 13941 a mask which represents a sort of a cookie-cutter for the image. This is 13942 the case when matte is 255 (full coverage) for pixels inside the shape, 13943 zero outside, and between zero and 255 on the boundary. 13944 <p> 13945 Setting the matte information in an image is done interactively. There 13946 is no command line argument to edit a pixel. To begin, and choose <strong>Matte</strong> 13947 of the <strong>Image Edit</strong> sub-menu from the <a href="#disp-comm">Command widget</a>. 13948 <p> 13949 Alternatively, <a href="#disp-keyb">press</a> m in the image window. 13950 <p> 13951 A small window appears showing the location of the cursor in the image 13952 window. You are now in matte edit mode. To exit immediately, press Dismiss. 13953 In matte edit mode, the Command widget has these options: 13954 <ul> 13955 <li> 13956 <strong>Method</strong> 13957 <ul> 13958 <li> 13959 point 13960 <li> 13961 replace 13962 <li> 13963 floodfill 13964 <li> 13965 reset 13966 </ul> 13967 <li> 13968 <strong>Border Color</strong> 13969 <ul> 13970 <li> 13971 black 13972 <li> 13973 blue 13974 <li> 13975 cyan 13976 <li> 13977 green 13978 <li> 13979 gray 13980 <li> 13981 red 13982 <li> 13983 magenta 13984 <li> 13985 yellow 13986 <li> 13987 white 13988 <li> 13989 Browser... 13990 </ul> 13991 <li> 13992 <strong>Fuzz</strong> 13993 <ul> 13994 <li> 13995 0 13996 <li> 13997 2 13998 <li> 13999 4 14000 <li> 14001 8 14002 <li> 14003 16 14004 <li>Dialog... 14005 </ul> 14006 <li> 14007 <strong>Matte</strong> 14008 <li> 14009 <strong>Undo</strong> 14010 <li> 14011 <strong>Help</strong> 14012 <li> 14013 <strong>Dismiss</strong> 14014 </ul> 14015 Choose a matte editing method from the <strong>Method</strong> sub-menu of the <a href="#disp-comm">Command 14016 widget</a>. The <strong>point method</strong> changes the matte value of the any 14017 pixel selected with the pointer until the button is released. The <strong>replace 14018 method</strong> changes the matte value of any pixel that matches the color 14019 of the pixel you select with a button press. <strong>Floodfill</strong> changes the 14020 matte value of any pixel that matches the color of the pixel you select 14021 with a button press and is a neighbor. Whereas 14022 <strong>filltoborder</strong> recolors 14023 any neighbor pixel that is not the border color. Finally <strong>reset</strong> changes 14024 the entire image to the designated matte value. 14025 <p>Choose <strong>Matte Value</strong> and a dialog appears requesting a matte value. 14026 Enter a value between <strong>0 and 255</strong>. This value is assigned as the matte 14027 value of the selected pixel or pixels. 14028 <p>Now, press any button to select a pixel within the Image window to change 14029 its matte value. You can change the matte value of additional pixels by 14030 increasing the Delta value. The Delta value is first added then subtracted 14031 from the red, green, and blue of the target color. Any pixels within the 14032 range also have their matte value updated. 14033 <p>If the <strong>Magnify widget</strong> is mapped, it can be helpful in positioning 14034 your pointer within the image (refer to button 2). Alternatively you can 14035 select a pixel to change the matte value from within the 14036 <strong>Magnify widget</strong>. 14037 Move the pointer to the <strong>Magnify widget</strong> and position the pixel with 14038 the cursor control keys. Finally, press a button to change the matte value 14039 of the selected pixel (or pixels). 14040 <p>Matte information is only valid in a <em>DirectClass image</em>. Therefore, 14041 any <em>PseudoClass</em> image is promoted to 14042 <em>DirectClass</em>. Note that 14043 matte information for <em>PseudoClass</em> is not retained for colormapped 14044 X server visuals (e.g. <em>StaticColor, StaticColor, GrayScale, PseudoColor</em>) 14045 unless you immediately save your image to a file (refer to Write). Correct 14046 matte editing behavior may require a <em>TrueColor</em> or <em>DirectColor</em> 14047 visual or a <em>Standard Colormap</em>. 14048 </td></tr></table> 14049 <p> 14050 <i><a href="#top">Back to Contents</a></i> 14051 </p> 14052 <table BORDER=0 WIDTH="100%"> 14053 <tr> 14054 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 14055 SRC="images/right_triangle.png" ALT=">" BORDER=0 14056 height=14 width=15><b><font face="Helvetica, Arial"><font 14057 color="#00B04F"><font size="+1"> 14058 <a NAME="disp-imdr"></a>Image Drawing 14059 </font></font></font></b></td></tr></table> 14060 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 14061 <tr><td width="3%"><br></td><td> 14062 <p> 14063 An image is drawn upon interactively. <strong>There is no command line argument 14064 to draw on an image</strong>. To begin, choose <strong>Draw</strong> of the Image <strong>Edit</strong> 14065 sub-menu from the <a href="#disp-comm">Command widget</a>. 14066 Alternatively, <a href="#disp-keyb">press</a> d in the image window. 14067 <p> 14068 The cursor changes to a crosshair to indicate you are in draw mode. To 14069 exit immediately, press Dismiss. In draw mode, the Command widget has these 14070 options: 14071 <ul> 14072 <li> 14073 <strong>Primitive</strong> 14074 <ul> 14075 <li> 14076 point 14077 <li> 14078 line 14079 <li> 14080 rectangle 14081 <li> 14082 fill rectangle 14083 <li> 14084 circle 14085 <li> 14086 fill circle 14087 <li> 14088 ellipse 14089 <li> 14090 fill ellipse 14091 <li> 14092 polygon 14093 <li> 14094 fill polygon 14095 </ul> 14096 <li> 14097 <strong>Color</strong> 14098 <ul> 14099 <li> 14100 black 14101 <li> 14102 blue 14103 <li> 14104 cyan 14105 <li> 14106 green 14107 <li> 14108 gray 14109 <li> 14110 red 14111 <li> 14112 magenta 14113 <li> 14114 yellow 14115 <li> 14116 white 14117 <li> 14118 transparent 14119 <li> 14120 Browser... 14121 </ul> 14122 <li> 14123 <strong>Stipple</strong> 14124 <ul> 14125 <li> 14126 Brick 14127 <li> 14128 Diagonal 14129 <li> 14130 Scales 14131 <li> 14132 Vertical 14133 <li> 14134 Wavy 14135 <li> 14136 Translucent 14137 <li> 14138 Opaque 14139 <li> 14140 Open... 14141 </ul> 14142 <li> 14143 <strong>Width</strong> 14144 <ul> 14145 <li> 14146 1 14147 <li> 14148 2 14149 <li> 14150 4 14151 <li> 14152 8 14153 <li> 14154 16 14155 <li>Dialog... 14156 </ul> 14157 <li> 14158 <strong>Undo</strong> 14159 <li> 14160 <strong>Help</strong> 14161 <li> 14162 <strong>Dismiss</strong> 14163 </ul> 14164 Choose a drawing primitive from the <strong>Primitive</strong> sub-menu. 14165 <p> 14166 Next, choose a color from the <strong>Color</strong> sub-menu. Additional colors 14167 can be specified with the color browser. You can change the menu colors 14168 by setting the <a href="#disp-xres">X resources</a> pen1 through pen9. The transparent 14169 color updates the image matte channel and is useful for image compositing. 14170 <p> 14171 If you choose the color browser and press <strong>Grab</strong>, you can select the 14172 primitive color by moving the pointer to the desired color on the screen 14173 and press any button. The transparent color updates the image matte channel 14174 and is useful for image compositing. 14175 <p> 14176 Choose a stipple, if appropriate, from the <strong>Stipple</strong> sub-menu. Additional 14177 stipples can be specified with the file browser. Stipples obtained from 14178 the file browser must be on disk in the X11 bitmap format. 14179 <p> 14180 Choose a line width, if appropriate, from the <strong>Width</strong> sub-menu. To 14181 choose a specific width select the <strong>Dialog</strong> widget. 14182 <p> 14183 Choose a point in the image window and press button 1 and hold. Next, move 14184 the pointer to another location in the image. As you move, a line connects 14185 the initial location and the pointer. When you release the button, the 14186 image is updated with the primitive you just drew. For polygons, the image 14187 is updated when you press and release the button without moving the pointer. 14188 <p> 14189 To cancel image drawing, move the pointer back to the starting point of 14190 the line and release the button. 14191 </td></tr></table> 14192 <p> 14193 <i><a href="#top">Back to Contents</a></i> 14194 </p> 14195 <table BORDER=0 WIDTH="100%"> 14196 <tr> 14197 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 14198 SRC="images/right_triangle.png" ALT=">" BORDER=0 14199 height=14 width=15><b><font face="Helvetica, Arial"><font 14200 color="#00B04F"><font size="+1"> 14201 <a NAME="disp-regi"></a>Region of Interest 14202 </font></font></font></b></td></tr></table> 14203 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 14204 <tr><td width="3%"><br></td><td> 14205 <p> 14206 To begin, press choose Region of Interest of the Pixel Transform sub-menu 14207 from the <a href="#disp-comm">Command widget</a>. 14208 Alternatively, <a href="#disp-keyb">press</a> R in the image window. 14209 <p> 14210 A small window appears showing the location of the cursor in the image 14211 window. You are now in region of interest mode. In region of interest mode, 14212 the Command widget has these options: 14213 <ul> 14214 <li> 14215 <strong>Help</strong> 14216 <li> 14217 <strong>Dismiss</strong> 14218 </ul> 14219 <p> 14220 To define a region of interest, press button 1 and drag. The region of 14221 interest is defined by a highlighted rectangle that expands or contracts 14222 as it follows the pointer. Once you are satisfied with the region of interest, 14223 release the button. You are now in apply mode. In apply mode the Command 14224 widget has these options: 14225 <ul> 14226 <li> 14227 <strong>File</strong> 14228 <ul> 14229 <li> 14230 Save... 14231 <li> 14232 Print... 14233 </ul> 14234 <li> 14235 <strong>Edit</strong> 14236 <ul> 14237 <li> 14238 Undo 14239 <li> 14240 Redo 14241 </ul> 14242 <li> 14243 <strong>Transform</strong> 14244 <ul> 14245 <li> 14246 Flip 14247 <li> 14248 Flop 14249 <li> 14250 Rotate Right 14251 <li> 14252 Rotate Left 14253 </ul> 14254 <li> 14255 <strong>Enhance</strong> 14256 <ul> 14257 <li> 14258 Hue... 14259 <li> 14260 Saturation... 14261 <li> 14262 Brightness... 14263 <li> 14264 Gamma... 14265 <li> 14266 Spiff 14267 <li> 14268 Dull 14269 <li> 14270 Equalize 14271 <li> 14272 Normalize 14273 <li> 14274 Negate 14275 <li> 14276 GRAYscale 14277 <li> 14278 Quantize... 14279 </ul> 14280 <li> 14281 <strong>Effects</strong> 14282 <ul> 14283 <li> 14284 Despeckle 14285 <li> 14286 Emboss 14287 <li> 14288 Reduce Noise 14289 <li> 14290 Add Noise 14291 <li> 14292 Sharpen... 14293 <li> 14294 Blur... 14295 <li> 14296 Threshold... 14297 <li> 14298 Edge Detect... 14299 <li> 14300 Spread... 14301 <li> 14302 Shade... 14303 <li> 14304 Raise... 14305 <li> 14306 Segment... 14307 </ul> 14308 </ul> 14309 <ul> 14310 <li> 14311 <strong>F/X</strong> 14312 <ul> 14313 <li> 14314 Solarize... 14315 <li> 14316 Swirl... 14317 <li> 14318 Implode... 14319 <li> 14320 Wave... 14321 <li> 14322 Oil Paint 14323 <li> 14324 Charcoal Draw... 14325 </ul> 14326 </ul> 14327 <ul> 14328 <li> 14329 <strong>Miscellany</strong> 14330 <ul> 14331 <li> 14332 Image Info 14333 <li> 14334 Zoom Image 14335 <li> 14336 Show Preview... 14337 <li> 14338 Show Histogram 14339 <li> 14340 Show Matte 14341 </ul> 14342 <li> 14343 <strong>Help</strong> 14344 <li> 14345 <strong>Dismiss</strong> 14346 </ul> 14347 <p> 14348 You can make adjustments to the region of interest by moving the pointer 14349 to one of the rectangle corners, pressing a button, and dragging. Finally, 14350 choose an image processing technique from the Command widget. You can choose 14351 more than one image processing technique to apply to an area. Alternatively, 14352 you can move the region of interest before applying another image processing 14353 technique. To exit, press Dismiss. 14354 </td></tr></table> 14355 <p> 14356 <i><a href="#top">Back to Contents</a></i> 14357 </p> 14358 <table BORDER=0 WIDTH="100%"> 14359 <tr> 14360 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 14361 SRC="images/right_triangle.png" ALT=">" BORDER=0 14362 height=14 width=15><b><font face="Helvetica, Arial"><font 14363 color="#00B04F"><font size="+1"> 14364 <a NAME="disp-impa"></a>Image Panning 14365 </font></font></font></b></td></tr></table> 14366 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 14367 <tr><td width="3%"><br></td><td> 14368 <p> 14369 When an image exceeds the width or height of the X server screen, display 14370 maps a small panning icon. The rectangle within the panning icon shows 14371 the area that is currently displayed in the the image window. To pan about 14372 the image, press any button and drag the pointer within the panning icon. 14373 The pan rectangle moves with the pointer and the image window is updated 14374 to reflect the location of the rectangle within the panning icon. When 14375 you have selected the area of the image you wish to view, release the button. 14376 <p> 14377 Use the arrow keys to pan the image one pixel up, down, left, or right 14378 within the image window. 14379 <p> 14380 The panning icon is withdrawn if the image becomes smaller than the dimensions 14381 of the X server screen. 14382 </td></tr></table> 14383 <p> 14384 <i><a href="#top">Back to Contents</a></i> 14385 </p> 14386 <table BORDER=0 WIDTH="100%"> 14387 <tr> 14388 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 14389 SRC="images/right_triangle.png" ALT=">" BORDER=0 14390 height=14 width=15><b><font face="Helvetica, Arial"><font 14391 color="#00B04F"><font size="+1"> 14392 <a NAME="disp-pref"></a>User Preferences 14393 </font></font></font></b></td></tr></table> 14394 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 14395 <tr><td width="3%"><br></td><td> 14396 <p> 14397 Preferences affect the default behavior of <strong>display(1)</strong>. The preferences 14398 are either true or false and are stored in your home directory 14399 as <tt>.displayrc</tt>: 14400 <dl> 14401 <dt> 14402 <strong>display image centered on a backdrop</strong></dt> 14403 <dd> 14404 This backdrop covers the entire workstation screen and is useful for hiding 14405 other X window activity while viewing the image. The color of the backdrop 14406 is specified as the background color. Refer to <a href="#disp-xres">X Resources</a> 14407 for details.</dd> 14408 <dt> 14409 <strong>confirm on program exit</strong></dt> 14410 <dd> 14411 Ask for a confirmation before exiting the <strong>display(1)</strong> program.</dd> 14412 <dt> 14413 <strong>correct image for display gamma</strong></dt> 14414 <dd> 14415 If the image has a known gamma, the gamma is corrected to match that of 14416 the X server (see the <a href="#disp-xres">X Resource</a><strong> displayGamma</strong>).</dd> 14417 <dt> 14418 <strong>display warning messages</strong></dt> 14419 <dd> 14420 Display any warning messages.</dd> 14421 <dt> 14422 <strong>apply Floyd/Steinberg error diffusion to image</strong></dt> 14423 <dd> 14424 The basic strategy of dithering is to trade intensity resolution for spatial 14425 resolution by averaging the intensities of several neighboring pixels. 14426 Images which suffer from severe contouring when reducing colors can be 14427 improved with this preference.</dd> 14428 <dt> 14429 <strong>use a shared colormap for colormapped X visuals</strong></dt> 14430 <dd> 14431 This option only applies when the default X server visual is 14432 <em>PseudoColor</em> 14433 or <em>GRAYScale</em>. Refer to <strong>-visual</strong> for more details. By default, 14434 a shared colormap is allocated. The image shares colors with other X clients. 14435 Some image colors could be approximated, therefore your image may look 14436 very different than intended. Otherwise the image colors appear exactly 14437 as they are defined. However, other clients may go technicolor when the 14438 image colormap is installed.</dd> 14439 <dt> 14440 <strong>display images as an X server pixmap</strong></dt> 14441 <dd> 14442 Images are maintained as a XImage by default. Set this resource to True 14443 to utilize a server Pixmap instead. This option is useful if your image 14444 exceeds the dimensions of your server screen and you intend to pan the 14445 image. Panning is much faster with Pixmaps than with a XImage. Pixmaps 14446 are considered a precious resource, use them with discretion.</dd> 14447 </dl> 14448 </td></tr></table> 14449 <p> 14450 <i><a href="#top">Back to Contents</a></i> 14451 </p> 14452 <br> <br> 14453 <table BORDER=0 WIDTH="100%"> 14454 <tr> 14455 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 14456 SRC="images/right_triangle.png" ALT=">" BORDER=0 14457 height=14 width=15><b><font face="Helvetica, Arial"><font 14458 color="#00B04F"><font size="+1"> 14459 <a NAME="gm identify"></a>gm identify 14460 </font></font></font></b></td></tr></table> 14461 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 14462 <tr><td width="3%"><br></td><td> 14463 <p> 14464 <strong>Identify</strong> describes the format and characteristics of one or 14465 more image files as internally supported by the software. It will also 14466 report if an image is incomplete or corrupt. The information 14467 displayed includes the scene number, the file name, the width and 14468 height of the image, whether the image is colormapped or not, the 14469 number of colors in the image, the number of bytes in the image, the 14470 format of the image (JPEG, PNM, etc.), and finally the number of 14471 seconds in both user time and elapsed time it took to read and process 14472 the image. If -verbose or +ping are provided as an option, the pixel 14473 read rate is also displayed. An example line output from 14474 <strong>identify</strong> follows: 14475 <pre> 14476 images/aquarium.miff 640x480 PseudoClass 256c 14477 308135b MIFF 0.000u 0:01 14478 </pre> 14479 <p> 14480 If <tt>-verbose</tt> is set, expect additional output including any image 14481 comment: 14482 <br> <br> 14483 <pre> 14484 Image: images/aquarium.miff 14485 class: PseudoClass 14486 colors: 256 14487 signature: eb5dca81dd93ae7e6ffae99a527eb5dca8... 14488 matte: False 14489 geometry: 640x480 14490 depth: 8 14491 bytes: 308135 14492 format: MIFF 14493 comments: 14494 Imported from MTV raster image: aquarium.mtv 14495 </pre> 14496 <p> 14497 For some formats, additional format-specific information about the file 14498 will be written if the <tt>-debug coder</tt> or <tt>-debug all</tt> option 14499 is used. 14500 </td></tr></table> 14501 <p> 14502 <i><a href="#top">Back to Contents</a></i> 14503 </p> 14504 <table BORDER=0 WIDTH="100%"> 14505 <tr> 14506 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 14507 SRC="images/right_triangle.png" ALT=">" BORDER=0 14508 height=14 width=15><b><font face="Helvetica, Arial"><font 14509 color="#00B04F"><font size="+1"> 14510 <a NAME="ident-opti"></a>Identify options 14511 </font></font></font></b></td></tr></table> 14512 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 14513 <tr><td width="3%"><br></td><td> 14514 <p> 14515 Options are processed in command line order. Any option you specify on 14516 the command line remains in effect for the set of images immediately 14517 following, until the set is terminated by the appearance of any option 14518 or <strong>-noop</strong>. 14519 <p> 14520 For a more detailed description of each option, see 14521 Options, above. 14522 <br> <br> 14523 <table BORDER=0 WIDTH="94%"> 14524 <tr> 14525 <td width="3%"><br></td> 14526 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14527 <img SRC="images/right_triangle_option.png" 14528 ALT=">" BORDER=0 height=14 14529 width=15><b><font face="Helvetica, Arial" 14530 ><font color="#00B04F"><font size="+1"> 14531 <a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i><string></i> 14532 </font></font></font></b></td></tr></table> 14533 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table> 14534 <table BORDER=0 WIDTH="94%"> 14535 <tr> 14536 <td width="3%"><br></td> 14537 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14538 <img SRC="images/right_triangle_option.png" 14539 ALT=">" BORDER=0 height=14 14540 width=15><b><font face="Helvetica, Arial" 14541 ><font color="#00B04F"><font size="+1"> 14542 -debug <i><events></i> 14543 </font></font></font></b></td></tr></table> 14544 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table> 14545 <table BORDER=0 WIDTH="94%"> 14546 <tr> 14547 <td width="3%"><br></td> 14548 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14549 <img SRC="images/right_triangle_option.png" 14550 ALT=">" BORDER=0 height=14 14551 width=15><b><font face="Helvetica, Arial" 14552 ><font color="#00B04F"><font size="+1"> 14553 <a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i> 14554 </font></font></font></b></td></tr></table> 14555 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table> 14556 <table BORDER=0 WIDTH="94%"> 14557 <tr> 14558 <td width="3%"><br></td> 14559 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14560 <img SRC="images/right_triangle_option.png" 14561 ALT=">" BORDER=0 height=14 14562 width=15><b><font face="Helvetica, Arial" 14563 ><font color="#00B04F"><font size="+1"> 14564 <a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i> 14565 </font></font></font></b></td></tr></table> 14566 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table> 14567 <table BORDER=0 WIDTH="94%"> 14568 <tr> 14569 <td width="3%"><br></td> 14570 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14571 <img SRC="images/right_triangle_option.png" 14572 ALT=">" BORDER=0 height=14 14573 width=15><b><font face="Helvetica, Arial" 14574 ><font color="#00B04F"><font size="+1"> 14575 <a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i> 14576 </font></font></font></b></td></tr></table> 14577 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table> 14578 <table BORDER=0 WIDTH="94%"> 14579 <tr> 14580 <td width="3%"><br></td> 14581 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14582 <img SRC="images/right_triangle_option.png" 14583 ALT=">" BORDER=0 height=14 14584 width=15><b><font face="Helvetica, Arial" 14585 ><font color="#00B04F"><font size="+1"> 14586 <a href="GraphicsMagick.html#details-format">-format</a> <i><string></i> 14587 </font></font></font></b></td></tr></table> 14588 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>output formatted image characteristics</td></tr></table> 14589 <table BORDER=0 WIDTH="94%"> 14590 <tr> 14591 <td width="3%"><br></td> 14592 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14593 <img SRC="images/right_triangle_option.png" 14594 ALT=">" BORDER=0 height=14 14595 width=15><b><font face="Helvetica, Arial" 14596 ><font color="#00B04F"><font size="+1"> 14597 -help 14598 </font></font></font></b></td></tr></table> 14599 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table> 14600 <table BORDER=0 WIDTH="94%"> 14601 <tr> 14602 <td width="3%"><br></td> 14603 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14604 <img SRC="images/right_triangle_option.png" 14605 ALT=">" BORDER=0 height=14 14606 width=15><b><font face="Helvetica, Arial" 14607 ><font color="#00B04F"><font size="+1"> 14608 <a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i> 14609 </font></font></font></b></td></tr></table> 14610 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table> 14611 <table BORDER=0 WIDTH="94%"> 14612 <tr> 14613 <td width="3%"><br></td> 14614 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14615 <img SRC="images/right_triangle_option.png" 14616 ALT=">" BORDER=0 height=14 14617 width=15><b><font face="Helvetica, Arial" 14618 ><font color="#00B04F"><font size="+1"> 14619 <a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i> 14620 </font></font></font></b></td></tr></table> 14621 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table> 14622 <table BORDER=0 WIDTH="94%"> 14623 <tr> 14624 <td width="3%"><br></td> 14625 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14626 <img SRC="images/right_triangle_option.png" 14627 ALT=">" BORDER=0 height=14 14628 width=15><b><font face="Helvetica, Arial" 14629 ><font color="#00B04F"><font size="+1"> 14630 <a href="GraphicsMagick.html#details-log">-log</a> <i><string></i> 14631 </font></font></font></b></td></tr></table> 14632 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table> 14633 <table BORDER=0 WIDTH="94%"> 14634 <tr> 14635 <td width="3%"><br></td> 14636 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14637 <img SRC="images/right_triangle_option.png" 14638 ALT=">" BORDER=0 height=14 14639 width=15><b><font face="Helvetica, Arial" 14640 ><font color="#00B04F"><font size="+1"> 14641 -ping 14642 </font></font></font></b></td></tr></table> 14643 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>efficiently determine image characteristics</td></tr></table> 14644 <table BORDER=0 WIDTH="94%"> 14645 <tr> 14646 <td width="3%"><br></td> 14647 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14648 <img SRC="images/right_triangle_option.png" 14649 ALT=">" BORDER=0 height=14 14650 width=15><b><font face="Helvetica, Arial" 14651 ><font color="#00B04F"><font size="+1"> 14652 <a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i> 14653 </font></font></font></b></td></tr></table> 14654 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chroma subsampling factors</td></tr></table> 14655 <table BORDER=0 WIDTH="94%"> 14656 <tr> 14657 <td width="3%"><br></td> 14658 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14659 <img SRC="images/right_triangle_option.png" 14660 ALT=">" BORDER=0 height=14 14661 width=15><b><font face="Helvetica, Arial" 14662 ><font color="#00B04F"><font size="+1"> 14663 <a href="GraphicsMagick.html#details-size">-size</a> <i><width>x<height></i>{<i>+offset</i>}<i></i> 14664 </font></font></font></b></td></tr></table> 14665 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table> 14666 <table BORDER=0 WIDTH="94%"> 14667 <tr> 14668 <td width="3%"><br></td> 14669 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14670 <img SRC="images/right_triangle_option.png" 14671 ALT=">" BORDER=0 height=14 14672 width=15><b><font face="Helvetica, Arial" 14673 ><font color="#00B04F"><font size="+1"> 14674 <a href="GraphicsMagick.html#details-verbose">-verbose</a> 14675 </font></font></font></b></td></tr></table> 14676 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table> 14677 <table BORDER=0 WIDTH="94%"> 14678 <tr> 14679 <td width="3%"><br></td> 14680 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14681 <img SRC="images/right_triangle_option.png" 14682 ALT=">" BORDER=0 height=14 14683 width=15><b><font face="Helvetica, Arial" 14684 ><font color="#00B04F"><font size="+1"> 14685 <a href="GraphicsMagick.html#details-version">-version</a> 14686 </font></font></font></b></td></tr></table> 14687 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table> 14688 <p> 14689 For a more detailed description of each option, see 14690 Options, above. 14691 <br> <br> 14692 </td></tr></table> 14693 <p> 14694 <i><a href="#top">Back to Contents</a></i> 14695 </p> 14696 <br> <br> 14697 <table BORDER=0 WIDTH="100%"> 14698 <tr> 14699 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 14700 SRC="images/right_triangle.png" ALT=">" BORDER=0 14701 height=14 width=15><b><font face="Helvetica, Arial"><font 14702 color="#00B04F"><font size="+1"> 14703 <a NAME="import"></a>gm import 14704 </font></font></font></b></td></tr></table> 14705 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 14706 <tr><td width="3%"><br></td><td> 14707 <p> 14708 <strong>Import</strong> reads an image from any visible window on an X server and 14709 outputs it as an image file. You can capture a single window, the entire 14710 screen, or any rectangular portion of the screen. 14711 Use <em><a href="display.html">display</a></em> 14712 for redisplay, printing, editing, formatting, archiving, image processing, 14713 etc. of the captured image. 14714 <p> 14715 The target window can be specified by id, name, or may be selected 14716 by clicking the mouse in the desired window. If you press a button and 14717 then drag, a rectangle will form which expands and contracts as the mouse 14718 moves. To save the portion of the screen defined by the rectangle, just 14719 release the button. The keyboard bell is rung once at the beginning of 14720 the screen capture and twice when it completes. 14721 </td></tr></table> 14722 <p> 14723 <i><a href="#top">Back to Contents</a></i> 14724 </p> 14725 <table BORDER=0 WIDTH="100%"> 14726 <tr> 14727 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 14728 SRC="images/right_triangle.png" ALT=">" BORDER=0 14729 height=14 width=15><b><font face="Helvetica, Arial"><font 14730 color="#00B04F"><font size="+1"> 14731 <a NAME="imp-exam"></a>Examples 14732 </font></font></font></b></td></tr></table> 14733 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 14734 <tr><td width="3%"><br></td><td> 14735 <p> 14736 To select an X window or an area of the screen with the mouse and save it 14737 in the MIFF image format to a file entitled window.miff, use: 14738 <pre> 14739 gm import window.miff 14740 </pre> 14741 <p> 14742 To select an X window or an area of the screen with the mouse and save it 14743 in the Encapsulated PostScript format to include in another document, use: 14744 <pre> 14745 gm import figure.eps 14746 </pre> 14747 <p> 14748 To capture the entire X server screen in the JPEG image format in a file 14749 entitled root.jpeg, without using the mouse, use: 14750 <pre> 14751 gm import -window root root.jpeg 14752 </pre> 14753 <p> 14754 To capture the 512x256 area at the upper right corner of the X server 14755 screen in the PNG image format in a well-compressed file entitled corner.png, 14756 without using the mouse, use: 14757 <pre> 14758 gm import -window root -crop 512x256-0+0 -quality 90 14759 corner.png 14760 </pre> 14761 </td></tr></table> 14762 <p> 14763 <i><a href="#top">Back to Contents</a></i> 14764 </p> 14765 <table BORDER=0 WIDTH="100%"> 14766 <tr> 14767 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 14768 SRC="images/right_triangle.png" ALT=">" BORDER=0 14769 height=14 width=15><b><font face="Helvetica, Arial"><font 14770 color="#00B04F"><font size="+1"> 14771 <a NAME="imp-opti"></a>Options 14772 </font></font></font></b></td></tr></table> 14773 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 14774 <tr><td width="3%"><br></td><td> 14775 <p> 14776 Options are processed in command line order. Any option you specify on 14777 the command line remains in effect until it is explicitly changed by specifying 14778 the option again with a different effect. 14779 <p> 14780 <strong>Import</strong> options can appear on the command line or in your 14781 X resources file. See <em>X(1)</em>. Options on the command line supersede 14782 values specified in your X resources file. 14783 <p> 14784 For a more detailed description of each option, see 14785 Options, above. 14786 <br> <br> 14787 <table BORDER=0 WIDTH="94%"> 14788 <tr> 14789 <td width="3%"><br></td> 14790 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14791 <img SRC="images/right_triangle_option.png" 14792 ALT=">" BORDER=0 height=14 14793 width=15><b><font face="Helvetica, Arial" 14794 ><font color="#00B04F"><font size="+1"> 14795 <a href="GraphicsMagick.html#details-bordercolor">-bordercolor</a> <i><color></i> 14796 </font></font></font></b></td></tr></table> 14797 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border color</td></tr></table> 14798 <table BORDER=0 WIDTH="94%"> 14799 <tr> 14800 <td width="3%"><br></td> 14801 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14802 <img SRC="images/right_triangle_option.png" 14803 ALT=">" BORDER=0 height=14 14804 width=15><b><font face="Helvetica, Arial" 14805 ><font color="#00B04F"><font size="+1"> 14806 <a href="GraphicsMagick.html#details-colors">-colors</a> <i><value></i> 14807 </font></font></font></b></td></tr></table> 14808 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table> 14809 <table BORDER=0 WIDTH="94%"> 14810 <tr> 14811 <td width="3%"><br></td> 14812 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14813 <img SRC="images/right_triangle_option.png" 14814 ALT=">" BORDER=0 height=14 14815 width=15><b><font face="Helvetica, Arial" 14816 ><font color="#00B04F"><font size="+1"> 14817 <a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i><value></i> 14818 </font></font></font></b></td></tr></table> 14819 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table> 14820 <table BORDER=0 WIDTH="94%"> 14821 <tr> 14822 <td width="3%"><br></td> 14823 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14824 <img SRC="images/right_triangle_option.png" 14825 ALT=">" BORDER=0 height=14 14826 width=15><b><font face="Helvetica, Arial" 14827 ><font color="#00B04F"><font size="+1"> 14828 <a href="GraphicsMagick.html#details-comment">-comment</a> <i><string></i> 14829 </font></font></font></b></td></tr></table> 14830 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with a comment</td></tr></table> 14831 <table BORDER=0 WIDTH="94%"> 14832 <tr> 14833 <td width="3%"><br></td> 14834 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14835 <img SRC="images/right_triangle_option.png" 14836 ALT=">" BORDER=0 height=14 14837 width=15><b><font face="Helvetica, Arial" 14838 ><font color="#00B04F"><font size="+1"> 14839 <a href="GraphicsMagick.html#details-crop">-crop</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i> 14840 </font></font></font></b></td></tr></table> 14841 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the cropped image</td></tr></table> 14842 <table BORDER=0 WIDTH="94%"> 14843 <tr> 14844 <td width="3%"><br></td> 14845 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14846 <img SRC="images/right_triangle_option.png" 14847 ALT=">" BORDER=0 height=14 14848 width=15><b><font face="Helvetica, Arial" 14849 ><font color="#00B04F"><font size="+1"> 14850 -debug <i><events></i> 14851 </font></font></font></b></td></tr></table> 14852 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table> 14853 <table BORDER=0 WIDTH="94%"> 14854 <tr> 14855 <td width="3%"><br></td> 14856 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14857 <img SRC="images/right_triangle_option.png" 14858 ALT=">" BORDER=0 height=14 14859 width=15><b><font face="Helvetica, Arial" 14860 ><font color="#00B04F"><font size="+1"> 14861 <a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i> 14862 </font></font></font></b></td></tr></table> 14863 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table> 14864 <table BORDER=0 WIDTH="94%"> 14865 <tr> 14866 <td width="3%"><br></td> 14867 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14868 <img SRC="images/right_triangle_option.png" 14869 ALT=">" BORDER=0 height=14 14870 width=15><b><font face="Helvetica, Arial" 14871 ><font color="#00B04F"><font size="+1"> 14872 <a href="GraphicsMagick.html#details-delay">-delay</a> <i><1/100ths of a second></i> 14873 </font></font></font></b></td></tr></table> 14874 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the next image after pausing</td></tr></table> 14875 <table BORDER=0 WIDTH="94%"> 14876 <tr> 14877 <td width="3%"><br></td> 14878 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14879 <img SRC="images/right_triangle_option.png" 14880 ALT=">" BORDER=0 height=14 14881 width=15><b><font face="Helvetica, Arial" 14882 ><font color="#00B04F"><font size="+1"> 14883 <a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i> 14884 </font></font></font></b></td></tr></table> 14885 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table> 14886 <table BORDER=0 WIDTH="94%"> 14887 <tr> 14888 <td width="3%"><br></td> 14889 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14890 <img SRC="images/right_triangle_option.png" 14891 ALT=">" BORDER=0 height=14 14892 width=15><b><font face="Helvetica, Arial" 14893 ><font color="#00B04F"><font size="+1"> 14894 <a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i> 14895 </font></font></font></b></td></tr></table> 14896 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table> 14897 <table BORDER=0 WIDTH="94%"> 14898 <tr> 14899 <td width="3%"><br></td> 14900 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14901 <img SRC="images/right_triangle_option.png" 14902 ALT=">" BORDER=0 height=14 14903 width=15><b><font face="Helvetica, Arial" 14904 ><font color="#00B04F"><font size="+1"> 14905 -descend 14906 </font></font></font></b></td></tr></table> 14907 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>obtain image by descending window hierarchy</td></tr></table> 14908 <table BORDER=0 WIDTH="94%"> 14909 <tr> 14910 <td width="3%"><br></td> 14911 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14912 <img SRC="images/right_triangle_option.png" 14913 ALT=">" BORDER=0 height=14 14914 width=15><b><font face="Helvetica, Arial" 14915 ><font color="#00B04F"><font size="+1"> 14916 <a href="GraphicsMagick.html#details-display">-display</a> <i><host:display[.screen]></i> 14917 </font></font></font></b></td></tr></table> 14918 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table> 14919 <table BORDER=0 WIDTH="94%"> 14920 <tr> 14921 <td width="3%"><br></td> 14922 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14923 <img SRC="images/right_triangle_option.png" 14924 ALT=">" BORDER=0 height=14 14925 width=15><b><font face="Helvetica, Arial" 14926 ><font color="#00B04F"><font size="+1"> 14927 <a href="GraphicsMagick.html#details-dispose">-dispose</a> <i><method></i> 14928 </font></font></font></b></td></tr></table> 14929 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table> 14930 <table BORDER=0 WIDTH="94%"> 14931 <tr> 14932 <td width="3%"><br></td> 14933 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14934 <img SRC="images/right_triangle_option.png" 14935 ALT=">" BORDER=0 height=14 14936 width=15><b><font face="Helvetica, Arial" 14937 ><font color="#00B04F"><font size="+1"> 14938 <a href="GraphicsMagick.html#details-dither">-dither</a> 14939 </font></font></font></b></td></tr></table> 14940 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table> 14941 <table BORDER=0 WIDTH="94%"> 14942 <tr> 14943 <td width="3%"><br></td> 14944 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14945 <img SRC="images/right_triangle_option.png" 14946 ALT=">" BORDER=0 height=14 14947 width=15><b><font face="Helvetica, Arial" 14948 ><font color="#00B04F"><font size="+1"> 14949 <a href="GraphicsMagick.html#details-encoding">-encoding</a> <i><type></i> 14950 </font></font></font></b></td></tr></table> 14951 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the text encoding</td></tr></table> 14952 <table BORDER=0 WIDTH="94%"> 14953 <tr> 14954 <td width="3%"><br></td> 14955 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14956 <img SRC="images/right_triangle_option.png" 14957 ALT=">" BORDER=0 height=14 14958 width=15><b><font face="Helvetica, Arial" 14959 ><font color="#00B04F"><font size="+1"> 14960 <a href="GraphicsMagick.html#details-endian">-endian</a> <i><type></i> 14961 </font></font></font></b></td></tr></table> 14962 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify endianness (MSB, LSB, or Native) of image</td></tr></table> 14963 <table BORDER=0 WIDTH="94%"> 14964 <tr> 14965 <td width="3%"><br></td> 14966 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14967 <img SRC="images/right_triangle_option.png" 14968 ALT=">" BORDER=0 height=14 14969 width=15><b><font face="Helvetica, Arial" 14970 ><font color="#00B04F"><font size="+1"> 14971 -frame 14972 </font></font></font></b></td></tr></table> 14973 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>include the X window frame in the imported image</td></tr></table> 14974 <table BORDER=0 WIDTH="94%"> 14975 <tr> 14976 <td width="3%"><br></td> 14977 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14978 <img SRC="images/right_triangle_option.png" 14979 ALT=">" BORDER=0 height=14 14980 width=15><b><font face="Helvetica, Arial" 14981 ><font color="#00B04F"><font size="+1"> 14982 <a href="GraphicsMagick.html#details-geometry">-geometry</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i>^</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 14983 </font></font></font></b></td></tr></table> 14984 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify dimension, offset, and resize options.</td></tr></table> 14985 <table BORDER=0 WIDTH="94%"> 14986 <tr> 14987 <td width="3%"><br></td> 14988 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 14989 <img SRC="images/right_triangle_option.png" 14990 ALT=">" BORDER=0 height=14 14991 width=15><b><font face="Helvetica, Arial" 14992 ><font color="#00B04F"><font size="+1"> 14993 -help 14994 </font></font></font></b></td></tr></table> 14995 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table> 14996 <table BORDER=0 WIDTH="94%"> 14997 <tr> 14998 <td width="3%"><br></td> 14999 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15000 <img SRC="images/right_triangle_option.png" 15001 ALT=">" BORDER=0 height=14 15002 width=15><b><font face="Helvetica, Arial" 15003 ><font color="#00B04F"><font size="+1"> 15004 <a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i> 15005 </font></font></font></b></td></tr></table> 15006 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table> 15007 <table BORDER=0 WIDTH="94%"> 15008 <tr> 15009 <td width="3%"><br></td> 15010 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15011 <img SRC="images/right_triangle_option.png" 15012 ALT=">" BORDER=0 height=14 15013 width=15><b><font face="Helvetica, Arial" 15014 ><font color="#00B04F"><font size="+1"> 15015 <a href="GraphicsMagick.html#details-label">-label</a> <i><name></i> 15016 </font></font></font></b></td></tr></table> 15017 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign a label to an image</td></tr></table> 15018 <table BORDER=0 WIDTH="94%"> 15019 <tr> 15020 <td width="3%"><br></td> 15021 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15022 <img SRC="images/right_triangle_option.png" 15023 ALT=">" BORDER=0 height=14 15024 width=15><b><font face="Helvetica, Arial" 15025 ><font color="#00B04F"><font size="+1"> 15026 <a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i> 15027 </font></font></font></b></td></tr></table> 15028 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table> 15029 <table BORDER=0 WIDTH="94%"> 15030 <tr> 15031 <td width="3%"><br></td> 15032 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15033 <img SRC="images/right_triangle_option.png" 15034 ALT=">" BORDER=0 height=14 15035 width=15><b><font face="Helvetica, Arial" 15036 ><font color="#00B04F"><font size="+1"> 15037 <a href="GraphicsMagick.html#details-log">-log</a> <i><string></i> 15038 </font></font></font></b></td></tr></table> 15039 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table> 15040 <table BORDER=0 WIDTH="94%"> 15041 <tr> 15042 <td width="3%"><br></td> 15043 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15044 <img SRC="images/right_triangle_option.png" 15045 ALT=">" BORDER=0 height=14 15046 width=15><b><font face="Helvetica, Arial" 15047 ><font color="#00B04F"><font size="+1"> 15048 -monitor 15049 </font></font></font></b></td></tr></table> 15050 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>show progress indication</td></tr></table> 15051 <table BORDER=0 WIDTH="94%"> 15052 <tr> 15053 <td width="3%"><br></td> 15054 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15055 <img SRC="images/right_triangle_option.png" 15056 ALT=">" BORDER=0 height=14 15057 width=15><b><font face="Helvetica, Arial" 15058 ><font color="#00B04F"><font size="+1"> 15059 -monochrome 15060 </font></font></font></b></td></tr></table> 15061 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table> 15062 <table BORDER=0 WIDTH="94%"> 15063 <tr> 15064 <td width="3%"><br></td> 15065 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15066 <img SRC="images/right_triangle_option.png" 15067 ALT=">" BORDER=0 height=14 15068 width=15><b><font face="Helvetica, Arial" 15069 ><font color="#00B04F"><font size="+1"> 15070 <a href="GraphicsMagick.html#details-negate">-negate</a> 15071 </font></font></font></b></td></tr></table> 15072 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>replace every pixel with its complementary color</td></tr></table> 15073 <table BORDER=0 WIDTH="94%"> 15074 <tr> 15075 <td width="3%"><br></td> 15076 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15077 <img SRC="images/right_triangle_option.png" 15078 ALT=">" BORDER=0 height=14 15079 width=15><b><font face="Helvetica, Arial" 15080 ><font color="#00B04F"><font size="+1"> 15081 <a href="GraphicsMagick.html#details-page">-page</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 15082 </font></font></font></b></td></tr></table> 15083 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>size and location of an image canvas</td></tr></table> 15084 <table BORDER=0 WIDTH="94%"> 15085 <tr> 15086 <td width="3%"><br></td> 15087 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15088 <img SRC="images/right_triangle_option.png" 15089 ALT=">" BORDER=0 height=14 15090 width=15><b><font face="Helvetica, Arial" 15091 ><font color="#00B04F"><font size="+1"> 15092 <a href="GraphicsMagick.html#details-pause">-pause</a> <i><seconds></i> 15093 </font></font></font></b></td></tr></table> 15094 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pause between snapshots [import]</td></tr></table> 15095 <table BORDER=0 WIDTH="94%"> 15096 <tr> 15097 <td width="3%"><br></td> 15098 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15099 <img SRC="images/right_triangle_option.png" 15100 ALT=">" BORDER=0 height=14 15101 width=15><b><font face="Helvetica, Arial" 15102 ><font color="#00B04F"><font size="+1"> 15103 -ping 15104 </font></font></font></b></td></tr></table> 15105 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>efficiently determine image characteristics</td></tr></table> 15106 <table BORDER=0 WIDTH="94%"> 15107 <tr> 15108 <td width="3%"><br></td> 15109 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15110 <img SRC="images/right_triangle_option.png" 15111 ALT=">" BORDER=0 height=14 15112 width=15><b><font face="Helvetica, Arial" 15113 ><font color="#00B04F"><font size="+1"> 15114 -pointsize <i><value></i> 15115 </font></font></font></b></td></tr></table> 15116 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pointsize of the PostScript, X11, or TrueType font</td></tr></table> 15117 <table BORDER=0 WIDTH="94%"> 15118 <tr> 15119 <td width="3%"><br></td> 15120 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15121 <img SRC="images/right_triangle_option.png" 15122 ALT=">" BORDER=0 height=14 15123 width=15><b><font face="Helvetica, Arial" 15124 ><font color="#00B04F"><font size="+1"> 15125 <a href="GraphicsMagick.html#details-quality">-quality</a> <i><value></i> 15126 </font></font></font></b></td></tr></table> 15127 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>JPEG/MIFF/PNG/TIFF compression level</td></tr></table> 15128 <table BORDER=0 WIDTH="94%"> 15129 <tr> 15130 <td width="3%"><br></td> 15131 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15132 <img SRC="images/right_triangle_option.png" 15133 ALT=">" BORDER=0 height=14 15134 width=15><b><font face="Helvetica, Arial" 15135 ><font color="#00B04F"><font size="+1"> 15136 <a href="GraphicsMagick.html#details-resize">-resize</a> <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 15137 </font></font></font></b></td></tr></table> 15138 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image</td></tr></table> 15139 <table BORDER=0 WIDTH="94%"> 15140 <tr> 15141 <td width="3%"><br></td> 15142 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15143 <img SRC="images/right_triangle_option.png" 15144 ALT=">" BORDER=0 height=14 15145 width=15><b><font face="Helvetica, Arial" 15146 ><font color="#00B04F"><font size="+1"> 15147 <a href="GraphicsMagick.html#details-rotate">-rotate</a> <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 15148 </font></font></font></b></td></tr></table> 15149 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>rotate the image</td></tr></table> 15150 <table BORDER=0 WIDTH="94%"> 15151 <tr> 15152 <td width="3%"><br></td> 15153 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15154 <img SRC="images/right_triangle_option.png" 15155 ALT=">" BORDER=0 height=14 15156 width=15><b><font face="Helvetica, Arial" 15157 ><font color="#00B04F"><font size="+1"> 15158 <a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i> 15159 </font></font></font></b></td></tr></table> 15160 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chroma subsampling factors</td></tr></table> 15161 <table BORDER=0 WIDTH="94%"> 15162 <tr> 15163 <td width="3%"><br></td> 15164 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15165 <img SRC="images/right_triangle_option.png" 15166 ALT=">" BORDER=0 height=14 15167 width=15><b><font face="Helvetica, Arial" 15168 ><font color="#00B04F"><font size="+1"> 15169 <a href="GraphicsMagick.html#details-scene">-scene</a> <i><value></i> 15170 </font></font></font></b></td></tr></table> 15171 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set scene number</td></tr></table> 15172 <table BORDER=0 WIDTH="94%"> 15173 <tr> 15174 <td width="3%"><br></td> 15175 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15176 <img SRC="images/right_triangle_option.png" 15177 ALT=">" BORDER=0 height=14 15178 width=15><b><font face="Helvetica, Arial" 15179 ><font color="#00B04F"><font size="+1"> 15180 <a href="GraphicsMagick.html#details-screen">-screen</a> 15181 </font></font></font></b></td></tr></table> 15182 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the screen to capture</td></tr></table> 15183 <table BORDER=0 WIDTH="94%"> 15184 <tr> 15185 <td width="3%"><br></td> 15186 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15187 <img SRC="images/right_triangle_option.png" 15188 ALT=">" BORDER=0 height=14 15189 width=15><b><font face="Helvetica, Arial" 15190 ><font color="#00B04F"><font size="+1"> 15191 <a href="GraphicsMagick.html#details-set">-set</a> <i><attribute> <value></i> 15192 </font></font></font></b></td></tr></table> 15193 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set an image attribute</td></tr></table> 15194 <table BORDER=0 WIDTH="94%"> 15195 <tr> 15196 <td width="3%"><br></td> 15197 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15198 <img SRC="images/right_triangle_option.png" 15199 ALT=">" BORDER=0 height=14 15200 width=15><b><font face="Helvetica, Arial" 15201 ><font color="#00B04F"><font size="+1"> 15202 <a href="GraphicsMagick.html#details+set">+set</a> <i><attribute></i> 15203 </font></font></font></b></td></tr></table> 15204 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>unset an image attribute</td></tr></table> 15205 <table BORDER=0 WIDTH="94%"> 15206 <tr> 15207 <td width="3%"><br></td> 15208 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15209 <img SRC="images/right_triangle_option.png" 15210 ALT=">" BORDER=0 height=14 15211 width=15><b><font face="Helvetica, Arial" 15212 ><font color="#00B04F"><font size="+1"> 15213 -silent 15214 </font></font></font></b></td></tr></table> 15215 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>operate silently</td></tr></table> 15216 <table BORDER=0 WIDTH="94%"> 15217 <tr> 15218 <td width="3%"><br></td> 15219 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15220 <img SRC="images/right_triangle_option.png" 15221 ALT=">" BORDER=0 height=14 15222 width=15><b><font face="Helvetica, Arial" 15223 ><font color="#00B04F"><font size="+1"> 15224 <a href="GraphicsMagick.html#details-snaps">-snaps</a> <i><value></i> 15225 </font></font></font></b></td></tr></table> 15226 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>number of screen snapshots</td></tr></table> 15227 <table BORDER=0 WIDTH="94%"> 15228 <tr> 15229 <td width="3%"><br></td> 15230 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15231 <img SRC="images/right_triangle_option.png" 15232 ALT=">" BORDER=0 height=14 15233 width=15><b><font face="Helvetica, Arial" 15234 ><font color="#00B04F"><font size="+1"> 15235 <a href="GraphicsMagick.html#details-thumbnail">-thumbnail</a> <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 15236 </font></font></font></b></td></tr></table> 15237 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image (quickly)</td></tr></table> 15238 <table BORDER=0 WIDTH="94%"> 15239 <tr> 15240 <td width="3%"><br></td> 15241 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15242 <img SRC="images/right_triangle_option.png" 15243 ALT=">" BORDER=0 height=14 15244 width=15><b><font face="Helvetica, Arial" 15245 ><font color="#00B04F"><font size="+1"> 15246 <a href="GraphicsMagick.html#details-transparent">-transparent</a> <i><color></i> 15247 </font></font></font></b></td></tr></table> 15248 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make this color transparent within the image</td></tr></table> 15249 <table BORDER=0 WIDTH="94%"> 15250 <tr> 15251 <td width="3%"><br></td> 15252 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15253 <img SRC="images/right_triangle_option.png" 15254 ALT=">" BORDER=0 height=14 15255 width=15><b><font face="Helvetica, Arial" 15256 ><font color="#00B04F"><font size="+1"> 15257 <a href="GraphicsMagick.html#details-trim">-trim</a> 15258 </font></font></font></b></td></tr></table> 15259 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table> 15260 <table BORDER=0 WIDTH="94%"> 15261 <tr> 15262 <td width="3%"><br></td> 15263 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15264 <img SRC="images/right_triangle_option.png" 15265 ALT=">" BORDER=0 height=14 15266 width=15><b><font face="Helvetica, Arial" 15267 ><font color="#00B04F"><font size="+1"> 15268 <a href="GraphicsMagick.html#details-verbose">-verbose</a> 15269 </font></font></font></b></td></tr></table> 15270 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table> 15271 <table BORDER=0 WIDTH="94%"> 15272 <tr> 15273 <td width="3%"><br></td> 15274 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15275 <img SRC="images/right_triangle_option.png" 15276 ALT=">" BORDER=0 height=14 15277 width=15><b><font face="Helvetica, Arial" 15278 ><font color="#00B04F"><font size="+1"> 15279 <a href="GraphicsMagick.html#details-version">-version</a> 15280 </font></font></font></b></td></tr></table> 15281 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table> 15282 <p> 15283 For a more detailed description of each option, see 15284 Options, above. 15285 <br> <br> 15286 </td></tr></table> 15287 <br> <br> 15288 <table BORDER=0 WIDTH="100%"> 15289 <tr> 15290 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 15291 SRC="images/right_triangle.png" ALT=">" BORDER=0 15292 height=14 width=15><b><font face="Helvetica, Arial"><font 15293 color="#00B04F"><font size="+1"> 15294 <a NAME="mogrify"></a>gm mogrify 15295 </font></font></font></b></td></tr></table> 15296 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 15297 <tr><td width="3%"><br></td><td> 15298 <p> 15299 <strong>Mogrify</strong> transforms an image or a sequence of images. These transforms 15300 include image scaling, image rotation, color reduction, and others. Each 15301 transmogrified image overwrites the corresponding original image, unless an 15302 option such as 15303 <strong>-format</strong> causes the output filename to be different from the input 15304 filename. 15305 <br> <br> 15306 The graphics formats supported by <strong>mogrify</strong> are listed in 15307 <em>GraphicsMagick(1)</em>. 15308 </td></tr></table> 15309 <p> 15310 <i><a href="#top">Back to Contents</a></i> 15311 </p> 15312 <table BORDER=0 WIDTH="100%"> 15313 <tr> 15314 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 15315 SRC="images/right_triangle.png" ALT=">" BORDER=0 15316 height=14 width=15><b><font face="Helvetica, Arial"><font 15317 color="#00B04F"><font size="+1"> 15318 <a NAME="mog-exam"></a>Examples 15319 </font></font></font></b></td></tr></table> 15320 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 15321 <tr><td width="3%"><br></td><td> 15322 <p> 15323 To convert all the TIFF files in a particular directory to JPEG, use: 15324 <pre> 15325 gm mogrify -format jpeg *.tiff 15326 </pre> 15327 <p> 15328 To convert a directory full of JPEG images to thumbnails, use: 15329 <pre> 15330 gm mogrify -size 120x120 *.jpg -resize 120x120 +profile "*" 15331 </pre> 15332 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 15333 In this example, <tt>'-size 120x120'</tt> gives a hint to the JPEG decoder 15334 that the images are going to be downscaled to 120x120, allowing it to run 15335 faster by avoiding returning full-resolution images to GraphicsMagick for 15336 the subsequent resizing operation. The 15337 <tt>'-resize 120x120'</tt> specifies the desired dimensions of the 15338 output images. It will be scaled so its largest dimension is 120 pixels. The 15339 <tt>'+profile "*"'</tt> removes any ICM, EXIF, IPTC, or other profiles 15340 that might be present in the input and aren't needed in the thumbnails.</font></td></tr></table> 15341 <p> 15342 To scale an image of a cockatoo to exactly 640 pixels in width and 480 15343 pixels in height, use: 15344 <pre> 15345 gm mogrify -resize 640x480! cockatoo.miff 15346 </pre> 15347 </td></tr></table> 15348 <p> 15349 <i><a href="#top">Back to Contents</a></i> 15350 </p> 15351 <table BORDER=0 WIDTH="100%"> 15352 <tr> 15353 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 15354 SRC="images/right_triangle.png" ALT=">" BORDER=0 15355 height=14 width=15><b><font face="Helvetica, Arial"><font 15356 color="#00B04F"><font size="+1"> 15357 <a NAME="mog-opti"></a>Options 15358 </font></font></font></b></td></tr></table> 15359 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 15360 <tr><td width="3%"><br></td><td> 15361 <p> 15362 Options are processed in command line order. Any option you specify on 15363 the command line remains in effect for the set of images that follows, 15364 until the set is terminated by the appearance of any option or <strong>-noop</strong>. 15365 <p> 15366 For a more detailed description of each option, see 15367 Options, above. 15368 <br> <br> 15369 <table BORDER=0 WIDTH="94%"> 15370 <tr> 15371 <td width="3%"><br></td> 15372 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15373 <img SRC="images/right_triangle_option.png" 15374 ALT=">" BORDER=0 height=14 15375 width=15><b><font face="Helvetica, Arial" 15376 ><font color="#00B04F"><font size="+1"> 15377 <a href="GraphicsMagick.html#details-affine">-affine</a> <i><matrix></i> 15378 </font></font></font></b></td></tr></table> 15379 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>drawing transform matrix</td></tr></table> 15380 <table BORDER=0 WIDTH="94%"> 15381 <tr> 15382 <td width="3%"><br></td> 15383 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15384 <img SRC="images/right_triangle_option.png" 15385 ALT=">" BORDER=0 height=14 15386 width=15><b><font face="Helvetica, Arial" 15387 ><font color="#00B04F"><font size="+1"> 15388 <a href="GraphicsMagick.html#details-antialias">-antialias</a> 15389 </font></font></font></b></td></tr></table> 15390 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove pixel aliasing</td></tr></table> 15391 <table BORDER=0 WIDTH="94%"> 15392 <tr> 15393 <td width="3%"><br></td> 15394 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15395 <img SRC="images/right_triangle_option.png" 15396 ALT=">" BORDER=0 height=14 15397 width=15><b><font face="Helvetica, Arial" 15398 ><font color="#00B04F"><font size="+1"> 15399 <a href="GraphicsMagick.html#details"></a> <i>-asc-cdl <spec></i> 15400 </font></font></font></b></td></tr></table> 15401 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply ASC CDL color transform</td></tr></table> 15402 <table BORDER=0 WIDTH="94%"> 15403 <tr> 15404 <td width="3%"><br></td> 15405 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15406 <img SRC="images/right_triangle_option.png" 15407 ALT=">" BORDER=0 height=14 15408 width=15><b><font face="Helvetica, Arial" 15409 ><font color="#00B04F"><font size="+1"> 15410 <a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i><string></i> 15411 </font></font></font></b></td></tr></table> 15412 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table> 15413 <table BORDER=0 WIDTH="94%"> 15414 <tr> 15415 <td width="3%"><br></td> 15416 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15417 <img SRC="images/right_triangle_option.png" 15418 ALT=">" BORDER=0 height=14 15419 width=15><b><font face="Helvetica, Arial" 15420 ><font color="#00B04F"><font size="+1"> 15421 <a href="GraphicsMagick.html#details-auto-orient">-auto-orient</a> 15422 </font></font></font></b></td></tr></table> 15423 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>orient (rotate) image so it is upright</td></tr></table> 15424 <table BORDER=0 WIDTH="94%"> 15425 <tr> 15426 <td width="3%"><br></td> 15427 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15428 <img SRC="images/right_triangle_option.png" 15429 ALT=">" BORDER=0 height=14 15430 width=15><b><font face="Helvetica, Arial" 15431 ><font color="#00B04F"><font size="+1"> 15432 <a href="GraphicsMagick.html#details-background">-background</a> <i><color></i> 15433 </font></font></font></b></td></tr></table> 15434 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the background color</td></tr></table> 15435 <table BORDER=0 WIDTH="94%"> 15436 <tr> 15437 <td width="3%"><br></td> 15438 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15439 <img SRC="images/right_triangle_option.png" 15440 ALT=">" BORDER=0 height=14 15441 width=15><b><font face="Helvetica, Arial" 15442 ><font color="#00B04F"><font size="+1"> 15443 <a href="GraphicsMagick.html#details-black-threshold">-black-threshold</a> <i>red[,green][,blue][,opacity]</i> 15444 </font></font></font></b></td></tr></table> 15445 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pixels below the threshold become black</td></tr></table> 15446 <table BORDER=0 WIDTH="94%"> 15447 <tr> 15448 <td width="3%"><br></td> 15449 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15450 <img SRC="images/right_triangle_option.png" 15451 ALT=">" BORDER=0 height=14 15452 width=15><b><font face="Helvetica, Arial" 15453 ><font color="#00B04F"><font size="+1"> 15454 <a href="GraphicsMagick.html#details-blue-primary">-blue-primary</a> <i><x>,<y></i> 15455 </font></font></font></b></td></tr></table> 15456 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blue chromaticity primary point</td></tr></table> 15457 <table BORDER=0 WIDTH="94%"> 15458 <tr> 15459 <td width="3%"><br></td> 15460 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15461 <img SRC="images/right_triangle_option.png" 15462 ALT=">" BORDER=0 height=14 15463 width=15><b><font face="Helvetica, Arial" 15464 ><font color="#00B04F"><font size="+1"> 15465 <a href="GraphicsMagick.html#details-blur">-blur</a> <i><radius></i>{<i>x<sigma></i>}<i></i> 15466 </font></font></font></b></td></tr></table> 15467 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blur the image with a Gaussian operator</td></tr></table> 15468 <table BORDER=0 WIDTH="94%"> 15469 <tr> 15470 <td width="3%"><br></td> 15471 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15472 <img SRC="images/right_triangle_option.png" 15473 ALT=">" BORDER=0 height=14 15474 width=15><b><font face="Helvetica, Arial" 15475 ><font color="#00B04F"><font size="+1"> 15476 <a href="GraphicsMagick.html#details-border">-border</a> <i><width>x<height></i> 15477 </font></font></font></b></td></tr></table> 15478 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with a border of color</td></tr></table> 15479 <table BORDER=0 WIDTH="94%"> 15480 <tr> 15481 <td width="3%"><br></td> 15482 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15483 <img SRC="images/right_triangle_option.png" 15484 ALT=">" BORDER=0 height=14 15485 width=15><b><font face="Helvetica, Arial" 15486 ><font color="#00B04F"><font size="+1"> 15487 <a href="GraphicsMagick.html#details-bordercolor">-bordercolor</a> <i><color></i> 15488 </font></font></font></b></td></tr></table> 15489 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border color</td></tr></table> 15490 <table BORDER=0 WIDTH="94%"> 15491 <tr> 15492 <td width="3%"><br></td> 15493 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15494 <img SRC="images/right_triangle_option.png" 15495 ALT=">" BORDER=0 height=14 15496 width=15><b><font face="Helvetica, Arial" 15497 ><font color="#00B04F"><font size="+1"> 15498 <a href="GraphicsMagick.html#details-channel">-channel</a> <i><type></i> 15499 </font></font></font></b></td></tr></table> 15500 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of channel</td></tr></table> 15501 <table BORDER=0 WIDTH="94%"> 15502 <tr> 15503 <td width="3%"><br></td> 15504 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15505 <img SRC="images/right_triangle_option.png" 15506 ALT=">" BORDER=0 height=14 15507 width=15><b><font face="Helvetica, Arial" 15508 ><font color="#00B04F"><font size="+1"> 15509 -charcoal <i><factor></i> 15510 </font></font></font></b></td></tr></table> 15511 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>simulate a charcoal drawing</td></tr></table> 15512 <table BORDER=0 WIDTH="94%"> 15513 <tr> 15514 <td width="3%"><br></td> 15515 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15516 <img SRC="images/right_triangle_option.png" 15517 ALT=">" BORDER=0 height=14 15518 width=15><b><font face="Helvetica, Arial" 15519 ><font color="#00B04F"><font size="+1"> 15520 <a href="GraphicsMagick.html#details-colorize">-colorize</a> <i><value></i> 15521 </font></font></font></b></td></tr></table> 15522 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>colorize the image with the pen color</td></tr></table> 15523 <table BORDER=0 WIDTH="94%"> 15524 <tr> 15525 <td width="3%"><br></td> 15526 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15527 <img SRC="images/right_triangle_option.png" 15528 ALT=">" BORDER=0 height=14 15529 width=15><b><font face="Helvetica, Arial" 15530 ><font color="#00B04F"><font size="+1"> 15531 <a href="GraphicsMagick.html#details-colors">-colors</a> <i><value></i> 15532 </font></font></font></b></td></tr></table> 15533 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table> 15534 <table BORDER=0 WIDTH="94%"> 15535 <tr> 15536 <td width="3%"><br></td> 15537 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15538 <img SRC="images/right_triangle_option.png" 15539 ALT=">" BORDER=0 height=14 15540 width=15><b><font face="Helvetica, Arial" 15541 ><font color="#00B04F"><font size="+1"> 15542 <a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i><value></i> 15543 </font></font></font></b></td></tr></table> 15544 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table> 15545 <table BORDER=0 WIDTH="94%"> 15546 <tr> 15547 <td width="3%"><br></td> 15548 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15549 <img SRC="images/right_triangle_option.png" 15550 ALT=">" BORDER=0 height=14 15551 width=15><b><font face="Helvetica, Arial" 15552 ><font color="#00B04F"><font size="+1"> 15553 <a href="GraphicsMagick.html#details-comment">-comment</a> <i><string></i> 15554 </font></font></font></b></td></tr></table> 15555 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with a comment</td></tr></table> 15556 <table BORDER=0 WIDTH="94%"> 15557 <tr> 15558 <td width="3%"><br></td> 15559 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15560 <img SRC="images/right_triangle_option.png" 15561 ALT=">" BORDER=0 height=14 15562 width=15><b><font face="Helvetica, Arial" 15563 ><font color="#00B04F"><font size="+1"> 15564 <a href="GraphicsMagick.html#details-compose">-compose</a> <i><operator></i> 15565 </font></font></font></b></td></tr></table> 15566 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image composition</td></tr></table> 15567 <table BORDER=0 WIDTH="94%"> 15568 <tr> 15569 <td width="3%"><br></td> 15570 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15571 <img SRC="images/right_triangle_option.png" 15572 ALT=">" BORDER=0 height=14 15573 width=15><b><font face="Helvetica, Arial" 15574 ><font color="#00B04F"><font size="+1"> 15575 <a href="GraphicsMagick.html#details-compress">-compress</a> <i><type></i> 15576 </font></font></font></b></td></tr></table> 15577 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image compression</td></tr></table> 15578 <table BORDER=0 WIDTH="94%"> 15579 <tr> 15580 <td width="3%"><br></td> 15581 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15582 <img SRC="images/right_triangle_option.png" 15583 ALT=">" BORDER=0 height=14 15584 width=15><b><font face="Helvetica, Arial" 15585 ><font color="#00B04F"><font size="+1"> 15586 <a href="GraphicsMagick.html#details-contrast">-contrast</a> 15587 </font></font></font></b></td></tr></table> 15588 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enhance or reduce the image contrast</td></tr></table> 15589 <table BORDER=0 WIDTH="94%"> 15590 <tr> 15591 <td width="3%"><br></td> 15592 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15593 <img SRC="images/right_triangle_option.png" 15594 ALT=">" BORDER=0 height=14 15595 width=15><b><font face="Helvetica, Arial" 15596 ><font color="#00B04F"><font size="+1"> 15597 <a href="GraphicsMagick.html#details-convolve">-convolve</a> <i><kernel></i> 15598 </font></font></font></b></td></tr></table> 15599 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>convolve image with the specified convolution kernel</td></tr></table> 15600 <table BORDER=0 WIDTH="94%"> 15601 <tr> 15602 <td width="3%"><br></td> 15603 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15604 <img SRC="images/right_triangle_option.png" 15605 ALT=">" BORDER=0 height=14 15606 width=15><b><font face="Helvetica, Arial" 15607 ><font color="#00B04F"><font size="+1"> 15608 <a href="GraphicsMagick.html#details-create-directories">-create-directories</a> 15609 </font></font></font></b></td></tr></table> 15610 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create output directory if required</td></tr></table> 15611 <table BORDER=0 WIDTH="94%"> 15612 <tr> 15613 <td width="3%"><br></td> 15614 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15615 <img SRC="images/right_triangle_option.png" 15616 ALT=">" BORDER=0 height=14 15617 width=15><b><font face="Helvetica, Arial" 15618 ><font color="#00B04F"><font size="+1"> 15619 <a href="GraphicsMagick.html#details-crop">-crop</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i> 15620 </font></font></font></b></td></tr></table> 15621 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the cropped image</td></tr></table> 15622 <table BORDER=0 WIDTH="94%"> 15623 <tr> 15624 <td width="3%"><br></td> 15625 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15626 <img SRC="images/right_triangle_option.png" 15627 ALT=">" BORDER=0 height=14 15628 width=15><b><font face="Helvetica, Arial" 15629 ><font color="#00B04F"><font size="+1"> 15630 <a href="GraphicsMagick.html#details-cycle">-cycle</a> <i><amount></i> 15631 </font></font></font></b></td></tr></table> 15632 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>displace image colormap by amount</td></tr></table> 15633 <table BORDER=0 WIDTH="94%"> 15634 <tr> 15635 <td width="3%"><br></td> 15636 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15637 <img SRC="images/right_triangle_option.png" 15638 ALT=">" BORDER=0 height=14 15639 width=15><b><font face="Helvetica, Arial" 15640 ><font color="#00B04F"><font size="+1"> 15641 -debug <i><events></i> 15642 </font></font></font></b></td></tr></table> 15643 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table> 15644 <table BORDER=0 WIDTH="94%"> 15645 <tr> 15646 <td width="3%"><br></td> 15647 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15648 <img SRC="images/right_triangle_option.png" 15649 ALT=">" BORDER=0 height=14 15650 width=15><b><font face="Helvetica, Arial" 15651 ><font color="#00B04F"><font size="+1"> 15652 <a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i> 15653 </font></font></font></b></td></tr></table> 15654 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table> 15655 <table BORDER=0 WIDTH="94%"> 15656 <tr> 15657 <td width="3%"><br></td> 15658 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15659 <img SRC="images/right_triangle_option.png" 15660 ALT=">" BORDER=0 height=14 15661 width=15><b><font face="Helvetica, Arial" 15662 ><font color="#00B04F"><font size="+1"> 15663 <a href="GraphicsMagick.html#details-delay">-delay</a> <i><1/100ths of a second></i> 15664 </font></font></font></b></td></tr></table> 15665 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the next image after pausing</td></tr></table> 15666 <table BORDER=0 WIDTH="94%"> 15667 <tr> 15668 <td width="3%"><br></td> 15669 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15670 <img SRC="images/right_triangle_option.png" 15671 ALT=">" BORDER=0 height=14 15672 width=15><b><font face="Helvetica, Arial" 15673 ><font color="#00B04F"><font size="+1"> 15674 <a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i> 15675 </font></font></font></b></td></tr></table> 15676 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table> 15677 <table BORDER=0 WIDTH="94%"> 15678 <tr> 15679 <td width="3%"><br></td> 15680 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15681 <img SRC="images/right_triangle_option.png" 15682 ALT=">" BORDER=0 height=14 15683 width=15><b><font face="Helvetica, Arial" 15684 ><font color="#00B04F"><font size="+1"> 15685 <a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i> 15686 </font></font></font></b></td></tr></table> 15687 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table> 15688 <table BORDER=0 WIDTH="94%"> 15689 <tr> 15690 <td width="3%"><br></td> 15691 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15692 <img SRC="images/right_triangle_option.png" 15693 ALT=">" BORDER=0 height=14 15694 width=15><b><font face="Helvetica, Arial" 15695 ><font color="#00B04F"><font size="+1"> 15696 -despeckle 15697 </font></font></font></b></td></tr></table> 15698 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>reduce the speckles within an image</td></tr></table> 15699 <table BORDER=0 WIDTH="94%"> 15700 <tr> 15701 <td width="3%"><br></td> 15702 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15703 <img SRC="images/right_triangle_option.png" 15704 ALT=">" BORDER=0 height=14 15705 width=15><b><font face="Helvetica, Arial" 15706 ><font color="#00B04F"><font size="+1"> 15707 <a href="GraphicsMagick.html#details-display">-display</a> <i><host:display[.screen]></i> 15708 </font></font></font></b></td></tr></table> 15709 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table> 15710 <table BORDER=0 WIDTH="94%"> 15711 <tr> 15712 <td width="3%"><br></td> 15713 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15714 <img SRC="images/right_triangle_option.png" 15715 ALT=">" BORDER=0 height=14 15716 width=15><b><font face="Helvetica, Arial" 15717 ><font color="#00B04F"><font size="+1"> 15718 <a href="GraphicsMagick.html#details-dispose">-dispose</a> <i><method></i> 15719 </font></font></font></b></td></tr></table> 15720 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table> 15721 <table BORDER=0 WIDTH="94%"> 15722 <tr> 15723 <td width="3%"><br></td> 15724 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15725 <img SRC="images/right_triangle_option.png" 15726 ALT=">" BORDER=0 height=14 15727 width=15><b><font face="Helvetica, Arial" 15728 ><font color="#00B04F"><font size="+1"> 15729 <a href="GraphicsMagick.html#details-dither">-dither</a> 15730 </font></font></font></b></td></tr></table> 15731 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table> 15732 <table BORDER=0 WIDTH="94%"> 15733 <tr> 15734 <td width="3%"><br></td> 15735 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15736 <img SRC="images/right_triangle_option.png" 15737 ALT=">" BORDER=0 height=14 15738 width=15><b><font face="Helvetica, Arial" 15739 ><font color="#00B04F"><font size="+1"> 15740 <a href="GraphicsMagick.html#details-draw">-draw</a> <i><string></i> 15741 </font></font></font></b></td></tr></table> 15742 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with one or more graphic primitives</td></tr></table> 15743 <table BORDER=0 WIDTH="94%"> 15744 <tr> 15745 <td width="3%"><br></td> 15746 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15747 <img SRC="images/right_triangle_option.png" 15748 ALT=">" BORDER=0 height=14 15749 width=15><b><font face="Helvetica, Arial" 15750 ><font color="#00B04F"><font size="+1"> 15751 -edge <i><radius></i> 15752 </font></font></font></b></td></tr></table> 15753 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>detect edges within an image</td></tr></table> 15754 <table BORDER=0 WIDTH="94%"> 15755 <tr> 15756 <td width="3%"><br></td> 15757 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15758 <img SRC="images/right_triangle_option.png" 15759 ALT=">" BORDER=0 height=14 15760 width=15><b><font face="Helvetica, Arial" 15761 ><font color="#00B04F"><font size="+1"> 15762 -emboss <i><radius></i> 15763 </font></font></font></b></td></tr></table> 15764 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>emboss an image</td></tr></table> 15765 <table BORDER=0 WIDTH="94%"> 15766 <tr> 15767 <td width="3%"><br></td> 15768 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15769 <img SRC="images/right_triangle_option.png" 15770 ALT=">" BORDER=0 height=14 15771 width=15><b><font face="Helvetica, Arial" 15772 ><font color="#00B04F"><font size="+1"> 15773 <a href="GraphicsMagick.html#details-encoding">-encoding</a> <i><type></i> 15774 </font></font></font></b></td></tr></table> 15775 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the text encoding</td></tr></table> 15776 <table BORDER=0 WIDTH="94%"> 15777 <tr> 15778 <td width="3%"><br></td> 15779 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15780 <img SRC="images/right_triangle_option.png" 15781 ALT=">" BORDER=0 height=14 15782 width=15><b><font face="Helvetica, Arial" 15783 ><font color="#00B04F"><font size="+1"> 15784 <a href="GraphicsMagick.html#details-endian">-endian</a> <i><type></i> 15785 </font></font></font></b></td></tr></table> 15786 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify endianness (MSB, LSB, or Native) of image</td></tr></table> 15787 <table BORDER=0 WIDTH="94%"> 15788 <tr> 15789 <td width="3%"><br></td> 15790 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15791 <img SRC="images/right_triangle_option.png" 15792 ALT=">" BORDER=0 height=14 15793 width=15><b><font face="Helvetica, Arial" 15794 ><font color="#00B04F"><font size="+1"> 15795 -enhance 15796 </font></font></font></b></td></tr></table> 15797 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a digital filter to enhance a noisy image</td></tr></table> 15798 <table BORDER=0 WIDTH="94%"> 15799 <tr> 15800 <td width="3%"><br></td> 15801 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15802 <img SRC="images/right_triangle_option.png" 15803 ALT=">" BORDER=0 height=14 15804 width=15><b><font face="Helvetica, Arial" 15805 ><font color="#00B04F"><font size="+1"> 15806 -equalize 15807 </font></font></font></b></td></tr></table> 15808 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform histogram equalization to the image</td></tr></table> 15809 <table BORDER=0 WIDTH="94%"> 15810 <tr> 15811 <td width="3%"><br></td> 15812 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15813 <img SRC="images/right_triangle_option.png" 15814 ALT=">" BORDER=0 height=14 15815 width=15><b><font face="Helvetica, Arial" 15816 ><font color="#00B04F"><font size="+1"> 15817 <a href="GraphicsMagick.html#details-extent">-extent</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i> 15818 </font></font></font></b></td></tr></table> 15819 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>composite image on background color canvas image</td></tr></table> 15820 <table BORDER=0 WIDTH="94%"> 15821 <tr> 15822 <td width="3%"><br></td> 15823 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15824 <img SRC="images/right_triangle_option.png" 15825 ALT=">" BORDER=0 height=14 15826 width=15><b><font face="Helvetica, Arial" 15827 ><font color="#00B04F"><font size="+1"> 15828 <a href="GraphicsMagick.html#details-fill">-fill</a> <i><color></i> 15829 </font></font></font></b></td></tr></table> 15830 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color to use when filling a graphic primitive</td></tr></table> 15831 <table BORDER=0 WIDTH="94%"> 15832 <tr> 15833 <td width="3%"><br></td> 15834 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15835 <img SRC="images/right_triangle_option.png" 15836 ALT=">" BORDER=0 height=14 15837 width=15><b><font face="Helvetica, Arial" 15838 ><font color="#00B04F"><font size="+1"> 15839 <a href="GraphicsMagick.html#details-filter">-filter</a> <i><type></i> 15840 </font></font></font></b></td></tr></table> 15841 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this type of filter when resizing an image</td></tr></table> 15842 <table BORDER=0 WIDTH="94%"> 15843 <tr> 15844 <td width="3%"><br></td> 15845 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15846 <img SRC="images/right_triangle_option.png" 15847 ALT=">" BORDER=0 height=14 15848 width=15><b><font face="Helvetica, Arial" 15849 ><font color="#00B04F"><font size="+1"> 15850 <a href="GraphicsMagick.html#details-flip">-flip</a> 15851 </font></font></font></b></td></tr></table> 15852 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table> 15853 <table BORDER=0 WIDTH="94%"> 15854 <tr> 15855 <td width="3%"><br></td> 15856 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15857 <img SRC="images/right_triangle_option.png" 15858 ALT=">" BORDER=0 height=14 15859 width=15><b><font face="Helvetica, Arial" 15860 ><font color="#00B04F"><font size="+1"> 15861 <a href="GraphicsMagick.html#details-flop">-flop</a> 15862 </font></font></font></b></td></tr></table> 15863 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table> 15864 <table BORDER=0 WIDTH="94%"> 15865 <tr> 15866 <td width="3%"><br></td> 15867 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15868 <img SRC="images/right_triangle_option.png" 15869 ALT=">" BORDER=0 height=14 15870 width=15><b><font face="Helvetica, Arial" 15871 ><font color="#00B04F"><font size="+1"> 15872 <a href="GraphicsMagick.html#details-font">-font</a> <i><name></i> 15873 </font></font></font></b></td></tr></table> 15874 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this font when annotating the image with text</td></tr></table> 15875 <table BORDER=0 WIDTH="94%"> 15876 <tr> 15877 <td width="3%"><br></td> 15878 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15879 <img SRC="images/right_triangle_option.png" 15880 ALT=">" BORDER=0 height=14 15881 width=15><b><font face="Helvetica, Arial" 15882 ><font color="#00B04F"><font size="+1"> 15883 <a href="GraphicsMagick.html#details-format">-format</a> <i><type></i> 15884 </font></font></font></b></td></tr></table> 15885 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image format type</td></tr></table> 15886 <table BORDER=0 WIDTH="94%"> 15887 <tr> 15888 <td width="3%"><br></td> 15889 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15890 <img SRC="images/right_triangle_option.png" 15891 ALT=">" BORDER=0 height=14 15892 width=15><b><font face="Helvetica, Arial" 15893 ><font color="#00B04F"><font size="+1"> 15894 <a href="GraphicsMagick.html#details-frame">-frame</a> <i><width>x<height>+<outer bevel width>+<inner bevel width></i> 15895 </font></font></font></b></td></tr></table> 15896 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with an ornamental border</td></tr></table> 15897 <table BORDER=0 WIDTH="94%"> 15898 <tr> 15899 <td width="3%"><br></td> 15900 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15901 <img SRC="images/right_triangle_option.png" 15902 ALT=">" BORDER=0 height=14 15903 width=15><b><font face="Helvetica, Arial" 15904 ><font color="#00B04F"><font size="+1"> 15905 <a href="GraphicsMagick.html#details-fuzz">-fuzz</a> <i><distance></i>{<i>%</i>}<i></i> 15906 </font></font></font></b></td></tr></table> 15907 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>colors within this Euclidean distance are considered equal</td></tr></table> 15908 <table BORDER=0 WIDTH="94%"> 15909 <tr> 15910 <td width="3%"><br></td> 15911 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15912 <img SRC="images/right_triangle_option.png" 15913 ALT=">" BORDER=0 height=14 15914 width=15><b><font face="Helvetica, Arial" 15915 ><font color="#00B04F"><font size="+1"> 15916 <a href="GraphicsMagick.html#details-gamma">-gamma</a> <i><value></i> 15917 </font></font></font></b></td></tr></table> 15918 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>level of gamma correction</td></tr></table> 15919 <table BORDER=0 WIDTH="94%"> 15920 <tr> 15921 <td width="3%"><br></td> 15922 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15923 <img SRC="images/right_triangle_option.png" 15924 ALT=">" BORDER=0 height=14 15925 width=15><b><font face="Helvetica, Arial" 15926 ><font color="#00B04F"><font size="+1"> 15927 <a href="GraphicsMagick.html#details-gaussian">-gaussian</a> <i><radius></i>{<i>x<sigma></i>}<i></i> 15928 </font></font></font></b></td></tr></table> 15929 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blur the image with a Gaussian operator</td></tr></table> 15930 <table BORDER=0 WIDTH="94%"> 15931 <tr> 15932 <td width="3%"><br></td> 15933 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15934 <img SRC="images/right_triangle_option.png" 15935 ALT=">" BORDER=0 height=14 15936 width=15><b><font face="Helvetica, Arial" 15937 ><font color="#00B04F"><font size="+1"> 15938 <a href="GraphicsMagick.html#details-geometry">-geometry</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i>^</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 15939 </font></font></font></b></td></tr></table> 15940 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify dimension, offset, and resize options.</td></tr></table> 15941 <table BORDER=0 WIDTH="94%"> 15942 <tr> 15943 <td width="3%"><br></td> 15944 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15945 <img SRC="images/right_triangle_option.png" 15946 ALT=">" BORDER=0 height=14 15947 width=15><b><font face="Helvetica, Arial" 15948 ><font color="#00B04F"><font size="+1"> 15949 <a href="GraphicsMagick.html#details-gravity">-gravity</a> <i><type></i> 15950 </font></font></font></b></td></tr></table> 15951 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>direction primitive gravitates to when annotating the image.</td></tr></table> 15952 <table BORDER=0 WIDTH="94%"> 15953 <tr> 15954 <td width="3%"><br></td> 15955 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15956 <img SRC="images/right_triangle_option.png" 15957 ALT=">" BORDER=0 height=14 15958 width=15><b><font face="Helvetica, Arial" 15959 ><font color="#00B04F"><font size="+1"> 15960 <a href="GraphicsMagick.html#details-green-primary">-green-primary</a> <i><x>,<y></i> 15961 </font></font></font></b></td></tr></table> 15962 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>green chromaticity primary point</td></tr></table> 15963 <table BORDER=0 WIDTH="94%"> 15964 <tr> 15965 <td width="3%"><br></td> 15966 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15967 <img SRC="images/right_triangle_option.png" 15968 ALT=">" BORDER=0 height=14 15969 width=15><b><font face="Helvetica, Arial" 15970 ><font color="#00B04F"><font size="+1"> 15971 -hald-clut <i><clut></i> 15972 </font></font></font></b></td></tr></table> 15973 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a Hald CLUT to the image</td></tr></table> 15974 <table BORDER=0 WIDTH="94%"> 15975 <tr> 15976 <td width="3%"><br></td> 15977 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15978 <img SRC="images/right_triangle_option.png" 15979 ALT=">" BORDER=0 height=14 15980 width=15><b><font face="Helvetica, Arial" 15981 ><font color="#00B04F"><font size="+1"> 15982 -help 15983 </font></font></font></b></td></tr></table> 15984 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table> 15985 <table BORDER=0 WIDTH="94%"> 15986 <tr> 15987 <td width="3%"><br></td> 15988 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 15989 <img SRC="images/right_triangle_option.png" 15990 ALT=">" BORDER=0 height=14 15991 width=15><b><font face="Helvetica, Arial" 15992 ><font color="#00B04F"><font size="+1"> 15993 -implode <i><factor></i> 15994 </font></font></font></b></td></tr></table> 15995 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>implode image pixels about the center</td></tr></table> 15996 <table BORDER=0 WIDTH="94%"> 15997 <tr> 15998 <td width="3%"><br></td> 15999 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16000 <img SRC="images/right_triangle_option.png" 16001 ALT=">" BORDER=0 height=14 16002 width=15><b><font face="Helvetica, Arial" 16003 ><font color="#00B04F"><font size="+1"> 16004 <a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i> 16005 </font></font></font></b></td></tr></table> 16006 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table> 16007 <table BORDER=0 WIDTH="94%"> 16008 <tr> 16009 <td width="3%"><br></td> 16010 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16011 <img SRC="images/right_triangle_option.png" 16012 ALT=">" BORDER=0 height=14 16013 width=15><b><font face="Helvetica, Arial" 16014 ><font color="#00B04F"><font size="+1"> 16015 <a href="GraphicsMagick.html#details-label">-label</a> <i><name></i> 16016 </font></font></font></b></td></tr></table> 16017 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign a label to an image</td></tr></table> 16018 <table BORDER=0 WIDTH="94%"> 16019 <tr> 16020 <td width="3%"><br></td> 16021 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16022 <img SRC="images/right_triangle_option.png" 16023 ALT=">" BORDER=0 height=14 16024 width=15><b><font face="Helvetica, Arial" 16025 ><font color="#00B04F"><font size="+1"> 16026 <a href="GraphicsMagick.html#details-lat">-lat</a> <i><width>x<height></i>{<i>+-</i>}<i><offset></i>{<i>%</i>}<i></i> 16027 </font></font></font></b></td></tr></table> 16028 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform local adaptive thresholding</td></tr></table> 16029 <table BORDER=0 WIDTH="94%"> 16030 <tr> 16031 <td width="3%"><br></td> 16032 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16033 <img SRC="images/right_triangle_option.png" 16034 ALT=">" BORDER=0 height=14 16035 width=15><b><font face="Helvetica, Arial" 16036 ><font color="#00B04F"><font size="+1"> 16037 <a href="GraphicsMagick.html#details-level">-level</a> <i><black_point></i>{<i>,<gamma></i>}<i></i>{<i>,<white_point></i>}<i></i>{<i>%</i>}<i></i> 16038 </font></font></font></b></td></tr></table> 16039 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>adjust the level of image contrast</td></tr></table> 16040 <table BORDER=0 WIDTH="94%"> 16041 <tr> 16042 <td width="3%"><br></td> 16043 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16044 <img SRC="images/right_triangle_option.png" 16045 ALT=">" BORDER=0 height=14 16046 width=15><b><font face="Helvetica, Arial" 16047 ><font color="#00B04F"><font size="+1"> 16048 <a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i> 16049 </font></font></font></b></td></tr></table> 16050 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table> 16051 <table BORDER=0 WIDTH="94%"> 16052 <tr> 16053 <td width="3%"><br></td> 16054 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16055 <img SRC="images/right_triangle_option.png" 16056 ALT=">" BORDER=0 height=14 16057 width=15><b><font face="Helvetica, Arial" 16058 ><font color="#00B04F"><font size="+1"> 16059 -linewidth 16060 </font></font></font></b></td></tr></table> 16061 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the line width for subsequent draw operations</td></tr></table> 16062 <table BORDER=0 WIDTH="94%"> 16063 <tr> 16064 <td width="3%"><br></td> 16065 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16066 <img SRC="images/right_triangle_option.png" 16067 ALT=">" BORDER=0 height=14 16068 width=15><b><font face="Helvetica, Arial" 16069 ><font color="#00B04F"><font size="+1"> 16070 <a href="GraphicsMagick.html#details-list">-list</a> <i><type></i> 16071 </font></font></font></b></td></tr></table> 16072 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of list</td></tr></table> 16073 <table BORDER=0 WIDTH="94%"> 16074 <tr> 16075 <td width="3%"><br></td> 16076 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16077 <img SRC="images/right_triangle_option.png" 16078 ALT=">" BORDER=0 height=14 16079 width=15><b><font face="Helvetica, Arial" 16080 ><font color="#00B04F"><font size="+1"> 16081 <a href="GraphicsMagick.html#details-log">-log</a> <i><string></i> 16082 </font></font></font></b></td></tr></table> 16083 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table> 16084 <table BORDER=0 WIDTH="94%"> 16085 <tr> 16086 <td width="3%"><br></td> 16087 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16088 <img SRC="images/right_triangle_option.png" 16089 ALT=">" BORDER=0 height=14 16090 width=15><b><font face="Helvetica, Arial" 16091 ><font color="#00B04F"><font size="+1"> 16092 <a href="GraphicsMagick.html#details-loop">-loop</a> <i><iterations></i> 16093 </font></font></font></b></td></tr></table> 16094 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add Netscape loop extension to your GIF animation</td></tr></table> 16095 <table BORDER=0 WIDTH="94%"> 16096 <tr> 16097 <td width="3%"><br></td> 16098 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16099 <img SRC="images/right_triangle_option.png" 16100 ALT=">" BORDER=0 height=14 16101 width=15><b><font face="Helvetica, Arial" 16102 ><font color="#00B04F"><font size="+1"> 16103 -magnify 16104 </font></font></font></b></td></tr></table> 16105 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>magnify the image</td></tr></table> 16106 <table BORDER=0 WIDTH="94%"> 16107 <tr> 16108 <td width="3%"><br></td> 16109 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16110 <img SRC="images/right_triangle_option.png" 16111 ALT=">" BORDER=0 height=14 16112 width=15><b><font face="Helvetica, Arial" 16113 ><font color="#00B04F"><font size="+1"> 16114 <a href="GraphicsMagick.html#details-map">-map</a> <i><filename></i> 16115 </font></font></font></b></td></tr></table> 16116 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>choose a particular set of colors from this image</td></tr></table> 16117 <table BORDER=0 WIDTH="94%"> 16118 <tr> 16119 <td width="3%"><br></td> 16120 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16121 <img SRC="images/right_triangle_option.png" 16122 ALT=">" BORDER=0 height=14 16123 width=15><b><font face="Helvetica, Arial" 16124 ><font color="#00B04F"><font size="+1"> 16125 <a href="GraphicsMagick.html#details-mask">-mask</a> <i><filename></i> 16126 </font></font></font></b></td></tr></table> 16127 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify a clipping mask</td></tr></table> 16128 <table BORDER=0 WIDTH="94%"> 16129 <tr> 16130 <td width="3%"><br></td> 16131 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16132 <img SRC="images/right_triangle_option.png" 16133 ALT=">" BORDER=0 height=14 16134 width=15><b><font face="Helvetica, Arial" 16135 ><font color="#00B04F"><font size="+1"> 16136 <a href="GraphicsMagick.html#details-matte">-matte</a> 16137 </font></font></font></b></td></tr></table> 16138 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table> 16139 <table BORDER=0 WIDTH="94%"> 16140 <tr> 16141 <td width="3%"><br></td> 16142 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16143 <img SRC="images/right_triangle_option.png" 16144 ALT=">" BORDER=0 height=14 16145 width=15><b><font face="Helvetica, Arial" 16146 ><font color="#00B04F"><font size="+1"> 16147 <a href="GraphicsMagick.html#details-mattecolor">-mattecolor</a> <i><color></i> 16148 </font></font></font></b></td></tr></table> 16149 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the color to be used with the <strong>-frame</strong> option</td></tr></table> 16150 <table BORDER=0 WIDTH="94%"> 16151 <tr> 16152 <td width="3%"><br></td> 16153 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16154 <img SRC="images/right_triangle_option.png" 16155 ALT=">" BORDER=0 height=14 16156 width=15><b><font face="Helvetica, Arial" 16157 ><font color="#00B04F"><font size="+1"> 16158 -median <i><radius></i> 16159 </font></font></font></b></td></tr></table> 16160 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a median filter to the image</td></tr></table> 16161 <table BORDER=0 WIDTH="94%"> 16162 <tr> 16163 <td width="3%"><br></td> 16164 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16165 <img SRC="images/right_triangle_option.png" 16166 ALT=">" BORDER=0 height=14 16167 width=15><b><font face="Helvetica, Arial" 16168 ><font color="#00B04F"><font size="+1"> 16169 -minify <i><factor></i> 16170 </font></font></font></b></td></tr></table> 16171 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>minify the image</td></tr></table> 16172 <table BORDER=0 WIDTH="94%"> 16173 <tr> 16174 <td width="3%"><br></td> 16175 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16176 <img SRC="images/right_triangle_option.png" 16177 ALT=">" BORDER=0 height=14 16178 width=15><b><font face="Helvetica, Arial" 16179 ><font color="#00B04F"><font size="+1"> 16180 <a href="GraphicsMagick.html#details-modulate">-modulate</a> <i>brightness[,saturation[,hue]]</i> 16181 </font></font></font></b></td></tr></table> 16182 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>vary the brightness, saturation, and hue of an image</td></tr></table> 16183 <table BORDER=0 WIDTH="94%"> 16184 <tr> 16185 <td width="3%"><br></td> 16186 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16187 <img SRC="images/right_triangle_option.png" 16188 ALT=">" BORDER=0 height=14 16189 width=15><b><font face="Helvetica, Arial" 16190 ><font color="#00B04F"><font size="+1"> 16191 -monitor 16192 </font></font></font></b></td></tr></table> 16193 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>show progress indication</td></tr></table> 16194 <table BORDER=0 WIDTH="94%"> 16195 <tr> 16196 <td width="3%"><br></td> 16197 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16198 <img SRC="images/right_triangle_option.png" 16199 ALT=">" BORDER=0 height=14 16200 width=15><b><font face="Helvetica, Arial" 16201 ><font color="#00B04F"><font size="+1"> 16202 -monochrome 16203 </font></font></font></b></td></tr></table> 16204 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table> 16205 <table BORDER=0 WIDTH="94%"> 16206 <tr> 16207 <td width="3%"><br></td> 16208 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16209 <img SRC="images/right_triangle_option.png" 16210 ALT=">" BORDER=0 height=14 16211 width=15><b><font face="Helvetica, Arial" 16212 ><font color="#00B04F"><font size="+1"> 16213 <a href="GraphicsMagick.html#details-motion-blur">-motion-blur</a> <i><radius></i>{<i>x<sigma></i>}<i></i>{<i>+angle</i>}<i></i> 16214 </font></font></font></b></td></tr></table> 16215 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Simulate motion blur</td></tr></table> 16216 <table BORDER=0 WIDTH="94%"> 16217 <tr> 16218 <td width="3%"><br></td> 16219 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16220 <img SRC="images/right_triangle_option.png" 16221 ALT=">" BORDER=0 height=14 16222 width=15><b><font face="Helvetica, Arial" 16223 ><font color="#00B04F"><font size="+1"> 16224 <a href="GraphicsMagick.html#details-negate">-negate</a> 16225 </font></font></font></b></td></tr></table> 16226 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>replace every pixel with its complementary color</td></tr></table> 16227 <table BORDER=0 WIDTH="94%"> 16228 <tr> 16229 <td width="3%"><br></td> 16230 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16231 <img SRC="images/right_triangle_option.png" 16232 ALT=">" BORDER=0 height=14 16233 width=15><b><font face="Helvetica, Arial" 16234 ><font color="#00B04F"><font size="+1"> 16235 <a href="GraphicsMagick.html#details-noise">-noise</a> <i><radius|type></i> 16236 </font></font></font></b></td></tr></table> 16237 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add or reduce noise in an image</td></tr></table> 16238 <table BORDER=0 WIDTH="94%"> 16239 <tr> 16240 <td width="3%"><br></td> 16241 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16242 <img SRC="images/right_triangle_option.png" 16243 ALT=">" BORDER=0 height=14 16244 width=15><b><font face="Helvetica, Arial" 16245 ><font color="#00B04F"><font size="+1"> 16246 <a href="GraphicsMagick.html#details-noop">-noop</a> 16247 </font></font></font></b></td></tr></table> 16248 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>NOOP (no option)</td></tr></table> 16249 <table BORDER=0 WIDTH="94%"> 16250 <tr> 16251 <td width="3%"><br></td> 16252 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16253 <img SRC="images/right_triangle_option.png" 16254 ALT=">" BORDER=0 height=14 16255 width=15><b><font face="Helvetica, Arial" 16256 ><font color="#00B04F"><font size="+1"> 16257 <a href="GraphicsMagick.html#details-normalize">-normalize</a> 16258 </font></font></font></b></td></tr></table> 16259 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform image to span the full range of color values</td></tr></table> 16260 <table BORDER=0 WIDTH="94%"> 16261 <tr> 16262 <td width="3%"><br></td> 16263 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16264 <img SRC="images/right_triangle_option.png" 16265 ALT=">" BORDER=0 height=14 16266 width=15><b><font face="Helvetica, Arial" 16267 ><font color="#00B04F"><font size="+1"> 16268 <a href="GraphicsMagick.html#details-opaque">-opaque</a> <i><color></i> 16269 </font></font></font></b></td></tr></table> 16270 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>change this color to the pen color within the image</td></tr></table> 16271 <table BORDER=0 WIDTH="94%"> 16272 <tr> 16273 <td width="3%"><br></td> 16274 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16275 <img SRC="images/right_triangle_option.png" 16276 ALT=">" BORDER=0 height=14 16277 width=15><b><font face="Helvetica, Arial" 16278 ><font color="#00B04F"><font size="+1"> 16279 <a href="GraphicsMagick.html#details-operator">-operator</a> <i>channel operator rvalue[%]</i> 16280 </font></font></font></b></td></tr></table> 16281 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a mathematical, bitwise, or value operator to an image channel</td></tr></table> 16282 <table BORDER=0 WIDTH="94%"> 16283 <tr> 16284 <td width="3%"><br></td> 16285 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16286 <img SRC="images/right_triangle_option.png" 16287 ALT=">" BORDER=0 height=14 16288 width=15><b><font face="Helvetica, Arial" 16289 ><font color="#00B04F"><font size="+1"> 16290 <a href="GraphicsMagick.html#details-ordered-dither">-ordered-dither</a> <i><channeltype> <NxN></i> 16291 </font></font></font></b></td></tr></table> 16292 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>ordered dither the image</td></tr></table> 16293 <table BORDER=0 WIDTH="94%"> 16294 <tr> 16295 <td width="3%"><br></td> 16296 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16297 <img SRC="images/right_triangle_option.png" 16298 ALT=">" BORDER=0 height=14 16299 width=15><b><font face="Helvetica, Arial" 16300 ><font color="#00B04F"><font size="+1"> 16301 <a href="GraphicsMagick.html#details-output-directory">-output-directory</a> <i><directory></i> 16302 </font></font></font></b></td></tr></table> 16303 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>output files to directory</td></tr></table> 16304 <table BORDER=0 WIDTH="94%"> 16305 <tr> 16306 <td width="3%"><br></td> 16307 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16308 <img SRC="images/right_triangle_option.png" 16309 ALT=">" BORDER=0 height=14 16310 width=15><b><font face="Helvetica, Arial" 16311 ><font color="#00B04F"><font size="+1"> 16312 <a href="GraphicsMagick.html#details-orient">-orient</a> <i><orientation></i> 16313 </font></font></font></b></td></tr></table> 16314 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Set the image orientation attribute</td></tr></table> 16315 <table BORDER=0 WIDTH="94%"> 16316 <tr> 16317 <td width="3%"><br></td> 16318 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16319 <img SRC="images/right_triangle_option.png" 16320 ALT=">" BORDER=0 height=14 16321 width=15><b><font face="Helvetica, Arial" 16322 ><font color="#00B04F"><font size="+1"> 16323 <a href="GraphicsMagick.html#details-page">-page</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 16324 </font></font></font></b></td></tr></table> 16325 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>size and location of an image canvas</td></tr></table> 16326 <table BORDER=0 WIDTH="94%"> 16327 <tr> 16328 <td width="3%"><br></td> 16329 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16330 <img SRC="images/right_triangle_option.png" 16331 ALT=">" BORDER=0 height=14 16332 width=15><b><font face="Helvetica, Arial" 16333 ><font color="#00B04F"><font size="+1"> 16334 <a href="GraphicsMagick.html#details-paint">-paint</a> <i><radius></i> 16335 </font></font></font></b></td></tr></table> 16336 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>simulate an oil painting</td></tr></table> 16337 <table BORDER=0 WIDTH="94%"> 16338 <tr> 16339 <td width="3%"><br></td> 16340 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16341 <img SRC="images/right_triangle_option.png" 16342 ALT=">" BORDER=0 height=14 16343 width=15><b><font face="Helvetica, Arial" 16344 ><font color="#00B04F"><font size="+1"> 16345 <a href="GraphicsMagick.html#details-pen">-pen</a> <i><color></i> 16346 </font></font></font></b></td></tr></table> 16347 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -fill option)</td></tr></table> 16348 <table BORDER=0 WIDTH="94%"> 16349 <tr> 16350 <td width="3%"><br></td> 16351 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16352 <img SRC="images/right_triangle_option.png" 16353 ALT=">" BORDER=0 height=14 16354 width=15><b><font face="Helvetica, Arial" 16355 ><font color="#00B04F"><font size="+1"> 16356 -pointsize <i><value></i> 16357 </font></font></font></b></td></tr></table> 16358 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pointsize of the PostScript, X11, or TrueType font</td></tr></table> 16359 <table BORDER=0 WIDTH="94%"> 16360 <tr> 16361 <td width="3%"><br></td> 16362 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16363 <img SRC="images/right_triangle_option.png" 16364 ALT=">" BORDER=0 height=14 16365 width=15><b><font face="Helvetica, Arial" 16366 ><font color="#00B04F"><font size="+1"> 16367 <a href="GraphicsMagick.html#details-profile">-profile</a> <i><filename></i> 16368 </font></font></font></b></td></tr></table> 16369 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add ICM, IPTC, or generic profile to image</td></tr></table> 16370 <table BORDER=0 WIDTH="94%"> 16371 <tr> 16372 <td width="3%"><br></td> 16373 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16374 <img SRC="images/right_triangle_option.png" 16375 ALT=">" BORDER=0 height=14 16376 width=15><b><font face="Helvetica, Arial" 16377 ><font color="#00B04F"><font size="+1"> 16378 <a href="GraphicsMagick.html#details-preserve-timestamp">-preserve-timestamp</a> 16379 </font></font></font></b></td></tr></table> 16380 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preserve the original timestamps of the file</td></tr></table> 16381 <table BORDER=0 WIDTH="94%"> 16382 <tr> 16383 <td width="3%"><br></td> 16384 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16385 <img SRC="images/right_triangle_option.png" 16386 ALT=">" BORDER=0 height=14 16387 width=15><b><font face="Helvetica, Arial" 16388 ><font color="#00B04F"><font size="+1"> 16389 <a href="GraphicsMagick.html#details-quality">-quality</a> <i><value></i> 16390 </font></font></font></b></td></tr></table> 16391 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>JPEG/MIFF/PNG/TIFF compression level</td></tr></table> 16392 <table BORDER=0 WIDTH="94%"> 16393 <tr> 16394 <td width="3%"><br></td> 16395 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16396 <img SRC="images/right_triangle_option.png" 16397 ALT=">" BORDER=0 height=14 16398 width=15><b><font face="Helvetica, Arial" 16399 ><font color="#00B04F"><font size="+1"> 16400 <a href="GraphicsMagick.html#details-raise">-raise</a> <i><width>x<height></i> 16401 </font></font></font></b></td></tr></table> 16402 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>lighten or darken image edges</td></tr></table> 16403 <table BORDER=0 WIDTH="94%"> 16404 <tr> 16405 <td width="3%"><br></td> 16406 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16407 <img SRC="images/right_triangle_option.png" 16408 ALT=">" BORDER=0 height=14 16409 width=15><b><font face="Helvetica, Arial" 16410 ><font color="#00B04F"><font size="+1"> 16411 <a href="GraphicsMagick.html#details-random-threshold">-random-threshold</a> <i><channeltype> <LOWxHIGH></i> 16412 </font></font></font></b></td></tr></table> 16413 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>random threshold the image</td></tr></table> 16414 <table BORDER=0 WIDTH="94%"> 16415 <tr> 16416 <td width="3%"><br></td> 16417 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16418 <img SRC="images/right_triangle_option.png" 16419 ALT=">" BORDER=0 height=14 16420 width=15><b><font face="Helvetica, Arial" 16421 ><font color="#00B04F"><font size="+1"> 16422 <a href="GraphicsMagick.html#details-recolor">-recolor</a> <i><matrix></i> 16423 </font></font></font></b></td></tr></table> 16424 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a color translation matrix to image channels</td></tr></table> 16425 <table BORDER=0 WIDTH="94%"> 16426 <tr> 16427 <td width="3%"><br></td> 16428 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16429 <img SRC="images/right_triangle_option.png" 16430 ALT=">" BORDER=0 height=14 16431 width=15><b><font face="Helvetica, Arial" 16432 ><font color="#00B04F"><font size="+1"> 16433 <a href="GraphicsMagick.html#details-red-primary">-red-primary</a> <i><x>,<y></i> 16434 </font></font></font></b></td></tr></table> 16435 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>red chromaticity primary point</td></tr></table> 16436 <table BORDER=0 WIDTH="94%"> 16437 <tr> 16438 <td width="3%"><br></td> 16439 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16440 <img SRC="images/right_triangle_option.png" 16441 ALT=">" BORDER=0 height=14 16442 width=15><b><font face="Helvetica, Arial" 16443 ><font color="#00B04F"><font size="+1"> 16444 <a href="GraphicsMagick.html#details-region">-region</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i> 16445 </font></font></font></b></td></tr></table> 16446 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply options to a portion of the image</td></tr></table> 16447 <table BORDER=0 WIDTH="94%"> 16448 <tr> 16449 <td width="3%"><br></td> 16450 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16451 <img SRC="images/right_triangle_option.png" 16452 ALT=">" BORDER=0 height=14 16453 width=15><b><font face="Helvetica, Arial" 16454 ><font color="#00B04F"><font size="+1"> 16455 <a href="GraphicsMagick.html#details-render">-render</a> 16456 </font></font></font></b></td></tr></table> 16457 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>render vector operations</td></tr></table> 16458 <table BORDER=0 WIDTH="94%"> 16459 <tr> 16460 <td width="3%"><br></td> 16461 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16462 <img SRC="images/right_triangle_option.png" 16463 ALT=">" BORDER=0 height=14 16464 width=15><b><font face="Helvetica, Arial" 16465 ><font color="#00B04F"><font size="+1"> 16466 <a href="GraphicsMagick.html#details-repage">-repage</a> <i> <width>x<height>+xoff+yoff[!]</i> 16467 </font></font></font></b></td></tr></table> 16468 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Adjust image page offsets</td></tr></table> 16469 <table BORDER=0 WIDTH="94%"> 16470 <tr> 16471 <td width="3%"><br></td> 16472 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16473 <img SRC="images/right_triangle_option.png" 16474 ALT=">" BORDER=0 height=14 16475 width=15><b><font face="Helvetica, Arial" 16476 ><font color="#00B04F"><font size="+1"> 16477 <a href="GraphicsMagick.html#details-resample">-resample</a> <i><horizontal>x<vertical></i> 16478 </font></font></font></b></td></tr></table> 16479 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Resample image to specified horizontal and vertical resolution</td></tr></table> 16480 <table BORDER=0 WIDTH="94%"> 16481 <tr> 16482 <td width="3%"><br></td> 16483 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16484 <img SRC="images/right_triangle_option.png" 16485 ALT=">" BORDER=0 height=14 16486 width=15><b><font face="Helvetica, Arial" 16487 ><font color="#00B04F"><font size="+1"> 16488 <a href="GraphicsMagick.html#details-resize">-resize</a> <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 16489 </font></font></font></b></td></tr></table> 16490 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image</td></tr></table> 16491 <table BORDER=0 WIDTH="94%"> 16492 <tr> 16493 <td width="3%"><br></td> 16494 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16495 <img SRC="images/right_triangle_option.png" 16496 ALT=">" BORDER=0 height=14 16497 width=15><b><font face="Helvetica, Arial" 16498 ><font color="#00B04F"><font size="+1"> 16499 <a href="GraphicsMagick.html#details-roll">-roll</a> <i></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i> 16500 </font></font></font></b></td></tr></table> 16501 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>roll an image vertically or horizontally</td></tr></table> 16502 <table BORDER=0 WIDTH="94%"> 16503 <tr> 16504 <td width="3%"><br></td> 16505 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16506 <img SRC="images/right_triangle_option.png" 16507 ALT=">" BORDER=0 height=14 16508 width=15><b><font face="Helvetica, Arial" 16509 ><font color="#00B04F"><font size="+1"> 16510 <a href="GraphicsMagick.html#details-rotate">-rotate</a> <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 16511 </font></font></font></b></td></tr></table> 16512 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>rotate the image</td></tr></table> 16513 <table BORDER=0 WIDTH="94%"> 16514 <tr> 16515 <td width="3%"><br></td> 16516 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16517 <img SRC="images/right_triangle_option.png" 16518 ALT=">" BORDER=0 height=14 16519 width=15><b><font face="Helvetica, Arial" 16520 ><font color="#00B04F"><font size="+1"> 16521 <a href="GraphicsMagick.html#details-sample">-sample</a> <i><geometry></i> 16522 </font></font></font></b></td></tr></table> 16523 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>scale image using pixel sampling</td></tr></table> 16524 <table BORDER=0 WIDTH="94%"> 16525 <tr> 16526 <td width="3%"><br></td> 16527 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16528 <img SRC="images/right_triangle_option.png" 16529 ALT=">" BORDER=0 height=14 16530 width=15><b><font face="Helvetica, Arial" 16531 ><font color="#00B04F"><font size="+1"> 16532 <a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i> 16533 </font></font></font></b></td></tr></table> 16534 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chroma subsampling factors</td></tr></table> 16535 <table BORDER=0 WIDTH="94%"> 16536 <tr> 16537 <td width="3%"><br></td> 16538 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16539 <img SRC="images/right_triangle_option.png" 16540 ALT=">" BORDER=0 height=14 16541 width=15><b><font face="Helvetica, Arial" 16542 ><font color="#00B04F"><font size="+1"> 16543 <a href="GraphicsMagick.html#details-scale">-scale</a> <i><geometry></i> 16544 </font></font></font></b></td></tr></table> 16545 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>scale the image.</td></tr></table> 16546 <table BORDER=0 WIDTH="94%"> 16547 <tr> 16548 <td width="3%"><br></td> 16549 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16550 <img SRC="images/right_triangle_option.png" 16551 ALT=">" BORDER=0 height=14 16552 width=15><b><font face="Helvetica, Arial" 16553 ><font color="#00B04F"><font size="+1"> 16554 <a href="GraphicsMagick.html#details-scene">-scene</a> <i><value></i> 16555 </font></font></font></b></td></tr></table> 16556 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set scene number</td></tr></table> 16557 <table BORDER=0 WIDTH="94%"> 16558 <tr> 16559 <td width="3%"><br></td> 16560 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16561 <img SRC="images/right_triangle_option.png" 16562 ALT=">" BORDER=0 height=14 16563 width=15><b><font face="Helvetica, Arial" 16564 ><font color="#00B04F"><font size="+1"> 16565 <a href="GraphicsMagick.html#details-set">-set</a> <i><attribute> <value></i> 16566 </font></font></font></b></td></tr></table> 16567 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set an image attribute</td></tr></table> 16568 <table BORDER=0 WIDTH="94%"> 16569 <tr> 16570 <td width="3%"><br></td> 16571 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16572 <img SRC="images/right_triangle_option.png" 16573 ALT=">" BORDER=0 height=14 16574 width=15><b><font face="Helvetica, Arial" 16575 ><font color="#00B04F"><font size="+1"> 16576 <a href="GraphicsMagick.html#details+set">+set</a> <i><attribute></i> 16577 </font></font></font></b></td></tr></table> 16578 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>unset an image attribute</td></tr></table> 16579 <table BORDER=0 WIDTH="94%"> 16580 <tr> 16581 <td width="3%"><br></td> 16582 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16583 <img SRC="images/right_triangle_option.png" 16584 ALT=">" BORDER=0 height=14 16585 width=15><b><font face="Helvetica, Arial" 16586 ><font color="#00B04F"><font size="+1"> 16587 <a href="GraphicsMagick.html#details-segment">-segment</a> <i><cluster threshold>x<smoothing threshold></i> 16588 </font></font></font></b></td></tr></table> 16589 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>segment an image</td></tr></table> 16590 <table BORDER=0 WIDTH="94%"> 16591 <tr> 16592 <td width="3%"><br></td> 16593 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16594 <img SRC="images/right_triangle_option.png" 16595 ALT=">" BORDER=0 height=14 16596 width=15><b><font face="Helvetica, Arial" 16597 ><font color="#00B04F"><font size="+1"> 16598 <a href="GraphicsMagick.html#details-shade">-shade</a> <i><azimuth>x<elevation></i> 16599 </font></font></font></b></td></tr></table> 16600 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shade the image using a distant light source</td></tr></table> 16601 <table BORDER=0 WIDTH="94%"> 16602 <tr> 16603 <td width="3%"><br></td> 16604 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16605 <img SRC="images/right_triangle_option.png" 16606 ALT=">" BORDER=0 height=14 16607 width=15><b><font face="Helvetica, Arial" 16608 ><font color="#00B04F"><font size="+1"> 16609 <a href="GraphicsMagick.html#details-sharpen">-sharpen</a> <i><radius></i>{<i>x<sigma></i>}<i></i> 16610 </font></font></font></b></td></tr></table> 16611 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image</td></tr></table> 16612 <table BORDER=0 WIDTH="94%"> 16613 <tr> 16614 <td width="3%"><br></td> 16615 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16616 <img SRC="images/right_triangle_option.png" 16617 ALT=">" BORDER=0 height=14 16618 width=15><b><font face="Helvetica, Arial" 16619 ><font color="#00B04F"><font size="+1"> 16620 <a href="GraphicsMagick.html#details-shave">-shave</a> <i><width>x<height></i>{<i>%</i>}<i></i> 16621 </font></font></font></b></td></tr></table> 16622 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shave pixels from the image edges</td></tr></table> 16623 <table BORDER=0 WIDTH="94%"> 16624 <tr> 16625 <td width="3%"><br></td> 16626 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16627 <img SRC="images/right_triangle_option.png" 16628 ALT=">" BORDER=0 height=14 16629 width=15><b><font face="Helvetica, Arial" 16630 ><font color="#00B04F"><font size="+1"> 16631 <a href="GraphicsMagick.html#details-shear">-shear</a> <i><x degrees>x<y degrees></i> 16632 </font></font></font></b></td></tr></table> 16633 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shear the image along the X or Y axis</td></tr></table> 16634 <table BORDER=0 WIDTH="94%"> 16635 <tr> 16636 <td width="3%"><br></td> 16637 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16638 <img SRC="images/right_triangle_option.png" 16639 ALT=">" BORDER=0 height=14 16640 width=15><b><font face="Helvetica, Arial" 16641 ><font color="#00B04F"><font size="+1"> 16642 <a href="GraphicsMagick.html#details-size">-size</a> <i><width>x<height></i>{<i>+offset</i>}<i></i> 16643 </font></font></font></b></td></tr></table> 16644 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table> 16645 <table BORDER=0 WIDTH="94%"> 16646 <tr> 16647 <td width="3%"><br></td> 16648 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16649 <img SRC="images/right_triangle_option.png" 16650 ALT=">" BORDER=0 height=14 16651 width=15><b><font face="Helvetica, Arial" 16652 ><font color="#00B04F"><font size="+1"> 16653 <a href="GraphicsMagick.html#details-solarize">-solarize</a> <i><factor></i> 16654 </font></font></font></b></td></tr></table> 16655 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>negate all pixels above the threshold level</td></tr></table> 16656 <table BORDER=0 WIDTH="94%"> 16657 <tr> 16658 <td width="3%"><br></td> 16659 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16660 <img SRC="images/right_triangle_option.png" 16661 ALT=">" BORDER=0 height=14 16662 width=15><b><font face="Helvetica, Arial" 16663 ><font color="#00B04F"><font size="+1"> 16664 <a href="GraphicsMagick.html#details-spread">-spread</a> <i><amount></i> 16665 </font></font></font></b></td></tr></table> 16666 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>displace image pixels by a random amount</td></tr></table> 16667 <table BORDER=0 WIDTH="94%"> 16668 <tr> 16669 <td width="3%"><br></td> 16670 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16671 <img SRC="images/right_triangle_option.png" 16672 ALT=">" BORDER=0 height=14 16673 width=15><b><font face="Helvetica, Arial" 16674 ><font color="#00B04F"><font size="+1"> 16675 <a href="GraphicsMagick.html#details-strip">-strip</a> 16676 </font></font></font></b></td></tr></table> 16677 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove all profiles and text attributes from the image</td></tr></table> 16678 <table BORDER=0 WIDTH="94%"> 16679 <tr> 16680 <td width="3%"><br></td> 16681 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16682 <img SRC="images/right_triangle_option.png" 16683 ALT=">" BORDER=0 height=14 16684 width=15><b><font face="Helvetica, Arial" 16685 ><font color="#00B04F"><font size="+1"> 16686 <a href="GraphicsMagick.html#details-stroke">-stroke</a> <i><color></i> 16687 </font></font></font></b></td></tr></table> 16688 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color to use when stroking a graphic primitive</td></tr></table> 16689 <table BORDER=0 WIDTH="94%"> 16690 <tr> 16691 <td width="3%"><br></td> 16692 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16693 <img SRC="images/right_triangle_option.png" 16694 ALT=">" BORDER=0 height=14 16695 width=15><b><font face="Helvetica, Arial" 16696 ><font color="#00B04F"><font size="+1"> 16697 <a href="GraphicsMagick.html#details-strokewidth">-strokewidth</a> <i><value></i> 16698 </font></font></font></b></td></tr></table> 16699 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set the stroke width</td></tr></table> 16700 <table BORDER=0 WIDTH="94%"> 16701 <tr> 16702 <td width="3%"><br></td> 16703 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16704 <img SRC="images/right_triangle_option.png" 16705 ALT=">" BORDER=0 height=14 16706 width=15><b><font face="Helvetica, Arial" 16707 ><font color="#00B04F"><font size="+1"> 16708 <a href="GraphicsMagick.html#details-swirl">-swirl</a> <i><degrees></i> 16709 </font></font></font></b></td></tr></table> 16710 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>swirl image pixels about the center</td></tr></table> 16711 <table BORDER=0 WIDTH="94%"> 16712 <tr> 16713 <td width="3%"><br></td> 16714 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16715 <img SRC="images/right_triangle_option.png" 16716 ALT=">" BORDER=0 height=14 16717 width=15><b><font face="Helvetica, Arial" 16718 ><font color="#00B04F"><font size="+1"> 16719 -texture <i><filename></i> 16720 </font></font></font></b></td></tr></table> 16721 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name of texture to tile onto the image background</td></tr></table> 16722 <table BORDER=0 WIDTH="94%"> 16723 <tr> 16724 <td width="3%"><br></td> 16725 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16726 <img SRC="images/right_triangle_option.png" 16727 ALT=">" BORDER=0 height=14 16728 width=15><b><font face="Helvetica, Arial" 16729 ><font color="#00B04F"><font size="+1"> 16730 <a href="GraphicsMagick.html#details-threshold">-threshold</a> <i><value></i>{<i>%</i>}<i></i> 16731 </font></font></font></b></td></tr></table> 16732 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>threshold the image</td></tr></table> 16733 <table BORDER=0 WIDTH="94%"> 16734 <tr> 16735 <td width="3%"><br></td> 16736 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16737 <img SRC="images/right_triangle_option.png" 16738 ALT=">" BORDER=0 height=14 16739 width=15><b><font face="Helvetica, Arial" 16740 ><font color="#00B04F"><font size="+1"> 16741 <a href="GraphicsMagick.html#details-thumbnail">-thumbnail</a> <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 16742 </font></font></font></b></td></tr></table> 16743 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image (quickly)</td></tr></table> 16744 <table BORDER=0 WIDTH="94%"> 16745 <tr> 16746 <td width="3%"><br></td> 16747 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16748 <img SRC="images/right_triangle_option.png" 16749 ALT=">" BORDER=0 height=14 16750 width=15><b><font face="Helvetica, Arial" 16751 ><font color="#00B04F"><font size="+1"> 16752 -tile <i><filename></i> 16753 </font></font></font></b></td></tr></table> 16754 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tile image when filling a graphic primitive</td></tr></table> 16755 <table BORDER=0 WIDTH="94%"> 16756 <tr> 16757 <td width="3%"><br></td> 16758 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16759 <img SRC="images/right_triangle_option.png" 16760 ALT=">" BORDER=0 height=14 16761 width=15><b><font face="Helvetica, Arial" 16762 ><font color="#00B04F"><font size="+1"> 16763 <a href="GraphicsMagick.html#details-transform">-transform</a> 16764 </font></font></font></b></td></tr></table> 16765 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image</td></tr></table> 16766 <table BORDER=0 WIDTH="94%"> 16767 <tr> 16768 <td width="3%"><br></td> 16769 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16770 <img SRC="images/right_triangle_option.png" 16771 ALT=">" BORDER=0 height=14 16772 width=15><b><font face="Helvetica, Arial" 16773 ><font color="#00B04F"><font size="+1"> 16774 <a href="GraphicsMagick.html#details-transparent">-transparent</a> <i><color></i> 16775 </font></font></font></b></td></tr></table> 16776 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make this color transparent within the image</td></tr></table> 16777 <table BORDER=0 WIDTH="94%"> 16778 <tr> 16779 <td width="3%"><br></td> 16780 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16781 <img SRC="images/right_triangle_option.png" 16782 ALT=">" BORDER=0 height=14 16783 width=15><b><font face="Helvetica, Arial" 16784 ><font color="#00B04F"><font size="+1"> 16785 <a href="GraphicsMagick.html#details-treedepth">-treedepth</a> <i><value></i> 16786 </font></font></font></b></td></tr></table> 16787 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tree depth for the color reduction algorithm</td></tr></table> 16788 <table BORDER=0 WIDTH="94%"> 16789 <tr> 16790 <td width="3%"><br></td> 16791 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16792 <img SRC="images/right_triangle_option.png" 16793 ALT=">" BORDER=0 height=14 16794 width=15><b><font face="Helvetica, Arial" 16795 ><font color="#00B04F"><font size="+1"> 16796 <a href="GraphicsMagick.html#details-trim">-trim</a> 16797 </font></font></font></b></td></tr></table> 16798 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table> 16799 <table BORDER=0 WIDTH="94%"> 16800 <tr> 16801 <td width="3%"><br></td> 16802 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16803 <img SRC="images/right_triangle_option.png" 16804 ALT=">" BORDER=0 height=14 16805 width=15><b><font face="Helvetica, Arial" 16806 ><font color="#00B04F"><font size="+1"> 16807 <a href="GraphicsMagick.html#details-type">-type</a> <i><type></i> 16808 </font></font></font></b></td></tr></table> 16809 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image type</td></tr></table> 16810 <table BORDER=0 WIDTH="94%"> 16811 <tr> 16812 <td width="3%"><br></td> 16813 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16814 <img SRC="images/right_triangle_option.png" 16815 ALT=">" BORDER=0 height=14 16816 width=15><b><font face="Helvetica, Arial" 16817 ><font color="#00B04F"><font size="+1"> 16818 <a href="GraphicsMagick.html#details-units">-units</a> <i><type></i> 16819 </font></font></font></b></td></tr></table> 16820 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the units of image resolution</td></tr></table> 16821 <table BORDER=0 WIDTH="94%"> 16822 <tr> 16823 <td width="3%"><br></td> 16824 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16825 <img SRC="images/right_triangle_option.png" 16826 ALT=">" BORDER=0 height=14 16827 width=15><b><font face="Helvetica, Arial" 16828 ><font color="#00B04F"><font size="+1"> 16829 <a href="GraphicsMagick.html#details-unsharp">-unsharp</a> <i><radius></i>{<i>x<sigma></i>}<i></i>{<i>+<amount></i>}<i></i>{<i>+<threshold></i>}<i></i> 16830 </font></font></font></b></td></tr></table> 16831 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image with an unsharp mask operator</td></tr></table> 16832 <table BORDER=0 WIDTH="94%"> 16833 <tr> 16834 <td width="3%"><br></td> 16835 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16836 <img SRC="images/right_triangle_option.png" 16837 ALT=">" BORDER=0 height=14 16838 width=15><b><font face="Helvetica, Arial" 16839 ><font color="#00B04F"><font size="+1"> 16840 <a href="GraphicsMagick.html#details-verbose">-verbose</a> 16841 </font></font></font></b></td></tr></table> 16842 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table> 16843 <table BORDER=0 WIDTH="94%"> 16844 <tr> 16845 <td width="3%"><br></td> 16846 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16847 <img SRC="images/right_triangle_option.png" 16848 ALT=">" BORDER=0 height=14 16849 width=15><b><font face="Helvetica, Arial" 16850 ><font color="#00B04F"><font size="+1"> 16851 <a href="GraphicsMagick.html#details-version">-version</a> 16852 </font></font></font></b></td></tr></table> 16853 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table> 16854 <table BORDER=0 WIDTH="94%"> 16855 <tr> 16856 <td width="3%"><br></td> 16857 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16858 <img SRC="images/right_triangle_option.png" 16859 ALT=">" BORDER=0 height=14 16860 width=15><b><font face="Helvetica, Arial" 16861 ><font color="#00B04F"><font size="+1"> 16862 -view <i><string></i> 16863 </font></font></font></b></td></tr></table> 16864 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>FlashPix viewing parameters</td></tr></table> 16865 <table BORDER=0 WIDTH="94%"> 16866 <tr> 16867 <td width="3%"><br></td> 16868 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16869 <img SRC="images/right_triangle_option.png" 16870 ALT=">" BORDER=0 height=14 16871 width=15><b><font face="Helvetica, Arial" 16872 ><font color="#00B04F"><font size="+1"> 16873 <a href="GraphicsMagick.html#details-virtual-pixel">-virtual-pixel</a> <i><method></i> 16874 </font></font></font></b></td></tr></table> 16875 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify contents of "virtual pixels"</td></tr></table> 16876 <table BORDER=0 WIDTH="94%"> 16877 <tr> 16878 <td width="3%"><br></td> 16879 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16880 <img SRC="images/right_triangle_option.png" 16881 ALT=">" BORDER=0 height=14 16882 width=15><b><font face="Helvetica, Arial" 16883 ><font color="#00B04F"><font size="+1"> 16884 <a href="GraphicsMagick.html#details-wave">-wave</a> <i><amplitude>x<wavelength></i> 16885 </font></font></font></b></td></tr></table> 16886 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>alter an image along a sine wave</td></tr></table> 16887 <table BORDER=0 WIDTH="94%"> 16888 <tr> 16889 <td width="3%"><br></td> 16890 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16891 <img SRC="images/right_triangle_option.png" 16892 ALT=">" BORDER=0 height=14 16893 width=15><b><font face="Helvetica, Arial" 16894 ><font color="#00B04F"><font size="+1"> 16895 <a href="GraphicsMagick.html#details-white-point">-white-point</a> <i><x>,<y></i> 16896 </font></font></font></b></td></tr></table> 16897 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chromaticity white point</td></tr></table> 16898 <table BORDER=0 WIDTH="94%"> 16899 <tr> 16900 <td width="3%"><br></td> 16901 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 16902 <img SRC="images/right_triangle_option.png" 16903 ALT=">" BORDER=0 height=14 16904 width=15><b><font face="Helvetica, Arial" 16905 ><font color="#00B04F"><font size="+1"> 16906 <a href="GraphicsMagick.html#details-white-threshold">-white-threshold</a> <i>red[,green][,blue][,opacity]</i> 16907 </font></font></font></b></td></tr></table> 16908 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pixels above the threshold become white</td></tr></table> 16909 <p> 16910 For a more detailed description of each option, see 16911 Options, above. 16912 <br> <br> 16913 </td></tr></table> 16914 <p> 16915 <i><a href="#top">Back to Contents</a></i> 16916 </p> 16917 <br> <br> 16918 <table BORDER=0 WIDTH="100%"> 16919 <tr> 16920 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 16921 SRC="images/right_triangle.png" ALT=">" BORDER=0 16922 height=14 width=15><b><font face="Helvetica, Arial"><font 16923 color="#00B04F"><font size="+1"> 16924 <a NAME="montage"></a>gm montage 16925 </font></font></font></b></td></tr></table> 16926 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 16927 <tr><td width="3%"><br></td><td> 16928 <p> 16929 <strong>montage</strong> creates a composite image by combining several separate 16930 images. The images are tiled on the composite image with the name of the 16931 image optionally appearing just below the individual tile. 16932 <p> 16933 The composite image is constructed in the following manner. First, each 16934 image specified on the command line, except for the last, is scaled to 16935 fit the maximum tile size. The maximum tile size by default is 120x120. 16936 It can be modified with the <strong>-geometry</strong> command line argument or X 16937 resource. See 16938 <strong>Options</strong> 16939 for more information on command line arguments. See 16940 <strong>X(1)</strong> for more information on X resources. 16941 Note that the maximum tile size need not be a square. 16942 <p> 16943 Next the composite image is initialized with the color specified by the 16944 <strong>-background</strong> 16945 command line argument or X resource. The width and height of the composite 16946 image is determined by the title specified, the maximum tile size, the 16947 number of tiles per row, the tile border width and height, the image border 16948 width, and the label height. The number of tiles per row specifies how 16949 many images are to appear in each row of the composite image. The default 16950 is to have 5 tiles in each row and 4 tiles in each column of the composite. 16951 A specific value is specified with <strong>-tile</strong>. The tile border width 16952 and height, and the image border width defaults to the value of the X resource 16953 <strong>-borderwidth</strong>. It can be changed with the <strong>-borderwidth</strong> or 16954 <strong>-geometry</strong> command line argument or X resource. The label height 16955 is determined by the font you specify with the <strong>-font</strong> command line 16956 argument or X resource. If you do not specify a font, a font is chosen 16957 that allows the name of the image to fit the maximum width of a tiled area. 16958 The label colors is determined by the <strong>-background</strong> and <strong>-fill</strong> 16959 command line argument or X resource. Note, that if the background and pen 16960 colors are the same, labels will not appear. 16961 <p> 16962 Initially, the composite image title is placed at the top if one is specified 16963 (refer to <strong>-fill</strong>). Next, each image is set onto the composite image, 16964 surrounded by its border color, with its name centered just below it. The 16965 individual images are left-justified within the width of the tiled area. 16966 The order of the images is the same as they appear on the command line 16967 unless the images have a scene keyword. If a scene number is specified 16968 in each image, then the images are tiled onto the composite in the order 16969 of their scene number. Finally, the last argument on the command line is 16970 the name assigned to the composite image. By default, the image is written 16971 in the <strong>MIFF</strong> format and can be viewed or printed with 16972 <em>display(1)</em>. 16973 <br> <br> 16974 <p> 16975 Note, that if the number of tiles exceeds the default number of 20 (5 per 16976 row, 4 per column), more than one composite image is created. To ensure 16977 a single image is produced, use <strong>-tile</strong> to increase the number of 16978 tiles to meet or exceed the number of input images. 16979 <p> 16980 Finally, to create one or more empty spaces in the sequence of tiles, use 16981 the <strong>"NULL:"</strong> image format. 16982 <p> 16983 Note, a composite MIFF image displayed to an X server with 16984 <strong>display</strong> 16985 behaves differently than other images. You can think of the composite as 16986 a visual image directory. Choose a particular tile of the composite and 16987 press a button to display it. See <strong>display(1)</strong> and <strong>miff(5)</strong> 16988 </td></tr></table> 16989 <p> 16990 <i><a href="#top">Back to Contents</a></i> 16991 </p> 16992 <table BORDER=0 WIDTH="100%"> 16993 <tr> 16994 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 16995 SRC="images/right_triangle.png" ALT=">" BORDER=0 16996 height=14 width=15><b><font face="Helvetica, Arial"><font 16997 color="#00B04F"><font size="+1"> 16998 <a NAME="mont-exam"></a>Examples 16999 </font></font></font></b></td></tr></table> 17000 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 17001 <tr><td width="3%"><br></td><td> 17002 <p> 17003 To create a montage of a cockatoo, a parrot, and a hummingbird and write 17004 it to a file called birds, use: 17005 <pre> 17006 gm montage cockatoo.miff parrot.miff hummingbird.miff 17007 birds.miff 17008 </pre> 17009 <p> 17010 To tile several bird images so that they are at most 256 pixels in width 17011 and 192 pixels in height, surrounded by a red border, and separated by 17012 10 pixels of background color, use: 17013 <pre> 17014 gm montage -geometry 256x192+10+10 -bordercolor red 17015 birds.* montage.miff 17016 </pre> 17017 <p> 17018 To create an unlabeled parrot image, 640 by 480 pixels, and surrounded 17019 by a border of black, use: 17020 <pre> 17021 gm montage -geometry 640x480 -bordercolor black 17022 -label "" parrot.miff bird.miff 17023 </pre> 17024 <p> 17025 To create an image of an eagle with a textured background, use: 17026 <pre> 17027 gm montage -texture bumps.jpg eagle.jpg eagle.png 17028 </pre> 17029 <p> 17030 To join several GIF images together without any extraneous graphics (e.g. 17031 no label, no shadowing, no surrounding tile frame), use: 17032 <pre> 17033 gm montage +frame +shadow +label -tile 5x1 17034 -geometry 50x50+0+0 *.png joined.png 17035 </pre> 17036 </td></tr></table> 17037 <p> 17038 <i><a href="#top">Back to Contents</a></i> 17039 </p> 17040 <table BORDER=0 WIDTH="100%"> 17041 <tr> 17042 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 17043 SRC="images/right_triangle.png" ALT=">" BORDER=0 17044 height=14 width=15><b><font face="Helvetica, Arial"><font 17045 color="#00B04F"><font size="+1"> 17046 <a NAME="mont-opti"></a>Options 17047 </font></font></font></b></td></tr></table> 17048 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 17049 <tr><td width="3%"><br></td><td> 17050 <p> 17051 Any option you specify on the command line remains in effect for the group 17052 of images following it, until the group is terminated by the appearance of 17053 any option or <strong>-noop</strong>. For example, to make a montage of three images, 17054 the first with 32 colors, the second with an unlimited number of colors, and 17055 the third with only 16 colors, use: 17056 <br> <br> 17057 <pre> 17058 gm montage -colors 32 cockatoo.1 -noop cockatoo.2 17059 -colors 16 cockatoo.3 cockatoos.miff 17060 </pre> 17061 <p> 17062 For a more detailed description of each option, see 17063 Options, above. 17064 <br> <br> 17065 <table BORDER=0 WIDTH="94%"> 17066 <tr> 17067 <td width="3%"><br></td> 17068 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17069 <img SRC="images/right_triangle_option.png" 17070 ALT=">" BORDER=0 height=14 17071 width=15><b><font face="Helvetica, Arial" 17072 ><font color="#00B04F"><font size="+1"> 17073 <a href="GraphicsMagick.html#details-adjoin">-adjoin</a> 17074 </font></font></font></b></td></tr></table> 17075 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>join images into a single multi-image file</td></tr></table> 17076 <table BORDER=0 WIDTH="94%"> 17077 <tr> 17078 <td width="3%"><br></td> 17079 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17080 <img SRC="images/right_triangle_option.png" 17081 ALT=">" BORDER=0 height=14 17082 width=15><b><font face="Helvetica, Arial" 17083 ><font color="#00B04F"><font size="+1"> 17084 <a href="GraphicsMagick.html#details-affine">-affine</a> <i><matrix></i> 17085 </font></font></font></b></td></tr></table> 17086 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>drawing transform matrix</td></tr></table> 17087 <table BORDER=0 WIDTH="94%"> 17088 <tr> 17089 <td width="3%"><br></td> 17090 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17091 <img SRC="images/right_triangle_option.png" 17092 ALT=">" BORDER=0 height=14 17093 width=15><b><font face="Helvetica, Arial" 17094 ><font color="#00B04F"><font size="+1"> 17095 <a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i><string></i> 17096 </font></font></font></b></td></tr></table> 17097 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table> 17098 <table BORDER=0 WIDTH="94%"> 17099 <tr> 17100 <td width="3%"><br></td> 17101 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17102 <img SRC="images/right_triangle_option.png" 17103 ALT=">" BORDER=0 height=14 17104 width=15><b><font face="Helvetica, Arial" 17105 ><font color="#00B04F"><font size="+1"> 17106 <a href="GraphicsMagick.html#details-background">-background</a> <i><color></i> 17107 </font></font></font></b></td></tr></table> 17108 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the background color</td></tr></table> 17109 <table BORDER=0 WIDTH="94%"> 17110 <tr> 17111 <td width="3%"><br></td> 17112 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17113 <img SRC="images/right_triangle_option.png" 17114 ALT=">" BORDER=0 height=14 17115 width=15><b><font face="Helvetica, Arial" 17116 ><font color="#00B04F"><font size="+1"> 17117 <a href="GraphicsMagick.html#details-blue-primary">-blue-primary</a> <i><x>,<y></i> 17118 </font></font></font></b></td></tr></table> 17119 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blue chromaticity primary point</td></tr></table> 17120 <table BORDER=0 WIDTH="94%"> 17121 <tr> 17122 <td width="3%"><br></td> 17123 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17124 <img SRC="images/right_triangle_option.png" 17125 ALT=">" BORDER=0 height=14 17126 width=15><b><font face="Helvetica, Arial" 17127 ><font color="#00B04F"><font size="+1"> 17128 <a href="GraphicsMagick.html#details-blur">-blur</a> <i><radius></i>{<i>x<sigma></i>}<i></i> 17129 </font></font></font></b></td></tr></table> 17130 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blur the image with a Gaussian operator</td></tr></table> 17131 <table BORDER=0 WIDTH="94%"> 17132 <tr> 17133 <td width="3%"><br></td> 17134 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17135 <img SRC="images/right_triangle_option.png" 17136 ALT=">" BORDER=0 height=14 17137 width=15><b><font face="Helvetica, Arial" 17138 ><font color="#00B04F"><font size="+1"> 17139 <a href="GraphicsMagick.html#details-bordercolor">-bordercolor</a> <i><color></i> 17140 </font></font></font></b></td></tr></table> 17141 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border color</td></tr></table> 17142 <table BORDER=0 WIDTH="94%"> 17143 <tr> 17144 <td width="3%"><br></td> 17145 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17146 <img SRC="images/right_triangle_option.png" 17147 ALT=">" BORDER=0 height=14 17148 width=15><b><font face="Helvetica, Arial" 17149 ><font color="#00B04F"><font size="+1"> 17150 -borderwidth <i><geometry></i> 17151 </font></font></font></b></td></tr></table> 17152 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border width</td></tr></table> 17153 <table BORDER=0 WIDTH="94%"> 17154 <tr> 17155 <td width="3%"><br></td> 17156 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17157 <img SRC="images/right_triangle_option.png" 17158 ALT=">" BORDER=0 height=14 17159 width=15><b><font face="Helvetica, Arial" 17160 ><font color="#00B04F"><font size="+1"> 17161 <a href="GraphicsMagick.html#details-chop">-chop</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i> 17162 </font></font></font></b></td></tr></table> 17163 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove pixels from the interior of an image</td></tr></table> 17164 <table BORDER=0 WIDTH="94%"> 17165 <tr> 17166 <td width="3%"><br></td> 17167 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17168 <img SRC="images/right_triangle_option.png" 17169 ALT=">" BORDER=0 height=14 17170 width=15><b><font face="Helvetica, Arial" 17171 ><font color="#00B04F"><font size="+1"> 17172 <a href="GraphicsMagick.html#details-colors">-colors</a> <i><value></i> 17173 </font></font></font></b></td></tr></table> 17174 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table> 17175 <table BORDER=0 WIDTH="94%"> 17176 <tr> 17177 <td width="3%"><br></td> 17178 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17179 <img SRC="images/right_triangle_option.png" 17180 ALT=">" BORDER=0 height=14 17181 width=15><b><font face="Helvetica, Arial" 17182 ><font color="#00B04F"><font size="+1"> 17183 <a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i><value></i> 17184 </font></font></font></b></td></tr></table> 17185 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table> 17186 <table BORDER=0 WIDTH="94%"> 17187 <tr> 17188 <td width="3%"><br></td> 17189 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17190 <img SRC="images/right_triangle_option.png" 17191 ALT=">" BORDER=0 height=14 17192 width=15><b><font face="Helvetica, Arial" 17193 ><font color="#00B04F"><font size="+1"> 17194 <a href="GraphicsMagick.html#details-comment">-comment</a> <i><string></i> 17195 </font></font></font></b></td></tr></table> 17196 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with a comment</td></tr></table> 17197 <table BORDER=0 WIDTH="94%"> 17198 <tr> 17199 <td width="3%"><br></td> 17200 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17201 <img SRC="images/right_triangle_option.png" 17202 ALT=">" BORDER=0 height=14 17203 width=15><b><font face="Helvetica, Arial" 17204 ><font color="#00B04F"><font size="+1"> 17205 <a href="GraphicsMagick.html#details-compose">-compose</a> <i><operator></i> 17206 </font></font></font></b></td></tr></table> 17207 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image composition</td></tr></table> 17208 <table BORDER=0 WIDTH="94%"> 17209 <tr> 17210 <td width="3%"><br></td> 17211 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17212 <img SRC="images/right_triangle_option.png" 17213 ALT=">" BORDER=0 height=14 17214 width=15><b><font face="Helvetica, Arial" 17215 ><font color="#00B04F"><font size="+1"> 17216 <a href="GraphicsMagick.html#details-compress">-compress</a> <i><type></i> 17217 </font></font></font></b></td></tr></table> 17218 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image compression</td></tr></table> 17219 <table BORDER=0 WIDTH="94%"> 17220 <tr> 17221 <td width="3%"><br></td> 17222 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17223 <img SRC="images/right_triangle_option.png" 17224 ALT=">" BORDER=0 height=14 17225 width=15><b><font face="Helvetica, Arial" 17226 ><font color="#00B04F"><font size="+1"> 17227 <a href="GraphicsMagick.html#details-crop">-crop</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i> 17228 </font></font></font></b></td></tr></table> 17229 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the cropped image</td></tr></table> 17230 <table BORDER=0 WIDTH="94%"> 17231 <tr> 17232 <td width="3%"><br></td> 17233 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17234 <img SRC="images/right_triangle_option.png" 17235 ALT=">" BORDER=0 height=14 17236 width=15><b><font face="Helvetica, Arial" 17237 ><font color="#00B04F"><font size="+1"> 17238 -debug <i><events></i> 17239 </font></font></font></b></td></tr></table> 17240 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table> 17241 <table BORDER=0 WIDTH="94%"> 17242 <tr> 17243 <td width="3%"><br></td> 17244 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17245 <img SRC="images/right_triangle_option.png" 17246 ALT=">" BORDER=0 height=14 17247 width=15><b><font face="Helvetica, Arial" 17248 ><font color="#00B04F"><font size="+1"> 17249 <a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i> 17250 </font></font></font></b></td></tr></table> 17251 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table> 17252 <table BORDER=0 WIDTH="94%"> 17253 <tr> 17254 <td width="3%"><br></td> 17255 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17256 <img SRC="images/right_triangle_option.png" 17257 ALT=">" BORDER=0 height=14 17258 width=15><b><font face="Helvetica, Arial" 17259 ><font color="#00B04F"><font size="+1"> 17260 <a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i> 17261 </font></font></font></b></td></tr></table> 17262 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table> 17263 <table BORDER=0 WIDTH="94%"> 17264 <tr> 17265 <td width="3%"><br></td> 17266 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17267 <img SRC="images/right_triangle_option.png" 17268 ALT=">" BORDER=0 height=14 17269 width=15><b><font face="Helvetica, Arial" 17270 ><font color="#00B04F"><font size="+1"> 17271 <a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i> 17272 </font></font></font></b></td></tr></table> 17273 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table> 17274 <table BORDER=0 WIDTH="94%"> 17275 <tr> 17276 <td width="3%"><br></td> 17277 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17278 <img SRC="images/right_triangle_option.png" 17279 ALT=">" BORDER=0 height=14 17280 width=15><b><font face="Helvetica, Arial" 17281 ><font color="#00B04F"><font size="+1"> 17282 <a href="GraphicsMagick.html#details-display">-display</a> <i><host:display[.screen]></i> 17283 </font></font></font></b></td></tr></table> 17284 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table> 17285 <table BORDER=0 WIDTH="94%"> 17286 <tr> 17287 <td width="3%"><br></td> 17288 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17289 <img SRC="images/right_triangle_option.png" 17290 ALT=">" BORDER=0 height=14 17291 width=15><b><font face="Helvetica, Arial" 17292 ><font color="#00B04F"><font size="+1"> 17293 <a href="GraphicsMagick.html#details-dispose">-dispose</a> <i><method></i> 17294 </font></font></font></b></td></tr></table> 17295 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table> 17296 <table BORDER=0 WIDTH="94%"> 17297 <tr> 17298 <td width="3%"><br></td> 17299 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17300 <img SRC="images/right_triangle_option.png" 17301 ALT=">" BORDER=0 height=14 17302 width=15><b><font face="Helvetica, Arial" 17303 ><font color="#00B04F"><font size="+1"> 17304 <a href="GraphicsMagick.html#details-dither">-dither</a> 17305 </font></font></font></b></td></tr></table> 17306 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table> 17307 <table BORDER=0 WIDTH="94%"> 17308 <tr> 17309 <td width="3%"><br></td> 17310 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17311 <img SRC="images/right_triangle_option.png" 17312 ALT=">" BORDER=0 height=14 17313 width=15><b><font face="Helvetica, Arial" 17314 ><font color="#00B04F"><font size="+1"> 17315 <a href="GraphicsMagick.html#details-draw">-draw</a> <i><string></i> 17316 </font></font></font></b></td></tr></table> 17317 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with one or more graphic primitives</td></tr></table> 17318 <table BORDER=0 WIDTH="94%"> 17319 <tr> 17320 <td width="3%"><br></td> 17321 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17322 <img SRC="images/right_triangle_option.png" 17323 ALT=">" BORDER=0 height=14 17324 width=15><b><font face="Helvetica, Arial" 17325 ><font color="#00B04F"><font size="+1"> 17326 <a href="GraphicsMagick.html#details-encoding">-encoding</a> <i><type></i> 17327 </font></font></font></b></td></tr></table> 17328 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the text encoding</td></tr></table> 17329 <table BORDER=0 WIDTH="94%"> 17330 <tr> 17331 <td width="3%"><br></td> 17332 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17333 <img SRC="images/right_triangle_option.png" 17334 ALT=">" BORDER=0 height=14 17335 width=15><b><font face="Helvetica, Arial" 17336 ><font color="#00B04F"><font size="+1"> 17337 <a href="GraphicsMagick.html#details-endian">-endian</a> <i><type></i> 17338 </font></font></font></b></td></tr></table> 17339 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify endianness (MSB, LSB, or Native) of image</td></tr></table> 17340 <table BORDER=0 WIDTH="94%"> 17341 <tr> 17342 <td width="3%"><br></td> 17343 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17344 <img SRC="images/right_triangle_option.png" 17345 ALT=">" BORDER=0 height=14 17346 width=15><b><font face="Helvetica, Arial" 17347 ><font color="#00B04F"><font size="+1"> 17348 <a href="GraphicsMagick.html#details-fill">-fill</a> <i><color></i> 17349 </font></font></font></b></td></tr></table> 17350 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color to use when filling a graphic primitive</td></tr></table> 17351 <table BORDER=0 WIDTH="94%"> 17352 <tr> 17353 <td width="3%"><br></td> 17354 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17355 <img SRC="images/right_triangle_option.png" 17356 ALT=">" BORDER=0 height=14 17357 width=15><b><font face="Helvetica, Arial" 17358 ><font color="#00B04F"><font size="+1"> 17359 <a href="GraphicsMagick.html#details-filter">-filter</a> <i><type></i> 17360 </font></font></font></b></td></tr></table> 17361 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this type of filter when resizing an image</td></tr></table> 17362 <table BORDER=0 WIDTH="94%"> 17363 <tr> 17364 <td width="3%"><br></td> 17365 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17366 <img SRC="images/right_triangle_option.png" 17367 ALT=">" BORDER=0 height=14 17368 width=15><b><font face="Helvetica, Arial" 17369 ><font color="#00B04F"><font size="+1"> 17370 <a href="GraphicsMagick.html#details-font">-font</a> <i><name></i> 17371 </font></font></font></b></td></tr></table> 17372 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this font when annotating the image with text</td></tr></table> 17373 <table BORDER=0 WIDTH="94%"> 17374 <tr> 17375 <td width="3%"><br></td> 17376 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17377 <img SRC="images/right_triangle_option.png" 17378 ALT=">" BORDER=0 height=14 17379 width=15><b><font face="Helvetica, Arial" 17380 ><font color="#00B04F"><font size="+1"> 17381 <a href="GraphicsMagick.html#details-frame">-frame</a> <i><width>x<height>+<outer bevel width>+<inner bevel width></i> 17382 </font></font></font></b></td></tr></table> 17383 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with an ornamental border</td></tr></table> 17384 <table BORDER=0 WIDTH="94%"> 17385 <tr> 17386 <td width="3%"><br></td> 17387 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17388 <img SRC="images/right_triangle_option.png" 17389 ALT=">" BORDER=0 height=14 17390 width=15><b><font face="Helvetica, Arial" 17391 ><font color="#00B04F"><font size="+1"> 17392 <a href="GraphicsMagick.html#details-gamma">-gamma</a> <i><value></i> 17393 </font></font></font></b></td></tr></table> 17394 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>level of gamma correction</td></tr></table> 17395 <table BORDER=0 WIDTH="94%"> 17396 <tr> 17397 <td width="3%"><br></td> 17398 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17399 <img SRC="images/right_triangle_option.png" 17400 ALT=">" BORDER=0 height=14 17401 width=15><b><font face="Helvetica, Arial" 17402 ><font color="#00B04F"><font size="+1"> 17403 <a href="GraphicsMagick.html#details-geometry">-geometry</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i>^</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 17404 </font></font></font></b></td></tr></table> 17405 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify dimension, offset, and resize options.</td></tr></table> 17406 <table BORDER=0 WIDTH="94%"> 17407 <tr> 17408 <td width="3%"><br></td> 17409 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17410 <img SRC="images/right_triangle_option.png" 17411 ALT=">" BORDER=0 height=14 17412 width=15><b><font face="Helvetica, Arial" 17413 ><font color="#00B04F"><font size="+1"> 17414 <a href="GraphicsMagick.html#details-gravity">-gravity</a> <i><type></i> 17415 </font></font></font></b></td></tr></table> 17416 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>direction primitive gravitates to when annotating the image.</td></tr></table> 17417 <table BORDER=0 WIDTH="94%"> 17418 <tr> 17419 <td width="3%"><br></td> 17420 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17421 <img SRC="images/right_triangle_option.png" 17422 ALT=">" BORDER=0 height=14 17423 width=15><b><font face="Helvetica, Arial" 17424 ><font color="#00B04F"><font size="+1"> 17425 <a href="GraphicsMagick.html#details-green-primary">-green-primary</a> <i><x>,<y></i> 17426 </font></font></font></b></td></tr></table> 17427 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>green chromaticity primary point</td></tr></table> 17428 <table BORDER=0 WIDTH="94%"> 17429 <tr> 17430 <td width="3%"><br></td> 17431 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17432 <img SRC="images/right_triangle_option.png" 17433 ALT=">" BORDER=0 height=14 17434 width=15><b><font face="Helvetica, Arial" 17435 ><font color="#00B04F"><font size="+1"> 17436 -help 17437 </font></font></font></b></td></tr></table> 17438 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table> 17439 <table BORDER=0 WIDTH="94%"> 17440 <tr> 17441 <td width="3%"><br></td> 17442 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17443 <img SRC="images/right_triangle_option.png" 17444 ALT=">" BORDER=0 height=14 17445 width=15><b><font face="Helvetica, Arial" 17446 ><font color="#00B04F"><font size="+1"> 17447 <a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i> 17448 </font></font></font></b></td></tr></table> 17449 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table> 17450 <table BORDER=0 WIDTH="94%"> 17451 <tr> 17452 <td width="3%"><br></td> 17453 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17454 <img SRC="images/right_triangle_option.png" 17455 ALT=">" BORDER=0 height=14 17456 width=15><b><font face="Helvetica, Arial" 17457 ><font color="#00B04F"><font size="+1"> 17458 <a href="GraphicsMagick.html#details-label">-label</a> <i><name></i> 17459 </font></font></font></b></td></tr></table> 17460 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign a label to an image</td></tr></table> 17461 <table BORDER=0 WIDTH="94%"> 17462 <tr> 17463 <td width="3%"><br></td> 17464 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17465 <img SRC="images/right_triangle_option.png" 17466 ALT=">" BORDER=0 height=14 17467 width=15><b><font face="Helvetica, Arial" 17468 ><font color="#00B04F"><font size="+1"> 17469 <a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i> 17470 </font></font></font></b></td></tr></table> 17471 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table> 17472 <table BORDER=0 WIDTH="94%"> 17473 <tr> 17474 <td width="3%"><br></td> 17475 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17476 <img SRC="images/right_triangle_option.png" 17477 ALT=">" BORDER=0 height=14 17478 width=15><b><font face="Helvetica, Arial" 17479 ><font color="#00B04F"><font size="+1"> 17480 <a href="GraphicsMagick.html#details-log">-log</a> <i><string></i> 17481 </font></font></font></b></td></tr></table> 17482 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table> 17483 <table BORDER=0 WIDTH="94%"> 17484 <tr> 17485 <td width="3%"><br></td> 17486 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17487 <img SRC="images/right_triangle_option.png" 17488 ALT=">" BORDER=0 height=14 17489 width=15><b><font face="Helvetica, Arial" 17490 ><font color="#00B04F"><font size="+1"> 17491 <a href="GraphicsMagick.html#details-matte">-matte</a> 17492 </font></font></font></b></td></tr></table> 17493 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table> 17494 <table BORDER=0 WIDTH="94%"> 17495 <tr> 17496 <td width="3%"><br></td> 17497 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17498 <img SRC="images/right_triangle_option.png" 17499 ALT=">" BORDER=0 height=14 17500 width=15><b><font face="Helvetica, Arial" 17501 ><font color="#00B04F"><font size="+1"> 17502 <a href="GraphicsMagick.html#details-mattecolor">-mattecolor</a> <i><color></i> 17503 </font></font></font></b></td></tr></table> 17504 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the color to be used with the <strong>-frame</strong> option</td></tr></table> 17505 <table BORDER=0 WIDTH="94%"> 17506 <tr> 17507 <td width="3%"><br></td> 17508 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17509 <img SRC="images/right_triangle_option.png" 17510 ALT=">" BORDER=0 height=14 17511 width=15><b><font face="Helvetica, Arial" 17512 ><font color="#00B04F"><font size="+1"> 17513 -mode <i><value></i> 17514 </font></font></font></b></td></tr></table> 17515 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>mode of operation</td></tr></table> 17516 <table BORDER=0 WIDTH="94%"> 17517 <tr> 17518 <td width="3%"><br></td> 17519 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17520 <img SRC="images/right_triangle_option.png" 17521 ALT=">" BORDER=0 height=14 17522 width=15><b><font face="Helvetica, Arial" 17523 ><font color="#00B04F"><font size="+1"> 17524 -monitor 17525 </font></font></font></b></td></tr></table> 17526 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>show progress indication</td></tr></table> 17527 <table BORDER=0 WIDTH="94%"> 17528 <tr> 17529 <td width="3%"><br></td> 17530 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17531 <img SRC="images/right_triangle_option.png" 17532 ALT=">" BORDER=0 height=14 17533 width=15><b><font face="Helvetica, Arial" 17534 ><font color="#00B04F"><font size="+1"> 17535 -monochrome 17536 </font></font></font></b></td></tr></table> 17537 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table> 17538 <table BORDER=0 WIDTH="94%"> 17539 <tr> 17540 <td width="3%"><br></td> 17541 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17542 <img SRC="images/right_triangle_option.png" 17543 ALT=">" BORDER=0 height=14 17544 width=15><b><font face="Helvetica, Arial" 17545 ><font color="#00B04F"><font size="+1"> 17546 <a href="GraphicsMagick.html#details-noop">-noop</a> 17547 </font></font></font></b></td></tr></table> 17548 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>NOOP (no option)</td></tr></table> 17549 <table BORDER=0 WIDTH="94%"> 17550 <tr> 17551 <td width="3%"><br></td> 17552 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17553 <img SRC="images/right_triangle_option.png" 17554 ALT=">" BORDER=0 height=14 17555 width=15><b><font face="Helvetica, Arial" 17556 ><font color="#00B04F"><font size="+1"> 17557 <a href="GraphicsMagick.html#details-page">-page</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 17558 </font></font></font></b></td></tr></table> 17559 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>size and location of an image canvas</td></tr></table> 17560 <table BORDER=0 WIDTH="94%"> 17561 <tr> 17562 <td width="3%"><br></td> 17563 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17564 <img SRC="images/right_triangle_option.png" 17565 ALT=">" BORDER=0 height=14 17566 width=15><b><font face="Helvetica, Arial" 17567 ><font color="#00B04F"><font size="+1"> 17568 <a href="GraphicsMagick.html#details-pen">-pen</a> <i><color></i> 17569 </font></font></font></b></td></tr></table> 17570 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -fill option)</td></tr></table> 17571 <table BORDER=0 WIDTH="94%"> 17572 <tr> 17573 <td width="3%"><br></td> 17574 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17575 <img SRC="images/right_triangle_option.png" 17576 ALT=">" BORDER=0 height=14 17577 width=15><b><font face="Helvetica, Arial" 17578 ><font color="#00B04F"><font size="+1"> 17579 -pointsize <i><value></i> 17580 </font></font></font></b></td></tr></table> 17581 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pointsize of the PostScript, X11, or TrueType font</td></tr></table> 17582 <table BORDER=0 WIDTH="94%"> 17583 <tr> 17584 <td width="3%"><br></td> 17585 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17586 <img SRC="images/right_triangle_option.png" 17587 ALT=">" BORDER=0 height=14 17588 width=15><b><font face="Helvetica, Arial" 17589 ><font color="#00B04F"><font size="+1"> 17590 <a href="GraphicsMagick.html#details-quality">-quality</a> <i><value></i> 17591 </font></font></font></b></td></tr></table> 17592 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>JPEG/MIFF/PNG/TIFF compression level</td></tr></table> 17593 <table BORDER=0 WIDTH="94%"> 17594 <tr> 17595 <td width="3%"><br></td> 17596 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17597 <img SRC="images/right_triangle_option.png" 17598 ALT=">" BORDER=0 height=14 17599 width=15><b><font face="Helvetica, Arial" 17600 ><font color="#00B04F"><font size="+1"> 17601 <a href="GraphicsMagick.html#details-red-primary">-red-primary</a> <i><x>,<y></i> 17602 </font></font></font></b></td></tr></table> 17603 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>red chromaticity primary point</td></tr></table> 17604 <table BORDER=0 WIDTH="94%"> 17605 <tr> 17606 <td width="3%"><br></td> 17607 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17608 <img SRC="images/right_triangle_option.png" 17609 ALT=">" BORDER=0 height=14 17610 width=15><b><font face="Helvetica, Arial" 17611 ><font color="#00B04F"><font size="+1"> 17612 <a href="GraphicsMagick.html#details-render">-render</a> 17613 </font></font></font></b></td></tr></table> 17614 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>render vector operations</td></tr></table> 17615 <table BORDER=0 WIDTH="94%"> 17616 <tr> 17617 <td width="3%"><br></td> 17618 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17619 <img SRC="images/right_triangle_option.png" 17620 ALT=">" BORDER=0 height=14 17621 width=15><b><font face="Helvetica, Arial" 17622 ><font color="#00B04F"><font size="+1"> 17623 <a href="GraphicsMagick.html#details-repage">-repage</a> <i> <width>x<height>+xoff+yoff[!]</i> 17624 </font></font></font></b></td></tr></table> 17625 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Adjust image page offsets</td></tr></table> 17626 <table BORDER=0 WIDTH="94%"> 17627 <tr> 17628 <td width="3%"><br></td> 17629 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17630 <img SRC="images/right_triangle_option.png" 17631 ALT=">" BORDER=0 height=14 17632 width=15><b><font face="Helvetica, Arial" 17633 ><font color="#00B04F"><font size="+1"> 17634 <a href="GraphicsMagick.html#details-resize">-resize</a> <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 17635 </font></font></font></b></td></tr></table> 17636 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image</td></tr></table> 17637 <table BORDER=0 WIDTH="94%"> 17638 <tr> 17639 <td width="3%"><br></td> 17640 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17641 <img SRC="images/right_triangle_option.png" 17642 ALT=">" BORDER=0 height=14 17643 width=15><b><font face="Helvetica, Arial" 17644 ><font color="#00B04F"><font size="+1"> 17645 <a href="GraphicsMagick.html#details-rotate">-rotate</a> <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 17646 </font></font></font></b></td></tr></table> 17647 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>rotate the image</td></tr></table> 17648 <table BORDER=0 WIDTH="94%"> 17649 <tr> 17650 <td width="3%"><br></td> 17651 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17652 <img SRC="images/right_triangle_option.png" 17653 ALT=">" BORDER=0 height=14 17654 width=15><b><font face="Helvetica, Arial" 17655 ><font color="#00B04F"><font size="+1"> 17656 <a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i> 17657 </font></font></font></b></td></tr></table> 17658 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chroma subsampling factors</td></tr></table> 17659 <table BORDER=0 WIDTH="94%"> 17660 <tr> 17661 <td width="3%"><br></td> 17662 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17663 <img SRC="images/right_triangle_option.png" 17664 ALT=">" BORDER=0 height=14 17665 width=15><b><font face="Helvetica, Arial" 17666 ><font color="#00B04F"><font size="+1"> 17667 <a href="GraphicsMagick.html#details-scenes">-scenes</a> <i><value-value></i> 17668 </font></font></font></b></td></tr></table> 17669 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>range of image scene numbers to read</td></tr></table> 17670 <table BORDER=0 WIDTH="94%"> 17671 <tr> 17672 <td width="3%"><br></td> 17673 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17674 <img SRC="images/right_triangle_option.png" 17675 ALT=">" BORDER=0 height=14 17676 width=15><b><font face="Helvetica, Arial" 17677 ><font color="#00B04F"><font size="+1"> 17678 -shadow <i><radius></i>{<i>x<sigma></i>}<i></i> 17679 </font></font></font></b></td></tr></table> 17680 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shadow the montage</td></tr></table> 17681 <table BORDER=0 WIDTH="94%"> 17682 <tr> 17683 <td width="3%"><br></td> 17684 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17685 <img SRC="images/right_triangle_option.png" 17686 ALT=">" BORDER=0 height=14 17687 width=15><b><font face="Helvetica, Arial" 17688 ><font color="#00B04F"><font size="+1"> 17689 <a href="GraphicsMagick.html#details-sharpen">-sharpen</a> <i><radius></i>{<i>x<sigma></i>}<i></i> 17690 </font></font></font></b></td></tr></table> 17691 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image</td></tr></table> 17692 <table BORDER=0 WIDTH="94%"> 17693 <tr> 17694 <td width="3%"><br></td> 17695 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17696 <img SRC="images/right_triangle_option.png" 17697 ALT=">" BORDER=0 height=14 17698 width=15><b><font face="Helvetica, Arial" 17699 ><font color="#00B04F"><font size="+1"> 17700 <a href="GraphicsMagick.html#details-size">-size</a> <i><width>x<height></i>{<i>+offset</i>}<i></i> 17701 </font></font></font></b></td></tr></table> 17702 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table> 17703 <table BORDER=0 WIDTH="94%"> 17704 <tr> 17705 <td width="3%"><br></td> 17706 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17707 <img SRC="images/right_triangle_option.png" 17708 ALT=">" BORDER=0 height=14 17709 width=15><b><font face="Helvetica, Arial" 17710 ><font color="#00B04F"><font size="+1"> 17711 <a href="GraphicsMagick.html#details-strip">-strip</a> 17712 </font></font></font></b></td></tr></table> 17713 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove all profiles and text attributes from the image</td></tr></table> 17714 <table BORDER=0 WIDTH="94%"> 17715 <tr> 17716 <td width="3%"><br></td> 17717 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17718 <img SRC="images/right_triangle_option.png" 17719 ALT=">" BORDER=0 height=14 17720 width=15><b><font face="Helvetica, Arial" 17721 ><font color="#00B04F"><font size="+1"> 17722 <a href="GraphicsMagick.html#details-stroke">-stroke</a> <i><color></i> 17723 </font></font></font></b></td></tr></table> 17724 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color to use when stroking a graphic primitive</td></tr></table> 17725 <table BORDER=0 WIDTH="94%"> 17726 <tr> 17727 <td width="3%"><br></td> 17728 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17729 <img SRC="images/right_triangle_option.png" 17730 ALT=">" BORDER=0 height=14 17731 width=15><b><font face="Helvetica, Arial" 17732 ><font color="#00B04F"><font size="+1"> 17733 <a href="GraphicsMagick.html#details-strokewidth">-strokewidth</a> <i><value></i> 17734 </font></font></font></b></td></tr></table> 17735 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set the stroke width</td></tr></table> 17736 <table BORDER=0 WIDTH="94%"> 17737 <tr> 17738 <td width="3%"><br></td> 17739 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17740 <img SRC="images/right_triangle_option.png" 17741 ALT=">" BORDER=0 height=14 17742 width=15><b><font face="Helvetica, Arial" 17743 ><font color="#00B04F"><font size="+1"> 17744 -texture <i><filename></i> 17745 </font></font></font></b></td></tr></table> 17746 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name of texture to tile onto the image background</td></tr></table> 17747 <table BORDER=0 WIDTH="94%"> 17748 <tr> 17749 <td width="3%"><br></td> 17750 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17751 <img SRC="images/right_triangle_option.png" 17752 ALT=">" BORDER=0 height=14 17753 width=15><b><font face="Helvetica, Arial" 17754 ><font color="#00B04F"><font size="+1"> 17755 <a href="GraphicsMagick.html#details-thumbnail">-thumbnail</a> <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 17756 </font></font></font></b></td></tr></table> 17757 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image (quickly)</td></tr></table> 17758 <table BORDER=0 WIDTH="94%"> 17759 <tr> 17760 <td width="3%"><br></td> 17761 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17762 <img SRC="images/right_triangle_option.png" 17763 ALT=">" BORDER=0 height=14 17764 width=15><b><font face="Helvetica, Arial" 17765 ><font color="#00B04F"><font size="+1"> 17766 -tile <i><geometry></i> 17767 </font></font></font></b></td></tr></table> 17768 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>layout of images [<em>montage</em>]</td></tr></table> 17769 <table BORDER=0 WIDTH="94%"> 17770 <tr> 17771 <td width="3%"><br></td> 17772 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17773 <img SRC="images/right_triangle_option.png" 17774 ALT=">" BORDER=0 height=14 17775 width=15><b><font face="Helvetica, Arial" 17776 ><font color="#00B04F"><font size="+1"> 17777 <a href="GraphicsMagick.html#details-title">-title</a> <i><string></i> 17778 </font></font></font></b></td></tr></table> 17779 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign title to displayed image [<em>animate, display, montage</em>]</td></tr></table> 17780 <table BORDER=0 WIDTH="94%"> 17781 <tr> 17782 <td width="3%"><br></td> 17783 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17784 <img SRC="images/right_triangle_option.png" 17785 ALT=">" BORDER=0 height=14 17786 width=15><b><font face="Helvetica, Arial" 17787 ><font color="#00B04F"><font size="+1"> 17788 <a href="GraphicsMagick.html#details-transform">-transform</a> 17789 </font></font></font></b></td></tr></table> 17790 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image</td></tr></table> 17791 <table BORDER=0 WIDTH="94%"> 17792 <tr> 17793 <td width="3%"><br></td> 17794 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17795 <img SRC="images/right_triangle_option.png" 17796 ALT=">" BORDER=0 height=14 17797 width=15><b><font face="Helvetica, Arial" 17798 ><font color="#00B04F"><font size="+1"> 17799 <a href="GraphicsMagick.html#details-transparent">-transparent</a> <i><color></i> 17800 </font></font></font></b></td></tr></table> 17801 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make this color transparent within the image</td></tr></table> 17802 <table BORDER=0 WIDTH="94%"> 17803 <tr> 17804 <td width="3%"><br></td> 17805 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17806 <img SRC="images/right_triangle_option.png" 17807 ALT=">" BORDER=0 height=14 17808 width=15><b><font face="Helvetica, Arial" 17809 ><font color="#00B04F"><font size="+1"> 17810 <a href="GraphicsMagick.html#details-treedepth">-treedepth</a> <i><value></i> 17811 </font></font></font></b></td></tr></table> 17812 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tree depth for the color reduction algorithm</td></tr></table> 17813 <table BORDER=0 WIDTH="94%"> 17814 <tr> 17815 <td width="3%"><br></td> 17816 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17817 <img SRC="images/right_triangle_option.png" 17818 ALT=">" BORDER=0 height=14 17819 width=15><b><font face="Helvetica, Arial" 17820 ><font color="#00B04F"><font size="+1"> 17821 <a href="GraphicsMagick.html#details-trim">-trim</a> 17822 </font></font></font></b></td></tr></table> 17823 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table> 17824 <table BORDER=0 WIDTH="94%"> 17825 <tr> 17826 <td width="3%"><br></td> 17827 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17828 <img SRC="images/right_triangle_option.png" 17829 ALT=">" BORDER=0 height=14 17830 width=15><b><font face="Helvetica, Arial" 17831 ><font color="#00B04F"><font size="+1"> 17832 <a href="GraphicsMagick.html#details-type">-type</a> <i><type></i> 17833 </font></font></font></b></td></tr></table> 17834 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image type</td></tr></table> 17835 <table BORDER=0 WIDTH="94%"> 17836 <tr> 17837 <td width="3%"><br></td> 17838 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17839 <img SRC="images/right_triangle_option.png" 17840 ALT=">" BORDER=0 height=14 17841 width=15><b><font face="Helvetica, Arial" 17842 ><font color="#00B04F"><font size="+1"> 17843 <a href="GraphicsMagick.html#details-verbose">-verbose</a> 17844 </font></font></font></b></td></tr></table> 17845 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table> 17846 <table BORDER=0 WIDTH="94%"> 17847 <tr> 17848 <td width="3%"><br></td> 17849 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17850 <img SRC="images/right_triangle_option.png" 17851 ALT=">" BORDER=0 height=14 17852 width=15><b><font face="Helvetica, Arial" 17853 ><font color="#00B04F"><font size="+1"> 17854 <a href="GraphicsMagick.html#details-version">-version</a> 17855 </font></font></font></b></td></tr></table> 17856 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table> 17857 <table BORDER=0 WIDTH="94%"> 17858 <tr> 17859 <td width="3%"><br></td> 17860 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17861 <img SRC="images/right_triangle_option.png" 17862 ALT=">" BORDER=0 height=14 17863 width=15><b><font face="Helvetica, Arial" 17864 ><font color="#00B04F"><font size="+1"> 17865 <a href="GraphicsMagick.html#details-white-point">-white-point</a> <i><x>,<y></i> 17866 </font></font></font></b></td></tr></table> 17867 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chromaticity white point</td></tr></table> 17868 <p> 17869 For a more detailed description of each option, see 17870 Options, above. 17871 <br> <br> 17872 </td></tr></table> 17873 <p> 17874 <i><a href="#top">Back to Contents</a></i> 17875 </p> 17876 <table BORDER=0 WIDTH="100%"> 17877 <tr> 17878 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 17879 SRC="images/right_triangle.png" ALT=">" BORDER=0 17880 height=14 width=15><b><font face="Helvetica, Arial"><font 17881 color="#00B04F"><font size="+1"> 17882 <a NAME="mont-xres"></a>X Resources 17883 </font></font></font></b></td></tr></table> 17884 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 17885 <tr><td width="3%"><br></td><td> 17886 <p> 17887 <strong>Montage</strong> options can appear on the command line or in your X resource 17888 file. Options on the command line supersede values specified in your X 17889 resource file. See <strong>X(1)</strong> for more information on X resources. 17890 <p> 17891 All <strong>montage</strong> options have a corresponding X resource. In addition, 17892 <strong>montage</strong> 17893 uses the following X resources: 17894 <table BORDER=0 WIDTH="94%"> 17895 <tr> 17896 <td width="3%"><br></td> 17897 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17898 <img SRC="images/right_triangle_option.png" 17899 ALT=">" BORDER=0 height=14 17900 width=15><b><font face="Helvetica, Arial" 17901 ><font color="#00B04F"><font size="+1"> 17902 background <i>(class Background)</i> 17903 </font></font></font></b></td></tr></table> 17904 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>background color</td></tr></table> 17905 <p> 17906 Specifies the preferred color to use for the composite image background. 17907 The default is #ccc. 17908 <table BORDER=0 WIDTH="94%"> 17909 <tr> 17910 <td width="3%"><br></td> 17911 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17912 <img SRC="images/right_triangle_option.png" 17913 ALT=">" BORDER=0 height=14 17914 width=15><b><font face="Helvetica, Arial" 17915 ><font color="#00B04F"><font size="+1"> 17916 borderColor <i>(class BorderColor)</i> 17917 </font></font></font></b></td></tr></table> 17918 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>border color</td></tr></table> 17919 <p> 17920 Specifies the preferred color to use for the composite image border. The 17921 default is #ccc. 17922 <table BORDER=0 WIDTH="94%"> 17923 <tr> 17924 <td width="3%"><br></td> 17925 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17926 <img SRC="images/right_triangle_option.png" 17927 ALT=">" BORDER=0 height=14 17928 width=15><b><font face="Helvetica, Arial" 17929 ><font color="#00B04F"><font size="+1"> 17930 borderWidth <i>(class BorderWidth)</i> 17931 </font></font></font></b></td></tr></table> 17932 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>border width</td></tr></table> 17933 <p> 17934 Specifies the width in pixels of the composite image border. The default 17935 is 2. 17936 <table BORDER=0 WIDTH="94%"> 17937 <tr> 17938 <td width="3%"><br></td> 17939 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17940 <img SRC="images/right_triangle_option.png" 17941 ALT=">" BORDER=0 height=14 17942 width=15><b><font face="Helvetica, Arial" 17943 ><font color="#00B04F"><font size="+1"> 17944 font <i>(class Font)</i> 17945 </font></font></font></b></td></tr></table> 17946 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>font to use</td></tr></table> 17947 <p> 17948 Specifies the name of the preferred font to use when displaying text within 17949 the composite image. The default is 9x15, fixed, or 5x8 determined by the 17950 composite image size. 17951 <table BORDER=0 WIDTH="94%"> 17952 <tr> 17953 <td width="3%"><br></td> 17954 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17955 <img SRC="images/right_triangle_option.png" 17956 ALT=">" BORDER=0 height=14 17957 width=15><b><font face="Helvetica, Arial" 17958 ><font color="#00B04F"><font size="+1"> 17959 matteColor <i>(class MatteColor)</i> 17960 </font></font></font></b></td></tr></table> 17961 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color of the frame</td></tr></table> 17962 <p> 17963 Specify the color of an image frame. A 3D effect is achieved by using highlight 17964 and shadow colors derived from this color. The default value is #697B8F. 17965 <table BORDER=0 WIDTH="94%"> 17966 <tr> 17967 <td width="3%"><br></td> 17968 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17969 <img SRC="images/right_triangle_option.png" 17970 ALT=">" BORDER=0 height=14 17971 width=15><b><font face="Helvetica, Arial" 17972 ><font color="#00B04F"><font size="+1"> 17973 pen <i>(class Pen)</i> 17974 </font></font></font></b></td></tr></table> 17975 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>text color</td></tr></table> 17976 <p> 17977 Specifies the preferred color to use for text within the composite image. 17978 The default is black. 17979 <table BORDER=0 WIDTH="94%"> 17980 <tr> 17981 <td width="3%"><br></td> 17982 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 17983 <img SRC="images/right_triangle_option.png" 17984 ALT=">" BORDER=0 height=14 17985 width=15><b><font face="Helvetica, Arial" 17986 ><font color="#00B04F"><font size="+1"> 17987 title <i>(class Title)</i> 17988 </font></font></font></b></td></tr></table> 17989 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>composite image title</td></tr></table> 17990 <p> 17991 This resource specifies the title to be placed at the top of the composite 17992 image. The default is not to place a title at the top of the composite 17993 image. 17994 </td></tr></table> 17995 <br> <br> 17996 <table BORDER=0 WIDTH="100%"> 17997 <tr> 17998 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 17999 SRC="images/right_triangle.png" ALT=">" BORDER=0 18000 height=14 width=15><b><font face="Helvetica, Arial"><font 18001 color="#00B04F"><font size="+1"> 18002 <a NAME="time"></a>gm time 18003 </font></font></font></b></td></tr></table> 18004 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 18005 <tr><td width="3%"><br></td><td> 18006 <table BORDER=0 WIDTH="100%"> 18007 <tr> 18008 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 18009 SRC="images/right_triangle.png" ALT=">" BORDER=0 18010 height=14 width=15><b><font face="Helvetica, Arial"><font 18011 color="#00B04F"><font size="+1"> 18012 <a NAME="time-desc"></a>Description 18013 </font></font></font></b></td></tr></table> 18014 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 18015 <tr><td width="3%"><br></td><td> 18016 <p> 18017 <strong>time</strong> executes an arbitrary <strong>gm</strong> utility command 18018 (e.g. <strong>convert</strong>) and reports the user and elapsed time. This 18019 provides way to measure command execution times similar to the Unix 18020 'time' command but in a portable and consistent way. 18021 </td></tr></table> 18022 <table BORDER=0 WIDTH="100%"> 18023 <tr> 18024 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 18025 SRC="images/right_triangle.png" ALT=">" BORDER=0 18026 height=14 width=15><b><font face="Helvetica, Arial"><font 18027 color="#00B04F"><font size="+1"> 18028 <a NAME="time-exam"></a>Examples 18029 </font></font></font></b></td></tr></table> 18030 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 18031 <tr><td width="3%"><br></td><td> 18032 <p>To obtain time information for the execution of a 18033 command: 18034 <pre> 18035 % gm time convert input.ppm -gaussian 0x2 output.ppm 18036 convert input.ppm -gaussian 0x2 output.ppm 22.60s user 0.00s system 2354% cpu 0.960 total 18037 </pre> 18038 <p>Here is the interpretation of the above output: 18039 <ul> 18040 <li><strong>user</strong> - the total user time consumed. 18041 <li><strong>system</strong> - the total system time consumed. 18042 <li><strong>total</strong> - the total elapsed time consumed. 18043 </ul> 18044 </td></tr></table> 18045 <p> 18046 <i><a href="#top">Back to Contents</a></i> 18047 </p> 18048 <table BORDER=0 WIDTH="100%"> 18049 <tr> 18050 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 18051 SRC="images/right_triangle.png" ALT=">" BORDER=0 18052 height=14 width=15><b><font face="Helvetica, Arial"><font 18053 color="#00B04F"><font size="+1"> 18054 <a NAME="time-opti"></a>Options 18055 </font></font></font></b></td></tr></table> 18056 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 18057 <tr><td width="3%"><br></td><td> 18058 <p>The time command reqires no options other than the gm command to 18059 execute. 18060 </td></tr></table> 18061 </td></tr></table> 18062 <br> <br> 18063 <table BORDER=0 WIDTH="100%"> 18064 <tr> 18065 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 18066 SRC="images/right_triangle.png" ALT=">" BORDER=0 18067 height=14 width=15><b><font face="Helvetica, Arial"><font 18068 color="#00B04F"><font size="+1"> 18069 <a NAME="version"></a>gm version 18070 </font></font></font></b></td></tr></table> 18071 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 18072 <tr><td width="3%"><br></td><td> 18073 <table BORDER=0 WIDTH="100%"> 18074 <tr> 18075 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 18076 SRC="images/right_triangle.png" ALT=">" BORDER=0 18077 height=14 width=15><b><font face="Helvetica, Arial"><font 18078 color="#00B04F"><font size="+1"> 18079 <a NAME="version-desc"></a>Description 18080 </font></font></font></b></td></tr></table> 18081 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 18082 <tr><td width="3%"><br></td><td> 18083 <p> 18084 <strong>version</strong> displays the software release version, build quantum 18085 (pixel sample) depth, web site URL, copyright notice, enabled features 18086 support, configuration parameters, and final build options used to 18087 build the software. The available information depends on how the 18088 software was configured and the host system. 18089 </td></tr></table> 18090 <table BORDER=0 WIDTH="100%"> 18091 <tr> 18092 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 18093 SRC="images/right_triangle.png" ALT=">" BORDER=0 18094 height=14 width=15><b><font face="Helvetica, Arial"><font 18095 color="#00B04F"><font size="+1"> 18096 <a NAME="version-exam"></a>Examples 18097 </font></font></font></b></td></tr></table> 18098 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 18099 <tr><td width="3%"><br></td><td> 18100 <p>To display the version information: 18101 <pre> 18102 GraphicsMagick 1.3.27a 2017-12-11 Q16 http://www.GraphicsMagick.org/ 18103 Copyright (C) 2002-2020 GraphicsMagick Group. 18104 Additional copyrights and licenses apply to this software. 18105 See http://www.GraphicsMagick.org/www/Copyright.html for details. 18106 Feature Support: 18107 Native Thread Safe yes 18108 Large Files (> 32 bit) yes 18109 Large Memory (> 32 bit) yes 18110 BZIP yes 18111 DPS no 18112 FlashPix no 18113 FreeType yes 18114 Ghostscript (Library) no 18115 JBIG yes 18116 JPEG-2000 yes 18117 JPEG yes 18118 Little CMS yes 18119 Loadable Modules no 18120 OpenMP yes (201307) 18121 PNG yes 18122 TIFF yes 18123 TRIO no 18124 UMEM no 18125 WebP yes 18126 WMF yes 18127 X11 yes 18128 XML yes 18129 ZLIB yes 18130 Host type: x86_64-unknown-linux-gnu 18131 Configured using the command: 18132 ./configure ... 18133 Final Build Parameters: 18134 CC = ... 18135 CFLAGS = ... 18136 CPPFLAGS = ... 18137 CXX = ... 18138 CXXFLAGS = ... 18139 LDFLAGS = ... 18140 LIBS = ... 18141 </pre> 18142 </td></tr></table> 18143 <p> 18144 <i><a href="#top">Back to Contents</a></i> 18145 </p> 18146 <table BORDER=0 WIDTH="100%"> 18147 <tr> 18148 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 18149 SRC="images/right_triangle.png" ALT=">" BORDER=0 18150 height=14 width=15><b><font face="Helvetica, Arial"><font 18151 color="#00B04F"><font size="+1"> 18152 <a NAME="version-opti"></a>Options 18153 </font></font></font></b></td></tr></table> 18154 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 18155 <tr><td width="3%"><br></td><td> 18156 <p>The version command does not currently support any options. 18157 </td></tr></table> 18158 </td></tr></table>