Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 3ed852eea50f9d4cd633efb8c2b054b8e33c2530 / . / www / identify.html
blob: 89be80b0d15a77dd78e7b5309637c2119afebb81 [file] [log] [blame]
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame^]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4<head>
5 <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
6 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
7 <style type="text/css" media="screen,projection"><!--
8 @import url("../www/magick.css");
9 --></style>
10 <link rel="shortcut icon" href="../images/wand.ico" type="images/vnd.microsoft.icon"/>
11 <title>ImageMagick: Command-line Tools: Identify</title>
12 <meta http-equiv="Content-Language" content="en-US"/>
13 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
14 <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
15 <meta name="Generator" content="PHP"/>
16 <meta name="Keywords" content="command-line, tools:, identify, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
17 <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."/>
18 <meta name="Rating" content="GENERAL"/>
19 <meta name="Robots" content="INDEX, FOLLOW"/>
20 <meta name="Generator" content="ImageMagick Studio LLC"/>
21 <meta name="Author" content="ImageMagick Studio LLC"/>
22 <meta name="Revisit-after" content="2 DAYS"/>
23 <meta name="Resource-type" content="document"/>
24 <meta name="Copyright" content="Copyright (c) 1999-2009 ImageMagick Studio LLC"/>
25 <meta name="Distribution" content="Global"/>
26</head>
27
28<body id="www-imagemagick-org">
29<div class="titlebar">
30<a href="../index.html">
31 <img src="../images/script.png" alt="[ImageMagick]"
32 style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
33<a href="http://www.networkredux.com">
34 <img src="../images/networkredux.png" alt="[sponsor]"
35 style="margin: 45px auto; border: 0px; float: left;" /></a>
36<a href="http://www.imagemagick.org/discourse-server/">
37 <img src="../images/logo.jpg" alt=""
38 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
39<a href="../index.html">
40 <img src="../images/sprite.jpg" alt=""
41 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
42</div>
43
44<div class="eastbar">
45
46<div class="menu">
47 <a href="../index.html">About ImageMagick</a>
48</div>
49<div class="sep"></div>
50<div class="menu">
51 <a href="../www/command-line-tools.html">Command-line Tools</a>
52</div>
53<div class="sub">
54 <a href="../www/command-line-processing.html">Processing</a>
55</div>
56<div class="sub">
57 <a href="../www/command-line-options.html">Options</a>
58</div>
59<div class="sub">
60 <a href="http://www.imagemagick.org/Usage/">Usage</a>
61</div>
62<div class="menu">
63 <a href="../www/api.html">Program Interfaces</a>
64</div>
65<div class="sub">
66 <a href="../www/magick-wand.html">MagickWand</a>
67</div>
68<div class="sub">
69 <a href="../www/magick-core.html">MagickCore</a>
70</div>
71<div class="sub">
72 <a href="../www/perl-magick.html">PerlMagick</a>
73</div>
74<div class="sub">
75 <a href="../Magick++/">Magick++</a>
76</div>
77<div class="menu">
78 <a href="../www/architecture.html">Architecture</a>
79</div>
80<div class="sep"></div>
81<div class="menu">
82 <a href="../www/install-source.html">Install from Source</a>
83</div>
84<div class="sub">
85 <a href="../www/install-source.html#unix">Unix</a>
86</div>
87<div class="sub">
88 <a href="../www/install-source.html#windows">Windows</a>
89 </div>
90<div class="menu">
91 <a href="../www/binary-releases.html">Binary Releases</a>
92</div>
93<div class="sub">
94 <a href="../www/binary-releases.html#unix">Unix</a>
95</div>
96<div class="sub">
97 <a href="../www/binary-releases.html#macosx">Mac OS X</a>
98</div>
99<div class="sub">
100 <a href="../www/binary-releases.html#windows">Windows</a>
101</div>
102<div class="menu">
103 <a href="../www/resources.html">Resources</a>
104</div>
105<div class="sep"></div>
106<div class="menu">
107 <a href="../www/download.html">Download</a>
108</div>
109<div class="sep"></div>
110<div class="menu">
111 <a href="http://www.imagemagick.org/script/search.php">Search</a>
112</div>
113<div class="sep"></div>
114<div class="menu">
115 <a href="../www/sitemap.html">Site Map</a>
116</div>
117<div class="sub">
118 <a href="../www/links.html">Links</a>
119</div>
120<div class="sep"></div>
121<div class="menu">
122 <a href="../www/sponsors.html">Sponsors:</a>
123
124<div class="sponsbox">
125<div class="sponsor">
126 <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012001200 allesdruck.de-->
127</div>
128<div class="sponsor">
129 <a href="http://www.blumenversender.com">Blumenversand</a><!-- 200911010120 -->
130</div>
131<div class="sponsor">
132 <a href="http://www.print24.de/">Druckerei</a><!-- 200911010480 -->
133</div>
134<div class="sponsor">
135 <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
136</div>
137<div class="sponsor">
138 <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201001010120 Buchhorn -->
139</div>
140</div>
141</div>
142
143
144</div>
145
146<div class="main">
147
148
149
150<p class="navigation-index">[<a href="#usage">Example Usage</a> &bull; <a href="#options">Option Summary</a>]</p>
151
152<div class="doc-section">
153<p>The <kbd>identify</kbd> program describes the format and characteristics of one or more image files. It also reports if an image is incomplete or corrupt. The information returned includes the image number, the file name, the width and height of the image, whether the image is colormapped or not, the number of colors in the image, the number of bytes in the image, the format of the image (JPEG, PNM, etc.), and finally the number of seconds it took to read and process the image. Many more attributes are available with the verbose option. See <a href="../www/command-line-processing.html">Command Line Processing</a> for advice on how to structure your <kbd>identify</kbd> command or see below for example usages of the command.</p>
154</div>
155
156<h2><a name="usage"></a>Example Usage</h2>
157<div class="doc-section">
158
159<p>We list a few examples of the <kbd>identify</kbd> command here to illustrate its usefulness and ease of use. To get started, lets identify an image in the JPEG format:</p>
160
161<p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>identify rose.jpg</span><span class='crtout'> rose.jpg JPEG 640x480 DirectClass 87kb 0.050u 0:01</span></p>
162<p>Next, we look at the same image in greater detail:</p>
163
164<p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>identify -verbose rose.jpg</span><span class='crtout'>Image: rose.jpg <br/>
165 Format: JPEG (Joint Photographic Experts Group JFIF format) <br/>
166 Class: DirectClass <br/>
167 Geometry: 70x46+0+0 <br/>
168 Resolution: 72x72 <br/>
169 Print size: 0.972222x0.638889 <br/>
170 Units: PixelsPerInch <br/>
171 Type: TrueColor <br/>
172 Endianess: Undefined <br/>
173 Colorspace: RGB <br/>
174 Depth: 8-bit <br/>
175 Channel depth: <br/>
176 red: 8-bit <br/>
177 green: 8-bit <br/>
178 blue: 8-bit <br/>
179 Channel statistics: <br/>
180 red: <br/>
181 min: 37 (0.145098) <br/>
182 max: 255 (1) <br/>
183 mean: 145.58 (0.5709) <br/>
184 standard deviation: 67.3195 (0.263998) <br/>
185 green: <br/>
186 min: 31 (0.121569) <br/>
187 max: 255 (1) <br/>
188 mean: 89.2512 (0.350005) <br/>
189 standard deviation: 52.0488 (0.204113) <br/>
190 blue: <br/>
191 min: 17 (0.0666667) <br/>
192 max: 255 (1) <br/>
193 mean: 80.4075 (0.315323) <br/>
194 standard deviation: 54.0052 (0.211785) <br/>
195 Rendering intent: Undefined <br/>
196 Interlace: None <br/>
197 Background color: white <br/>
198 Border color: rgb(223,223,223) <br/>
199 Matte color: grey74 <br/>
200 Transparent color: black <br/>
201 Page geometry: 70x46+0+0 <br/>
202 Dispose: Undefined <br/>
203 Iterations: 0 <br/>
204 Compression: JPEG <br/>
205 Quality: 100 <br/>
206 Orientation: Undefined <br/>
207 Properties: <br/>
208 date:create: 2008-01-08T11:08:52-05:00 <br/>
209 date:modify: 2005-04-07T12:48:13-04:00 <br/>
210 jpeg:colorspace: 2 <br/>
211 jpeg:sampling-factor: 2x2,1x1,1x1 <br/>
212 signature: dcd00d6303f80f4fa53f991804cb026151c1e851b7a96255e82da87299583ebc <br/>
213 Artifacts: <br/>
214 verbose: true <br/>
215 Tainted: False <br/>
216 Filesize: 3.97266kb <br/>
217 Number pixels: 3.14453kb <br/>
218 Version: ImageMagick 6.5.5-6 2009-09-01 Q16 http://www.imagemagick.org</span></p>
219<p>To get the print size in inches of an image at 72 DPI, use:</p>
220
221<p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>identify -format "%[fx:w/72] by %[fx:h/72] inches" document.png</span><span class='crtout'>8.5 x 11 inches</span></p>
222<p>The depth and dimensions of a raw image must be specified on the command line:</p>
223
224<p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>identify -depth 8 -size 640x480 image.raw</span><span class='crtout'>image.raw RGB 640x480 DirectClass 9kb 0.000u 0:01</span></p>
225<p>Here we display the number of unique colors in the image:</p>
226
227<p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>identify -define unique=true -verbose image.png</span></p>
228<p>You can find additional examples of using <kbd>identify</kbd> in <a href="http://www.imagemagick.org/Usage/">Examples of ImageMagick Usage</a>.</p>
229
230</div>
231
232<h2><a name="options"></a>Option Summary</h2>
233<div class="doc-section">
234
235<p>The <kbd>identify</kbd> command recognizes these options. Click on an option to get more details about how that option works.</p>
236
237<table class="doc">
238 <tbody>
239 <tr>
240 <th align="left">Option</th>
241 <th align="left">Description</th>
242 </tr>
243
244 <tr>
245 <td valign="top"><a href="../www/command-line-options.html#alpha">-alpha</a></td>
246 <td valign="top">on, activate, off, deactivate, set, opaque, copy",
247transparent, extract, background, or shape the alpha channel</td>
248 </tr>
249
250 <tr>
251 <td valign="top"><a href="../www/command-line-options.html#antialias">-antialias</a></td>
252 <td valign="top">remove pixel-aliasing</td>
253 </tr>
254
255 <tr>
256 <td valign="top"><a href="../www/command-line-options.html#authenticate">-authenticate <em class="option">value</em></a></td>
257 <td valign="top">decrypt image with this password</td>
258 </tr>
259
260 <tr>
261 <td valign="top"><a href="../www/command-line-options.html#channel">-channel <em class="option">type</em></a></td>
262 <td valign="top">apply option to select image channels</td>
263 </tr>
264
265 <tr>
266 <td valign="top"><a href="../www/command-line-options.html#colorspace">-colorspace <em class="option">type</em></a></td>
267 <td valign="top">set image colorspace</td>
268 </tr>
269
270 <tr>
271 <td valign="top"><a href="../www/command-line-options.html#crop">-crop <em class="option">geometry</em></a></td>
272 <td valign="top">crop the image</td>
273 </tr>
274
275 <tr>
276 <td valign="top"><a href="../www/command-line-options.html#debug">-debug <em class="option">events</em></a></td>
277 <td valign="top">display copious debugging information</td>
278 </tr>
279
280 <tr>
281 <td valign="top"><a href="../www/command-line-options.html#define">-define <em class="option">format:option</em></a></td>
282 <td valign="top">define one or more image format options</td>
283 </tr>
284
285 <tr>
286 <td valign="top"><a href="../www/command-line-options.html#density">-density <em class="option">geometry</em></a></td>
287 <td valign="top">horizontal and vertical density of the image</td>
288 </tr>
289
290 <tr>
291 <td valign="top"><a href="../www/command-line-options.html#depth">-depth <em class="option">value</em></a></td>
292 <td valign="top">image depth</td>
293 </tr>
294
295 <tr>
296 <td valign="top"><a href="../www/command-line-options.html#extract">-extract <em class="option">geometry</em></a></td>
297 <td valign="top">extract area from image</td>
298 </tr>
299
300 <tr>
301 <td valign="top"><a href="../www/command-line-options.html#format_identify_">-format <em class="option">string</em></a></td>
302 <td valign="top">output formatted image characteristics</td>
303 </tr>
304
305 <tr>
306 <td valign="top"><a href="../www/command-line-options.html#gamma">-gamma <em class="option">value</em></a></td>
307 <td valign="top">level of gamma correction</td>
308 </tr>
309
310 <tr>
311 <td valign="top"><a href="../www/command-line-options.html#help">-help</a></td>
312 <td valign="top">print program options</td>
313 </tr>
314
315 <tr>
316 <td valign="top"><a href="../www/command-line-options.html#interlace">-interlace <em class="option">type</em></a></td>
317 <td valign="top">type of image interlacing scheme</td>
318 </tr>
319
320 <tr>
321 <td valign="top"><a href="../www/command-line-options.html#interpolate">-interpolate <em class="option">method</em></a></td>
322 <td valign="top">pixel color interpolation method</td>
323 </tr>
324
325 <tr>
326 <td valign="top"><a href="../www/command-line-options.html#limit">-limit <em class="option">type value</em></a></td>
327 <td valign="top">pixel cache resource limit</td>
328 </tr>
329
330 <tr>
331 <td valign="top"><a href="../www/command-line-options.html#list">-list <em class="option">type</em></a></td>
332 <td valign="top">Color, Configure, Delegate, Format, Magic, Module, Resource, or Type</td>
333 </tr>
334
335 <tr>
336 <td valign="top"><a href="../www/command-line-options.html#log">-log <em class="option">format</em></a></td>
337 <td valign="top">format of debugging information</td>
338 </tr>
339
340 <tr>
341 <td valign="top"><a href="../www/command-line-options.html#monitor">-monitor</a></td>
342 <td valign="top">monitor progress</td>
343 </tr>
344
345 <tr>
346 <td valign="top"><a href="../www/command-line-options.html#quiet">-quiet</a></td>
347 <td valign="top">suppress all warning messages</td>
348 </tr>
349
350 <tr>
351 <td valign="top"><a href="../www/command-line-options.html#regard-warnings">-regard-warnings</a></td>
352 <td valign="top">pay attention to warning messages.</td>
353 </tr>
354
355 <tr>
356 <td valign="top"><a href="../www/command-line-options.html#respect-parentheses">-respect-parentheses</a></td>
357 <td valign="top">settings remain in effect until parenthesis boundary.</td>
358 </tr>
359
360 <tr>
361 <td valign="top"><a href="../www/command-line-options.html#sampling-factor">-sampling-factor <em class="option">geometry</em></a></td>
362 <td valign="top">horizontal and vertical sampling factor</td>
363 </tr>
364
365 <tr>
366 <td valign="top"><a href="../www/command-line-options.html#set">-set <em class="option">attribute value</em></a></td>
367 <td valign="top">set an image attribute</td>
368 </tr>
369
370 <tr>
371 <td valign="top"><a href="../www/command-line-options.html#size">-size <em class="option">geometry</em></a></td>
372 <td valign="top">width and height of image</td>
373 </tr>
374
375 <tr>
376 <td valign="top"><a href="../www/command-line-options.html#strip">-strip</a></td>
377 <td valign="top">strip image of all profiles and comments</td>
378 </tr>
379
380 <tr>
381 <td valign="top"><a href="../www/command-line-options.html#units">-units <em class="option">type</em></a></td>
382 <td valign="top">the units of image resolution</td>
383 </tr>
384
385 <tr>
386 <td valign="top"><a href="../www/command-line-options.html#verbose">-verbose</a></td>
387 <td valign="top">print detailed information about the image</td>
388 </tr>
389
390 <tr>
391 <td valign="top"><a href="../www/command-line-options.html#version">-version</a></td>
392 <td valign="top">print version information</td>
393 </tr>
394
395 <tr>
396 <td valign="top"><a href="../www/command-line-options.html#virtual-pixel">-virtual-pixel <em class="option">method</em></a></td>
397 <td valign="top">access method for pixels outside the boundaries of the image</td>
398 </tr>
399
400 </tbody>
401</table>
402
403</div>
404
405</div>
406
407<div id="linkbar">
408 <!-- <span id="linkbar-west">&nbsp;</span> -->
409 <span id="linkbar-center">
410 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
411 <a href="../www/mailing-list.html">Mailing Lists</a> &bull;
412 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
413 </span>
414 <span id="linkbar-east">&nbsp;</span>
415 </div>
416 <div class="footer">
417 <span id="footer-west">&copy; 1999-2009 ImageMagick Studio LLC</span>
418 <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
419 </div>
420 <div style="clear: both; margin: 0; width: 100%; "></div>
421</body>
422</html>