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">\r
   5 <head>\r
   6   <meta http-equiv="Content-Type" value="application/xhtml+xml" />\r
   7   <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />\r
   8   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />\r
   9   <style type="text/css" media="screen,projection"><!--\r
  10     @import url("../www/magick.css");\r
  11   --></style>\r
  12   <link rel="shortcut icon" href="../images/wand.ico"  type="images/vnd.microsoft.icon"/>
  13   <title>ImageMagick: Format and Print Image Properties</title>
  14   <meta http-equiv="Content-Language" content="en-US"/>
  15   <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
  16   <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
  17   <meta name="Generator" content="PHP"/>
  18   <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"/>
  19   <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."/>
  20   <meta name="Rating" content="GENERAL"/>
  21   <meta name="Robots" content="INDEX, FOLLOW"/>
  22   <meta name="Generator" content="ImageMagick Studio LLC"/>
  23   <meta name="Author" content="ImageMagick Studio LLC"/>
  24   <meta name="Revisit-after" content="2 DAYS"/>
  25   <meta name="Resource-type" content="document"/>
  26   <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
  27   <meta name="Distribution" content="Global"/>
  28 </head>\r
  29 \r
  30 <body id="www-imagemagick-org">\r
  31 <div class="titlebar">\r
  32 <a href="../index.html">\r
  33   <img src="../images/script.png" alt="[ImageMagick]"\r
  34   style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>\r
  35 <a href="http://www.networkredux.com">\r
  36   <img src="../images/networkredux.png" alt="[sponsor]"\r
  37   style="margin: 45px auto; border: 0px; float: left;" /></a>\r
  38 <a href="http://www.imagemagick.org/discourse-server/">\r
  39   <img src="../images/logo.jpg" alt=""\r
  40   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  41 <a href="../index.html">\r
  42   <img src="../images/sprite.jpg" alt=""\r
  43   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  44 </div>\r
  45 \r
  46 <div class="eastbar">\r
  47 \r
  48 <div class="menu">
  49   <a href="../index.html">About ImageMagick</a>
  50 </div>
  51 <div class="sep"></div>\r
  52 <div class="menu">
  53   <a href="../www/command-line-tools.html">Command-line Tools</a>
  54 </div>
  55 <div class="sub">
  56     <a href="../www/command-line-processing.html">Processing</a>
  57 </div>
  58 <div class="sub">
  59     <a href="../www/command-line-options.html">Options</a>
  60 </div>
  61 <div class="sub">
  62     <a href="http://www.imagemagick.org/Usage/">Usage</a>
  63 </div>
  64 <div class="menu">
  65   <a href="../www/api.html">Program Interfaces</a>
  66 </div>
  67 <div class="sub">
  68     <a href="../www/magick-wand.html">MagickWand</a>
  69 </div>
  70 <div class="sub">
  71     <a href="../www/magick-core.html">MagickCore</a>
  72 </div>
  73 <div class="sub">
  74     <a href="../www/perl-magick.html">PerlMagick</a>
  75 </div>
  76 <div class="sub">
  77     <a href="../Magick++/">Magick++</a>
  78 </div>
  79 <div class="menu">
  80   <a href="../www/architecture.html">Architecture</a>
  81 </div>
  82 <div class="sep"></div>\r
  83 <div  class="menu">
  84    <a href="../www/install-source.html">Install from Source</a>
  85 </div>
  86 <div class="sub">
  87     <a href="../www/install-source.html#unix">Unix</a>
  88 </div>
  89 <div class="sub">
  90     <a href="../www/install-source.html#windows">Windows</a>
  91  </div>
  92 <div class="menu">
  93   <a href="../www/binary-releases.html">Binary Releases</a>
  94 </div>
  95 <div class="sub">
  96     <a href="../www/binary-releases.html#unix">Unix</a>
  97 </div>
  98 <div class="sub">
  99     <a href="../www/binary-releases.html#macosx">Mac OS X</a>
 100 </div>
 101 <div class="sub">
 102     <a href="../www/binary-releases.html#windows">Windows</a>
 103 </div>
 104 <div class="menu">
 105   <a href="../www/resources.html">Resources</a>
 106 </div>
 107 <div class="sep"></div>\r
 108 <div class="menu">
 109   <a href="../www/download.html">Download</a>
 110 </div>
 111 <div class="sep"></div>\r
 112 <div class="menu">
 113   <a href="http://www.imagemagick.org/script/search.php">Search</a>
 114 </div>
 115 <div class="sep"></div>\r
 116 <div class="menu">
 117   <a href="../www/sitemap.html">Site Map</a>
 118 </div>
 119 <div  class="sub">
 120     <a href="../www/links.html">Links</a>
 121 </div>
 122 <div class="sep"></div>\r
 123 <div  class="menu">
 124   <a href="../www/sponsors.html">Sponsors:</a>
 125
 126 <div class="sponsbox">
 127 <div  class="sponsor">
 128    <a href="http://www.geschenke-elsen.de/" title="Lampe Berger">Lampe Berger</a><!-- 20106101000040 -->
 129 </div>
 130 <div  class="sponsor">
 131   <a href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
 132 </div>
 133 <div  class="sponsor">
 134   <a href="http://www.tomsgutscheine.de">Tom's Gutscheine</a><!-- 201005010360 invendio.de-->
 135 </div>
 136 <div  class="sponsor">
 137   <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201007010120 Buchhorn -->
 138 </div>
 139 <div  class="sponsor">
 140   <a href="http://www.blumenversender.com">Blumenversand</a><!-- 201005010120 -->
 141 </div>
 142 <div  class="sponsor">
 143   <a href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
 144 </div>
 145 <div  class="sponsor">
 146    <a href="http://www.goyax.de">Börse</a><!-- 201004010240 Gewiese digital-finance.de -->
 147 </div>
 148 <div  class="sponsor">
 149    <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
 150 </div>
 151 </div>
 152 </div>
 153 \r
 154 \r
 155 </div>\r
 156 \r
 157 <div class="main">\r
 158 \r
 159 <p class="navigation-index"></p>
 160
 161 <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>
 162
 163 <pre class="text">
 164    %b   file size
 165    %c   comment
 166    %d   directory
 167    %e   filename extension
 168    %f   filename
 169    %g   page geometry
 170    %h   current image height in pixels
 171    %i   input filename
 172    %k   number of unique colors
 173    %l   label
 174    %m   magick
 175    %n   number of scenes
 176    %o   output filename
 177    %p   page number
 178    %q   quantum depth
 179    %r   image class and colorspace
 180    %s   scene number
 181    %t   top of filename
 182    %u   unique temporary filename
 183    %w   current width in pixels
 184    %x   x resolution
 185    %y   y resolution
 186    %z   image depth
 187    %A   image alpha channel
 188    %C   image compression type
 189    %D   image dispose method
 190    %H   page height
 191    %W   page width
 192    %X   page x offset
 193    %Y   page y offset
 194    %Q   image compression quality
 195    %T   image delay
 196    %@   bounding box
 197    %#   signature
 198    %%   a percent sign
 199    \n   newline
 200    \r   carriage return
 201 </pre>
 202
 203 <p>Here is a sample command and its output
 204 for an image with filename <kbd>bird.miff</kbd> and whose width is 512 and height is 480.</p>
 205
 206 <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>
 207 <p>Additional properties are recognized when enclosed in braces:</p>
 208
 209 <pre class="text">
 210    %[base]
 211    %[channels]
 212    %[colorspace]
 213    %[depth]
 214    %[directory]
 215    %[extension]
 216    %[group]
 217    %[height]               original height of image (when it was read in)
 218    %[magick]
 219    %[max]
 220    %[mean]
 221    %[min]
 222    %[name]
 223    %[page]
 224    %[scene]
 225    %[scenes]
 226    %[size]                 original size of image (when it was read in)
 227    %[standard-deviation]
 228    %[unique]
 229    %[width]                original width of image (when it was read in)
 230    %[xresolution]
 231    %[yresolution]
 232 </pre>
 233
 234 <p>Use <kbd>fx:</kbd> to evaluate <a href="../www/fx.html">FX</a> expressions:</p>
 235
 236 <p class="text">
 237    %[fx:<em class="arg">expression</em>]
 238 </p>
 239
 240 <p>Use <kbd>pixel:</kbd> to evaluate a pixel color as defined by the <a href="../www/fx.html">FX</a> expression:</p>
 241
 242 <pre class="text">
 243    %[pixel:<em class="arg">expression</em>]
 244 </pre>
 245
 246 <p>You can also use the following special formatting syntax to print EXIF information contained in the file:</p>
 247
 248 <pre class="text">
 249    %[EXIF:<em class="arg">tag</em>]
 250 </pre>
 251
 252 <p>Choose <em class="arg">tag</em> from the following:</p>
 253
 254 <pre class="text">
 255    *  (print all EXIF tags, in keyword=data format)
 256    !  (print all EXIF tags, in tag_number data format)
 257    #hhhh (print data for EXIF tag #hhhh)
 258    ImageWidth
 259    ImageLength
 260    BitsPerSample
 261    Compression
 262    PhotometricInterpretation
 263    FillOrder
 264    DocumentName
 265    ImageDescription
 266    Make
 267    Model
 268    StripOffsets
 269    Orientation
 270    SamplesPerPixel
 271    RowsPerStrip
 272    StripByteCounts
 273    XResolution
 274    YResolution
 275    PlanarConfiguration
 276    ResolutionUnit
 277    TransferFunction
 278    Software
 279    DateTime
 280    Artist
 281    WhitePoint
 282    PrimaryChromaticities
 283    TransferRange
 284    JPEGProc
 285    JPEGInterchangeFormat
 286    JPEGInterchangeFormatLength
 287    YCbCrCoefficients
 288    YCbCrSubSampling
 289    YCbCrPositioning
 290    ReferenceBlackWhite
 291    CFARepeatPatternDim
 292    CFAPattern
 293    BatteryLevel
 294    Copyright
 295    ExposureTime
 296    FNumber
 297    IPTC/NAA
 298    EXIFOffset
 299    InterColorProfile
 300    ExposureProgram
 301    SpectralSensitivity
 302    GPSInfo
 303    ISOSpeedRatings
 304    OECF
 305    EXIFVersion
 306    DateTimeOriginal
 307    DateTimeDigitized
 308    ComponentsConfiguration
 309    CompressedBitsPerPixel
 310    ShutterSpeedValue
 311    ApertureValue
 312    BrightnessValue
 313    ExposureBiasValue
 314    MaxApertureValue
 315    SubjectDistance
 316    MeteringMode
 317    LightSource
 318    Flash
 319    FocalLength
 320    MakerNote
 321    UserComment
 322    SubSecTime
 323    SubSecTimeOriginal
 324    SubSecTimeDigitized
 325    FlashPixVersion
 326    ColorSpace
 327    EXIFImageWidth
 328    EXIFImageLength
 329    InteroperabilityOffset
 330    FlashEnergy
 331    SpatialFrequencyResponse
 332    FocalPlaneXResolution
 333    FocalPlaneYResolution
 334    FocalPlaneResolutionUnit
 335    SubjectLocation
 336    ExposureIndex
 337    SensingMethod
 338    FileSource
 339    SceneType
 340 </pre>
 341
 342 <p>Surround the format specification with quotation marks to prevent your shell from misinterpreting any spaces and square brackets.</p>
 343
 344 <p>The following special formatting syntax can be used to print IPTC information contained in the file:</p>
 345
 346 <pre class="text">
 347    %[IPTC:<em class="arg">dataset</em>:<em class="arg">record</em>]
 348 </pre>
 349
 350 <p>Select <em class="arg">dataset</em> and <em class="arg">record</em> from the following:</p>
 351
 352 <pre class="text">
 353     Envelope Record
 354       1:00  Model Version
 355       1:05  Destination
 356       1:20  File Format
 357       1:22  File Format Version
 358       1:30  Service Identifier
 359       1:40  Envelope Number
 360       1:50  Product ID
 361       1:60  Envelope Priority
 362       1:70  Date Sent
 363       1:80  Time Sent
 364       1:90  Coded Character Set
 365       1:100  UNO (Unique Name of Object)
 366       1:120  ARM Identifier
 367       1:122  ARM Version
 368
 369     Application Record
 370       2:00  Record Version
 371       2:03  Object Type Reference
 372       2:05  Object Name (Title)
 373       2:07  Edit Status
 374       2:08  Editorial Update
 375       2:10  Urgency
 376       2:12  Subject Reference
 377       2:15  Category
 378       2:20  Supplemental Category
 379       2:22  Fixture Identifier
 380       2:25  Keywords
 381       2:26  Content Location Code
 382       2:27  Content Location Name
 383       2:30  Release Date
 384       2:35  Release Time
 385       2:37  Expiration Date
 386       2:35  Expiration Time
 387       2:40  Special Instructions
 388       2:42  Action Advised
 389       2:45  Reference Service
 390       2:47  Reference Date
 391       2:50  Reference Number
 392       2:55  Date Created
 393       2:60  Time Created
 394       2:62  Digital Creation Date
 395       2:63  Digital Creation Time
 396       2:65  Originating Program
 397       2:70  Program Version
 398       2:75  Object Cycle
 399       2:80  By-Line (Author)
 400       2:85  By-Line Title (Author Position) [Not used in Photoshop 7]
 401       2:90  City
 402       2:92  Sub-Location
 403       2:95  Province/State
 404       2:100  Country/Primary Location Code
 405       2:101  Country/Primary Location Name
 406       2:103  Original Transmission Reference
 407       2:105  Headline
 408       2:110  Credit
 409       2:115  Source
 410       2:116  Copyright Notice
 411       2:118  Contact
 412       2:120  Caption/Abstract
 413       2:122  Caption Writer/Editor
 414       2:125  Rasterized Caption
 415       2:130  Image Type
 416       2:131  Image Orientation
 417       2:135  Language Identifier
 418       2:150  Audio Type
 419       2:151  Audio Sampling Rate
 420       2:152  Audio Sampling Resolution
 421       2:153  Audio Duration
 422       2:154  Audio Outcue
 423       2:200  ObjectData Preview File Format
 424       2:201  ObjectData Preview File Format Version
 425       2:202  ObjectData Preview Data
 426
 427     Pre-ObjectData Descriptor Record
 428       7:10   Size Mode
 429       7:20   Max Subfile Size
 430       7:90   ObjectData Size Announced
 431       7:95   Maximum ObjectData Size
 432
 433     ObjectData Record
 434       8:10   Subfile
 435
 436     Post ObjectData Descriptor Record
 437       9:10   Confirmed ObjectData Size
 438 </pre>
 439
 440 \r
 441 </div>\r
 442 \r
 443 <div id="linkbar">\r
 444  <!--    <span id="linkbar-west">&nbsp;</span>  -->\r
 445     <span id="linkbar-center">\r
 446       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 447     <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 448     </span>\r
 449     <span id="linkbar-east">&nbsp;</span>\r
 450   </div>\r
 451   <div class="footer">\r
 452     <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>\r
 453     <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 454   </div>\r
 455   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 456 </body>\r
 457 </html>\r