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" 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: Web Hosting" href="http://www.micfo.com">Web Hosting</a><!-- 209901010090s golestan -->
 166 </div>
 167 <div  class="sponsor">
 168   <a rel="follow" title="Sponsor: Autos part" href="http://www.pkwteile.de/autoteile">Autos part</a><!-- 201112010090s jr@pkwte... -->
 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: Web Hosting Reviews" href="http://www.webhostingsecretrevealed.com">Web Hosting Secret Revealed</a><!-- 201204010540 iamchee jerry -->
 181 </div>
 182 <div  class="sponsor">
 183   <a rel="follow" title="Sponsor: Web Hosting Break" href="http://www.webhostingbreak.com">Web Hosting Break</a><!-- 201109010090 ian@ian-m... -->
 184 </div>
 185 <div  class="sponsor">
 186   <a rel="follow" title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201303011500 r.leo -->
 187 </div>
 188 <div  class="sponsor">
 189   <a rel="follow" title="Sponsor: Website Hosting" href="http://www.hostreviewgeeks.com">Website Hosting</a><!-- 201110010090 alexanian media -->
 190 </div>
 191 <div  class="sponsor">
 192   <a rel="follow" title="Sponsor: Hotel München" href="http://www.messehotel-erb-muenchen.de">Hotel München</a><!-- 201111010450 cerb -->
 193 </div>
 194 <div  class="sponsor">
 195   <a rel="follow" title="Sponsor: Best Web Hosting" href="http://webhostinggeeks.com">Best Web Hosting</a><!-- 201110010720 -->
 196 </div>
 197 <div  class="sponsor">
 198   <a rel="follow" title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
 199 </div>
 200 <div  class="sponsor">
 201   <a rel="follow" title="Sponsor: Web Hosting Ratings" href="http://webhostingrating.com">Web Hosting Ratings</a><!-- 201110010720 -->
 202 </div>
 203 <div  class="sponsor">
 204    <a rel="follow" title="Sponsor: Webdesign" href="http://www.renehornig.com/">Webdesign</a><!-- 20111001000240 -->
 205 </div>
 206 </div>
 207 </div>
 208 </div>\r
 209 \r
 210 <div class="eastbar">\r
 211   <div class="g-plusone" data-size="standard" data-count="false"></div>\r
 212 </div>\r
 213 \r
 214 <div class="main">\r
 215 \r
 216 <h1>ImageMagick Escapes</h1>
 217 <p class="navigation-index"></p>
 218
 219 <div class="doc-section">
 220 <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>
 221
 222 <pre class="text">
 223    %b   original file size of image file
 224    %c   comment property
 225    %d   directory path
 226    %e   filename extension or suffix
 227    %f   filename (including suffix)
 228    %g   page geometry   ( = %Wx%H%X%Y )
 229    %h   current image height in pixels
 230    %i   input filename (full path)
 231    %k   number of unique colors
 232    %l   label property
 233    %m   magick format used during read
 234    %n   number of images in sequence
 235    %o   output filename
 236    %p   index of image in sequence
 237    %q   quantum depth (compile-time constant)
 238    %r   image class and colorspace
 239    %s   scene number (from input unless re-assigned)
 240    %t   top of filename (excluding suffix)
 241    %u   unique temporary filename
 242    %w   current width in pixels
 243    %x   x resolution
 244    %y   y resolution
 245    %z   image depth (as read in)
 246    %A   image transparency channel enabled (true/false)
 247    %C   image compression type
 248    %D   image dispose method
 249    %G   image size ( = %wx%h )
 250    %H   page (canvas) height
 251    %O   page (canvas) offset ( = %X%Y )
 252    %P   page (canvas) size ( = %Wx%H )
 253    %Q   image compression quality
 254    %S   ?? scenes ??
 255    %T   image time delay
 256    %W   page (canvas) width
 257    %X   page (canvas) x offset (including sign)
 258    %Y   page (canvas) y offset (including sign)
 259    %@   bounding box
 260    %#   signature
 261    %%   a percent sign
 262    \n   newline
 263    \r   carriage return
 264 </pre>
 265
 266 <p>Here is a sample command and its output
 267 for an image with filename <kbd>bird.miff</kbd> and whose width is 512 and height is 480.</p>
 268
 269 <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>
 270 <p>Additional properties are recognized when enclosed in braces:</p>
 271
 272 <pre class="text">
 273    %[base]                 base filename, no suffixes (as %t)
 274    %[channels]
 275    %[colorspace]           Colorspace of Image Data (excluding transparency)
 276    %[copyright]            ImageMagick Copyright String
 277    %[depth]                depth of image for write (as input unless changed)
 278    %[directory]            directory part of filename (as %d)
 279    %[extension]            extention part of filename (as %e)
 280    %[group]
 281    %[height]               original height of image (when it was read in)
 282    %[magick]               coder used to read image (not the file suffix)
 283    %[max]
 284    %[mean]
 285    %[min]
 286    %[name]
 287    %[opaque]
 288    %[page]
 289    %[scene]                original scene number of image in input file
 290    %[scenes]               original number of scenes in input file
 291    %[size]                 original size of image (when it was read in)
 292    %[standard-deviation]
 293    %[unique]               unique temporary filename ???
 294    %[version]              Version Information of this running ImageMagick
 295    %[width]                original width of image (when it was read in)
 296    %[xresolution]
 297    %[yresolution]
 298    %[*]                    list of image property strings
 299 </pre>
 300
 301 <p>Use <kbd>%[fx:...]</kbd> to evaluate <a href="../www/fx.html">FX</a> expressions:</p>
 302
 303 <pre class="text">
 304    %[fx:<em class="arg">expression</em>]
 305 </pre>
 306
 307 <p>Use <kbd>pixel:</kbd> to evaluate a pixel color as defined by the <a href="../www/fx.html">FX</a> expression:</p>
 308
 309 <pre class="text">
 310    %[pixel:<em class="arg">expression</em>]
 311 </pre>
 312
 313 <p>You can also use the following special formatting syntax to print EXIF
 314 information contained in the file:</p>
 315
 316 <pre class="text">
 317    %[EXIF:<em class="arg">tag</em>]
 318 </pre>
 319
 320 <p>Choose <em class="arg">tag</em> from the following:</p>
 321
 322 <pre class="text">
 323    *  (print all EXIF tags, in keyword=data format)
 324    !  (print all EXIF tags, in tag_number data format)
 325    #hhhh (print data for EXIF tag #hhhh)
 326    ImageWidth
 327    ImageLength
 328    BitsPerSample
 329    Compression
 330    PhotometricInterpretation
 331    FillOrder
 332    DocumentName
 333    ImageDescription
 334    Make
 335    Model
 336    StripOffsets
 337    Orientation
 338    SamplesPerPixel
 339    RowsPerStrip
 340    StripByteCounts
 341    XResolution
 342    YResolution
 343    PlanarConfiguration
 344    ResolutionUnit
 345    TransferFunction
 346    Software
 347    DateTime
 348    Artist
 349    WhitePoint
 350    PrimaryChromaticities
 351    TransferRange
 352    JPEGProc
 353    JPEGInterchangeFormat
 354    JPEGInterchangeFormatLength
 355    YCbCrCoefficients
 356    YCbCrSubSampling
 357    YCbCrPositioning
 358    ReferenceBlackWhite
 359    CFARepeatPatternDim
 360    CFAPattern
 361    BatteryLevel
 362    Copyright
 363    ExposureTime
 364    FNumber
 365    IPTC/NAA
 366    EXIFOffset
 367    InterColorProfile
 368    ExposureProgram
 369    SpectralSensitivity
 370    GPSInfo
 371    ISOSpeedRatings
 372    OECF
 373    EXIFVersion
 374    DateTimeOriginal
 375    DateTimeDigitized
 376    ComponentsConfiguration
 377    CompressedBitsPerPixel
 378    ShutterSpeedValue
 379    ApertureValue
 380    BrightnessValue
 381    ExposureBiasValue
 382    MaxApertureValue
 383    SubjectDistance
 384    MeteringMode
 385    LightSource
 386    Flash
 387    FocalLength
 388    MakerNote
 389    UserComment
 390    SubSecTime
 391    SubSecTimeOriginal
 392    SubSecTimeDigitized
 393    FlashPixVersion
 394    ColorSpace
 395    EXIFImageWidth
 396    EXIFImageLength
 397    InteroperabilityOffset
 398    FlashEnergy
 399    SpatialFrequencyResponse
 400    FocalPlaneXResolution
 401    FocalPlaneYResolution
 402    FocalPlaneResolutionUnit
 403    SubjectLocation
 404    ExposureIndex
 405    SensingMethod
 406    FileSource
 407    SceneType
 408 </pre>
 409
 410 <p>Surround the format specification with quotation marks to prevent your shell from misinterpreting any spaces and square brackets.</p>
 411
 412 <p>The following special formatting syntax can be used to print IPTC information contained in the file:</p>
 413
 414 <pre class="text">
 415    %[IPTC:<em class="arg">dataset</em>:<em class="arg">record</em>]
 416 </pre>
 417
 418 <p>Select <em class="arg">dataset</em> and <em class="arg">record</em> from the following:</p>
 419
 420 <pre class="text">
 421     Envelope Record
 422       1:00  Model Version
 423       1:05  Destination
 424       1:20  File Format
 425       1:22  File Format Version
 426       1:30  Service Identifier
 427       1:40  Envelope Number
 428       1:50  Product ID
 429       1:60  Envelope Priority
 430       1:70  Date Sent
 431       1:80  Time Sent
 432       1:90  Coded Character Set
 433       1:100  UNO (Unique Name of Object)
 434       1:120  ARM Identifier
 435       1:122  ARM Version
 436
 437     Application Record
 438       2:00  Record Version
 439       2:03  Object Type Reference
 440       2:05  Object Name (Title)
 441       2:07  Edit Status
 442       2:08  Editorial Update
 443       2:10  Urgency
 444       2:12  Subject Reference
 445       2:15  Category
 446       2:20  Supplemental Category
 447       2:22  Fixture Identifier
 448       2:25  Keywords
 449       2:26  Content Location Code
 450       2:27  Content Location Name
 451       2:30  Release Date
 452       2:35  Release Time
 453       2:37  Expiration Date
 454       2:35  Expiration Time
 455       2:40  Special Instructions
 456       2:42  Action Advised
 457       2:45  Reference Service
 458       2:47  Reference Date
 459       2:50  Reference Number
 460       2:55  Date Created
 461       2:60  Time Created
 462       2:62  Digital Creation Date
 463       2:63  Digital Creation Time
 464       2:65  Originating Program
 465       2:70  Program Version
 466       2:75  Object Cycle
 467       2:80  By-Line (Author)
 468       2:85  By-Line Title (Author Position) [Not used in Photoshop 7]
 469       2:90  City
 470       2:92  Sub-Location
 471       2:95  Province/State
 472       2:100  Country/Primary Location Code
 473       2:101  Country/Primary Location Name
 474       2:103  Original Transmission Reference
 475       2:105  Headline
 476       2:110  Credit
 477       2:115  Source
 478       2:116  Copyright Notice
 479       2:118  Contact
 480       2:120  Caption/Abstract
 481       2:122  Caption Writer/Editor
 482       2:125  Rasterized Caption
 483       2:130  Image Type
 484       2:131  Image Orientation
 485       2:135  Language Identifier
 486       2:150  Audio Type
 487       2:151  Audio Sampling Rate
 488       2:152  Audio Sampling Resolution
 489       2:153  Audio Duration
 490       2:154  Audio Outcue
 491       2:200  ObjectData Preview File Format
 492       2:201  ObjectData Preview File Format Version
 493       2:202  ObjectData Preview Data
 494
 495     Pre-ObjectData Descriptor Record
 496       7:10   Size Mode
 497       7:20   Max Subfile Size
 498       7:90   ObjectData Size Announced
 499       7:95   Maximum ObjectData Size
 500
 501     ObjectData Record
 502       8:10   Subfile
 503
 504     Post ObjectData Descriptor Record
 505       9:10   Confirmed ObjectData Size
 506 </pre>
 507 </div>
 508 \r
 509 </div>\r
 510 \r
 511 <div id="linkbar">\r
 512     <span id="linkbar-west">&nbsp;</span>\r
 513     <span id="linkbar-center">\r
 514       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 515       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 516     </span>\r
 517     <span id="linkbar-east">&nbsp;</span>\r
 518   </div>\r
 519   <div class="footer">\r
 520     <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>\r
 521     <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 522   </div>\r
 523   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 524   <script type="text/javascript">\r
 525     var _gaq = _gaq || [];\r
 526     _gaq.push(['_setAccount', 'UA-17690367-1']);\r
 527     _gaq.push(['_trackPageview']);\r
 528 \r
 529     (function() {\r
 530       var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;\r
 531       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';\r
 532       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);\r
 533     })();\r
 534   </script>\r
 535 </body>\r
 536 </html>\r