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

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