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-2016 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>%[colorspace]</td>
 379     <td>Colorspace of Image Data (excluding transparency)</td>
 380   </tr>
 381   <tr>
 382     <td>%[copyright]</td>
 383     <td>ImageMagick Copyright String</td>
 384   </tr>
 385   <tr>
 386     <td>%[depth]</td>
 387     <td>depth of image for write (as input unless changed)</td>
 388   </tr>
 389   <tr>
 390     <td>%[deskew:angle]</td>
 391     <td>The deskew angle in degrees of rotation</td>
 392   </tr>
 393   <tr>
 394     <td>%[directory]</td>
 395     <td>directory part of filename (as %d)</td>
 396   </tr>
 397   <tr>
 398     <td>%[distortion]</td>
 399     <td>how well an image resembles a reference image (<a href="command-line-options.html#compare" >-compare</a>)</td>
 400   </tr>
 401   <tr>
 402     <td>%[entropy]</td>
 403     <td>CALCULATED: entropy of the image</td>
 404   </tr>
 405   <tr>
 406     <td>%[extension]</td>
 407     <td>extension part of filename (as %e)</td>
 408   </tr>
 409   <tr>
 410     <td>%[gamma]</td>
 411     <td>value of image gamma</td>
 412   </tr>
 413   <tr>
 414     <td>%[group]</td>
 415     <td>??? window group ???</td>
 416   </tr>
 417   <tr>
 418     <td>%[height]</td>
 419     <td>original height of image (when it was read in)</td>
 420   </tr>
 421   <tr>
 422     <td>%[kurtosis]</td>
 423     <td>CALCULATED: kurtosis statistic of image</td>
 424   </tr>
 425   <tr>
 426     <td>%[label]</td>
 427     <td>label meta-data property</td>
 428   </tr>
 429    <tr>
 430     <td>%[label:pointsize]</td>
 431     <td>returns the pointsize computed during label: processing (as of IM 6.9.1-0)</td>
 432   </tr>
 433   <tr>
 434     <td>%[magick]</td>
 435     <td>coder used to read image (not the file suffix)</td>
 436   </tr>
 437   <tr>
 438     <td>%[max]</td>
 439     <td>CALCULATED: maximum value statistic of image</td>
 440   </tr>
 441   <tr>
 442     <td>%[mean]</td>
 443     <td>CALCULATED: average value statistic of image</td>
 444   </tr>
 445   <tr>
 446     <td>%[min]</td>
 447     <td>CALCULATED: minimum value statistic of image</td>
 448   </tr>
 449   <tr>
 450     <td>%[name]</td>
 451     <td>The original name of the image</td>
 452   </tr>
 453   <tr>
 454     <td>%[opaque]</td>
 455     <td>CALCULATED: is image fully-opaque?</td>
 456   </tr>
 457   <tr>
 458     <td>%[orientation]</td>
 459     <td>image orientation</td>
 460   </tr>
 461   <tr>
 462     <td>%[page]</td>
 463     <td>Virtual canvas (page) geometry</td>
 464   </tr>
 465   <tr>
 466     <td>%[profile:icc]</td>
 467     <td>ICC profile info</td>
 468   </tr>
 469   <tr>
 470     <td>%[profile:icm]</td>
 471     <td>ICM profile info</td>
 472   </tr>
 473   <tr>
 474     <td>%[profiles]</td>
 475     <td>list of any embedded profiles</td>
 476   </tr>
 477   <tr>
 478     <td>%[resolution.x]</td>
 479     <td>X density (resolution) without units</td>
 480   </tr>
 481   <tr>
 482     <td>%[resolution.y]</td>
 483     <td>Y density (resolution) without units</td>
 484   </tr>
 485   <tr>
 486     <td>%[scene]</td>
 487     <td>original scene number of image in input file</td>
 488   </tr>
 489   <tr>
 490     <td>%[size]</td>
 491     <td>original size of image (when it was read in)</td>
 492   </tr>
 493   <tr>
 494     <td>%[skewness]</td>
 495     <td>CALCULATED: skewness statistic of image</td>
 496   </tr>
 497   <tr>
 498     <td>%[standard-deviation]</td>
 499     <td>CALCULATED: standard deviation statistic of image</td>
 500   </tr>
 501   <tr>
 502     <td>%[type]</td>
 503     <td>CALCULATED: image type</td>
 504   </tr>
 505   <tr>
 506     <td>%[unique]</td>
 507     <td>unique temporary filename ???</td>
 508   </tr>
 509   <tr>
 510     <td>%[units]</td>
 511     <td>image resolution units</td>
 512   </tr>
 513   <tr>
 514     <td>%[version]</td>
 515     <td>Version Information of this running ImageMagick</td>
 516   </tr>
 517   <tr>
 518     <td>%[width]</td>
 519     <td>original width of image (when it was read in)</td>
 520   </tr>
 521   <tr>
 522     <td>%[zero]</td>
 523     <td>zero (unique filename for delegate use)</td>
 524   </tr>
 525 </table></div>
 526
 527 <h3 class="magick-header">Properties</h3>
 528
 529 <p>All other long forms of percent escapes (not single letter long form) are
 530 handled in a case insensitive manner. Such escapes will will attempt to look
 531 up that name specific data sources. </p>
 532
 533 <p>The primary search space (if not a specific attribute listed above) is
 534 a free-form property string.  Such strings are associated and saved with
 535 images, and are typically set using either the <a href="command-line-options.html#set" >-set</a>
 536 CLI option (or API equivalent), or from special convenience options
 537 (such as <a href="command-line-options.html#label"
 538 >-label</a>, <a href="command-line-options.html#comment"
 539 >-comment</a>, <a href="command-line-options.html#caption"
 540 >-caption</a>). </p>
 541
 542 <p>These convenience options are globally saved (as 'global options' so thay can
 543 be set before images are read), and later are transfered to the property of
 544 individual images, only when they are read in. At that time any internal
 545 percent escape present is then handled. </p>
 546
 547 <p>To change a property of an image already in memory, you need to use <a
 548 href="command-line-options.html#set" >-set</a>.
 549 </p>
 550
 551 <p>Note that properties, like attributes (and profiles), are saved with
 552 images when write, if the image file format allows. </p>
 553
 554
 555 <h3 class="magick-header">Artifacts and Options</h3>
 556
 557 <p>The previous percent escapes are associated with the primary Attributes and
 558 Properties. Which is the original and primary focus of such percent escapes.
 559 </p>
 560
 561 <p>However there are many operational settings that are used by various
 562 ImageMagick operators that can be useful to set and later access.  These
 563 consist of per-image Artifacts, and Global options (associated with a list of
 564 images, typically the current image list).</p>
 565
 566 <p>Note that the major difference between an artifact and a property is that
 567 artifacts, being an internal operational setting, is not saved with images (if
 568 such is possible). </p>
 569
 570 <p>For example when you use <code>-define 'distort:viewport=100x100'</code> you
 571 are in fact generating a global option, which the <a href="command-line-options.html#distort"
 572 >-distort</a> operator will use to modify its behavior (distorted output
 573 image 'view'). </p>
 574
 575 <p>An Option is essentually a Artifact that has been stored globally as part
 576 of a list of images (specifically a 'Wand' of images). As such they are
 577 identical, in that a Option, is simply a global Artifact for all the
 578 associated images. </p>
 579
 580 <p>As such you can use <code>-set 'option:distort:viewport' '100x100'</code> to
 581 achieve the same result of setting a Artifact for the disort operation to use.
 582 </p>
 583
 584 <p><b>Internal Handling of a Global Option...</b></p>
 585
 586 <p>The Core library ('MagickCore') does not generally directly understand
 587 Global Options. As such, continuing the previous example, the
 588 <code>DistortImages()</code> function only looks up an artifact to discover if
 589 a 'viewport' has been provided to it. </p>
 590
 591 <p>How Global Options are used when a library function requests an Artifact is
 592 one of the key differences between IMv6 and IMv7.</p>
 593
 594 <p>In <b>ImageMagick version 6</b>... before each operator, any global Options
 595 are copied to per-image Artifacts, for every image in the current image list.
 596 This allows various operators to find its operational 'defines' or Artifacts.
 597 </p>
 598
 599 <p>In <b>ImageMagick version 7</b>... sets a link back to the global options
 600 data, so that if a specific per-image Artifact is not found , then it will
 601 look for a equivalent global Option for that image list.  directly.  This
 602 saves coping these free-form options into artifacts repeatally, and means you
 603 can now separately define a global option for a list, and a individual
 604 overriding artifact for a specific image in that list. </p>
 605
 606 <p>Note that many API's that do not use Wands (PerlMagick for example using
 607 arrays of images rather than a Wand). In these API's you will not have Global
 608 Options, only per-image Artifacts. </p>
 609
 610 <p>In summery a Global Option, if available, is equivalent to a per-image
 611 Artifact. </p>
 612
 613
 614 <h3 class="magick-header">Glob-Pattern Listing of Properties, Artifacts and Options</h3>
 615
 616 <p>The <var>setting</var> can contain a glob pattern. As such you can
 617 now list all free-form string properties, artifacts, and options, (but not
 618 specific image attributes) using...</p>
 619
 620 <pre>
 621 convert ... \
 622    -print "__Properties__\n%[*]" \
 623    -print "__Artifacts__\n%[artifact:*]" \
 624    -print "__Options__\n%[option:*]" \
 625    ...
 626 </pre>
 627
 628 <p> The format of glob patterns are very specific and as such is generally
 629 only used to list specific settings, such as when debugging, rather than being
 630 used for image processing use. </p>
 631
 632
 633 <h3 class="magick-header">Calculated Percent Escape Prefixes</h3>
 634
 635 <p>There are some special prefixes (before the first ':') which performs
 636 calculations based on the user provided string that follows that prefix.  For
 637 example you can do a numerical calculation use <code>%[fx:...]</code> to
 638 evaluate the given <a href="fx.html">FX</a> expressions:</p>
 639
 640 <pre>
 641 %[fx:<var>expression</var>]
 642 </pre>
 643
 644 <p>Use <code>pixel:</code> to evaluate a pixel color as defined by the <a
 645 href="fx.html">FX</a>
 646 expression:</p>
 647
 648 <pre>
 649 %[pixel:<var>expression</var>]
 650 </pre>
 651
 652 <h3 class="magick-header">Specific Profile Percent Escape Prefixes</h3>
 653
 654 <p>You can also use the following special formatting syntax to print EXIF
 655 mage meta-data that was included in the image read in:</p>
 656
 657 <pre>
 658 %[EXIF:<var>tag</var>]
 659 </pre>
 660
 661 <p>Choose <var>tag</var> from the following:</p>
 662
 663 <pre class="pre-scrollable">
 664 *  (print all EXIF tags, in keyword=data format)
 665 !  (print all EXIF tags, in tag_number data format)
 666 #hhhh (print data for EXIF tag #hhhh)
 667 ImageWidth
 668 ImageLength
 669 BitsPerSample
 670 Compression
 671 PhotometricInterpretation
 672 FillOrder
 673 DocumentName
 674 ImageDescription
 675 Make
 676 Model
 677 StripOffsets
 678 Orientation
 679 SamplesPerPixel
 680 RowsPerStrip
 681 StripByteCounts
 682 XResolution
 683 YResolution
 684 PlanarConfiguration
 685 ResolutionUnit
 686 TransferFunction
 687 Software
 688 DateTime
 689 Artist
 690 WhitePoint
 691 PrimaryChromaticities
 692 TransferRange
 693 JPEGProc
 694 JPEGInterchangeFormat
 695 JPEGInterchangeFormatLength
 696 YCbCrCoefficients
 697 YCbCrSubSampling
 698 YCbCrPositioning
 699 ReferenceBlackWhite
 700 CFARepeatPatternDim
 701 CFAPattern
 702 BatteryLevel
 703 Copyright
 704 ExposureTime
 705 FNumber
 706 IPTC/NAA
 707 EXIFOffset
 708 InterColorProfile
 709 ExposureProgram
 710 SpectralSensitivity
 711 GPSInfo
 712 ISOSpeedRatings
 713 OECF
 714 EXIFVersion
 715 DateTimeOriginal
 716 DateTimeDigitized
 717 ComponentsConfiguration
 718 CompressedBitsPerPixel
 719 ShutterSpeedValue
 720 ApertureValue
 721 BrightnessValue
 722 ExposureBiasValue
 723 MaxApertureValue
 724 SubjectDistance
 725 MeteringMode
 726 LightSource
 727 Flash
 728 FocalLength
 729 MakerNote
 730 UserComment
 731 SubSecTime
 732 SubSecTimeOriginal
 733 SubSecTimeDigitized
 734 FlashPixVersion
 735 ColorSpace
 736 EXIFImageWidth
 737 EXIFImageLength
 738 InteroperabilityOffset
 739 FlashEnergy
 740 SpatialFrequencyResponse
 741 FocalPlaneXResolution
 742 FocalPlaneYResolution
 743 FocalPlaneResolutionUnit
 744 SubjectLocation
 745 ExposureIndex
 746 SensingMethod
 747 FileSource
 748 SceneType
 749 </pre>
 750 <br/>
 751 <p>Surround the format specification with quotation marks to prevent your
 752 shell from misinterpreting any spaces and square brackets.</p>
 753
 754 <p>The following special formatting syntax can be used to print IPTC
 755 information contained in the file:</p>
 756
 757 <pre>
 758 %[IPTC:<var>dataset</var>:<var>record</var>]
 759 </pre>
 760
 761 <p>Select <var>dataset</var> and <var>record</var> from the following:</p>
 762
 763 <pre class="pre-scrollable:">
 764   Envelope Record
 765   1:00  Model Version
 766   1:05  Destination
 767   1:20  File Format
 768   1:22  File Format Version
 769   1:30  Service Identifier
 770   1:40  Envelope Number
 771   1:50  Product ID
 772   1:60  Envelope Priority
 773   1:70  Date Sent
 774   1:80  Time Sent
 775   1:90  Coded Character Set
 776   1:100  UNO (Unique Name of Object)
 777   1:120  ARM Identifier
 778   1:122  ARM Version
 779
 780 Application Record
 781   2:00  Record Version
 782   2:03  Object Type Reference
 783   2:05  Object Name (Title)
 784   2:07  Edit Status
 785   2:08  Editorial Update
 786   2:10  Urgency
 787   2:12  Subject Reference
 788   2:15  Category
 789   2:20  Supplemental Category
 790   2:22  Fixture Identifier
 791   2:25  Keywords
 792   2:26  Content Location Code
 793   2:27  Content Location Name
 794   2:30  Release Date
 795   2:35  Release Time
 796   2:37  Expiration Date
 797   2:38  Expiration Time
 798   2:40  Special Instructions
 799   2:42  Action Advised
 800   2:45  Reference Service
 801   2:47  Reference Date
 802   2:50  Reference Number
 803   2:55  Date Created
 804   2:60  Time Created
 805   2:62  Digital Creation Date
 806   2:63  Digital Creation Time
 807   2:65  Originating Program
 808   2:70  Program Version
 809   2:75  Object Cycle
 810   2:80  By-Line (Author)
 811   2:85  By-Line Title (Author Position) [Not used in Photoshop 7]
 812   2:90  City
 813   2:92  Sub-Location
 814   2:95  Province/State
 815   2:100  Country/Primary Location Code
 816   2:101  Country/Primary Location Name
 817   2:103  Original Transmission Reference
 818   2:105  Headline
 819   2:110  Credit
 820   2:115  Source
 821   2:116  Copyright Notice
 822   2:118  Contact
 823   2:120  Caption/Abstract
 824   2:122  Caption Writer/Editor
 825   2:125  Rasterized Caption
 826   2:130  Image Type
 827   2:131  Image Orientation
 828   2:135  Language Identifier
 829   2:150  Audio Type
 830   2:151  Audio Sampling Rate
 831   2:152  Audio Sampling Resolution
 832   2:153  Audio Duration
 833   2:154  Audio Outcue
 834   2:200  ObjectData Preview File Format
 835   2:201  ObjectData Preview File Format Version
 836   2:202  ObjectData Preview Data
 837
 838 Pre-ObjectData Descriptor Record
 839   7:10   Size Mode
 840   7:20   Max Subfile Size
 841   7:90   ObjectData Size Announced
 842   7:95   Maximum ObjectData Size
 843
 844 ObjectData Record
 845   8:10   Subfile
 846
 847 Post ObjectData Descriptor Record
 848   9:10   Confirmed ObjectData Size
 849 </pre>
 850 </div>
 851   <footer class="magick-footer">
 852     <p><a href="support.html">Donate</a> •
 853      <a href="sitemap.html">Sitemap</a> •
 854     <a href="links.html">Related</a> •
 855     <a href="security-policy.html">Security</a> •
 856     <a href="architecture.html">Architecture</a>
 857 </p>
 858     <p><a href="escape.html#">Back to top</a> •
 859     <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a> •
 860     <a href="https://www.imagemagick.org/script/contact.php">Contact Us</a></p>
 861         <p><small>©  1999-2016 ImageMagick Studio LLC</small></p>
 862   </footer>
 863 </div><!-- /.container -->
 864
 865   <script src="https://localhost/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
 866   <script src="../js/magick.html"></script>
 867 </div>
 868 </body>
 869 </html>
 870 <!-- Magick Cache 10th November 2016 08:04 -->