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