]> granicus.if.org Git - imagemagick/blob - www/escape.html
(no commit message)
[imagemagick] / www / escape.html
1
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 
3   "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
4 <html version="-//W3C//DTD XHTML 1.1//EN"
5       xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
6       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
7       xsi:schemaLocation="http://www.w3.org/1999/xhtml
8                           http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">
9 <head>
10   <meta http-equiv="content-type" content="text/html; charset=UTF-8"/>
11   <meta name="google-site-verification" content="MxsMq6bdLOx0KSuz1MY6yG9ZTIJ7_7DVRfl5NCAT5Yg"/>
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, PerlMagick, image processing, OpenMP, software development library, image, photo, software, Magick++, MagickWand"/>
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-2013 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" />
32   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
33   <!-- Add jQuery library -->
34   <script type="text/javascript" src="http://localhost/ajax/libs/jquery/1.7/jquery.min.js"></script>
35   
36   <!-- Optionaly include easing and/or mousewheel plugins -->
37   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.easing-1.3.pack.js"></script>
38   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.mousewheel-3.0.6.pack.js"></script>
39   
40   <!-- Add fancyBox -->
41   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/jquery.fancybox.css?v=2.0.4" type="text/css" media="screen" />
42   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.fancybox.pack.js?v=2.0.4"></script>
43   
44   <!-- Optionaly include button and/or thumbnail helpers -->
45   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-buttons.css?v=2.0.4" type="text/css" media="screen" />
46   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-buttons.js?v=2.0.4"></script>
47   
48   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-thumbs.css?v=2.0.4" type="text/css" media="screen" />
49   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-thumbs.js?v=2.0.4"></script>
50   <script type="text/javascript">
51         $(document).ready(function() {
52                 $(".fancybox").fancybox();
53         });
54   </script>
55   <!-- ImageMagick style -->
56   <link rel="stylesheet" href="http://www.localhost/cse/style/look/default.css" type="text/css" />
57   <style type="text/css" media="all">
58     @import url("../www/magick.css");
59   </style>
60 </head>
61
62 <body id="www-imagemagick-org">
63 <div class="titlebar">
64 <div style="margin: 17px auto; float: left;">
65   <script type="text/javascript">
66   <!--
67     google_ad_client = "pub-3129977114552745";
68     google_ad_slot = "5439289906";
69     google_ad_width = 728;
70     google_ad_height = 90;
71   //-->
72   </script>
73   <script type="text/javascript"
74     src="http://localhost/pagead/show_ads.js">
75   </script>
76 </div>
77 <a href="../discourse-server">
78   <img src="../images/logo.jpg"
79   alt="ImageMagick Logo"
80   style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
81 <a href="../index.html">
82   <img src="../images/sprite.jpg"
83   alt="ImageMagick Sprite"
84   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
85 </div>
86
87 <div class="westbar">
88
89 <div class="menu">
90   <a title="About ImageMagick" href="../index.html">About ImageMagick</a>
91 </div>
92 <div class="menu">
93   <a title="Binary Releases" href="binary-releases.html">Binary Releases</a>
94 </div>
95 <div class="sub">
96     <a title="Binary Release: Unix" href="binary-releases.html#unix">Unix</a>
97 </div>
98 <div class="sub">
99     <a title="Binary Release: MacOS X" href="binary-releases.html#macosx">Mac OS X</a>
100 </div>
101 <div class="sub">
102     <a title="Binary Release: iOS" href="binary-releases.html#iOS">iOS</a>
103 </div>
104 <div class="sub">
105     <a title="Binary Release: Windows" href="binary-releases.html#windows">Windows</a>
106 </div>
107 <div class="sep"></div>
108 <div class="menu">
109   <a title="Command-line Tools" href="command-line-tools.html">Command-line Tools</a>
110 </div>
111 <div class="sub">
112     <a title="Command-line Tools: Processing" href="command-line-processing.html">Processing</a>
113 </div>
114 <div class="sub">
115     <a title="Command-line Tools: Options" href="command-line-options.html">Options</a>
116 </div>
117 <div class="sub">
118     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
119 </div>
120 <div class="menu">
121   <a title="Program Interfaces" href="api.html">Program Interfaces</a>
122 </div>
123 <div class="sub">
124     <a title="Program Interface: MagickWand" href="magick-wand.html">MagickWand</a>
125 </div>
126 <div class="sub">
127     <a title="Program Interface: MagickCore" href="magick-core.html">MagickCore</a>
128 </div>
129 <div class="sub">
130     <a title="Program Interface: PerlMagick" href="perl-magick.html">PerlMagick</a>
131 </div>
132 <div class="sub">
133     <a title="Program Interface: Magick++" href="magick++.html">Magick++</a>
134 </div>
135 <div class="sep"></div>
136 <div  class="menu">
137    <a title="Install from Source" href="install-source.html">Install from Source</a>
138 </div>
139 <div class="sub">
140     <a title="Install from Source: Unix" href="install-source.html#unix">Unix</a>
141 </div>
142 <div class="sub">
143     <a title="Install from Source: Windows" href="install-source.html#windows">Windows</a>
144  </div>
145 <div class="menu">
146   <a title="Resources" href="resources.html">Resources</a>
147 </div>
148 <div class="menu">
149   <a title="Architecture" href="architecture.html">Architecture</a>
150 </div>
151 <div class="menu">
152   <a title="Download" href="download.html">Download</a>
153 </div>
154 <div class="sep"></div>
155 <div class="menu">
156   <a title="Search" href="http://www.imagemagick.org/script/search.php">Search</a>
157 </div>
158 <div class="sep"></div>
159 <div class="menu">
160   <a title="Site Map" href="sitemap.html">Site Map</a>
161 </div>
162 <div  class="sub">
163   <a title="Site Map: Links" href="links.html">Links</a>
164 </div>
165 <div class="sep"></div>
166 <div class="menu">
167   <a rel="follow" title="Sponsors" href="sponsors.html">Sponsors:</a>
168
169   <a href="http://www.networkredux.com"> <img src="../images/networkredux.png" width="140" height="31" alt="[sponsor]" style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a>
170   <a href="http://www.dinodirect.com/ipads-tablets/"> <img src="../images/dino-direct.jpg" width="140" height="90" alt="[sponsor]" style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a><!-- 201208010120 mickey@163... -->
171 <div class="sponsbox">
172 <div class="sponsor">
173   <a rel="follow" title="Sponsor: The Fastest &amp; Easiest Way to Find Images" href="http://www.graphicsfactory.com">The Fastest &amp; Easiest Way to Find Images</a><!-- 201210010270 graphicsfac... -->
174 </div>
175 <div class="sponsor">
176   <a rel="follow" title="Sponsor: VPS" href="http://www.interdominios.com/vps">VPS</a><!-- 201209010090 barsh@inter... -->
177 </div>
178 <div class="sponsor">
179   <a rel="follow" title="Werbebanner Werbeplane" href="http://www.allesbanner.de">Werbebanner Werbeplane</a><!-- 201212010450 info@druck... -->
180 </div>
181 <div class="sponsor">
182   <a rel="follow" title="Entertainment News &amp; Photos" href="http://www.zimbio.com">Entertainment News &amp; Photos</a><!-- 201211010540 bd@zimb... -->
183 </div>
184 <div class="sponsor">
185   <a rel="follow" title="Sponsor: LED24" href="http://led24.de/">LED24</a><!-- 201207010270 info@led24... -->
186 </div>
187 <div class="sponsor">
188   <a rel="follow" title="Sponsor: Best Website Hosting" href="http://www.top-cheap-web-hosting.com">Best Website Hosting</a><!-- 201304010090 eunge.liu-->
189 </div>
190 <div class="sponsor">
191   <a rel="follow" title="Android Tablet" href="http://www.dinodirect.com/ipads-tablets/">Android Tablet</a><!-- 201208010120 mickey@163... -->
192 </div>
193 <div class="sponsor">
194   <a rel="follow" title="Sponsor: Web Site Hosting" href="http://webhostinggeeks.com">Web Site Hosting</a><!-- 201302010900 funds@enmob... -->
195 </div>
196 <div class="sponsor">
197    <a rel="follow" title="Sponsor: Premium Quality Stock Photos" href="http://www.f1online.pro/en/">Premium Quality Stock Photos</a><!-- 2012080100540 ... -->
198 </div>
199 <div class="sponsor">
200    <a rel="follow" title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 2012070100250 ... -->
201 </div>
202 <div class="sponsor">
203   <a rel="follow" title="Sponsor: Managed Server" href="http://www.robhost.de">Managed Server</a><!-- 201210010720 klikics... -->
204 </div>
205 <div class="sponsor">
206   <a rel="follow" title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201303011500 r.leo -->
207 </div>
208 <div class="sponsor">
209    <a rel="follow" title="Sponsor: Free Catalogs" href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 20120801000600 -->
210 </div>
211 <div class="sponsor">
212    <a rel="follow" title="Sponsor: Web Hosting" href="http://www.hostucan.com">Web Hosting</a><!-- 2012120100150 racent marketing@webhosting...-->
213 </div>
214 </div>
215 </div>
216 </div>
217
218 <div class="eastbar">
219   <div class="g-plusone" id="gplusone"></div>
220   <script type="text/javascript">
221     window.___gcfg = {
222       lang: 'en-US'
223     };
224
225     (function() {
226       var po = document.createElement('offline-script');
227       po.type = 'text/javascript'; po.async = true;
228       po.src = 'https://apis.localhost/js/plusone.js';
229       var script = document.getElementsByTagName('offline-script')[0];
230       script.parentNode.insertBefore(po, script);
231     })();
232     var gplusone = document.getElementById("gplusone");
233     gplusone.setAttribute("data-size","medium");
234     gplusone.setAttribute("data-count","false");
235   </script>
236 </div>
237
238 <div class="main">
239
240 <h1>ImageMagick Escapes</h1>
241 <p class="navigation-index"></p>
242
243 <div class="doc-section">
244 <p>Use the <a href="command-line-options.html#format_identify_"
245 >-format</a> option to print properties associated with an image in a format
246 of your choosing. You can include the image filename, type, width, height,
247 EXIF data, or other image attributes by embedding special format
248 characters:</p>
249
250 <pre class="text">
251    %b   file size of image read in
252    %c   comment meta-data property
253    %d   directory component of path
254    %e   filename extension or suffix
255    %f   filename (including suffix)
256    %g   layer canvas page geometry   ( = %Wx%H%X%Y )
257    %h   current image height in pixels
258    %i   image filename (note: becomes output filename for "info:")
259    %k   CALCULATED: number of unique colors
260    %l   label meta-data property
261    %m   image file format (file magic)
262    %n   number of images in current image sequence
263    %o   output filename  (used for delegates)
264    %p   index of image in current image list
265    %q   quantum depth (compile-time constant)
266    %r   image class and colorspace
267    %s   scene number (from input unless re-assigned)
268    %t   filename without directory or extension (suffix)
269    %u   unique temporary filename (used for delegates)
270    %w   current width in pixels
271    %x   x resolution (density)
272    %y   y resolution (density)
273    %z   image depth (as read in unless modified, image save depth)
274    %A   image transparency channel enabled (true/false)
275    %C   image compression type
276    %D   image GIF dispose method
277    %G   image size ( = %wx%h )
278    %H   page (canvas) height
279    %M   Magick filename (original file exactly as given,  including read mods)
280    %O   page (canvas) offset ( = %X%Y )
281    %P   page (canvas) size ( = %Wx%H )
282    %Q   image compression quality ( 0 = default )
283    %S   ?? scenes ??
284    %T   image time delay (in centi-seconds)
285    %W   page (canvas) width
286    %X   page (canvas) x offset (including sign)
287    %Y   page (canvas) y offset (including sign)
288    %Z   unique filename (used for delegates)
289    %@   CALCULATED: trim bounding box (without actually trimming)
290    %#   CALCULATED: 'signature' hash of image values
291    %%   a percent sign
292    \n   newline
293    \r   carriage return
294    &lt; less-than character.
295    &gt; greater-than character.
296   &amp; ampersand character.
297 </pre>
298
299 <p>Here is a sample command and its output
300 for an image with filename <kbd>bird.miff</kbd> and whose width is 512 and height is 480.</p>
301
302 <p class='crt'><span class="crtprompt"> $ </span><span class='crtin'>identify -format "%m:%f %wx%h" bird.miff</span><span class='crtout'>MIFF:bird.miff 512x480</span></p>
303 <p>Additional properties are recognized when enclosed in braces:</p>
304
305 <pre class="text">
306    %[base]                 base filename, no suffixes (as %t)
307    %[channels]             ??? channels in use - colorspace ???
308    %[colorspace]           Colorspace of Image Data (excluding transparency)
309    %[copyright]            ImageMagick Copyright String
310    %[depth]                depth of image for write (as input unless changed)
311    %[directory]            directory part of filename (as %d)
312    %[extension]            extention part of filename (as %e)
313    %[group]                ??? window group ???
314    %[height]               original height of image (when it was read in)
315    %[kurtosis]             CALCULATED: kurtosis statistic of image
316    %[magick]               coder used to read image (not the file suffix)
317    %[max]                  CALCULATED: maximum value statistic of image
318    %[mean]                 CALCULATED: average value statistic of image
319    %[min]                  CALCULATED: minimum value statistic of image
320    %[name]                 The original name of the image
321    %[opaque]               CALCULATED: is image fully-opaque?
322    %[page]                 Virtual canvas (page) geometry
323    %[resolution.y]         X density (resolution) without units
324    %[resolution.x]         Y density (resolution) without units
325    %[zero]                 zero (unique filename for delegates
326    %[scene]                original scene number of image in input file
327    %[size]                 original size of image (when it was read in)
328    %[skewness]             CALCULATED: skewness statistic of image
329    %[standard-deviation]   CALCULATED: standard-deviation statistic of image
330    %[unique]               unique temporary filename ???
331    %[version]              Version Information of this running ImageMagick
332    %[width]                original width of image (when it was read in)
333    %[*]                    list of image property strings
334 </pre>
335
336 <p>Use <kbd>%[fx:...]</kbd> to evaluate <a href="fx.html">FX</a> expressions:</p>
337
338 <pre class="text">
339    %[fx:<em class="arg">expression</em>]
340 </pre>
341
342 <p>Use <kbd>pixel:</kbd> to evaluate a pixel color as defined by the <a href="fx.html">FX</a> expression:</p>
343
344 <pre class="text">
345    %[pixel:<em class="arg">expression</em>]
346 </pre>
347
348 <p>You can also use the following special formatting syntax to print EXIF
349 information contained in the file:</p>
350
351 <pre class="text">
352    %[EXIF:<em class="arg">tag</em>]
353 </pre>
354
355 <p>Choose <em class="arg">tag</em> from the following:</p>
356
357 <pre class="text">
358    *  (print all EXIF tags, in keyword=data format)
359    !  (print all EXIF tags, in tag_number data format)
360    #hhhh (print data for EXIF tag #hhhh)
361    ImageWidth
362    ImageLength
363    BitsPerSample
364    Compression
365    PhotometricInterpretation
366    FillOrder
367    DocumentName
368    ImageDescription
369    Make
370    Model
371    StripOffsets
372    Orientation
373    SamplesPerPixel
374    RowsPerStrip
375    StripByteCounts
376    XResolution
377    YResolution
378    PlanarConfiguration
379    ResolutionUnit
380    TransferFunction
381    Software
382    DateTime
383    Artist
384    WhitePoint
385    PrimaryChromaticities
386    TransferRange
387    JPEGProc
388    JPEGInterchangeFormat
389    JPEGInterchangeFormatLength
390    YCbCrCoefficients
391    YCbCrSubSampling
392    YCbCrPositioning
393    ReferenceBlackWhite
394    CFARepeatPatternDim
395    CFAPattern
396    BatteryLevel
397    Copyright
398    ExposureTime
399    FNumber
400    IPTC/NAA
401    EXIFOffset
402    InterColorProfile
403    ExposureProgram
404    SpectralSensitivity
405    GPSInfo
406    ISOSpeedRatings
407    OECF
408    EXIFVersion
409    DateTimeOriginal
410    DateTimeDigitized
411    ComponentsConfiguration
412    CompressedBitsPerPixel
413    ShutterSpeedValue
414    ApertureValue
415    BrightnessValue
416    ExposureBiasValue
417    MaxApertureValue
418    SubjectDistance
419    MeteringMode
420    LightSource
421    Flash
422    FocalLength
423    MakerNote
424    UserComment
425    SubSecTime
426    SubSecTimeOriginal
427    SubSecTimeDigitized
428    FlashPixVersion
429    ColorSpace
430    EXIFImageWidth
431    EXIFImageLength
432    InteroperabilityOffset
433    FlashEnergy
434    SpatialFrequencyResponse
435    FocalPlaneXResolution
436    FocalPlaneYResolution
437    FocalPlaneResolutionUnit
438    SubjectLocation
439    ExposureIndex
440    SensingMethod
441    FileSource
442    SceneType
443 </pre>
444
445 <p>Surround the format specification with quotation marks to prevent your shell from misinterpreting any spaces and square brackets.</p>
446
447 <p>The following special formatting syntax can be used to print IPTC information contained in the file:</p>
448
449 <pre class="text">
450    %[IPTC:<em class="arg">dataset</em>:<em class="arg">record</em>]
451 </pre>
452
453 <p>Select <em class="arg">dataset</em> and <em class="arg">record</em> from the following:</p>
454
455 <pre class="text">
456     Envelope Record
457       1:00  Model Version
458       1:05  Destination
459       1:20  File Format
460       1:22  File Format Version
461       1:30  Service Identifier
462       1:40  Envelope Number
463       1:50  Product ID
464       1:60  Envelope Priority
465       1:70  Date Sent
466       1:80  Time Sent
467       1:90  Coded Character Set
468       1:100  UNO (Unique Name of Object)
469       1:120  ARM Identifier
470       1:122  ARM Version
471
472     Application Record
473       2:00  Record Version
474       2:03  Object Type Reference
475       2:05  Object Name (Title)
476       2:07  Edit Status
477       2:08  Editorial Update
478       2:10  Urgency
479       2:12  Subject Reference
480       2:15  Category
481       2:20  Supplemental Category
482       2:22  Fixture Identifier
483       2:25  Keywords
484       2:26  Content Location Code
485       2:27  Content Location Name
486       2:30  Release Date
487       2:35  Release Time
488       2:37  Expiration Date
489       2:35  Expiration Time
490       2:40  Special Instructions
491       2:42  Action Advised
492       2:45  Reference Service
493       2:47  Reference Date
494       2:50  Reference Number
495       2:55  Date Created
496       2:60  Time Created
497       2:62  Digital Creation Date
498       2:63  Digital Creation Time
499       2:65  Originating Program
500       2:70  Program Version
501       2:75  Object Cycle
502       2:80  By-Line (Author)
503       2:85  By-Line Title (Author Position) [Not used in Photoshop 7]
504       2:90  City
505       2:92  Sub-Location
506       2:95  Province/State
507       2:100  Country/Primary Location Code
508       2:101  Country/Primary Location Name
509       2:103  Original Transmission Reference
510       2:105  Headline
511       2:110  Credit
512       2:115  Source
513       2:116  Copyright Notice
514       2:118  Contact
515       2:120  Caption/Abstract
516       2:122  Caption Writer/Editor
517       2:125  Rasterized Caption
518       2:130  Image Type
519       2:131  Image Orientation
520       2:135  Language Identifier
521       2:150  Audio Type
522       2:151  Audio Sampling Rate
523       2:152  Audio Sampling Resolution
524       2:153  Audio Duration
525       2:154  Audio Outcue
526       2:200  ObjectData Preview File Format
527       2:201  ObjectData Preview File Format Version
528       2:202  ObjectData Preview Data
529
530     Pre-ObjectData Descriptor Record
531       7:10   Size Mode
532       7:20   Max Subfile Size
533       7:90   ObjectData Size Announced
534       7:95   Maximum ObjectData Size
535
536     ObjectData Record
537       8:10   Subfile
538
539     Post ObjectData Descriptor Record
540       9:10   Confirmed ObjectData Size
541 </pre>
542 </div>
543
544 </div>
545
546 <div id="linkbar">
547     <span id="linkbar-west">&nbsp;</span>
548     <span id="linkbar-center">
549       <a href="../discourse-server">Discourse Server</a> &bull;
550       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
551     </span>
552     <span id="linkbar-east">&nbsp;</span>
553   </div>
554   <div class="footer">
555     <span id="footer-west">&copy; 1999-2013 ImageMagick Studio LLC</span>
556     <span id="footer-east"> <a href="contact.html">Contact the Wizards</a></span>
557   </div>
558   <div style="clear: both; margin: 0; width: 100%; "></div>
559   <script type="text/javascript">
560     var _gaq = _gaq || [];
561     _gaq.push(['_setAccount', 'UA-17690367-1']);
562     _gaq.push(['_trackPageview']);
563
564     (function() {
565       var ga = document.createElement('offline-script'); ga.type = 'text/javascript'; ga.async = true;
566       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.localhost/ga.js';
567       var s = document.getElementsByTagName('offline-script')[0]; s.parentNode.insertBefore(ga, s);
568     })();
569   </script>
570 </body>
571 </html>