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

   1 \r
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" \r
   3   "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
   4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" dir="ltr">\r
   5 <head>\r
   6   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>\r
   7   <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U="/>\r
   8   <title>ImageMagick: Format and Print Image Properties</title>
   9   <meta http-equiv="Content-Language" content="en-US"/>
  10   <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
  11   <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
  12   <meta name="Application-name" content="ImageMagick"/>
  13   <meta name="Description" content="ImageMagick is a software suite to create, edit, compose, or convert bitmap images in a variety of formats. Use ImageMagick to scale, rotate, shear, distort and transform images."/>
  14   <meta name="Application-url" content="http://www.imagemagick.org"/>
  15   <meta name="Generator" content="PHP"/>
  16   <meta name="Keywords" content="format, print, image, properties, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
  17   <meta name="Rating" content="GENERAL"/>
  18   <meta name="Robots" content="INDEX, FOLLOW"/>
  19   <meta name="Generator" content="ImageMagick Studio LLC"/>
  20   <meta name="Author" content="ImageMagick Studio LLC"/>
  21   <meta name="Revisit-after" content="2 DAYS"/>
  22   <meta name="Resource-type" content="document"/>
  23   <meta name="Copyright" content="Copyright (c) 1999-2011 ImageMagick Studio LLC"/>
  24   <meta name="Distribution" content="Global"/>
  25   <link rel="icon" href="../images/wand.png"/>
  26   <link rel="shortcut icon" href="../images/wand.ico"  type="images/x-icon"/>
  27   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>\r
  28   <link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />\r
  29   <style type="text/css" media="all">\r
  30     @import url("../www/magick.css");\r
  31   </style>\r
  32   <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script>\r
  33   <script type="text/javascript" src="../fancybox/jquery.fancybox-1.3.4.pack.js"></script>\r
  34   <link rel="stylesheet" type="text/css" href="../fancybox/jquery.fancybox-1.3.4.css" media="screen" />\r
  35   <script type="text/javascript">\r
  36     $(document).ready(function() {\r
  37       $("a[href$=.jpg],a[href$=.png],a[href$=.gif]").fancybox({\r
  38         'transitionIn'  : 'elastic',\r
  39         'transitionOut' : 'elastic',\r
  40         'overlayShow'   : false,\r
  41         'opacity'       : true\r
  42       });\r
  43     });\r
  44   </script>\r
  45 </head>\r
  46 \r
  47 <body id="www-imagemagick-org">\r
  48 <div class="titlebar">\r
  49 <a href="../index.html">\r
  50   <img src="../images/script.png" alt="[ImageMagick]"\r
  51   style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>\r
  52 <a href="http://www.networkredux.com">\r
  53   <img src="../images/networkredux.png" alt="[sponsor]"\r
  54   style="margin-top: 42px; border: 0px; float: left;" /></a>\r
  55 <a href="http://www.imagemagick.org/discourse-server/">\r
  56   <img src="../images/logo.jpg" alt=""\r
  57   style="width: 123px; height: 118px; border: 0px; float: right;" /></a>\r
  58 <a href="../index.html">\r
  59   <img src="../images/sprite.jpg" alt=""\r
  60   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  61 </div>\r
  62 \r
  63 <div class="westbar">\r
  64 \r
  65 <div class="menu">
  66   <a title="About ImageMagick" href="../index.html">About ImageMagick</a>
  67 </div>
  68 <div class="sep"></div>\r
  69 <div class="menu">
  70   <a title="Binary Releases" href="../www/binary-releases.html">Binary Releases</a>
  71 </div>
  72 <div class="sub">
  73     <a title="Binary Release: Unix" href="../www/binary-releases.html#unix">Unix</a>
  74 </div>
  75 <div class="sub">
  76     <a title="Binary Release: MacOS X" href="../www/binary-releases.html#macosx">Mac OS X</a>
  77 </div>
  78 <div class="sub">
  79     <a title="Binary Release: Windows" href="../www/binary-releases.html#windows">Windows</a>
  80 </div>
  81 <div class="sep"></div>\r
  82 <div class="menu">
  83   <a title="Command-line Tools" href="../www/command-line-tools.html">Command-line Tools</a>
  84 </div>
  85 <div class="sub">
  86     <a title="Command-line Tools: Processing" href="../www/command-line-processing.html">Processing</a>
  87 </div>
  88 <div class="sub">
  89     <a title="Command-line Tools: Options" href="../www/command-line-options.html">Options</a>
  90 </div>
  91 <div class="sub">
  92     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
  93 </div>
  94 <div class="menu">
  95   <a title="Program Interfaces" href="../www/api.html">Program Interfaces</a>
  96 </div>
  97 <div class="sub">
  98     <a title="Program Interface: MagickWand" href="../www/magick-wand.html">MagickWand</a>
  99 </div>
 100 <div class="sub">
 101     <a title="Program Interface: MagickCore" href="../www/magick-core.html">MagickCore</a>
 102 </div>
 103 <div class="sub">
 104     <a title="Program Interface: PerlMagick" href="../www/perl-magick.html">PerlMagick</a>
 105 </div>
 106 <div class="sub">
 107     <a title="Program Interface: Magick++" href="../www/magick++.html">Magick++</a>
 108 </div>
 109 <div class="sep"></div>\r
 110 <div  class="menu">
 111    <a title="Install from Source" href="../www/install-source.html">Install from Source</a>
 112 </div>
 113 <div class="sub">
 114     <a title="Install from Source: Unix" href="../www/install-source.html#unix">Unix</a>
 115 </div>
 116 <div class="sub">
 117     <a title="Install from Source: Windows" href="../www/install-source.html#windows">Windows</a>
 118  </div>
 119 <div class="menu">
 120   <a title="Resources" href="../www/resources.html">Resources</a>
 121 </div>
 122 <div class="menu">
 123   <a title="Architecture" href="../www/architecture.html">Architecture</a>
 124 </div>
 125 <div class="menu">
 126   <a title="Download" href="../www/download.html">Download</a>
 127 </div>
 128 <div class="sep"></div>\r
 129 <div class="menu">
 130   <a title="Search" href="../www/search.html">Search</a>
 131 </div>
 132 <div class="sep"></div>\r
 133 <div class="menu">
 134   <a title="Site Map" href="../www/sitemap.html">Site Map</a>
 135 </div>
 136 <div  class="sub">
 137   <a title="Site Map: Links" href="../www/links.html">Links</a>
 138 </div>
 139 <div class="sep"></div>\r
 140 <div  class="menu">
 141   <a title="Sponsors" href="../www/sponsors.html">Sponsors:</a>
 142
 143 <div class="sponsbox">
 144 <div  class="sponsor">
 145   <a title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201106010240 -->
 146 </div>
 147 <div class="sponsor">
 148   <a title="Sponsor: Web Hosting" href="http://www.bodhost.com/hosting.shtml">Web Hosting</a><!-- 201104010090 -->
 149 </div>
 150 <div  class="sponsor">
 151   <a title="Sponsor: Image Converter" href="http://www.batchphoto.com">Image Converter</a><!-- 201103010900 Bits Coffee-->
 152 </div>
 153 <div  class="sponsor">
 154   <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
 155 </div>
 156 <div  class="sponsor">
 157   <a title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
 158 </div>
 159 <div  class="sponsor">
 160    <a title="Sponsor: alaTest.com" href="http://alatest.com">alaTest.com</a><!-- 20110801000300 -->
 161 </div>
 162 </div>
 163 </div>
 164 </div>\r
 165 \r
 166 <div class="eastbar">\r
 167   <script type="text/javascript">\r
 168   <!--\r
 169     google_ad_client = "pub-3129977114552745";\r
 170     google_ad_slot = "0574824969";\r
 171     google_ad_width = 160;\r
 172     google_ad_height = 600;\r
 173   //-->\r
 174   </script>\r
 175   <script type="text/javascript"\r
 176     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">\r
 177   </script>\r
 178 </div>\r
 179 \r
 180 <div class="main">\r
 181 \r
 182 <h1>ImageMagick Escapes</h1>
 183 <p class="navigation-index"></p>
 184
 185 <div class="doc-section">
 186 <p>Use the <a href="../www/command-line-options.html#format_identify_">-format</a> option to print properties associated with an image in a format of your choosing. You can include the image filename, type, width, height, EXIF data, or other image attributes by embedding special format characters:</p>
 187
 188 <pre class="text">
 189    %b   file size
 190    %c   comment
 191    %d   directory
 192    %e   filename extension
 193    %f   filename
 194    %g   page geometry
 195    %h   current image height in pixels
 196    %i   input filename
 197    %k   number of unique colors
 198    %l   label
 199    %m   magick
 200    %n   number of scenes
 201    %o   output filename
 202    %p   page number
 203    %q   quantum depth
 204    %r   image class and colorspace
 205    %s   scene number
 206    %t   top of filename
 207    %u   unique temporary filename
 208    %w   current width in pixels
 209    %x   x resolution
 210    %y   y resolution
 211    %z   image depth
 212    %A   image alpha channel
 213    %C   image compression type
 214    %D   image dispose method
 215    %H   page height
 216    %W   page width
 217    %X   page x offset
 218    %Y   page y offset
 219    %Q   image compression quality
 220    %T   image delay
 221    %@   bounding box
 222    %#   signature
 223    %%   a percent sign
 224    \n   newline
 225    \r   carriage return
 226 </pre>
 227
 228 <p>Here is a sample command and its output
 229 for an image with filename <kbd>bird.miff</kbd> and whose width is 512 and height is 480.</p>
 230
 231 <p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>identify -format "%m:%f %wx%h" bird.miff</span><span class='crtout'>MIFF:bird.miff 512x480</span></p>
 232 <p>Additional properties are recognized when enclosed in braces:</p>
 233
 234 <pre class="text">
 235    %[base]                base filename
 236    %[channels]
 237    %[colorspace]
 238    %[copyright]
 239    %[depth]
 240    %[directory]
 241    %[extension]
 242    %[group]
 243    %[height]               original height of image (when it was read in)
 244    %[magick]
 245    %[max]
 246    %[mean]
 247    %[min]
 248    %[name]
 249    %[page]
 250    %[scene]
 251    %[scenes]
 252    %[size]                 original size of image (when it was read in)
 253    %[standard-deviation]
 254    %[unique]               unique temporary filename
 255    %[version]
 256    %[width]                original width of image (when it was read in)
 257    %[xresolution]
 258    %[yresolution]
 259 </pre>
 260
 261 <p>Use <kbd>fx:</kbd> to evaluate <a href="../www/fx.html">FX</a> expressions:</p>
 262
 263 <pre class="text">
 264    %[fx:<em class="arg">expression</em>]
 265 </pre>
 266
 267 <p>Use <kbd>pixel:</kbd> to evaluate a pixel color as defined by the <a href="../www/fx.html">FX</a> expression:</p>
 268
 269 <pre class="text">
 270    %[pixel:<em class="arg">expression</em>]
 271 </pre>
 272
 273 <p>You can also use the following special formatting syntax to print EXIF information contained in the file:</p>
 274
 275 <pre class="text">
 276    %[EXIF:<em class="arg">tag</em>]
 277 </pre>
 278
 279 <p>Choose <em class="arg">tag</em> from the following:</p>
 280
 281 <pre class="text">
 282    *  (print all EXIF tags, in keyword=data format)
 283    !  (print all EXIF tags, in tag_number data format)
 284    #hhhh (print data for EXIF tag #hhhh)
 285    ImageWidth
 286    ImageLength
 287    BitsPerSample
 288    Compression
 289    PhotometricInterpretation
 290    FillOrder
 291    DocumentName
 292    ImageDescription
 293    Make
 294    Model
 295    StripOffsets
 296    Orientation
 297    SamplesPerPixel
 298    RowsPerStrip
 299    StripByteCounts
 300    XResolution
 301    YResolution
 302    PlanarConfiguration
 303    ResolutionUnit
 304    TransferFunction
 305    Software
 306    DateTime
 307    Artist
 308    WhitePoint
 309    PrimaryChromaticities
 310    TransferRange
 311    JPEGProc
 312    JPEGInterchangeFormat
 313    JPEGInterchangeFormatLength
 314    YCbCrCoefficients
 315    YCbCrSubSampling
 316    YCbCrPositioning
 317    ReferenceBlackWhite
 318    CFARepeatPatternDim
 319    CFAPattern
 320    BatteryLevel
 321    Copyright
 322    ExposureTime
 323    FNumber
 324    IPTC/NAA
 325    EXIFOffset
 326    InterColorProfile
 327    ExposureProgram
 328    SpectralSensitivity
 329    GPSInfo
 330    ISOSpeedRatings
 331    OECF
 332    EXIFVersion
 333    DateTimeOriginal
 334    DateTimeDigitized
 335    ComponentsConfiguration
 336    CompressedBitsPerPixel
 337    ShutterSpeedValue
 338    ApertureValue
 339    BrightnessValue
 340    ExposureBiasValue
 341    MaxApertureValue
 342    SubjectDistance
 343    MeteringMode
 344    LightSource
 345    Flash
 346    FocalLength
 347    MakerNote
 348    UserComment
 349    SubSecTime
 350    SubSecTimeOriginal
 351    SubSecTimeDigitized
 352    FlashPixVersion
 353    ColorSpace
 354    EXIFImageWidth
 355    EXIFImageLength
 356    InteroperabilityOffset
 357    FlashEnergy
 358    SpatialFrequencyResponse
 359    FocalPlaneXResolution
 360    FocalPlaneYResolution
 361    FocalPlaneResolutionUnit
 362    SubjectLocation
 363    ExposureIndex
 364    SensingMethod
 365    FileSource
 366    SceneType
 367 </pre>
 368
 369 <p>Surround the format specification with quotation marks to prevent your shell from misinterpreting any spaces and square brackets.</p>
 370
 371 <p>The following special formatting syntax can be used to print IPTC information contained in the file:</p>
 372
 373 <pre class="text">
 374    %[IPTC:<em class="arg">dataset</em>:<em class="arg">record</em>]
 375 </pre>
 376
 377 <p>Select <em class="arg">dataset</em> and <em class="arg">record</em> from the following:</p>
 378
 379 <pre class="text">
 380     Envelope Record
 381       1:00  Model Version
 382       1:05  Destination
 383       1:20  File Format
 384       1:22  File Format Version
 385       1:30  Service Identifier
 386       1:40  Envelope Number
 387       1:50  Product ID
 388       1:60  Envelope Priority
 389       1:70  Date Sent
 390       1:80  Time Sent
 391       1:90  Coded Character Set
 392       1:100  UNO (Unique Name of Object)
 393       1:120  ARM Identifier
 394       1:122  ARM Version
 395
 396     Application Record
 397       2:00  Record Version
 398       2:03  Object Type Reference
 399       2:05  Object Name (Title)
 400       2:07  Edit Status
 401       2:08  Editorial Update
 402       2:10  Urgency
 403       2:12  Subject Reference
 404       2:15  Category
 405       2:20  Supplemental Category
 406       2:22  Fixture Identifier
 407       2:25  Keywords
 408       2:26  Content Location Code
 409       2:27  Content Location Name
 410       2:30  Release Date
 411       2:35  Release Time
 412       2:37  Expiration Date
 413       2:35  Expiration Time
 414       2:40  Special Instructions
 415       2:42  Action Advised
 416       2:45  Reference Service
 417       2:47  Reference Date
 418       2:50  Reference Number
 419       2:55  Date Created
 420       2:60  Time Created
 421       2:62  Digital Creation Date
 422       2:63  Digital Creation Time
 423       2:65  Originating Program
 424       2:70  Program Version
 425       2:75  Object Cycle
 426       2:80  By-Line (Author)
 427       2:85  By-Line Title (Author Position) [Not used in Photoshop 7]
 428       2:90  City
 429       2:92  Sub-Location
 430       2:95  Province/State
 431       2:100  Country/Primary Location Code
 432       2:101  Country/Primary Location Name
 433       2:103  Original Transmission Reference
 434       2:105  Headline
 435       2:110  Credit
 436       2:115  Source
 437       2:116  Copyright Notice
 438       2:118  Contact
 439       2:120  Caption/Abstract
 440       2:122  Caption Writer/Editor
 441       2:125  Rasterized Caption
 442       2:130  Image Type
 443       2:131  Image Orientation
 444       2:135  Language Identifier
 445       2:150  Audio Type
 446       2:151  Audio Sampling Rate
 447       2:152  Audio Sampling Resolution
 448       2:153  Audio Duration
 449       2:154  Audio Outcue
 450       2:200  ObjectData Preview File Format
 451       2:201  ObjectData Preview File Format Version
 452       2:202  ObjectData Preview Data
 453
 454     Pre-ObjectData Descriptor Record
 455       7:10   Size Mode
 456       7:20   Max Subfile Size
 457       7:90   ObjectData Size Announced
 458       7:95   Maximum ObjectData Size
 459
 460     ObjectData Record
 461       8:10   Subfile
 462
 463     Post ObjectData Descriptor Record
 464       9:10   Confirmed ObjectData Size
 465 </pre>
 466 </div>
 467 \r
 468 </div>\r
 469 \r
 470 <div id="linkbar">\r
 471     <span id="linkbar-west">&nbsp;</span>\r
 472     <span id="linkbar-center">\r
 473       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 474       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 475     </span>\r
 476     <span id="linkbar-east">&nbsp;</span>\r
 477   </div>\r
 478   <div class="footer">\r
 479     <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>\r
 480     <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 481   </div>\r
 482   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 483   <script type="text/javascript">\r
 484     var _gaq = _gaq || [];\r
 485     _gaq.push(['_setAccount', 'UA-17690367-1']);\r
 486     _gaq.push(['_trackPageview']);\r
 487 \r
 488     (function() {\r
 489       var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;\r
 490       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';\r
 491       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);\r
 492     })();\r
 493   </script>\r
 494 </body>\r
 495 </html>\r