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