1 2 3 4 5<!doctype html> 6<html lang="en"> 7<head> 8 <meta charset="utf-8" /> 9 <meta name="viewport" content="width=device-width, initial-scale=1" /> 10 <title>ImageMagick - Defines</title> 11 <meta name="application-name" content="ImageMagick" /> 12 <meta name="description" content="Use ImageMagick® to create, edit, compose, and convert digital images. Resize an image, crop it, change its shades and colors, add captions, and more." /> 13 <meta name="application-url" content="https://imagemagick.org" /> 14 <meta name="generator" content="PHP" /> 15 <meta name="keywords" content="defines, image processing software" /> 16 <meta name="rating" content="GENERAL" /> 17 <meta name="robots" content="INDEX, FOLLOW" /> 18 <meta name="generator" content="ImageMagick Studio LLC" /> 19 <meta name="author" content="ImageMagick Studio LLC" /> 20 <meta name="revisit-after" content="2 DAYS" /> 21 <meta name="resource-type" content="document" /> 22 <meta name="copyright" content="Copyright (c) 1999-2020 ImageMagick Studio LLC" /> 23 <meta name="distribution" content="Global" /> 24 <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1" /> 25 <meta property='og:url' content='../' /> 26 <meta property='og:title' content='ImageMagick' /> 27 <meta property='og:image' content='../images/logo.png' /> 28 <meta property='og:type' content='website' /> 29 <meta property='og:site_name' content='ImageMagick' /> 30 <meta property='og:description' content="Create, Edit, Compose, or Convert Digital Images" /> 31 <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" /> 32 <link href="defines.html" rel="canonical" /> 33 <link href="../images/wand.png" rel="icon" /> 34 <link href="../images/wand.ico" rel="shortcut icon" /> 35 <link href="assets/magick.css" rel="stylesheet" /> 36</head> 37<body> 38 <nav class="navbar navbar-expand-md navbar-dark bg-dark fixed-top"> 39 <div class="container-fluid"> 40 <a class="navbar-brand" href="../"><img class="d-block" id="icon" alt="ImageMagick" width="32" height="32" src="../images/wand.ico"/></a> 41 <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#magick-navbars" aria-controls="magick-navbars" aria-expanded="false" aria-label="Toggle navigation"> 42 <span class="navbar-toggler-icon"></span> 43 </button> 44 45 <div class="collapse navbar-collapse" id="magick-navbars"> 46 <ul class="navbar-nav me-auto mb-2 mb-md-0"> 47 <li class="nav-item"> 48 <a class="nav-link " href="../www/index.html">Home</a> 49 </li> 50 <li class="nav-item"> 51 <a class="nav-link " href="../www/download.html">Download</a> 52 </li> 53 <li class="nav-item"> 54 <a class="nav-link " href="../www/command-line-tools.html">Tools</a> 55 </li> 56 <li class="nav-item"> 57 <a class="nav-link " href="../www/command-line-processing.html">CLI</a> 58 </li> 59 <li class="nav-item"> 60 <a class="nav-link " href="../www/develop.html">Develop</a> 61 </li> 62 <li class="nav-item"> 63 <a class="nav-link" target="_blank" href="https://github.com/ImageMagick/ImageMagick/discussions">Community</a> 64 </li> 65 <li class="nav-item"> 66 <iframe src="https://github.com/sponsors/ImageMagick/button" title="Sponsor ImageMagick" height="35" width="107" style="border: 0;"></iframe> 67 </li> 68 </ul> 69 <form class="d-flex form-inline" action="search.html"> 70 <input class="form-control me-2" type="text" name="q" placeholder="Search" aria-label="Search"> 71 <button class="btn btn-outline-success" type="submit" name="sa">Search</button> 72 </form> 73 </div> 74 </div> 75 </nav> 76 77 <div class="container"> 78 <script async="async" src="https://localhost/pagead/js/adsbygoogle.js"></script> 79 <ins class="adsbygoogle" 80 style="display:block" 81 data-ad-client="ca-pub-3129977114552745" 82 data-ad-slot="6345125851" 83 data-full-width-responsive="true" 84 data-ad-format="horizontal"></ins> 85 <script> 86 (adsbygoogle = window.adsbygoogle || []).push({}); 87 </script> 88 89 </div> 90 91 <main class="container"> 92 <div class="magick-template"> 93<div class="magick-header"> 94 95<p class="magick-description">The <a href="../www/command-line-options.html#define">-define</a> command-line option adds specific global settings generally used to control coders and image processing operations.</p> 96 97<p>This option creates one or more definitions for coders and decoders to use 98while reading and writing image data. Definitions are generally used to 99control image file format coder modules, and image processing operations, 100beyond what is provided by normal means. Defined settings are listed in <a href="../www/command-line-options.html#verbose">-verbose</a> information ("<code>info:</code>" output format) as "Artifacts". </p> 101 102<p>If <var>value</var> is missing for a definition, an empty-valued 103definition of a flag is created with that name. This used to control on/off 104options. Use <a href="../www/command-line-options.html#define">-define keys</a> to remove definitions 105previously created. Use <a href="../www/command-line-options.html#define">+define "*"</a> to remove all existing definitions.</p> 106 107<p>The same 'artifact' settings can also be defined using the <a href="../www/command-line-options.html#set">-set "option:<var>key</var>" "<var>value</var>"</a> option, which also allows the use of <a href="escape.html" >Format and Print Image Properties</a> in the defined value. </p> 108 109<p>The <var>option</var> and <var>key</var> are case-independent (they are 110converted to lowercase for use within the decoders) while the <var>value</var> 111is case-dependent.</p> 112 113<p>Such settings are global in scope, and affect all images and operations. </p> 114 115<pre class="highlight"><code>magick bilevel.tif -define ps:imagemask eps3:stencil.ps 116</code></pre> 117 118<p>Set attributes of the image registry by prefixing the value with 119<code>registry:</code>. For example, to set a temporary path to put work files, 120use:</p> 121 122<pre class="highlight"><code>-define registry:temporary-path=/data/tmp 123</code></pre> 124 125<p>Here is a list of recognized defines:</p> 126 127 128<div class="table-responsive" style="font-size:87.5% !important;"> 129 130<table class="table table-sm table-hover"> 131 <tr> 132 <th align="center" colspan=2>Command-line Defines</th> 133 </tr> 134 135 <tr> 136 <td colspan=2><p></p></td> 137 </tr> 138 139 <tr> 140 <td>auto-threshold:verbose</td> 141 <td>return derived threshold as the <code>auto-threshold:threshold</code> image property.</td> 142 </tr> 143 144 <tr> 145 <td>colorspace:auto-grayscale=<var>on|off</var></td> 146 <td>Prevent automatic conversion to grayscale inside coders that support 147 grayscale. This should be accompanied by -type truecolor. PNG and TIF do 148 not need this define. With PNG, just use PNG24:image. With TIF, just use 149 -type truecolor. JPG and PSD will need this define.</td> 150 </tr> 151 152 <tr> 153 <td>compare:ssim-radius=<var>value</var></td> 154 <td>Set the structural similarity index radius.</td> 155 </tr> 156 157 <tr> 158 <td>compare:ssim-sigma=<var>value</var></td> 159 <td>Set the structural similarity index sigma.</td> 160 </tr> 161 162 <tr> 163 <td>compare:ssim-k1=<var>value</var></td> 164 <td>Set the structural similarity index k1 argument.</td> 165 </tr> 166 167 <tr> 168 <td>compare:ssim-k2=<var>value</var></td> 169 <td>Set the structural similarity index k2 argument.</td> 170 </tr> 171 172 <tr> 173 <td>complex:snr=<var>value</var></td> 174 <td>Set the divide SNR constant <a href="../www/command-line-options.html#complex">-complex</a>.</td> 175 </tr> 176 177 <tr> 178 <td>compose:args=<var>arguments</var></td> 179 <td>Set certain compose argument values when using convert ... -compose ... 180 -composite. See <a href="compose.html" 181 >Image Composition</a>.</td> 182 </tr> 183 184 <tr> 185 <td>compose:clip-to-self=<var>true|false</var></td> 186 <td>Some <a href="../www/command-line-options.html#compose" >-compose</a> methods can modify the 187 'destination' image outside the overlay area. It is disabled by default.</td> 188 </tr> 189 190 <tr> 191 <td>compose:clamp=<var>on|off</var></td> 192 <td>Set each pixel whose value is below zero to zero and any the pixel 193 whose value is above the quantum range to the quantum range (e.g. 65535) 194 otherwise the pixel value remains unchanged. Define supported in 195 ImageMagick 6.9.1-3 and above.</td> 196 </tr> 197 198 <tr> 199 <td>connected-components:angle-threshold=<var>value</var></td> 200 <td>Merges any region with equivalent ellipse angle smaller than 201 <var>value</var> into its surrounding region or largest neighbor. 202 Supported in Imagemagick 7.0.9.24.</td> 203 </tr> 204 205 <tr> 206 <td>connected-components:area-threshold=<var>value</var></td> 207 <td>Merges any region with area smaller than <var>value</var> into its 208 surrounding region or largest neighbor. Thresholds can optionally include ranges, e.g. 410-1600.</td> 209 </tr> 210 211 <tr> 212 <td>connected-components:background-id=<var>object-id</var></td> 213 <td>Identify which object is to be the background object. 214 Supported in Imagemagick 7.0.9.21.</td> 215 </tr> 216 217 <tr> 218 <td>connected-components:circularity-threshold=<var>value</var></td> 219 <td>Merge any region with circularity smaller than <var>value</var> 220 into its surrounding region or largest neighbor. Circularity is 221 computed as 4*pi*area/perimeter^2. 222 Supported in Imagemagick 7.0.9.24.</td> 223 </tr> 224 225 <tr> 226 <td>connected-components:diameter-threshold=<var>value</var></td> 227 <td>Merge any region with diameter smaller than <var>value</var> 228 into its surrounding region or largest neighbor. Diameter is 229 computed as sqrt(4*area/pi). 230 Supported in Imagemagick 7.0.9.24.</td> 231 </tr> 232 233 <tr> 234 <td>connected-components:eccentricity-threshold=<var>value</var></td> 235 <td>Merge any region with equivalent ellipse eccentricity smaller 236 than <var>value</var> into its surrounding region or largest neighbor. 237 Supported in Imagemagick 7.0.9.24.</td> 238 </tr> 239 240 <tr> 241 <td>connected-components:exclude-header=<var>true</var></td> 242 <td>List the objects without the header. Supported in Imagemagick 7.0.9.21.</td> 243 </tr> 244 245 <tr> 246 <td>connected-components:keep=<var>list-of-ids</var></td> 247 <td>Comma and/or hyphenated list of id values to keep in the output. Supported in Imagemagick 6.9.3-0.</td> 248 </tr> 249 250 <tr> 251 <td>connected-components:keep-colors=<var>red;green;blue</var></td> 252 <td>Keeps objects identified by their color in a semicolon separated list. Supported in Imagemagick 6.9.3-0.</td> 253 </tr> 254 255 <tr> 256 <td>connected-components:keep-top=<var>number-of-objects</var></td> 257 <td>Keeps only the top number of objects by area. Supported in Imagemagick 7.0.9.21.</td> 258 </tr> 259 260 <tr> 261 <td>connected-components:major-axis-threshold=<var>value</var></td> 262 <td>Merge any region with equivalent ellipse major axis diameter smaller 263 than <var>value</var> into its surrounding region or largest neighbor. 264 Supported in Imagemagick 7.0.9.24.</td> 265 </tr> 266 267 <tr> 268 <td>connected-components:mean-color=<var>true</var></td> 269 <td>Change the output image from id values to mean color values. Supported in Imagemagick 6.9.2-8.</td> 270 </tr> 271 272 <tr> 273 <td>connected-components:minor-axis-threshold=<var>value</var></td> 274 <td>Merge any region with equivalent ellipse minor axis diameter smaller than <var>value</var> into its surrounding region or largest neighbor. Supported in Imagemagick 7.0.9.24.</td> 275 </tr> 276 277 <tr> 278 <td>connected-components:perimeter-threshold=<var>value</var></td> 279 <td>Merge any region with perimeter smaller than <var>value</var> into its surrounding region or largest neighbor. Supported in Imagemagick 7.0.9.24.</td> 280 </tr> 281 282 <tr> 283 <td>connected-components:remove=<var>list-of-ids</var></td> 284 <td>Comma and/or hyphenated list of id values to remove from the output. 285 Supported in Imagemagick 6.9.2-9.</td> 286 </tr> 287 288 <tr> 289 <td>connected-components:remove-colors=<var>red;green;blue</var></td> 290 <td>Remove objects identified by their color in a semicolon separated list. 291 Supported in Imagemagick 6.9.3-0.</td> 292 </tr> 293 294 <tr> 295 <td>connected-components:verbose=<var>true</var></td> 296 <td>Lists id, bounding box, centroid, area, mean color for each region.</td> 297 </tr> 298 299 <tr> 300 <td>convolve:scale=<var>{kernel_scale}[!^] [,{origin_addition}] [%]</var></td> 301 <td>Define the kernel scaling. The special flag ! automatically scales to 302 full dynamic range. The ! flag can be used in combination with a factor or 303 percent. The factor or percent is then applied after the automatic scaling. 304 An example is 50%!. This produces a result 50% darker than full dynamic 305 range scaling. The ^ flag assures the kernel is 'zero-summing', for 306 example when some values are positive and some are negative as in edge 307 detection kernels. The origin addition adds that value to the center 308 pixel of the kernel. This produces an effect that is like adding the image 309 that many times to the result of the filtered image. The typical value 310 is 1 so that the original image is added to the result of the convolution. 311 The default is 0.</td> 312 </tr> 313 314 <tr> 315 <td>deskew:auto-crop=<var>true</var></td> 316 <td>auto crop the image after deskewing.</td> 317 </tr> 318 319 <tr> 320 <td>delegate:bimodal=<var>true</var></td> 321 <td>Specify direct conversion from Postscript to PDF.</td> 322 </tr> 323 324 <tr> 325 <td>distort:scale=<var>value</var></td> 326 <td>Set the output scaling factor for use with <a href="../www/command-line-options.html#distort" 327 >-distort</a>.</td> 328 </tr> 329 330 <tr> 331 <td>distort:viewport=<var>WxH+X+Y</var></td> 332 <td>Set the viewport for use with <a href="../www/command-line-options.html#distort">-distort</a>.</td> 333 </tr> 334 335 <tr> 336 <td>dither:diffusion-amount=<var>X%</var></td> 337 <td>Set the amount of diffusion to use with Floyd-Steinberg diffusion</td> 338 </tr> 339 340 <tr> 341 <td>filter:option=<var>value</var></td> 342 <td>Set a filter option for use with <a href="../www/command-line-options.html#resize">-resize</a>. 343 See below for specific options.</td> 344 </tr> 345 346 <tr> 347 <td>filter:b=<var>value</var></td> 348 <td>Redefine the spline factor used for cubic filters such as Cubic, 349 Catrom, Mitchel, and Hermite, as well as the Parzen cubic windowing 350 function. If only one of the b or c values are defined, the other is 351 set so as to generate a 'Cubic-Keys' filter. The meaning of the b and c 352 values was defined in a research paper by Mitchell-Netravali.</td> 353 </tr> 354 355 <tr> 356 <td>filter:blur=<var>factor</var></td> 357 <td>Scale the X axis of the filter (and its window). Use > 1.0 for blurry 358 or < 1.0 for sharp. This should only be used with Gaussian and 359 Gaussian-like filters simple filters, or you may not get the 360 expected results.</td> 361 </tr> 362 363 <tr> 364 <td>filter:c=<var>value</var></td> 365 <td>Redefine the Keys alpha factor used for cubic filters such as Cubic, 366 Catrom, Mitchel, and Hermite, as well as the Parzen cubic windowing 367 function. If only one of the b or c values are defined, the other is 368 set so as to generate a 'Cubic-Keys' filter. The meaning of the b and c 369 values was defined in a research paper by Mitchell-Netravali.</td> 370 </tr> 371 372 <tr> 373 <td>filter:kaiser-alpha=<var>value</var></td> 374 <td>Set the Kaiser window alpha value. When it is multiplied by 'PI', 375 it is equivalent to "kaiser-beta" and will override that setting. 376 It only affects the Kaiser windowing function and does not affect 377 any other attributes.</td> 378 </tr> 379 380 <tr> 381 <td>filter:kaiser-beta=<var>value</var></td> 382 <td>Set the Kaiser window beta value. It only affects Kaiser windowing 383 function and does not affect any other attributes. Before ImageMagick 384 v6.7.6-10, this option was known as "filter:alpha" (an inheritance 385 from the very old "zoom" program). It was changed to bring the function 386 in line with more modern academic research usage and better assign it 387 be more definitive. The default value is 6.5</td> 388 </tr> 389 390 <tr> 391 <td>filter:lobes=<var>count</var></td> 392 <td>Set the number of lobes to use for the Sinc/Bessel filter. 393 This is an alternate way of specifying the 'support' range of the filter, 394 that is designed to be more suited to windowed filters, especially when 395 used for image distorts.</td> 396 </tr> 397 398 <tr> 399 <td>filter:sigma=<var>value</var></td> 400 <td>Set the 'sigma' value used to define the Gaussian filter. 401 The default sigma value is '0.5'. It only affects the Gaussian filter, 402 but does not shrink (but may enlarge) the filter's 'support'. 403 It can be used to generate very small blurs, but without the filter 404 'missing' pixels due to using a small support setting. 405 A larger value of '0.707' (a value of '1/sqrt(2)') is another 406 common setting.</td> 407 </tr> 408 409 <tr> 410 <td>filter:support=<var>radius</var></td> 411 <td>Set the filter support radius. It defines how large the filter 412 should be and thus directly defines how slow the filtered resampling 413 process is. All filters have a default 'preferred' support size. 414 Some filters like Lagrange and windowed filters adjust themselves 415 depending on this value. With simple filters this value either does 416 nothing (but slow the resampling), or will clip the filter function 417 in a detrimental way.</td> 418 </tr> 419 420 <tr> 421 <td>filter:verbose=<var>true</var></td> 422 <td>Enable printing of information about the final internal 423 filter selection to standard output. This includes a commented header 424 on the filter settings being used and data allowing the filter weights 425 to be easily graphed. Note however that some filters are internally 426 defined in terms of other filters. The Lanczos filter, for example, 427 is defined in terms of a SincFast windowed SincFast filter, while 428 the Mitchell filter is defined as a general Cubic family filter 429 with specific 'B' and 'C' settings.</td> 430 </tr> 431 432 <tr> 433 <td>filter:window=<var>filter_function</var></td> 434 <td>The IIR (infinite impulse response) filters Sinc and Jinc are 435 windowed (brought down to zero over the defined support range) with 436 the given filter. This allows you to specify a filter function to be 437 used as a windowing function for these IIR filters. Many of the defined 438 filters are actually windowing functions for these IIR filters. A typical 439 choices is Box, (which effectively turns off the windowing function).</td> 440 </tr> 441 442 <tr> 443 <td>filter:window-support=<var>radius</var></td> 444 <td>Scale the windowing function to this size. This causes 445 the windowing (or self-windowing Lagrange filter) to act is if the 446 support window is larger than what is actually supplied to the calling 447 operator. The filter, however, is still clipped to the true support 448 size that is provided. If unset, this will equal the normal filter 449 support size.</td> 450 </tr> 451 452 <tr> 453 <td>fourier:normalize=<var>inverse</var></td> 454 <td>Set the location for the FFT/IFT normalization as use by 455 <a href="../www/command-line-options.html#fft">+-fft</a> and <a href="../www/command-line-options.html#ift">+-ift</a>. The default is 456 <var>forward</var>.</td> 457 </tr> 458 459 <tr> 460 <td>frames:step</td> 461 <td>When selecting image <a href="../www/command-line-processing.html">frames</a>, the default is to step one frame at a time through a list, e.g. [0-3], returns frames 0, 1, 2, and 3. Set the step to 2 in this example and we instead get frames 0 and 2.</td> 462 </tr> 463 464 <tr> 465 <td>h:format=<var>value</var></td> 466 <td>Set the image encoding format use when writing a C-style header. 467 <var>format</var> can be any output format supported by ImageMagick 468 except for <var>h</var> and <var>magick</var>. If this 469 option is omitted, the default is <var>GIF</var> for PseudoClass 470 images and <var>PNM</var> for DirectClass images.</td> 471 </tr> 472 473 <tr> 474 <td>hough-lines:accumulator=true</td> 475 <td>Return the accumulator image in addition to the lines image.</td> 476 </tr> 477 478 <tr> 479 <td>json:features</td> 480 <td>Include features in verbose information.</td> 481 </tr> 482 483 <tr> 484 <td>json:limit</td> 485 <td> </td> 486 </tr> 487 488 <tr> 489 <td>json:locate</td> 490 <td> </td> 491 </tr> 492 493 <tr> 494 <td>json:moments</td> 495 <td>Include image moments in verbose information.</td> 496 </tr> 497 498 <tr> 499 <td>kmeans:seed-colors=<var>color-list</var></td> 500 <td>Initialize the colors, where color-list is a semicolon delimited 501 list of seed colors (e.g. red;sRGB(19,167,254);#00ffff)</td> 502 </tr> 503 504 <tr> 505 <td>magick:format=<var>value</var></td> 506 <td>Set the image encoding format use when writing a C-style header. 507 This is the same as "h:format=format" described above.</td> 508 </tr> 509 510 <tr> 511 <td>magnify:method=<var>value</var></td> 512 <td>Choose the method of pixel art magnification. The choices are: 513 eagle2X, eagle3X, eagle3XB, epb2X, fish2X, hq2X, scale2X (default), 514 scale3X, xbr2X</td> 515 </tr> 516 517 <tr> 518 <td>modulate:colorspace=<var>colorspace</var></td> 519 <td>Define the colorspace to use with <a href="../www/command-line-options.html#modulate">-modulate</a>. 520 Any hue-based colorspace may be use. The default is HSL.</td> 521 </tr> 522 523 <tr> 524 <td>morphology:compose=<var>compose-method</var></td> 525 <td>Specify how to merge results generated by multiple<a 526 href="defines.html#morphology" >-morphology</a> kernel. The default is none. One 527 typical value is 'lighten' as used, for example, with the sobel edge 528 kernels. </td> 529 </tr> 530 531 <tr> 532 <td>morphology:showKernel=<var>1</var></td> 533 <td>Output (to 'standard error') all the information about a generated <a 534 href="defines.html#morphology" >-morphology</a> kernel.</td> 535 </tr> 536 537 <tr> 538 <td>phash:colorspaces=<var>colorspace,colorspace,...</var></td> 539 <td>The perceptual hash defaults to the sRGB and HCLp colorspaces. When 540 using this define, you can specify up to six alternative colorspaces. (as 541 of IM 7.0.3-8)</td> 542 </tr> 543 544 <tr> 545 <td>phash:normalize=<var>true</var></td> 546 <td>Normalize the phash metric by dividing by the number of channels 547 specified by <code>-define phash:colorspaces</code> when using compare 548 -metric phash. (as of IM 7.0.3-8)</td> 549 </tr> 550 551 <tr> 552 <td>profile:skip=<var>name1,name2,...</var></td> 553 <td>Skip the named profile[s] when reading the image. Use skip="*" to 554 skip all named profiles in the image. Many named profiles exist, 555 including ICC, EXIF, APP1, IPTC, XMP, and others.</td> 556 </tr> 557 558 <tr> 559 <td>precision:highres-transform=<var>true</var></td> 560 <td>Increase the profile transform precision. Note, there is a slight 561 performance penalty as the high-precision transform is floating point 562 rather than unsigned. It is important to note that results may depend 563 on whether or not the original image already has an included profile.</td> 564 </tr> 565 566 <tr> 567 <td>preserve-timestamp=<var>true|false</var></td> 568 <td>Preserve file timestamp (<code>mogrify</code> only).</td> 569 </tr> 570 571 <tr> 572 <td>q-table=<var>quantization-table.xml</var></td> 573 <td>Custom JPEG quantization tables.</td> 574 </tr> 575 576 <tr> 577 <td>quantum:format=<var>type</var></td> 578 <td>Set the type to <code>floating-point</code> to specify a floating-point 579 format for raw files (e.g. GRAY:) or for MIFF and TIFF images in HDRI mode 580 to preserve negative values. If <a href="../www/command-line-options.html#depth">-depth</a> 16 is 581 included, the result is a single precision floating point format. 582 If <a href="../www/command-line-options.html#depth">-depth</a> 32 is included, the result is 583 double precision floating point format. For signed pixel data, use <code>-define quantum:format=signed</code></td> 584 </tr> 585 586 <tr> 587 <td>quantum:maximum=<var>value</var></td> 588 <td>Maximum value for certain image types such as DCM. If not set, the 589 the maximum value is QuantumRange.</td> 590 </tr> 591 592 <tr> 593 <td>quantum:minimum=<var>value</var></td> 594 <td>Minimum value for certain image types such as DCM. If not set, the 595 the minimum value is zero.</td> 596 </tr> 597 598 <tr> 599 <td>quantum:polarity=<var>photometric-interpretation</var></td> 600 <td>Set the photometric-interpretation of an image (typically for TIFF 601 image file format) to either <code>min-is-black</code> (default) or 602 <code>min-is-white</code>.</td> 603 </tr> 604 605 <tr> 606 <td>registry:<var>attribute</var>=<var>value</var></td> 607 <td>Set attributes of the image registry, for example, 608 registry:temporary-path=/data/tmp. 609 </td> 610 </tr> 611 612 <tr> 613 <td>resample:verbose=<var>true</var></td> 614 <td>Output the cylindrical filter lookup table created by the EWA 615 (Elliptical Weighted Average) resampling algorithm. Note this table 616 uses a squared radius lookup value. This is typically only used for 617 debugging EWA resampling. 618 </td> 619 </tr> 620 621 <tr> 622 <td>sample:offset=<var>geometry</var></td> 623 <td>Location of the sampling point within the sub-region being sampled, 624 expressed as percentages (see <a href="../www/command-line-options.html#sample" >-sample</a>).</td> 625 </tr> 626 627 <tr> 628 <td>shepards:power=<var>value</var></td> 629 <td>Set the exponent in the Shepard's distortion. The default is 2.</td> 630 </tr> 631 632 <tr> 633 <td>stream:buffer-size=<var>value</var></td> 634 <td>Set the stream buffer size. Select 0 for unbuffered I/O.</td> 635 </tr> 636 637 <tr> 638 <td>trim:percent-background=<var>X%</var></td> 639 <td>Set the amount of background that is tolerated in an edge. It is 640 specified as a percent. 0% means no background is tolerated. 641 50% means an edge can contain up to 50% pixels that are background per 642 the fuzz-factor.</td> 643 </tr> 644 645 <tr> 646 <td>trim:edges={<var>north,east,south,west</var>}</td> 647 <td>Only trim the specified edges of the image.</td> 648 </tr> 649 650 <tr> 651 <td>type:features=<var>string</var></td> 652 <td>Add a font feature to be used by the RAQM delegate during complex 653 text layout. This is usually used to turn on optional font features that 654 are not enabled by default, but can be also used to turn off default font 655 features. Features include those to control kerning, ligature and Arabic.</td> 656 </tr> 657 658 <tr> 659 <td>type:hinting=<var>false</var></td> 660 <td>Disable font hinting. Proper glyph rendering needs the scaled points 661 to be aligned along the target device pixel grid, through an operation 662 often called hinting. One of its main purposes is to ensure that important 663 widths and heights are respected throughout the whole font. (For example, 664 it is very often desirable that the ‘I’ and the ‘T’ glyphs have their 665 central vertical line of the same pixel width. Hinting also manages 666 features like stems and overshoots, which can cause problems at small 667 pixel sizes.</td> 668 </tr> 669 670 <tr> 671 <td>white-balance:vibrance=<var>value{%}</var></td> 672 <td>Change in color vibrance of the a & b channels.</td> 673 </tr> 674 675 <tr> 676 <td>x:screen=<var>true</var></td> 677 <td>Obtain the image from the root window.</td> 678 </tr> 679 680 <tr> 681 <td>x:silent=<var>true</var></td> 682 <td>Turn off the beep when importing an image.</td> 683 </tr> 684 685 <tr> 686 <td colspan=2><p></p></td> 687 </tr> 688 689 <tr> 690 <td colspan=2><p></p></td> 691 </tr> 692 693 <tr> 694 <th align="center" colspan=2>IMAGE FORMATS</th> 695 </tr> 696 697 <tr> 698 <td colspan=2><p></p></td> 699 </tr> 700 701 <tr> 702 <td>bmp3:alpha=<var>true|false</var></td> 703 <td>Include any alpha channel when writing in the BMP image format.</td> 704 </tr> 705 706 <tr> 707 <td>bmp:format=<var>value</var></td> 708 <td>Valid values are <var>bmp2</var>, <var>bmp3</var>, 709 and <var>bmp4</var>. This option can be useful when the 710 method of prepending "BMP2:" to the output filename is inconvenient or 711 is not available, such as when using the <a href="../www/mogrify.html">mogrify</a> utility.</td> 712 </tr> 713 714 <tr> 715 <td>bmp:subtype=<var>value</var></td> 716 <td>BMP channel depth subtypes. The choices are: RGB555, RGB565, ARGB4444, 717 ARGB1555. Only support in BMP (BMP4). BMP3 and BMP2 do not contain header 718 fields to support these options.</td> 719 </tr> 720 721 <tr> 722 <td>dcm:display-range=<var>reset</var></td> 723 <td>Set the display range to the minimum and maximum pixel values for the 724 DCM image format.</td> 725 </tr> 726 727 <tr> 728 <td>dcm:rescale=<var>true</var></td> 729 <td>Enable interpretation of the rescale slope and intercept settings 730 in the file.</td> 731 </tr> 732 733 <tr> 734 <td>dcm:rescale=<var>true</var></td> 735 <td>Enable interpretation of the rescale slope and intercept settings 736 in the file.</td> 737 </tr> 738 739 <tr> 740 <td>dcm:window=<var>CxW</var></td> 741 <td>Specify the dcm window center and width.</td> 742 </tr> 743 744 <tr> 745 <td>dds:cluster-fit=<var>true|false</var></td> 746 <td>Enable the DDS cluster-fit.</td> 747 </tr> 748 749 <tr> 750 <td>dds:compression=<var>dxt1|dxt5|none</var></td> 751 <td>Set the dds compression.</td> 752 </tr> 753 754 <tr> 755 <td>dds:mipmaps=<var>value</var></td> 756 <td>Set the dds number of mipmaps.</td> 757 </tr> 758 759 <tr> 760 <td>dds:weight-by-alpha=<var>true|false</var></td> 761 <td>Enable the DDS alpha weighting.</td> 762 </tr> 763 764 <tr> 765 <td>dng:output-color=<var>value</var></td> 766 <td>Select the output colorspace. The choices are: 767 0 - Raw color (unique to each camera), 768 1 - sRGB D65 (default), 769 2 - Adobe RGB (1998) D65, 770 3 - Wide Gamut RGB D65, 771 4 - Kodak ProPhoto RGB D65, 772 5 - XYZ, 773 6 - ACES</td> 774 </tr> 775 776 <tr> 777 <td>dng:use-auto-bright=<var>false</var></td> 778 <td>Disable the histogram-based white level.</td> 779 </tr> 780 781 <tr> 782 <td>dng:use-auto-wb=<var>true</var></td> 783 <td>Compute the white balance by averaging the entire image.</td> 784 </tr> 785 786 <tr> 787 <td>dng:use-camera-wb=<var>true</var></td> 788 <td>Uses the white balance specified by the camera.</td> 789 </tr> 790 791 <tr> 792 <td>dot:layout-engine=<var>value</var></td> 793 <td>Specify the layout engine for the DOT image format (e.g. 794 <code>neato</code>).</td> 795 </tr> 796 797 <tr> 798 <td>eps:use-cropbox=<var>true</var></td> 799 <td>Force Imagemagick to respect the crop box.</td> 800 </tr> 801 802 <tr> 803 <td>exr:color-type=<var>value</var></td> 804 <td>Specify the color type for the EXR format: RGB, RGBA, YC, YCA, Y, 805 YA, R, G, B, A).</td> 806 </tr> 807 808 <tr> 809 <td>fpx:view=<var>value</var></td> 810 <td>Specify the FlashPix viewing object, which contains the specification 811 of a viewing transform. The viewing transform enables applications to 812 represent a set of simple edits as a list of "commands" which are applied 813 to the image in real time without altering the original image.</td> 814 </tr> 815 816 <tr> 817 <td>heic:preserve-orientation=<var>true</var></td> 818 <td>Preserve the original EXIF orientation during HEIC decoding and rotate 819 the pixels accordingly. By default, EXIF orientation is reset to "1" to 820 match the actual orientation of pixels in HEIC. 821 </td> 822 </tr> 823 824 <tr> 825 <td>icon:auto-resize</td> 826 <td>Automatically stores multiple sizes when writing an ico image (requires a 256x256 input image).</td> 827 </tr> 828 829 <tr> 830 <td>jp2:layer-number=<var>value</var></td> 831 <td>Set the maximum number of quality layers to decode. Same for JPT, JC2, 832 and J2K.</td> 833 </tr> 834 835 <tr> 836 <td>jp2:number-resolutions=<var>value</var></td> 837 <td>Set the number of resolutions to encode.Same for JPT, JC2, and 838 J2K.</td> 839 </tr> 840 841 <tr> 842 <td>jp2:progression-order=<var>value</var></td> 843 <td>Choose from LRCP, RLCP, RPCL, PCRL or CPRL. Same for JPT, JC2, and 844 J2K.</td> 845 </tr> 846 847 <tr> 848 <td>jp2:quality=<var>value,value...</var></td> 849 <td>Set the quality layer PSNR, given in dB. The order is from left to 850 right in ascending order. The default is a single lossless quality layer. 851 Same for JPT, JC2, and J2K.</td> 852 </tr> 853 854 <tr> 855 <td>jp2:rate=<var>value</var></td> 856 <td>Specify the compression factor to use while writing JPEG-2000 files. 857 The compression factor is the reciprocal of the compression ratio. The 858 valid range is 0.0 to 1.0, with 1.0 indicating lossless compression. If 859 defined, this value overrides the -quality setting. A quality setting 860 of 75 results in a rate value of 0.06641. Same for JPT, JC2, and J2K.</td> 861 </tr> 862 863 <tr> 864 <td>jp2:reduce-factor=<var>value</var></td> 865 <td>Set the number of highest resolution levels to be discarded.Same for 866 JPT, JC2, and J2K.</td> 867 </tr> 868 869 <tr> 870 <td>jpeg:block-smoothing=<var>on|off</var></td> 871 <td> </td> 872 </tr> 873 874 <tr> 875 <td>jpeg:colors=<var>value</var></td> 876 <td>Set the desired number of colors and let the JPEG encoder do the 877 quantizing.</td> 878 </tr> 879 880 <tr> 881 <td>jpeg:dct-method=<var>value</var></td> 882 <td>Choose from <code>default</code>, <code>fastest</code>, 883 <code>float</code>, <code>ifast</code>, and <code>islow</code>.</td> 884 </tr> 885 886 <tr> 887 <td>jpeg:extent=<var>value</var></td> 888 <td>Restrict the maximum JPEG file size, for example <code>-define 889 jpeg:extent=400KB</code>. The JPEG encoder will search for the highest 890 compression quality level that results in an output file that does not 891 exceed the value. The <code>-quality</code> option also will be respected 892 starting with version 6.9.2-5. Between 6.9.1-0 and 6.9.2-4, add -quality 893 100 in order for the jpeg:extent to work properly. Prior to 6.9.1-0, the 894 -quality setting was ignored.</td> 895 </tr> 896 897 <tr> 898 <td>jpeg:fancy-upsampling=<var>on|off</var></td> 899 <td> </td> 900 </tr> 901 902 <tr> 903 <td>jpeg:optimize-coding=<var>on|off</var></td> 904 <td> </td> 905 </tr> 906 907 <tr> 908 <td>jpeg:q-table=<var>table</var></td> 909 <td> </td> 910 </tr> 911 912 <tr> 913 <td>jpeg:sampling-factor=<var>sampling-factor-string</var></td> 914 <td> </td> 915 </tr> 916 917 <tr> 918 <td>jpeg:size=<var>geometry</var></td> 919 <td>Set the size hint of a JPEG image, for 920 example, <code>-define jpeg:size=128x128</code>. 921 It is most useful for increasing performance and reducing the memory 922 requirements when reducing the size of a large JPEG image.</td> 923 </tr> 924 925 <tr> 926 <td>mng:need-cacheoff</td> 927 <td>turn playback caching off for streaming MNG.</td> 928 </tr> 929 930 <tr> 931 <td>pcl:fit-to-page=<var>true</var></td> 932 <td> </td> 933 </tr> 934 935 <tr> 936 <td>pdf:fit-page=<var>geometry</var></td> 937 <td><var>Geometry</var> specifies the scaling dimensions for resizing when the PDF is being read. The geometry is either WxH{%} or page size. No offsets are allowed. (introduced in IM 6.8.8-8)</td> 938 </tr> 939 940 <tr> 941 <td>pdf:fit-to-page=<var>true</var></td> 942 <td> </td> 943 </tr> 944 945 <tr> 946 <td>pdf:interpolate=<var>true</var></td> 947 <td>enable interpolation while rendering</td> 948 </tr> 949 950 <tr> 951 <td>pdf:page-direction=<var>right-to-left</var></td> 952 <td> </td> 953 </tr> 954 955 <tr> 956 <td>pdf:stop-on-error=<var>true</var></td> 957 <td> </td> 958 </tr> 959 960 <tr> 961 <td>pdf:thumbnail=<var>false</var></td> 962 <td>Skip writing a thumbnail when saving a PDF file.</td> 963 </tr> 964 965 <tr> 966 <td>pdf:use-cropbox=<var>true</var></td> 967 <td> </td> 968 </tr> 969 970 <tr> 971 <td>pdf:use-trimbox=<var>true</var></td> 972 <td> </td> 973 </tr> 974 975 <tr> 976 <td>png:bit-depth=<var>value</var></td> 977 <td> </td> 978 </tr> 979 980 <tr> 981 <td>png:color-type=<var>value</var></td> 982 <td>Desired bit-depth and color-type for PNG output. You can force the 983 PNG encoder to use a different bit-depth and color-type than it would have 984 normally selected, but only if this does not cause any loss of image 985 quality. Any attempt to reduce image quality is treated as an error and no 986 PNG file is written. E.g., if you have a 1-bit black-and-white image, you 987 can use these "defines" to cause it to be written as an 8-bit grayscale, 988 indexed, or even a 64-bit RGBA. But if you have a 16-million color image, 989 you cannot force it to be written as a grayscale or indexed PNG. If you 990 wish to do this, you must use the appropriate <a href="../www/command-line-options.html#depth">-depth</a>, 991 <a href="../www/command-line-options.html#colors">-colors</a>, or <a href="../www/command-line-options.html#type">-type</a> directives to 992 reduce the image quality prior to using the PNG encoder. Note that in 993 indexed PNG files, "bit-depth" refers to the number of bits per index, 994 which can be 1, 2, 4, or 8. In such files, the color samples always have 995 8-bit depth.</td> 996 </tr> 997 998 <tr> 999 <td>png:compression-filter=<var>value</var></td> 1000 <td>Valid values are 0 through 9. 0-4 are the corresponding PNG filters, 1001 5 means adaptive filtering except for images with a colormap, 6 means 1002 adaptive filtering for all images, 7 means MNG "loco" compression, 8 means 1003 Z_RLE strategy with adaptive filtering, and 9 means Z_RLE strategy with no 1004 filtering.</td> 1005 </tr> 1006 1007 <tr> 1008 <td>png:compression-level=<var>value</var></td> 1009 <td>Valid values are 0 through 9, with 0 providing the least, but fastest 1010 compression and 9 usually providing the best and always the slowest.</td> 1011 </tr> 1012 1013 <tr> 1014 <td>png:compression-strategy=<var>value</var></td> 1015 <td>Valid values are 0 through 4, meaning default, filtered, huffman_only, 1016 rle, and fixed ZLIB compression strategy. If you are using an old zlib 1017 that does not support Z_RLE (before 1.2.0) or Z_FIXED (before 1.2.2.2), 1018 values 3 and 4, respectively, will use the zlib default strategy 1019 instead.</td> 1020 </tr> 1021 1022 <tr> 1023 <td>png:format=<var>value</var></td> 1024 <td> valid values are <var>png8</var>, <var>png24</var>, 1025 <var>png32</var>, <var>png48</var>, 1026 <var>png64</var>, and <var>png00</var>. 1027 This property is useful for specifying 1028 the specific PNG format to be used, when the usual method of prepending the 1029 format name to the output filename is inconvenient, such as when writing 1030 a PNG-encoded ICO file or when using <a href="../www/mogrify.html">mogrify</a>. 1031 Value = <var>png8</var> reduces the number of colors to 256, 1032 only one of which may be fully transparent, if necessary. The other 1033 values do not force any reduction of quality; it is an error to request 1034 a format that cannot represent the image data without loss (except that 1035 it is allowed to reduce the bit-depth from 16 to 8 for all formats). 1036 Value = <var>png24</var> and <var>png48</var> 1037 allow transparency, only if a single color is fully transparent and that 1038 color does not also appear in an opaque pixel; such transparency is 1039 written in a PNG <code>tRNS</code> chunk. 1040 Value = <var>png00</var> causes the image to inherit its 1041 color-type and bit-depth from the input image, if the input was also 1042 a PNG.</td> 1043 </tr> 1044 1045 <tr> 1046 <td>png:exclude-chunk=<var>value</var></td> 1047 <td> </td> 1048 </tr> 1049 1050 <tr> 1051 <td>png:include-chunk=<var>value</var></td> 1052 <td>ancillary chunks to be excluded from or included in PNG output. 1053 1054 <p>The <var>value</var> can be the name of a PNG chunk-type such 1055 as <var>bKGD</var>, a comma-separated list of chunk-names 1056 (which can include the word <var>date</var>, the word 1057 <var>all</var>, or the word <var>none</var>). 1058 Although PNG chunk-names are case-dependent, you can use all lowercase 1059 names if you prefer.</p> 1060 1061 <p>The "include-chunk" and "exclude-chunk" lists only affect the behavior 1062 of the PNG encoder and have no effect on the PNG decoder.</p> 1063 1064 <p>As a special case, if the <code>sRGB</code> chunk is excluded and 1065 the <code>gAMA</code> chunk is included, the <code>gAMA</code> chunk will 1066 only be written if gamma is not 1/2.2, since most decoders assume 1067 sRGB and gamma=1/2.2 when no colorspace information is included in 1068 the PNG file. Because the list is processed from left to right, you 1069 can achieve this with a single define:</p> 1070 1071 <pre class="highlight"><code>-define png:include-chunk=none,gAMA 1072 </code></pre> 1073 1074 <p>As a special case, if the <code>sRGB</code> chunk is not excluded and 1075 the PNG encoder recognizes that the image contains the sRGB ICC profile, 1076 the PNG encoder will write the <code>sRGB</code> chunk instead of the 1077 entire ICC profile. To force the PNG encoder to write the sRGB 1078 profile as an <code>iCCP</code> chunk in the output PNG instead of the 1079 <code>sRGB</code> chunk, exclude the <code>sRGB</code> chunk.</p> 1080 1081 <p>The critical PNG chunks <code>IHDR</code>, <code>PLTE</code>, 1082 <code>IDAT</code>, and <code>IEND</code> cannot be excluded. Any such 1083 entries appearing in the list will be ignored.</p> 1084 1085 <p>If the ancillary PNG <code>tRNS</code> chunk is excluded and the 1086 image has transparency, the PNG colortype is forced to be 4 or 6 1087 (GRAY_ALPHA or RGBA). If the image is not transparent, then the 1088 <code>tRNS</code> chunk isn't written anyhow, and there is no effect 1089 on the PNG colortype of the output image.</p> 1090 1091 <p>The <a href="../www/command-line-options.html#strip">-strip</a> 1092 option does the equivalent of the following for PNG output:</p> 1093 1094 <pre class="highlight"><code>-define png:exclude-chunk=EXIF,iCCP,iTXt,sRGB,tEXt,zCCP,zTXt,date</code></pre> 1095 1096 <p>The default behavior is to include all known PNG ancillary chunks 1097 plus ImageMagick's private <code>vpAg</code> ("virtual page") chunk, 1098 and to exclude all PNG chunks that are unknown to ImageMagick, 1099 regardless of their PNG "copy-safe" status as described in the 1100 PNG specification.</p> 1101 1102 <p>Any chunk names that are not known to ImageMagick are ignored 1103 if they appear in either the "include-chunk" or "exclude-chunk" list. 1104 The ancillary chunks currently known to ImageMagick are 1105 <code>bKGD</code>, <code>cHRM</code>, <code>gAMA</code>, <code>iCCP</code>, 1106 <code>oFFs</code>, <code>pHYs</code>, <code>sRGB</code>, <code>tEXt</code>, 1107 <code>tRNS</code>, <code>vpAg</code>, and <code>zTXt</code>.</p> 1108 1109 <p>You can also put <code>date</code> in the list to include or exclude 1110 the "Date:create" and "Date:modify" text chunks that ImageMagick normally 1111 inserts in the output PNG.</p></td> 1112 </tr> 1113 1114 <tr> 1115 <td>png:ignore-crc[=<var>true</var>]</td> 1116 <td>When you know your image has no CRC or ADLER32 errors, this can speed 1117 up decoding. It is also helpful in debugging bug reports from "fuzzers".</td> 1118 </tr> 1119 1120 <tr> 1121 <td>png:preserve-colormap[=<var>true</var>]</td> 1122 <td>Use the existing image->colormap. Normally the PNG encoder will 1123 try to optimize the palette, eliminating unused entries and putting 1124 the transparent colors first. If this flag is set, that behavior 1125 is suppressed.</td> 1126 </tr> 1127 1128 <tr> 1129 <td>png:preserve-iCCP[=<var>true</var>]</td> 1130 <td>By default, the PNG decoder and encoder examine any ICC profile 1131 that is present, either from an <code>iCCP</code> chunk in the PNG 1132 input or supplied via an option, and if the profile is recognized 1133 to be the sRGB profile, converts it to the <code>sRGB</code> chunk. 1134 You can use <code>-define png:preserve-iCCP</code> to prevent 1135 this from happening; in such cases the <code>iCCP</code> chunk 1136 will be read or written and no <code>sRGB</code> chunk will be 1137 written. There are some ICC profiles that claim to be sRGB but 1138 have various errors that cause them to be rejected by libpng16; such 1139 profiles are recognized anyhow and converted to the <code>sRGB</code> 1140 chunk, but are rejected if the <code>-define png:preserve-iCCP</code> 1141 is present. Note that not all "sRGB" ICC profiles are recognized 1142 yet; we will add them to the list as we encounter them.</td> 1143 </tr> 1144 1145 <tr> 1146 <td>png:swap-bytes[=<var>true</var>]</td> 1147 <td>The PNG specification requires that any multi-byte integers be stored 1148 in network byte order (MSB-LSB endian). This option allows you to 1149 fix any invalid PNG files that have 16-bit samples stored incorrectly 1150 in little-endian order (LSB-MSB). The "-define png:swap-bytes" option 1151 must appear before the input filename on the commandline. The swapping 1152 is done during the libpng decoding operation.</td> 1153 </tr> 1154 1155 <tr> 1156 <td>ps:imagemask</td> 1157 <td>If the ps:imagemask flag is defined, the PS3 and EPS3 coders will 1158 create Postscript files that render bilevel images with the Postscript 1159 imagemask operator instead of the image operator.</td> 1160 </tr> 1161 1162 <tr> 1163 <td>psd:additional-info=all|selective</td> 1164 <td>This option should only be used when converting from a PSD file to 1165 another PSD file. This should be placed after the image is read. The two 1166 options are 'all' and 'selective'. The 'selective' option will preserve 1167 all additional information that is not related to the geometry of the 1168 image. The 'all' option should only be used when the geometry of the 1169 image has not been changed. This option is helpful when transferring 1170 non-simple layers, such as adjustment layers from the input PSD file to 1171 the output PSD file. If this option is not used, the additional 1172 information will not be preserved. This define is available as of 1173 Imagemagick version 6.9.5-8. 1174 </td> 1175 </tr> 1176 1177 <tr> 1178 <td>psd:alpha-unblend=off</td> 1179 <td>Disable new automatic un-blending of transparency with the base image 1180 for the flattened layer 0 before adding the alpha channel to the output 1181 image. This define must be placed before the input psd image. (Available 1182 as of IM 6.9.2.5). The automatic un-blending is new to IM 6.9.2.5 and 1183 prevents the transparency from being applied twice in the output 1184 image. This option should be set before reading the image.</td> 1185 </tr> 1186 1187 <tr> 1188 <td>psd:preserve-opacity-mask=<var>true</var></td> 1189 <td>This option should only be used when converting from a PSD file to 1190 another PSD file. It will preserve the opacity mask of a layer and add it 1191 back to the layer when the image is saved. Setting this to 'true' will 1192 enable this feature. This define is available as of Imagemagick version 1193 6.9.5-10. 1194 </td> 1195 </tr> 1196 1197 <tr> 1198 <td>svg:xml-parse-huge=<var>true</var></td> 1199 <td>Enable rendering of a very large SVG for which you trust the source</td> 1200 </tr> 1201 1202 <tr> 1203 <td>tiff:alpha=<var>associated|unassociated|unspecified</var></td> 1204 <td>Specify the alpha extra samples as associated, unassociated or 1205 unspecified.</td> 1206 </tr> 1207 1208 <tr> 1209 <td>tiff:endian=<var>msb|lsb</var></td> 1210 <td> </td> 1211 </tr> 1212 1213 <tr> 1214 <td>tiff:exif-properties=<var>true</var></td> 1215 <td>Enable reading the EXIF properties.</td> 1216 </tr> 1217 1218 <tr> 1219 <td>tiff:fill-order=<var>msb|lsb</var></td> 1220 <td> </td> 1221 </tr> 1222 1223 <tr> 1224 <td>tiff:ignore-layers=<var>true</var></td> 1225 <td>Ignore the Photoshop layers.</td> 1226 </tr> 1227 1228 <tr> 1229 <td>tiff:ignore-tags=<var>comma-separate-list-of-tag-IDs</var></td> 1230 <td>Allow one or more tag ID values to be ignored.</td> 1231 </tr> 1232 1233 <tr> 1234 <td>tiff:predictor=<var>[1, 2 or 3]</var></td> 1235 <td>A mathematical operator that is applied to the image data before an 1236 encoding scheme is applied. The general idea is that subsequent pixels of 1237 an image resemble each other. Thus, substracting the information from a 1238 pixel that is already contained in previous one is likely to reduce its 1239 information density considerably and aid subsequent compression. 1240 1 = No prediction scheme used before coding. 2 = Horizontal differencing. 1241 3 = Floating point horizontal differencing.</td> 1242 </tr> 1243 1244 <tr> 1245 <td>tiff:preserve-compression=<var>true</var></td> 1246 <td>Preserve compression of the source image.</td> 1247 </tr> 1248 1249 <tr> 1250 <td>tiff:rows-per-strip=<var>value</var></td> 1251 <td>Set the number of rows per strip.</td> 1252 </tr> 1253 1254 <tr> 1255 <td>tiff:tile-geometry=<var>WxH</var></td> 1256 <td>Set the tile size for pyramid tiffs. Requires the suffix 1257 PTIF: before the outputname.</td> 1258 </tr> 1259 1260 <tr> 1261 <td colspan=2><p></p></td> 1262 </tr> 1263 1264 <tr> 1265 <td colspan=2><p></p></td> 1266 </tr> 1267 1268 <tr> 1269 <th align="center" colspan=2>PSEUDO-IMAGE FORMATS</th> 1270 </tr> 1271 1272 <tr> 1273 <td>caption:max-pointsize=<var>pointsize</var></td> 1274 <td>Limit the maximum point size</td> 1275 </tr> 1276 1277 <tr> 1278 <td>gradient:angle=<var>angle (in degrees)</var></td> 1279 <td>For a linear gradient, this specifies the direction of 1280 the gradient going from color1 to color2 in a clockwise 1281 positive manner relative to north (up). For a radial 1282 gradient, this specifies the rotation of the gradient in a 1283 clockwise positive manner from its normal X-Y orientation. 1284 Supported in Imagemagick 6.9.2-5.</td> 1285 </tr> 1286 1287 <tr> 1288 <td>gradient:bounding-box=<var>WxH+X+Y</var></td> 1289 <td>Limit the gradient to a larger or smaller region than 1290 the image dimensions. If the region defined by the bounding 1291 box is smaller than the image, then color1 will be the color 1292 of the background. 1293 Supported in Imagemagick 6.9.2-5.</td> 1294 </tr> 1295 1296 <tr> 1297 <td>gradient:center=<var>x,y</var></td> 1298 <td>Specify the coordinates of the center point for the 1299 radial gradient. The default is the center of the image. 1300 Supported in Imagemagick 6.9.2-5.</td> 1301 </tr> 1302 1303 <tr> 1304 <td>gradient:direction=<var>value</var></td> 1305 <td>Specify the direction of the linear gradient towards 1306 the top/bottom/left/right or diagonal corners. The choices are: 1307 NorthWest, North, Northeast, West, East, SouthWest, South, SouthEast. 1308 Supported in Imagemagick 6.9.2-5.</td> 1309 </tr> 1310 1311 <tr> 1312 <td>gradient:extent=<var>value</var></td> 1313 <td>Specify the shape of an image centered radial gradient. 1314 The choices are: Circle, Diagonal, Ellipse, Maximum, Minimum. 1315 Circle and Maximum draw a circular radial gradient even for 1316 rectangular shaped images of radius equal to the larger of 1317 the half-width and half-height of the image. The Circle and 1318 Maximum options are both equivalent to the default radial 1319 gradient. The Minimum option draws a circular radial gradient 1320 even for rectangular shaped images of radius equal to the 1321 smaller of the half-width and half-height of the image. 1322 The Diagonal option draws a circular radial gradient even 1323 for rectangular shaped images of radius equal to the 1324 half-diagonal of the image. The Ellipse options draws an 1325 elliptical radial gradient for rectangular shaped images of 1326 radii equal to half the width and half the height of the image. 1327 Supported in Imagemagick 6.9.2-5.</td> 1328 </tr> 1329 1330 <tr> 1331 <td>gradient:radii=<var>x,y</var></td> 1332 <td>Specify the x and y radii of the gradient. If the 1333 x radius and the y radius are equal, the shape of the 1334 radial gradient will be a circle. If they differ, then 1335 the shape will be an ellipse. The default values are the 1336 maximum of the half width and half height of the image. 1337 Supported in Imagemagick 6.9.2-5.</td> 1338 </tr> 1339 1340 <tr> 1341 <td>gradient:vector=<var>x1,y1,x2,y2</var></td> 1342 <td>Specify the direction of the linear gradient going from 1343 vector1 (x1,y1) to vector2 (x2,y2). Color1 (fromColor) will be 1344 located at vector position x1,y1 and color2 (toColor) will be 1345 located at vector position x2,y2. 1346 Supported in Imagemagick 6.9.2-5.</td> 1347 </tr> 1348 1349 <tr> 1350 <td>histogram:unique-colors=<var>false</var></td> 1351 <td>Suppress the textual listing of the image's unique colors.</td> 1352 </tr> 1353 1354 <tr> 1355 <td>pango:align=<var>left|center|right</var></td> 1356 <td></td> 1357 </tr> 1358 1359 <tr> 1360 <td>pango:auto-dir=<var>true|false</var></td> 1361 <td></td> 1362 </tr> 1363 1364 <tr> 1365 <td>pango:ellipsize=<var>start|middle|end</var></td> 1366 <td></td> 1367 </tr> 1368 1369 <tr> 1370 <td>pango:gravity-hint=<var>natural|strong|line</var></td> 1371 <td></td> 1372 </tr> 1373 1374 <tr> 1375 <td>pango:hinting=<var>none|auto|full</var></td> 1376 <td></td> 1377 </tr> 1378 1379 <tr> 1380 <td>pango:indent=<var>points</var></td> 1381 <td></td> 1382 </tr> 1383 1384 <tr> 1385 <td>pango:justify=<var>true|false</var></td> 1386 <td></td> 1387 </tr> 1388 1389 <tr> 1390 <td>pango:language=<var>en_US|others</var></td> 1391 <td></td> 1392 </tr> 1393 1394 <tr> 1395 <td>pango:markup=<var>true|false</var></td> 1396 <td></td> 1397 </tr> 1398 1399 <tr> 1400 <td>pango:single-paragraph=<var>true|false</var></td> 1401 <td></td> 1402 </tr> 1403 1404 <tr> 1405 <td>pango:wrap=<var>word|char|word-char</var></td> 1406 <td></td> 1407 </tr> 1408 1409 <tr> 1410 <td>pixel:compliance=<var>value</var></td> 1411 <td>Set the "pixel:" output format according to several standards. 1412 The choices are SVG, None, Undefined, MVG, X11, XPM. The default 1413 list values for (s)RGB colors in the form of (s)rgb(r,g,b) or 1414 (s)rgba(r,g,b,a). Color names will no longer be presented. For sRGB or 1415 RGB colors, the SVG, X11, XPM and None options lists color names, 1416 if they exist. The MVG and Undefined options list hex values. When 1417 colors are presented or converted to hue-based colorspaces, the values 1418 listed will be integers for hue and percents for the other two components. 1419 For other colorspaces, values may be listed as either percents or 1420 fractional value. Setting the depth to 8 will limit values to the 8-bit 1421 range, except for hue-based colors.</td> 1422 </tr> 1423 1424 <tr> 1425 <td>txt:compliance=<var>value</var></td> 1426 <td>Set the "txt:" format for the values in parentheses according to 1427 several standards. The choices are svg, none, undefined, mvg, x11, xpm. 1428 The default will list values for (s)RGB colors in the quantum range. 1429 The SVG, X11, XPM, MVG and None options lists values in the 8-bit range 1430 for all Q-level compiles. The undefined option also lists values in the 1431 quantum range. When colors are presented or converted to hue-based 1432 colorspaces, the values listed will be integers for hue and percents for 1433 the other two components. For other colorspaces, values may be listed as 1434 either percents or fractional value. Setting the depth to 8 will limit 1435 values to the 8-bit range, except for hue-based colors.</td> 1436 </tr> 1437 1438 <tr> 1439 <td colspan=2><p></p></td> 1440 </tr> 1441 1442 <tr> 1443 <td colspan=2><p></p></td> 1444 </tr> 1445 1446 <tr> 1447 <th align="center" colspan=2>Identify Defines</th> 1448 </tr> 1449 1450 <tr> 1451 <td colspan=2><p></p></td> 1452 </tr> 1453 1454 <tr> 1455 <td>identify:locate=<var>minimum|maximum</var></td> 1456 <td>Locate the coordinates of one or more image minimum or maximum.</td> 1457 </tr> 1458 1459 <tr> 1460 <td>identify:limit=<var>number</var></td> 1461 <td>Locate the coordinates for the number of minima or maxima specified.</td> 1462 </tr> 1463 1464</table> 1465 1466</div> 1467</div> 1468 </div> 1469 </main><!-- /.container --> 1470 <footer class="magick-footer"> 1471 <div class="container-fluid"> 1472 <a href="../www/security-policy.html">Security</a> • 1473 <a href="../www/news.html">News</a> 1474 1475 <a href="defines.html#"><img class="d-inline" id="wand" alt="And Now a Touch of Magick" width="16" height="16" src="../images/wand.ico"/></a> 1476 1477 <a href="../www/links.html">Related</a> • 1478 <a href="../www/sitemap.html">Sitemap</a> 1479 <br/> 1480 <a href="../www/support.html">Sponsor</a> • 1481 <a href="../www/cite.html">Cite</a> • 1482 <a href="http://pgp.mit.edu/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> • 1483 <a href="../www/https://imagemagick.org/script/contact.php">Contact Us</a> 1484 <br/> 1485 <a href="https://github.com/imagemagick/imagemagick" target="_blank" rel="noopener" aria-label="GitHub"><svg xmlns="http://www.w3.org/2000/svg" class="navbar-nav-svg" viewBox="0 0 512 499.36" width="2%" height="2%" role="img" focusable="false"><title>GitHub</title><path fill="currentColor" fill-rule="evenodd" d="M256 0C114.64 0 0 114.61 0 256c0 113.09 73.34 209 175.08 242.9 12.8 2.35 17.47-5.56 17.47-12.34 0-6.08-.22-22.18-.35-43.54-71.2 15.49-86.2-34.34-86.2-34.34-11.64-29.57-28.42-37.45-28.42-37.45-23.27-15.84 1.73-15.55 1.73-15.55 25.69 1.81 39.21 26.38 39.21 26.38 22.84 39.12 59.92 27.82 74.5 21.27 2.33-16.54 8.94-27.82 16.25-34.22-56.84-6.43-116.6-28.43-116.6-126.49 0-27.95 10-50.8 26.35-68.69-2.63-6.48-11.42-32.5 2.51-67.75 0 0 21.49-6.88 70.4 26.24a242.65 242.65 0 0 1 128.18 0c48.87-33.13 70.33-26.24 70.33-26.24 14 35.25 5.18 61.27 2.55 67.75 16.41 17.9 26.31 40.75 26.31 68.69 0 98.35-59.85 120-116.88 126.32 9.19 7.9 17.38 23.53 17.38 47.41 0 34.22-.31 61.83-.31 70.23 0 6.85 4.61 14.81 17.6 12.31C438.72 464.97 512 369.08 512 256.02 512 114.62 397.37 0 256 0z"/></svg></a> • 1486 <a href="https://twitter.com/imagemagick" target="_blank" rel="noopener" aria-label="Twitter"><svg xmlns="http://www.w3.org/2000/svg" class="navbar-nav-svg" viewBox="0 0 512 416.32" width="2%" height="2%" role="img" focusable="false"><title>Twitter</title><path fill="currentColor" d="M160.83 416.32c193.2 0 298.92-160.22 298.92-298.92 0-4.51 0-9-.2-13.52A214 214 0 0 0 512 49.38a212.93 212.93 0 0 1-60.44 16.6 105.7 105.7 0 0 0 46.3-58.19 209 209 0 0 1-66.79 25.37 105.09 105.09 0 0 0-181.73 71.91 116.12 116.12 0 0 0 2.66 24c-87.28-4.3-164.73-46.3-216.56-109.82A105.48 105.48 0 0 0 68 159.6a106.27 106.27 0 0 1-47.53-13.11v1.43a105.28 105.28 0 0 0 84.21 103.06 105.67 105.67 0 0 1-47.33 1.84 105.06 105.06 0 0 0 98.14 72.94A210.72 210.72 0 0 1 25 370.84a202.17 202.17 0 0 1-25-1.43 298.85 298.85 0 0 0 160.83 46.92"/></svg></a> 1487 <br/> 1488 <small>© 1999-2021 ImageMagick Studio LLC</small> 1489 </div> 1490 </footer> 1491 1492 <!-- Javascript assets --> 1493 <script src="assets/magick.js" ></script> 1494 </body> 1495</html> 1496<!-- Magick Cache 13th February 2021 11:54 -->
