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