Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / cd1da08edce989e248041cacf5c280e54ddabdce / . / www / escape.html
blob: 2f085fba715e4e487e79e381ab21c315df96b048 [file] [log] [blame]
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]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>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]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"/>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]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
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]47<div class="menu">
48 <a href="../index.html">About ImageMagick</a>
49</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]50<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]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>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]81<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]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>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]106<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]107<div class="menu">
108 <a href="../www/download.html">Download</a>
109</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]110<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]111<div class="menu">
112 <a href="http://www.imagemagick.org/script/search.php">Search</a>
113</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]114<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]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>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]121<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]122<div class="menu">
123 <a href="../www/sponsors.html">Sponsors:</a>
124
125<div class="sponsbox">
126<div class="sponsor">
cristy0f61e612009-11-10 20:03:57 +0000[diff] [blame]127 <a href="http://www.hygi.de">Reinigungsmittel</a><!-- 201002000400+ -->
cristyb4c03bb2009-09-27 13:55:46 +0000[diff] [blame]128</div>
129<div class="sponsor">
cristy0f61e612009-11-10 20:03:57 +0000[diff] [blame]130 <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201004010120 Buchhorn -->
131</div>
132<div class="sponsor">
133 <a href="http://www.blumenversender.com">Blumenversand</a><!-- 201005010120 -->
cristy916e1922009-10-01 12:52:47 +0000[diff] [blame]134</div>
135<div class="sponsor">
cristyb4c03bb2009-09-27 13:55:46 +0000[diff] [blame]136 <a href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
137</div>
138<div class="sponsor">
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]139 <a href="http://www.goyax.de">Börse</a><!-- 201001000240 Gewiese digital-finance.de -->
140</div>
141<div class="sponsor">
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]142 <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012001200 allesdruck.de-->
143</div>
144<div class="sponsor">
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]145 <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
146</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]147</div>
148</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]149
150
151</div>
152
153<div class="main">
154
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]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
200for 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
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]436
437</div>
438
439<div id="linkbar">
440 <!-- <span id="linkbar-west">&nbsp;</span> -->
441 <span id="linkbar-center">
442 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
443 <a href="../www/mailing-list.html">Mailing Lists</a> &bull;
cristycd1da082009-11-11 02:24:40 +0000[diff] [blame^]444 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]445 </span>
446 <span id="linkbar-east">&nbsp;</span>
447 </div>
448 <div class="footer">
449 <span id="footer-west">&copy; 1999-2009 ImageMagick Studio LLC</span>
450 <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
451 </div>
452 <div style="clear: both; margin: 0; width: 100%; "></div>
453</body>
454</html>