root/ImageMagick/trunk/www/escape.html

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