github.com/kaydxh/golang@v0.0.131/pkg/gocv/cgo/third_path/graphics-magick/share/doc/GraphicsMagick/www/GraphicsMagick.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="contents"></a>Contents 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 <dl> 47 <dt> 48 <a href="#syno">Synopsis</a> 49 </dt> 50 <dt> 51 <a href="#desc">Description</a> 52 </dt> 53 <dt> 54 <a href="#files">Files and Formats</a> 55 </dt> 56 <dt> 57 <a href="#opti">Options</a> 58 </dt> 59 <dt> 60 <a href="#envi">Environment</a> 61 </dt> 62 <dt> 63 <a href="#file">Configuration Files</a> 64 </dt> 65 <dt> 66 <a href="#auth">Authors</a> 67 </dt> 68 <dt> 69 <a href="#copy">Copyright</a> 70 </dt> 71 </dl> 72 </td></tr></table> 73 <table BORDER=0 WIDTH="100%"> 74 <tr> 75 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 76 SRC="images/right_triangle.png" ALT=">" BORDER=0 77 height=14 width=15><b><font face="Helvetica, Arial"><font 78 color="#00B04F"><font size="+1"> 79 <a NAME="syno"></a>Synopsis 80 </font></font></font></b></td></tr></table> 81 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 82 <tr><td width="3%"><br></td><td> 83 <p> 84 <strong>gm animate</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>file</em> <strong>[ [</strong> 85 <em>options ...</em> <strong>]</strong> <em>file ...</em> <strong>]</strong> 86 <p> 87 <strong>gm batch</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <strong>[</strong> <em>script</em> <strong>]</strong> 88 <p> 89 <strong>gm benchmark</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> subcommand 90 <p> 91 <strong>gm compare</strong> <strong>[</strong> <em>options</em> <strong>... ]</strong> <em>reference-image</em> 92 <strong>[</strong> <em>options</em> <strong>... ]</strong> <em>compare-image</em> 93 <strong>[</strong> <em>options</em> <strong>... ]</strong> 94 <p> 95 <strong>gm composite</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>change-image base-image</em> 96 <strong>[</strong> <em>mask-image</em> <strong>]</strong> <em>output-image</em> 97 <p> 98 <strong>gm conjure</strong> <strong>[</strong> <em>options</em> <strong>]</strong> <em>script.msl</em> 99 <strong>[ [</strong> <em>options</em> <strong>]</strong> <em>script.msl</em> <strong>]</strong> 100 <p> 101 <strong>gm convert</strong> <strong>[ [</strong> <em>options ...</em> <strong>] [</strong> <em>input-file ...</em> 102 <strong>] [</strong> <em>options ...</em> <strong>] ]</strong> <em>output-file</em> 103 <p> 104 <strong>gm display</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>file ...</em> 105 <strong>[ [</strong><em>options ...</em> <strong>]</strong><em>file ...</em> <strong>]</strong> 106 <p> 107 <strong>gm identify</strong> <em>file</em> <strong>[</strong> <em>file ...</em> <strong>]</strong> 108 <p> 109 <strong>gm import</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>file</em> 110 <p> 111 <strong>gm mogrify</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>file ...</em> 112 <p> 113 <strong>gm montage</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>file</em> <strong>[ [</strong> 114 <em>options ...</em> <strong>]</strong> <em>file ...</em> <strong>]</strong> <em>output-file</em> 115 <p> 116 <strong>gm time</strong> subcommand 117 <p> 118 <strong>gm version</strong> 119 </td></tr></table> 120 <table BORDER=0 WIDTH="100%"> 121 <tr> 122 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 123 SRC="images/right_triangle.png" ALT=">" BORDER=0 124 height=14 width=15><b><font face="Helvetica, Arial"><font 125 color="#00B04F"><font size="+1"> 126 <a NAME="desc"></a>Description 127 </font></font></font></b></td></tr></table> 128 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 129 <tr><td width="3%"><br></td><td> 130 <p> 131 GraphicsMagick's <strong>gm</strong> provides a suite of utilities for creating, 132 comparing, converting, editing, and displaying images. All of the 133 utilities are provided as sub-commands of a single <strong>gm</strong> 134 executable. The <strong>gm</strong> executable returns the exit code 0 to 135 indicate success, or 1 to indicate failure: 136 <p> 137 <a href="animate.html"><strong>animate</strong></a> 138 displays an animation (e.g. a GIF file) on any workstation display 139 running an <em>X</em> server. 140 <p> 141 <a href="batch.html"><strong>batch</strong></a> 142 executes an arbitary number of the utility commands 143 (e.g. <strong>convert</strong>) in the form of a simple linear batch script in 144 order to improve execution efficiency, and/or to allow use as a 145 subordinate co-process under the control of an arbitrary script or 146 program. 147 <p> 148 <a href="benchmark.html"><strong>benchmark</strong></a> 149 executes one of the other utility commands (e.g. <strong>convert</strong>) for a 150 specified number of iterations, or execution time, and reports 151 execution time and other profiling information such as CPU 152 utilization. <strong>Benchmark</strong> provides various operating modes 153 including executing the command with a varying number of threads, and 154 alternate reporting formats such as comma-separated value (CSV). 155 <p> 156 <a href="compare.html"><strong>compare</strong></a> 157 compares two images and reports difference statistics according to 158 specified metrics and/or outputs an image with a visual representation 159 of the differences. It may also be used to test if images are similar 160 within a particular range and specified metric, returning a truth 161 value to the executing environment. 162 <p> 163 <a href="composite.html"><strong>composite</strong></a> 164 composites images (blends or merges images together) to create new images. 165 <p> 166 <a href="conjure.html"><strong>conjure</strong></a> 167 interprets and executes scripts in 168 the Magick Scripting Language (MSL). 169 <p> 170 <a href="convert.html"><strong>convert</strong></a> 171 converts an input file using one image format to an output file with 172 the same or differing image format while applying an arbitrary number 173 of image transformations. 174 <p> 175 <a href="display.html"><strong>display</strong></a> 176 is a machine architecture independent image processing and display 177 facility. It can display an image on any workstation display running 178 an <em>X</em> server. 179 <p> 180 <a href="identify.html"><strong>identify</strong></a> 181 describes the format and characteristics of one or more image 182 files. It will also report if an image is incomplete or corrupt. 183 <p> 184 <a href="import.html"><strong>import</strong></a> 185 reads an image from any visible window on an <em>X</em> server and 186 outputs it as an image file. You can capture a single window, the 187 entire screen, or any rectangular portion of the screen. 188 <p> 189 <a href="mogrify.html"><strong>mogrify</strong></a> 190 transforms an image or a sequence of images. These transforms include 191 <strong>image scaling</strong>, <strong>image rotation</strong>, <strong>color reduction</strong>, 192 and others. The transmogrified image <strong>overwrites</strong> the original 193 image. 194 <p> 195 <a href="montage.html"><strong>montage</strong></a> 196 creates a composite by combining several separate images. The images 197 are tiled on the composite image with the name of the image optionally 198 appearing just below the individual tile. 199 <p> 200 <a href="time.html"><strong>time</strong></a> 201 executes a subcommand and reports the user, system, and total 202 execution time consumed. 203 <p> 204 <a href="version.html"><strong>version</strong></a> 205 reports the GraphicsMagick release version, maximum sample-depth, 206 copyright notice, supported features, and the options used while 207 building the software. 208 <p> 209 The <strong>GraphicsMagick</strong> utilities recognize the following image formats: 210 <br> <br> 211 <table border="0" cellspacing="0" cellpadding="2"> 212 <p> 213 <tr><td><strong>Name</strong> </td><td><strong>Mode</strong></td><td><strong>Description</strong></td></tr> 214 <tr><td><dd><img SRC="images/ball.png" ALT="*">3FR </td><td>r--</td><td>Hasselblad Photo RAW</td></tr> 215 <tr><td><dd><img SRC="images/ball.png" ALT="*">8BIM </td><td>rw-</td><td>Photoshop resource format</td></tr> 216 <tr><td><dd><img SRC="images/ball.png" ALT="*">8BIMTEXT </td><td>rw-</td><td>Photoshop resource text format</td></tr> 217 <tr><td><dd><img SRC="images/ball.png" ALT="*">8BIMWTEXT</td><td>rw-</td><td>Photoshop resource wide text format</td></tr> 218 <tr><td><dd><img SRC="images/ball.png" ALT="*">APP1 </td><td>rw-</td><td>Raw application information</td></tr> 219 <tr><td><dd><img SRC="images/ball.png" ALT="*">APP1JPEG </td><td>rw-</td><td>Raw JPEG binary data</td></tr> 220 <tr><td><dd><img SRC="images/ball.png" ALT="*">ART </td><td>r--</td><td>PF1: 1st Publisher</td></tr> 221 <tr><td><dd><img SRC="images/ball.png" ALT="*">ARW </td><td>r--</td><td>Sony Alpha DSLR RAW</td></tr> 222 <tr><td><dd><img SRC="images/ball.png" ALT="*">AVS </td><td>rw+</td><td>AVS X image</td></tr> 223 <tr><td><dd><img SRC="images/ball.png" ALT="*">BIE </td><td>rw-</td><td>Joint Bi-level Image experts Group</td></tr> 224 <tr><td> </td><td> </td><td>interchange format</td></tr> 225 <tr><td><dd><img SRC="images/ball.png" ALT="*">BMP </td><td>rw+</td><td>Microsoft Windows bitmap image</td></tr> 226 <tr><td><dd><img SRC="images/ball.png" ALT="*">BMP2 </td><td>-w-</td><td>Microsoft Windows bitmap image v2</td></tr> 227 <tr><td><dd><img SRC="images/ball.png" ALT="*">BMP3 </td><td>-w-</td><td>Microsoft Windows bitmap image v3</td></tr> 228 <tr><td><dd><img SRC="images/ball.png" ALT="*">CACHE </td><td>---</td><td>Magick Persistent Cache image format</td></tr> 229 <tr><td><dd><img SRC="images/ball.png" ALT="*">CALS </td><td>rw-</td><td>Continuous Acquisition and Life-cycle</td></tr> 230 <tr><td> </td><td> </td><td>Support Type 1 image</td></tr> 231 <tr><td><dd><img SRC="images/ball.png" ALT="*">CAPTION </td><td>r--</td><td>Caption (requires separate size info)</td></tr> 232 <tr><td><dd><img SRC="images/ball.png" ALT="*">CIN </td><td>rw-</td><td>Kodak Cineon Format</td></tr> 233 <tr><td><dd><img SRC="images/ball.png" ALT="*">CMYK </td><td>rw-</td><td>Raw cyan, magenta, yellow, and black</td></tr> 234 <tr><td> </td><td> </td><td>samples (8 or 16 bits, depending on</td></tr> 235 <tr><td> </td><td> </td><td>the image depth)</td></tr> 236 <tr><td><dd><img SRC="images/ball.png" ALT="*">CMYKA </td><td>rw-</td><td>Raw cyan, magenta, yellow, black, and</td></tr> 237 <tr><td> </td><td> </td><td>matte samples (8 or 16 bits, depending</td></tr> 238 <tr><td> </td><td> </td><td>on the image depth)</td></tr> 239 <tr><td><dd><img SRC="images/ball.png" ALT="*">CR2 </td><td>r--</td><td>Canon Photo RAW</td></tr> 240 <tr><td><dd><img SRC="images/ball.png" ALT="*">CRW </td><td>r--</td><td>Canon Photo RAW</td></tr> 241 <tr><td><dd><img SRC="images/ball.png" ALT="*">CUR </td><td>r--</td><td>Microsoft Cursor Icon</td></tr> 242 <tr><td><dd><img SRC="images/ball.png" ALT="*">CUT </td><td>r--</td><td>DR Halo</td></tr> 243 <tr><td><dd><img SRC="images/ball.png" ALT="*">DCM </td><td>r--</td><td>Digital Imaging and Communications in</td></tr> 244 <tr><td> </td><td> </td><td>Medicine image</td></tr> 245 <tr><td><dd><img SRC="images/ball.png" ALT="*">DCR </td><td>r--</td><td>Kodak Photo RAW</td></tr> 246 <tr><td><dd><img SRC="images/ball.png" ALT="*">DCX </td><td>rw+</td><td>ZSoft IBM PC multi-page Paintbrush</td></tr> 247 <tr><td><dd><img SRC="images/ball.png" ALT="*">DNG </td><td>r--</td><td>Adobe Digital Negative</td></tr> 248 <tr><td><dd><img SRC="images/ball.png" ALT="*">DPS </td><td>r--</td><td>Display PostScript Interpreter</td></tr> 249 <tr><td><dd><img SRC="images/ball.png" ALT="*">DPX </td><td>rw-</td><td>Digital Moving Picture Exchange</td></tr> 250 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPDF </td><td>rw-</td><td>Encapsulated Portable Document Format</td></tr> 251 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPI </td><td>rw-</td><td>Adobe Encapsulated PostScript</td></tr> 252 <tr><td> </td><td> </td><td>Interchange format</td></tr> 253 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPS </td><td>rw-</td><td>Adobe Encapsulated PostScript</td></tr> 254 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPS2 </td><td>-w-</td><td>Adobe Level II Encapsulated PostScript</td></tr> 255 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPS3 </td><td>-w-</td><td>Adobe Level III Encapsulated PostScript</td></tr> 256 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPSF </td><td>rw-</td><td>Adobe Encapsulated PostScript</td></tr> 257 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPSI </td><td>rw-</td><td>Adobe Encapsulated PostScript</td></tr> 258 <tr><td> </td><td> </td><td>Interchange format</td></tr> 259 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPT </td><td>rw-</td><td>Adobe Encapsulated PostScript with MS-DOS</td></tr> 260 <tr><td> </td><td> </td><td>TIFF preview</td></tr> 261 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPT2 </td><td>rw-</td><td>Adobe Level II Encapsulated PostScript</td></tr> 262 <tr><td> </td><td> </td><td>with MS-DOS TIFF preview</td></tr> 263 <tr><td><dd><img SRC="images/ball.png" ALT="*">EPT3 </td><td>rw-</td><td>Adobe Level III Encapsulated PostScript</td></tr> 264 <tr><td> </td><td> </td><td>with MS-DOS TIFF preview</td></tr> 265 <tr><td><dd><img SRC="images/ball.png" ALT="*">EXIF </td><td>rw-</td><td>Exif digital camera binary data</td></tr> 266 <tr><td><dd><img SRC="images/ball.png" ALT="*">FAX </td><td>rw+</td><td>Group 3 FAX (Not TIFF Group3 FAX!)</td></tr> 267 <tr><td><dd><img SRC="images/ball.png" ALT="*">FITS </td><td>rw-</td><td>Flexible Image Transport System</td></tr> 268 <tr><td><dd><img SRC="images/ball.png" ALT="*">FRACTAL </td><td>r--</td><td>Plasma fractal image</td></tr> 269 <tr><td><dd><img SRC="images/ball.png" ALT="*">FPX </td><td>rw-</td><td>FlashPix Format</td></tr> 270 <tr><td><dd><img SRC="images/ball.png" ALT="*">GIF </td><td>rw+</td><td>CompuServe graphics interchange format</td></tr> 271 <tr><td><dd><img SRC="images/ball.png" ALT="*">GIF87 </td><td>rw-</td><td>CompuServe graphics interchange format</td></tr> 272 <tr><td> </td><td> </td><td>(version 87a)</td></tr> 273 <tr><td><dd><img SRC="images/ball.png" ALT="*">GRADIENT </td><td>r--</td><td>Gradual passing from one shade to</td></tr> 274 <tr><td> </td><td> </td><td>another</td></tr> 275 <tr><td><dd><img SRC="images/ball.png" ALT="*">GRAY </td><td>rw+</td><td>Raw gray samples (8/16/32 bits,</td></tr> 276 <tr><td> </td><td> </td><td>depending on the image depth)</td></tr> 277 <tr><td><dd><img SRC="images/ball.png" ALT="*">HISTOGRAM</td><td>-w-</td><td>Histogram of the image</td></tr> 278 <tr><td><dd><img SRC="images/ball.png" ALT="*">HRZ </td><td>r--</td><td>HRZ: Slow scan TV</td></tr> 279 <tr><td><dd><img SRC="images/ball.png" ALT="*">HTML </td><td>-w-</td><td>Hypertext Markup Language and a</td></tr> 280 <tr><td> </td><td> </td><td>client-side image map</td></tr> 281 <tr><td><dd><img SRC="images/ball.png" ALT="*">ICB </td><td>rw+</td><td>Truevision Targa image</td></tr> 282 <tr><td><dd><img SRC="images/ball.png" ALT="*">ICC </td><td>rw-</td><td>ICC Color Profile</td></tr> 283 <tr><td><dd><img SRC="images/ball.png" ALT="*">ICM </td><td>rw-</td><td>ICC Color Profile</td></tr> 284 <tr><td><dd><img SRC="images/ball.png" ALT="*">ICO </td><td>r--</td><td>Microsoft icon</td></tr> 285 <tr><td><dd><img SRC="images/ball.png" ALT="*">ICON </td><td>r--</td><td>Microsoft icon</td></tr> 286 <tr><td><dd><img SRC="images/ball.png" ALT="*">IDENTITY </td><td>r--</td><td>Hald CLUT identity image</td></tr> 287 <tr><td><dd><img SRC="images/ball.png" ALT="*">IMAGE </td><td>r--</td><td>GraphicsMagick Embedded Image</td></tr> 288 <tr><td><dd><img SRC="images/ball.png" ALT="*">INFO </td><td>-w+</td><td>Image descriptive information and</td></tr> 289 <tr><td> </td><td> </td><td> statistics</td></tr> 290 <tr><td><dd><img SRC="images/ball.png" ALT="*">IPTC </td><td>rw-</td><td>IPTC Newsphoto</td></tr> 291 <tr><td><dd><img SRC="images/ball.png" ALT="*">IPTCTEXT </td><td>rw-</td><td>IPTC Newsphoto text format</td></tr> 292 <tr><td><dd><img SRC="images/ball.png" ALT="*">IPTCWTEXT</td><td>rw-</td><td>IPTC Newsphoto wide text format</td></tr> 293 <tr><td><dd><img SRC="images/ball.png" ALT="*">JBG </td><td>rw+</td><td>Joint Bi-level Image experts Group</td></tr> 294 <tr><td> </td><td> </td><td>interchange format</td></tr> 295 <tr><td><dd><img SRC="images/ball.png" ALT="*">JBIG </td><td>rw+</td><td>Joint Bi-level Image experts Group</td></tr> 296 <tr><td> </td><td> </td><td>interchange format</td></tr> 297 <tr><td><dd><img SRC="images/ball.png" ALT="*">JNG </td><td>rw-</td><td>JPEG Network Graphics</td></tr> 298 <tr><td><dd><img SRC="images/ball.png" ALT="*">JP2 </td><td>rw-</td><td>JPEG-2000 JP2 File Format Syntax</td></tr> 299 <tr><td><dd><img SRC="images/ball.png" ALT="*">JPC </td><td>rw-</td><td>JPEG-2000 Code Stream Syntax</td></tr> 300 <tr><td><dd><img SRC="images/ball.png" ALT="*">JPEG </td><td>rw-</td><td>Joint Photographic Experts Group</td></tr> 301 <tr><td> </td><td> </td><td>JFIF format</td></tr> 302 <tr><td><dd><img SRC="images/ball.png" ALT="*">JPG </td><td>rw-</td><td>Joint Photographic Experts Group</td></tr> 303 <tr><td> </td><td> </td><td>JFIF format</td></tr> 304 <tr><td><dd><img SRC="images/ball.png" ALT="*">K25 </td><td>r--</td><td>Kodak Photo RAW</td></tr> 305 <tr><td><dd><img SRC="images/ball.png" ALT="*">KDC </td><td>r--</td><td>Kodak Photo RAW</td></tr> 306 <tr><td><dd><img SRC="images/ball.png" ALT="*">LABEL </td><td>r--</td><td>Text image format</td></tr> 307 <tr><td><dd><img SRC="images/ball.png" ALT="*">M2V </td><td>rw+</td><td>MPEG-2 Video Stream</td></tr> 308 <tr><td><dd><img SRC="images/ball.png" ALT="*">MAP </td><td>rw-</td><td>Colormap intensities and indices</td></tr> 309 <tr><td><dd><img SRC="images/ball.png" ALT="*">MAT </td><td>r--</td><td>MATLAB image format</td></tr> 310 <tr><td><dd><img SRC="images/ball.png" ALT="*">MATTE </td><td>-w+</td><td>MATTE format</td></tr> 311 <tr><td><dd><img SRC="images/ball.png" ALT="*">MIFF </td><td>rw+</td><td>Magick Image File Format</td></tr> 312 <tr><td><dd><img SRC="images/ball.png" ALT="*">MNG </td><td>rw+</td><td>Multiple-image Network Graphics</td></tr> 313 <tr><td><dd><img SRC="images/ball.png" ALT="*">MONO </td><td>rw-</td><td>Bi-level bitmap in least-significant-</td></tr> 314 <tr><td> </td><td> </td><td>-byte-first order</td></tr> 315 <tr><td><dd><img SRC="images/ball.png" ALT="*">MPC </td><td>rw+</td><td>Magick Persistent Cache image format</td></tr> 316 <tr><td><dd><img SRC="images/ball.png" ALT="*">MPEG </td><td>rw+</td><td>MPEG-1 Video Stream</td></tr> 317 <tr><td><dd><img SRC="images/ball.png" ALT="*">MPG </td><td>rw+</td><td>MPEG-1 Video Stream</td></tr> 318 <tr><td><dd><img SRC="images/ball.png" ALT="*">MRW </td><td>r--</td><td>Minolta Photo Raw</td></tr> 319 <tr><td><dd><img SRC="images/ball.png" ALT="*">MSL </td><td>r--</td><td>Magick Scripting Language</td></tr> 320 <tr><td><dd><img SRC="images/ball.png" ALT="*">MTV </td><td>rw+</td><td>MTV Raytracing image format</td></tr> 321 <tr><td><dd><img SRC="images/ball.png" ALT="*">MVG </td><td>rw-</td><td>Magick Vector Graphics</td></tr> 322 <tr><td><dd><img SRC="images/ball.png" ALT="*">NEF </td><td>r--</td><td>Nikon Electronic Format</td></tr> 323 <tr><td><dd><img SRC="images/ball.png" ALT="*">NULL </td><td>r--</td><td>Constant image of uniform color</td></tr> 324 <tr><td><dd><img SRC="images/ball.png" ALT="*">OTB </td><td>rw-</td><td>On-the-air bitmap</td></tr> 325 <tr><td><dd><img SRC="images/ball.png" ALT="*">P7 </td><td>rw+</td><td>Xv thumbnail format</td></tr> 326 <tr><td><dd><img SRC="images/ball.png" ALT="*">PAL </td><td>rw-</td><td>16bit/pixel interleaved YUV</td></tr> 327 <tr><td><dd><img SRC="images/ball.png" ALT="*">PALM </td><td>rw-</td><td>Palm Pixmap</td></tr> 328 <tr><td><dd><img SRC="images/ball.png" ALT="*">PBM </td><td>rw+</td><td>Portable bitmap format (black and white)</td></tr> 329 <tr><td><dd><img SRC="images/ball.png" ALT="*">PCD </td><td>rw-</td><td>Photo CD</td></tr> 330 <tr><td><dd><img SRC="images/ball.png" ALT="*">PCDS </td><td>rw-</td><td>Photo CD</td></tr> 331 <tr><td><dd><img SRC="images/ball.png" ALT="*">PCL </td><td>-w-</td><td>Page Control Language</td></tr> 332 <tr><td><dd><img SRC="images/ball.png" ALT="*">PCT </td><td>rw-</td><td>Apple Macintosh QuickDraw/PICT</td></tr> 333 <tr><td><dd><img SRC="images/ball.png" ALT="*">PCX </td><td>rw-</td><td>ZSoft IBM PC Paintbrush</td></tr> 334 <tr><td><dd><img SRC="images/ball.png" ALT="*">PDB </td><td>rw+</td><td>Palm Database ImageViewer Format</td></tr> 335 <tr><td><dd><img SRC="images/ball.png" ALT="*">PDF </td><td>rw+</td><td>Portable Document Format</td></tr> 336 <tr><td><dd><img SRC="images/ball.png" ALT="*">PEF </td><td>r--</td><td>Pentax Electronic File</td></tr> 337 <tr><td><dd><img SRC="images/ball.png" ALT="*">PFA </td><td>r--</td><td>TrueType font</td></tr> 338 <tr><td><dd><img SRC="images/ball.png" ALT="*">PFB </td><td>r--</td><td>TrueType font</td></tr> 339 <tr><td><dd><img SRC="images/ball.png" ALT="*">PGM </td><td>rw+</td><td>Portable graymap format (gray scale)</td></tr> 340 <tr><td><dd><img SRC="images/ball.png" ALT="*">PGX </td><td>r--</td><td>JPEG-2000 VM Format</td></tr> 341 <tr><td><dd><img SRC="images/ball.png" ALT="*">PICON </td><td>rw-</td><td>Personal Icon</td></tr> 342 <tr><td><dd><img SRC="images/ball.png" ALT="*">PICT </td><td>rw-</td><td>Apple Macintosh QuickDraw/PICT</td></tr> 343 <tr><td><dd><img SRC="images/ball.png" ALT="*">PIX </td><td>r--</td><td>Alias/Wavefront RLE image format</td></tr> 344 <tr><td><dd><img SRC="images/ball.png" ALT="*">PLASMA </td><td>r--</td><td>Plasma fractal image</td></tr> 345 <tr><td><dd><img SRC="images/ball.png" ALT="*">PNG </td><td>rw-</td><td>Portable Network Graphics</td></tr> 346 <tr><td><dd><img SRC="images/ball.png" ALT="*">PNG24 </td><td>rw-</td><td>Portable Network Graphics, 24 bit RGB</td></tr> 347 <tr><td> </td><td> </td><td>opaque only</td></tr> 348 <tr><td><dd><img SRC="images/ball.png" ALT="*">PNG32 </td><td>rw-</td><td>Portable Network Graphics, 32 bit RGBA</td></tr> 349 <tr><td> </td><td> </td><td>semitransparency OK</td></tr> 350 <tr><td><dd><img SRC="images/ball.png" ALT="*">PNG8 </td><td>rw-</td><td>Portable Network Graphics, 8-bit</td></tr> 351 <tr><td> </td><td> </td><td>indexed, binary transparency only</td></tr> 352 <tr><td><dd><img SRC="images/ball.png" ALT="*">PNM </td><td>rw+</td><td>Portable anymap</td></tr> 353 <tr><td><dd><img SRC="images/ball.png" ALT="*">PPM </td><td>rw+</td><td>Portable pixmap format (color)</td></tr> 354 <tr><td><dd><img SRC="images/ball.png" ALT="*">PREVIEW </td><td>-w-</td><td>Show a preview an image enhancement,</td></tr> 355 <tr><td> </td><td> </td><td>effect, or f/x</td></tr> 356 <tr><td><dd><img SRC="images/ball.png" ALT="*">PS </td><td>rw+</td><td>Adobe PostScript</td></tr> 357 <tr><td><dd><img SRC="images/ball.png" ALT="*">PS2 </td><td>-w+</td><td>Adobe Level II PostScript</td></tr> 358 <tr><td><dd><img SRC="images/ball.png" ALT="*">PS3 </td><td>-w+</td><td>Adobe Level III PostScript</td></tr> 359 <tr><td><dd><img SRC="images/ball.png" ALT="*">PSD </td><td>rw-</td><td>Adobe Photoshop bitmap</td></tr> 360 <tr><td><dd><img SRC="images/ball.png" ALT="*">PTIF </td><td>rw-</td><td>Pyramid encoded TIFF</td></tr> 361 <tr><td><dd><img SRC="images/ball.png" ALT="*">PWP </td><td>r--</td><td>Seattle Film Works</td></tr> 362 <tr><td><dd><img SRC="images/ball.png" ALT="*">RAF </td><td>r--</td><td>Fuji Photo RAW</td></tr> 363 <tr><td><dd><img SRC="images/ball.png" ALT="*">RAS </td><td>rw+</td><td>SUN Rasterfile</td></tr> 364 <tr><td><dd><img SRC="images/ball.png" ALT="*">RGB </td><td>rw+</td><td>Raw red, green, and blue samples</td></tr> 365 <tr><td><dd><img SRC="images/ball.png" ALT="*">RGBA </td><td>rw+</td><td>Raw red, green, blue, and matte samples</td></tr> 366 <tr><td><dd><img SRC="images/ball.png" ALT="*">RLA </td><td>r--</td><td>Alias/Wavefront image</td></tr> 367 <tr><td><dd><img SRC="images/ball.png" ALT="*">RLE </td><td>r--</td><td>Utah Run length encoded image</td></tr> 368 <tr><td><dd><img SRC="images/ball.png" ALT="*">SCT </td><td>r--</td><td>Scitex HandShake</td></tr> 369 <tr><td><dd><img SRC="images/ball.png" ALT="*">SFW </td><td>r--</td><td>Seattle Film Works</td></tr> 370 <tr><td><dd><img SRC="images/ball.png" ALT="*">SGI </td><td>rw+</td><td>Irix RGB image</td></tr> 371 <tr><td><dd><img SRC="images/ball.png" ALT="*">SHTML </td><td>-w-</td><td>Hypertext Markup Language and a</td></tr> 372 <tr><td> </td><td> </td><td>client-side image map</td></tr> 373 <tr><td><dd><img SRC="images/ball.png" ALT="*">STEGANO </td><td>r--</td><td>Steganographic image</td></tr> 374 <tr><td><dd><img SRC="images/ball.png" ALT="*">SUN </td><td>rw+</td><td>SUN Rasterfile</td></tr> 375 <tr><td><dd><img SRC="images/ball.png" ALT="*">SVG </td><td>rw+</td><td>Scalable Vector Gaphics</td></tr> 376 <tr><td><dd><img SRC="images/ball.png" ALT="*">TEXT </td><td>rw+</td><td>Raw text</td></tr> 377 <tr><td><dd><img SRC="images/ball.png" ALT="*">TGA </td><td>rw+</td><td>Truevision Targa image</td></tr> 378 <tr><td><dd><img SRC="images/ball.png" ALT="*">TIFF </td><td>rw+</td><td>Tagged Image File Format</td></tr> 379 <tr><td><dd><img SRC="images/ball.png" ALT="*">TILE </td><td>r--</td><td>Tile image with a texture</td></tr> 380 <tr><td><dd><img SRC="images/ball.png" ALT="*">TIM </td><td>r--</td><td>PSX TIM</td></tr> 381 <tr><td><dd><img SRC="images/ball.png" ALT="*">TOPOL </td><td>r--</td><td>TOPOL X Image</td></tr> 382 <tr><td><dd><img SRC="images/ball.png" ALT="*">TTF </td><td>r--</td><td>TrueType font</td></tr> 383 <tr><td><dd><img SRC="images/ball.png" ALT="*">TXT </td><td>rw+</td><td>Raw text</td></tr> 384 <tr><td><dd><img SRC="images/ball.png" ALT="*">UIL </td><td>-w-</td><td>X-Motif UIL table</td></tr> 385 <tr><td><dd><img SRC="images/ball.png" ALT="*">UYVY </td><td>rw-</td><td>16bit/pixel interleaved YUV</td></tr> 386 <tr><td><dd><img SRC="images/ball.png" ALT="*">VDA </td><td>rw+</td><td>Truevision Targa image</td></tr> 387 <tr><td><dd><img SRC="images/ball.png" ALT="*">VICAR </td><td>rw-</td><td>VICAR rasterfile format</td></tr> 388 <tr><td><dd><img SRC="images/ball.png" ALT="*">VID </td><td>rw+</td><td>Visual Image Directory</td></tr> 389 <tr><td><dd><img SRC="images/ball.png" ALT="*">VIFF </td><td>rw+</td><td>Khoros Visualization image</td></tr> 390 <tr><td><dd><img SRC="images/ball.png" ALT="*">VST </td><td>rw+</td><td>Truevision Targa image</td></tr> 391 <tr><td><dd><img SRC="images/ball.png" ALT="*">WBMP </td><td>rw-</td><td>Wireless Bitmap (level 0) image</td></tr> 392 <tr><td><dd><img SRC="images/ball.png" ALT="*">WMF </td><td>r--</td><td>Windows Metafile</td></tr> 393 <tr><td><dd><img SRC="images/ball.png" ALT="*">WPG </td><td>r--</td><td>Word Perfect Graphics</td></tr> 394 <tr><td><dd><img SRC="images/ball.png" ALT="*">X </td><td>rw-</td><td>X Image</td></tr> 395 <tr><td><dd><img SRC="images/ball.png" ALT="*">X3F </td><td>r--</td><td>Foveon X3 (Sigma/Polaroid) RAW</td></tr> 396 <tr><td><dd><img SRC="images/ball.png" ALT="*">XBM </td><td>rw-</td><td>X Windows system bitmap (black</td></tr> 397 <tr><td> </td><td> </td><td>and white)</td></tr> 398 <tr><td><dd><img SRC="images/ball.png" ALT="*">XC </td><td>r--</td><td>Constant image uniform color</td></tr> 399 <tr><td><dd><img SRC="images/ball.png" ALT="*">XCF </td><td>r--</td><td>GIMP image</td></tr> 400 <tr><td><dd><img SRC="images/ball.png" ALT="*">XMP </td><td>rw-</td><td>Adobe XML metadata</td></tr> 401 <tr><td><dd><img SRC="images/ball.png" ALT="*">XPM </td><td>rw-</td><td>X Windows system pixmap (color)</td></tr> 402 <tr><td><dd><img SRC="images/ball.png" ALT="*">XV </td><td>rw+</td><td>Khoros Visualization image</td></tr> 403 <tr><td><dd><img SRC="images/ball.png" ALT="*">XWD </td><td>rw-</td><td>X Windows system window dump (color)</td></tr> 404 <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> 405 <tr><td> </td><td> </td><td></td></tr> 406 <tr><td> Modes: </td><td> </td><td></td></tr> 407 <tr><td> </td><td>r </td><td>Read</td></tr> 408 <tr><td> </td><td>w </td><td>Write</td></tr> 409 <tr><td> </td><td>+ </td><td>Multi-image</td></tr> 410 <br> <br> 411 </table> 412 <p> 413 <em>Support for some of these formats require additional programs or libraries. 414 See <a href="README.html">README</a> 415 in the source package for where to find optional additional software</em>. 416 <p> 417 Note, a format delineated with <tt>+</tt> means that if more than one 418 image is specified, frames are combined into a single multi-image 419 file. Use <strong>+adjoin</strong> if you want a single image produced for each 420 frame. 421 <p> 422 Your installation might not support all of the formats in the list. 423 To get an accurate listing of the formats supported by your particular 424 configuration, run <tt>"gm convert -list format"</tt>. 425 <p> 426 Raw images are expected to have one byte per pixel unless <strong>gm</strong> is 427 compiled in 16-bit quantum mode or in 32-bit quantum mode. Here, the 428 raw data is expected to be stored two or four bytes per pixel, 429 respectively, in most-significant-byte-first order. For example, you 430 can tell if <strong>gm</strong> was compiled in 16-bit mode by typing "gm 431 version" without any options, and looking for "Q:16" in the first line 432 of output. 433 </td></tr></table> 434 <p> 435 <i><a href="#top">Back to Contents</a></i> 436 </p> 437 <table BORDER=0 WIDTH="100%"> 438 <tr> 439 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 440 SRC="images/right_triangle.png" ALT=">" BORDER=0 441 height=14 width=15><b><font face="Helvetica, Arial"><font 442 color="#00B04F"><font size="+1"> 443 <a NAME="files"></a>Files and Formats 444 </font></font></font></b></td></tr></table> 445 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 446 <tr><td width="3%"><br></td><td> 447 <p> 448 By default, the image format is determined by its magic number, i.e., the 449 first few bytes of the file. To specify 450 a particular image format, precede the filename with an image format name 451 and a colon (<em>i.e.</em><strong>ps:image</strong>) or specify the image type as the 452 filename suffix (<em>i.e.</em><strong>image.ps</strong>). 453 The magic number takes precedence over the filename suffix 454 and the prefix takes precedence over the magic number and the suffix 455 in input files. 456 When a file is read, its magic number is stored in the "image->magick" 457 string. 458 In output files, the prefix takes precedence over the filename suffix, 459 and the filename suffix takes precedence over the 460 "image->magick" string. 461 <br> <br> 462 <p>To read the "built-in" formats (GRANITE, H, LOGO, 463 NETSCAPE, PLASMA, and ROSE) use a prefix (including the colon) without a 464 filename or suffix. To read the XC format, follow the colon with a color 465 specification. To read the CAPTION format, follow the colon with a text 466 string or with a filename prefixed with the at symbol (<strong>@</strong>). 467 <br> <br> 468 <p> 469 When you specify <strong>X</strong> as your image type, the filename has special 470 meaning. It specifies an X window by <strong>id, name</strong>, or 471 <strong>root</strong>. If 472 no filename is specified, the window is selected by clicking the mouse 473 in the desired window. 474 <p> 475 Specify <em>input_file</em> as <strong>-</strong> for standard input, 476 <em>output_file</em> as <strong>-</strong> for standard output. 477 If <em>input_file</em> has the extension <strong>.Z</strong> or <strong>.gz</strong>, the 478 file is uncompressed with <strong>uncompress</strong> or <strong>gunzip</strong> 479 respectively. 480 If <em>output_file</em> has the extension <strong>.Z</strong> or <strong>.gz</strong>, 481 the file is compressed using with <em>compress</em> or <em>gzip</em> respectively. 482 <p> 483 Use an optional index enclosed in brackets after an input file name to 484 specify a desired subimage of a multi-resolution image format like 485 Photo CD (e.g. <tt>"img0001.pcd[4]"</tt>) or a range for MPEG images 486 (e.g. <tt>"video.mpg[50-75]"</tt>). A subimage specification can be 487 disjoint (e.g. <tt>"image.tiff[2,7,4]"</tt>). For raw images, specify 488 a subimage with a geometry (e.g. <tt>-size 640x512</tt> 489 <tt>"image.rgb[320x256+50+50]"</tt>). Surround the image name with 490 quotation marks to prevent your shell from interpreting the square 491 brackets. <p>Single images are written with the filename you 492 specify. However, multi-part images (e.g., a multi-page PostScript 493 document with <strong>+adjoin</strong> specified) may be written with the scene 494 number included as part of the filename. In order to include the scene 495 number in the filename, it is necessary to include a printf-style 496 <tt>%d</tt> format specification in the file name and use the +adjoin 497 option. For example, 498 <pre> 499 image%02d.miff 500 </pre> 501 <p> 502 writes files <em>image00.miff, image01.miff,</em> etc. Only a single 503 specification is allowed within an output filename. If more than one 504 specification is present, it will be ignored. It is best to embed the 505 scene number in the base part of the file name, not in the extension, 506 because the extension will not be a recognizeable image type. 507 <p> 508 When running a commandline utility, you can 509 prepend an at sign <tt>@</tt> to a filename to read a list of image 510 filenames from that file. This is convenient in the event you have too 511 many image filenames to fit on the command line. 512 </td></tr></table> 513 <p> 514 <i><a href="#top">Back to Contents</a></i> 515 </p> 516 <table BORDER=0 WIDTH="100%"> 517 <tr> 518 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 519 SRC="images/right_triangle.png" ALT=">" BORDER=0 520 height=14 width=15><b><font face="Helvetica, Arial"><font 521 color="#00B04F"><font size="+1"> 522 <a NAME="opti"></a>Options 523 </font></font></font></b></td></tr></table> 524 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 525 <tr><td width="3%"><br></td><td> 526 <p> 527 Options are processed in command line order. Any option you specify on 528 the command line remains in effect for the set of images that follows, 529 until the set is terminated by the appearance of any option or <strong>-noop</strong>. 530 Some options only affect the decoding of images and others only the encoding. 531 The latter can appear after the final group of input images. 532 <p> 533 This is a combined list of the command-line options used by the 534 GraphicsMagick utilities (<em>animate</em>, <em>compare</em>, 535 <em>composite</em>, <em>convert</em>, <em>display</em>, <em>identify</em>, 536 <em>import</em>, <em>mogrify</em> and <em>montage</em>). 537 <br> <br> 538 <p> 539 In this document, angle brackets ("<>") enclose variables and curly 540 brackets ("{}") enclose optional parameters. For example, 541 "<strong>-fuzz <distance>{%}</strong>" means you can use the 542 option <tt>"-fuzz 10"</tt> 543 or <tt>"-fuzz 2%"</tt>. 544 <br> <br> 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-adjoin"></a>-adjoin 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>join images into a single multi-image file</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, all images of an image sequence are stored in the same 558 file. However, some formats (e.g. JPEG) do not support storing more 559 than one image per file and only the first frame in an image sequence 560 will be saved unless the result is saved to separate files. Use 561 <strong>+adjoin</strong> to force saving multiple frames to multiple numbered 562 files. If <strong>+adjoin</strong> is used, then the output filename must 563 include a printf style formatting specification for the numeric part 564 of the filename. For example,</font></td></tr></table> 565 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 566 image%02d.miff 567 </pre></font></td></tr></table> 568 <table BORDER=0 WIDTH="94%"> 569 <tr> 570 <td width="3%"><br></td> 571 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 572 <img SRC="images/right_triangle_option.png" 573 ALT=">" BORDER=0 height=14 574 width=15><b><font face="Helvetica, Arial" 575 ><font color="#00B04F"><font size="+1"> 576 <a name="details-affine"></a>-affine <i><matrix></i> 577 </font></font></font></b></td></tr></table> 578 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>drawing transform matrix</td></tr></table> 579 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 580 This option provides a transform matrix <tt>{sx,rx,ry,sy,tx,ty}</tt> for 581 use by subsequent <strong>-draw</strong> or <strong>-transform</strong> options.</font></td></tr></table> 582 <table BORDER=0 WIDTH="94%"> 583 <tr> 584 <td width="3%"><br></td> 585 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 586 <img SRC="images/right_triangle_option.png" 587 ALT=">" BORDER=0 height=14 588 width=15><b><font face="Helvetica, Arial" 589 ><font color="#00B04F"><font size="+1"> 590 <a name="details-antialias"></a>-antialias 591 </font></font></font></b></td></tr></table> 592 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove pixel aliasing</td></tr></table> 593 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 594 By default antialiasing algorithms are used when drawing objects (e.g. lines) 595 or rendering vector formats (e.g. WMF and Postscript). Use +antialias to 596 disable use of antialiasing algorithms. Reasons to disable antialiasing 597 include avoiding increasing colors in the image, or improving rendering speed.</font></td></tr></table> 598 <table BORDER=0 WIDTH="94%"> 599 <tr> 600 <td width="3%"><br></td> 601 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 602 <img SRC="images/right_triangle_option.png" 603 ALT=">" BORDER=0 height=14 604 width=15><b><font face="Helvetica, Arial" 605 ><font color="#00B04F"><font size="+1"> 606 <a name="details-append"></a>-append 607 </font></font></font></b></td></tr></table> 608 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>append a set of images</td></tr></table> 609 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 610 This option creates a single image where the images in the original set 611 are stacked top-to-bottom. If they are not of the same width, 612 any narrow images will be expanded to fit using the background color. 613 Use <strong>+append</strong> to stack images left-to-right. The set of images 614 is terminated by the appearance of any option. 615 If the <strong>-append</strong> 616 option appears after all of the input images, all images are appended.</font></td></tr></table> 617 <table BORDER=0 WIDTH="94%"> 618 <tr> 619 <td width="3%"><br></td> 620 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 621 <img SRC="images/right_triangle_option.png" 622 ALT=">" BORDER=0 height=14 623 width=15><b><font face="Helvetica, Arial" 624 ><font color="#00B04F"><font size="+1"> 625 <a name="details"></a> <i>-asc-cdl <spec></i> 626 </font></font></font></b></td></tr></table> 627 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply ASC CDL color transform</td></tr></table> 628 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 629 Applies ("bakes in") the ASC CDL, which is a format for the exchange 630 of basic primary color grading information between equipment and 631 software from different manufacturers. The format defines the math for 632 three functions: slope, offset and power. Each function uses a number 633 for the red, green, and blue color channels for a total of nine 634 numbers comprising a single color decision. The tenth number 635 (optional) is for chromiance (saturation) as specified by ASC CDL 636 1.2.</font></td></tr></table> 637 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 638 The argument string is comma delimited and is in the following form 639 (but without invervening spaces or line breaks)</font></td></tr></table> 640 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 641 redslope,redoffset,redpower: 642 greenslope,greenoffset,greenpower: 643 blueslope,blueoffset,bluepower: 644 saturation 645 </pre></font></td></tr></table> 646 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 647 with the unity (no change) specification being:</font></td></tr></table> 648 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 649 "1.0,0.0,1.0:1.0,0.0,1.0:1.0,0.0,1.0:1.0" 650 </pre></font></td></tr></table> 651 <table BORDER=0 WIDTH="94%"> 652 <tr> 653 <td width="3%"><br></td> 654 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 655 <img SRC="images/right_triangle_option.png" 656 ALT=">" BORDER=0 height=14 657 width=15><b><font face="Helvetica, Arial" 658 ><font color="#00B04F"><font size="+1"> 659 <a name="details-authenticate"></a>-authenticate <i><string></i> 660 </font></font></font></b></td></tr></table> 661 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table> 662 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 663 Use this option to supply a password for decrypting an image or an 664 image sequence, if it is being read from a format such as PDF that supports 665 encryption. Encrypting images being written is not supported.</font></td></tr></table> 666 <table BORDER=0 WIDTH="94%"> 667 <tr> 668 <td width="3%"><br></td> 669 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 670 <img SRC="images/right_triangle_option.png" 671 ALT=">" BORDER=0 height=14 672 width=15><b><font face="Helvetica, Arial" 673 ><font color="#00B04F"><font size="+1"> 674 <a name="details-auto-orient"></a>-auto-orient 675 </font></font></font></b></td></tr></table> 676 <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> 677 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 678 Adjusts the image orienation so that it is suitable for viewing. Uses 679 the orientation tag obtained from the image file or as supplied by the 680 <strong>-orient</strong> option.</font></td></tr></table> 681 <table BORDER=0 WIDTH="94%"> 682 <tr> 683 <td width="3%"><br></td> 684 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 685 <img SRC="images/right_triangle_option.png" 686 ALT=">" BORDER=0 height=14 687 width=15><b><font face="Helvetica, Arial" 688 ><font color="#00B04F"><font size="+1"> 689 <a name="details-average"></a>-average 690 </font></font></font></b></td></tr></table> 691 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>average a set of images</td></tr></table> 692 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 693 The set of images 694 is terminated by the appearance of any option. 695 If the <strong>-average</strong> 696 option appears after all of the input images, all images are averaged.</font></td></tr></table> 697 <table BORDER=0 WIDTH="94%"> 698 <tr> 699 <td width="3%"><br></td> 700 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 701 <img SRC="images/right_triangle_option.png" 702 ALT=">" BORDER=0 height=14 703 width=15><b><font face="Helvetica, Arial" 704 ><font color="#00B04F"><font size="+1"> 705 <a name="details-backdrop"></a>-backdrop 706 </font></font></font></b></td></tr></table> 707 <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> 708 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 709 This backdrop covers the entire workstation screen and is useful for hiding 710 other X window activity while viewing the image. The color of the backdrop 711 is specified as the foreground color (X11 default is black).</font></td></tr></table> 712 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">Refer to 713 <a href="#xres">X Resources</a> 714 for details.</font></td></tr></table> 715 <table BORDER=0 WIDTH="94%"> 716 <tr> 717 <td width="3%"><br></td> 718 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 719 <img SRC="images/right_triangle_option.png" 720 ALT=">" BORDER=0 height=14 721 width=15><b><font face="Helvetica, Arial" 722 ><font color="#00B04F"><font size="+1"> 723 <a name="details-background"></a>-background <i><color></i> 724 </font></font></font></b></td></tr></table> 725 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the background color</td></tr></table> 726 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 727 The color is specified using the format described under the <strong>-fill</strong> 728 option.</font></td></tr></table> 729 <table BORDER=0 WIDTH="94%"> 730 <tr> 731 <td width="3%"><br></td> 732 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 733 <img SRC="images/right_triangle_option.png" 734 ALT=">" BORDER=0 height=14 735 width=15><b><font face="Helvetica, Arial" 736 ><font color="#00B04F"><font size="+1"> 737 <a name="details-black-threshold"></a>-black-threshold <i>red[,green][,blue][,opacity]</i> 738 </font></font></font></b></td></tr></table> 739 <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> 740 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 741 Use <strong>-black-threshold</strong> to set pixels with values below the specified 742 threshold to minimum value (black). If only one value is supplied, or the 743 red, green, and blue values are identical, then intensity thresholding is 744 used. If the color threshold values are not identical then channel-based 745 thresholding is used, and color distortion will occur. Specify a negative 746 value (e.g. -1) if you want a channel to be ignored but you do want to 747 threshold a channel later in the list. If a percent (%) symbol is 748 appended, then the values are treated as a percentage of maximum 749 range.</font></td></tr></table> 750 <table BORDER=0 WIDTH="94%"> 751 <tr> 752 <td width="3%"><br></td> 753 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 754 <img SRC="images/right_triangle_option.png" 755 ALT=">" BORDER=0 height=14 756 width=15><b><font face="Helvetica, Arial" 757 ><font color="#00B04F"><font size="+1"> 758 <a name="details-blue-primary"></a>-blue-primary <i><x>,<y></i> 759 </font></font></font></b></td></tr></table> 760 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blue chromaticity primary point</td></tr></table> 761 <table BORDER=0 WIDTH="94%"> 762 <tr> 763 <td width="3%"><br></td> 764 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 765 <img SRC="images/right_triangle_option.png" 766 ALT=">" BORDER=0 height=14 767 width=15><b><font face="Helvetica, Arial" 768 ><font color="#00B04F"><font size="+1"> 769 <a name="details-blur"></a>-blur <i><radius></i>{<i>x<sigma></i>}<i></i> 770 </font></font></font></b></td></tr></table> 771 <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> 772 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 773 Blur with the given radius and 774 standard deviation (sigma).</font></td></tr></table> 775 <table BORDER=0 WIDTH="94%"> 776 <tr> 777 <td width="3%"><br></td> 778 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 779 <img SRC="images/right_triangle_option.png" 780 ALT=">" BORDER=0 height=14 781 width=15><b><font face="Helvetica, Arial" 782 ><font color="#00B04F"><font size="+1"> 783 <a name="details-border"></a>-border <i><width>x<height></i> 784 </font></font></font></b></td></tr></table> 785 <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> 786 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 787 See <strong>-geometry</strong> for details 788 about the geometry specification.</font></td></tr></table> 789 <table BORDER=0 WIDTH="94%"> 790 <tr> 791 <td width="3%"><br></td> 792 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 793 <img SRC="images/right_triangle_option.png" 794 ALT=">" BORDER=0 height=14 795 width=15><b><font face="Helvetica, Arial" 796 ><font color="#00B04F"><font size="+1"> 797 <a name="details-bordercolor"></a>-bordercolor <i><color></i> 798 </font></font></font></b></td></tr></table> 799 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border color</td></tr></table> 800 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 801 The color is specified using the format described under the <strong>-fill</strong> 802 option.</font></td></tr></table> 803 <table BORDER=0 WIDTH="94%"> 804 <tr> 805 <td width="3%"><br></td> 806 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 807 <img SRC="images/right_triangle_option.png" 808 ALT=">" BORDER=0 height=14 809 width=15><b><font face="Helvetica, Arial" 810 ><font color="#00B04F"><font size="+1"> 811 -borderwidth <i><geometry></i> 812 </font></font></font></b></td></tr></table> 813 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border width</td></tr></table> 814 <table BORDER=0 WIDTH="94%"> 815 <tr> 816 <td width="3%"><br></td> 817 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 818 <img SRC="images/right_triangle_option.png" 819 ALT=">" BORDER=0 height=14 820 width=15><b><font face="Helvetica, Arial" 821 ><font color="#00B04F"><font size="+1"> 822 <a name="details-box"></a>-box <i><color></i> 823 </font></font></font></b></td></tr></table> 824 <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> 825 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 826 The color is specified using the format described under the <strong>-fill</strong> 827 option.</font></td></tr></table> 828 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 829 See <strong>-draw</strong> for further 830 details.</font></td></tr></table> 831 <table BORDER=0 WIDTH="94%"> 832 <tr> 833 <td width="3%"><br></td> 834 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 835 <img SRC="images/right_triangle_option.png" 836 ALT=">" BORDER=0 height=14 837 width=15><b><font face="Helvetica, Arial" 838 ><font color="#00B04F"><font size="+1"> 839 <a name="details-channel"></a>-channel <i><type></i> 840 </font></font></font></b></td></tr></table> 841 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of channel</td></tr></table> 842 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 843 Choose from: <strong>Red</strong>, <strong>Green</strong>, <strong>Blue</strong>, <strong>Opacity</strong>, 844 <strong>Matte</strong>, <strong>Cyan</strong>, <strong>Magenta</strong>, <strong>Yellow</strong>, <strong>Black</strong>, 845 or <strong>Gray</strong>.</font></td></tr></table> 846 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 847 Use this option to extract a particular <em>channel</em> from the image. 848 <strong>Opacity</strong>, 849 for example, is useful for extracting the opacity values from an image.</font></td></tr></table> 850 <table BORDER=0 WIDTH="94%"> 851 <tr> 852 <td width="3%"><br></td> 853 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 854 <img SRC="images/right_triangle_option.png" 855 ALT=">" BORDER=0 height=14 856 width=15><b><font face="Helvetica, Arial" 857 ><font color="#00B04F"><font size="+1"> 858 -charcoal <i><factor></i> 859 </font></font></font></b></td></tr></table> 860 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>simulate a charcoal drawing</td></tr></table> 861 <table BORDER=0 WIDTH="94%"> 862 <tr> 863 <td width="3%"><br></td> 864 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 865 <img SRC="images/right_triangle_option.png" 866 ALT=">" BORDER=0 height=14 867 width=15><b><font face="Helvetica, Arial" 868 ><font color="#00B04F"><font size="+1"> 869 <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> 870 </font></font></font></b></td></tr></table> 871 <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> 872 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 873 <em>Width</em> and <em>height</em> give the number of columns and rows to remove, 874 and <em>x</em> and <em>y</em> are offsets that give the location of the 875 leftmost column and topmost row to remove.</font></td></tr></table> 876 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 877 The <em>x</em> offset normally specifies the leftmost column to remove. 878 If the <strong>-gravity</strong> option is present with <em>NorthEast, East,</em> 879 or <em>SouthEast</em> 880 gravity, it gives the distance leftward from the right edge 881 of the image to the rightmost column to remove. Similarly, the <em>y</em> offset 882 normally specifies the topmost row to remove, but if 883 the <strong>-gravity</strong> option is present with <em>SouthWest, South,</em> 884 or <em>SouthEast</em> 885 gravity, it specifies the distance upward from the bottom edge of the 886 image to the bottom row to remove.</font></td></tr></table> 887 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 888 The <strong>-chop</strong> option removes entire rows and columns, 889 and moves the remaining corner blocks leftward and upward to close the gaps.</font></td></tr></table> 890 <table BORDER=0 WIDTH="94%"> 891 <tr> 892 <td width="3%"><br></td> 893 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 894 <img SRC="images/right_triangle_option.png" 895 ALT=">" BORDER=0 height=14 896 width=15><b><font face="Helvetica, Arial" 897 ><font color="#00B04F"><font size="+1"> 898 <a name="details-clip"></a>-clip 899 </font></font></font></b></td></tr></table> 900 <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> 901 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 902 If a clipping path is present, it will be applied to subsequent operations.</font></td></tr></table> 903 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 904 For example, if you type the following command:</font></td></tr></table> 905 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 906 gm convert -clip -negate cockatoo.tif negated.tif 907 </pre></font></td></tr></table> 908 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 909 only the pixels within the clipping path are negated.</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>-clip</strong> feature requires the XML library. If the XML library 912 is not present, the option is ignored.</font></td></tr></table> 913 <table BORDER=0 WIDTH="94%"> 914 <tr> 915 <td width="3%"><br></td> 916 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 917 <img SRC="images/right_triangle_option.png" 918 ALT=">" BORDER=0 height=14 919 width=15><b><font face="Helvetica, Arial" 920 ><font color="#00B04F"><font size="+1"> 921 <a name="details-coalesce"></a>-coalesce 922 </font></font></font></b></td></tr></table> 923 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>merge a sequence of images</td></tr></table> 924 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 925 Each image N in the sequence after Image 0 is replaced with the image 926 created by flattening images 0 through N.</font></td></tr></table> 927 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 928 The set of images 929 is terminated by the appearance of any option. 930 If the <strong>-coalesce</strong> 931 option appears after all of the input images, all images are coalesced.</font></td></tr></table> 932 <table BORDER=0 WIDTH="94%"> 933 <tr> 934 <td width="3%"><br></td> 935 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 936 <img SRC="images/right_triangle_option.png" 937 ALT=">" BORDER=0 height=14 938 width=15><b><font face="Helvetica, Arial" 939 ><font color="#00B04F"><font size="+1"> 940 <a name="details-colorize"></a>-colorize <i><value></i> 941 </font></font></font></b></td></tr></table> 942 <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> 943 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 944 Specify the amount of colorization as a percentage. You can apply separate 945 colorization values to the red, green, and blue channels of the image with 946 a colorization value list delimited with slashes (e.g. 0/0/50).</font></td></tr></table> 947 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 948 The <strong>-colorize</strong> option may be used in conjunction with <strong>-modulate</strong> 949 to produce a nice sepia toned image like:</font></td></tr></table> 950 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 951 gm convert input.ppm -modulate 115,0,100 \ 952 -colorize 7,21,50 output.ppm. 953 </pre></font></td></tr></table> 954 <table BORDER=0 WIDTH="94%"> 955 <tr> 956 <td width="3%"><br></td> 957 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 958 <img SRC="images/right_triangle_option.png" 959 ALT=">" BORDER=0 height=14 960 width=15><b><font face="Helvetica, Arial" 961 ><font color="#00B04F"><font size="+1"> 962 <a name="details-colormap"></a>-colormap <i><type></i> 963 </font></font></font></b></td></tr></table> 964 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>define the colormap type</td></tr></table> 965 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 966 Choose between <strong>shared</strong> or <strong>private</strong>.</font></td></tr></table> 967 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 968 This option only applies when the default X server visual is <em>PseudoColor</em> 969 or <em>GRAYScale</em>. Refer to <strong>-visual</strong> for more details. By default, 970 a shared colormap is allocated. The image shares colors with other X clients. 971 Some image colors could be approximated, therefore your image may look 972 very different than intended. Choose <strong>Private</strong> and the image colors 973 appear exactly as they are defined. However, other clients may 974 go <em>technicolor</em> when the image colormap is installed.</font></td></tr></table> 975 <table BORDER=0 WIDTH="94%"> 976 <tr> 977 <td width="3%"><br></td> 978 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 979 <img SRC="images/right_triangle_option.png" 980 ALT=">" BORDER=0 height=14 981 width=15><b><font face="Helvetica, Arial" 982 ><font color="#00B04F"><font size="+1"> 983 <a name="details-colors"></a>-colors <i><value></i> 984 </font></font></font></b></td></tr></table> 985 <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> 986 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 987 The actual number of colors in the image may be less than your request, 988 but never more. Note, this is a color reduction option. Images with less 989 unique colors than specified with this option will have any duplicate or 990 unused colors removed. The ordering of an existing color palette may be 991 altered. When converting an image from color to grayscale, convert the 992 image to the gray colorspace before reducing the number of colors since 993 doing so is most efficient. Refer to <a 994 href="quantize.html">quantize</a> for more details.</font></td></tr></table> 995 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 996 Note, options <strong>-dither</strong>, <strong>-colorspace</strong>, and <strong>-treedepth</strong> 997 affect the color reduction algorithm.</font></td></tr></table> 998 <table BORDER=0 WIDTH="94%"> 999 <tr> 1000 <td width="3%"><br></td> 1001 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1002 <img SRC="images/right_triangle_option.png" 1003 ALT=">" BORDER=0 height=14 1004 width=15><b><font face="Helvetica, Arial" 1005 ><font color="#00B04F"><font size="+1"> 1006 <a name="details-colorspace"></a>-colorspace <i><value></i> 1007 </font></font></font></b></td></tr></table> 1008 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table> 1009 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1010 Choices are: 1011 <strong>CineonLog</strong>, <strong>CMYK</strong>, <strong>GRAY</strong>, <strong>HSL</strong>, <strong>HWB</strong>, 1012 <strong>OHTA</strong>, <strong>RGB</strong>, <strong>Rec601Luma</strong>, <strong>Rec709Luma</strong>, 1013 <strong>Rec601YCbCr</strong>, <strong>Rec709YCbCr</strong>, <strong>Transparent</strong>, <strong>XYZ</strong>, 1014 <strong>YCbCr</strong>, <strong>YIQ</strong>, <strong>YPbPr</strong>, or <strong>YUV</strong>.</font></td></tr></table> 1015 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1016 Color reduction, by default, takes place in the RGB color space. Empirical 1017 evidence suggests that distances in color spaces such as YUV or YIQ correspond 1018 to perceptual color differences more closely than do distances in RGB space. 1019 These color spaces may give better results when color reducing an image. 1020 Refer to <a href="quantize.html">quantize</a> for more details.</font></td></tr></table> 1021 <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 1022 based on the recommendations for legacy NTSC television (ITU-R 1023 BT.601-5). The <strong>Rec709Luma</strong> space is based on the 1024 recommendations for HDTV (Rec. ITU-R BT.709-5) and is suitable for use 1025 with computer graphics, and for contemporary CRT displays. The 1026 <strong>GRAY</strong> colorspace currently selects the <strong>Rec601Luma</strong> 1027 colorspace by default for backwards compatibly reasons. This default 1028 may be re-considered in the future. 1029 </font></td></tr></table> 1030 <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 1031 based on the recommendations for legacy NTSC television (ITU-R BT.601-5). The 1032 <strong>Rec709CbCr</strong> space is based on the recommendations for HDTV (Rec. 1033 ITU-R BT.709-5) and is suitable for suitable for use with computer 1034 graphics, and for contemporary CRT displays. The <strong>YCbCr</strong> colorspace 1035 specification is equivalent to<strong>Rec601YCbCr</strong>. 1036 </font></td></tr></table> 1037 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1038 The <strong>Transparent</strong> color space behaves uniquely in that it preserves 1039 the matte channel of the image if it exists.</font></td></tr></table> 1040 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1041 The <strong>-colors</strong> or <strong>-monochrome</strong> option, or saving to a file 1042 format which requires color reduction, is required for this option to 1043 take effect.</font></td></tr></table> 1044 <table BORDER=0 WIDTH="94%"> 1045 <tr> 1046 <td width="3%"><br></td> 1047 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1048 <img SRC="images/right_triangle_option.png" 1049 ALT=">" BORDER=0 height=14 1050 width=15><b><font face="Helvetica, Arial" 1051 ><font color="#00B04F"><font size="+1"> 1052 <a name="details-comment"></a>-comment <i><string></i> 1053 </font></font></font></b></td></tr></table> 1054 <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> 1055 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1056 Use this option to assign a specific comment to the image, when writing 1057 to an image format that supports comments. You can include the 1058 image filename, type, width, height, or other image attribute by embedding 1059 special format characters listed under the <strong>-format</strong> option. 1060 The comment is not drawn on the image, but is embedded in the image 1061 datastream via a "Comment" tag or similar mechanism. If you want the 1062 comment to be visible on the image itself, use the <strong>-draw</strong> option 1063 instead.</font></td></tr></table> 1064 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1065 For example,</font></td></tr></table> 1066 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 1067 -comment "%m:%f %wx%h" 1068 </pre></font></td></tr></table> 1069 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1070 produces an image comment of <strong>MIFF:bird.miff 512x480</strong> for an image 1071 titled <strong>bird.miff</strong> and whose width is 512 and height is 480.</font></td></tr></table> 1072 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1073 If the first character of <em>string</em> is <em>@</em>, the image comment 1074 is read from a file titled by the remaining characters in the string. 1075 Please note that if the string comes from an untrusted source that it 1076 should be sanitized before use since otherwise the content of an 1077 arbitrary readable file could be incorporated in a comment in the 1078 output file (a security risk).</font></td></tr></table> 1079 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1080 If the -comment option appears multiple times, only the last comment is 1081 stored.</font></td></tr></table> 1082 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1083 In PNG images, the comment is stored in a <strong>tEXt</strong> or <strong>zTXt</strong> chunk 1084 with the keyword "comment".</font></td></tr></table> 1085 <table BORDER=0 WIDTH="94%"> 1086 <tr> 1087 <td width="3%"><br></td> 1088 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1089 <img SRC="images/right_triangle_option.png" 1090 ALT=">" BORDER=0 height=14 1091 width=15><b><font face="Helvetica, Arial" 1092 ><font color="#00B04F"><font size="+1"> 1093 <a name="details-compose"></a>-compose <i><operator></i> 1094 </font></font></font></b></td></tr></table> 1095 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image composition</td></tr></table> 1096 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1097 The description of composition uses abstract terminology in order to 1098 allow the the description to be more clear, while avoiding constant 1099 values which are specific to a particular build configuration. Each image 1100 pixel is represented by red, green, and blue levels (which are equal for 1101 a gray pixel). MaxRGB is the maximum integral value which may be stored 1102 in the red, green, or blue channels of the image. Each image pixel may 1103 also optionally (if the image matte channel is enabled) have an 1104 associated level of opacity (ranging from opaque to transparent), which 1105 may be used to determine the influence of the pixel color when 1106 compositing the pixel with another image pixel. If the image matte 1107 channel is disabled, then all pixels in the image are treated as opaque. 1108 The color of an <em>opaque</em> pixel is fully visible while the color of a 1109 <em>transparent</em> pixel color is entirely absent (pixel color is ignored).</font></td></tr></table> 1110 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1111 By definition, raster images have a rectangular shape. All image rows are 1112 of equal length, and all image columns have the same number of rows. By 1113 treating the opacity channel as a visual "mask" the rectangular image may 1114 be given a "shape" by treating the opacity channel as a cookie-cutter for 1115 the image. Pixels within the shape are opaque, while pixels outside the 1116 shape are transparent. Pixels on the boundary of the shape may be between 1117 opaque and transparent in order to provide antialiasing (visually smooth 1118 edges). The description of the composition operators use this concept of 1119 image "shape" in order to make the description of the operators easier to 1120 understand. While it is convenient to describe the operators in terms of 1121 "shapes" they are by no means limited to mask-style operations since they 1122 are based on continuous floating-point mathematics rather than simple 1123 boolean operations.</font></td></tr></table> 1124 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1125 By default, the <em>Over</em> composite operator is used. The following 1126 composite operators are available:</font></td></tr></table> 1127 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 1128 Over 1129 In 1130 Out 1131 Atop 1132 Xor 1133 Plus 1134 Minus 1135 Add 1136 Subtract 1137 Difference 1138 Divide 1139 Multiply 1140 Bumpmap 1141 Copy 1142 CopyRed 1143 CopyGreen 1144 CopyBlue 1145 CopyOpacity 1146 CopyCyan 1147 CopyMagenta 1148 CopyYellow 1149 CopyBlack 1150 </pre></font></td></tr></table> 1151 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1152 The behavior of each operator is described below.</font></td></tr></table> 1153 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1154 <dl> 1155 <dt>Over</dt> 1156 <dd>The result will be the union of the two image shapes, with opaque areas 1157 of <em>change-image</em> obscuring <em>base-image</em> in the region of 1158 overlap. 1159 </dd> 1160 <dt>In</dt> 1161 <dd>The result is simply <em>change-image</em> cut by the shape of 1162 <em>base-image</em>. None of the image data of <em>base-image</em> will be in 1163 the result. 1164 </dd> 1165 <dt>Out</dt> 1166 <dd>The resulting image is <em>change-image</em> with the shape of 1167 <em>base-image</em> cut out. 1168 </dd> 1169 <dt>Atop</dt> 1170 <dd>The result is the same shape as <em>base-image</em>, with 1171 <em>change-image</em> obscuring <em>base-image</em> where the image shapes 1172 overlap. Note this differs from <strong>over</strong> because the portion of 1173 <em>change-image</em> outside <em>base-image</em>'s shape does not appear in 1174 the result. 1175 </dd> 1176 <dt>Xor</dt> 1177 <dd>The result is the image data from both <em>change-image</em> and 1178 <em>base-image</em> that is outside the overlap region. The overlap region 1179 will be blank. 1180 </dd> 1181 <dt>Plus</dt> 1182 <dd>The result is just the sum of the image data. Output values are cropped 1183 to MaxRGB (no overflow). This operation is independent of the matte 1184 channels. 1185 </dd> 1186 <dt>Minus</dt> 1187 <dd>The result of <em>change-image</em> - <em>base-image</em>, with underflow 1188 cropped to zero. The matte channel is ignored (set to opaque, full 1189 coverage). 1190 </dd> 1191 <dt>Add</dt> 1192 <dd>The result of <em>change-image</em> + <em>base-image</em>, with overflow 1193 wrapping around (<em>mod</em> MaxRGB+1). 1194 </dd> 1195 <dt>Subtract</dt> 1196 <dd>The result of <em>change-image</em> - <em>base-image</em>, with underflow 1197 wrapping around (<em>mod</em> MaxRGB+1). The <strong>add</strong> and <strong>subtract</strong> 1198 operators can be used to perform reversible transformations. 1199 </dd> 1200 <dt>Difference</dt> 1201 <dd>The result of abs(<em>change-image</em> - <em>base-image</em>). This is 1202 useful for comparing two very similar images. 1203 </dd> 1204 <dt>Divide</dt> 1205 <dd>The result of <em>change-image</em> / <em>base-image</em>. This is useful 1206 for improving the readability of text on unevenly illuminated photos (by 1207 using a gaussian blurred copy of change-image as base-image). 1208 </dd> 1209 <dt>Multiply</dt> 1210 <dd>The result of <em>change-image</em> * <em>base-image</em>. This is useful for 1211 the creation of drop-shadows. 1212 </dd> 1213 <dt>Bumpmap</dt> 1214 <dd>The result <em>base-image</em> shaded by <em>change-image</em>. 1215 </dd> 1216 <dt>Copy</dt> 1217 <dd>The resulting image is <em>base-image</em> replaced with 1218 <em>change-image</em>. Here the matte information is ignored. 1219 </dd> 1220 <dt>CopyRed</dt> 1221 <dd>The resulting image is the red channel in <em>base-image</em> replaced with 1222 the red channel in <em>change-image</em>. The other channels are copied 1223 untouched. 1224 </dd> 1225 <dt>CopyGreen</dt> 1226 <dd>The resulting image is the green channel in <em>base-image</em> replaced 1227 with the green channel in <em>change-image</em>. The other channels are 1228 copied untouched. 1229 </dd> 1230 <dt>CopyBlue</dt> 1231 <dd>The resulting image is the blue channel in <em>base-image</em> replaced 1232 with the blue channel in <em>change-image</em>. The other channels are 1233 copied untouched. 1234 </dd> 1235 <dt>CopyOpacity</dt> 1236 <dd>The resulting image is the opacity channel in <em>base-image</em> replaced 1237 with the opacity channel in <em>change-image</em>. The other channels are 1238 copied untouched. 1239 </dd> 1240 <dt>CopyCyan</dt> 1241 <dd>The resulting image is the cyan channel in <em>base-image</em> replaced 1242 with the cyan channel in <em>change-image</em>. The other channels are 1243 copied untouched. Use of this operator requires that base-image be in 1244 CMYK(A) colorspace. 1245 </dd> 1246 <dt>CopyMagenta</dt> 1247 <dd>The resulting image is the magenta channel in <em>base-image</em> 1248 replaced with the magenta channel in <em>change-image</em>. The other 1249 channels are copied untouched. Use of this operator requires that 1250 base-image be in CMYK(A) colorspace. 1251 </dd> 1252 <dt>CopyYellow</dt> 1253 <dd>The resulting image is the yellow channel in <em>base-image</em> 1254 replaced with the yellow channel in <em>change-image</em>. The other 1255 channels are copied untouched. Use of this operator requires that 1256 base-image be in CMYK(A) colorspace. 1257 </dd> 1258 <dt>CopyBlack</dt> 1259 <dd>The resulting image is the black channel in <em>base-image</em> 1260 replaced with the black channel in <em>change-image</em>. The other 1261 channels are copied untouched. Use of this operator requires that 1262 base-image be in CMYK(A) colorspace. If change-image is not in CMYK 1263 space, then the change-image pixel intensities are used. 1264 </dd> 1265 </dl> 1266 </font></td></tr></table> 1267 <table BORDER=0 WIDTH="94%"> 1268 <tr> 1269 <td width="3%"><br></td> 1270 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1271 <img SRC="images/right_triangle_option.png" 1272 ALT=">" BORDER=0 height=14 1273 width=15><b><font face="Helvetica, Arial" 1274 ><font color="#00B04F"><font size="+1"> 1275 <a name="details-compress"></a>-compress <i><type></i> 1276 </font></font></font></b></td></tr></table> 1277 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image compression</td></tr></table> 1278 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1279 Choices are: <em>None</em>, <em>BZip</em>, <em>Fax</em>, 1280 <em>Group3</em>, <em>Group4</em>, 1281 <em>JPEG</em>, <em>Lossless</em>, 1282 <em>LZW</em>, <em>RLE</em>, <em>Zip</em>, <em>LZMA</em>, <em>JPEG2000</em>, 1283 <em>JPEG2000</em>, <em>JBIG</em>, <em>JBIG2</em>, <em>WebP</em>, or <em>ZSTD</em>. 1284 </font></td></tr></table> 1285 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1286 Specify <strong>+compress</strong> to store the binary image in an uncompressed format. 1287 The default is the compression type of the specified image file.</font></td></tr></table> 1288 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1289 <em>"Lossless"</em> refers to lossless JPEG, which is only available if 1290 the JPEG library has been patched to support it. Use of lossless JPEG is 1291 generally not recommended.</font></td></tr></table> 1292 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1293 Use the <strong>-quality</strong> option to set the compression level to be used 1294 by the JPEG, JPEG-2000, PNG, MIFF, MPEG, and TIFF encoders. Use the 1295 <strong>-sampling-factor</strong> option to set the sampling factor to be used 1296 by the DPX, JPEG, MPEG, and YUV encoders for downsampling the chroma 1297 channels.</font></td></tr></table> 1298 <table BORDER=0 WIDTH="94%"> 1299 <tr> 1300 <td width="3%"><br></td> 1301 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1302 <img SRC="images/right_triangle_option.png" 1303 ALT=">" BORDER=0 height=14 1304 width=15><b><font face="Helvetica, Arial" 1305 ><font color="#00B04F"><font size="+1"> 1306 <a name="details-contrast"></a>-contrast 1307 </font></font></font></b></td></tr></table> 1308 <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> 1309 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1310 This option enhances the intensity differences between the lighter and 1311 darker elements of the image. Use <strong>-contrast</strong> to enhance 1312 the image 1313 or <strong>+contrast</strong> to reduce the image contrast. 1314 </font></td></tr></table> 1315 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1316 For a more pronounced effect you can repeat the option:</font></td></tr></table> 1317 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 1318 gm convert rose: -contrast -contrast rose_c2.png 1319 </pre></font></td></tr></table> 1320 <table BORDER=0 WIDTH="94%"> 1321 <tr> 1322 <td width="3%"><br></td> 1323 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1324 <img SRC="images/right_triangle_option.png" 1325 ALT=">" BORDER=0 height=14 1326 width=15><b><font face="Helvetica, Arial" 1327 ><font color="#00B04F"><font size="+1"> 1328 <a name="details-convolve"></a>-convolve <i><kernel></i> 1329 </font></font></font></b></td></tr></table> 1330 <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> 1331 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1332 The kernel is specified as a comma-separated list of floating point 1333 values, ordered left-to right, starting with the top row. The order of 1334 the kernel is determined by the square root of the number of entries. 1335 Presently only square kernels are supported.</font></td></tr></table> 1336 <table BORDER=0 WIDTH="94%"> 1337 <tr> 1338 <td width="3%"><br></td> 1339 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1340 <img SRC="images/right_triangle_option.png" 1341 ALT=">" BORDER=0 height=14 1342 width=15><b><font face="Helvetica, Arial" 1343 ><font color="#00B04F"><font size="+1"> 1344 <a name="details-create-directories"></a>-create-directories 1345 </font></font></font></b></td></tr></table> 1346 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create output directory if required</td></tr></table> 1347 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1348 Use this option with <strong>-output-directory</strong> if the input paths contain 1349 subdirectories and it is desired to create similar subdirectories in the 1350 output directory. Without this option, <strong>mogrify</strong> will fail if the 1351 required output directory does not exist.</font></td></tr></table> 1352 <table BORDER=0 WIDTH="94%"> 1353 <tr> 1354 <td width="3%"><br></td> 1355 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1356 <img SRC="images/right_triangle_option.png" 1357 ALT=">" BORDER=0 height=14 1358 width=15><b><font face="Helvetica, Arial" 1359 ><font color="#00B04F"><font size="+1"> 1360 <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> 1361 </font></font></font></b></td></tr></table> 1362 <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> 1363 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1364 See <strong>-geometry</strong> for details 1365 about the geometry specification.</font></td></tr></table> 1366 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1367 The width and height give the size of the image that remains after cropping, 1368 and <em>x</em> and <em>y</em> are offsets that give the location of the top left 1369 corner of the cropped 1370 image with respect to the original image. To specify the amount to be 1371 removed, use <strong>-shave</strong> instead.</font></td></tr></table> 1372 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1373 If the <em>x</em> and <em>y</em> offsets are present, a single image is 1374 generated, consisting of the pixels from the cropping region. 1375 The offsets specify the location of the upper left corner of 1376 the cropping region measured downward and rightward with respect to the 1377 upper left corner of the image. 1378 If the <strong>-gravity</strong> option is present with <em>NorthEast, East,</em> 1379 or <em>SouthEast</em> 1380 gravity, it gives the distance leftward from the right edge 1381 of the image to the right edge of the cropping region. Similarly, if 1382 the <strong>-gravity</strong> option is present with <em>SouthWest, South,</em> 1383 or <em>SouthEast</em> 1384 gravity, the distance is measured upward between the bottom 1385 edges.</font></td></tr></table> 1386 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1387 If the <em>x</em> and <em>y</em> offsets are omitted, a set of tiles of the 1388 specified geometry, covering the entire input image, is generated. The 1389 rightmost tiles and the bottom tiles are smaller if the 1390 specified geometry extends beyond the dimensions of the input image.</font></td></tr></table> 1391 <table BORDER=0 WIDTH="94%"> 1392 <tr> 1393 <td width="3%"><br></td> 1394 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1395 <img SRC="images/right_triangle_option.png" 1396 ALT=">" BORDER=0 height=14 1397 width=15><b><font face="Helvetica, Arial" 1398 ><font color="#00B04F"><font size="+1"> 1399 <a name="details-cycle"></a>-cycle <i><amount></i> 1400 </font></font></font></b></td></tr></table> 1401 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>displace image colormap by amount</td></tr></table> 1402 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1403 <em>Amount</em> defines the number of positions each colormap entry isshifted. 1404 </font></td></tr></table> 1405 <table BORDER=0 WIDTH="94%"> 1406 <tr> 1407 <td width="3%"><br></td> 1408 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1409 <img SRC="images/right_triangle_option.png" 1410 ALT=">" BORDER=0 height=14 1411 width=15><b><font face="Helvetica, Arial" 1412 ><font color="#00B04F"><font size="+1"> 1413 -debug <i><events></i> 1414 </font></font></font></b></td></tr></table> 1415 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table> 1416 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1417 The <tt>events</tt> parameter specifies which events are to be logged. It 1418 can be either <tt>None</tt>, <tt>All</tt>, or a comma-separated list 1419 consisting of one or more of the following domains: 1420 <tt>Annotate</tt>, 1421 <tt>Blob</tt>, 1422 <tt>Cache</tt>, 1423 <tt>Coder</tt>, 1424 <tt>Configure</tt>, 1425 <tt>Deprecate</tt>, 1426 <tt>Error</tt>, 1427 <tt>Exception</tt>, 1428 <tt>FatalError</tt>, 1429 <tt>Information</tt>, 1430 <tt>Locale</tt>, 1431 <tt>Option</tt>, 1432 <tt>Render</tt>, 1433 <tt>Resource</tt>, 1434 <tt>TemporaryFile</tt>, 1435 <tt>Transform</tt>, 1436 <tt>User</tt>. 1437 <tt>Warning</tt>, or 1438 <tt>X11</tt>, 1439 For example, to log cache and blob events, use</font></td></tr></table> 1440 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 1441 gm convert -debug "Cache,Blob" rose: rose.png 1442 </pre></font></td></tr></table> 1443 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1444 The "User" domain is normally empty, but developers can log "User" events 1445 in their private copy of GraphicsMagick.</font></td></tr></table> 1446 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1447 Use the <strong>-log</strong> option to specify the format for debugging output.</font></td></tr></table> 1448 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1449 Use <strong>+debug</strong> to turn off all logging.</font></td></tr></table> 1450 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1451 An alternative to using <strong>-debug</strong> is to use the <strong>MAGICK_DEBUG</strong> 1452 environment variable. The allowed values for the <strong>MAGICK_DEBUG</strong> 1453 environment variable are the same as for the <strong>-debug</strong> option.</font></td></tr></table> 1454 <table BORDER=0 WIDTH="94%"> 1455 <tr> 1456 <td width="3%"><br></td> 1457 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1458 <img SRC="images/right_triangle_option.png" 1459 ALT=">" BORDER=0 height=14 1460 width=15><b><font face="Helvetica, Arial" 1461 ><font color="#00B04F"><font size="+1"> 1462 <a name="details-deconstruct"></a>-deconstruct 1463 </font></font></font></b></td></tr></table> 1464 <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> 1465 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1466 This option compares each image with the next in a sequence and 1467 returns the maximum bounding region of any pixel differences it discovers. 1468 This method can undo a coalesced sequence returned by the 1469 <strong>-coalesce</strong> option, and is useful for removing redundant information 1470 from a GIF or MNG animation.</font></td></tr></table> 1471 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1472 The sequence of images 1473 is terminated by the appearance of any option. 1474 If the <strong>-deconstruct</strong> 1475 option appears after all of the input images, all images are deconstructed.</font></td></tr></table> 1476 <table BORDER=0 WIDTH="94%"> 1477 <tr> 1478 <td width="3%"><br></td> 1479 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1480 <img SRC="images/right_triangle_option.png" 1481 ALT=">" BORDER=0 height=14 1482 width=15><b><font face="Helvetica, Arial" 1483 ><font color="#00B04F"><font size="+1"> 1484 <a name="details-define"></a>-define <i><key></i>{<i>=<value></i>}<i>,...</i> 1485 </font></font></font></b></td></tr></table> 1486 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table> 1487 <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 1488 decoders to use while reading and writing image data. Definitions 1489 may be passed to coders and decoders to control options that are 1490 specific to certain image formats. If <em>value</em> is missing for a 1491 definition, an empty-valued definition of a flag will be created with 1492 that name. This is used to control on/off options. Use <tt>+define 1493 <key>,...</tt> to remove definitions previously created. Use 1494 <tt>+define "*"</tt> to remove all existing definitions.</font></td></tr></table> 1495 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1496 The following definitions may be created:</font></td></tr></table> 1497 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1498 <dl> 1499 <dt>cineon:colorspace={rgb|cineonlog}</dt> 1500 <dd>Use the cineon:colorspace option when reading a Cineon file to 1501 specify the colorspace the Cineon file uses. This overrides the colorspace 1502 type implied by the DPX header (if any). 1503 </dd> 1504 <dt>dpx:bits-per-sample=<value></dt> 1505 <dd>If the dpx:bits-per-sample key is defined, GraphicsMagick will write 1506 DPX images with the specified bits per sample, overriding any existing 1507 depth value. If this option is not specified, then the value is based on 1508 the existing image depth value from the original image file. The DPX 1509 standard supports bits per sample values of 1, 8, 10, 12, and 16. Many 1510 DPX readers demand a sample size of 10 bits with type A padding (see 1511 below). 1512 </dd> 1513 <dt>dpx:colorspace={rgb|cineonlog}</dt> 1514 <dd>Use the dpx:colorspace option when reading a DPX file to 1515 specify the colorspace the DPX file uses. This overrides the colorspace 1516 type implied by the DPX header (if any). 1517 </dd> 1518 <dt>dpx:packing-method={packed|a|b|lsbpad|msbpad}</dt> 1519 <dd>DPX samples are output within 32-bit words. They may be tightly 1520 packed end-to-end within the words ("packed"), padded with null bits to 1521 the right of the sample ("a" or "lsbpad"), or padded with null bits to the 1522 left of the sample ("b" or "msbpad"). This option only has an effect for 1523 sample sizes of 10 or 12 bits. If samples are not packed, the DPX 1524 standard recommends type A padding. Many DPX readers demand a sample size 1525 of 10 bits with type A padding. 1526 </dd> 1527 <dt>dpx:pixel-endian={lsb|msb}</dt> 1528 <dd>Allows the user to specify the endian order of the pixels when 1529 reading or writing the DPX files. Sometimes this is useful if the file is 1530 (or must be) written incorrectly so that the file header and the pixels 1531 use different endianness. 1532 </dd> 1533 <dt>dpx:swap-samples={true|false}</dt> 1534 <dd>GraphicsMagick strives to adhere to the DPX standard but certain 1535 aspects of the standard can be quite confusing. As a result, some 10-bit 1536 DPX files have Red and Blue interchanged, or Cb and Cr interchanged due 1537 to an different interpretation of the standard, or getting the wires 1538 crossed. The swap-samples option may be supplied when reading or writing 1539 in order to read or write using the necessary sample order. 1540 </dd> 1541 <dt>gradient:direction={South|North|West|East|NorthWest|NorthEast|SouthWest|SouthEast}</dt> 1542 <dd>By default, the gradient coder produces a gradient from top to 1543 bottom ("South"). Since GraphicsMagick 1.3.35, the gradient direction 1544 may be specified to produce gradient vectors according to a 1545 gravity-like specification. The arguments are <strong>South</strong> (Top to 1546 Bottom), <strong>North</strong> (Bottom to Top), <strong>West</strong> (Right to Left), 1547 <strong>East</strong> (Left to Right), <strong>NorthWest</strong> (Bottom-Right to 1548 Top-Left), <strong>NorthEast</strong> (Bottom-Left to Top-Right), 1549 <strong>SouthWest</strong> (Top-Right Bottom-Left), and <strong>SouthEast</strong> 1550 (Top-Left to Bottom-Right). 1551 </dd> 1552 <dt>jp2:rate=<value></dt> 1553 <dd>Specify the compression factor to use while writing JPEG-2000 1554 files. The compression factor is the reciprocal of the compression 1555 ratio. The valid range is 0.0 to 1.0, with 1.0 indicating lossless 1556 compression. If defined, this value overrides the -quality 1557 setting. The default quality setting of 75 results in a rate value of 1558 0.06641. 1559 </dd> 1560 <dt>jpeg:block-smoothing={true|false}</dt> 1561 <dd>Enables or disables block smoothing when reading a JPEG file 1562 (default enabled). 1563 </dd> 1564 <dt>jpeg:dct-method=<value></dt> 1565 <dd>Selects the IJG JPEG library DCT implementation to use. The 1566 encoding implementations vary in speed and encoding error. The 1567 available choices for <strong>value</strong> are <strong>islow</strong>, <strong>ifast</strong>, 1568 <strong>float</strong>, <strong>default</strong> and <strong>fastest</strong>. Note that 1569 <strong>fastest</strong> might not necessarily be fastest on your CPU, depending 1570 on the choices made when the JPEG library was built and how your CPU 1571 behaves. 1572 </dd> 1573 <dt>jpeg:fancy-upsampling={true|false}</dt> 1574 <dd>Enables or disables fancy upsampling when reading a JPEG file 1575 (default enabled). 1576 </dd> 1577 <dt>jpeg:max-scan-number=<value></dt> 1578 <dd>Specifies an integer value for the maximum number of progressive 1579 scans allowed in a JPEG file. The default maximum is 100 scans. This 1580 limit is imposed due to a weakness in the JPEG standard which allows 1581 small JPEG files to take many minutes or hours to be read. 1582 </dd> 1583 <dt>jpeg:max-warnings=<value></dt> 1584 <dd>Specifies an integer value for how many warnings are allowed for 1585 any given error type before being promoted to a hard error. JPEG 1586 files producing excessive warnings indicate a problem with the file. 1587 </dd> 1588 <dt>jpeg:optimize-coding={true|false}</dt> 1589 <dd>Selects if huffman encoding should be used. Huffman encoding is enabled 1590 by default, but may be disabled for very large images since it encoding 1591 requires that the entire image be buffered in memory. Huffman encoding 1592 produces smaller JPEG files at the expense of added compression time and 1593 memory consumption. 1594 </dd> 1595 <dt>jpeg:preserve-settings</dt> 1596 <dd>If the jpeg:preserve-settings flag is defined, the JPEG encoder will 1597 use the same "quality" and "sampling-factor" settings that were found 1598 in the input file, if the input was in JPEG format. These settings are 1599 also preserved if the input is a JPEG file and the output is a JNG 1600 file. If the colorspace of the output file differs from that of the 1601 input file, the quality setting is preserved but the sampling-factors 1602 are not. 1603 </dd> 1604 <dt>pcl:fit-to-page</dt> 1605 <dd>If the pcl:fit-to-page flag is defined, then the printer is 1606 requested to scale the image to fit the page size (width and/or 1607 height).</dd> 1608 <dt>mng:maximum-loops=<value></dt> 1609 <dd>mng:maximum-loops specifies the maximum number of loops allowed to 1610 be specified by a MNG LOOP chunk. Without an imposed limit, a MNG file 1611 could request up to 2147483647 loops, which could run for a very long 1612 time. The current default limit is 512 loops. 1613 </dd> 1614 <dt>pdf:use-cropbox={true|false}</dt> 1615 <dd>If the pdf:use-cropbox flag is set to <strong>true</strong>, then 1616 Ghostscript is requested to apply the PDF crop box. 1617 </dd> 1618 <dt>pdf:stop-on-error={true|false}</dt> 1619 <dd>If the pdf:stop-on-error flag is set to <strong>true</strong>, then 1620 Ghostscript is requested to stop processing the PDF when the first 1621 error is encountered. Otherwise it will attempt to process all 1622 requested pages. 1623 </dd> 1624 <dt>ps:imagemask</dt> 1625 <dd>If the ps:imagemask flag is defined, the PS3 and EPS3 coders will 1626 create Postscript files that render bilevel images with the Postscript 1627 imagemask operator instead of the image operator. 1628 </dd> 1629 <dt>ptif:minimum-geometry=<geometry></dt> 1630 <dd>If the ptif:minimum-geometry key is defined, GraphicsMagick will 1631 use it to determine the minimum frame size to output when writing a 1632 pyramid TIFF file (a TIFF file containing a succession of reduced 1633 versions of the first frame). The default minimum geometry is 32x32. 1634 </dd> 1635 <dt>tiff:alpha={unspecified|associated|unassociated}</dt> 1636 <dd>Specify the TIFF alpha channel type when reading or writing TIFF files, 1637 overriding the normal value. The default alpha channel type for new files 1638 is unspecified alpha. Existing alpha settings are preserved when 1639 converting from one TIFF file to another. When a TIFF file uses 1640 associated alpha, the image pixels are pre-multiplied (i.e. altered) with 1641 the alpha channel. Files with "associated" alpha appear as if they were 1642 alpha composited on a black background when the matte channel is 1643 disabled. If the unassociated alpha type is selected, then the alpha 1644 channel is saved without altering the pixels. Photoshop recognizes 1645 associated alpha as transparency information, if the file is saved with 1646 unassociated alpha, the alpha information is loaded as an independent 1647 channel. Note that for many years, ImageMagick and GraphicsMagick marked 1648 TIFF files as using associated alpha, without properly pre-multiplying 1649 the pixels. 1650 </dd> 1651 <dt>tiff:fill-order={msb2lsb|lsb2msb}</dt> 1652 <dd>If the tiff:fill-order key is defined, GraphicsMagick will use it to 1653 determine the bit fill order used while writing TIFF files. The normal default 1654 is "msb2lsb", which matches the native bit order of all modern CPUs. The 1655 only exception to this is when Group3 or Group4 FAX compression is 1656 requested since FAX machines send data in bit-reversed order and 1657 therefore RFC 2301 recommends using reverse order. 1658 </dd> 1659 <dt>tiff:group-three-options=<value></dt> 1660 <dd>If the tiff:group-three-options key is defined, GraphicsMagick 1661 will use it to set the group3 options tag when writing 1662 group3-compressed TIFF. Please see the TIFF specification for the 1663 usage of this tag. The default value is 4. 1664 </dd> 1665 <dt>tiff:ignore-tags=<tags></dt> 1666 <dd>If the tiff:ignore-tags key is defined, then it is used as a list 1667 of comma-delimited integer TIFF tag values to ignore while reading the 1668 TIFF file. This is useful in order to be able to read files which 1669 which otherwise fail to read due to problems with TIFF tags. Note 1670 that some TIFF tags are required in order to be able to read the image 1671 data at all. 1672 </dd> 1673 <dt>tiff:report-warnings={false|true}</dt> 1674 <dd>If the tiff:report-warnings key is defined and set to <strong>true</strong>, 1675 then TIFF warnings are reported as a warning exception rather than as 1676 a coder log message. Such warnings are reported after the image has 1677 been read or written. Most TIFF warnings are benign but sometimes 1678 they may help deduce problems with the TIFF file, or help detect that 1679 the TIFF file requires a special application to read successfully due 1680 to the use of proprietary or specialized extensions. 1681 </dd> 1682 <dt>tiff:sample-format={unsigned|ieeefp}</dt> 1683 <dd>If the tiff:sample-format key is defined, GraphicsMagick will use it to 1684 determine the sample format used while writing TIFF files. The default is 1685 "unsigned". Specify "ieeefp" in order to write floating-point TIFF 1686 files with float (32-bit) or double (64-bit) values. Use the 1687 tiff:bits-per-sample define to determine the type of floating-point value 1688 to use. 1689 </dd> 1690 <dt>tiff:max-sample-value=<value></dt> 1691 <dd>If the tiff:max-sample-value key is defined, GraphicsMagick will use the 1692 assigned value as the maximum floating point value while reading or 1693 writing IEEE floating point TIFFs. Otherwise the maximum value is 1.0 or 1694 the value obtained from the file's SMaxSampleValue tag (if present). The 1695 floating point data is currently not scanned in advance to determine a 1696 best maximum sample value so if the range is not 1.0, or the 1697 SMaxSampleValue tag is not present, it may be necessary to 1698 (intelligently) use this parameter to properly read a file. 1699 </dd> 1700 <dt>tiff:min-sample-value=<value></dt> 1701 <dd>If the tiff:min-sample-value key is defined, GraphicsMagick will use 1702 the assigned value as the minimum floating point value while reading or 1703 writing IEEE floating point TIFFs. Otherwise the minimum value is 0.0 or 1704 the value obtained from the file's SMinSampleValue tag (if present). 1705 </dd> 1706 <dt>tiff:bits-per-sample=<value></dt> 1707 <dd>If the tiff:bits-per-sample key is defined, GraphicsMagick will write 1708 images with the specified bits per sample, overriding any existing depth 1709 value. Value may be any in the range of 1 to 32, or 64 when the default 1710 'unsigned' format is written, or 16/32/24/64 if IEEEFP format is written. 1711 Please note that the baseline TIFF 6.0 specification only requires 1712 readers to handle certain powers of two, and the values to be handled 1713 depend on the nature of the image (e.g. colormapped, grayscale, RGB, CMYK). 1714 </dd> 1715 <dt>tiff:samples-per-pixel=<value></dt> 1716 <dd>If the tiff:samples-per-pixel key is defined to a value, the TIFF coder 1717 will write TIFF images with the defined samples per pixel, overriding any 1718 value stored in the image. This option should not normally be used. 1719 </dd> 1720 <dt>tiff:rows-per-strip=<value></dt> 1721 <dd>Allows the user to specify the number of rows per TIFF strip. 1722 Rounded up to a multiple of 16 when using JPEG compression. Ignored when 1723 using tiles. 1724 </dd> 1725 <dt>tiff:strip-per-page=true</dt> 1726 <dd>Requests that the image is written in a single TIFF strip. This is 1727 normally the default when group3 or group4 compression is requested 1728 within reasonable limits. Requesting a single strip for large images may 1729 result in failure due to resource consumption in the writer or reader. 1730 </dd> 1731 <dt>tiff:tile</dt> 1732 <dd>Enable writing tiled TIFF (rather than stripped) using the default tile 1733 size. Tiled TIFF organizes the image as an array of smaller images 1734 (tiles) in order to enable random access. 1735 </dd> 1736 <dt>tiff:tile-geometry=<width>x<height></dt> 1737 <dd>Specify the tile size to use while writing tiled TIFF. Width and 1738 height should be a multiple of 16. If the value is not a multiple of 16, 1739 then it will be rounded down. Enables tiled TIFF if it has not already 1740 been enabled. GraphicsMagick does not use tiled storage internally so 1741 tiles need to be converted back and forth from the internal 1742 scanline-oriented storage to tile-oriented storage. Testing with typical 1743 RGB images shows that useful square tile size values range from 128x128 1744 to 1024x1024. Large images which require using a disk-based pixel cache 1745 benefit from large tile sizes while images which fit in memory work well 1746 with smaller tile sizes. 1747 </dd> 1748 <dt>tiff:tile-width=<width></dt> 1749 <dd>Specify the tile width to use while writing tiled TIFF. The tile height 1750 is then defaulted to an appropriate size. Width should be a multiple of 1751 16. If the value is not a multiple of 16, then it will be rounded down. 1752 Enables tiled TIFF if it has not already been enabled. 1753 </dd> 1754 <dt>tiff:tile-height=<height></dt> 1755 <dd>Specify the tile height to use while writing tiled TIFF. The tile width 1756 is then defaulted to an appropriate size. Height should be a multiple of 1757 16. If the value is not a multiple of 16, then it will be rounded down. 1758 Enables tiled TIFF if it has not already been enabled. 1759 </dd> 1760 <dt>tiff:webp-lossless={TRUE|FALSE}</dt> 1761 <dd>Specify a value of <strong>TRUE</strong> to enable lossless mode while 1762 writing WebP-compressed TIFF files. The WebP <strong>webp:lossless</strong> 1763 option may also be used. The quality factor set by the 1764 <strong>-quality</strong> option may be used to influence the level of effort 1765 expended while compressing. 1766 </dd> 1767 <dt>tiff:zstd-compress-level=<value></dt> 1768 <dd>Specify the compression level to use while writing Zstd-compressed 1769 TIFF files. The valid range is 1 to 22. If this define is not 1770 specified, then the 'quality' value is used such that the default 1771 quality setting of 75 is translated to a compress level of 9 such that 1772 'quality' has a useful range of 10-184 if used for this purpose. 1773 </dd> 1774 <dt>webp:lossless={true|false}</dt> 1775 <dd>Enable lossless encoding. 1776 </dd> 1777 <dt>webp:method={0-6}</dt> 1778 <dd>Quality/speed trade-off. 1779 </dd> 1780 <dt>webp:image-hint={default,graph,photo,picture}</dt> 1781 <dd>Hint for image type. 1782 </dd> 1783 <dt>webp:target-size=<integer></dt> 1784 <dd>Target size in bytes. 1785 </dd> 1786 <dt>webp:target-psnr=<float></dt> 1787 <dd>Minimal distortion to try to achieve. 1788 </dd> 1789 <dt>webp:segments={1-4}</dt> 1790 <dd>Maximum number of segments to use. 1791 </dd> 1792 <dt>webp:sns-strength={0-100}</dt> 1793 <dd>Spatial Noise Shaping. 1794 </dd> 1795 <dt>webp:filter-strength={0-100}</dt> 1796 <dd>Filter strength. 1797 </dd> 1798 <dt>webp:filter-sharpness={0-7}</dt> 1799 <dd>Filter sharpness. 1800 </dd> 1801 <dt>webp:filter-type={0,1}</dt> 1802 <dd>Filtering type. 0 = simple, 1 = strong (only used if 1803 filter-strength > 0 or autofilter is enabled). 1804 </dd> 1805 <dt>webp:auto-filter={true|false}</dt> 1806 <dd>Auto adjust filter's strength. 1807 </dd> 1808 <dt>webp:alpha-compression=<integer></dt> 1809 <dd>Algorithm for encoding the alpha plane (0 = none, 1 = compressed 1810 with WebP lossless). Default is 1. 1811 </dd> 1812 <dt>webp:alpha-filtering=<integer></dt> 1813 <dd>Predictive filtering method for alpha plane. 0: none, 1: fast, 2: 1814 best. Default is 1. 1815 </dd> 1816 <dt>webp:alpha-quality={0-100}</dt> 1817 <dd>Between 0 (smallest size) and 100 (lossless). Default is 100. 1818 </dd> 1819 <dt>webp:pass=[1..10]</dt> 1820 <dd>Number of entropy-analysis passes. 1821 </dd> 1822 <dt>webp:show-compressed={true|false}</dt> 1823 <dd>Export the compressed picture back. In-loop filtering is not 1824 applied. 1825 </dd> 1826 <dt>webp:preprocessing=[0,1,2]</dt> 1827 <dd>0=none, 1=segment-smooth, 2=pseudo-random dithering 1828 </dd> 1829 <dt>webp:partitions=[0-3]</dt> 1830 <dd>log2(number of token partitions) in [0..3]. Default is 0 for 1831 easier progressive decoding. 1832 </dd> 1833 <dt>webp:partition-limit={0-100}</dt> 1834 <dd>Quality degradation allowed to fit the 512k limit on prediction 1835 modes coding (0: no degradation, 100: maximum possible 1836 degradation). 1837 </dd> 1838 <dt>webp:emulate-jpeg-size={true|false}</dt> 1839 <dd>If true, compression parameters will be remapped to better match 1840 the expected output size from JPEG compression. Generally, the output 1841 size will be similar but the degradation will be lower. 1842 </dd> 1843 <dt>webp:thread-level=<integer></dt> 1844 <dd>If non-zero, try and use multi-threaded encoding. 1845 </dd> 1846 <dt>webp:low-memory={true|false}</dt> 1847 <dd>If set, reduce memory usage (but increase CPU use) 1848 </dd> 1849 <dt>webp:use-sharp-yuv={true|false}</dt> 1850 <dd>If set, if needed, use sharp (and slow) RGB->YUV conversion 1851 </dd> 1852 </dl> 1853 </font></td></tr></table> 1854 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1855 For example, to create a postscript file that will render only the black 1856 pixels of a bilevel image, use:</font></td></tr></table> 1857 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 1858 gm convert bilevel.tif -define ps:imagemask eps3:stencil.ps 1859 </pre></font></td></tr></table> 1860 <table BORDER=0 WIDTH="94%"> 1861 <tr> 1862 <td width="3%"><br></td> 1863 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1864 <img SRC="images/right_triangle_option.png" 1865 ALT=">" BORDER=0 height=14 1866 width=15><b><font face="Helvetica, Arial" 1867 ><font color="#00B04F"><font size="+1"> 1868 <a name="details-delay"></a>-delay <i><1/100ths of a second></i> 1869 </font></font></font></b></td></tr></table> 1870 <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> 1871 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1872 This option is useful for regulating the animation of image sequences 1873 <em>Delay/100</em> seconds must expire before the display 1874 of the next image. The default is no delay between each showing of the 1875 image sequence. The maximum delay is 65535.</font></td></tr></table> 1876 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1877 You can specify a delay range (e.g. <em>-delay 10-500</em>) which sets the 1878 minimum and maximum delay.</font></td></tr></table> 1879 <table BORDER=0 WIDTH="94%"> 1880 <tr> 1881 <td width="3%"><br></td> 1882 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1883 <img SRC="images/right_triangle_option.png" 1884 ALT=">" BORDER=0 height=14 1885 width=15><b><font face="Helvetica, Arial" 1886 ><font color="#00B04F"><font size="+1"> 1887 <a name="details-density"></a>-density <i><width>x<height></i> 1888 </font></font></font></b></td></tr></table> 1889 <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> 1890 <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 1891 raster image or the canvas resolution while rendering (reading) vector 1892 formats such as Postscript, PDF, WMF, and SVG into a raster image. Image 1893 resolution provides the unit of measure to apply when rendering to an 1894 output device or raster image. The default unit of measure is in dots 1895 per inch (DPI). The <strong>-units</strong> option may be used to select dots per 1896 centimeter instead.</font></td></tr></table> 1897 <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 1898 one point per pixel (Macintosh and Postscript standard). Computer 1899 screens are normally 72 or 96 dots per inch while printers typically 1900 support 150, 300, 600, or 1200 dots per inch. To determine the 1901 resolution of your display, use a ruler to measure the width of your 1902 screen in inches, and divide by the number of horizontal pixels (1024 on 1903 a 1024x768 display).</font></td></tr></table> 1904 <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 1905 the stored image resolution. Note that Photoshop stores and obtains 1906 image resolution from a proprietary embedded profile. If this profile is 1907 not stripped from the image, then Photoshop will continue to treat the 1908 image using its former resolution, ignoring the image resolution 1909 specified in the standard file header.</font></td></tr></table> 1910 <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 1911 raster image. It may be used to adjust the rendered size for desktop 1912 publishing purposes by adjusting the scale applied to the pixels. To 1913 resize the image so that it is the same size at a different resolution, 1914 use the <strong>-resample</strong> option.</font></td></tr></table> 1915 <table BORDER=0 WIDTH="94%"> 1916 <tr> 1917 <td width="3%"><br></td> 1918 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1919 <img SRC="images/right_triangle_option.png" 1920 ALT=">" BORDER=0 height=14 1921 width=15><b><font face="Helvetica, Arial" 1922 ><font color="#00B04F"><font size="+1"> 1923 <a name="details-depth"></a>-depth <i><value></i> 1924 </font></font></font></b></td></tr></table> 1925 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table> 1926 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1927 This is the number of bits of color to preserve in the image. Any value 1928 between 1 and <strong>QuantumDepth</strong> (build option) may be specified, 1929 although 8 or 16 are the most common values. Use this option to specify 1930 the depth of raw images whose depth is unknown such as GRAY, RGB, or 1931 CMYK, or to change the depth of any image after it has been read.</font></td></tr></table> 1932 <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 1933 used as a form of simple compression by discarding the least significant 1934 bits. Reducing the depth in advance may speed up color quantization, and 1935 help create smaller file sizes when using a compression algorithm like 1936 LZW or ZIP.</font></td></tr></table> 1937 <table BORDER=0 WIDTH="94%"> 1938 <tr> 1939 <td width="3%"><br></td> 1940 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1941 <img SRC="images/right_triangle_option.png" 1942 ALT=">" BORDER=0 height=14 1943 width=15><b><font face="Helvetica, Arial" 1944 ><font color="#00B04F"><font size="+1"> 1945 -descend 1946 </font></font></font></b></td></tr></table> 1947 <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> 1948 <table BORDER=0 WIDTH="94%"> 1949 <tr> 1950 <td width="3%"><br></td> 1951 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1952 <img SRC="images/right_triangle_option.png" 1953 ALT=">" BORDER=0 height=14 1954 width=15><b><font face="Helvetica, Arial" 1955 ><font color="#00B04F"><font size="+1"> 1956 -despeckle 1957 </font></font></font></b></td></tr></table> 1958 <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> 1959 <table BORDER=0 WIDTH="94%"> 1960 <tr> 1961 <td width="3%"><br></td> 1962 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1963 <img SRC="images/right_triangle_option.png" 1964 ALT=">" BORDER=0 height=14 1965 width=15><b><font face="Helvetica, Arial" 1966 ><font color="#00B04F"><font size="+1"> 1967 <a name="details-displace"></a>-displace <i><horizontal scale>x<vertical scale></i> 1968 </font></font></font></b></td></tr></table> 1969 <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> 1970 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1971 With this option, <em>composite image</em> is used as a displacement map. Black, 1972 within the displacement map, is a maximum positive displacement. White is a 1973 maximum negative displacement and middle gray is neutral. The displacement 1974 is scaled to determine the pixel shift. By default, the displacement applies 1975 in both the horizontal and vertical directions. However, if you specify 1976 <em>mask</em>, <em>composite image</em> is the horizontal X displacement and 1977 <em>mask</em> the vertical Y displacement.</font></td></tr></table> 1978 <table BORDER=0 WIDTH="94%"> 1979 <tr> 1980 <td width="3%"><br></td> 1981 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1982 <img SRC="images/right_triangle_option.png" 1983 ALT=">" BORDER=0 height=14 1984 width=15><b><font face="Helvetica, Arial" 1985 ><font color="#00B04F"><font size="+1"> 1986 <a name="details-display"></a>-display <i><host:display[.screen]></i> 1987 </font></font></font></b></td></tr></table> 1988 <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> 1989 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 1990 This option is used with convert for 1991 obtaining image or font from this X server. See <em>X(1)</em>.</font></td></tr></table> 1992 <table BORDER=0 WIDTH="94%"> 1993 <tr> 1994 <td width="3%"><br></td> 1995 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 1996 <img SRC="images/right_triangle_option.png" 1997 ALT=">" BORDER=0 height=14 1998 width=15><b><font face="Helvetica, Arial" 1999 ><font color="#00B04F"><font size="+1"> 2000 <a name="details-dispose"></a>-dispose <i><method></i> 2001 </font></font></font></b></td></tr></table> 2002 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table> 2003 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2004 The Disposal Method indicates the way in which the graphic is to 2005 be treated after being displayed.</font></td></tr></table> 2006 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2007 Here are the valid methods:</font></td></tr></table> 2008 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2009 Undefined No disposal specified. 2010 None Do not dispose between frames. 2011 Background Overwrite the image area with 2012 the background color. 2013 Previous Overwrite the image area with 2014 what was there prior to rendering 2015 the image. 2016 </pre></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-dissolve"></a>-dissolve <i><percent></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>dissolve an image into another by the given percent</td></tr></table> 2028 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2029 The opacity of the composite image is multiplied by the given percent, 2030 then it is composited over the main image.</font></td></tr></table> 2031 <table BORDER=0 WIDTH="94%"> 2032 <tr> 2033 <td width="3%"><br></td> 2034 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2035 <img SRC="images/right_triangle_option.png" 2036 ALT=">" BORDER=0 height=14 2037 width=15><b><font face="Helvetica, Arial" 2038 ><font color="#00B04F"><font size="+1"> 2039 <a name="details-dither"></a>-dither 2040 </font></font></font></b></td></tr></table> 2041 <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> 2042 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2043 The basic strategy of dithering is to trade intensity resolution for spatial 2044 resolution by averaging the intensities of several neighboring pixels. 2045 Images which suffer from severe contouring when reducing colors can be 2046 improved with this option.</font></td></tr></table> 2047 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2048 The <strong>-colors</strong> or <strong>-monochrome</strong> option is required for this option 2049 to take effect.</font></td></tr></table> 2050 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2051 Use <strong>+dither</strong> to turn off dithering and to render PostScript 2052 without text or graphic aliasing. Disabling dithering often (but not 2053 always) leads to decreased processing time.</font></td></tr></table> 2054 <table BORDER=0 WIDTH="94%"> 2055 <tr> 2056 <td width="3%"><br></td> 2057 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2058 <img SRC="images/right_triangle_option.png" 2059 ALT=">" BORDER=0 height=14 2060 width=15><b><font face="Helvetica, Arial" 2061 ><font color="#00B04F"><font size="+1"> 2062 <a name="details-draw"></a>-draw <i><string></i> 2063 </font></font></font></b></td></tr></table> 2064 <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> 2065 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2066 Use this option to annotate an image with one or more graphic primitives. 2067 The primitives include shapes, text, transformations, 2068 and pixel operations. The shape primitives are</font></td></tr></table> 2069 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2070 point x,y 2071 line x0,y0 x1,y1 2072 rectangle x0,y0 x1,y1 2073 roundRectangle x0,y0 x1,y1 wc,hc 2074 arc x0,y0 x1,y1 a0,a1 2075 ellipse x0,y0 rx,ry a0,a1 2076 circle x0,y0 x1,y1 2077 polyline x0,y0 ... xn,yn 2078 polygon x0,y0 ... xn,yn 2079 Bezier x0,y0 ... xn,yn 2080 path path specification 2081 image operator x0,y0 w,h filename 2082 </pre></font></td></tr></table> 2083 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2084 The text primitive is</font></td></tr></table> 2085 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2086 text x0,y0 string 2087 </pre></font></td></tr></table> 2088 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2089 The text gravity primitive is</font></td></tr></table> 2090 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2091 gravity NorthWest, North, NorthEast, West, Center, 2092 East, SouthWest, South, or SouthEast 2093 </pre></font></td></tr></table> 2094 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2095 The text gravity primitive only affects the placement of text and 2096 does not interact with the other primitives. It is equivalent to 2097 using the <strong>-gravity</strong> commandline option, except that it is 2098 limited in scope to the <strong>-draw</strong> option in which it appears.</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 The transformation primitives are</font></td></tr></table> 2101 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2102 rotate degrees 2103 translate dx,dy 2104 scale sx,sy 2105 skewX degrees 2106 skewY degrees 2107 </pre></font></td></tr></table> 2108 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2109 The pixel operation primitives are</font></td></tr></table> 2110 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2111 color x0,y0 method 2112 matte x0,y0 method 2113 </pre></font></td></tr></table> 2114 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2115 The shape primitives are drawn in the color specified in the preceding 2116 <strong>-stroke</strong> option. Except for the <strong>line</strong> and <strong>point</strong> 2117 primitives, they are filled with the color specified in the preceding 2118 <strong>-fill</strong> option. For unfilled shapes, use <tt>-fill none</tt></font></td></tr></table>. 2119 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2120 <strong>Point</strong> requires a single coordinate.</font></td></tr></table> 2121 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2122 <strong>Line</strong> requires a start and end coordinate.</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 <strong>Rectangle</strong> 2125 expects an upper left and lower right coordinate.</font></td></tr></table> 2126 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2127 <strong>RoundRectangle</strong> has the upper left and lower right coordinates 2128 and the width and height of the corners.</font></td></tr></table> 2129 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2130 <strong>Circle</strong> has a center coordinate and a coordinate for 2131 the outer edge.</font></td></tr></table> 2132 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2133 Use <strong>Arc</strong> to inscribe an elliptical arc within 2134 a rectangle. Arcs require a start and end point as well as the degree 2135 of rotation (e.g. 130,30 200,100 45,90).</font></td></tr></table> 2136 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2137 Use <strong>Ellipse</strong> to draw a partial ellipse 2138 centered at the given point with the x-axis and y-axis radius 2139 and start and end of arc in degrees (e.g. 100,100 100,150 0,360).</font></td></tr></table> 2140 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2141 Finally, <strong>polyline</strong> and <strong>polygon</strong> require 2142 three or more coordinates to define its boundaries. 2143 Coordinates are integers separated by an optional comma. For example, 2144 to define a circle centered at 100,100 2145 that extends to 150,150 use:</font></td></tr></table> 2146 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2147 -draw 'circle 100,100 150,150' 2148 </pre></font></td></tr></table> 2149 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2150 <strong>Paths</strong> 2151 (See <a href="http://www.w3.org/TR/SVG/paths.html">Paths</a>) 2152 represent an outline of an object which is defined in terms of 2153 moveto (set a new current point), lineto (draw a straight line), 2154 curveto (draw a curve using a cubic Bezier), arc (elliptical or 2155 circular arc) and closepath (close the current shape by drawing a line 2156 to the last moveto) elements. Compound paths (i.e., a path with 2157 subpaths, each consisting of a single moveto followed by one or more 2158 line or curve operations) are possible to allow effects such as 2159 "donut holes" in objects.</font></td></tr></table> 2160 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2161 Use <strong>image</strong> to composite an image with another image. Follow the 2162 image keyword with the composite operator, image location, image size, 2163 and filename:</font></td></tr></table> 2164 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2165 -draw 'image Over 100,100 225,225 image.jpg' 2166 </pre></font></td></tr></table> 2167 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2168 You can use 0,0 for the image size, which means to use the actual 2169 dimensions found in the image header. Otherwise, it will 2170 be scaled to the given dimensions. 2171 See <strong>-compose</strong> for a description of the composite operators.</font></td></tr></table> 2172 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2173 Use <strong>text</strong> to annotate an image with text. Follow the text 2174 coordinates with a string. If the string has embedded spaces, enclose it 2175 in single or double quotes. Optionally you can include the image 2176 filename, type, width, height, or other image attribute by embedding 2177 special format character. See <strong>-comment</strong> for details.</font></td></tr></table> 2178 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2179 For example, 2180 </font></td></tr></table> 2181 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2182 -draw 'text 100,100 "%m:%f %wx%h"' 2183 </pre></font></td></tr></table> 2184 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2185 annotates the image with <tt>MIFF:bird.miff 512x480</tt> for an image titled 2186 <tt>bird.miff</tt> 2187 and whose width is 512 and height is 480.</font></td></tr></table> 2188 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2189 If the first character of <em>string</em> is <em>@</em>, the text is read 2190 from a file titled by the remaining characters in the string. Please 2191 note that if the string comes from an untrusted source that it should 2192 be sanitized before use (a security risk).</font></td></tr></table> 2193 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2194 <strong>Rotate</strong> rotates subsequent shape primitives and text primitives about 2195 the origin of the main image. If the <strong>-region</strong> option precedes the 2196 <strong>-draw</strong> option, the origin for transformations is the upper left 2197 corner of the region.</font></td></tr></table> 2198 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2199 <strong>Translate</strong> translates them.</font></td></tr></table> 2200 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2201 <strong>Scale</strong> scales them.</font></td></tr></table> 2202 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2203 <strong>SkewX</strong> and <strong>SkewY</strong> skew them with respect to the origin of 2204 the main image or the region.</font></td></tr></table> 2205 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2206 The transformations modify the current affine matrix, which is initialized 2207 from the initial affine matrix defined by the <strong>-affine</strong> option. 2208 Transformations are cumulative within the <strong>-draw</strong> option. 2209 The initial affine matrix is not affected; that matrix is only changed by the 2210 appearance of another <strong>-affine</strong> option. If another <strong>-draw</strong> 2211 option appears, the current affine matrix is reinitialized from 2212 the initial affine matrix.</font></td></tr></table> 2213 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2214 Use <strong>color</strong> to change the color of a pixel to the fill color (see 2215 <strong>-fill</strong>). Follow the pixel coordinate 2216 with a method:</font></td></tr></table> 2217 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2218 point 2219 replace 2220 floodfill 2221 filltoborder 2222 reset 2223 </pre></font></td></tr></table> 2224 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2225 Consider the target pixel as that specified by your coordinate. The 2226 <strong>point</strong> 2227 method recolors the target pixel. The <strong>replace</strong> method recolors any 2228 pixel that matches the color of the target pixel. 2229 <strong>Floodfill</strong> recolors 2230 any pixel that matches the color of the target pixel and is a neighbor, 2231 whereas <strong>filltoborder</strong> recolors any neighbor pixel that is not the 2232 border color. Finally, <strong>reset</strong> recolors all pixels.</font></td></tr></table> 2233 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2234 Use <strong>matte</strong> to the change the pixel matte value to transparent. Follow 2235 the pixel coordinate with a method (see the <strong>color</strong> primitive for 2236 a description of methods). The <strong>point</strong> method changes the matte value 2237 of the target pixel. The <strong>replace</strong> method changes the matte value 2238 of any pixel that matches the color of the target pixel. <strong>Floodfill</strong> 2239 changes the matte value of any pixel that matches the color of the target 2240 pixel and is a neighbor, whereas 2241 <strong>filltoborder</strong> changes the matte 2242 value of any neighbor pixel that is not the border color (<strong>-bordercolor</strong>). 2243 Finally <strong>reset</strong> changes the matte value of all pixels.</font></td></tr></table> 2244 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2245 You can set the primitive color, font, and font bounding box 2246 color with 2247 <strong>-fill</strong>, <strong>-font</strong>, and <strong>-box</strong> respectively. Options 2248 are processed in command line order so be sure to use these 2249 options <em>before</em> the <strong>-draw</strong> option.</font></td></tr></table> 2250 <table BORDER=0 WIDTH="94%"> 2251 <tr> 2252 <td width="3%"><br></td> 2253 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2254 <img SRC="images/right_triangle_option.png" 2255 ALT=">" BORDER=0 height=14 2256 width=15><b><font face="Helvetica, Arial" 2257 ><font color="#00B04F"><font size="+1"> 2258 -edge <i><radius></i> 2259 </font></font></font></b></td></tr></table> 2260 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>detect edges within an image</td></tr></table> 2261 <table BORDER=0 WIDTH="94%"> 2262 <tr> 2263 <td width="3%"><br></td> 2264 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2265 <img SRC="images/right_triangle_option.png" 2266 ALT=">" BORDER=0 height=14 2267 width=15><b><font face="Helvetica, Arial" 2268 ><font color="#00B04F"><font size="+1"> 2269 -emboss <i><radius></i> 2270 </font></font></font></b></td></tr></table> 2271 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>emboss an image</td></tr></table> 2272 <table BORDER=0 WIDTH="94%"> 2273 <tr> 2274 <td width="3%"><br></td> 2275 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2276 <img SRC="images/right_triangle_option.png" 2277 ALT=">" BORDER=0 height=14 2278 width=15><b><font face="Helvetica, Arial" 2279 ><font color="#00B04F"><font size="+1"> 2280 <a name="details-encoding"></a>-encoding <i><type></i> 2281 </font></font></font></b></td></tr></table> 2282 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the text encoding</td></tr></table> 2283 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2284 Choose from <em>AdobeCustom, AdobeExpert, AdobeStandard, AppleRoman, 2285 BIG5, GB2312, Latin 2, None, SJIScode, Symbol, Unicode, Wansung.</em></font></td></tr></table> 2286 <table BORDER=0 WIDTH="94%"> 2287 <tr> 2288 <td width="3%"><br></td> 2289 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2290 <img SRC="images/right_triangle_option.png" 2291 ALT=">" BORDER=0 height=14 2292 width=15><b><font face="Helvetica, Arial" 2293 ><font color="#00B04F"><font size="+1"> 2294 <a name="details-endian"></a>-endian <i><type></i> 2295 </font></font></font></b></td></tr></table> 2296 <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> 2297 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2298 <em>MSB</em> indicates big-endian (e.g. SPARC, Motorola 68K) while 2299 <em>LSB</em> indicates little-endian (e.g. Intel 'x86, VAX) byte 2300 ordering. <em>Native</em> indicates to use the normal ordering for the 2301 current CPU. This option currently only influences the CMYK, DPX, 2302 GRAY, RGB, and TIFF, formats.</font></td></tr></table> 2303 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2304 Use <strong>+endian</strong> to revert to unspecified endianness.</font></td></tr></table> 2305 <table BORDER=0 WIDTH="94%"> 2306 <tr> 2307 <td width="3%"><br></td> 2308 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2309 <img SRC="images/right_triangle_option.png" 2310 ALT=">" BORDER=0 height=14 2311 width=15><b><font face="Helvetica, Arial" 2312 ><font color="#00B04F"><font size="+1"> 2313 -enhance 2314 </font></font></font></b></td></tr></table> 2315 <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> 2316 <table BORDER=0 WIDTH="94%"> 2317 <tr> 2318 <td width="3%"><br></td> 2319 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2320 <img SRC="images/right_triangle_option.png" 2321 ALT=">" BORDER=0 height=14 2322 width=15><b><font face="Helvetica, Arial" 2323 ><font color="#00B04F"><font size="+1"> 2324 -equalize 2325 </font></font></font></b></td></tr></table> 2326 <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> 2327 <table BORDER=0 WIDTH="94%"> 2328 <tr> 2329 <td width="3%"><br></td> 2330 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2331 <img SRC="images/right_triangle_option.png" 2332 ALT=">" BORDER=0 height=14 2333 width=15><b><font face="Helvetica, Arial" 2334 ><font color="#00B04F"><font size="+1"> 2335 <a name="details-extent"></a>-extent <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i> 2336 </font></font></font></b></td></tr></table> 2337 <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> 2338 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2339 This option composites the image on a new background color 2340 (<strong>-background</strong>) canvas image of size <width>x<height>. The 2341 existing image content is composited at the position specified by 2342 geometry x and y offset and/or desired gravity (<strong>-gravity</strong>) using 2343 the current image compose (<strong>-compose</strong>) method. Image content 2344 which falls outside the bounds of the new image dimensions is 2345 discarded.</font></td></tr></table> 2346 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2347 For example, this command creates a thumbnail of an image, and centers 2348 it on a red color backdrop image, offsetting the canvas ten pixels to 2349 the left and five pixels up, with respect to the thumbnail:</font></td></tr></table> 2350 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2351 gm convert infile.jpg -thumbnail 120x80 -background red -gravity center \ 2352 -extent 140x100-10-5 outfile.jpg 2353 </pre></font></td></tr></table> 2354 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2355 This command reduces or expands a JPEG image to fit on an 800x600 2356 display: </font></td></tr></table> 2357 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2358 gm convert -size 800x600 input.jpg \ 2359 -resize 800x600 -background black \ 2360 -compose Copy -gravity center \ 2361 -extent 800x600 \ 2362 -quality 92 output.jpg 2363 </pre></font></td></tr></table> 2364 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2365 If the aspect ratio of the input image isn't exactly 4:3, then the 2366 image is centered on an 800x600 black canvas. </font></td></tr></table> 2367 <table BORDER=0 WIDTH="94%"> 2368 <tr> 2369 <td width="3%"><br></td> 2370 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2371 <img SRC="images/right_triangle_option.png" 2372 ALT=">" BORDER=0 height=14 2373 width=15><b><font face="Helvetica, Arial" 2374 ><font color="#00B04F"><font size="+1"> 2375 <a name="details-file"></a>-file <i><filename></i> 2376 </font></font></font></b></td></tr></table> 2377 <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> 2378 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2379 If <strong>-file</strong> is specified, then an annotated difference image is 2380 generated and written to the specified file. Pixels which differ between 2381 the <strong>reference</strong> and <strong>compare</strong> images are modified from those in 2382 the <strong>compare</strong> image so that the changed pixels become more obvious. 2383 Some images may require use of an alternative highlight style (see 2384 <strong>-highlight-style</strong>) or highlight color (see <strong>-highlight-color</strong>) 2385 before the changes are obvious.</font></td></tr></table> 2386 <table BORDER=0 WIDTH="94%"> 2387 <tr> 2388 <td width="3%"><br></td> 2389 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2390 <img SRC="images/right_triangle_option.png" 2391 ALT=">" BORDER=0 height=14 2392 width=15><b><font face="Helvetica, Arial" 2393 ><font color="#00B04F"><font size="+1"> 2394 <a name="details-fill"></a>-fill <i><color></i> 2395 </font></font></font></b></td></tr></table> 2396 <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> 2397 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2398 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> 2399 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2400 name (named color) 2401 #RGB (hex numbers, 4 bits each) 2402 #RRGGBB (8 bits each) 2403 #RRRGGGBBB (12 bits each) 2404 #RRRRGGGGBBBB (16 bits each) 2405 #RGBA (4 bits each) 2406 #RRGGBBAA (8 bits each) 2407 #RRRGGGBBBAAA (12 bits each) 2408 #RRRRGGGGBBBBAAAA (16 bits each) 2409 rgb(r,g,b) (r,g,b are decimal numbers) 2410 rgba(r,g,b,a) (r,g,b,a are decimal numbers) 2411 </pre></font></td></tr></table> 2412 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2413 Enclose the color specification in quotation marks to prevent the "#" 2414 or the parentheses from being interpreted by your shell.</font></td></tr></table> 2415 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2416 For example,</font></td></tr></table> 2417 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2418 gm convert -fill blue ... 2419 gm convert -fill "#ddddff" ... 2420 gm convert -fill "rgb(65000,65000,65535)" ... 2421 </pre></font></td></tr></table> 2422 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2423 The shorter forms are scaled up, if necessary by replication. For example, 2424 #3af, #33aaff, and #3333aaaaffff are all equivalent.</font></td></tr></table> 2425 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2426 See <strong>-draw</strong> for further details.</font></td></tr></table> 2427 <table BORDER=0 WIDTH="94%"> 2428 <tr> 2429 <td width="3%"><br></td> 2430 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2431 <img SRC="images/right_triangle_option.png" 2432 ALT=">" BORDER=0 height=14 2433 width=15><b><font face="Helvetica, Arial" 2434 ><font color="#00B04F"><font size="+1"> 2435 <a name="details-filter"></a>-filter <i><type></i> 2436 </font></font></font></b></td></tr></table> 2437 <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> 2438 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2439 Use this option to affect the resizing operation of an image (see 2440 <strong>-geometry</strong>). 2441 Choose from these filters (ordered by approximate increasing CPU 2442 time):</font></td></tr></table> 2443 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2444 Point 2445 Box 2446 Triangle 2447 Hermite 2448 Hanning 2449 Hamming 2450 Blackman 2451 Gaussian 2452 Quadratic 2453 Cubic 2454 Catrom 2455 Mitchell 2456 Lanczos 2457 Bessel 2458 Sinc 2459 </pre></font></td></tr></table> 2460 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2461 The default filter is automatically selected to provide the best quality 2462 while consuming a reasonable amount of time. The <strong>Mitchell</strong> filter 2463 is used if the image supports a palette, supports a matte channel, or is 2464 being enlarged, otherwise the <strong>Lanczos</strong> filter is used.</font></td></tr></table> 2465 <table BORDER=0 WIDTH="94%"> 2466 <tr> 2467 <td width="3%"><br></td> 2468 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2469 <img SRC="images/right_triangle_option.png" 2470 ALT=">" BORDER=0 height=14 2471 width=15><b><font face="Helvetica, Arial" 2472 ><font color="#00B04F"><font size="+1"> 2473 <a name="details-flatten"></a>-flatten 2474 </font></font></font></b></td></tr></table> 2475 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>flatten a sequence of images</td></tr></table> 2476 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2477 In some file formats (e.g. Photoshop's PSD) complex images may be 2478 represented by "layers" (independent images) which must be composited 2479 in order to obtain the final rendition. The <strong>-flatten</strong> option 2480 accomplishes this composition. The sequence of images is replaced by 2481 a single image created by compositing each image in turn, while 2482 respecting composition operators and page offsets. While 2483 <strong>-flatten</strong> is immediately useful for eliminating layers, it is 2484 also useful as a general-purpose composition tool.</font></td></tr></table> 2485 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2486 The sequence of images is terminated by the appearance of any option. 2487 If the <strong>-flatten</strong> option appears after all of the input images, 2488 all images are flattened. Also see <strong>-mosaic</strong> which is similar to 2489 <strong>-flatten</strong> except that it adds a suitably-sized canvas base 2490 image.</font></td></tr></table> 2491 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2492 For example, this composites an image on top of a 640x400 transparent 2493 black canvas image:</font></td></tr></table> 2494 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2495 gm convert -size 640x300 xc:transparent \ 2496 -compose over -page +0-100 \ 2497 frame.png -flatten output.png 2498 </pre></font></td></tr></table> 2499 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2500 and this flattens a Photoshop PSD file:</font></td></tr></table> 2501 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2502 gm convert input.psd -flatten output.png 2503 </pre></font></td></tr></table> 2504 <table BORDER=0 WIDTH="94%"> 2505 <tr> 2506 <td width="3%"><br></td> 2507 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2508 <img SRC="images/right_triangle_option.png" 2509 ALT=">" BORDER=0 height=14 2510 width=15><b><font face="Helvetica, Arial" 2511 ><font color="#00B04F"><font size="+1"> 2512 <a name="details-flip"></a>-flip 2513 </font></font></font></b></td></tr></table> 2514 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table> 2515 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2516 reflect the scanlines in the vertical direction.</font></td></tr></table> 2517 <table BORDER=0 WIDTH="94%"> 2518 <tr> 2519 <td width="3%"><br></td> 2520 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2521 <img SRC="images/right_triangle_option.png" 2522 ALT=">" BORDER=0 height=14 2523 width=15><b><font face="Helvetica, Arial" 2524 ><font color="#00B04F"><font size="+1"> 2525 <a name="details-flop"></a>-flop 2526 </font></font></font></b></td></tr></table> 2527 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table> 2528 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2529 reflect the scanlines in the horizontal direction.</font></td></tr></table> 2530 <table BORDER=0 WIDTH="94%"> 2531 <tr> 2532 <td width="3%"><br></td> 2533 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2534 <img SRC="images/right_triangle_option.png" 2535 ALT=">" BORDER=0 height=14 2536 width=15><b><font face="Helvetica, Arial" 2537 ><font color="#00B04F"><font size="+1"> 2538 <a name="details-font"></a>-font <i><name></i> 2539 </font></font></font></b></td></tr></table> 2540 <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> 2541 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2542 You can tag a font to specify whether it is a PostScript, TrueType, or X11 2543 font. For example, <tt>Arial.ttf</tt> is a TrueType font, <tt>ps:helvetica</tt> 2544 is PostScript, and <tt>x:fixed</tt> is X11.</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-foreground"></a>-foreground <i><color></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>define the foreground color</td></tr></table> 2556 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2557 The color is specified using the format described under the <strong>-fill</strong> 2558 option.</font></td></tr></table> 2559 <table BORDER=0 WIDTH="94%"> 2560 <tr> 2561 <td width="3%"><br></td> 2562 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2563 <img SRC="images/right_triangle_option.png" 2564 ALT=">" BORDER=0 height=14 2565 width=15><b><font face="Helvetica, Arial" 2566 ><font color="#00B04F"><font size="+1"> 2567 <a name="details-format"></a>-format <i><type></i> 2568 </font></font></font></b></td></tr></table> 2569 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image format type</td></tr></table> 2570 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2571 When used with the <strong>mogrify</strong> utility, 2572 this option will convert any image to the image format you specify. 2573 See <em>GraphicsMagick(1)</em> for a list of image format types supported by 2574 <strong>GraphicsMagick</strong>, or see the output of 'gm -list format'.</font></td></tr></table> 2575 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2576 By default the file is written to its original name. However, if the 2577 filename extension matches a supported format, the extension is replaced 2578 with the image format type specified with <strong>-format</strong>. For example, 2579 if you specify <em>tiff</em> as the format type and the input image 2580 filename is <em>image.gif</em>, the output image filename becomes 2581 <em>image.tiff</em>.</font></td></tr></table> 2582 <table BORDER=0 WIDTH="94%"> 2583 <tr> 2584 <td width="3%"><br></td> 2585 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2586 <img SRC="images/right_triangle_option.png" 2587 ALT=">" BORDER=0 height=14 2588 width=15><b><font face="Helvetica, Arial" 2589 ><font color="#00B04F"><font size="+1"> 2590 <a name="details-format"></a>-format <i><string></i> 2591 </font></font></font></b></td></tr></table> 2592 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>output formatted image characteristics</td></tr></table> 2593 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2594 When used with the <strong>identify</strong> utility, or the <strong>convert</strong> 2595 utility with output written to the 'info:-' file specification, use 2596 this option to print information about the image in a format of your 2597 choosing. You can include the image filename, type, width, height, 2598 Exif data, or other image attributes by embedding special format 2599 characters:</font></td></tr></table> 2600 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2601 %b file size 2602 %c comment 2603 %d directory 2604 %e filename extension 2605 %f filename 2606 %g page dimensions and offsets 2607 %h height 2608 %i input filename 2609 %k number of unique colors 2610 %l label 2611 %m magick 2612 %n number of scenes 2613 %o output filename 2614 %p page number 2615 %q image bit depth 2616 %r image type description 2617 %s scene number 2618 %t top of filename 2619 %u unique temporary filename 2620 %w width 2621 %x horizontal resolution 2622 %y vertical resolution 2623 %A transparency supported 2624 %C compression type 2625 %D GIF disposal method 2626 %G Original width and height 2627 %H page height 2628 %M original filename specification 2629 %O page offset (x,y) 2630 %P page dimensions (width,height) 2631 %Q compression quality 2632 %T time delay (in centi-seconds) 2633 %U resolution units 2634 %W page width 2635 %X page horizontal offset (x) 2636 %Y page vertical offset (y) 2637 %@ trim bounding box 2638 %# signature 2639 \n newline 2640 \r carriage return 2641 %% % 2642 </pre></font></td></tr></table> 2643 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2644 For example,</font></td></tr></table> 2645 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2646 -format "%m:%f %wx%h" 2647 </pre></font></td></tr></table> 2648 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2649 displays <strong>MIFF:bird.miff 512x480</strong> for an image 2650 titled <strong>bird.miff</strong> and whose width is 512 and height is 480.</font></td></tr></table> 2651 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2652 If the first character of <em>string</em> is <strong>@</strong>, the format is 2653 read from a file titled by the remaining characters in the string. 2654 Please note that if the string comes from an untrusted source that it 2655 should be sanitized before use since this may be used to incorporate 2656 any readable file on the system (a security risk).</font></td></tr></table> 2657 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2658 The values of image type (<strong>%r</strong>) which may be returned include:</font></td></tr></table> 2659 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2660 Bilevel 2661 Grayscale 2662 GrayscaleMatte 2663 Palette 2664 PaletteMatte 2665 TrueColor 2666 TrueColorMatte 2667 ColorSeparation 2668 ColorSeparationMatte 2669 Optimize 2670 </pre></font></td></tr></table> 2671 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2672 You can also use the following special formatting syntax to print Exif 2673 information contained in the file:</font></td></tr></table> 2674 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2675 %[EXIF:<tag>] 2676 </pre></font></td></tr></table> 2677 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2678 Where "<tag>" may be one of the following:</font></td></tr></table> 2679 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2680 * (print all Exif tags, in keyword=data format) 2681 ! (print all Exif tags, in tag_number format) 2682 #hhhh (print data for Exif tag #hhhh) 2683 ImageWidth 2684 ImageLength 2685 BitsPerSample 2686 Compression 2687 PhotometricInterpretation 2688 FillOrder 2689 DocumentName 2690 ImageDescription 2691 Make 2692 Model 2693 StripOffsets 2694 Orientation 2695 SamplesPerPixel 2696 RowsPerStrip 2697 StripByteCounts 2698 XResolution 2699 YResolution 2700 PlanarConfiguration 2701 ResolutionUnit 2702 TransferFunction 2703 Software 2704 DateTime 2705 Artist 2706 WhitePoint 2707 PrimaryChromaticities 2708 TransferRange 2709 JPEGProc 2710 JPEGInterchangeFormat 2711 JPEGInterchangeFormatLength 2712 YCbCrCoefficients 2713 YCbCrSubSampling 2714 YCbCrPositioning 2715 ReferenceBlackWhite 2716 CFARepeatPatternDim 2717 CFAPattern 2718 BatteryLevel 2719 Copyright 2720 ExposureTime 2721 FNumber 2722 IPTC/NAA 2723 ExifOffset 2724 InterColorProfile 2725 ExposureProgram 2726 SpectralSensitivity 2727 GPSInfo 2728 ISOSpeedRatings 2729 OECF 2730 ExifVersion 2731 DateTimeOriginal 2732 DateTimeDigitized 2733 ComponentsConfiguration 2734 CompressedBitsPerPixel 2735 ShutterSpeedValue 2736 ApertureValue 2737 BrightnessValue 2738 ExposureBiasValue 2739 MaxApertureValue 2740 SubjectDistance 2741 MeteringMode 2742 LightSource 2743 Flash 2744 FocalLength 2745 MakerNote 2746 UserComment 2747 SubSecTime 2748 SubSecTimeOriginal 2749 SubSecTimeDigitized 2750 FlashPixVersion 2751 ColorSpace 2752 ExifImageWidth 2753 ExifImageLength 2754 InteroperabilityOffset 2755 FlashEnergy 2756 SpatialFrequencyResponse 2757 FocalPlaneXResolution 2758 FocalPlaneYResolution 2759 FocalPlaneResolutionUnit 2760 SubjectLocation 2761 ExposureIndex 2762 SensingMethod 2763 FileSource 2764 SceneType 2765 </pre></font></td></tr></table> 2766 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2767 JPEG specific information (from reading a JPEG file) may be obtained 2768 like this:</font></td></tr></table> 2769 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2770 %[JPEG-<tag>] 2771 </pre></font></td></tr></table> 2772 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2773 Where "<tag>" may be one of the following:</font></td></tr></table> 2774 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 2775 * (all JPEG-related tags, in 2776 keyword=data format) 2777 Quality IJG JPEG "quality" estimate 2778 Colorspace JPEG colorspace numeric ID 2779 Colorspace-Name JPEG colorspace name 2780 Sampling-factors JPEG sampling factors 2781 </pre></font></td></tr></table> 2782 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2783 Please note that JPEG has no notion of "quality" and that the quality 2784 metric used by, and estimated by the software is based on the quality 2785 metric established by IJG JPEG 6b. Other encoders (e.g. that used by 2786 Adobe Photoshop) use different encoding metrics.</font></td></tr></table> 2787 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2788 Surround the format specification with quotation marks to prevent your shell 2789 from misinterpreting any spaces and square brackets.</font></td></tr></table> 2790 <table BORDER=0 WIDTH="94%"> 2791 <tr> 2792 <td width="3%"><br></td> 2793 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2794 <img SRC="images/right_triangle_option.png" 2795 ALT=">" BORDER=0 height=14 2796 width=15><b><font face="Helvetica, Arial" 2797 ><font color="#00B04F"><font size="+1"> 2798 <a name="details-frame"></a>-frame <i><width>x<height>+<outer bevel width>+<inner bevel width></i> 2799 </font></font></font></b></td></tr></table> 2800 <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> 2801 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2802 See <strong>-geometry</strong> for details about the geometry 2803 specification. The <strong>-frame</strong> option is not affected by the 2804 <strong>-gravity</strong> option.</font></td></tr></table> 2805 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2806 The color of the border is specified with the <strong>-mattecolor</strong> 2807 command line option.</font></td></tr></table> 2808 <table BORDER=0 WIDTH="94%"> 2809 <tr> 2810 <td width="3%"><br></td> 2811 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2812 <img SRC="images/right_triangle_option.png" 2813 ALT=">" BORDER=0 height=14 2814 width=15><b><font face="Helvetica, Arial" 2815 ><font color="#00B04F"><font size="+1"> 2816 -frame 2817 </font></font></font></b></td></tr></table> 2818 <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> 2819 <table BORDER=0 WIDTH="94%"> 2820 <tr> 2821 <td width="3%"><br></td> 2822 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2823 <img SRC="images/right_triangle_option.png" 2824 ALT=">" BORDER=0 height=14 2825 width=15><b><font face="Helvetica, Arial" 2826 ><font color="#00B04F"><font size="+1"> 2827 <a name="details-fuzz"></a>-fuzz <i><distance></i>{<i>%</i>}<i></i> 2828 </font></font></font></b></td></tr></table> 2829 <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> 2830 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2831 A number of algorithms search for a target color. By default the color 2832 must be exact. Use this option to match colors that are close (in 2833 Euclidean distance) to the target color in RGB 3D space. For example, 2834 if you want to automatically trim the edges of an image with 2835 <strong>-trim</strong> but the image was scanned and the target background color 2836 may differ by a small amount. This option can account for these 2837 differences.</font></td></tr></table> 2838 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2839 The <em>distance</em> can be in absolute intensity units or, by appending 2840 <em>"%"</em>, as a percentage of the maximum possible intensity (255, 2841 65535, or 4294967295).</font></td></tr></table> 2842 <table BORDER=0 WIDTH="94%"> 2843 <tr> 2844 <td width="3%"><br></td> 2845 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2846 <img SRC="images/right_triangle_option.png" 2847 ALT=">" BORDER=0 height=14 2848 width=15><b><font face="Helvetica, Arial" 2849 ><font color="#00B04F"><font size="+1"> 2850 <a name="details-gamma"></a>-gamma <i><value></i> 2851 </font></font></font></b></td></tr></table> 2852 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>level of gamma correction</td></tr></table> 2853 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2854 The same color image displayed on two different workstations may look 2855 different due to differences in the display monitor. Use gamma 2856 correction to adjust for this color difference. Reasonable values extend 2857 from <strong>0.8</strong> to <strong>2.3</strong>. Gamma less than 1.0 darkens the image and 2858 gamma greater than 1.0 lightens it. Large adjustments to image gamma may 2859 result in the loss of some image information if the pixel quantum size 2860 is only eight bits (quantum range 0 to 255).</font></td></tr></table> 2861 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2862 You can apply separate gamma values to the red, green, and blue channels 2863 of the image with a gamma value list delimited with slashes 2864 (e.g., <strong>1.7</strong>/<strong>2.3</strong>/<strong>1.2</strong>).</font></td></tr></table> 2865 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2866 Use <strong>+gamma</strong> <em>value</em> 2867 to set the image gamma level without actually adjusting 2868 the image pixels. This option is useful if the image is of a known gamma 2869 but not set as an image attribute (e.g. PNG images).</font></td></tr></table> 2870 <table BORDER=0 WIDTH="94%"> 2871 <tr> 2872 <td width="3%"><br></td> 2873 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2874 <img SRC="images/right_triangle_option.png" 2875 ALT=">" BORDER=0 height=14 2876 width=15><b><font face="Helvetica, Arial" 2877 ><font color="#00B04F"><font size="+1"> 2878 <a name="details-gaussian"></a>-gaussian <i><radius></i>{<i>x<sigma></i>}<i></i> 2879 </font></font></font></b></td></tr></table> 2880 <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> 2881 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2882 Use the given radius and standard deviation (sigma).</font></td></tr></table> 2883 <table BORDER=0 WIDTH="94%"> 2884 <tr> 2885 <td width="3%"><br></td> 2886 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2887 <img SRC="images/right_triangle_option.png" 2888 ALT=">" BORDER=0 height=14 2889 width=15><b><font face="Helvetica, Arial" 2890 ><font color="#00B04F"><font size="+1"> 2891 <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> 2892 </font></font></font></b></td></tr></table> 2893 <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> 2894 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2895 The <strong>-geometry</strong> option is used for a number of different 2896 purposes, depending on the utility it is used with.</font></td></tr></table> 2897 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2898 For the X11 commands ('animate', 'display', and 'import'), it 2899 specifies the preferred size and location of the Image window. By 2900 default, the window size is the image size and the location is chosen 2901 by you (or your window manager) when it is mapped.</font></td></tr></table> 2902 <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 2903 used to specify the desired size when resizing an image. In this 2904 case, symbols representing resize options may be appended to the 2905 geometry string to influence how the resize request is treated.</font></td></tr></table> 2906 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2907 See later notes corresponding to usage by particular commands. The 2908 following notes apply to when <strong>-geometry</strong> is used to express a 2909 resize request, taking into account the current properties of the 2910 image.</font></td></tr></table> 2911 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2912 By default, the width and height are maximum values. That is, the 2913 image is expanded or contracted to fit the width and height value 2914 while maintaining the aspect ratio of the image.</font></td></tr></table> 2915 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2916 Append a ^ to the geometry so that the image aspect ratio is 2917 maintained when the image is resized, but the resulting width or 2918 height are treated as minimum values rather than maximum values.</font></td></tr></table> 2919 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2920 Append a ! (exclamation point) to the geometry to force the image size to 2921 exactly the size you specify. For example, if you specify 2922 <tt>640x480!</tt> the image width is set to 640 pixels and height to 2923 480.</font></td></tr></table> 2924 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2925 If only the width is specified, without the trailing 'x', then height 2926 is set to width (e.g., <tt>-geometry 100</tt> is the same as 2927 <tt>-geometry 100x100</tt>). If only the width is specified but with 2928 the trailing 'x', then width assumes the value and the height is 2929 chosen to maintain the aspect ratio of the image. Similarly, if only 2930 the height is specified prefixed by 'x' (e.g., <tt>-geometry 2931 x256</tt>), the width is chosen to maintain the aspect ratio.</font></td></tr></table> 2932 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2933 To specify a percentage width or height instead, append %. The image size 2934 is multiplied by the width and height percentages to obtain the final image 2935 dimensions. To increase the size of an image, use a value greater than 2936 100 (e.g. 125%). To decrease an image's size, use a percentage less than 2937 100.</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 Use <tt>@</tt> to specify the maximum area in pixels of an image.</font></td></tr></table> 2940 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2941 Use <tt>></tt> to change the dimensions of the image <em>only</em> if 2942 its width or height exceeds the geometry specification. <tt><</tt> resizes 2943 the image <em>only</em> if both of its dimensions are less than the geometry 2944 specification. For example, 2945 if you specify <tt>'640x480>'</tt> and the image size is 256x256, the image 2946 size does not change. However, if the image is 512x512 or 1024x1024, it is 2947 resized to 480x480. Enclose the geometry specification in quotation marks to 2948 prevent the <tt><</tt> or <tt>></tt> from being interpreted by your shell 2949 as a file redirection.</font></td></tr></table> 2950 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2951 When used with <em>animate</em> and <em>display</em>, offsets are handled in 2952 the same manner as in <em>X(1)</em> and the <strong>-gravity</strong> option is not used. 2953 If the <em>x</em> is negative, the offset is measured leftward 2954 from the right edge of the 2955 screen to the right edge of the image being displayed. 2956 Similarly, negative <em>y</em> is measured between the bottom edges. The 2957 offsets are not affected by "%"; they are always measured in pixels.</font></td></tr></table> 2958 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2959 When used as a <em>composite</em> option, <strong>-geometry</strong> 2960 gives the dimensions of the image and its location with respect 2961 to the composite image. If the <strong>-gravity</strong> option is present 2962 with <em>NorthEast, East,</em> or <em>SouthEast</em> gravity, the <em>x</em> 2963 represents the distance from the right edge of the image to the right edge of 2964 the composite image. Similarly, if the <strong>-gravity</strong> option is present 2965 with <em>SouthWest, South,</em> or <em>SouthEast</em> gravity, <em>y</em> 2966 is measured between the bottom edges. Accordingly, a positive offset will 2967 never point in the direction outside of the image. The 2968 offsets are not affected by "%"; they are always measured in pixels. 2969 To specify the dimensions of the composite image, use the <strong>-resize</strong> 2970 option.</font></td></tr></table> 2971 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2972 When used as a <em>convert</em>, <em>import</em> or <em>mogrify</em> option, 2973 <strong>-geometry</strong> is synonymous with <strong>-resize</strong> and 2974 specifies the size of the output image. The offsets, if present, are ignored.</font></td></tr></table> 2975 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2976 When used as a <em>montage</em> option, <strong>-geometry</strong> specifies the image 2977 size and border size for each tile; default is 256x256+0+0. Negative 2978 offsets (border dimensions) are meaningless. The <strong>-gravity</strong> 2979 option affects the placement of the image within the tile; the default 2980 gravity for this purpose is <em>Center</em>. If the "%" sign appears in 2981 the geometry specification, the tile size is the specified percentage of 2982 the original dimensions of the first tile. 2983 To specify the dimensions of the montage, use the <strong>-resize</strong> 2984 option.</font></td></tr></table> 2985 <table BORDER=0 WIDTH="94%"> 2986 <tr> 2987 <td width="3%"><br></td> 2988 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 2989 <img SRC="images/right_triangle_option.png" 2990 ALT=">" BORDER=0 height=14 2991 width=15><b><font face="Helvetica, Arial" 2992 ><font color="#00B04F"><font size="+1"> 2993 <a name="details-gravity"></a>-gravity <i><type></i> 2994 </font></font></font></b></td></tr></table> 2995 <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> 2996 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 2997 Choices are: NorthWest, North, 2998 NorthEast, West, Center, East, SouthWest, South, SouthEast.</font></td></tr></table> 2999 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3000 The direction you choose specifies where to position the text 3001 when annotating 3002 the image. For example <em>Center</em> gravity forces the text to be centered 3003 within the image. By default, the image gravity is <em>NorthWest</em>. 3004 See <strong>-draw</strong> for more details about graphic primitives. Only the 3005 text primitive is affected by the <strong>-gravity</strong> option.</font></td></tr></table> 3006 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3007 The <strong>-gravity</strong> option is also used in concert with the <strong>-geometry</strong> 3008 option and other options that take <strong><geometry></strong> as a parameter, such 3009 as the <strong>-crop</strong> option. See <strong>-geometry</strong> for details of how the 3010 <strong>-gravity</strong> option interacts with the 3011 <strong><x></strong> and <strong><y></strong> parameters of a geometry 3012 specification.</font></td></tr></table> 3013 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3014 When used as an option to <em>composite</em>, <strong>-gravity</strong> 3015 gives the direction that the image gravitates within the composite.</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 When used as an option to <em>montage</em>, <strong>-gravity</strong> gives the direction 3018 that an image gravitates within a tile. The default gravity is <em>Center</em> 3019 for this purpose.</font></td></tr></table> 3020 <table BORDER=0 WIDTH="94%"> 3021 <tr> 3022 <td width="3%"><br></td> 3023 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3024 <img SRC="images/right_triangle_option.png" 3025 ALT=">" BORDER=0 height=14 3026 width=15><b><font face="Helvetica, Arial" 3027 ><font color="#00B04F"><font size="+1"> 3028 <a name="details-green-primary"></a>-green-primary <i><x>,<y></i> 3029 </font></font></font></b></td></tr></table> 3030 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>green chromaticity primary point</td></tr></table> 3031 <table BORDER=0 WIDTH="94%"> 3032 <tr> 3033 <td width="3%"><br></td> 3034 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3035 <img SRC="images/right_triangle_option.png" 3036 ALT=">" BORDER=0 height=14 3037 width=15><b><font face="Helvetica, Arial" 3038 ><font color="#00B04F"><font size="+1"> 3039 -hald-clut <i><clut></i> 3040 </font></font></font></b></td></tr></table> 3041 <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> 3042 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3043 A Hald CLUT ("Color Look-Up Table") is a special square color image 3044 which contains a look-up table for red, green, and blue. The size of 3045 the Hald CLUT image is determined by its order. The width (and 3046 height) of a Hald CLUT is the cube of the order. For example, a Hald 3047 CLUT of order 8 is 512x512 pixels (262,144 colors) and of order 16 is 3048 4096x4096 (16,777,216 colors). A special CLUT is the identity CLUT 3049 which which causes no change to the input image. In order to use the 3050 Hald CLUT, one takes an identity CLUT and adjusts its colors in some 3051 way. The modified CLUT can then be used to transform any number of 3052 images in an identical way.</font></td></tr></table> 3053 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3054 GraphicsMagick contains a built-in identity CLUT generator via the 3055 <strong>IDENTITY</strong> coder. For example reading from the file name 3056 </strong>IDENTITY:8</strong> returns an identity CLUT of order 8. Typical Hald 3057 CLUT identity images have an order of between 8 and 16. The default 3058 order for the <strong>IDENTITY</strong> CLUT generator is 8. Interpolation is 3059 used so it is not usually necessary for CLUT images to be very large. 3060 The PNG file format is ideal for storing Hald CLUT images because it 3061 compresses them very well.</font></td></tr></table> 3062 <table BORDER=0 WIDTH="94%"> 3063 <tr> 3064 <td width="3%"><br></td> 3065 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3066 <img SRC="images/right_triangle_option.png" 3067 ALT=">" BORDER=0 height=14 3068 width=15><b><font face="Helvetica, Arial" 3069 ><font color="#00B04F"><font size="+1"> 3070 -help 3071 </font></font></font></b></td></tr></table> 3072 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table> 3073 <table BORDER=0 WIDTH="94%"> 3074 <tr> 3075 <td width="3%"><br></td> 3076 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3077 <img SRC="images/right_triangle_option.png" 3078 ALT=">" BORDER=0 height=14 3079 width=15><b><font face="Helvetica, Arial" 3080 ><font color="#00B04F"><font size="+1"> 3081 <a name="details-highlight-color"></a>-highlight-color <i><color></i> 3082 </font></font></font></b></td></tr></table> 3083 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pixel annotation color</td></tr></table> 3084 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3085 Specifies the color to use when annotating difference pixels.</font></td></tr></table> 3086 <table BORDER=0 WIDTH="94%"> 3087 <tr> 3088 <td width="3%"><br></td> 3089 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3090 <img SRC="images/right_triangle_option.png" 3091 ALT=">" BORDER=0 height=14 3092 width=15><b><font face="Helvetica, Arial" 3093 ><font color="#00B04F"><font size="+1"> 3094 <a name="details-highlight-style"></a>-highlight-style <i><style></i> 3095 </font></font></font></b></td></tr></table> 3096 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pixel annotation style</td></tr></table> 3097 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3098 Specifies the pixel difference annotation style used to draw attention to 3099 changed pixels. May be one of <strong>Assign</strong>, <strong>Threshold</strong>, 3100 <strong>Tint</strong>, or <strong>XOR</strong>; where <strong>Assign</strong> replaces the pixel with 3101 the highlight color (see <strong>-highlight-color</strong>), <strong>Threshold</strong> 3102 replaces the pixel with black or white based on the difference in 3103 intensity, <strong>Tint</strong> alpha tints the pixel with the highlight color, 3104 and <strong>XOR</strong> does an XOR between the pixel and the highlight color.</font></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 <a name="details-iconGeometry"></a>-iconGeometry <i><geometry></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>specify the icon geometry</td></tr></table> 3116 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3117 Offsets, if present in the geometry specification, are handled in 3118 the same manner as the <strong>-geometry</strong> option, using X11 style to handle 3119 negative offsets.</font></td></tr></table> 3120 <table BORDER=0 WIDTH="94%"> 3121 <tr> 3122 <td width="3%"><br></td> 3123 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3124 <img SRC="images/right_triangle_option.png" 3125 ALT=">" BORDER=0 height=14 3126 width=15><b><font face="Helvetica, Arial" 3127 ><font color="#00B04F"><font size="+1"> 3128 -iconic 3129 </font></font></font></b></td></tr></table> 3130 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>iconic animation</td></tr></table> 3131 <table BORDER=0 WIDTH="94%"> 3132 <tr> 3133 <td width="3%"><br></td> 3134 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3135 <img SRC="images/right_triangle_option.png" 3136 ALT=">" BORDER=0 height=14 3137 width=15><b><font face="Helvetica, Arial" 3138 ><font color="#00B04F"><font size="+1"> 3139 -immutable 3140 </font></font></font></b></td></tr></table> 3141 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make image immutable</td></tr></table> 3142 <table BORDER=0 WIDTH="94%"> 3143 <tr> 3144 <td width="3%"><br></td> 3145 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3146 <img SRC="images/right_triangle_option.png" 3147 ALT=">" BORDER=0 height=14 3148 width=15><b><font face="Helvetica, Arial" 3149 ><font color="#00B04F"><font size="+1"> 3150 -implode <i><factor></i> 3151 </font></font></font></b></td></tr></table> 3152 <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> 3153 <table BORDER=0 WIDTH="94%"> 3154 <tr> 3155 <td width="3%"><br></td> 3156 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3157 <img SRC="images/right_triangle_option.png" 3158 ALT=">" BORDER=0 height=14 3159 width=15><b><font face="Helvetica, Arial" 3160 ><font color="#00B04F"><font size="+1"> 3161 <a name="details-intent"></a>-intent <i><type></i> 3162 </font></font></font></b></td></tr></table> 3163 <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> 3164 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3165 Use this option to affect the the color management operation of an image (see 3166 <strong>-profile</strong>). 3167 Choose from these intents: 3168 <strong>Absolute, Perceptual, Relative, Saturation</strong>.</font></td></tr></table> 3169 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3170 The default intent is undefined.</font></td></tr></table> 3171 <table BORDER=0 WIDTH="94%"> 3172 <tr> 3173 <td width="3%"><br></td> 3174 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3175 <img SRC="images/right_triangle_option.png" 3176 ALT=">" BORDER=0 height=14 3177 width=15><b><font face="Helvetica, Arial" 3178 ><font color="#00B04F"><font size="+1"> 3179 <a name="details-interlace"></a>-interlace <i><type></i> 3180 </font></font></font></b></td></tr></table> 3181 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table> 3182 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3183 Choices are: <strong>None, Line, Plane,</strong> 3184 or <strong>Partition</strong>. The default is <strong>None</strong>.</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 This option is used to specify the type of interlacing scheme for raw image 3187 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"> 3188 <strong>None</strong> means do not interlace 3189 (RGBRGBRGBRGBRGBRGB...),</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 <strong>Line</strong> uses scanline interlacing 3192 (RRR...GGG...BBB...RRR...GGG...BBB...), 3193 and</font></td></tr></table><table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3194 <strong>Plane</strong> uses plane interlacing (RRRRRR...GGGGGG...BBBBBB...).</font></td></tr></table> 3195 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3196 <strong>Partition</strong> 3197 is like plane except the different planes are saved to individual files 3198 (e.g. image.R, image.G, and image.B).</font></td></tr></table> 3199 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3200 Use <strong>Line</strong> to create an <strong>interlaced PNG</strong> or <strong> GIF</strong> or 3201 <strong>progressive JPEG</strong> image.</font></td></tr></table> 3202 <table BORDER=0 WIDTH="94%"> 3203 <tr> 3204 <td width="3%"><br></td> 3205 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3206 <img SRC="images/right_triangle_option.png" 3207 ALT=">" BORDER=0 height=14 3208 width=15><b><font face="Helvetica, Arial" 3209 ><font color="#00B04F"><font size="+1"> 3210 <a name="details-label"></a>-label <i><name></i> 3211 </font></font></font></b></td></tr></table> 3212 <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> 3213 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3214 Use this option to assign a specific label to the image, when writing 3215 to an image format that supports labels, such as TIFF, PNG, MIFF, or 3216 PostScript. You can include the the image filename, type, width, height, 3217 or other image attribute by embedding special format character. A label 3218 is not drawn on the image, but is embedded in the image datastream via 3219 a "Label" tag or similar mechanism. If you want the 3220 label to be visible on the image itself, use the <strong>-draw</strong> option. 3221 See <strong>-comment</strong> for details.</font></td></tr></table> 3222 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3223 For example,</font></td></tr></table> 3224 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 3225 -label "%m:%f %wx%h" 3226 </pre></font></td></tr></table> 3227 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3228 produces an image label of <strong>MIFF:bird.miff 512x480</strong> for an image titled 3229 <strong>bird.miff</strong> 3230 and whose width is 512 and height is 480.</font></td></tr></table> 3231 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3232 If the first character of <em>string</em> is <em>@</em>, the image label 3233 is read from a file titled by the remaining characters in the string. 3234 Please note that if the string comes from an untrusted source that it 3235 should be sanitized before use since otherwise the content of an 3236 arbitrary readable file might be incorporated into the image 3237 label (a security risk).</font></td></tr></table> 3238 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3239 If the -label option appears multiple times, only the last label is 3240 stored.</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 In PNG images, the label is stored in a <strong>tEXt</strong> or <strong>zTXt</strong> chunk 3243 with the keyword "label".</font></td></tr></table> 3244 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3245 When converting to <em>PostScript</em>, use this option to specify a header 3246 string to print above the image. Specify the label font with 3247 <strong>-font</strong>.</font></td></tr></table> 3248 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3249 When creating a montage, by default the label associated with an image 3250 is displayed with the corresponding tile in the montage. Use the 3251 <strong>+label</strong> option to suppress this behavior.</font></td></tr></table> 3252 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3253 </font></td></tr></table> 3254 <table BORDER=0 WIDTH="94%"> 3255 <tr> 3256 <td width="3%"><br></td> 3257 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3258 <img SRC="images/right_triangle_option.png" 3259 ALT=">" BORDER=0 height=14 3260 width=15><b><font face="Helvetica, Arial" 3261 ><font color="#00B04F"><font size="+1"> 3262 <a name="details-lat"></a>-lat <i><width>x<height></i>{<i>+-</i>}<i><offset></i>{<i>%</i>}<i></i> 3263 </font></font></font></b></td></tr></table> 3264 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform local adaptive thresholding</td></tr></table> 3265 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3266 Perform local adaptive thresholding using the specified width, height, 3267 and offset. The offset is a distance in sample space from the mean, 3268 as an absolute integer ranging from 0 to the maximum sample value or 3269 as a percentage. If the percent option is supplied, then the offset 3270 is computed as a percentage of the quantum range. It is strongly 3271 recommended to use the percent option so that results are not 3272 sensitive to pixel quantum depth.</font></td></tr></table> 3273 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3274 For example,</font></td></tr></table> 3275 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 3276 -colorspace gray -lat "10x10-5%" 3277 </pre></font></td></tr></table> 3278 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3279 will help clarify a scanned grayscale or color document, producing a 3280 bi-level equivalent.</font></td></tr></table> 3281 <table BORDER=0 WIDTH="94%"> 3282 <tr> 3283 <td width="3%"><br></td> 3284 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3285 <img SRC="images/right_triangle_option.png" 3286 ALT=">" BORDER=0 height=14 3287 width=15><b><font face="Helvetica, Arial" 3288 ><font color="#00B04F"><font size="+1"> 3289 <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> 3290 </font></font></font></b></td></tr></table> 3291 <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> 3292 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3293 Give one, two or three values delimited with commas: black-point, gamma, 3294 white-point (e.g. 10,1.0,250 or 2%,0.5,98%). The black and white 3295 points range from 0 to MaxRGB or from 0 to 100%; if the white point is 3296 omitted it is set to MaxRGB-black_point. If a "%" sign is present 3297 anywhere in the string, the black and white points are percentages of 3298 MaxRGB. Gamma is an exponent that ranges from 0.1 to 10.; if it is 3299 omitted, the default of 1.0 (no gamma correction) is assumed. This 3300 interface works similar to Photoshop's "Image->Adjustments->Levels..." 3301 "Input Levels" interface.</font></td></tr></table> 3302 <table BORDER=0 WIDTH="94%"> 3303 <tr> 3304 <td width="3%"><br></td> 3305 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3306 <img SRC="images/right_triangle_option.png" 3307 ALT=">" BORDER=0 height=14 3308 width=15><b><font face="Helvetica, Arial" 3309 ><font color="#00B04F"><font size="+1"> 3310 <a name="details-limit"></a>-limit <i><type> <value></i> 3311 </font></font></font></b></td></tr></table> 3312 <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> 3313 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3314 By default, resource limits are estimated based on the available 3315 resources of the system. The resource limits are <strong>Disk</strong>, maximum 3316 total disk space consumed; <strong>File</strong>, maximum number of file 3317 descriptors allowed to be open at once; <strong>Map</strong>, maximum total 3318 number of file bytes which may be memory mapped; <strong>Memory</strong>, 3319 maximum total number of bytes of heap memory used for image storage; 3320 <strong>Pixels</strong>, maximum absolute image size (per image); <strong>Width</strong>, 3321 maximum image pixels width; <strong>Height</strong>, maximum image pixels 3322 height; and <strong>Threads</strong>, the maximum number of worker threads to 3323 use per OpenMP thread team.</font></td></tr></table> 3324 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3325 These resource limits are used to decide if (for a given image) the 3326 decoded image ("pixel cache") should be stored in heap memory (RAM), 3327 in a memory-mapped disk file, or in a disk file accessed via 3328 read/write I/O. The number of total pixels in one image, and/or the 3329 width/height, may also be limited in order to force the reading, or 3330 creation of images larger than the limit (in pixels) to intentionally 3331 fail. The disk limit establishes an overall limit since using the disk 3332 is the means of last resort. When the disk limit has been reached, no 3333 more images may be read.</font></td></tr></table> 3334 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3335 The value argument is an absolute value, but may have standard binary 3336 suffix characters applied ('K', 'M', 'G', 'T', 'P', 'E') to apply a 3337 scaling to the value (based on a multiplier of 1024). Any additional 3338 characters are ignored. For example, <tt>'-limit Pixels 10MP'</tt> limits 3339 the maximum image size to 10 megapixels and <tt>'-limit memory 32MB 3340 -limit map 64MB'</tt> limits memory and memory mapped files to 32 3341 megabytes and 64 megabytes respectively.</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 Resource limits may also be set using environment variables. The 3344 environment variables <strong>MAGICK_LIMIT_DISK</strong>, 3345 <strong>MAGICK_LIMIT_FILES</strong>, <strong>MAGICK_LIMIT_MAP</strong>, 3346 <strong>MAGICK_LIMIT_MEMORY</strong>, <strong>MAGICK_LIMIT_PIXELS</strong>, 3347 <strong>MAGICK_LIMIT_WIDTH</strong>, <strong>MAGICK_LIMIT_HEIGHT</strong>,and 3348 <strong>OMP_NUM_THREADS</strong> may be used to set the limits for disk space, 3349 open files, memory mapped size, heap memory, per-image pixels, image 3350 width, image height, and threads respectively.</font></td></tr></table> 3351 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3352 Use the option <tt>-list resource</tt> list the current limits.</font></td></tr></table> 3353 <table BORDER=0 WIDTH="94%"> 3354 <tr> 3355 <td width="3%"><br></td> 3356 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3357 <img SRC="images/right_triangle_option.png" 3358 ALT=">" BORDER=0 height=14 3359 width=15><b><font face="Helvetica, Arial" 3360 ><font color="#00B04F"><font size="+1"> 3361 -linewidth 3362 </font></font></font></b></td></tr></table> 3363 <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> 3364 <table BORDER=0 WIDTH="94%"> 3365 <tr> 3366 <td width="3%"><br></td> 3367 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3368 <img SRC="images/right_triangle_option.png" 3369 ALT=">" BORDER=0 height=14 3370 width=15><b><font face="Helvetica, Arial" 3371 ><font color="#00B04F"><font size="+1"> 3372 <a name="details-list"></a>-list <i><type></i> 3373 </font></font></font></b></td></tr></table> 3374 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of list</td></tr></table> 3375 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3376 Choices are: <strong>Color</strong>, <strong>Delegate</strong>, <strong>Format</strong>, <strong>Magic</strong>, 3377 <strong>Module</strong>, <strong>Resource</strong>, or <strong>Type</strong>. The <strong>Module</strong> option 3378 is only available if GraphicsMagick was built to support loadable modules.</font></td></tr></table> 3379 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3380 This option lists information about the GraphicsMagick configuration.</font></td></tr></table> 3381 <table BORDER=0 WIDTH="94%"> 3382 <tr> 3383 <td width="3%"><br></td> 3384 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3385 <img SRC="images/right_triangle_option.png" 3386 ALT=">" BORDER=0 height=14 3387 width=15><b><font face="Helvetica, Arial" 3388 ><font color="#00B04F"><font size="+1"> 3389 <a name="details-log"></a>-log <i><string></i> 3390 </font></font></font></b></td></tr></table> 3391 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table> 3392 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3393 This option specifies the format for the log printed when the <strong>-debug</strong> 3394 option is active.</font></td></tr></table> 3395 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3396 You can display the following components by embedding 3397 special format characters:</font></td></tr></table> 3398 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 3399 %d domain 3400 %e event 3401 %f function 3402 %l line 3403 %m module 3404 %p process ID 3405 %r real CPU time 3406 %t wall clock time 3407 %u user CPU time 3408 %% percent sign 3409 \n newline 3410 \r carriage return 3411 </pre></font></td></tr></table> 3412 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3413 For example:</font></td></tr></table> 3414 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 3415 gm convert -debug coders -log "%u %m:%l %e" in.gif out.png 3416 </pre></font></td></tr></table> 3417 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3418 The default behavior is to print all of the components.</font></td></tr></table> 3419 <table BORDER=0 WIDTH="94%"> 3420 <tr> 3421 <td width="3%"><br></td> 3422 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3423 <img SRC="images/right_triangle_option.png" 3424 ALT=">" BORDER=0 height=14 3425 width=15><b><font face="Helvetica, Arial" 3426 ><font color="#00B04F"><font size="+1"> 3427 <a name="details-loop"></a>-loop <i><iterations></i> 3428 </font></font></font></b></td></tr></table> 3429 <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> 3430 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3431 A value other than zero forces the animation to repeat itself up to 3432 <em>iterations</em> 3433 times.</font></td></tr></table> 3434 <table BORDER=0 WIDTH="94%"> 3435 <tr> 3436 <td width="3%"><br></td> 3437 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3438 <img SRC="images/right_triangle_option.png" 3439 ALT=">" BORDER=0 height=14 3440 width=15><b><font face="Helvetica, Arial" 3441 ><font color="#00B04F"><font size="+1"> 3442 -magnify 3443 </font></font></font></b></td></tr></table> 3444 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>magnify the image</td></tr></table> 3445 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3446 The image size is doubled using linear interpolation.</font></td></tr></table> 3447 <table BORDER=0 WIDTH="94%"> 3448 <tr> 3449 <td width="3%"><br></td> 3450 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3451 <img SRC="images/right_triangle_option.png" 3452 ALT=">" BORDER=0 height=14 3453 width=15><b><font face="Helvetica, Arial" 3454 ><font color="#00B04F"><font size="+1"> 3455 -magnify <i><factor></i> 3456 </font></font></font></b></td></tr></table> 3457 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>magnify the image</td></tr></table> 3458 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3459 The displayed image is magnified by <strong>factor</strong>.</font></td></tr></table> 3460 <table BORDER=0 WIDTH="94%"> 3461 <tr> 3462 <td width="3%"><br></td> 3463 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3464 <img SRC="images/right_triangle_option.png" 3465 ALT=">" BORDER=0 height=14 3466 width=15><b><font face="Helvetica, Arial" 3467 ><font color="#00B04F"><font size="+1"> 3468 <a name="details-map"></a>-map <i><filename></i> 3469 </font></font></font></b></td></tr></table> 3470 <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> 3471 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3472 [<em>convert</em> or <em>mogrify</em>]</font></td></tr></table> 3473 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3474 By default, color reduction chooses an optimal set of colors that best 3475 represent the original image. Alternatively, you can choose a particular 3476 set of colors from an image file with this option.</font></td></tr></table> 3477 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3478 Use 3479 <strong>+map</strong> to reduce 3480 all images in the image sequence that follows to a single optimal set of colors 3481 that best represent all the images. The sequence of images 3482 is terminated by the appearance of any option. 3483 If the <strong>+map</strong> 3484 option appears after all of the input images, all images are mapped.</font></td></tr></table> 3485 <table BORDER=0 WIDTH="94%"> 3486 <tr> 3487 <td width="3%"><br></td> 3488 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3489 <img SRC="images/right_triangle_option.png" 3490 ALT=">" BORDER=0 height=14 3491 width=15><b><font face="Helvetica, Arial" 3492 ><font color="#00B04F"><font size="+1"> 3493 <a name="details-map"></a>-map <i><type></i> 3494 </font></font></font></b></td></tr></table> 3495 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display image using this type.</td></tr></table> 3496 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3497 [<em>animate</em> or <em>display</em>]</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 Choose from these <em>Standard Colormap</em> types:</font></td></tr></table> 3500 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 3501 best 3502 default 3503 gray 3504 red 3505 green 3506 blue 3507 </pre></font></td></tr></table> 3508 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3509 The <em>X server</em> must support the <em>Standard Colormap</em> you choose, 3510 otherwise an error occurs. Use <strong>list</strong> as the type and <strong>display</strong> 3511 searches the list of colormap types in <strong>top-to-bottom</strong> order until 3512 one is located. See <em>xstdcmap(1)</em> for one way of creating Standard 3513 Colormaps.</font></td></tr></table> 3514 <table BORDER=0 WIDTH="94%"> 3515 <tr> 3516 <td width="3%"><br></td> 3517 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3518 <img SRC="images/right_triangle_option.png" 3519 ALT=">" BORDER=0 height=14 3520 width=15><b><font face="Helvetica, Arial" 3521 ><font color="#00B04F"><font size="+1"> 3522 <a name="details-mask"></a>-mask <i><filename></i> 3523 </font></font></font></b></td></tr></table> 3524 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify a clipping mask</td></tr></table> 3525 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3526 The image read from the file is used as a clipping mask. It must have 3527 the same dimensions as the image being masked.</font></td></tr></table> 3528 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3529 If the mask image contains an opacity channel, the opacity of each 3530 pixel is used to define the mask. Otherwise, the intensity (gray 3531 level) of each pixel is used. Unmasked (black) pixels are modified 3532 while masked pixels (not black) are protected from alteration.</font></td></tr></table> 3533 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3534 Use <strong>+mask</strong> to remove the clipping mask.</font></td></tr></table> 3535 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3536 It is not necessary to use <strong>-clip</strong> to activate the mask; <strong>-clip</strong> 3537 is implied by <strong>-mask</strong>.</font></td></tr></table> 3538 <table BORDER=0 WIDTH="94%"> 3539 <tr> 3540 <td width="3%"><br></td> 3541 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3542 <img SRC="images/right_triangle_option.png" 3543 ALT=">" BORDER=0 height=14 3544 width=15><b><font face="Helvetica, Arial" 3545 ><font color="#00B04F"><font size="+1"> 3546 <a name="details-matte"></a>-matte 3547 </font></font></font></b></td></tr></table> 3548 <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> 3549 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3550 If the image does not have a matte channel, create an opaque one.</font></td></tr></table> 3551 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3552 Use <strong>+matte</strong> to ignore the matte channel and to avoid writing a 3553 matte channel in the output file.</font></td></tr></table> 3554 <table BORDER=0 WIDTH="94%"> 3555 <tr> 3556 <td width="3%"><br></td> 3557 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3558 <img SRC="images/right_triangle_option.png" 3559 ALT=">" BORDER=0 height=14 3560 width=15><b><font face="Helvetica, Arial" 3561 ><font color="#00B04F"><font size="+1"> 3562 <a name="details-mattecolor"></a>-mattecolor <i><color></i> 3563 </font></font></font></b></td></tr></table> 3564 <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> 3565 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3566 The color is specified using the format described under the <strong>-fill</strong> 3567 option.</font></td></tr></table> 3568 <table BORDER=0 WIDTH="94%"> 3569 <tr> 3570 <td width="3%"><br></td> 3571 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3572 <img SRC="images/right_triangle_option.png" 3573 ALT=">" BORDER=0 height=14 3574 width=15><b><font face="Helvetica, Arial" 3575 ><font color="#00B04F"><font size="+1"> 3576 <a name="details-maximum-error"></a>-maximum-error <i><limit></i> 3577 </font></font></font></b></td></tr></table> 3578 <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> 3579 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3580 Specifies the maximum amount of total image error (based on comparison 3581 using a specified metric) before an error ("image difference exceeds 3582 limit") is reported. The error is reported via a non-zero command 3583 execution return status.</font></td></tr></table> 3584 <table BORDER=0 WIDTH="94%"> 3585 <tr> 3586 <td width="3%"><br></td> 3587 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3588 <img SRC="images/right_triangle_option.png" 3589 ALT=">" BORDER=0 height=14 3590 width=15><b><font face="Helvetica, Arial" 3591 ><font color="#00B04F"><font size="+1"> 3592 -median <i><radius></i> 3593 </font></font></font></b></td></tr></table> 3594 <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> 3595 <table BORDER=0 WIDTH="94%"> 3596 <tr> 3597 <td width="3%"><br></td> 3598 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3599 <img SRC="images/right_triangle_option.png" 3600 ALT=">" BORDER=0 height=14 3601 width=15><b><font face="Helvetica, Arial" 3602 ><font color="#00B04F"><font size="+1"> 3603 -metric <i><metric></i> 3604 </font></font></font></b></td></tr></table> 3605 <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> 3606 <table BORDER=0 WIDTH="94%"> 3607 <tr> 3608 <td width="3%"><br></td> 3609 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3610 <img SRC="images/right_triangle_option.png" 3611 ALT=">" BORDER=0 height=14 3612 width=15><b><font face="Helvetica, Arial" 3613 ><font color="#00B04F"><font size="+1"> 3614 -minify <i><factor></i> 3615 </font></font></font></b></td></tr></table> 3616 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>minify the image</td></tr></table> 3617 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3618 The image size is halved using linear interpolation.</font></td></tr></table> 3619 <table BORDER=0 WIDTH="94%"> 3620 <tr> 3621 <td width="3%"><br></td> 3622 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3623 <img SRC="images/right_triangle_option.png" 3624 ALT=">" BORDER=0 height=14 3625 width=15><b><font face="Helvetica, Arial" 3626 ><font color="#00B04F"><font size="+1"> 3627 -mode <i><value></i> 3628 </font></font></font></b></td></tr></table> 3629 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>mode of operation</td></tr></table> 3630 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3631 The available montage modes are <strong>frame</strong> to place the images in a 3632 rectangular grid while adding a decorative frame with dropshadow, 3633 <strong>unframe</strong> to place undecorated images in a rectangular grid, and 3634 <strong>concatenate</strong> to pack the images closely together without any 3635 well-defined grid or decoration. </font></td></tr></table> 3636 <table BORDER=0 WIDTH="94%"> 3637 <tr> 3638 <td width="3%"><br></td> 3639 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3640 <img SRC="images/right_triangle_option.png" 3641 ALT=">" BORDER=0 height=14 3642 width=15><b><font face="Helvetica, Arial" 3643 ><font color="#00B04F"><font size="+1"> 3644 <a name="details-modulate"></a>-modulate <i>brightness[,saturation[,hue]]</i> 3645 </font></font></font></b></td></tr></table> 3646 <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> 3647 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3648 Specify the percent change in brightness, color saturation, and 3649 hue separated by commas. Default argument values are 100 percent, 3650 resulting in no change. For example, to increase the color brightness 3651 by 20% and decrease the color saturation by 10% and leave the hue 3652 unchanged, use: <strong>-modulate 120,90</strong>.</font></td></tr></table> 3653 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3654 Hue is the percentage of absolute rotation from the current 3655 position. For example 50 results in a counter-clockwise rotation of 90 3656 degrees, 150 results in a clockwise rotation of 90 degrees, with 0 and 3657 200 both resulting in a rotation of 180 degrees.</font></td></tr></table> 3658 <table BORDER=0 WIDTH="94%"> 3659 <tr> 3660 <td width="3%"><br></td> 3661 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3662 <img SRC="images/right_triangle_option.png" 3663 ALT=">" BORDER=0 height=14 3664 width=15><b><font face="Helvetica, Arial" 3665 ><font color="#00B04F"><font size="+1"> 3666 -monitor 3667 </font></font></font></b></td></tr></table> 3668 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>show progress indication</td></tr></table> 3669 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3670 A simple command-line progress indication is shown while the command is 3671 running. The process indication shows the operation currently being 3672 performed and the percent completed. Commands using X11 may replace the 3673 command line progress indication with a graphical one once an image has 3674 been displayed.</font></td></tr></table> 3675 <table BORDER=0 WIDTH="94%"> 3676 <tr> 3677 <td width="3%"><br></td> 3678 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3679 <img SRC="images/right_triangle_option.png" 3680 ALT=">" BORDER=0 height=14 3681 width=15><b><font face="Helvetica, Arial" 3682 ><font color="#00B04F"><font size="+1"> 3683 -monochrome 3684 </font></font></font></b></td></tr></table> 3685 <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> 3686 <table BORDER=0 WIDTH="94%"> 3687 <tr> 3688 <td width="3%"><br></td> 3689 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3690 <img SRC="images/right_triangle_option.png" 3691 ALT=">" BORDER=0 height=14 3692 width=15><b><font face="Helvetica, Arial" 3693 ><font color="#00B04F"><font size="+1"> 3694 <a name="details-morph"></a>-morph <i><frames></i> 3695 </font></font></font></b></td></tr></table> 3696 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>morphs an image sequence</td></tr></table> 3697 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3698 Both the image pixels and size are linearly interpolated to give the appearance 3699 of a meta-morphosis from one image to the next.</font></td></tr></table> 3700 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3701 The sequence of images 3702 is terminated by the appearance of any option. 3703 If the <strong>-morph</strong> 3704 option appears after all of the input images, all images are morphed.</font></td></tr></table> 3705 <table BORDER=0 WIDTH="94%"> 3706 <tr> 3707 <td width="3%"><br></td> 3708 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3709 <img SRC="images/right_triangle_option.png" 3710 ALT=">" BORDER=0 height=14 3711 width=15><b><font face="Helvetica, Arial" 3712 ><font color="#00B04F"><font size="+1"> 3713 <a name="details-mosaic"></a>-mosaic 3714 </font></font></font></b></td></tr></table> 3715 <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> 3716 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3717 The <strong>-mosaic</strong> option provides a flexible way to composite one or 3718 more images onto a solid-color canvas image. It works similar to 3719 <strong>-flatten</strong> except that a base canvas image is automatically 3720 created with a suitable size given the image size, page dimensions, 3721 and page offsets of images to be composited. The color of the base 3722 canvas image may be set via the <strong>-background</strong> option. The 3723 default canvas color is 'white', but 'black' or 'transparent' may be 3724 more suitable depending on the composition algorithm requested.</font></td></tr></table> 3725 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3726 The <strong>-compose</strong> option may be used to specify the composition 3727 algorithm to use when compositing the subsequent image on the base 3728 canvas.</font></td></tr></table> 3729 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3730 The <strong>-page</strong> option can be used to establish the dimensions of the 3731 mosaic and to position the subsequent image within the mosaic. If the 3732 <strong>-page</strong> argument does not specify width and height, then the 3733 canvas dimensions are evaluated based on the image sizes and 3734 offsets.</font></td></tr></table> 3735 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3736 The sequence of images is terminated by the appearance of any option. 3737 If the <strong>-mosaic</strong> option appears after all of the input images, 3738 all images are included in the mosaic.</font></td></tr></table> 3739 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3740 The following is an example of composing an image based on red, green, 3741 and blue layers extracted from a sequence of images and pasted on the 3742 canvas image at specified offsets:</font></td></tr></table> 3743 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 3744 gm convert -background black \ 3745 -compose CopyRed -page +0-100 red.png \ 3746 -compose CopyGreen -page +0+40 green.png \ 3747 -compose CopyBlue -page +0+180 blue.png \ 3748 -mosaic output.png 3749 </pre></font></td></tr></table> 3750 <table BORDER=0 WIDTH="94%"> 3751 <tr> 3752 <td width="3%"><br></td> 3753 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3754 <img SRC="images/right_triangle_option.png" 3755 ALT=">" BORDER=0 height=14 3756 width=15><b><font face="Helvetica, Arial" 3757 ><font color="#00B04F"><font size="+1"> 3758 <a name="details-motion-blur"></a>-motion-blur <i><radius></i>{<i>x<sigma></i>}<i></i>{<i>+angle</i>}<i></i> 3759 </font></font></font></b></td></tr></table> 3760 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Simulate motion blur</td></tr></table> 3761 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3762 Simulate motion blur by convolving the image with a Gaussian operator of 3763 the given radius and standard deviation (sigma). For reasonable results, 3764 radius should be larger than sigma. If radius is zero, then a suitable 3765 radius is automatically selected based on sigma. The angle specifies the 3766 angle that the object is coming from (side which is blurred).</font></td></tr></table> 3767 <table BORDER=0 WIDTH="94%"> 3768 <tr> 3769 <td width="3%"><br></td> 3770 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3771 <img SRC="images/right_triangle_option.png" 3772 ALT=">" BORDER=0 height=14 3773 width=15><b><font face="Helvetica, Arial" 3774 ><font color="#00B04F"><font size="+1"> 3775 -name 3776 </font></font></font></b></td></tr></table> 3777 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name an image</td></tr></table> 3778 <table BORDER=0 WIDTH="94%"> 3779 <tr> 3780 <td width="3%"><br></td> 3781 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3782 <img SRC="images/right_triangle_option.png" 3783 ALT=">" BORDER=0 height=14 3784 width=15><b><font face="Helvetica, Arial" 3785 ><font color="#00B04F"><font size="+1"> 3786 <a name="details-negate"></a>-negate 3787 </font></font></font></b></td></tr></table> 3788 <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> 3789 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3790 The red, green, and blue intensities of an image are negated. 3791 White becomes black, 3792 yellow becomes blue, etc. 3793 Use <strong>+negate</strong> 3794 to only negate the grayscale pixels of the image.</font></td></tr></table> 3795 <table BORDER=0 WIDTH="94%"> 3796 <tr> 3797 <td width="3%"><br></td> 3798 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3799 <img SRC="images/right_triangle_option.png" 3800 ALT=">" BORDER=0 height=14 3801 width=15><b><font face="Helvetica, Arial" 3802 ><font color="#00B04F"><font size="+1"> 3803 <a name="details-noise"></a>-noise <i><radius|type></i> 3804 </font></font></font></b></td></tr></table> 3805 <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> 3806 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3807 The principal function of noise peak elimination filter is to smooth the 3808 objects within an image without losing edge information and without creating 3809 undesired structures. The central idea of the algorithm is to replace a 3810 pixel with its next neighbor in value within a pixel window, if this pixel 3811 has been found to be noise. A pixel is defined as noise if and only if 3812 this pixel is a maximum or minimum within the pixel window.</font></td></tr></table> 3813 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3814 Use <strong>radius</strong> to specify the width of the neighborhood.</font></td></tr></table> 3815 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3816 Use <strong>+noise</strong> followed by a noise type to add noise to an image. 3817 The noise added modulates the existing image pixels. Choose from these 3818 noise types:</font></td></tr></table> 3819 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 3820 Uniform 3821 Gaussian 3822 Multiplicative 3823 Impulse 3824 Laplacian 3825 Poisson 3826 Random (uniform distribution) 3827 </pre></font></td></tr></table> 3828 <table BORDER=0 WIDTH="94%"> 3829 <tr> 3830 <td width="3%"><br></td> 3831 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3832 <img SRC="images/right_triangle_option.png" 3833 ALT=">" BORDER=0 height=14 3834 width=15><b><font face="Helvetica, Arial" 3835 ><font color="#00B04F"><font size="+1"> 3836 <a name="details-noop"></a>-noop 3837 </font></font></font></b></td></tr></table> 3838 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>NOOP (no option)</td></tr></table> 3839 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3840 The <strong>-noop</strong> option can be used to terminate a group of images 3841 and reset all options to their default values, when no other option is 3842 desired.</font></td></tr></table> 3843 <table BORDER=0 WIDTH="94%"> 3844 <tr> 3845 <td width="3%"><br></td> 3846 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3847 <img SRC="images/right_triangle_option.png" 3848 ALT=">" BORDER=0 height=14 3849 width=15><b><font face="Helvetica, Arial" 3850 ><font color="#00B04F"><font size="+1"> 3851 <a name="details-normalize"></a>-normalize 3852 </font></font></font></b></td></tr></table> 3853 <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> 3854 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3855 This is a contrast enhancement technique based on the image histogram.</font></td></tr></table> 3856 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3857 When computing the contrast enhancement values, the histogram edges 3858 are truncated so that the majority of the image pixels are considered 3859 in the constrast enhancement, and outliers (e.g. random noise or 3860 minute details) are ignored. The default is that 0.1 percent of the 3861 histogram entries are ignored. The percentage of the histogram to 3862 ignore may be specified by using the <strong>-set</strong> option with the 3863 <strong>histogram-threshold</strong> parameter similar to <strong>-set 3864 histogram-threshold 0.01</strong> to specify 0.01 percent. Use 0 percent 3865 to use the entire histogram, with possibly diminished contrast 3866 enhancement.</font></td></tr></table> 3867 <table BORDER=0 WIDTH="94%"> 3868 <tr> 3869 <td width="3%"><br></td> 3870 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3871 <img SRC="images/right_triangle_option.png" 3872 ALT=">" BORDER=0 height=14 3873 width=15><b><font face="Helvetica, Arial" 3874 ><font color="#00B04F"><font size="+1"> 3875 <a name="details-opaque"></a>-opaque <i><color></i> 3876 </font></font></font></b></td></tr></table> 3877 <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> 3878 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3879 The color is specified using the format described under the 3880 <strong>-fill</strong> option. The color is replaced if it is identical to the 3881 target color, or close enough to the target color in a 3D space as 3882 defined by the Euclidean distance specified by <strong>-fuzz</strong>.</font></td></tr></table> 3883 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3884 See <strong>-fill</strong> and <strong>-fuzz</strong> for more details.</font></td></tr></table> 3885 <table BORDER=0 WIDTH="94%"> 3886 <tr> 3887 <td width="3%"><br></td> 3888 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 3889 <img SRC="images/right_triangle_option.png" 3890 ALT=">" BORDER=0 height=14 3891 width=15><b><font face="Helvetica, Arial" 3892 ><font color="#00B04F"><font size="+1"> 3893 <a name="details-operator"></a>-operator <i>channel operator rvalue[%]</i> 3894 </font></font></font></b></td></tr></table> 3895 <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> 3896 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3897 Apply a low-level mathematical, bitwise, or value operator to a selected 3898 image channel or all image channels. Operations which result in negative 3899 results are reset to zero, and operations which overflow the available 3900 range are reset to the maximum possible value.</font></td></tr></table> 3901 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3902 Select a channel from: <strong>Red</strong>, <strong>Green</strong>, <strong>Blue</strong>, 3903 <strong>Opacity</strong>, <strong>Matte</strong>, <strong>Cyan</strong>, <strong>Magenta</strong>, <strong>Yellow</strong>, 3904 <strong>Black</strong>, <strong>All</strong>, or <strong>Gray</strong>. <strong>All</strong> only modifies the 3905 color channels and does not modify the <strong>Opacity</strong> channel. Except for 3906 the threshold operators, <strong>All</strong> operates on each channel 3907 independently so that operations are on a per-channel basis.</font></td></tr></table> 3908 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3909 <strong>Gray</strong> treats the color channels as a grayscale intensity and 3910 performs the requested operation on the equivalent pixel intensity so the 3911 result is a gray image.</font></td></tr></table> 3912 <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>, 3913 <strong>Depth</strong>, <strong>Divide</strong>, <strong>Gamma</strong>, <strong>Negate</strong>, 3914 <strong>LShift</strong>, <strong>Log</strong>, <strong>Max</strong>, <strong>Min</strong>, <strong>Multiply</strong>, 3915 <strong>Or</strong>, <strong>Pow</strong> <strong>RShift</strong>, <strong>Subtract</strong>, 3916 <strong>Threshold</strong>, <strong>Threshold-White</strong>, 3917 <strong>Threshold-White-Negate</strong>, <strong>Threshold-Black</strong>, 3918 <strong>Threshold-Black-Negate</strong>, <strong>Xor</strong>, <strong>Noise-Gaussian</strong>, 3919 <strong>Noise-Impulse</strong>, <strong>Noise-Laplacian</strong>, 3920 <strong>Noise-Multiplicative</strong>, <strong>Noise-Poisson</strong>, 3921 <strong>Noise-Random</strong>, and <strong>Noise-Uniform</strong>.</font></td></tr></table> 3922 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3923 Rvalue may be any floating point or integer value. Normally rvalue will 3924 be in the range of 0 to MaxRGB, where MaxRGB is the largest quantum value 3925 supported by the GraphicsMagick build (255, 65535, or 4294967295) but 3926 values outside this range are useful for some arithmetic operations. 3927 Arguments to logical or bit-wise operations are rounded to a positive 3928 integral value prior to use. If a percent (<strong>%</strong>) symbol is appended 3929 to the argument, then the argument has a range of 0 to 100 percent.</font></td></tr></table> 3930 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3931 The following is a description of the operators:</font></td></tr></table> 3932 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 3933 <dl> 3934 <dt>Add</dt> 3935 <dd>Result is rvalue added to channel value. 3936 </dd> 3937 <dt>And</dt> 3938 <dd>Result is the logical AND of rvalue with channel value. 3939 </dd> 3940 <dt>Assign</dt> 3941 <dd>Result is rvalue. 3942 </dd> 3943 <dt>Depth</dt> 3944 <dd>Result is channel value adjusted so that it may be (approximately) 3945 stored in the specified number of bits without additional loss. 3946 </dd> 3947 <dt>Divide</dt> 3948 <dd>Result is channel value divided by rvalue. 3949 </dd> 3950 <dt>Gamma</dt> 3951 <dd>Result is channel value gamma adjusted by rvalue. 3952 </dd> 3953 <dt>LShift</dt> 3954 <dd>Result is channel value bitwise left shifted by rvalue bits. 3955 </dd> 3956 <dt>Log</dt> 3957 <dd>Result is computed as log(value*rvalue+1)/log(rvalue+1). 3958 </dd> 3959 <dt>Max</dt> 3960 <dd>Result is assigned to rvalue if rvalue is greater than value. 3961 </dd> 3962 <dt>Min</dt> 3963 <dd>Result is assigned to rvalue if rvalue is less than value. 3964 </dd> 3965 <dt>Multiply</dt> 3966 <dd>Result is channel value multiplied by rvalue. 3967 </dd> 3968 <dt>Negate</dt> 3969 <dd>Result is inverse of channel value (like a film negative). An rvalue 3970 must be supplied but is currently not used. Inverting the image twice 3971 results in the original image. 3972 </dd> 3973 <dt>Or</dt> 3974 <dd>Result is the logical OR of rvalue with channel value. 3975 </dd> 3976 <dt>Pow</dt> 3977 <dd>Result is computed as pow(value,rvalue). Similar to Gamma except that 3978 rvalue is not inverted. 3979 </dd> 3980 <dt>RShift</dt> 3981 <dd>Result is channel value bitwise right shifted by rvalue bits. 3982 </dd> 3983 <dt>Subtract</dt> 3984 <dd>Result is channel value minus rvalue. 3985 </dd> 3986 <dt>Threshold</dt> 3987 <dd>Result is maximum (white) if channel value is greater than rvalue, 3988 or minimum (black) if it is less than or equal to rvalue. If <strong>all</strong> 3989 channels are specified, then thresholding is done based on computed pixel 3990 intensity. 3991 </dd> 3992 <dt>Threshold-white</dt> 3993 <dd>Result is maximum (white) if channel value is greater than rvalue and 3994 is unchanged if it is less than or equal to rvalue. This can be used to 3995 remove apparent noise from the bright parts of an image. If <strong>all</strong> 3996 channels are specified, then thresholding is done based on computed pixel 3997 intensity. 3998 </dd> 3999 <dt>Threshold-White-Negate</dt> 4000 <dd>Result is set to black if channel value is greater than 4001 rvalue and is unchanged if it is less than or equal to rvalue. If 4002 <strong>all</strong> channels are specified, then thresholding is done based on 4003 computed pixel intensity. 4004 </dd> 4005 <dt>Threshold-black</dt> 4006 <dd>Result is minimum (black) if channel value is less than than rvalue 4007 and is unchanged if it is greater than or equal to rvalue. This can be 4008 used to remove apparent noise from the dark parts of an image. If 4009 <strong>all</strong> channels are specified, then thresholding is done based on 4010 computed pixel intensity. 4011 </dd> 4012 <dt>Threshold-Black-Negate</dt> 4013 <dd>Result is set to white if channel value is less than than 4014 rvalue and is unchanged if it is greater than or equal to rvalue. If 4015 <strong>all</strong> channels are specified, then thresholding is done based on 4016 computed pixel intensity. 4017 </dd> 4018 <dt>Xor</dt> 4019 <dd>Result is the logical XOR of rvalue with channel value. An 4020 interesting property of XOR is that performing the same operation twice 4021 results in the original value. 4022 </dd> 4023 <dt>Noise-Gaussian</dt> 4024 <dd>Result is the current channel value modulated with gaussian noise 4025 according to the intensity specified by rvalue. 4026 </dd> 4027 <dt>Noise-Impulse</dt> 4028 <dd>Result is the current channel value modulated with impulse noise 4029 according to the intensity specified by rvalue. 4030 </dd> 4031 <dt>Noise-Laplacian</dt> 4032 <dd>Result is the current channel value modulated with laplacian noise 4033 according to the intensity specified by rvalue. 4034 </dd> 4035 <dt>Noise-Multiplicative</dt> 4036 <dd>Result is the current channel value modulated with multiplicative 4037 gaussian noise according to the intensity specified by rvalue. 4038 </dd> 4039 <dt>Noise-Poisson</dt> 4040 <dd>Result is the current channel value modulated with poisson noise 4041 according to the intensity specified by rvalue. 4042 </dd> 4043 <dt>Noise-Random</dt> 4044 <dd>Result is the current channel value modulated with random (uniform 4045 distribution) noise according to the intensity specified by rvalue. 4046 The initial noise intensity (rvalue=1.0) is the range of one pixel 4047 quantum span. 4048 </dd> 4049 <dt>Noise-Uniform</dt> 4050 <dd>Result is the channel value with uniform noise applied according to 4051 the intensity specified by rvalue. 4052 </dd> 4053 </dl> 4054 </font></td></tr></table> 4055 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4056 As an example, the <strong>Assign</strong> operator assigns a fixed value to a 4057 channel. For example, this command sets the red channel to the mid-range 4058 value:</font></td></tr></table> 4059 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4060 gm convert in.bmp -operator red assign "50%" out.bmp 4061 </pre></font></td></tr></table> 4062 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4063 The following applies 50% thresholding to the image and returns a gray 4064 image:</font></td></tr></table> 4065 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4066 gm convert in.bmp -operator gray threshold "50%" out.bmp 4067 </pre></font></td></tr></table> 4068 <table BORDER=0 WIDTH="94%"> 4069 <tr> 4070 <td width="3%"><br></td> 4071 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4072 <img SRC="images/right_triangle_option.png" 4073 ALT=">" BORDER=0 height=14 4074 width=15><b><font face="Helvetica, Arial" 4075 ><font color="#00B04F"><font size="+1"> 4076 <a name="details-ordered-dither"></a>-ordered-dither <i><channeltype> <NxN></i> 4077 </font></font></font></b></td></tr></table> 4078 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>ordered dither the image</td></tr></table> 4079 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4080 The channel or channels specified in the <strong>channeltype</strong> argument are 4081 reduced to binary, using an ordered dither method. The choices for 4082 <strong>channeltype</strong> are <strong>All</strong>, <strong>Intensity</strong>, <strong>Red</strong>, 4083 <strong>Green</strong>, <strong>Blue</strong>, <strong>Cyan</strong>, <strong>Magenta</strong>, <strong>Yellow</strong>, 4084 <strong>Black</strong>, and <strong>Opacity</strong></font></td></tr></table> 4085 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4086 When <strong>channeltype</strong> is "All", the color samples are dithered into 4087 a gray level and then that gray level is stored in the three color 4088 channels. Separately, the opacity channel is dithered into a bilevel 4089 opacity value which is stored in the opacity channel.</font></td></tr></table> 4090 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4091 When <strong>channeltype</strong> is "Intensity", only the color samples are 4092 dithered. When <strong>channeltype</strong> is "opacity" or "matte", only the 4093 opacity channel is dithered. When a color channel is specified, only that 4094 channel is dithered.</font></td></tr></table> 4095 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4096 The choices for N are 2 through 7. The image is divided into 4097 NxN pixel tiles. In each tile, some or all pixels are turned to 4098 white depending on their intensity. For each N, (N**2)+1 levels 4099 of gray can be represented. For N == 2, 3, or 4, the pixels 4100 are turned to white in an order that maximizes dispersion (i.e., 4101 reduces granularity), while 4102 for N == 5, 6, and 7, they are turned to white in an order that 4103 creates a roughly circular black blob in the middle of each tile. 4104 An attractive "half-tone" looking image can be obtained by first 4105 rotating the image 45 degrees, performing a 5x5 ordered-dither 4106 operation, then rotating it back to the original orientation and 4107 cropping to the original image dimensions. If the original image 4108 is gamma-encoded, it is adviseable to convert it to linear intensity 4109 first, e.g., with the "-gamma 0.45455" option.</font></td></tr></table> 4110 <table BORDER=0 WIDTH="94%"> 4111 <tr> 4112 <td width="3%"><br></td> 4113 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4114 <img SRC="images/right_triangle_option.png" 4115 ALT=">" BORDER=0 height=14 4116 width=15><b><font face="Helvetica, Arial" 4117 ><font color="#00B04F"><font size="+1"> 4118 <a name="details-output-directory"></a>-output-directory <i><directory></i> 4119 </font></font></font></b></td></tr></table> 4120 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>output files to directory</td></tr></table> 4121 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4122 Use -output-directory to specify a directory under which to write the 4123 output files. Normally mogrify overwrites the input files, but with 4124 this option the output files may be written to a different directory 4125 tree so that the input files are preserved. The algorithm used 4126 preserves all of the input path specification in the output path so 4127 that the user-specified input path (including any sub-directory part) 4128 is appended to the output path. If the input file lacks an extension, 4129 then a suitable extension is automatically added to the output file. 4130 The user is responsible for creating the output directory specified as 4131 an argument, but subdirectories will be created as needed if the 4132 <strong>-create-directories</strong> option is supplied. This option may be 4133 used to apply transformations on files from one directory and write 4134 the transformed files to a different directory. In conjunction with 4135 <strong>-create-directories</strong>, this option is designed to support 4136 transforming whole directory trees of files provided that the relative 4137 path of the input file is included as part the list of filenames.</font></td></tr></table> 4138 <table BORDER=0 WIDTH="94%"> 4139 <tr> 4140 <td width="3%"><br></td> 4141 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4142 <img SRC="images/right_triangle_option.png" 4143 ALT=">" BORDER=0 height=14 4144 width=15><b><font face="Helvetica, Arial" 4145 ><font color="#00B04F"><font size="+1"> 4146 <a name="details-orient"></a>-orient <i><orientation></i> 4147 </font></font></font></b></td></tr></table> 4148 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Set the image orientation attribute</td></tr></table> 4149 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4150 Sets the image orientation attribute. The image orientation attribute 4151 is compatible with the TIFF orientation tag (and the EXIF orientation 4152 tag). Accepted values are <strong>undefined</strong>, <strong>TopLeft</strong>, 4153 <strong>TopRight</strong>, <strong>BottomRight</strong>, <strong>BottomLeft</strong>, 4154 <strong>LeftTop</strong>, <strong>RightTop</strong>, <strong>RightBottom</strong>, 4155 <strong>LeftBottom</strong>, and hyphenated versions thereof 4156 (e.g. <strong>left-bottom</strong>). Please note that GraphicsMagick does not 4157 include an EXIF editor so if an EXIF profile is written to the output 4158 image, the value in the EXIF profile might not match the image. It is 4159 possible for an image file to indicate its orientation in several 4160 different ways simultaneously.</font></td></tr></table> 4161 <table BORDER=0 WIDTH="94%"> 4162 <tr> 4163 <td width="3%"><br></td> 4164 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4165 <img SRC="images/right_triangle_option.png" 4166 ALT=">" BORDER=0 height=14 4167 width=15><b><font face="Helvetica, Arial" 4168 ><font color="#00B04F"><font size="+1"> 4169 <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> 4170 </font></font></font></b></td></tr></table> 4171 <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> 4172 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4173 Use this option to specify the dimensions of the 4174 <em>PostScript</em> page 4175 in dots per inch or a TEXT page in pixels. The choices for a PostScript 4176 page are:</font></td></tr></table> 4177 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4178 11x17 792 1224 4179 Ledger 1224 792 4180 Legal 612 1008 4181 Letter 612 792 4182 LetterSmall 612 792 4183 ArchE 2592 3456 4184 ArchD 1728 2592 4185 ArchC 1296 1728 4186 ArchB 864 1296 4187 ArchA 648 864 4188 A0 2380 3368 4189 A1 1684 2380 4190 A2 1190 1684 4191 A3 842 1190 4192 A4 595 842 4193 A4Small 595 842 4194 A5 421 595 4195 A6 297 421 4196 A7 210 297 4197 A8 148 210 4198 A9 105 148 4199 A10 74 105 4200 B0 2836 4008 4201 B1 2004 2836 4202 B2 1418 2004 4203 B3 1002 1418 4204 B4 709 1002 4205 B5 501 709 4206 C0 2600 3677 4207 C1 1837 2600 4208 C2 1298 1837 4209 C3 918 1298 4210 C4 649 918 4211 C5 459 649 4212 C6 323 459 4213 Flsa 612 936 4214 Flse 612 936 4215 HalfLetter 396 612 4216 </pre></font></td></tr></table> 4217 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4218 For convenience you can specify the page size by media (e.g. A4, Ledger, 4219 etc.). Otherwise, <strong>-page</strong> behaves much like 4220 <strong>-geometry</strong> (e.g. <tt>-page letter+43+43></tt>).</font></td></tr></table> 4221 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4222 This option is also used to place subimages when writing to a multi-image 4223 format that supports offsets, such as GIF89 and MNG. When used for this 4224 purpose the offsets are always measured from the 4225 top left corner of the canvas and are not affected by the <strong>-gravity</strong> 4226 option. 4227 To position a GIF or MNG image, use <strong>-page</strong><em>{+-}<x>{+-}<y></em> 4228 (e.g. -page +100+200). When writing to a MNG file, a <strong>-page</strong> 4229 option appearing ahead of the first image in the sequence with nonzero 4230 width and height defines the width and height values that are written in 4231 the <strong>MHDR</strong> chunk. Otherwise, the MNG width and height are computed 4232 from the bounding box that contains all images in the sequence. When 4233 writing a GIF89 file, only the bounding box method is used to determine its 4234 dimensions.</font></td></tr></table> 4235 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4236 For a PostScript page, the image is sized as in <strong>-geometry</strong> and positioned 4237 relative to the lower left hand corner of the page by 4238 {+-}<<strong>x</strong><em>offset</em>>{+-}<<strong>y</strong> 4239 <em>offset></em>. Use 4240 <tt>-page 612x792></tt>, for example, to center the 4241 image within the page. If the image size exceeds the PostScript page, it 4242 is reduced to fit the page. 4243 The default gravity for the <strong>-page</strong> 4244 option is <em>NorthWest</em>, i.e., positive <strong>x</strong> and 4245 <strong>y</strong> <em>offset</em> are measured rightward and downward from the top 4246 left corner of the page, unless the <strong>-gravity</strong> option is present with 4247 a value other than <em>NorthWest</em>.</font></td></tr></table> 4248 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4249 The default page dimensions for a TEXT image is 612x792.</font></td></tr></table> 4250 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4251 This option is used in concert with <strong>-density</strong>.</font></td></tr></table> 4252 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4253 Use <strong>+page</strong> to remove the page settings for an image.</font></td></tr></table> 4254 <table BORDER=0 WIDTH="94%"> 4255 <tr> 4256 <td width="3%"><br></td> 4257 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4258 <img SRC="images/right_triangle_option.png" 4259 ALT=">" BORDER=0 height=14 4260 width=15><b><font face="Helvetica, Arial" 4261 ><font color="#00B04F"><font size="+1"> 4262 <a name="details-paint"></a>-paint <i><radius></i> 4263 </font></font></font></b></td></tr></table> 4264 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>simulate an oil painting</td></tr></table> 4265 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4266 Each pixel is replaced by the most frequent color in a circular neighborhood 4267 whose width is specified with <em>radius</em>.</font></td></tr></table> 4268 <table BORDER=0 WIDTH="94%"> 4269 <tr> 4270 <td width="3%"><br></td> 4271 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4272 <img SRC="images/right_triangle_option.png" 4273 ALT=">" BORDER=0 height=14 4274 width=15><b><font face="Helvetica, Arial" 4275 ><font color="#00B04F"><font size="+1"> 4276 <a name="details-pause"></a>-pause <i><seconds></i> 4277 </font></font></font></b></td></tr></table> 4278 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pause between animation loops [animate]</td></tr></table> 4279 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4280 Pause for the specified number of seconds before repeating the 4281 animation.</font></td></tr></table> 4282 <table BORDER=0 WIDTH="94%"> 4283 <tr> 4284 <td width="3%"><br></td> 4285 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4286 <img SRC="images/right_triangle_option.png" 4287 ALT=">" BORDER=0 height=14 4288 width=15><b><font face="Helvetica, Arial" 4289 ><font color="#00B04F"><font size="+1"> 4290 <a name="details-pause"></a>-pause <i><seconds></i> 4291 </font></font></font></b></td></tr></table> 4292 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pause between snapshots [import]</td></tr></table> 4293 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4294 Pause for the specified number of seconds before taking the next 4295 snapshot.</font></td></tr></table> 4296 <table BORDER=0 WIDTH="94%"> 4297 <tr> 4298 <td width="3%"><br></td> 4299 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4300 <img SRC="images/right_triangle_option.png" 4301 ALT=">" BORDER=0 height=14 4302 width=15><b><font face="Helvetica, Arial" 4303 ><font color="#00B04F"><font size="+1"> 4304 <a name="details-pen"></a>-pen <i><color></i> 4305 </font></font></font></b></td></tr></table> 4306 <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> 4307 <table BORDER=0 WIDTH="94%"> 4308 <tr> 4309 <td width="3%"><br></td> 4310 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4311 <img SRC="images/right_triangle_option.png" 4312 ALT=">" BORDER=0 height=14 4313 width=15><b><font face="Helvetica, Arial" 4314 ><font color="#00B04F"><font size="+1"> 4315 -ping 4316 </font></font></font></b></td></tr></table> 4317 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>efficiently determine image characteristics</td></tr></table> 4318 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4319 Use this option to disable reading the image pixels so that image 4320 characteristics such as the image dimensions may be obtained very 4321 quickly. For identify, use +ping to force reading the image pixels so 4322 that the pixel read rate may be included in the displayed information.</font></td></tr></table> 4323 <table BORDER=0 WIDTH="94%"> 4324 <tr> 4325 <td width="3%"><br></td> 4326 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4327 <img SRC="images/right_triangle_option.png" 4328 ALT=">" BORDER=0 height=14 4329 width=15><b><font face="Helvetica, Arial" 4330 ><font color="#00B04F"><font size="+1"> 4331 -pointsize <i><value></i> 4332 </font></font></font></b></td></tr></table> 4333 <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> 4334 <table BORDER=0 WIDTH="94%"> 4335 <tr> 4336 <td width="3%"><br></td> 4337 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4338 <img SRC="images/right_triangle_option.png" 4339 ALT=">" BORDER=0 height=14 4340 width=15><b><font face="Helvetica, Arial" 4341 ><font color="#00B04F"><font size="+1"> 4342 <a name="details-preview"></a>-preview <i><type></i> 4343 </font></font></font></b></td></tr></table> 4344 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>image preview type</td></tr></table> 4345 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4346 Use this option to affect the preview operation of an image (e.g. 4347 <tt>convert file.png -preview Gamma Preview:gamma.png</tt>). Choose 4348 from these previews:</font></td></tr></table> 4349 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4350 Rotate 4351 Shear 4352 Roll 4353 Hue 4354 Saturation 4355 Brightness 4356 Gamma 4357 Spiff 4358 Dull 4359 Grayscale 4360 Quantize 4361 Despeckle 4362 ReduceNoise 4363 AddNoise 4364 Sharpen 4365 Blur 4366 Threshold 4367 EdgeDetect 4368 Spread 4369 Shade 4370 Raise 4371 Segment 4372 Solarize 4373 Swirl 4374 Implode 4375 Wave 4376 OilPaint 4377 CharcoalDrawing 4378 JPEG 4379 </pre></font></td></tr></table> 4380 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4381 The default preview is <strong>JPEG</strong>.</font></td></tr></table> 4382 <table BORDER=0 WIDTH="94%"> 4383 <tr> 4384 <td width="3%"><br></td> 4385 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4386 <img SRC="images/right_triangle_option.png" 4387 ALT=">" BORDER=0 height=14 4388 width=15><b><font face="Helvetica, Arial" 4389 ><font color="#00B04F"><font size="+1"> 4390 <a name="details-process"></a>-process <i><command></i> 4391 </font></font></font></b></td></tr></table> 4392 <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> 4393 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4394 The command argument has the form <strong>module=arg1,arg2,arg3,...,argN</strong> 4395 where <strong>module</strong> is the name of the module to invoke (e.g. "analyze") 4396 and arg1,arg2,arg3,...,argN are an arbitrary number of arguments to 4397 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"> 4398 The sequence of images 4399 is terminated by the appearance of any option.</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 If the <strong>-process</strong> 4402 option appears after all of the input images, all images are processed.</font></td></tr></table> 4403 <table BORDER=0 WIDTH="94%"> 4404 <tr> 4405 <td width="3%"><br></td> 4406 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4407 <img SRC="images/right_triangle_option.png" 4408 ALT=">" BORDER=0 height=14 4409 width=15><b><font face="Helvetica, Arial" 4410 ><font color="#00B04F"><font size="+1"> 4411 <a name="details-profile"></a>-profile <i><filename></i> 4412 </font></font></font></b></td></tr></table> 4413 <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> 4414 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4415 <tt>-profile filename</tt> adds an ICM (ICC color management), IPTC 4416 (newswire information), or a generic (including Exif) profile to the image 4417 </font></td></tr></table>. 4418 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4419 Use <tt>+profile icm</tt>, <tt>+profile iptc</tt>, or 4420 <tt>+profile profile_name</tt> to remove the respective profile. 4421 Multiple profiles may be listed, separated by commas. Profiles may be 4422 excluded from subsequent listed matches by preceding their name with 4423 an exclamation point. For example, <tt>+profile '!icm,*'</tt> strips 4424 all profiles except for the ICM profile. Use <tt>identify 4425 -verbose</tt> to find out what profiles are in the image file. Use 4426 <tt>+profile "*"</tt> to remove all profiles.</font></td></tr></table> 4427 <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 4428 of course also cause all profiles to be removed. The JPEG and PNG 4429 formats will store any profiles that have been read and not removed. 4430 In JPEG they are stored in APP1 markers, and in PNG they are stored 4431 as hex-coded binary in compressed zTXt chunks, except for the iCC 4432 chunk which is stored in the iCCP chunk.</font></td></tr></table> 4433 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4434 To extract a profile, the <strong>-profile</strong> option is not used. Instead, 4435 simply write the file to an image 4436 format such as <em>APP1, 8BIM, ICM,</em> or <em>IPTC</em>.</font></td></tr></table> 4437 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4438 For example, to extract the Exif data (which is stored in JPEG files 4439 in the <em>APP1</em> profile), use 4440 </font></td></tr></table> 4441 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4442 gm convert cockatoo.jpg exifdata.app1 4443 </pre></font></td></tr></table> 4444 <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 4445 reflect changes made to the image, e.g., rotation from portrait to landscape 4446 orientation, so it is possible that the preserved profile may contain 4447 invalid data.</font></td></tr></table> 4448 <table BORDER=0 WIDTH="94%"> 4449 <tr> 4450 <td width="3%"><br></td> 4451 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4452 <img SRC="images/right_triangle_option.png" 4453 ALT=">" BORDER=0 height=14 4454 width=15><b><font face="Helvetica, Arial" 4455 ><font color="#00B04F"><font size="+1"> 4456 <a name="details-preserve-timestamp"></a>-preserve-timestamp 4457 </font></font></font></b></td></tr></table> 4458 <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> 4459 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4460 Use this option to preserve the original modification and access 4461 timestamps of the file, even if it has been modified.</font></td></tr></table> 4462 <table BORDER=0 WIDTH="94%"> 4463 <tr> 4464 <td width="3%"><br></td> 4465 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4466 <img SRC="images/right_triangle_option.png" 4467 ALT=">" BORDER=0 height=14 4468 width=15><b><font face="Helvetica, Arial" 4469 ><font color="#00B04F"><font size="+1"> 4470 <a name="details+progress"></a>+progress 4471 </font></font></font></b></td></tr></table> 4472 <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> 4473 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4474 By default, when an image is displayed, a progress monitor bar is shown 4475 in the top left corner of an existing image display window, and the 4476 current cursor is replaced with an hourglass cursor. Use <strong>+progress</strong> 4477 to disable the progress monitor and busy cursor during display operations. 4478 While the progress monitor is disabled for all operations, the busy 4479 cursor continues to be enabled for non-display operations such as image 4480 processing. This option is useful for non-interactive display operations, 4481 or when a "clean" look is desired.</font></td></tr></table> 4482 <table BORDER=0 WIDTH="94%"> 4483 <tr> 4484 <td width="3%"><br></td> 4485 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4486 <img SRC="images/right_triangle_option.png" 4487 ALT=">" BORDER=0 height=14 4488 width=15><b><font face="Helvetica, Arial" 4489 ><font color="#00B04F"><font size="+1"> 4490 <a name="details-quality"></a>-quality <i><value></i> 4491 </font></font></font></b></td></tr></table> 4492 <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> 4493 <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 4494 quality and highest compression) to 100 (best quality but least 4495 effective compression). The default quality is 75. Use the 4496 <strong>-sampling-factor</strong> option to specify the factors for chroma 4497 downsampling. To use the same quality value as that found by the JPEG 4498 decoder, use the <tt>-define jpeg:preserve-settings</tt> flag.</font></td></tr></table> 4499 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4500 For the MIFF image format, and the TIFF format while using ZIP 4501 compression, quality/10 is the zlib compression level, which is 0 (worst 4502 but fastest compression) to 9 (best but slowest). It has no effect on the 4503 image appearance, since the compression is always lossless.</font></td></tr></table> 4504 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4505 For the JPEG-2000 image format, quality is mapped using a non-linear 4506 equation to the compression ratio required by the Jasper library. This 4507 non-linear equation is intended to loosely approximate the quality 4508 provided by the JPEG v1 format. The default quality value 75 results in 4509 a request for 16:1 compression. The quality value 100 results in 4510 a request for non-lossy compression.</font></td></tr></table> 4511 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4512 For the MNG and PNG image formats, the quality value sets the zlib compression 4513 level (quality / 10) and filter-type (quality % 10). Compression levels 4514 range from 0 (fastest compression) to 100 (best but slowest). For compression 4515 level 0, the Huffman-only strategy is used, which is fastest but not 4516 necessarily the worst compression.</font></td></tr></table> 4517 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4518 If 4519 filter-type is 4 or less, the specified filter-type is used for all scanlines:</font></td></tr></table> 4520 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4521 0: none 4522 1: sub 4523 2: up 4524 3: average 4525 4: Paeth 4526 </pre></font></td></tr></table> 4527 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4528 If filter-type is 5, adaptive filtering is used when quality is greater 4529 than 50 and the image does not have a color map, otherwise no filtering 4530 is used.</font></td></tr></table> 4531 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4532 If filter-type is 6, adaptive filtering 4533 with <em>minimum-sum-of-absolute-values</em> 4534 is used.</font></td></tr></table> 4535 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4536 Only if the output is MNG, if filter-type is 7, the LOCO color transformation 4537 and adaptive filtering with <em>minimum-sum-of-absolute-values</em> 4538 are used.</font></td></tr></table> 4539 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4540 The default is quality is 75, which means nearly the best compression with 4541 adaptive filtering. The quality setting has no effect on the appearance 4542 of PNG and MNG images, since the compression is always lossless.</font></td></tr></table> 4543 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4544 For further information, see the <a href="http://www.w3.org/TR/">PNG</a> 4545 specification.</font></td></tr></table> 4546 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4547 When writing a JNG image with transparency, two quality values are required, 4548 one for the main image and one for the grayscale image that conveys the 4549 opacity channel. These are written as a single integer equal to the main 4550 image quality plus 1000 times the opacity quality. For example, if you 4551 want to use quality 75 for the main image and quality 90 to compress 4552 the opacity data, use <tt>-quality 90075</tt>.</font></td></tr></table> 4553 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4554 For the PNM family of formats (PNM, PGM, and PPM) specify a quality 4555 factor of zero in order to obtain the ASCII variant of the format. Note 4556 that -compress <em>none</em> used to be used to trigger ASCII output but 4557 provided the opposite result of what was expected as compared with other 4558 formats.</font></td></tr></table> 4559 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4560 For the TIFF format, the JPEG, WebP, Zip, and Zstd compression 4561 algorithms are influenced by the quality value. JPEG and WebP provide 4562 lossy compression so higher quality produces a larger file with less 4563 degradation. The Zip and Zstd compression algorithms (and WebP in 4564 lossless mode) are lossless and for these algorithms a higher 4565 'quality' means to work harder to produce a smaller file, but with no 4566 difference in image quality.</font></td></tr></table> 4567 <table BORDER=0 WIDTH="94%"> 4568 <tr> 4569 <td width="3%"><br></td> 4570 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4571 <img SRC="images/right_triangle_option.png" 4572 ALT=">" BORDER=0 height=14 4573 width=15><b><font face="Helvetica, Arial" 4574 ><font color="#00B04F"><font size="+1"> 4575 <a name="details-raise"></a>-raise <i><width>x<height></i> 4576 </font></font></font></b></td></tr></table> 4577 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>lighten or darken image edges</td></tr></table> 4578 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4579 This will create a 3-D effect. See <strong>-geometry</strong> for details 4580 details about the geometry specification. Offsets are not used.</font></td></tr></table> 4581 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4582 Use <strong>-raise</strong> to create a raised effect, otherwise use <strong>+raise</strong>.</font></td></tr></table> 4583 <table BORDER=0 WIDTH="94%"> 4584 <tr> 4585 <td width="3%"><br></td> 4586 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4587 <img SRC="images/right_triangle_option.png" 4588 ALT=">" BORDER=0 height=14 4589 width=15><b><font face="Helvetica, Arial" 4590 ><font color="#00B04F"><font size="+1"> 4591 <a name="details-random-threshold"></a>-random-threshold <i><channeltype> <LOWxHIGH></i> 4592 </font></font></font></b></td></tr></table> 4593 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>random threshold the image</td></tr></table> 4594 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4595 The channel or channels specified in the <channeltype> argument are 4596 reduced to binary, using an random-threshold method. The choices for 4597 <strong>channeltype</strong> are <strong>All</strong>, <strong>Intensity</strong>, <strong>Red</strong>, 4598 <strong>Green</strong>, <strong>Blue</strong>, <strong>Cyan</strong>, <strong>Magenta</strong>, <strong>Yellow</strong>, 4599 <strong>Black</strong>, and <strong>Opacity</strong></font></td></tr></table> 4600 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4601 When <strong>channeltype</strong> is "All", the color samples are thresholded into 4602 a graylevel and then that gray level is stored in the three color 4603 channels. Separately, the opacity channel is thresholded into a bilevel 4604 opacity value which is stored in the opacity channel. For each pixel, a 4605 new random number is used to establish the threshold to be used. The 4606 threshold never exceeds the specified maximum (HIGH) and is never less 4607 than the specified minimum (LOW).</font></td></tr></table> 4608 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4609 When <strong>channeltype</strong> is "intensity", only the color samples are 4610 thresholded. When <strong>channeltype</strong> is "opacity" or "matte", only the 4611 opacity channel is thresholded. The other named channels only threshold 4612 the associated channel.</font></td></tr></table> 4613 <table BORDER=0 WIDTH="94%"> 4614 <tr> 4615 <td width="3%"><br></td> 4616 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4617 <img SRC="images/right_triangle_option.png" 4618 ALT=">" BORDER=0 height=14 4619 width=15><b><font face="Helvetica, Arial" 4620 ><font color="#00B04F"><font size="+1"> 4621 <a name="details-recolor"></a>-recolor <i><matrix></i> 4622 </font></font></font></b></td></tr></table> 4623 <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> 4624 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4625 A user supplied color translation matrix (expressed as a text string) 4626 is used to translate/blend the image channels based on weightings in a 4627 supplied matrix which may be of order 3 (color channels only), 4 4628 (color channels plus opacity), or 5 (color channels plus opacity and 4629 offset). Values in the columns of the matrix (red, green, blue, 4630 opacity) are used as multipliers with the existing channel values and 4631 added together according to the rows of the matrix. Matrix values are 4632 floating point and may be negative. The offset column (column 5) is 4633 purely additive and is scaled such that 0.0 to 1.0 represents the 4634 maximum quantum range (but values are not limited to this range). The 4635 math for the color translation matrix is similar to that used by Adobe 4636 Flash except that the offset is scaled to 1.0 (divide Flash offset by 4637 255 for use with GraphicsMagick) so that the results are independent 4638 of quantum depth.</font></td></tr></table> 4639 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4640 An <strong>identity</strong> matrix exists for each matrix order which 4641 results in no change to the image. The translation matrix should be 4642 based on an alteration of the identity matrix.</font></td></tr></table> 4643 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4644 Identity matrix of order 3</font></td></tr></table> 4645 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4646 1 0 0 4647 0 1 0 4648 0 0 1 4649 </pre></font></td></tr></table> 4650 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4651 which may be formatted into a convenient matrix argument similar to 4652 (comma is treated as white space):</font></td></tr></table> 4653 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4654 -recolor "1 0 0, 0 1 0, 0 0 1" 4655 </pre></font></td></tr></table> 4656 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4657 Identity matrix of order 4</font></td></tr></table> 4658 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4659 1 0 0 0 4660 0 1 0 0 4661 0 0 1 0 4662 0 0 0 1 4663 </pre></font></td></tr></table> 4664 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4665 Identity matrix of order 5. The last row is required to exist 4666 for the purpose of parsing, but is otherwise not used.</font></td></tr></table> 4667 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4668 1 0 0 0 0 4669 0 1 0 0 0 4670 0 0 1 0 0 4671 0 0 0 1 0 4672 0 0 0 0 1 4673 </pre></font></td></tr></table> 4674 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4675 As an example, an image wrongly in BGR channel order may be converted 4676 to RGB using this matrix (blue->red, red->blue):</font></td></tr></table> 4677 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4678 0 0 1 4679 0 1 0 4680 1 0 0 4681 </pre></font></td></tr></table> 4682 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4683 and an RGB image using standard Rec.709 primaries may be converted 4684 to grayscale using this matrix of standard weighting factors:</font></td></tr></table> 4685 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4686 0.2126 0.7152 0.0722 4687 0.2126 0.7152 0.0722 4688 0.2126 0.7152 0.0722 4689 </pre></font></td></tr></table> 4690 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4691 and contrast may be reduced by scaling down by 80% and adding a 10% 4692 offset:</font></td></tr></table> 4693 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4694 0.8 0.0 0.0 0.0 0.1 4695 0.0 0.8 0.0 0.0 0.1 4696 0.0 0.0 0.8 0.0 0.1 4697 0.0 0.0 0.0 0.8 0.1 4698 0.0 0.0 0.0 0.0 1.0 4699 </pre></font></td></tr></table> 4700 <table BORDER=0 WIDTH="94%"> 4701 <tr> 4702 <td width="3%"><br></td> 4703 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4704 <img SRC="images/right_triangle_option.png" 4705 ALT=">" BORDER=0 height=14 4706 width=15><b><font face="Helvetica, Arial" 4707 ><font color="#00B04F"><font size="+1"> 4708 <a name="details-red-primary"></a>-red-primary <i><x>,<y></i> 4709 </font></font></font></b></td></tr></table> 4710 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>red chromaticity primary point</td></tr></table> 4711 <table BORDER=0 WIDTH="94%"> 4712 <tr> 4713 <td width="3%"><br></td> 4714 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4715 <img SRC="images/right_triangle_option.png" 4716 ALT=">" BORDER=0 height=14 4717 width=15><b><font face="Helvetica, Arial" 4718 ><font color="#00B04F"><font size="+1"> 4719 <a name="details-region"></a>-region <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i> 4720 </font></font></font></b></td></tr></table> 4721 <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> 4722 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4723 The <em>x</em> and <em>y</em> offsets are treated in the same manner as in <strong>-crop</strong></font></td></tr></table>. 4724 <table BORDER=0 WIDTH="94%"> 4725 <tr> 4726 <td width="3%"><br></td> 4727 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4728 <img SRC="images/right_triangle_option.png" 4729 ALT=">" BORDER=0 height=14 4730 width=15><b><font face="Helvetica, Arial" 4731 ><font color="#00B04F"><font size="+1"> 4732 <a name="details-remote"></a>-remote 4733 </font></font></font></b></td></tr></table> 4734 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform a X11 remote operation</td></tr></table> 4735 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4736 The <strong>-remote</strong> command sends a command to a "gm display" or "gm 4737 animate" which is already running. The only command recognized at this 4738 time is the name of an image file to load. This capability is very 4739 useful to load new images without needing to restart GraphicsMagick 4740 (e.g. for a slide-show or to use GraphicsMagick as the display engine 4741 for a different GUI). Also see the <strong>+progress</strong> option for a way 4742 to disable progress indication for a clean look while loading new images.</font></td></tr></table> 4743 <table BORDER=0 WIDTH="94%"> 4744 <tr> 4745 <td width="3%"><br></td> 4746 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4747 <img SRC="images/right_triangle_option.png" 4748 ALT=">" BORDER=0 height=14 4749 width=15><b><font face="Helvetica, Arial" 4750 ><font color="#00B04F"><font size="+1"> 4751 <a name="details-render"></a>-render 4752 </font></font></font></b></td></tr></table> 4753 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>render vector operations</td></tr></table> 4754 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4755 Use <strong>+render</strong> to turn off rendering vector operations. This is 4756 useful when saving the result to vector formats such as MVG or SVG.</font></td></tr></table> 4757 <table BORDER=0 WIDTH="94%"> 4758 <tr> 4759 <td width="3%"><br></td> 4760 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4761 <img SRC="images/right_triangle_option.png" 4762 ALT=">" BORDER=0 height=14 4763 width=15><b><font face="Helvetica, Arial" 4764 ><font color="#00B04F"><font size="+1"> 4765 <a name="details-repage"></a>-repage <i> <width>x<height>+xoff+yoff[!]</i> 4766 </font></font></font></b></td></tr></table> 4767 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Adjust image page offsets</td></tr></table> 4768 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4769 Adjust the current image page canvas and position based on a relative 4770 page specification. This option may be used to change the location of 4771 a subframe (e.g. part of an animation) prior to composition. If the 4772 geometry specification is absolute (includes a '!'), then the offset 4773 adjustment is absolute and there is no adjustment to page width and 4774 height, otherwise the page width and height values are also adjusted 4775 based on the current image dimensions. Use <strong>+repage</strong> to set the 4776 image page offsets to default.</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-resample"></a>-resample <i><horizontal>x<vertical></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>Resample image to specified horizontal and vertical resolution</td></tr></table> 4788 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4789 Resize the image so that its rendered size remains the same as the 4790 original at the specified target resolution. Either the current image 4791 resolution units or the previously set with <strong>-units</strong> are used to 4792 interpret the argument. For example, if a 300 DPI image renders at 3 4793 inches by 2 inches on a 300 DPI device, when the image has been 4794 resampled to 72 DPI, it will render at 3 inches by 2 inches on a 72 4795 DPI device. Note that only a small number of image formats 4796 (e.g. JPEG, PNG, and TIFF) are capable of storing the image 4797 resolution. For formats which do not support an image resolution, the 4798 original resolution of the image must be specified via <strong>-density</strong> 4799 on the command line prior to specifying the resample resolution.</font></td></tr></table> 4800 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4801 Note that Photoshop stores and obtains image resolution from a 4802 proprietary embedded profile. If this profile exists in the image, 4803 then Photoshop will continue to treat the image using its former 4804 resolution, ignoring the image resolution specified in the standard 4805 file header.</font></td></tr></table> 4806 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4807 Some image formats (e.g. PNG) require use of metric or english units 4808 so even if the original image used a particular unit system, if it is 4809 saved to a different format prior to resampling, then it may be 4810 necessary to specify the desired resolution units using <strong>-units</strong> 4811 since the original units may have been lost. In other words, do not 4812 assume that the resolution units are restored if the image has been 4813 saved to a file.</font></td></tr></table> 4814 <table BORDER=0 WIDTH="94%"> 4815 <tr> 4816 <td width="3%"><br></td> 4817 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4818 <img SRC="images/right_triangle_option.png" 4819 ALT=">" BORDER=0 height=14 4820 width=15><b><font face="Helvetica, Arial" 4821 ><font color="#00B04F"><font size="+1"> 4822 <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> 4823 </font></font></font></b></td></tr></table> 4824 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image</td></tr></table> 4825 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4826 This is an alias for the <strong>-geometry</strong> option and it behaves in the 4827 same manner. If the <strong>-filter</strong> option precedes the <strong>-resize</strong> 4828 option, the specified filter is used.</font></td></tr></table> 4829 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4830 There are some exceptions:</font></td></tr></table> 4831 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4832 When used as a <em>composite</em> option, <strong>-resize</strong> conveys the 4833 preferred size of the output image, while <strong>-geometry</strong> conveys the 4834 size and placement of the <em>composite image</em> within the main 4835 image.</font></td></tr></table> 4836 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4837 When used as a <em>montage</em> option, <strong>-resize</strong> conveys the preferred 4838 size of the montage, while <strong>-geometry</strong> conveys 4839 information about the tiles.</font></td></tr></table> 4840 <table BORDER=0 WIDTH="94%"> 4841 <tr> 4842 <td width="3%"><br></td> 4843 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4844 <img SRC="images/right_triangle_option.png" 4845 ALT=">" BORDER=0 height=14 4846 width=15><b><font face="Helvetica, Arial" 4847 ><font color="#00B04F"><font size="+1"> 4848 <a name="details-roll"></a>-roll <i></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i> 4849 </font></font></font></b></td></tr></table> 4850 <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> 4851 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4852 See <strong>-geometry</strong> for details the geometry specification. The 4853 <em>x</em> and <em>y</em> offsets are not affected by the <strong>-gravity</strong> 4854 option.</font></td></tr></table> 4855 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4856 A negative <em>x</em> offset rolls the image left-to-right. A negative 4857 <em>y</em> offset rolls the image top-to-bottom.</font></td></tr></table> 4858 <table BORDER=0 WIDTH="94%"> 4859 <tr> 4860 <td width="3%"><br></td> 4861 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4862 <img SRC="images/right_triangle_option.png" 4863 ALT=">" BORDER=0 height=14 4864 width=15><b><font face="Helvetica, Arial" 4865 ><font color="#00B04F"><font size="+1"> 4866 <a name="details-rotate"></a>-rotate <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i> 4867 </font></font></font></b></td></tr></table> 4868 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>rotate the image</td></tr></table> 4869 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4870 Positive angles rotate the image in a clockwise direction while 4871 negative angles rotate counter-clockwise.</font></td></tr></table> 4872 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4873 Use <tt>></tt> to rotate the image only if its width exceeds the 4874 height. <tt><</tt> rotates the image <em>only</em> if its width is less 4875 than the height. For example, if you specify <tt>-rotate "-90>"</tt> 4876 and the image size is 480x640, the image is not rotated. However, if 4877 the image is 640x480, it is rotated by -90 degrees. If you use 4878 <tt>></tt> or <tt><</tt>, enclose it in quotation marks to prevent it 4879 from being misinterpreted as a file redirection.</font></td></tr></table> 4880 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4881 Empty triangles left over from rotating the image are filled with the 4882 color defined as <strong>background</strong> (class <strong>backgroundColor</strong>). 4883 The color is specified using the format described under the 4884 <strong>-fill</strong> option.</font></td></tr></table> 4885 <table BORDER=0 WIDTH="94%"> 4886 <tr> 4887 <td width="3%"><br></td> 4888 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4889 <img SRC="images/right_triangle_option.png" 4890 ALT=">" BORDER=0 height=14 4891 width=15><b><font face="Helvetica, Arial" 4892 ><font color="#00B04F"><font size="+1"> 4893 <a name="details-sample"></a>-sample <i><geometry></i> 4894 </font></font></font></b></td></tr></table> 4895 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>scale image using pixel sampling</td></tr></table> 4896 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4897 See <strong>-geometry</strong> for details about 4898 the geometry specification. 4899 <strong>-sample</strong> ignores the <strong>-filter</strong> selection if the <strong>-filter</strong> option 4900 is present. Offsets, if present in the geometry string, are ignored, and 4901 the <strong>-gravity</strong> option has no effect.</font></td></tr></table> 4902 <table BORDER=0 WIDTH="94%"> 4903 <tr> 4904 <td width="3%"><br></td> 4905 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4906 <img SRC="images/right_triangle_option.png" 4907 ALT=">" BORDER=0 height=14 4908 width=15><b><font face="Helvetica, Arial" 4909 ><font color="#00B04F"><font size="+1"> 4910 <a name="details-sampling-factor"></a>-sampling-factor <i><horizontal_factor>x<vertical_factor></i> 4911 </font></font></font></b></td></tr></table> 4912 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chroma subsampling factors</td></tr></table> 4913 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4914 This option specifies the sampling factors to be used by the DPX, JPEG, 4915 MPEG, or YUV encoders for chroma downsampling. The sampling factor must 4916 be specified while reading the raw YUV format since it is not preserved 4917 in the file header.</font></td></tr></table> 4918 <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 4919 be used to specify the sampling factors. "4:2:2" is equivalent to a 4920 specification of "2x1"</font></td></tr></table> 4921 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4922 The JPEG decoder obtains the original sampling factors (and quality 4923 settings) when a JPEG file is read. To re-use the original sampling 4924 factors (and quality setting) when JPEG is output, use the <tt>-define 4925 jpeg:preserve-settings</tt> flag.</font></td></tr></table> 4926 <table BORDER=0 WIDTH="94%"> 4927 <tr> 4928 <td width="3%"><br></td> 4929 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4930 <img SRC="images/right_triangle_option.png" 4931 ALT=">" BORDER=0 height=14 4932 width=15><b><font face="Helvetica, Arial" 4933 ><font color="#00B04F"><font size="+1"> 4934 <a name="details-scale"></a>-scale <i><geometry></i> 4935 </font></font></font></b></td></tr></table> 4936 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>scale the image.</td></tr></table> 4937 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4938 See <strong>-geometry</strong> for details about 4939 the geometry specification. <strong>-scale</strong> uses a simpler, faster algorithm, 4940 and it ignores the <strong>-filter</strong> selection if the <strong>-filter</strong> option 4941 is present. Offsets, if present in the geometry string, are ignored, and 4942 the <strong>-gravity</strong> option has no effect.</font></td></tr></table> 4943 <table BORDER=0 WIDTH="94%"> 4944 <tr> 4945 <td width="3%"><br></td> 4946 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4947 <img SRC="images/right_triangle_option.png" 4948 ALT=">" BORDER=0 height=14 4949 width=15><b><font face="Helvetica, Arial" 4950 ><font color="#00B04F"><font size="+1"> 4951 <a name="details-scene"></a>-scene <i><value></i> 4952 </font></font></font></b></td></tr></table> 4953 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set scene number</td></tr></table> 4954 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4955 This option sets the scene number of an image or the first image in 4956 an image sequence.</font></td></tr></table> 4957 <table BORDER=0 WIDTH="94%"> 4958 <tr> 4959 <td width="3%"><br></td> 4960 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4961 <img SRC="images/right_triangle_option.png" 4962 ALT=">" BORDER=0 height=14 4963 width=15><b><font face="Helvetica, Arial" 4964 ><font color="#00B04F"><font size="+1"> 4965 <a name="details-scenes"></a>-scenes <i><value-value></i> 4966 </font></font></font></b></td></tr></table> 4967 <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> 4968 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4969 Each image in the range is read 4970 with the filename followed by a period (<strong>.</strong>) and the decimal scene 4971 number. You 4972 can change this behavior by embedding a <strong>%d, %0Nd, %o, %0No, %x, or %0Nx 4973 printf</strong> format specification in the file name. For example,</font></td></tr></table> 4974 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4975 gm montage -scenes 5-7 image.miff montage.miff 4976 </pre></font></td></tr></table> 4977 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4978 makes a montage of files image.miff.5, image.miff.6, and image.miff.7, and</font></td></tr></table> 4979 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 4980 gm animate -scenes 0-12 image%02d.miff 4981 </pre></font></td></tr></table> 4982 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4983 animates files image00.miff, image01.miff, through image12.miff.</font></td></tr></table> 4984 <table BORDER=0 WIDTH="94%"> 4985 <tr> 4986 <td width="3%"><br></td> 4987 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 4988 <img SRC="images/right_triangle_option.png" 4989 ALT=">" BORDER=0 height=14 4990 width=15><b><font face="Helvetica, Arial" 4991 ><font color="#00B04F"><font size="+1"> 4992 <a name="details-screen"></a>-screen 4993 </font></font></font></b></td></tr></table> 4994 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the screen to capture</td></tr></table> 4995 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 4996 This option indicates that the GetImage request used to obtain the image 4997 should be done on the root window, rather than directly on the specified 4998 window. In this way, you can obtain pieces of other windows that overlap 4999 the specified window, and more importantly, you can capture menus or other 5000 popups that are independent windows but appear over the specified window.</font></td></tr></table> 5001 <table BORDER=0 WIDTH="94%"> 5002 <tr> 5003 <td width="3%"><br></td> 5004 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5005 <img SRC="images/right_triangle_option.png" 5006 ALT=">" BORDER=0 height=14 5007 width=15><b><font face="Helvetica, Arial" 5008 ><font color="#00B04F"><font size="+1"> 5009 <a name="details-set"></a>-set <i><attribute> <value></i> 5010 </font></font></font></b></td></tr></table> 5011 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set an image attribute</td></tr></table> 5012 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5013 Set a named image attribute. The attribute is set on the current 5014 (previously specified on command line) image.</font></td></tr></table> 5015 <table BORDER=0 WIDTH="94%"> 5016 <tr> 5017 <td width="3%"><br></td> 5018 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5019 <img SRC="images/right_triangle_option.png" 5020 ALT=">" BORDER=0 height=14 5021 width=15><b><font face="Helvetica, Arial" 5022 ><font color="#00B04F"><font size="+1"> 5023 <a name="details+set"></a>+set <i><attribute></i> 5024 </font></font></font></b></td></tr></table> 5025 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>unset an image attribute</td></tr></table> 5026 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5027 Unset a named image attribute. The attribute is removed from the current 5028 (previously specified on command line) image.</font></td></tr></table> 5029 <table BORDER=0 WIDTH="94%"> 5030 <tr> 5031 <td width="3%"><br></td> 5032 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5033 <img SRC="images/right_triangle_option.png" 5034 ALT=">" BORDER=0 height=14 5035 width=15><b><font face="Helvetica, Arial" 5036 ><font color="#00B04F"><font size="+1"> 5037 <a name="details-segment"></a>-segment <i><cluster threshold>x<smoothing threshold></i> 5038 </font></font></font></b></td></tr></table> 5039 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>segment an image</td></tr></table> 5040 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5041 Segment an image by analyzing the histograms of the color components and 5042 identifying units that are homogeneous with the fuzzy c-means technique.</font></td></tr></table> 5043 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5044 Segmentation is a very useful fast and and approximate color quantization 5045 algorithm for scanned printed pages or scanned cartoons. It may also be 5046 used as a special effect. Specify <em>cluster threshold</em> as the minimum 5047 percentage of total pixels in a cluster before it is considered valid. 5048 For huge images containing small detail, this may need to be a tiny 5049 fraction of a percent (e.g. 0.015) so that important detail is not lost. 5050 <em>Smoothing threshold</em> eliminates noise in the second derivative of 5051 the histogram. As the value is increased, you can expect a smoother 5052 second derivative. The default is 1.5. Add the <em>-verbose</em> option to 5053 see a dump of cluster statistics given the parameters used. The 5054 statistics may be used as a guide to help fine tune the options.</font></td></tr></table> 5055 <table BORDER=0 WIDTH="94%"> 5056 <tr> 5057 <td width="3%"><br></td> 5058 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5059 <img SRC="images/right_triangle_option.png" 5060 ALT=">" BORDER=0 height=14 5061 width=15><b><font face="Helvetica, Arial" 5062 ><font color="#00B04F"><font size="+1"> 5063 <a name="details-shade"></a>-shade <i><azimuth>x<elevation></i> 5064 </font></font></font></b></td></tr></table> 5065 <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> 5066 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5067 Specify <em>azimuth</em> and <em>elevation</em> as the position of the light 5068 source. Use <strong>+shade</strong> to return the shading results as a grayscale 5069 image.</font></td></tr></table> 5070 <table BORDER=0 WIDTH="94%"> 5071 <tr> 5072 <td width="3%"><br></td> 5073 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5074 <img SRC="images/right_triangle_option.png" 5075 ALT=">" BORDER=0 height=14 5076 width=15><b><font face="Helvetica, Arial" 5077 ><font color="#00B04F"><font size="+1"> 5078 -shadow <i><radius></i>{<i>x<sigma></i>}<i></i> 5079 </font></font></font></b></td></tr></table> 5080 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shadow the montage</td></tr></table> 5081 <table BORDER=0 WIDTH="94%"> 5082 <tr> 5083 <td width="3%"><br></td> 5084 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5085 <img SRC="images/right_triangle_option.png" 5086 ALT=">" BORDER=0 height=14 5087 width=15><b><font face="Helvetica, Arial" 5088 ><font color="#00B04F"><font size="+1"> 5089 <a name="details-shared-memory"></a>-shared-memory 5090 </font></font></font></b></td></tr></table> 5091 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use shared memory</td></tr></table> 5092 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5093 This option specifies whether the utility should attempt to use shared 5094 memory for pixmaps. GraphicsMagick must be compiled with shared 5095 memory support, and the display must support the <em>MIT-SHM</em> 5096 extension. Otherwise, this option is ignored. The default is 5097 <strong>True</strong>.</font></td></tr></table> 5098 <table BORDER=0 WIDTH="94%"> 5099 <tr> 5100 <td width="3%"><br></td> 5101 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5102 <img SRC="images/right_triangle_option.png" 5103 ALT=">" BORDER=0 height=14 5104 width=15><b><font face="Helvetica, Arial" 5105 ><font color="#00B04F"><font size="+1"> 5106 <a name="details-sharpen"></a>-sharpen <i><radius></i>{<i>x<sigma></i>}<i></i> 5107 </font></font></font></b></td></tr></table> 5108 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image</td></tr></table> 5109 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5110 Use a Gaussian operator of the given radius and standard deviation 5111 (sigma).</font></td></tr></table> 5112 <table BORDER=0 WIDTH="94%"> 5113 <tr> 5114 <td width="3%"><br></td> 5115 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5116 <img SRC="images/right_triangle_option.png" 5117 ALT=">" BORDER=0 height=14 5118 width=15><b><font face="Helvetica, Arial" 5119 ><font color="#00B04F"><font size="+1"> 5120 <a name="details-shave"></a>-shave <i><width>x<height></i>{<i>%</i>}<i></i> 5121 </font></font></font></b></td></tr></table> 5122 <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> 5123 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5124 Specify the width of the region to be removed from both 5125 sides of the image and the height of the regions to be removed from 5126 top and bottom.</font></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-shear"></a>-shear <i><x degrees>x<y degrees></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>shear the image along the X or Y axis</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 the specified positive or negative shear angle.</font></td></tr></table> 5140 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5141 Shearing slides one edge of an image along the X or Y axis, creating a 5142 parallelogram. An X direction shear slides an edge along the X axis, 5143 while a Y direction shear slides an edge along the Y axis. The amount 5144 of the shear is controlled by a shear angle. For X direction shears, 5145 <em>x degrees</em> is measured relative to the Y axis, and similarly, 5146 for Y direction shears <em>y degrees</em> is measured relative to the X 5147 axis.</font></td></tr></table> 5148 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5149 Empty triangles left over from shearing the image are filled with the 5150 color defined as <strong>background</strong> (class <strong>backgroundColor</strong>). 5151 The color is specified using the format described under the 5152 <strong>-fill</strong> option.</font></td></tr></table> 5153 <table BORDER=0 WIDTH="94%"> 5154 <tr> 5155 <td width="3%"><br></td> 5156 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5157 <img SRC="images/right_triangle_option.png" 5158 ALT=">" BORDER=0 height=14 5159 width=15><b><font face="Helvetica, Arial" 5160 ><font color="#00B04F"><font size="+1"> 5161 -silent 5162 </font></font></font></b></td></tr></table> 5163 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>operate silently</td></tr></table> 5164 <table BORDER=0 WIDTH="94%"> 5165 <tr> 5166 <td width="3%"><br></td> 5167 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5168 <img SRC="images/right_triangle_option.png" 5169 ALT=">" BORDER=0 height=14 5170 width=15><b><font face="Helvetica, Arial" 5171 ><font color="#00B04F"><font size="+1"> 5172 <a name="details-size"></a>-size <i><width>x<height></i>{<i>+offset</i>}<i></i> 5173 </font></font></font></b></td></tr></table> 5174 <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> 5175 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5176 Use this option to specify the width and height of raw images whose 5177 dimensions are unknown such as <strong>GRAY</strong>, <strong>RGB</strong>, or 5178 <strong>CMYK</strong>. In addition to width and height, use <strong>-size</strong> with an 5179 offset to skip any header information in the image or tell the number 5180 of colors in a <strong>MAP</strong> image file, (e.g. -size 640x512+256).</font></td></tr></table> 5181 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5182 For Photo CD images, choose from these sizes:</font></td></tr></table> 5183 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 5184 192x128 5185 384x256 5186 768x512 5187 1536x1024 5188 3072x2048 5189 </pre></font></td></tr></table> 5190 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5191 Finally, use this option to choose a particular resolution layer of a JBIG 5192 or JPEG image (e.g. -size 1024x768).</font></td></tr></table> 5193 <table BORDER=0 WIDTH="94%"> 5194 <tr> 5195 <td width="3%"><br></td> 5196 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5197 <img SRC="images/right_triangle_option.png" 5198 ALT=">" BORDER=0 height=14 5199 width=15><b><font face="Helvetica, Arial" 5200 ><font color="#00B04F"><font size="+1"> 5201 <a name="details-snaps"></a>-snaps <i><value></i> 5202 </font></font></font></b></td></tr></table> 5203 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>number of screen snapshots</td></tr></table> 5204 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5205 Use this option 5206 to grab more than one image from the X server screen, to create 5207 an animation sequence.</font></td></tr></table> 5208 <table BORDER=0 WIDTH="94%"> 5209 <tr> 5210 <td width="3%"><br></td> 5211 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5212 <img SRC="images/right_triangle_option.png" 5213 ALT=">" BORDER=0 height=14 5214 width=15><b><font face="Helvetica, Arial" 5215 ><font color="#00B04F"><font size="+1"> 5216 <a name="details-solarize"></a>-solarize <i><factor></i> 5217 </font></font></font></b></td></tr></table> 5218 <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> 5219 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5220 Specify <em>factor</em> as the 5221 percent threshold of the intensity (0 - 99.9%).</font></td></tr></table> 5222 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5223 This option produces a <em>solarization</em> effect seen when exposing a 5224 photographic film to light during the development process.</font></td></tr></table> 5225 <table BORDER=0 WIDTH="94%"> 5226 <tr> 5227 <td width="3%"><br></td> 5228 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5229 <img SRC="images/right_triangle_option.png" 5230 ALT=">" BORDER=0 height=14 5231 width=15><b><font face="Helvetica, Arial" 5232 ><font color="#00B04F"><font size="+1"> 5233 <a name="details-spread"></a>-spread <i><amount></i> 5234 </font></font></font></b></td></tr></table> 5235 <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> 5236 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5237 <em>Amount</em> defines the size of the neighborhood around each pixel to 5238 choose a candidate pixel to swap.</font></td></tr></table> 5239 <table BORDER=0 WIDTH="94%"> 5240 <tr> 5241 <td width="3%"><br></td> 5242 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5243 <img SRC="images/right_triangle_option.png" 5244 ALT=">" BORDER=0 height=14 5245 width=15><b><font face="Helvetica, Arial" 5246 ><font color="#00B04F"><font size="+1"> 5247 <a name="details-stegano"></a>-stegano <i><offset></i> 5248 </font></font></font></b></td></tr></table> 5249 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>hide watermark within an image</td></tr></table> 5250 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5251 Use an offset to start the image hiding some number of pixels from the 5252 beginning of the image. Note this offset and the image size. You will 5253 need this information to recover the steganographic image 5254 (e.g. display -size 320x256+35 stegano:image.png).</font></td></tr></table> 5255 <table BORDER=0 WIDTH="94%"> 5256 <tr> 5257 <td width="3%"><br></td> 5258 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5259 <img SRC="images/right_triangle_option.png" 5260 ALT=">" BORDER=0 height=14 5261 width=15><b><font face="Helvetica, Arial" 5262 ><font color="#00B04F"><font size="+1"> 5263 <a name="details-stereo"></a>-stereo 5264 </font></font></font></b></td></tr></table> 5265 <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> 5266 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5267 The left side of the stereo pair is saved as the red channel of the output 5268 image. The right side is saved as the green channel. Red-green stereo 5269 glasses are required to properly view the stereo image.</font></td></tr></table> 5270 <table BORDER=0 WIDTH="94%"> 5271 <tr> 5272 <td width="3%"><br></td> 5273 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5274 <img SRC="images/right_triangle_option.png" 5275 ALT=">" BORDER=0 height=14 5276 width=15><b><font face="Helvetica, Arial" 5277 ><font color="#00B04F"><font size="+1"> 5278 <a name="details-strip"></a>-strip 5279 </font></font></font></b></td></tr></table> 5280 <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> 5281 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5282 All embedded profiles and text attributes are stripped from the image. 5283 This is useful for images used for the web, or when output files need 5284 to be as small as possible</font></td></tr></table> 5285 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5286 Be careful not to use this option to remove author, copyright, and 5287 license information that you are required to retain when redistributing 5288 an image.</font></td></tr></table> 5289 <table BORDER=0 WIDTH="94%"> 5290 <tr> 5291 <td width="3%"><br></td> 5292 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5293 <img SRC="images/right_triangle_option.png" 5294 ALT=">" BORDER=0 height=14 5295 width=15><b><font face="Helvetica, Arial" 5296 ><font color="#00B04F"><font size="+1"> 5297 <a name="details-stroke"></a>-stroke <i><color></i> 5298 </font></font></font></b></td></tr></table> 5299 <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> 5300 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5301 The color is specified using the format described under the <strong>-fill</strong> 5302 option.</font></td></tr></table> 5303 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5304 See <strong>-draw</strong> for further details.</font></td></tr></table> 5305 <table BORDER=0 WIDTH="94%"> 5306 <tr> 5307 <td width="3%"><br></td> 5308 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5309 <img SRC="images/right_triangle_option.png" 5310 ALT=">" BORDER=0 height=14 5311 width=15><b><font face="Helvetica, Arial" 5312 ><font color="#00B04F"><font size="+1"> 5313 <a name="details-strokewidth"></a>-strokewidth <i><value></i> 5314 </font></font></font></b></td></tr></table> 5315 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set the stroke width</td></tr></table> 5316 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5317 See <strong>-draw</strong> for further details.</font></td></tr></table> 5318 <table BORDER=0 WIDTH="94%"> 5319 <tr> 5320 <td width="3%"><br></td> 5321 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5322 <img SRC="images/right_triangle_option.png" 5323 ALT=">" BORDER=0 height=14 5324 width=15><b><font face="Helvetica, Arial" 5325 ><font color="#00B04F"><font size="+1"> 5326 <a name="details-swirl"></a>-swirl <i><degrees></i> 5327 </font></font></font></b></td></tr></table> 5328 <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> 5329 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5330 <em>Degrees</em> defines the tightness of the swirl.</font></td></tr></table> 5331 <table BORDER=0 WIDTH="94%"> 5332 <tr> 5333 <td width="3%"><br></td> 5334 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5335 <img SRC="images/right_triangle_option.png" 5336 ALT=">" BORDER=0 height=14 5337 width=15><b><font face="Helvetica, Arial" 5338 ><font color="#00B04F"><font size="+1"> 5339 <a name="details-text-font"></a>-text-font <i><name></i> 5340 </font></font></font></b></td></tr></table> 5341 <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> 5342 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5343 Specifies the name of the preferred font to use in fixed (typewriter style) 5344 formatted text. The default is 14 point <em>Courier</em>.</font></td></tr></table> 5345 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5346 You can tag a font to specify whether it is a PostScript, TrueType, or 5347 X11 font. For example, <tt>Courier.ttf</tt> is a TrueType font 5348 and <tt>x:fixed</tt> is X11.</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 -texture <i><filename></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>name of texture to tile onto the image background</td></tr></table> 5360 <table BORDER=0 WIDTH="94%"> 5361 <tr> 5362 <td width="3%"><br></td> 5363 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5364 <img SRC="images/right_triangle_option.png" 5365 ALT=">" BORDER=0 height=14 5366 width=15><b><font face="Helvetica, Arial" 5367 ><font color="#00B04F"><font size="+1"> 5368 <a name="details-threshold"></a>-threshold <i><value></i>{<i>%</i>}<i></i> 5369 </font></font></font></b></td></tr></table> 5370 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>threshold the image</td></tr></table> 5371 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5372 Modify the image such that any pixel sample with an intensity value 5373 greater than the threshold is assigned the maximum intensity (white), or 5374 otherwise is assigned the minimum intensity (black). If a percent prefix 5375 is applied, then the threshold is a percentage of the available range.</font></td></tr></table> 5376 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5377 To efficiently create a black and white image from a color image, use</font></td></tr></table> 5378 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 5379 gm convert -threshold 50% in.png out.png 5380 </pre></font></td></tr></table> 5381 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5382 The optimum threshold value depends on the nature of the image.</font></td></tr></table> 5383 <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> 5384 subcommand with it's <strong>Threshold</strong>, <strong>Threshold-White</strong>, or 5385 <strong>Threshold-Black</strong> options.</font></td></tr></table> 5386 <table BORDER=0 WIDTH="94%"> 5387 <tr> 5388 <td width="3%"><br></td> 5389 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5390 <img SRC="images/right_triangle_option.png" 5391 ALT=">" BORDER=0 height=14 5392 width=15><b><font face="Helvetica, Arial" 5393 ><font color="#00B04F"><font size="+1"> 5394 <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> 5395 </font></font></font></b></td></tr></table> 5396 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image (quickly)</td></tr></table> 5397 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5398 The <strong>-thumbnail</strong> command resizes the image as quickly as 5399 possible, with more concern for speed than resulting image quality. 5400 Regardless, resulting image quality should be acceptable for many 5401 uses. It is primarily intended to be used to generate smaller 5402 versions of the image, but may also be used to enlarge the image. The 5403 <strong>-thumbnail</strong> <strong>geometry</strong> argument observes the same syntax 5404 and rules as it does for <strong>-resize</strong>.</font></td></tr></table> 5405 <table BORDER=0 WIDTH="94%"> 5406 <tr> 5407 <td width="3%"><br></td> 5408 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5409 <img SRC="images/right_triangle_option.png" 5410 ALT=">" BORDER=0 height=14 5411 width=15><b><font face="Helvetica, Arial" 5412 ><font color="#00B04F"><font size="+1"> 5413 -tile <i><filename></i> 5414 </font></font></font></b></td></tr></table> 5415 <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> 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 -tile <i><geometry></i> 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>layout of images [<em>montage</em>]</td></tr></table> 5427 <table BORDER=0 WIDTH="94%"> 5428 <tr> 5429 <td width="3%"><br></td> 5430 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5431 <img SRC="images/right_triangle_option.png" 5432 ALT=">" BORDER=0 height=14 5433 width=15><b><font face="Helvetica, Arial" 5434 ><font color="#00B04F"><font size="+1"> 5435 <a name="details-title"></a>-title <i><string></i> 5436 </font></font></font></b></td></tr></table> 5437 <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> 5438 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5439 Use this option to assign a specific title to the image. This is 5440 assigned to the image window and is typically displayed in the window 5441 title bar. Optionally you can include the image filename, type, 5442 width, height, Exif data, or other image attribute by embedding 5443 special format characters described under the <strong>-format</strong> 5444 option.</font></td></tr></table> 5445 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5446 For example,</font></td></tr></table> 5447 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 5448 -title "%m:%f %wx%h" 5449 </pre></font></td></tr></table> 5450 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5451 produces an image title of <tt>MIFF:bird.miff 512x480</tt> for an image 5452 titled <tt>bird.miff</tt> and whose width is 512 and height is 480.</font></td></tr></table> 5453 <table BORDER=0 WIDTH="94%"> 5454 <tr> 5455 <td width="3%"><br></td> 5456 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5457 <img SRC="images/right_triangle_option.png" 5458 ALT=">" BORDER=0 height=14 5459 width=15><b><font face="Helvetica, Arial" 5460 ><font color="#00B04F"><font size="+1"> 5461 <a name="details-transform"></a>-transform 5462 </font></font></font></b></td></tr></table> 5463 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image</td></tr></table> 5464 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5465 This option applies the transformation matrix from a previous 5466 <strong>-affine</strong> option.</font></td></tr></table> 5467 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 5468 gm convert -affine 2,2,-2,2,0,0 -transform bird.ppm bird.jpg 5469 </pre></font></td></tr></table> 5470 <table BORDER=0 WIDTH="94%"> 5471 <tr> 5472 <td width="3%"><br></td> 5473 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5474 <img SRC="images/right_triangle_option.png" 5475 ALT=">" BORDER=0 height=14 5476 width=15><b><font face="Helvetica, Arial" 5477 ><font color="#00B04F"><font size="+1"> 5478 <a name="details-transparent"></a>-transparent <i><color></i> 5479 </font></font></font></b></td></tr></table> 5480 <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> 5481 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5482 The color is specified using the format described under the <strong>-fill</strong> 5483 option.</font></td></tr></table> 5484 <table BORDER=0 WIDTH="94%"> 5485 <tr> 5486 <td width="3%"><br></td> 5487 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5488 <img SRC="images/right_triangle_option.png" 5489 ALT=">" BORDER=0 height=14 5490 width=15><b><font face="Helvetica, Arial" 5491 ><font color="#00B04F"><font size="+1"> 5492 <a name="details-treedepth"></a>-treedepth <i><value></i> 5493 </font></font></font></b></td></tr></table> 5494 <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> 5495 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5496 Normally, this integer value is zero or one. A value of zero or one 5497 causes the use of an optimal tree depth for the color reduction 5498 algorithm</font></td></tr></table> 5499 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5500 An optimal depth generally allows the best representation of the source 5501 image with the fastest computational speed and the least amount of memory. 5502 However, the default depth is inappropriate for some images. To assure 5503 the best representation, try values between 2 and 8 for this parameter. 5504 Refer to 5505 <a href="quantize.html">quantize</a> for more details.</font></td></tr></table> 5506 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5507 The <strong>-colors</strong> or <strong>-monochrome</strong> option, or writing to an image 5508 format which requires color reduction, is required for this option to 5509 take effect.</font></td></tr></table> 5510 <table BORDER=0 WIDTH="94%"> 5511 <tr> 5512 <td width="3%"><br></td> 5513 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5514 <img SRC="images/right_triangle_option.png" 5515 ALT=">" BORDER=0 height=14 5516 width=15><b><font face="Helvetica, Arial" 5517 ><font color="#00B04F"><font size="+1"> 5518 <a name="details-trim"></a>-trim 5519 </font></font></font></b></td></tr></table> 5520 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table> 5521 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5522 This option removes any edges that are exactly the same color as the 5523 corner pixels. Use <strong>-fuzz</strong> to make <strong>-trim</strong> remove edges that 5524 are nearly the same color as the corner pixels.</font></td></tr></table> 5525 <table BORDER=0 WIDTH="94%"> 5526 <tr> 5527 <td width="3%"><br></td> 5528 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5529 <img SRC="images/right_triangle_option.png" 5530 ALT=">" BORDER=0 height=14 5531 width=15><b><font face="Helvetica, Arial" 5532 ><font color="#00B04F"><font size="+1"> 5533 <a name="details-type"></a>-type <i><type></i> 5534 </font></font></font></b></td></tr></table> 5535 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image type</td></tr></table> 5536 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5537 Choose from: 5538 <strong>Bilevel</strong>, <strong>Grayscale</strong>, <strong>Palette</strong>, 5539 <strong>PaletteMatte</strong>, <strong>TrueColor</strong>, <strong>TrueColorMatte</strong>, 5540 <strong>ColorSeparation</strong>, <strong>ColorSeparationMatte</strong>, or <strong>Optimize</strong>.</font></td></tr></table> 5541 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5542 Normally, when a format supports different subformats such as bilevel, 5543 grayscale, palette, truecolor, and truecolor+alpha, the encoder will try 5544 to choose a suitable subformat based on the nature of the image. The 5545 <strong>-type</strong> option may be used to tailor the output subformat. By 5546 default the output subformat is based on readily available image 5547 information and is usually similar to the input format.</font></td></tr></table> 5548 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5549 Specify <tt>-type Optimize</tt> in order to enable inspecting all pixels 5550 (if necessary) in order to find the most efficient subformat. Inspecting 5551 all of the pixels may be slow for very large images, particularly if they 5552 are stored in a disk cache. If an RGB image contains only gray pixels, 5553 then every pixel in the image must be inspected in order to decide that 5554 the image is actually grayscale!</font></td></tr></table> 5555 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5556 Sometimes a specific subformat is desired. For example, to force a JPEG 5557 image to be written in TrueColor RGB format even though only gray pixels 5558 are present, use</font></td></tr></table> 5559 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 5560 gm convert bird.pgm -type TrueColor bird.jpg 5561 </pre></font></td></tr></table> 5562 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5563 Similarly, using <tt>-type TrueColorMatte</tt> will force the encoder to 5564 write an alpha channel even though the image is opaque, if the output 5565 format supports transparency.</font></td></tr></table> 5566 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5567 Some pseudo-formats (e.g. the XC format) will respect the requested 5568 type if it occurs previously on the command line. For example, to obtain 5569 a DirectClass solid color canvas image rather than PsuedoClass, use</font></td></tr></table> 5570 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 5571 gm convert -size 640x480 -type TrueColor xc:red red.miff 5572 </pre></font></td></tr></table> 5573 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5574 Likewise, specify <strong>-type</strong> <strong>Bilevel</strong>, <strong>Grayscale</strong>, 5575 <strong>TrueColor</strong>, or <strong>TrueColorMatte</strong> prior to reading a Postscript 5576 (or PDF file) in order to influence the type of image that Ghostcript 5577 returns. Reading performance will be dramatically improved for 5578 black/white Postscript if <strong>Bilevel</strong> is specified, and will be 5579 considerably faster if <strong>Grayscale</strong> is specified.</font></td></tr></table> 5580 <table BORDER=0 WIDTH="94%"> 5581 <tr> 5582 <td width="3%"><br></td> 5583 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5584 <img SRC="images/right_triangle_option.png" 5585 ALT=">" BORDER=0 height=14 5586 width=15><b><font face="Helvetica, Arial" 5587 ><font color="#00B04F"><font size="+1"> 5588 <a name="details-update"></a>-update <i><seconds></i> 5589 </font></font></font></b></td></tr></table> 5590 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td> 5591 detect when image file is modified and redisplay.</td></tr></table> 5592 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5593 Suppose that while you are displaying an image the file that is currently 5594 displayed is over-written. 5595 <strong>display</strong> will automatically detect that 5596 the input file has been changed and update the displayed image accordingly.</font></td></tr></table> 5597 <table BORDER=0 WIDTH="94%"> 5598 <tr> 5599 <td width="3%"><br></td> 5600 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5601 <img SRC="images/right_triangle_option.png" 5602 ALT=">" BORDER=0 height=14 5603 width=15><b><font face="Helvetica, Arial" 5604 ><font color="#00B04F"><font size="+1"> 5605 <a name="details-units"></a>-units <i><type></i> 5606 </font></font></font></b></td></tr></table> 5607 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the units of image resolution</td></tr></table> 5608 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5609 Choose from: <strong>Undefined</strong>, <strong>PixelsPerInch</strong>, or 5610 <strong>PixelsPerCentimeter</strong>. This option is normally used in conjunction 5611 with the <strong>-density</strong> option.</font></td></tr></table> 5612 <table BORDER=0 WIDTH="94%"> 5613 <tr> 5614 <td width="3%"><br></td> 5615 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5616 <img SRC="images/right_triangle_option.png" 5617 ALT=">" BORDER=0 height=14 5618 width=15><b><font face="Helvetica, Arial" 5619 ><font color="#00B04F"><font size="+1"> 5620 <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> 5621 </font></font></font></b></td></tr></table> 5622 <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> 5623 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5624 The <strong>-unsharp</strong> option sharpens an image. The image is convolved 5625 with a Gaussian operator of the given radius and standard deviation 5626 (sigma). For reasonable results, radius should be larger than sigma. Use 5627 a radius of 0 to have the method select a suitable radius.</font></td></tr></table> 5628 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5629 The parameters are:</font></td></tr></table> 5630 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5631 <dl> 5632 <dt>radius</dt> 5633 <dd> 5634 The radius of the Gaussian, in pixels, not counting the center pixel (default 0). 5635 </dd> 5636 <dt>sigma</dt> 5637 <dd> 5638 The standard deviation of the Gaussian, in pixels (default 1.0). 5639 </dd> 5640 <dt>amount</dt> 5641 <dd> 5642 The percentage of the difference between the original and the blur image that 5643 is added back into the original (default 1.0). 5644 </dd> 5645 <dt>threshold</dt> 5646 <dd> 5647 The threshold, as a fraction of MaxRGB, needed to apply the difference 5648 amount (default 0.05). 5649 </dd> 5650 </dl> 5651 </font></td></tr></table> 5652 <table BORDER=0 WIDTH="94%"> 5653 <tr> 5654 <td width="3%"><br></td> 5655 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5656 <img SRC="images/right_triangle_option.png" 5657 ALT=">" BORDER=0 height=14 5658 width=15><b><font face="Helvetica, Arial" 5659 ><font color="#00B04F"><font size="+1"> 5660 -use-pixmap 5661 </font></font></font></b></td></tr></table> 5662 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use the pixmap</td></tr></table> 5663 <table BORDER=0 WIDTH="94%"> 5664 <tr> 5665 <td width="3%"><br></td> 5666 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5667 <img SRC="images/right_triangle_option.png" 5668 ALT=">" BORDER=0 height=14 5669 width=15><b><font face="Helvetica, Arial" 5670 ><font color="#00B04F"><font size="+1"> 5671 <a name="details-verbose"></a>-verbose 5672 </font></font></font></b></td></tr></table> 5673 <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> 5674 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5675 This information is printed: image scene number; image name; image size; 5676 the image class (<em>DirectClass</em> or <em>PseudoClass</em>); the total 5677 number of unique colors; and the number of seconds to read and transform 5678 the image. If the image is <em>DirectClass</em>, the total number of unique 5679 colors is not displayed unless <strong>-verbose</strong> is specified twice since 5680 it may take quite a long time to compute, particularly for deep images. 5681 If the image is <em>PseudoClass</em> then its pixels are defined by indexes 5682 into a colormap. If the image is <em>DirectClass</em> then each pixel 5683 includes a complete and independent color specification.</font></td></tr></table> 5684 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5685 If <strong>-colors</strong> is also specified, the total unique colors in the image 5686 and color reduction error values are printed. Refer to <a href="quantize.html">quantize</a> 5687 for a description of these values.</font></td></tr></table> 5688 <table BORDER=0 WIDTH="94%"> 5689 <tr> 5690 <td width="3%"><br></td> 5691 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5692 <img SRC="images/right_triangle_option.png" 5693 ALT=">" BORDER=0 height=14 5694 width=15><b><font face="Helvetica, Arial" 5695 ><font color="#00B04F"><font size="+1"> 5696 <a name="details-version"></a>-version 5697 </font></font></font></b></td></tr></table> 5698 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table> 5699 <table BORDER=0 WIDTH="94%"> 5700 <tr> 5701 <td width="3%"><br></td> 5702 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5703 <img SRC="images/right_triangle_option.png" 5704 ALT=">" BORDER=0 height=14 5705 width=15><b><font face="Helvetica, Arial" 5706 ><font color="#00B04F"><font size="+1"> 5707 -view <i><string></i> 5708 </font></font></font></b></td></tr></table> 5709 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>FlashPix viewing parameters</td></tr></table> 5710 <table BORDER=0 WIDTH="94%"> 5711 <tr> 5712 <td width="3%"><br></td> 5713 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5714 <img SRC="images/right_triangle_option.png" 5715 ALT=">" BORDER=0 height=14 5716 width=15><b><font face="Helvetica, Arial" 5717 ><font color="#00B04F"><font size="+1"> 5718 <a name="details-virtual-pixel"></a>-virtual-pixel <i><method></i> 5719 </font></font></font></b></td></tr></table> 5720 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify contents of "virtual pixels"</td></tr></table> 5721 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5722 This option 5723 defines "virtual pixels" for use in operations that can access pixels outside 5724 the boundaries of an image.</font></td></tr></table> 5725 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5726 Choose from these methods:</font></td></tr></table> 5727 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5728 <dl> 5729 <dt>Constant</dt> 5730 <dd> 5731 Use the image background color. 5732 </dd> 5733 <dt>Edge</dt> 5734 <dd> 5735 Extend the edge pixel toward infinity (default). 5736 </dd> 5737 <dt>Mirror</dt> 5738 <dd> 5739 Mirror the image. 5740 </dd> 5741 <dt>Tile</dt> 5742 <dd> 5743 Tile the image. 5744 </dd> 5745 </dl> 5746 </font></td></tr></table> 5747 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5748 This option affects operations that use 5749 virtual pixels such as <strong>-blur</strong>, <strong>-sharpen</strong>, <strong>-wave</strong>, etc.</font></td></tr></table> 5750 <table BORDER=0 WIDTH="94%"> 5751 <tr> 5752 <td width="3%"><br></td> 5753 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5754 <img SRC="images/right_triangle_option.png" 5755 ALT=">" BORDER=0 height=14 5756 width=15><b><font face="Helvetica, Arial" 5757 ><font color="#00B04F"><font size="+1"> 5758 <a name="details-visual"></a>-visual <i><type></i> 5759 </font></font></font></b></td></tr></table> 5760 <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> 5761 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5762 Choose from these visual classes:</font></td></tr></table> 5763 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 5764 StaticGray 5765 GrayScale 5766 StaticColor 5767 PseudoColor 5768 TrueColor 5769 DirectColor 5770 default 5771 visual id 5772 </pre></font></td></tr></table> 5773 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5774 The X server must support the visual you choose, otherwise an error occurs. 5775 If a visual is not specified, the visual class that can display the most 5776 simultaneous colors on the default screen is chosen.</font></td></tr></table> 5777 <table BORDER=0 WIDTH="94%"> 5778 <tr> 5779 <td width="3%"><br></td> 5780 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5781 <img SRC="images/right_triangle_option.png" 5782 ALT=">" BORDER=0 height=14 5783 width=15><b><font face="Helvetica, Arial" 5784 ><font color="#00B04F"><font size="+1"> 5785 -watermark <i><brightness>x<saturation></i> 5786 </font></font></font></b></td></tr></table> 5787 <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> 5788 <table BORDER=0 WIDTH="94%"> 5789 <tr> 5790 <td width="3%"><br></td> 5791 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5792 <img SRC="images/right_triangle_option.png" 5793 ALT=">" BORDER=0 height=14 5794 width=15><b><font face="Helvetica, Arial" 5795 ><font color="#00B04F"><font size="+1"> 5796 <a name="details-wave"></a>-wave <i><amplitude>x<wavelength></i> 5797 </font></font></font></b></td></tr></table> 5798 <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> 5799 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5800 Specify <em>amplitude</em> and <em>wavelength</em> 5801 of the wave.</font></td></tr></table> 5802 <table BORDER=0 WIDTH="94%"> 5803 <tr> 5804 <td width="3%"><br></td> 5805 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5806 <img SRC="images/right_triangle_option.png" 5807 ALT=">" BORDER=0 height=14 5808 width=15><b><font face="Helvetica, Arial" 5809 ><font color="#00B04F"><font size="+1"> 5810 <a name="details-white-point"></a>-white-point <i><x>,<y></i> 5811 </font></font></font></b></td></tr></table> 5812 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chromaticity white point</td></tr></table> 5813 <table BORDER=0 WIDTH="94%"> 5814 <tr> 5815 <td width="3%"><br></td> 5816 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5817 <img SRC="images/right_triangle_option.png" 5818 ALT=">" BORDER=0 height=14 5819 width=15><b><font face="Helvetica, Arial" 5820 ><font color="#00B04F"><font size="+1"> 5821 <a name="details-white-threshold"></a>-white-threshold <i>red[,green][,blue][,opacity]</i> 5822 </font></font></font></b></td></tr></table> 5823 <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> 5824 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5825 Use <strong>-white-threshold</strong> to set pixels with values above the specified 5826 threshold to maximum value (white). If only one value is supplied, or the 5827 red, green, and blue values are identical, then intensity thresholding is 5828 used. If the color threshold values are not identical then channel-based 5829 thresholding is used, and color distortion will occur. Specify a negative 5830 value (e.g. -1) if you want a channel to be ignored but you do want to 5831 threshold a channel later in the list. If a percent (%) symbol is 5832 appended, then the values are treated as a percentage of maximum 5833 range.</font></td></tr></table> 5834 <table BORDER=0 WIDTH="94%"> 5835 <tr> 5836 <td width="3%"><br></td> 5837 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5838 <img SRC="images/right_triangle_option.png" 5839 ALT=">" BORDER=0 height=14 5840 width=15><b><font face="Helvetica, Arial" 5841 ><font color="#00B04F"><font size="+1"> 5842 <a name="details-window"></a>-window <i><id></i> 5843 </font></font></font></b></td></tr></table> 5844 <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> 5845 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5846 <em>id</em> can be a window id or name. Specify <strong>root</strong> to 5847 select X's root window as the target window.</font></td></tr></table> 5848 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5849 By default the image is tiled onto the background of the target 5850 window. If <strong>backdrop</strong> or <strong>-geometry</strong> are 5851 specified, the image is surrounded by the background color. Refer to 5852 <strong>X RESOURCES</strong> for details.</font></td></tr></table> 5853 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5854 The image will not display on the root window if the image has more 5855 unique colors than the target window colormap allows. Use 5856 <strong>-colors</strong> to reduce the number of colors.</font></td></tr></table> 5857 <table BORDER=0 WIDTH="94%"> 5858 <tr> 5859 <td width="3%"><br></td> 5860 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5861 <img SRC="images/right_triangle_option.png" 5862 ALT=">" BORDER=0 height=14 5863 width=15><b><font face="Helvetica, Arial" 5864 ><font color="#00B04F"><font size="+1"> 5865 -window-group 5866 </font></font></font></b></td></tr></table> 5867 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the window group</td></tr></table> 5868 <table BORDER=0 WIDTH="94%"> 5869 <tr> 5870 <td width="3%"><br></td> 5871 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5872 <img SRC="images/right_triangle_option.png" 5873 ALT=">" BORDER=0 height=14 5874 width=15><b><font face="Helvetica, Arial" 5875 ><font color="#00B04F"><font size="+1"> 5876 <a name="details-write"></a>-write <i><filename></i> 5877 </font></font></font></b></td></tr></table> 5878 <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> 5879 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5880 The current image is written to the specified filename and then 5881 processing continues using that image. The following is an example of how 5882 several sizes of an image may be generated in one command (repeat as 5883 often as needed):</font></td></tr></table> 5884 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 5885 gm convert input.jpg -resize 50% -write input50.jpg \ 5886 -resize 25% input25.jpg 5887 </pre></font></td></tr></table> 5888 <table BORDER=0 WIDTH="94%"> 5889 <tr> 5890 <td width="3%"><br></td> 5891 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5892 <img SRC="images/right_triangle_option.png" 5893 ALT=">" BORDER=0 height=14 5894 width=15><b><font face="Helvetica, Arial" 5895 ><font color="#00B04F"><font size="+1"> 5896 <a name="details-write"></a>-write <i><filename></i> 5897 </font></font></font></b></td></tr></table> 5898 <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> 5899 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5900 If <em>filename</em> already exists, you will be prompted as to whether it should 5901 be overwritten.</font></td></tr></table> 5902 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5903 By default, the image is written in the format that it was read in as. 5904 To specify a particular image format, prefix <em>filename</em> with the 5905 image type and a colon (e.g., ps:image) or specify the image type as 5906 the filename suffix (e.g., image.ps). Specify file as - for standard 5907 output. If file has the extension <strong>.Z</strong> or <strong>.gz</strong>, the file 5908 size is <strong>compressed</strong> using compress or <strong>gzip</strong> 5909 respectively. Precede the image file name with | to pipe to a system 5910 command.</font></td></tr></table> 5911 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5912 Use <strong>-compress</strong> to specify the type of image compression.</font></td></tr></table> 5913 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> 5914 The equivalent X resource for this option is 5915 <strong>writeFilename</strong> (class <strong>WriteFilename</strong>). 5916 See 5917 <a href="#xres">X Resources</a> 5918 for details.</font></td></tr></table> 5919 </td></tr></table> 5920 <p> 5921 <i><a href="#top">Back to Contents</a></i> 5922 </p> 5923 <table BORDER=0 WIDTH="100%"> 5924 <tr> 5925 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 5926 SRC="images/right_triangle.png" ALT=">" BORDER=0 5927 height=14 width=15><b><font face="Helvetica, Arial"><font 5928 color="#00B04F"><font size="+1"> 5929 <a NAME="envi"></a>Environment 5930 </font></font></font></b></td></tr></table> 5931 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 5932 <tr><td width="3%"><br></td><td> 5933 <table BORDER=0 WIDTH="94%"> 5934 <tr> 5935 <td width="3%"><br></td> 5936 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5937 <img SRC="images/right_triangle_option.png" 5938 ALT=">" BORDER=0 height=14 5939 width=15><b><font face="Helvetica, Arial" 5940 ><font color="#00B04F"><font size="+1"> 5941 COLUMNS 5942 </font></font></font></b></td></tr></table> 5943 <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 5944 Unix systems keep this shell variable up to date, but it may need to be 5945 explicitly exported in order for GraphicsMagick to see it.</td></tr></table> 5946 <table BORDER=0 WIDTH="94%"> 5947 <tr> 5948 <td width="3%"><br></td> 5949 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5950 <img SRC="images/right_triangle_option.png" 5951 ALT=">" BORDER=0 height=14 5952 width=15><b><font face="Helvetica, Arial" 5953 ><font color="#00B04F"><font size="+1"> 5954 DISPLAY 5955 </font></font></font></b></td></tr></table> 5956 <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 5957 hostname:display.screen).</td></tr></table> 5958 <table BORDER=0 WIDTH="94%"> 5959 <tr> 5960 <td width="3%"><br></td> 5961 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5962 <img SRC="images/right_triangle_option.png" 5963 ALT=">" BORDER=0 height=14 5964 width=15><b><font face="Helvetica, Arial" 5965 ><font color="#00B04F"><font size="+1"> 5966 HOME 5967 </font></font></font></b></td></tr></table> 5968 <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 5969 observed by "uninstalled" builds of GraphicsMagick which do not have 5970 their location hard-coded or set by an installer. When supported, 5971 GraphicsMagick searches for configuration files in $HOME/.magick if 5972 the directory exists. See <strong>MAGICK_CODER_MODULE_PATH</strong>, 5973 <strong>MAGICK_CONFIGURE_PATH</strong>, and <strong>MAGICK_FILTER_MODULE_PATH</strong> if 5974 more flexibility is needed.</td></tr></table> 5975 <table BORDER=0 WIDTH="94%"> 5976 <tr> 5977 <td width="3%"><br></td> 5978 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5979 <img SRC="images/right_triangle_option.png" 5980 ALT=">" BORDER=0 height=14 5981 width=15><b><font face="Helvetica, Arial" 5982 ><font color="#00B04F"><font size="+1"> 5983 MAGICK_ACCESS_MONITOR 5984 </font></font></font></b></td></tr></table> 5985 <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 5986 <strong>-monitor</strong>) will also show files accessed (including temporary 5987 files) and any external commands which are executed. This is useful 5988 for debugging, but also illustrates arguments made available to an 5989 access handler registered by the 5990 <strong>MagickSetConfirmAccessHandler()</strong> C library function.</td></tr></table> 5991 <table BORDER=0 WIDTH="94%"> 5992 <tr> 5993 <td width="3%"><br></td> 5994 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 5995 <img SRC="images/right_triangle_option.png" 5996 ALT=">" BORDER=0 height=14 5997 width=15><b><font face="Helvetica, Arial" 5998 ><font color="#00B04F"><font size="+1"> 5999 MAGICK_CODER_STABILITY 6000 </font></font></font></b></td></tr></table> 6001 <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 6002 available levels are <strong>PRIMARY</strong>, <strong>STABLE</strong>, <strong>UNSTABLE</strong>, 6003 and <strong>BROKEN</strong>. The default minimum level is <strong>UNSTABLE</strong>, 6004 which means that all available working coders will be used. The 6005 purpose of this option is to reduce the security exposure (or apparent 6006 complexity) due to the huge number of formats supported. Coders at the 6007 <strong>PRIMARY</strong> level are commonly used formats with very well 6008 maintained implementations. Coders at the <strong>STABLE</strong> level are 6009 reasonably well maintained but represent less used formats. Coders at 6010 the <strong>UNSTABLE</strong> level either have weak implementations, the file 6011 format itself is weak, or the probability the coder will be needed is 6012 vanishingly small. Coders at the <strong>BROKEN</strong> level are known to 6013 often not work properly or might not be useful in their current state 6014 at all.</td></tr></table> 6015 <table BORDER=0 WIDTH="94%"> 6016 <tr> 6017 <td width="3%"><br></td> 6018 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6019 <img SRC="images/right_triangle_option.png" 6020 ALT=">" BORDER=0 height=14 6021 width=15><b><font face="Helvetica, Arial" 6022 ><font color="#00B04F"><font size="+1"> 6023 MAGICK_CODER_MODULE_PATH 6024 </font></font></font></b></td></tr></table> 6025 <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. 6026 This path allows the user to arbitrarily extend the image formats 6027 supported by GraphicsMagick by adding loadable modules to an arbitrary 6028 location rather than copying them into the GraphicsMagick installation 6029 directory. The formatting of the search path is similar to operating 6030 system search paths (i.e. colon delimited for Unix, and semi-colon 6031 delimited for Microsoft Windows). This user specified search path is used 6032 before trying the default search path.</td></tr></table> 6033 <table BORDER=0 WIDTH="94%"> 6034 <tr> 6035 <td width="3%"><br></td> 6036 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6037 <img SRC="images/right_triangle_option.png" 6038 ALT=">" BORDER=0 height=14 6039 width=15><b><font face="Helvetica, Arial" 6040 ><font color="#00B04F"><font size="+1"> 6041 MAGICK_CONFIGURE_PATH 6042 </font></font></font></b></td></tr></table> 6043 <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. 6044 The formatting of the search path is similar to operating system search 6045 paths (i.e. colon delimited for Unix, and semi-colon delimited for 6046 Microsoft Windows). This user specified search path is used before trying 6047 the default search path.</td></tr></table> 6048 <table BORDER=0 WIDTH="94%"> 6049 <tr> 6050 <td width="3%"><br></td> 6051 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6052 <img SRC="images/right_triangle_option.png" 6053 ALT=">" BORDER=0 height=14 6054 width=15><b><font face="Helvetica, Arial" 6055 ><font color="#00B04F"><font size="+1"> 6056 MAGICK_DEBUG 6057 </font></font></font></b></td></tr></table> 6058 <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 6059 configure debug option via an environment variable 6060 (e.g. <strong>MAGICK_DEBUG=configure</strong>) is necessary to see the complete 6061 initialization process, which includes searching for configuration 6062 files.</td></tr></table> 6063 <table BORDER=0 WIDTH="94%"> 6064 <tr> 6065 <td width="3%"><br></td> 6066 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6067 <img SRC="images/right_triangle_option.png" 6068 ALT=">" BORDER=0 height=14 6069 width=15><b><font face="Helvetica, Arial" 6070 ><font color="#00B04F"><font size="+1"> 6071 MAGICK_FILTER_MODULE_PATH 6072 </font></font></font></b></td></tr></table> 6073 <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 6074 (invoked via <strong>-process</strong>). This path allows the user to arbitrarily 6075 extend GraphicsMagick's image processing functionality by adding loadable 6076 modules to an arbitrary location rather than copying them into the 6077 GraphicsMagick installation directory. The formatting of the search path 6078 is similar to operating system search paths (i.e. colon delimited for 6079 Unix, and semi-colon delimited for Microsoft Windows). This user 6080 specified search path is used before trying the default search path.</td></tr></table> 6081 <table BORDER=0 WIDTH="94%"> 6082 <tr> 6083 <td width="3%"><br></td> 6084 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6085 <img SRC="images/right_triangle_option.png" 6086 ALT=">" BORDER=0 height=14 6087 width=15><b><font face="Helvetica, Arial" 6088 ><font color="#00B04F"><font size="+1"> 6089 MAGICK_GHOSTSCRIPT_PATH 6090 </font></font></font></b></td></tr></table> 6091 <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 6092 installation rather than searching for it via the Windows registry. 6093 This helps in case Ghostscript is not installed via the Ghostscript 6094 Windows installer or the user wants more control over the Ghostscript 6095 used.</td></tr></table> 6096 <table BORDER=0 WIDTH="94%"> 6097 <tr> 6098 <td width="3%"><br></td> 6099 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6100 <img SRC="images/right_triangle_option.png" 6101 ALT=">" BORDER=0 height=14 6102 width=15><b><font face="Helvetica, Arial" 6103 ><font color="#00B04F"><font size="+1"> 6104 MAGICK_HOME 6105 </font></font></font></b></td></tr></table> 6106 <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 6107 by "uninstalled" builds of GraphicsMagick which do not have their location 6108 hard-coded or set by an installer.</td></tr></table> 6109 <table BORDER=0 WIDTH="94%"> 6110 <tr> 6111 <td width="3%"><br></td> 6112 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6113 <img SRC="images/right_triangle_option.png" 6114 ALT=">" BORDER=0 height=14 6115 width=15><b><font face="Helvetica, Arial" 6116 ><font color="#00B04F"><font size="+1"> 6117 MAGICK_MMAP_READ 6118 </font></font></font></b></td></tr></table> 6119 <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 6120 will attempt to memory-map the input file for reading. This usually 6121 substantially improves repeated read performance since the file is 6122 already in memory after the first time it has been read. However, 6123 testing shows that performance may be reduced for files accessed for 6124 the first time since data is accessed via page-faults (upon first 6125 access) and many operating systems fail to do sequential read-ahead of 6126 memory mapped files, and particularly if those files are accessed over 6127 a network. If many large input files are read, then enabling this 6128 option may harm performance by overloading the operating system's VM 6129 system as it then needs to free unmapped pages and map new ones.</td></tr></table> 6130 <table BORDER=0 WIDTH="94%"> 6131 <tr> 6132 <td width="3%"><br></td> 6133 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6134 <img SRC="images/right_triangle_option.png" 6135 ALT=">" BORDER=0 height=14 6136 width=15><b><font face="Helvetica, Arial" 6137 ><font color="#00B04F"><font size="+1"> 6138 MAGICK_IO_FSYNC 6139 </font></font></font></b></td></tr></table> 6140 <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 6141 will request that the output file is fully flushed and synchronized to 6142 disk when it is closed. This incurs a performance penalty, but has the 6143 benefit that if the power fails or the system crashes, the file should be 6144 valid on disk. If image files are referenced from a database, then this 6145 option helps assure that the files referenced by the database are 6146 valid.</td></tr></table> 6147 <table BORDER=0 WIDTH="94%"> 6148 <tr> 6149 <td width="3%"><br></td> 6150 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6151 <img SRC="images/right_triangle_option.png" 6152 ALT=">" BORDER=0 height=14 6153 width=15><b><font face="Helvetica, Arial" 6154 ><font color="#00B04F"><font size="+1"> 6155 MAGICK_IOBUF_SIZE 6156 </font></font></font></b></td></tr></table> 6157 <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 6158 writing encoded files. The default is 16384, which is observed to work 6159 well for many cases. The best value for a local filesystem is usually the 6160 the native filesystem block size (e.g. 4096, 8192, or even 131,072 for 6161 ZFS) in order to minimize the number of physical disk I/O operations. 6162 I/O performance to files accessed over a network may benefit 6163 significantly by tuning this option. Larger values are not necessarily 6164 better (they may be slower!), and there is rarely any benefit from using 6165 values larger than 32768. Use convert's <strong>-verbose</strong> option in order 6166 to evaluate read and write rates in pixels per second while keeping in 6167 mind that the operating system will try to cache files in RAM.</td></tr></table> 6168 <table BORDER=0 WIDTH="94%"> 6169 <tr> 6170 <td width="3%"><br></td> 6171 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6172 <img SRC="images/right_triangle_option.png" 6173 ALT=">" BORDER=0 height=14 6174 width=15><b><font face="Helvetica, Arial" 6175 ><font color="#00B04F"><font size="+1"> 6176 MAGICK_LIMIT_DISK 6177 </font></font></font></b></td></tr></table> 6178 <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> 6179 <table BORDER=0 WIDTH="94%"> 6180 <tr> 6181 <td width="3%"><br></td> 6182 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6183 <img SRC="images/right_triangle_option.png" 6184 ALT=">" BORDER=0 height=14 6185 width=15><b><font face="Helvetica, Arial" 6186 ><font color="#00B04F"><font size="+1"> 6187 MAGICK_LIMIT_FILES 6188 </font></font></font></b></td></tr></table> 6189 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum number of open files.</td></tr></table> 6190 <table BORDER=0 WIDTH="94%"> 6191 <tr> 6192 <td width="3%"><br></td> 6193 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6194 <img SRC="images/right_triangle_option.png" 6195 ALT=">" BORDER=0 height=14 6196 width=15><b><font face="Helvetica, Arial" 6197 ><font color="#00B04F"><font size="+1"> 6198 MAGICK_LIMIT_MAP 6199 </font></font></font></b></td></tr></table> 6200 <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 6201 file consumes memory when the file is accessed, although the system 6202 may reclaim such memory when needed.</td></tr></table> 6203 <table BORDER=0 WIDTH="94%"> 6204 <tr> 6205 <td width="3%"><br></td> 6206 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6207 <img SRC="images/right_triangle_option.png" 6208 ALT=">" BORDER=0 height=14 6209 width=15><b><font face="Helvetica, Arial" 6210 ><font color="#00B04F"><font size="+1"> 6211 MAGICK_LIMIT_MEMORY 6212 </font></font></font></b></td></tr></table> 6213 <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> 6214 <table BORDER=0 WIDTH="94%"> 6215 <tr> 6216 <td width="3%"><br></td> 6217 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6218 <img SRC="images/right_triangle_option.png" 6219 ALT=">" BORDER=0 height=14 6220 width=15><b><font face="Helvetica, Arial" 6221 ><font color="#00B04F"><font size="+1"> 6222 MAGICK_LIMIT_PIXELS 6223 </font></font></font></b></td></tr></table> 6224 <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 6225 allow for any image which is requested to be created or read. This is 6226 useful to place a limit on how large an image may be. If the input 6227 image file has image dimensions larger than the pixel limit, then the 6228 image memory allocation is denied and an error is returned 6229 immediately. This is a per-image limit and does not limit the total 6230 number of pixels due to multiple image frames/pages (e.g. multi-page 6231 document or an animation).</td></tr></table> 6232 <table BORDER=0 WIDTH="94%"> 6233 <tr> 6234 <td width="3%"><br></td> 6235 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6236 <img SRC="images/right_triangle_option.png" 6237 ALT=">" BORDER=0 height=14 6238 width=15><b><font face="Helvetica, Arial" 6239 ><font color="#00B04F"><font size="+1"> 6240 MAGICK_LIMIT_WIDTH 6241 </font></font></font></b></td></tr></table> 6242 <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> 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 MAGICK_LIMIT_HEIGHT 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>Maximum pixel height of an image read, or created.</td></tr></table> 6254 <table BORDER=0 WIDTH="94%"> 6255 <tr> 6256 <td width="3%"><br></td> 6257 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6258 <img SRC="images/right_triangle_option.png" 6259 ALT=">" BORDER=0 height=14 6260 width=15><b><font face="Helvetica, Arial" 6261 ><font color="#00B04F"><font size="+1"> 6262 MAGICK_TMPDIR 6263 </font></font></font></b></td></tr></table> 6264 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Path to directory where GraphicsMagick should write temporary 6265 files. The default is to use the system default, or the location set by 6266 <strong>TMPDIR</strong>.</td></tr></table> 6267 <table BORDER=0 WIDTH="94%"> 6268 <tr> 6269 <td width="3%"><br></td> 6270 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6271 <img SRC="images/right_triangle_option.png" 6272 ALT=">" BORDER=0 height=14 6273 width=15><b><font face="Helvetica, Arial" 6274 ><font color="#00B04F"><font size="+1"> 6275 TMPDIR 6276 </font></font></font></b></td></tr></table> 6277 <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 6278 directory where all applications should write temporary files. 6279 Overridden by <strong>MAGICK_TMPDIR</strong> if it is set.</td></tr></table> 6280 <table BORDER=0 WIDTH="94%"> 6281 <tr> 6282 <td width="3%"><br></td> 6283 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6284 <img SRC="images/right_triangle_option.png" 6285 ALT=">" BORDER=0 height=14 6286 width=15><b><font face="Helvetica, Arial" 6287 ><font color="#00B04F"><font size="+1"> 6288 TMP <i>or TEMP</i> 6289 </font></font></font></b></td></tr></table> 6290 <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 6291 should write temporary files. Overridden by <strong>MAGICK_TMPDIR</strong> if it 6292 is set.</td></tr></table> 6293 <table BORDER=0 WIDTH="94%"> 6294 <tr> 6295 <td width="3%"><br></td> 6296 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6297 <img SRC="images/right_triangle_option.png" 6298 ALT=">" BORDER=0 height=14 6299 width=15><b><font face="Helvetica, Arial" 6300 ><font color="#00B04F"><font size="+1"> 6301 OMP_NUM_THREADS 6302 </font></font></font></b></td></tr></table> 6303 <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 6304 use in parallel regions. Some compilers default the number of threads to 6305 use to the number of processor cores available while others default to 6306 just one thread. See the OpenMP specification for other standard 6307 adjustments and your compiler's manual for vendor-specific settings.</td></tr></table> 6308 </td></tr></table> 6309 <p> 6310 <i><a href="#top">Back to Contents</a></i> 6311 </p> 6312 <table BORDER=0 WIDTH="100%"> 6313 <tr> 6314 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 6315 SRC="images/right_triangle.png" ALT=">" BORDER=0 6316 height=14 width=15><b><font face="Helvetica, Arial"><font 6317 color="#00B04F"><font size="+1"> 6318 <a NAME="file"></a>Configuration Files 6319 </font></font></font></b></td></tr></table> 6320 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 6321 <tr><td width="3%"><br></td><td> 6322 <p>GraphicsMagick uses a number of XML format configuration files: 6323 <table BORDER=0 WIDTH="94%"> 6324 <tr> 6325 <td width="3%"><br></td> 6326 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6327 <img SRC="images/right_triangle_option.png" 6328 ALT=">" BORDER=0 height=14 6329 width=15><b><font face="Helvetica, Arial" 6330 ><font color="#00B04F"><font size="+1"> 6331 colors.mgk 6332 </font></font></font></b></td></tr></table> 6333 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>colors configuration file</td></tr></table> 6334 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 6335 <?xml version="1.0"?> 6336 <colormap> 6337 <color name="AliceBlue" red="240" green="248" blue="255" 6338 compliance="SVG, X11, XPM" /> 6339 </colormap> 6340 </pre></font></td></tr></table> 6341 <table BORDER=0 WIDTH="94%"> 6342 <tr> 6343 <td width="3%"><br></td> 6344 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6345 <img SRC="images/right_triangle_option.png" 6346 ALT=">" BORDER=0 height=14 6347 width=15><b><font face="Helvetica, Arial" 6348 ><font color="#00B04F"><font size="+1"> 6349 delegates.mgk 6350 </font></font></font></b></td></tr></table> 6351 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>delegates configuration file</td></tr></table> 6352 <table BORDER=0 WIDTH="94%"> 6353 <tr> 6354 <td width="3%"><br></td> 6355 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6356 <img SRC="images/right_triangle_option.png" 6357 ALT=">" BORDER=0 height=14 6358 width=15><b><font face="Helvetica, Arial" 6359 ><font color="#00B04F"><font size="+1"> 6360 log.mgk 6361 </font></font></font></b></td></tr></table> 6362 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>logging configuration file</td></tr></table> 6363 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 6364 <?xml version="1.0"?> 6365 <magicklog> 6366 <log events="None" /> 6367 <log output="stdout" /> 6368 <log filename="Magick-%d.log" /> 6369 <log generations="3" /> 6370 <log limit="2000" /> 6371 <log format="%t %r %u %p %m/%f/%l/%d:\n %e" /> 6372 </magicklog> 6373 </pre></font></td></tr></table> 6374 <table BORDER=0 WIDTH="94%"> 6375 <tr> 6376 <td width="3%"><br></td> 6377 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6378 <img SRC="images/right_triangle_option.png" 6379 ALT=">" BORDER=0 height=14 6380 width=15><b><font face="Helvetica, Arial" 6381 ><font color="#00B04F"><font size="+1"> 6382 modules.mgk 6383 </font></font></font></b></td></tr></table> 6384 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>loadable modules configuration file</td></tr></table> 6385 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 6386 <?xml version="1.0"?> 6387 <modulemap> 6388 <module magick="8BIM" name="META" /> 6389 </modulemap> 6390 </pre></font></td></tr></table> 6391 <table BORDER=0 WIDTH="94%"> 6392 <tr> 6393 <td width="3%"><br></td> 6394 <td ALIGN=LEFT BGCOLOR="#FFFFFF"> 6395 <img SRC="images/right_triangle_option.png" 6396 ALT=">" BORDER=0 height=14 6397 width=15><b><font face="Helvetica, Arial" 6398 ><font color="#00B04F"><font size="+1"> 6399 type.mgk 6400 </font></font></font></b></td></tr></table> 6401 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>master type (fonts) configuration file</td></tr></table> 6402 <table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"><pre> 6403 <?xml version="1.0"?> 6404 <typemap> 6405 <<strong></strong>include file="type-windows.mgk" /> 6406 <type 6407 name="AvantGarde-Book" 6408 fullname="AvantGarde Book" 6409 family="AvantGarde" 6410 foundry="URW" 6411 weight="400" 6412 style="normal" 6413 stretch="normal" 6414 format="type1" 6415 metrics="/usr/local/share/ghostscript/fonts/a010013l.afm" 6416 glyphs="/usr/local/share/ghostscript/fonts/a010013l.pfb" 6417 /> 6418 </typemap> 6419 </pre></font></td></tr></table> 6420 </td></tr></table> 6421 <p> 6422 <i><a href="#top">Back to Contents</a></i> 6423 </p> 6424 <table BORDER=0 WIDTH="100%"> 6425 <tr> 6426 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 6427 SRC="images/right_triangle.png" ALT=">" BORDER=0 6428 height=14 width=15><b><font face="Helvetica, Arial"><font 6429 color="#00B04F"><font size="+1"> 6430 <a NAME="auth"></a>Authors 6431 </font></font></font></b></td></tr></table> 6432 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 6433 <tr><td width="3%"><br></td><td> 6434 <p> 6435 <em> 6436 John Cristy,<br> 6437 Bob Friesenhahn,<br> 6438 Glenn Randers-Pehrson,<br> 6439 William Radcliff,<br> 6440 Leonard Rosenthol,<br> 6441 Lars Ruben Skyum,<br> 6442 Jaroslav Fojtik,<br> 6443 and many more. 6444 </em> 6445 <br> <br> 6446 </td></tr></table> 6447 <p> 6448 <i><a href="#top">Back to Contents</a></i> 6449 </p> 6450 <table BORDER=0 WIDTH="100%"> 6451 <tr> 6452 <td ALIGN=LEFT bgcolor="#FFFFFF"><img 6453 SRC="images/right_triangle.png" ALT=">" BORDER=0 6454 height=14 width=15><b><font face="Helvetica, Arial"><font 6455 color="#00B04F"><font size="+1"> 6456 <a NAME="copy"></a>Copyright 6457 </font></font></font></b></td></tr></table> 6458 <table width="94%" border="0" cellspacing="0" cellpadding="8"> 6459 <tr><td width="3%"><br></td><td> 6460 <p> 6461 <strong>Copyright (C) 2002 - 2020 GraphicsMagick Group.</strong> Additional 6462 copyrights apply. Please see see 6463 http://www.GraphicsMagick.org/Copyright.html for details. 6464 <p> 6465 </td></tr></table> 6466 <p> 6467 <i><a href="#top">Back to Contents</a></i> 6468 </p> 6469 <HR> 6470 6471 [<a href="index.html">Home</a>] [<a href="utilities.html">Utilities Index</a>] 6472 <BR> 6473 <p align=center <a href="Copyright.html">Copyright © GraphicsMagick Group 2002 - 2020</a></p></td> 6474 </tr></table> 6475 </body></html>