2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
\r
3 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
\r
4 <html version="-//W3C//DTD XHTML 1.1//EN"
\r
5 xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
\r
6 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
\r
7 xsi:schemaLocation="http://www.w3.org/1999/xhtml
\r
8 http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">
\r
10 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
\r
11 <meta name="google-site-verification" content="MxsMq6bdLOx0KSuz1MY6yG9ZTIJ7_7DVRfl5NCAT5Yg"/>
\r
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="Application-name" content="ImageMagick"/>
17 <meta name="Description" content="Use ImageMagick to convert, edit, or compose bitmap images in a variety of formats. In addition resize, rotate, shear, distort and transform images automagically."/>
18 <meta name="Application-url" content="http://www.imagemagick.org"/>
19 <meta name="Generator" content="PHP"/>
20 <meta name="Keywords" content="format, print, image, properties, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Image, Processing, Automagically"/>
21 <meta name="Rating" content="GENERAL"/>
22 <meta name="Robots" content="INDEX, FOLLOW"/>
23 <meta name="Generator" content="ImageMagick Studio LLC"/>
24 <meta name="Author" content="ImageMagick Studio LLC"/>
25 <meta name="Revisit-after" content="2 DAYS"/>
26 <meta name="Resource-type" content="document"/>
27 <meta name="Copyright" content="Copyright (c) 1999-2011 ImageMagick Studio LLC"/>
28 <meta name="Distribution" content="Global"/>
29 <link rel="icon" href="../images/wand.png"/>
30 <link rel="shortcut icon" href="../images/wand.ico" type="images/x-icon"/>
31 <link rel="canonical" href="http://www.imagemagick.org" />
\r
32 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
\r
33 <link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />
\r
34 <link rel="stylesheet" type="text/css" href="http://www.imagemagick.org/fancybox/jquery.fancybox-1.3.4.css" media="screen" />
\r
35 <style type="text/css" media="all">
\r
36 @import url("../www/magick.css");
\r
38 <script type="text/javascript" src="https://apis.google.com/js/plusone.js"></script>
\r
39 <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.1/jquery.min.js"></script>
\r
40 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.fancybox-1.3.4.pack.js"></script>
\r
41 <script type="text/javascript">
\r
42 $(document).ready(function() {
\r
43 $("a[href$=.jpg],a[href$=.png],a[href$=.gif]").fancybox({
\r
44 'transitionIn' : 'elastic',
\r
45 'transitionOut' : 'elastic',
\r
46 'overlayShow' : false,
\r
53 <body id="www-imagemagick-org">
\r
54 <div class="titlebar">
\r
55 <div style="margin: 17px auto; float: left;">
\r
56 <script type="text/javascript">
\r
58 google_ad_client = "pub-3129977114552745";
\r
59 google_ad_slot = "5439289906";
\r
60 google_ad_width = 728;
\r
61 google_ad_height = 90;
\r
64 <script type="text/javascript"
\r
65 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
\r
68 <a href="http://www.imagemagick.org/discourse-server/">
\r
69 <img src="../images/logo.jpg"
\r
70 alt="ImageMagick Logo"
\r
71 style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
\r
72 <a href="../index.html">
\r
73 <img src="../images/sprite.jpg"
\r
74 alt="ImageMagick Sprite"
\r
75 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
\r
78 <div class="westbar">
\r
81 <a title="About ImageMagick" href="../index.html">About ImageMagick</a>
84 <a title="Binary Releases" href="../www/binary-releases.html">Binary Releases</a>
87 <a title="Binary Release: Unix" href="../www/binary-releases.html#unix">Unix</a>
90 <a title="Binary Release: MacOS X" href="../www/binary-releases.html#macosx">Mac OS X</a>
93 <a title="Binary Release: iOS" href="../www/binary-releases.html#iOS">iOS</a>
96 <a title="Binary Release: Windows" href="../www/binary-releases.html#windows">Windows</a>
98 <div class="sep"></div>
\r
100 <a title="Command-line Tools" href="../www/command-line-tools.html">Command-line Tools</a>
103 <a title="Command-line Tools: Processing" href="../www/command-line-processing.html">Processing</a>
106 <a title="Command-line Tools: Options" href="../www/command-line-options.html">Options</a>
109 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
112 <a title="Program Interfaces" href="../www/api.html">Program Interfaces</a>
115 <a title="Program Interface: MagickWand" href="../www/magick-wand.html">MagickWand</a>
118 <a title="Program Interface: MagickCore" href="../www/magick-core.html">MagickCore</a>
121 <a title="Program Interface: PerlMagick" href="../www/perl-magick.html">PerlMagick</a>
124 <a title="Program Interface: Magick++" href="../www/magick++.html">Magick++</a>
126 <div class="sep"></div>
\r
128 <a title="Install from Source" href="../www/install-source.html">Install from Source</a>
131 <a title="Install from Source: Unix" href="../www/install-source.html#unix">Unix</a>
134 <a title="Install from Source: Windows" href="../www/install-source.html#windows">Windows</a>
137 <a title="Resources" href="../www/resources.html">Resources</a>
140 <a title="Architecture" href="../www/architecture.html">Architecture</a>
143 <a title="Download" href="../www/download.html">Download</a>
145 <div class="sep"></div>
\r
147 <a title="Search" href="../www/search.html">Search</a>
149 <div class="sep"></div>
\r
151 <a title="Site Map" href="../www/sitemap.html">Site Map</a>
154 <a title="Site Map: Links" href="../www/links.html">Links</a>
156 <div class="sep"></div>
\r
158 <a rel="follow" title="Sponsors" href="../www/sponsors.html">Sponsors:</a>
160 <a href="http://www.networkredux.com">
161 <img src="../images/networkredux.png" width="140" height="31" alt="[sponsor]"
162 style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a>
163 <div class="sponsbox">
164 <div class="sponsor">
165 <a rel="follow" title="Sponsor: Autoteile" href="http://www.q11-shop.de">Autoteile</a><!-- 201205010540s suvalj -->
167 <div class="sponsor">
168 <a rel="follow" title="Sponsor: Web Hosting" href="http://www.micfo.com">Web Hosting</a><!-- 209901010090s golestan -->
170 <div class="sponsor">
171 <a rel="follow" title="Sponsor: Search engine optimisation" href="http://www.seomoves.com.au">Search engine optimisation</a><!-- 201110010090s jen@seo lowprofilelinks -->
173 <div class="sponsor">
174 <a rel="follow" title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
176 <div class="sponsor">
177 <a rel="follow" title="Sponsor: Web Hosting Deals" href="http://www.webhostingdeals.org">Web Hosting Deals</a><!-- 201111010270 chee.hoa darin -->
179 <div class="sponsor">
180 <a rel="follow" title="Sponsor: Autos part" href="http://www.pkwteile.de/autoteile">Autos part</a><!-- 201112010090s jr@pkwte... -->
182 <div class="sponsor">
183 <a rel="follow" title="Sponsor: Web Hosting Reviews" href="http://www.webhostingsecretrevealed.com">Web Hosting Secret Revealed</a><!-- 201204010540 iamchee jerry -->
185 <div class="sponsor">
186 <a rel="follow" title="Sponsor: Web Hosting Break" href="http://www.webhostingbreak.com">Web Hosting Break</a><!-- 201109010090 ian@ian-m... -->
188 <div class="sponsor">
189 <a rel="follow" title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201303011500 r.leo -->
191 <div class="sponsor">
192 <a rel="follow" title="Sponsor: Website Hosting" href="http://www.hostreviewgeeks.com">Website Hosting</a><!-- 201110010090 alexanian media -->
194 <div class="sponsor">
195 <a rel="follow" title="Sponsor: Hotel München" href="http://www.messehotel-erb-muenchen.de">Hotel München</a><!-- 201111010450 cerb -->
197 <div class="sponsor">
198 <a rel="follow" title="Sponsor: Best Web Hosting" href="http://webhostinggeeks.com">Best Web Hosting</a><!-- 201110010720 -->
200 <div class="sponsor">
201 <a rel="follow" title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
203 <div class="sponsor">
204 <a rel="follow" title="Sponsor: Web Hosting Ratings" href="http://webhostingrating.com">Web Hosting Ratings</a><!-- 201110010720 -->
206 <div class="sponsor">
207 <a rel="follow" title="Kaffeevollautomaten Reparatur Kundendienst Berlin" href="http://www.kaffeemaschinen-center.de">Kaffeevollautomaten Reparatur Berlin</a><!-- 2011090100025 c.karule-->
213 <div class="eastbar">
\r
214 <div class="g-plusone" data-size="standard" data-count="false"></div>
\r
219 <h1>ImageMagick Escapes</h1>
220 <p class="navigation-index"></p>
222 <div class="doc-section">
223 <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>
226 %b original file size of image file
229 %e filename extension or suffix
230 %f filename (including suffix)
231 %g page geometry ( = %Wx%H%X%Y )
232 %h current image height in pixels
233 %i input filename (full path)
234 %k number of unique colors
236 %m magick format used during read
237 %n number of images in sequence
239 %p index of image in sequence
240 %q quantum depth (compile-time constant)
241 %r image class and colorspace
242 %s scene number (from input unless re-assigned)
243 %t top of filename (excluding suffix)
244 %u unique temporary filename
245 %w current width in pixels
248 %z image depth (as read in)
249 %A image transparency channel enabled (true/false)
250 %C image compression type
251 %D image dispose method
252 %G image size ( = %wx%h )
253 %H page (canvas) height
254 %O page (canvas) offset ( = %X%Y )
255 %P page (canvas) size ( = %Wx%H )
256 %Q image compression quality
259 %W page (canvas) width
260 %X page (canvas) x offset (including sign)
261 %Y page (canvas) y offset (including sign)
269 <p>Here is a sample command and its output
270 for an image with filename <kbd>bird.miff</kbd> and whose width is 512 and height is 480.</p>
272 <p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>identify -format "%m:%f %wx%h" bird.miff</span><span class='crtout'>MIFF:bird.miff 512x480</span></p>
273 <p>Additional properties are recognized when enclosed in braces:</p>
276 %[base] base filename, no suffixes (as %t)
278 %[colorspace] Colorspace of Image Data (excluding transparency)
279 %[copyright] ImageMagick Copyright String
280 %[depth] depth of image for write (as input unless changed)
281 %[directory] directory part of filename (as %d)
282 %[extension] extention part of filename (as %e)
284 %[height] original height of image (when it was read in)
285 %[magick] coder used to read image (not the file suffix)
292 %[scene] original scene number of image in input file
293 %[scenes] original number of scenes in input file
294 %[size] original size of image (when it was read in)
295 %[standard-deviation]
296 %[unique] unique temporary filename ???
297 %[version] Version Information of this running ImageMagick
298 %[width] original width of image (when it was read in)
301 %[*] list of image property strings
304 <p>Use <kbd>%[fx:...]</kbd> to evaluate <a href="../www/fx.html">FX</a> expressions:</p>
307 %[fx:<em class="arg">expression</em>]
310 <p>Use <kbd>pixel:</kbd> to evaluate a pixel color as defined by the <a href="../www/fx.html">FX</a> expression:</p>
313 %[pixel:<em class="arg">expression</em>]
316 <p>You can also use the following special formatting syntax to print EXIF
317 information contained in the file:</p>
320 %[EXIF:<em class="arg">tag</em>]
323 <p>Choose <em class="arg">tag</em> from the following:</p>
326 * (print all EXIF tags, in keyword=data format)
327 ! (print all EXIF tags, in tag_number data format)
328 #hhhh (print data for EXIF tag #hhhh)
333 PhotometricInterpretation
353 PrimaryChromaticities
356 JPEGInterchangeFormat
357 JPEGInterchangeFormatLength
379 ComponentsConfiguration
380 CompressedBitsPerPixel
400 InteroperabilityOffset
402 SpatialFrequencyResponse
403 FocalPlaneXResolution
404 FocalPlaneYResolution
405 FocalPlaneResolutionUnit
413 <p>Surround the format specification with quotation marks to prevent your shell from misinterpreting any spaces and square brackets.</p>
415 <p>The following special formatting syntax can be used to print IPTC information contained in the file:</p>
418 %[IPTC:<em class="arg">dataset</em>:<em class="arg">record</em>]
421 <p>Select <em class="arg">dataset</em> and <em class="arg">record</em> from the following:</p>
428 1:22 File Format Version
429 1:30 Service Identifier
432 1:60 Envelope Priority
435 1:90 Coded Character Set
436 1:100 UNO (Unique Name of Object)
442 2:03 Object Type Reference
443 2:05 Object Name (Title)
445 2:08 Editorial Update
447 2:12 Subject Reference
449 2:20 Supplemental Category
450 2:22 Fixture Identifier
452 2:26 Content Location Code
453 2:27 Content Location Name
458 2:40 Special Instructions
460 2:45 Reference Service
462 2:50 Reference Number
465 2:62 Digital Creation Date
466 2:63 Digital Creation Time
467 2:65 Originating Program
470 2:80 By-Line (Author)
471 2:85 By-Line Title (Author Position) [Not used in Photoshop 7]
475 2:100 Country/Primary Location Code
476 2:101 Country/Primary Location Name
477 2:103 Original Transmission Reference
481 2:116 Copyright Notice
483 2:120 Caption/Abstract
484 2:122 Caption Writer/Editor
485 2:125 Rasterized Caption
487 2:131 Image Orientation
488 2:135 Language Identifier
490 2:151 Audio Sampling Rate
491 2:152 Audio Sampling Resolution
494 2:200 ObjectData Preview File Format
495 2:201 ObjectData Preview File Format Version
496 2:202 ObjectData Preview Data
498 Pre-ObjectData Descriptor Record
500 7:20 Max Subfile Size
501 7:90 ObjectData Size Announced
502 7:95 Maximum ObjectData Size
507 Post ObjectData Descriptor Record
508 9:10 Confirmed ObjectData Size
515 <span id="linkbar-west"> </span>
\r
516 <span id="linkbar-center">
\r
517 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> •
\r
518 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
\r
520 <span id="linkbar-east"> </span>
\r
522 <div class="footer">
\r
523 <span id="footer-west">© 1999-2011 ImageMagick Studio LLC</span>
\r
524 <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
\r
526 <div style="clear: both; margin: 0; width: 100%; "></div>
\r
527 <script type="text/javascript">
\r
528 var _gaq = _gaq || [];
\r
529 _gaq.push(['_setAccount', 'UA-17690367-1']);
\r
530 _gaq.push(['_trackPageview']);
\r
533 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
\r
534 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
\r
535 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
\r