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