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