granicus.if.org Git - imagemagick/blob - www/escape.html

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