granicus.if.org Git - imagemagick/blob - www/escape.html

   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, shrink-to-fit=no" />
  10   <meta http-equiv="x-ua-compatible" content="ie=edge" />
  11   <title>Format and Print Image Properties @ ImageMagick</title>
  12   <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
  13   <meta name="application-name" content="ImageMagick"/>
  14   <meta name="description" content="ImageMagick® is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves."/>
  15   <meta name="application-url" content="https://www.imagemagick.org"/>
  16   <meta name="generator" content="PHP"/>
  17   <meta name="keywords" content="format, print, image, properties, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert"/>
  18   <meta name="rating" content="GENERAL"/>
  19   <meta name="robots" content="INDEX, FOLLOW"/>
  20   <meta name="generator" content="ImageMagick Studio LLC"/>
  21   <meta name="author" content="ImageMagick Studio LLC"/>
  22   <meta name="revisit-after" content="2 DAYS"/>
  23   <meta name="resource-type" content="document"/>
  24   <meta name="copyright" content="Copyright (c) 1999-2017 ImageMagick Studio LLC"/>
  25   <meta name="distribution" content="Global"/>
  26   <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1"/>
  27   <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
  28   <link rel="canonical" href="https://www.imagemagick.org/script/escape.html"/>
  29   <link rel="icon" href="../images/wand.png"/>
  30   <link rel="shortcut icon" href="../images/wand.ico"/>
  31   <link rel="stylesheet" type="text/css" href="http://fonts.googleapis.com/css?family=Roboto:900,400,400italic,700,700italic,300,300italic|Open+Sans:300italic,400italic,700italic,300,400,600,700" />
  32   <link rel="stylesheet" href="css/magick.css"/>
  33 </head>
  34 <body>
  35 <div class="main">
  36 <div class="magick-masthead">
  37   <div class="container">
  38     <script async="async" src="http://localhost/pagead/js/adsbygoogle.js"></script>    <ins class="adsbygoogle"
  39          style="display:block"
  40          data-ad-client="ca-pub-3129977114552745"
  41          data-ad-slot="6345125851"
  42          data-ad-format="auto"></ins>
  43     <script>
  44       (adsbygoogle = window.adsbygoogle || []).push({});
  45     </script>
  46     <nav class="magick-nav">
  47       <a class="magick-nav-item " href="../index.html">Home</a>
  48       <a class="magick-nav-item " href="binary-releases.html">Download</a>
  49       <a class="magick-nav-item " href="command-line-tools.html">Tools</a>
  50       <a class="magick-nav-item " href="command-line-processing.html">Command-line</a>
  51       <a class="magick-nav-item " href="resources.html">Resources</a>
  52       <a class="magick-nav-item " href="api.html">Develop</a>
  53       <a class="magick-nav-item " href="https://www.imagemagick.org/script/search.php">Search</a>
  54       <a class="magick-nav-item pull-right" href="https://www.imagemagick.org/discourse-server/">Community</a>
  55     </nav>
  56   </div>
  57 </div>
  58 <div class="container">
  59 <div class="magick-header">
  60 <p class="lead magick-description">There are copious amounts of extra data associated with images (metadata), beyond the actual image pixels. This metadata can be useful, either for display, or for various calculations, or in modifying the behavior of later image processing operations.  You can utilize percent escapes in a number of options, for example in <a href="command-line-options.html#format_identify_">-format</a> or in montage <a href="command-line-options.html#label" >-label</a>, to print various properties and other settings associated with an image.</p>
  61
  62 <div class="table-responsive">
  63 <table class="table table-striped">
  64 <tr>
  65     <td><b>Profile Data</b></td>
  66     <td>Such as EXIF: data, containing focal lengths, exposures, dates, and in
  67         come cases GPS locations.
  68     </td></tr>
  69 <tr>
  70     <td><b>Attributes</b></td>
  71     <td>These are directly involved with image data, and more commonly
  72         modified as part of normal image processing.  These include
  73         width, height, depth, image type (colorspace), timing delays, and
  74         background color. Most specific percent escapes is to access this
  75         information.
  76     </td></tr>
  77 <tr>
  78     <td><b>Properties</b></td>
  79     <td>These are stored as a table of free form strings, and are (if possible)
  80         saved with the image (especially in MIFF and PNG image file formats).
  81         These include: Labels, Captions, Comments.
  82     </td></tr>
  83 <tr>
  84     <td><b>Artifacts</b></td>
  85     <td>These are various operational (expert) settings that are saved for
  86         use by various operators, or by the user for future use.  It is just
  87         a table of free-form strings.  They are not saved with the image when
  88         written.  See Artifacts and Options below for details.
  89     </td></tr>
  90 <tr>
  91     <td><b>Options</b></td>
  92     <td>Also operational (expert) settings that are saved for
  93         use by various operators, but are set globally for use by a whole
  94         image list (also not saved).  See Artifacts and Options below.
  95     </td></tr>
  96 </table></div>
  97
  98 <h3 class="magick-header">Percent Escape Handling</h3>
  99
 100 <p>If you request a percent escape such as <code>%[key]</code> the setting
 101 is looked for in the following order until the first match has been
 102 found...</p>
 103
 104 <ol>
 105 <li>Handle special prefixes such as 'artifact:' 'option:' 'exif:', or
 106     'fx:'.  This includes and calculations and or globs of those prefixes such
 107     as 'exif:*' or 'artifact:*' (see below).</li>
 108
 109 <li>If <code>key</code> contains a glob pattern (but no known prefix)
 110     search free-form properties table.</li>
 111
 112 <li>If <code>key</code> is a special image 'attribute' name (see list
 113     above) return the associated or calculated image attribute.</li>
 114
 115 <li>Search for setting as a free-form 'property'</li>
 116 <li>Search for setting as a free-form 'artifact'</li>
 117 <li>Search for setting as a free-form 'option'</li>
 118
 119 <li>Replace escape with empty string, and perhaps produce a warning.</li>
 120 </ol>
 121
 122 <p>Remember, all long name forms of percent escapes are handled in a is case
 123 insensitive manner. </p>
 124
 125 <p><b>As of IM v6.8.0-5</b> you can now access the Artifact and Option
 126 free-form string tables directly, allowing you to override the above sequence,
 127 and avoid accessing an attribute or property of the same name.</p>
 128
 129 <pre>
 130 %[artifact:<var>setting</var>]
 131 %[option:<var>setting</var>]
 132 </pre>
 133
 134
 135 <h3 class="magick-header">Single Letter Attribute Percent Escapes</h3>
 136
 137 <p>Here are common single letter escapes (short form) is used to report the most
 138 common attributes and properties of an image, such as: the image filename
 139 filename, type, width, height. </p>
 140
 141 <div class="table-responsive">
 142 <table class="table table-condensed table-striped">
 143   <tr>
 144     <td>\n</td>
 145     <td>newline</td>
 146   </tr>
 147   <tr>
 148     <td>\r</td>
 149     <td>carriage return</td>
 150   </tr>
 151   <tr>
 152     <td>&lt;</td>
 153     <td>less-than character.</td>
 154   </tr>
 155   <tr>
 156     <td>&gt;</td>
 157     <td>greater-than character.</td>
 158   </tr>
 159   <tr>
 160     <td>&amp;</td>
 161     <td>ampersand character.</td>
 162   </tr>
 163   <tr>
 164     <td>%%</td>
 165     <td>a percent sign</td>
 166   </tr>
 167   <tr>
 168     <td>%b</td>
 169     <td>file size of image read in</td>
 170   </tr>
 171   <tr>
 172     <td>%c</td>
 173     <td>comment meta-data property</td>
 174   </tr>
 175   <tr>
 176     <td>%d</td>
 177     <td>directory component of path</td>
 178   </tr>
 179   <tr>
 180     <td>%e</td>
 181     <td>filename extension or suffix</td>
 182   </tr>
 183   <tr>
 184     <td>%f</td>
 185     <td>filename (including suffix)</td>
 186   </tr>
 187   <tr>
 188     <td>%g</td>
 189     <td>layer canvas page geometry   (equivalent to "%Wx%H%X%Y")</td>
 190   </tr>
 191   <tr>
 192     <td>%h</td>
 193     <td>current image height in pixels</td>
 194   </tr>
 195   <tr>
 196     <td>%i</td>
 197     <td>image filename (note: becomes output filename for "info:")</td>
 198   </tr>
 199   <tr>
 200     <td>%k</td>
 201     <td>CALCULATED: number of unique colors</td>
 202   </tr>
 203   <tr>
 204     <td>%l</td>
 205     <td>label meta-data property</td>
 206   </tr>
 207   <tr>
 208     <td>%m</td>
 209     <td>image file format (file magic)</td>
 210   </tr>
 211   <tr>
 212     <td>%n</td>
 213     <td>number of images in current image sequence</td>
 214   </tr>
 215   <tr>
 216     <td>%o</td>
 217     <td>output filename  (used for delegates)</td>
 218   </tr>
 219   <tr>
 220     <td>%p</td>
 221     <td>index of image in current image list</td>
 222   </tr>
 223   <tr>
 224     <td>%q</td>
 225     <td>quantum depth (compile-time constant)</td>
 226   </tr>
 227   <tr>
 228     <td>%r</td>
 229     <td>image class and colorspace</td>
 230   </tr>
 231   <tr>
 232     <td>%s</td>
 233     <td>scene number (from input unless re-assigned)</td>
 234   </tr>
 235   <tr>
 236     <td>%t</td>
 237     <td>filename without directory or extension (suffix)</td>
 238   </tr>
 239   <tr>
 240     <td>%u</td>
 241     <td>unique temporary filename (used for delegates)</td>
 242   </tr>
 243   <tr>
 244     <td>%w</td>
 245     <td>current width in pixels</td>
 246   </tr>
 247   <tr>
 248     <td>%x</td>
 249     <td>x resolution (density)</td>
 250   </tr>
 251   <tr>
 252     <td>%y</td>
 253     <td>y resolution (density)</td>
 254   </tr>
 255   <tr>
 256     <td>%z</td>
 257     <td>image depth (as read in unless modified, image save depth)</td>
 258   </tr>
 259   <tr>
 260     <td>%A</td>
 261     <td>image transparency channel enabled (true/false)</td>
 262   </tr>
 263   <tr>
 264     <td>%C</td>
 265     <td>image compression type</td>
 266   </tr>
 267   <tr>
 268     <td>%D</td>
 269     <td>image GIF dispose method</td>
 270   </tr>
 271   <tr>
 272     <td>%G</td>
 273     <td>original image size (%wx%h; before any resizes)</td>
 274   </tr>
 275   <tr>
 276     <td>%H</td>
 277     <td>page (canvas) height</td>
 278   </tr>
 279   <tr>
 280     <td>%M</td>
 281     <td>Magick filename (original file exactly as given,  including read mods)</td>
 282   </tr>
 283   <tr>
 284     <td>%O</td>
 285     <td>page (canvas) offset ( = %X%Y )</td>
 286   </tr>
 287   <tr>
 288     <td>%P</td>
 289     <td>page (canvas) size ( = %Wx%H )</td>
 290   </tr>
 291   <tr>
 292     <td>%Q</td>
 293     <td>image compression quality ( 0 = default )</td>
 294   </tr>
 295   <tr>
 296     <td>%S</td>
 297     <td>?? scenes ??</td>
 298   </tr>
 299   <tr>
 300     <td>%T</td>
 301     <td>image time delay (in centi-seconds)</td>
 302   </tr>
 303   <tr>
 304     <td>%U</td>
 305     <td>image resolution units</td>
 306   </tr>
 307   <tr>
 308     <td>%W</td>
 309     <td>page (canvas) width</td>
 310   </tr>
 311   <tr>
 312     <td>%X</td>
 313     <td>page (canvas) x offset (including sign)</td>
 314   </tr>
 315   <tr>
 316     <td>%Y</td>
 317     <td>page (canvas) y offset (including sign)</td>
 318   </tr>
 319   <tr>
 320     <td>%Z</td>
 321     <td>unique filename (used for delegates)</td>
 322   </tr>
 323   <tr>
 324     <td>%@</td>
 325     <td>CALCULATED: trim bounding box (without actually trimming)</td>
 326   </tr>
 327   <tr>
 328     <td>%#</td>
 329     <td>CALCULATED: 'signature' hash of image values</td>
 330   </tr>
 331 </table></div>
 332
 333 <p>Here is a sample command and its output for an image with filename
 334 <code>bird.miff</code> and whose width is 512 and height is 480.</p>
 335
 336 <pre>
 337 -> identify -format "%m:%f %wx%h" bird.miff
 338 MIFF:bird.miff 512x480
 339 </pre>
 340
 341 <p>Note that all single letter percent escapes can also be used using long
 342 form (from IM version 6.7.6-9, see next). For example <code>%[f]</code> is
 343 equivalent to the <code>%f</code> short form. </p>
 344
 345 <p><b>WARNING</b>: short form percent escapes are NOT performed when the percent
 346 is after a number.  For example,  <code>10%x10</code> does not expand the
 347 <code>%x</code> as a percent escape.  If you specifically want to expand the
 348 'x', use the long form which overrides this special case. EG:
 349 <code>10%[x]10</code>. </p>
 350
 351 <p>Also be warned that calculated attributes can take some time to generate,
 352 especially for large images.</p>
 353
 354 <h3 class="magick-header">Long Form Attribute Percent Escapes</h3>
 355
 356 <p>In addition to the above specific and calculated attributes are recognized
 357 when enclosed in braces (long form):</p>
 358
 359 <div class="table-responsive">
 360 <table class="table table-condensed table-striped">
 361   <tr>
 362     <td>%[base]</td>
 363     <td>base filename, no suffixes (as %t)</td>
 364   </tr>
 365   <tr>
 366     <td>%[caption]</td>
 367     <td>caption meta-data property</td>
 368   </tr>
 369    <tr>
 370     <td>%[caption:pointsize]</td>
 371     <td>returns the pointsize computed during caption: processing (as of IM 6.9.1-0)</td>
 372   </tr>
 373   <tr>
 374     <td>%[channels]</td>
 375     <td>??? channels in use - colorspace ???</td>
 376   </tr>
 377   <tr>
 378     <td>%[colors]</td>
 379     <td>Number of unique colors in the image (as of IM 7.0.3.8)</td>
 380   </tr>
 381   <tr>
 382     <td>%[colorspace]</td>
 383     <td>Colorspace of Image Data (excluding transparency)</td>
 384   </tr>
 385   <tr>
 386     <td>%[compression]</td>
 387     <td>Image compression type (as of IM 7.0.3.8)</td>
 388   </tr>
 389   <tr>
 390     <td>%[copyright]</td>
 391     <td>ImageMagick Copyright String</td>
 392   </tr>
 393   <tr>
 394     <td>%[depth]</td>
 395     <td>depth of image for write (as input unless changed)</td>
 396   </tr>
 397   <tr>
 398     <td>%[deskew:angle]</td>
 399     <td>The deskew angle in degrees of rotation</td>
 400   </tr>
 401   <tr>
 402     <td>%[directory]</td>
 403     <td>directory part of filename (as %d)</td>
 404   </tr>
 405   <tr>
 406     <td>%[distortion]</td>
 407     <td>how well an image resembles a reference image (<a href="command-line-options.html#compare" >-compare</a>)</td>
 408   </tr>
 409   <tr>
 410     <td>%[entropy]</td>
 411     <td>CALCULATED: entropy of the image</td>
 412   </tr>
 413   <tr>
 414     <td>%[extension]</td>
 415     <td>extension part of filename (as %e)</td>
 416   </tr>
 417   <tr>
 418     <td>%[gamma]</td>
 419     <td>value of image gamma</td>
 420   </tr>
 421   <tr>
 422     <td>%[group]</td>
 423     <td>??? window group ???</td>
 424   </tr>
 425   <tr>
 426     <td>%[height]</td>
 427     <td>original height of image (when it was read in)</td>
 428   </tr>
 429   <tr>
 430     <td>%[interlace]</td>
 431     <td>Image interlace mode (as of IM 7.0.3.8)</td>
 432   </tr>
 433   <tr>
 434     <td>%[kurtosis]</td>
 435     <td>CALCULATED: kurtosis statistic of image</td>
 436   </tr>
 437   <tr>
 438     <td>%[label]</td>
 439     <td>label meta-data property</td>
 440   </tr>
 441    <tr>
 442     <td>%[label:pointsize]</td>
 443     <td>returns the pointsize computed during label: processing (as of IM 6.9.1-0)</td>
 444   </tr>
 445   <tr>
 446     <td>%[magick]</td>
 447     <td>coder used to read image (not the file suffix)</td>
 448   </tr>
 449   <tr>
 450     <td>%[max]</td>
 451     <td>CALCULATED: maximum value statistic of image</td>
 452   </tr>
 453   <tr>
 454     <td>%[mean]</td>
 455     <td>CALCULATED: average value statistic of image</td>
 456   </tr>
 457   <tr>
 458     <td>%[min]</td>
 459     <td>CALCULATED: minimum value statistic of image</td>
 460   </tr>
 461   <tr>
 462     <td>%[name]</td>
 463     <td>The original name of the image</td>
 464   </tr>
 465   <tr>
 466     <td>%[opaque]</td>
 467     <td>CALCULATED: is image fully-opaque?</td>
 468   </tr>
 469   <tr>
 470     <td>%[orientation]</td>
 471     <td>image orientation</td>
 472   </tr>
 473   <tr>
 474     <td>%[page]</td>
 475     <td>Virtual canvas (page) geometry</td>
 476   </tr>
 477   <tr>
 478     <td>%[profile:icc]</td>
 479     <td>ICC profile info</td>
 480   </tr>
 481   <tr>
 482     <td>%[profile:icm]</td>
 483     <td>ICM profile info</td>
 484   </tr>
 485   <tr>
 486     <td>%[profiles]</td>
 487     <td>list of any embedded profiles</td>
 488   </tr>
 489   <tr>
 490     <td>%[quality]</td>
 491     <td>Image quality value (as of IM 7.0.3.8)</td>
 492   </tr>
 493   <tr>
 494     <td>%[rendering-intent]</td>
 495     <td>Image rendering intent (as of IM 7.0.3.8)</td>
 496   </tr>
 497   <tr>
 498     <td>%[resolution.x]</td>
 499     <td>X density (resolution) without units</td>
 500   </tr>
 501   <tr>
 502     <td>%[resolution.y]</td>
 503     <td>Y density (resolution) without units</td>
 504   </tr>
 505   <tr>
 506     <td>%[scene]</td>
 507     <td>original scene number of image in input file</td>
 508   </tr>
 509   <tr>
 510     <td>%[size]</td>
 511     <td>original size of image (when it was read in)</td>
 512   </tr>
 513   <tr>
 514     <td>%[skewness]</td>
 515     <td>CALCULATED: skewness statistic of image</td>
 516   </tr>
 517   <tr>
 518     <td>%[standard-deviation]</td>
 519     <td>CALCULATED: standard deviation statistic of image</td>
 520   </tr>
 521   <tr>
 522     <td>%[type]</td>
 523     <td>CALCULATED: image type</td>
 524   </tr>
 525   <tr>
 526     <td>%[unique]</td>
 527     <td>unique temporary filename ???</td>
 528   </tr>
 529   <tr>
 530     <td>%[units]</td>
 531     <td>image resolution units</td>
 532   </tr>
 533   <tr>
 534     <td>%[version]</td>
 535     <td>Version Information of this running ImageMagick</td>
 536   </tr>
 537   <tr>
 538     <td>%[width]</td>
 539     <td>original width of image (when it was read in)</td>
 540   </tr>
 541   <tr>
 542     <td>%[zero]</td>
 543     <td>zero (unique filename for delegate use)</td>
 544   </tr>
 545 </table></div>
 546
 547 <h3 class="magick-header">Properties</h3>
 548
 549 <p>All other long forms of percent escapes (not single letter long form) are
 550 handled in a case insensitive manner. Such escapes will will attempt to look
 551 up that name specific data sources. </p>
 552
 553 <p>The primary search space (if not a specific attribute listed above) is
 554 a free-form property string.  Such strings are associated and saved with
 555 images, and are typically set using either the <a href="command-line-options.html#set" >-set</a>
 556 CLI option (or API equivalent), or from special convenience options
 557 (such as <a href="command-line-options.html#label"
 558 >-label</a>, <a href="command-line-options.html#comment"
 559 >-comment</a>, <a href="command-line-options.html#caption"
 560 >-caption</a>). </p>
 561
 562 <p>These convenience options are globally saved (as 'global options' so thay can
 563 be set before images are read), and later are transfered to the property of
 564 individual images, only when they are read in. At that time any internal
 565 percent escape present is then handled. </p>
 566
 567 <p>To change a property of an image already in memory, you need to use <a
 568 href="command-line-options.html#set" >-set</a>.
 569 </p>
 570
 571 <p>Note that properties, like attributes (and profiles), are saved with
 572 images when write, if the image file format allows. </p>
 573
 574
 575 <h3 class="magick-header">Artifacts and Options</h3>
 576
 577 <p>The previous percent escapes are associated with the primary Attributes and
 578 Properties. Which is the original and primary focus of such percent escapes.
 579 </p>
 580
 581 <p>However there are many operational settings that are used by various
 582 ImageMagick operators that can be useful to set and later access.  These
 583 consist of per-image Artifacts, and Global options (associated with a list of
 584 images, typically the current image list).</p>
 585
 586 <p>Note that the major difference between an artifact and a property is that
 587 artifacts, being an internal operational setting, is not saved with images (if
 588 such is possible). </p>
 589
 590 <p>For example when you use <code>-define 'distort:viewport=100x100'</code> you
 591 are in fact generating a global option, which the <a href="command-line-options.html#distort"
 592 >-distort</a> operator will use to modify its behavior (distorted output
 593 image 'view'). </p>
 594
 595 <p>An Option is essentually a Artifact that has been stored globally as part
 596 of a list of images (specifically a 'Wand' of images). As such they are
 597 identical, in that a Option, is simply a global Artifact for all the
 598 associated images. </p>
 599
 600 <p>As such you can use <code>-set 'option:distort:viewport' '100x100'</code> to
 601 achieve the same result of setting a Artifact for the disort operation to use.
 602 </p>
 603
 604 <p><b>Internal Handling of a Global Option...</b></p>
 605
 606 <p>The Core library ('MagickCore') does not generally directly understand
 607 Global Options. As such, continuing the previous example, the
 608 <code>DistortImages()</code> function only looks up an artifact to discover if
 609 a 'viewport' has been provided to it. </p>
 610
 611 <p>How Global Options are used when a library function requests an Artifact is
 612 one of the key differences between IMv6 and IMv7.</p>
 613
 614 <p>In <b>ImageMagick version 6</b>... before each operator, any global Options
 615 are copied to per-image Artifacts, for every image in the current image list.
 616 This allows various operators to find its operational 'defines' or Artifacts.
 617 </p>
 618
 619 <p>In <b>ImageMagick version 7</b>... sets a link back to the global options
 620 data, so that if a specific per-image Artifact is not found , then it will
 621 look for a equivalent global Option for that image list.  directly.  This
 622 saves coping these free-form options into artifacts repeatally, and means you
 623 can now separately define a global option for a list, and a individual
 624 overriding artifact for a specific image in that list. </p>
 625
 626 <p>Note that many API's that do not use Wands (PerlMagick for example using
 627 arrays of images rather than a Wand). In these API's you will not have Global
 628 Options, only per-image Artifacts. </p>
 629
 630 <p>In summery a Global Option, if available, is equivalent to a per-image
 631 Artifact. </p>
 632
 633
 634 <h3 class="magick-header">Glob-Pattern Listing of Properties, Artifacts and Options</h3>
 635
 636 <p>The <var>setting</var> can contain a glob pattern. As such you can
 637 now list all free-form string properties, artifacts, and options, (but not
 638 specific image attributes) using...</p>
 639
 640 <pre>
 641 convert ... \
 642    -print "__Properties__\n%[*]" \
 643    -print "__Artifacts__\n%[artifact:*]" \
 644    -print "__Options__\n%[option:*]" \
 645    ...
 646 </pre>
 647
 648 <p> The format of glob patterns are very specific and as such is generally
 649 only used to list specific settings, such as when debugging, rather than being
 650 used for image processing use. </p>
 651
 652
 653 <h3 class="magick-header">Calculated Percent Escape Prefixes</h3>
 654
 655 <p>There are some special prefixes (before the first ':') which performs
 656 calculations based on the user provided string that follows that prefix.  For
 657 example you can do a numerical calculation use <code>%[fx:...]</code> to
 658 evaluate the given <a href="fx.html">FX</a> expressions:</p>
 659
 660 <pre>
 661 %[fx:<var>expression</var>]
 662 </pre>
 663
 664 <p>Use <code>pixel:</code> to evaluate a pixel color as defined by the <a
 665 href="fx.html">FX</a>
 666 expression:</p>
 667
 668 <pre>
 669 %[pixel:<var>expression</var>]
 670 </pre>
 671
 672 <h3 class="magick-header">Specific Profile Percent Escape Prefixes</h3>
 673
 674 <p>You can also use the following special formatting syntax to print EXIF
 675 mage meta-data that was included in the image read in:</p>
 676
 677 <pre>
 678 %[EXIF:<var>tag</var>]
 679 </pre>
 680
 681 <p>Choose <var>tag</var> from the following:</p>
 682
 683 <pre class="pre-scrollable">
 684 *  (print all EXIF tags, in keyword=data format)
 685 !  (print all EXIF tags, in tag_number data format)
 686 #hhhh (print data for EXIF tag #hhhh)
 687 ImageWidth
 688 ImageLength
 689 BitsPerSample
 690 Compression
 691 PhotometricInterpretation
 692 FillOrder
 693 DocumentName
 694 ImageDescription
 695 Make
 696 Model
 697 StripOffsets
 698 Orientation
 699 SamplesPerPixel
 700 RowsPerStrip
 701 StripByteCounts
 702 XResolution
 703 YResolution
 704 PlanarConfiguration
 705 ResolutionUnit
 706 TransferFunction
 707 Software
 708 DateTime
 709 Artist
 710 WhitePoint
 711 PrimaryChromaticities
 712 TransferRange
 713 JPEGProc
 714 JPEGInterchangeFormat
 715 JPEGInterchangeFormatLength
 716 YCbCrCoefficients
 717 YCbCrSubSampling
 718 YCbCrPositioning
 719 ReferenceBlackWhite
 720 CFARepeatPatternDim
 721 CFAPattern
 722 BatteryLevel
 723 Copyright
 724 ExposureTime
 725 FNumber
 726 IPTC/NAA
 727 EXIFOffset
 728 InterColorProfile
 729 ExposureProgram
 730 SpectralSensitivity
 731 GPSInfo
 732 ISOSpeedRatings
 733 OECF
 734 EXIFVersion
 735 DateTimeOriginal
 736 DateTimeDigitized
 737 ComponentsConfiguration
 738 CompressedBitsPerPixel
 739 ShutterSpeedValue
 740 ApertureValue
 741 BrightnessValue
 742 ExposureBiasValue
 743 MaxApertureValue
 744 SubjectDistance
 745 MeteringMode
 746 LightSource
 747 Flash
 748 FocalLength
 749 MakerNote
 750 UserComment
 751 SubSecTime
 752 SubSecTimeOriginal
 753 SubSecTimeDigitized
 754 FlashPixVersion
 755 ColorSpace
 756 EXIFImageWidth
 757 EXIFImageLength
 758 InteroperabilityOffset
 759 FlashEnergy
 760 SpatialFrequencyResponse
 761 FocalPlaneXResolution
 762 FocalPlaneYResolution
 763 FocalPlaneResolutionUnit
 764 SubjectLocation
 765 ExposureIndex
 766 SensingMethod
 767 FileSource
 768 SceneType
 769 </pre>
 770 <br/>
 771 <p>Surround the format specification with quotation marks to prevent your
 772 shell from misinterpreting any spaces and square brackets.</p>
 773
 774 <p>The following special formatting syntax can be used to print IPTC
 775 information contained in the file:</p>
 776
 777 <pre>
 778 %[IPTC:<var>dataset</var>:<var>record</var>]
 779 </pre>
 780
 781 <p>Select <var>dataset</var> and <var>record</var> from the following:</p>
 782
 783 <pre class="pre-scrollable:">
 784   Envelope Record
 785   1:00  Model Version
 786   1:05  Destination
 787   1:20  File Format
 788   1:22  File Format Version
 789   1:30  Service Identifier
 790   1:40  Envelope Number
 791   1:50  Product ID
 792   1:60  Envelope Priority
 793   1:70  Date Sent
 794   1:80  Time Sent
 795   1:90  Coded Character Set
 796   1:100  UNO (Unique Name of Object)
 797   1:120  ARM Identifier
 798   1:122  ARM Version
 799
 800 Application Record
 801   2:00  Record Version
 802   2:03  Object Type Reference
 803   2:05  Object Name (Title)
 804   2:07  Edit Status
 805   2:08  Editorial Update
 806   2:10  Urgency
 807   2:12  Subject Reference
 808   2:15  Category
 809   2:20  Supplemental Category
 810   2:22  Fixture Identifier
 811   2:25  Keywords
 812   2:26  Content Location Code
 813   2:27  Content Location Name
 814   2:30  Release Date
 815   2:35  Release Time
 816   2:37  Expiration Date
 817   2:38  Expiration Time
 818   2:40  Special Instructions
 819   2:42  Action Advised
 820   2:45  Reference Service
 821   2:47  Reference Date
 822   2:50  Reference Number
 823   2:55  Date Created
 824   2:60  Time Created
 825   2:62  Digital Creation Date
 826   2:63  Digital Creation Time
 827   2:65  Originating Program
 828   2:70  Program Version
 829   2:75  Object Cycle
 830   2:80  By-Line (Author)
 831   2:85  By-Line Title (Author Position) [Not used in Photoshop 7]
 832   2:90  City
 833   2:92  Sub-Location
 834   2:95  Province/State
 835   2:100  Country/Primary Location Code
 836   2:101  Country/Primary Location Name
 837   2:103  Original Transmission Reference
 838   2:105  Headline
 839   2:110  Credit
 840   2:115  Source
 841   2:116  Copyright Notice
 842   2:118  Contact
 843   2:120  Caption/Abstract
 844   2:122  Caption Writer/Editor
 845   2:125  Rasterized Caption
 846   2:130  Image Type
 847   2:131  Image Orientation
 848   2:135  Language Identifier
 849   2:150  Audio Type
 850   2:151  Audio Sampling Rate
 851   2:152  Audio Sampling Resolution
 852   2:153  Audio Duration
 853   2:154  Audio Outcue
 854   2:200  ObjectData Preview File Format
 855   2:201  ObjectData Preview File Format Version
 856   2:202  ObjectData Preview Data
 857
 858 Pre-ObjectData Descriptor Record
 859   7:10   Size Mode
 860   7:20   Max Subfile Size
 861   7:90   ObjectData Size Announced
 862   7:95   Maximum ObjectData Size
 863
 864 ObjectData Record
 865   8:10   Subfile
 866
 867 Post ObjectData Descriptor Record
 868   9:10   Confirmed ObjectData Size
 869 </pre>
 870 </div>
 871   <footer class="magick-footer">
 872     <p><a href="support.html">Donate</a> •
 873      <a href="sitemap.html">Sitemap</a> •
 874     <a href="links.html">Related</a> •
 875     <a href="security-policy.html">Security</a> •
 876     <a href="architecture.html">Architecture</a>
 877 </p>
 878     <p><a href="escape.html#">Back to top</a> •
 879     <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a> •
 880     <a href="https://www.imagemagick.org/script/contact.php">Contact Us</a></p>
 881         <p><small>© 1999-2017 ImageMagick Studio LLC</small></p>
 882   </footer>
 883 </div><!-- /.container -->
 884
 885   <script src="https://localhost/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
 886   <script src="../js/magick.html"></script>
 887 </div>
 888 </body>
 889 </html>
 890 <!-- Magick Cache 24th December 2016 10:58 -->