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