Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 18f8ee4f880cde0219ebdef3f2afd83043a7907e / . / www / identify.html
blob: b9d38b3b947d5f8b68a56d44263607c55794d3a4 [file] [log] [blame]
cristyf3bb4782009-09-08 13:10:04 +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>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]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"/>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]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
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]46<div class="menu">
47 <a href="../index.html">About ImageMagick</a>
48</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]49<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]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>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]80<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]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>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]105<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]106<div class="menu">
107 <a href="../www/download.html">Download</a>
108</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]109<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]110<div class="menu">
111 <a href="http://www.imagemagick.org/script/search.php">Search</a>
112</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]113<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]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>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]120<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]121<div class="menu">
122 <a href="../www/sponsors.html">Sponsors:</a>
123
124<div class="sponsbox">
125<div class="sponsor">
cristyb4c03bb2009-09-27 13:55:46 +0000[diff] [blame]126 <a href="http://www.hygi.de">Reinigungsmittel</a><!-- 201002000400+ -->
127</div>
128<div class="sponsor">
129 <a href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
130</div>
131<div class="sponsor">
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]132 <a href="http://www.goyax.de">Börse</a><!-- 201001000240 Gewiese digital-finance.de -->
133</div>
134<div class="sponsor">
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]135 <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012001200 allesdruck.de-->
136</div>
137<div class="sponsor">
138 <a href="http://www.blumenversender.com">Blumenversand</a><!-- 200911010120 -->
139</div>
140<div class="sponsor">
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]141 <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
142</div>
143<div class="sponsor">
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]144 <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201002010120 Buchhorn -->
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]145</div>
146</div>
147</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]148
149
150</div>
151
152<div class="main">
153
154
155
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]156<p class="navigation-index">[<a href="#usage">Example Usage</a> &bull; <a href="#options">Option Summary</a>]</p>
157
158<div class="doc-section">
159<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>
160</div>
161
162<h2><a name="usage"></a>Example Usage</h2>
163<div class="doc-section">
164
165<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>
166
167<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>
168<p>Next, we look at the same image in greater detail:</p>
169
170<p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>identify -verbose rose.jpg</span><span class='crtout'>Image: rose.jpg <br/>
171 Format: JPEG (Joint Photographic Experts Group JFIF format) <br/>
172 Class: DirectClass <br/>
173 Geometry: 70x46+0+0 <br/>
174 Resolution: 72x72 <br/>
175 Print size: 0.972222x0.638889 <br/>
176 Units: PixelsPerInch <br/>
177 Type: TrueColor <br/>
178 Endianess: Undefined <br/>
179 Colorspace: RGB <br/>
180 Depth: 8-bit <br/>
181 Channel depth: <br/>
182 red: 8-bit <br/>
183 green: 8-bit <br/>
184 blue: 8-bit <br/>
185 Channel statistics: <br/>
186 red: <br/>
187 min: 37 (0.145098) <br/>
188 max: 255 (1) <br/>
189 mean: 145.58 (0.5709) <br/>
190 standard deviation: 67.3195 (0.263998) <br/>
191 green: <br/>
192 min: 31 (0.121569) <br/>
193 max: 255 (1) <br/>
194 mean: 89.2512 (0.350005) <br/>
195 standard deviation: 52.0488 (0.204113) <br/>
196 blue: <br/>
197 min: 17 (0.0666667) <br/>
198 max: 255 (1) <br/>
199 mean: 80.4075 (0.315323) <br/>
200 standard deviation: 54.0052 (0.211785) <br/>
201 Rendering intent: Undefined <br/>
202 Interlace: None <br/>
203 Background color: white <br/>
204 Border color: rgb(223,223,223) <br/>
205 Matte color: grey74 <br/>
206 Transparent color: black <br/>
207 Page geometry: 70x46+0+0 <br/>
208 Dispose: Undefined <br/>
209 Iterations: 0 <br/>
210 Compression: JPEG <br/>
211 Quality: 100 <br/>
212 Orientation: Undefined <br/>
213 Properties: <br/>
214 date:create: 2008-01-08T11:08:52-05:00 <br/>
215 date:modify: 2005-04-07T12:48:13-04:00 <br/>
216 jpeg:colorspace: 2 <br/>
217 jpeg:sampling-factor: 2x2,1x1,1x1 <br/>
218 signature: dcd00d6303f80f4fa53f991804cb026151c1e851b7a96255e82da87299583ebc <br/>
219 Artifacts: <br/>
220 verbose: true <br/>
221 Tainted: False <br/>
222 Filesize: 3.97266kb <br/>
223 Number pixels: 3.14453kb <br/>
cristyb4c03bb2009-09-27 13:55:46 +0000[diff] [blame]224 Version: ImageMagick 6.5.6-5 2009-09-55 Q16 http://www.imagemagick.org</span></p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]225<p>To get the print size in inches of an image at 72 DPI, use:</p>
226
227<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>
228<p>The depth and dimensions of a raw image must be specified on the command line:</p>
229
230<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>
231<p>Here we display the number of unique colors in the image:</p>
232
233<p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>identify -define unique=true -verbose image.png</span></p>
234<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>
235
236</div>
237
238<h2><a name="options"></a>Option Summary</h2>
239<div class="doc-section">
240
241<p>The <kbd>identify</kbd> command recognizes these options. Click on an option to get more details about how that option works.</p>
242
243<table class="doc">
244 <tbody>
245 <tr>
246 <th align="left">Option</th>
247 <th align="left">Description</th>
248 </tr>
249
250 <tr>
251 <td valign="top"><a href="../www/command-line-options.html#alpha">-alpha</a></td>
252 <td valign="top">on, activate, off, deactivate, set, opaque, copy",
253transparent, extract, background, or shape the alpha channel</td>
254 </tr>
255
256 <tr>
257 <td valign="top"><a href="../www/command-line-options.html#antialias">-antialias</a></td>
258 <td valign="top">remove pixel-aliasing</td>
259 </tr>
260
261 <tr>
262 <td valign="top"><a href="../www/command-line-options.html#authenticate">-authenticate <em class="option">value</em></a></td>
263 <td valign="top">decrypt image with this password</td>
264 </tr>
265
266 <tr>
267 <td valign="top"><a href="../www/command-line-options.html#channel">-channel <em class="option">type</em></a></td>
268 <td valign="top">apply option to select image channels</td>
269 </tr>
270
271 <tr>
272 <td valign="top"><a href="../www/command-line-options.html#colorspace">-colorspace <em class="option">type</em></a></td>
273 <td valign="top">set image colorspace</td>
274 </tr>
275
276 <tr>
277 <td valign="top"><a href="../www/command-line-options.html#crop">-crop <em class="option">geometry</em></a></td>
278 <td valign="top">crop the image</td>
279 </tr>
280
281 <tr>
282 <td valign="top"><a href="../www/command-line-options.html#debug">-debug <em class="option">events</em></a></td>
283 <td valign="top">display copious debugging information</td>
284 </tr>
285
286 <tr>
287 <td valign="top"><a href="../www/command-line-options.html#define">-define <em class="option">format:option</em></a></td>
288 <td valign="top">define one or more image format options</td>
289 </tr>
290
291 <tr>
292 <td valign="top"><a href="../www/command-line-options.html#density">-density <em class="option">geometry</em></a></td>
293 <td valign="top">horizontal and vertical density of the image</td>
294 </tr>
295
296 <tr>
297 <td valign="top"><a href="../www/command-line-options.html#depth">-depth <em class="option">value</em></a></td>
298 <td valign="top">image depth</td>
299 </tr>
300
301 <tr>
302 <td valign="top"><a href="../www/command-line-options.html#extract">-extract <em class="option">geometry</em></a></td>
303 <td valign="top">extract area from image</td>
304 </tr>
305
306 <tr>
307 <td valign="top"><a href="../www/command-line-options.html#format_identify_">-format <em class="option">string</em></a></td>
308 <td valign="top">output formatted image characteristics</td>
309 </tr>
310
311 <tr>
312 <td valign="top"><a href="../www/command-line-options.html#gamma">-gamma <em class="option">value</em></a></td>
313 <td valign="top">level of gamma correction</td>
314 </tr>
315
316 <tr>
317 <td valign="top"><a href="../www/command-line-options.html#help">-help</a></td>
318 <td valign="top">print program options</td>
319 </tr>
320
321 <tr>
322 <td valign="top"><a href="../www/command-line-options.html#interlace">-interlace <em class="option">type</em></a></td>
323 <td valign="top">type of image interlacing scheme</td>
324 </tr>
325
326 <tr>
327 <td valign="top"><a href="../www/command-line-options.html#interpolate">-interpolate <em class="option">method</em></a></td>
328 <td valign="top">pixel color interpolation method</td>
329 </tr>
330
331 <tr>
332 <td valign="top"><a href="../www/command-line-options.html#limit">-limit <em class="option">type value</em></a></td>
333 <td valign="top">pixel cache resource limit</td>
334 </tr>
335
336 <tr>
337 <td valign="top"><a href="../www/command-line-options.html#list">-list <em class="option">type</em></a></td>
338 <td valign="top">Color, Configure, Delegate, Format, Magic, Module, Resource, or Type</td>
339 </tr>
340
341 <tr>
342 <td valign="top"><a href="../www/command-line-options.html#log">-log <em class="option">format</em></a></td>
343 <td valign="top">format of debugging information</td>
344 </tr>
345
346 <tr>
347 <td valign="top"><a href="../www/command-line-options.html#monitor">-monitor</a></td>
348 <td valign="top">monitor progress</td>
349 </tr>
350
351 <tr>
352 <td valign="top"><a href="../www/command-line-options.html#quiet">-quiet</a></td>
353 <td valign="top">suppress all warning messages</td>
354 </tr>
355
356 <tr>
357 <td valign="top"><a href="../www/command-line-options.html#regard-warnings">-regard-warnings</a></td>
358 <td valign="top">pay attention to warning messages.</td>
359 </tr>
360
361 <tr>
362 <td valign="top"><a href="../www/command-line-options.html#respect-parentheses">-respect-parentheses</a></td>
363 <td valign="top">settings remain in effect until parenthesis boundary.</td>
364 </tr>
365
366 <tr>
367 <td valign="top"><a href="../www/command-line-options.html#sampling-factor">-sampling-factor <em class="option">geometry</em></a></td>
368 <td valign="top">horizontal and vertical sampling factor</td>
369 </tr>
370
371 <tr>
372 <td valign="top"><a href="../www/command-line-options.html#set">-set <em class="option">attribute value</em></a></td>
373 <td valign="top">set an image attribute</td>
374 </tr>
375
376 <tr>
377 <td valign="top"><a href="../www/command-line-options.html#size">-size <em class="option">geometry</em></a></td>
378 <td valign="top">width and height of image</td>
379 </tr>
380
381 <tr>
382 <td valign="top"><a href="../www/command-line-options.html#strip">-strip</a></td>
383 <td valign="top">strip image of all profiles and comments</td>
384 </tr>
385
386 <tr>
387 <td valign="top"><a href="../www/command-line-options.html#units">-units <em class="option">type</em></a></td>
388 <td valign="top">the units of image resolution</td>
389 </tr>
390
391 <tr>
392 <td valign="top"><a href="../www/command-line-options.html#verbose">-verbose</a></td>
393 <td valign="top">print detailed information about the image</td>
394 </tr>
395
396 <tr>
397 <td valign="top"><a href="../www/command-line-options.html#version">-version</a></td>
398 <td valign="top">print version information</td>
399 </tr>
400
401 <tr>
402 <td valign="top"><a href="../www/command-line-options.html#virtual-pixel">-virtual-pixel <em class="option">method</em></a></td>
403 <td valign="top">access method for pixels outside the boundaries of the image</td>
404 </tr>
405
406 </tbody>
407</table>
408
409</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]410
411</div>
412
413<div id="linkbar">
414 <!-- <span id="linkbar-west">&nbsp;</span> -->
415 <span id="linkbar-center">
416 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
417 <a href="../www/mailing-list.html">Mailing Lists</a> &bull;
cristyec678732009-09-22 11:31:10 +0000[diff] [blame]418 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]419 </span>
420 <span id="linkbar-east">&nbsp;</span>
421 </div>
422 <div class="footer">
423 <span id="footer-west">&copy; 1999-2009 ImageMagick Studio LLC</span>
424 <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
425 </div>
426 <div style="clear: both; margin: 0; width: 100%; "></div>
427</body>
428</html>