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