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