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

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