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

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