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

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