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

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