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