Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / e0a316c58eb3b49d04aec21d901b2ecb84559fff / . / www / escape.html
blob: 5bbd92416bc1245330ed9e4a19ddaa2e9bbe4d13 [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>
cristy1f9e1ed2009-11-18 04:09:38 +0000[diff] [blame]6 <meta http-equiv="Content-Type" value="application/xhtml+xml" />
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]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>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]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"/>
cristy16af1cb2009-12-11 21:38:29 +0000[diff] [blame]26 <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]27 <meta name="Distribution" content="Global"/>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]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
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]48<div class="menu">
49 <a href="../index.html">About ImageMagick</a>
50</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]51<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]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>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]82<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]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>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]107<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]108<div class="menu">
109 <a href="../www/download.html">Download</a>
110</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]111<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]112<div class="menu">
113 <a href="http://www.imagemagick.org/script/search.php">Search</a>
114</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]115<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]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>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]122<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]123<div class="menu">
124 <a href="../www/sponsors.html">Sponsors:</a>
125
126<div class="sponsbox">
127<div class="sponsor">
cristycdbe2742010-02-07 19:30:44 +0000[diff] [blame]128 <a href="http://www.abi-stoff.de/abizeitung/" title="Abibuch">Abizeitung</a><!-- 20101101000200 -->
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]129</div>
130<div class="sponsor">
cristy1f9e1ed2009-11-18 04:09:38 +0000[diff] [blame]131 <a href="http://www.tomsgutscheine.de">Tom's Gutscheine</a><!-- 201005010360 invendio.de-->
132</div>
133<div class="sponsor">
cristycdbe2742010-02-07 19:30:44 +0000[diff] [blame]134 <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201007010120 Buchhorn -->
cristy0f61e612009-11-10 20:03:57 +0000[diff] [blame]135</div>
136<div class="sponsor">
137 <a href="http://www.blumenversender.com">Blumenversand</a><!-- 201005010120 -->
cristy916e1922009-10-01 12:52:47 +0000[diff] [blame]138</div>
139<div class="sponsor">
cristyb4c03bb2009-09-27 13:55:46 +0000[diff] [blame]140 <a href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
141</div>
142<div class="sponsor">
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]143 <a href="http://www.goyax.de">Börse</a><!-- 201004010240 Gewiese digital-finance.de -->
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]144</div>
145<div class="sponsor">
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]146 <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]147</div>
148<div class="sponsor">
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]149 <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
150</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]151</div>
152</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]153
154
155</div>
156
157<div class="main">
158
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]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
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]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;
cristycdbe2742010-02-07 19:30:44 +0000[diff] [blame]447 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]448 </span>
449 <span id="linkbar-east">&nbsp;</span>
450 </div>
451 <div class="footer">
cristy16af1cb2009-12-11 21:38:29 +0000[diff] [blame]452 <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]453 <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
454 </div>
455 <div style="clear: both; margin: 0; width: 100%; "></div>
456</body>
457</html>