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

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