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: Image Converter" href="http://www.batchphoto.com">Image Converter</a><!-- 201103010900 Bits Coffee-->
 132 </div>
 133 <div  class="sponsor">
 134   <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
 135 </div>
 136 <div  class="sponsor">
 137   <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
 138 </div>
 139 <div  class="sponsor">
 140   <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
 141 </div>
 142 <div  class="sponsor">
 143   <a title="Sponsor: Diamonds are a Girls Best Friend" href="http://www.schmuck.org">Diamonds are a Girls Best Friend</a><!-- 201101010600 Peterssen-->
 144 </div>
 145 <div  class="sponsor">
 146    <a title="Sponsor: Druckerei Online" href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
 147 </div>
 148 <div  class="sponsor">
 149    <a title="Sponsor: Online-Magazin" href="http://www.unkostenbeitrag.de/">Online-Magazin</a><!-- 20101101000200 -->
 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    %[depth]
 226    %[directory]
 227    %[extension]
 228    %[group]
 229    %[height]               original height of image (when it was read in)
 230    %[magick]
 231    %[max]
 232    %[mean]
 233    %[min]
 234    %[name]
 235    %[page]
 236    %[scene]
 237    %[scenes]
 238    %[size]                 original size of image (when it was read in)
 239    %[standard-deviation]
 240    %[unique]               unique temporary filename
 241    %[width]                original width of image (when it was read in)
 242    %[xresolution]
 243    %[yresolution]
 244 </pre>
 245
 246 <p>Use <kbd>fx:</kbd> to evaluate <a href="../www/fx.html">FX</a> expressions:</p>
 247
 248 <p class="text">
 249    %[fx:<em class="arg">expression</em>]
 250 </p>
 251
 252 <p>Use <kbd>pixel:</kbd> to evaluate a pixel color as defined by the <a href="../www/fx.html">FX</a> expression:</p>
 253
 254 <pre class="text">
 255    %[pixel:<em class="arg">expression</em>]
 256 </pre>
 257
 258 <p>You can also use the following special formatting syntax to print EXIF information contained in the file:</p>
 259
 260 <pre class="text">
 261    %[EXIF:<em class="arg">tag</em>]
 262 </pre>
 263
 264 <p>Choose <em class="arg">tag</em> from the following:</p>
 265
 266 <pre class="text">
 267    *  (print all EXIF tags, in keyword=data format)
 268    !  (print all EXIF tags, in tag_number data format)
 269    #hhhh (print data for EXIF tag #hhhh)
 270    ImageWidth
 271    ImageLength
 272    BitsPerSample
 273    Compression
 274    PhotometricInterpretation
 275    FillOrder
 276    DocumentName
 277    ImageDescription
 278    Make
 279    Model
 280    StripOffsets
 281    Orientation
 282    SamplesPerPixel
 283    RowsPerStrip
 284    StripByteCounts
 285    XResolution
 286    YResolution
 287    PlanarConfiguration
 288    ResolutionUnit
 289    TransferFunction
 290    Software
 291    DateTime
 292    Artist
 293    WhitePoint
 294    PrimaryChromaticities
 295    TransferRange
 296    JPEGProc
 297    JPEGInterchangeFormat
 298    JPEGInterchangeFormatLength
 299    YCbCrCoefficients
 300    YCbCrSubSampling
 301    YCbCrPositioning
 302    ReferenceBlackWhite
 303    CFARepeatPatternDim
 304    CFAPattern
 305    BatteryLevel
 306    Copyright
 307    ExposureTime
 308    FNumber
 309    IPTC/NAA
 310    EXIFOffset
 311    InterColorProfile
 312    ExposureProgram
 313    SpectralSensitivity
 314    GPSInfo
 315    ISOSpeedRatings
 316    OECF
 317    EXIFVersion
 318    DateTimeOriginal
 319    DateTimeDigitized
 320    ComponentsConfiguration
 321    CompressedBitsPerPixel
 322    ShutterSpeedValue
 323    ApertureValue
 324    BrightnessValue
 325    ExposureBiasValue
 326    MaxApertureValue
 327    SubjectDistance
 328    MeteringMode
 329    LightSource
 330    Flash
 331    FocalLength
 332    MakerNote
 333    UserComment
 334    SubSecTime
 335    SubSecTimeOriginal
 336    SubSecTimeDigitized
 337    FlashPixVersion
 338    ColorSpace
 339    EXIFImageWidth
 340    EXIFImageLength
 341    InteroperabilityOffset
 342    FlashEnergy
 343    SpatialFrequencyResponse
 344    FocalPlaneXResolution
 345    FocalPlaneYResolution
 346    FocalPlaneResolutionUnit
 347    SubjectLocation
 348    ExposureIndex
 349    SensingMethod
 350    FileSource
 351    SceneType
 352 </pre>
 353
 354 <p>Surround the format specification with quotation marks to prevent your shell from misinterpreting any spaces and square brackets.</p>
 355
 356 <p>The following special formatting syntax can be used to print IPTC information contained in the file:</p>
 357
 358 <pre class="text">
 359    %[IPTC:<em class="arg">dataset</em>:<em class="arg">record</em>]
 360 </pre>
 361
 362 <p>Select <em class="arg">dataset</em> and <em class="arg">record</em> from the following:</p>
 363
 364 <pre class="text">
 365     Envelope Record
 366       1:00  Model Version
 367       1:05  Destination
 368       1:20  File Format
 369       1:22  File Format Version
 370       1:30  Service Identifier
 371       1:40  Envelope Number
 372       1:50  Product ID
 373       1:60  Envelope Priority
 374       1:70  Date Sent
 375       1:80  Time Sent
 376       1:90  Coded Character Set
 377       1:100  UNO (Unique Name of Object)
 378       1:120  ARM Identifier
 379       1:122  ARM Version
 380
 381     Application Record
 382       2:00  Record Version
 383       2:03  Object Type Reference
 384       2:05  Object Name (Title)
 385       2:07  Edit Status
 386       2:08  Editorial Update
 387       2:10  Urgency
 388       2:12  Subject Reference
 389       2:15  Category
 390       2:20  Supplemental Category
 391       2:22  Fixture Identifier
 392       2:25  Keywords
 393       2:26  Content Location Code
 394       2:27  Content Location Name
 395       2:30  Release Date
 396       2:35  Release Time
 397       2:37  Expiration Date
 398       2:35  Expiration Time
 399       2:40  Special Instructions
 400       2:42  Action Advised
 401       2:45  Reference Service
 402       2:47  Reference Date
 403       2:50  Reference Number
 404       2:55  Date Created
 405       2:60  Time Created
 406       2:62  Digital Creation Date
 407       2:63  Digital Creation Time
 408       2:65  Originating Program
 409       2:70  Program Version
 410       2:75  Object Cycle
 411       2:80  By-Line (Author)
 412       2:85  By-Line Title (Author Position) [Not used in Photoshop 7]
 413       2:90  City
 414       2:92  Sub-Location
 415       2:95  Province/State
 416       2:100  Country/Primary Location Code
 417       2:101  Country/Primary Location Name
 418       2:103  Original Transmission Reference
 419       2:105  Headline
 420       2:110  Credit
 421       2:115  Source
 422       2:116  Copyright Notice
 423       2:118  Contact
 424       2:120  Caption/Abstract
 425       2:122  Caption Writer/Editor
 426       2:125  Rasterized Caption
 427       2:130  Image Type
 428       2:131  Image Orientation
 429       2:135  Language Identifier
 430       2:150  Audio Type
 431       2:151  Audio Sampling Rate
 432       2:152  Audio Sampling Resolution
 433       2:153  Audio Duration
 434       2:154  Audio Outcue
 435       2:200  ObjectData Preview File Format
 436       2:201  ObjectData Preview File Format Version
 437       2:202  ObjectData Preview Data
 438
 439     Pre-ObjectData Descriptor Record
 440       7:10   Size Mode
 441       7:20   Max Subfile Size
 442       7:90   ObjectData Size Announced
 443       7:95   Maximum ObjectData Size
 444
 445     ObjectData Record
 446       8:10   Subfile
 447
 448     Post ObjectData Descriptor Record
 449       9:10   Confirmed ObjectData Size
 450 </pre>
 451
 452 \r
 453 </div>\r
 454 \r
 455 <div id="linkbar">\r
 456     <span id="linkbar-west">&nbsp;</span>\r
 457     <span id="linkbar-center">\r
 458       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 459       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 460     </span>\r
 461     <span id="linkbar-east">&nbsp;</span>\r
 462   </div>\r
 463   <div class="footer">\r
 464     <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>\r
 465     <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 466   </div>\r
 467   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 468   <script type="text/javascript">\r
 469     var _gaq = _gaq || [];\r
 470     _gaq.push(['_setAccount', 'UA-17690367-1']);\r
 471     _gaq.push(['_trackPageview']);\r
 472 \r
 473     (function() {\r
 474       var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;\r
 475       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';\r
 476       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);\r
 477     })();\r
 478   </script>\r
 479 </body>\r
 480 </html>\r