-
Notifications
You must be signed in to change notification settings - Fork 4
/
identify.html
507 lines (426 loc) · 20.7 KB
/
identify.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="-//W3C//DTD XHTML 1.1//EN" xml:lang="en" xsi:schemaLocation="http://www.w3.org/1999/xhtml http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8"></meta>
<meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4"></meta>
<title>ImageMagick: Command-line Tools: Identify</title>
<meta http-equiv="content-language" content="en-US"></meta>
<meta http-equiv="content-type" content="text/html; charset=utf-8"></meta>
<meta http-equiv="reply-to" content="[email protected]"></meta>
<meta name="application-name" content="ImageMagick"></meta>
<meta name="description" content="Use ImageMagick to convert, edit, or compose bitmap images in a variety of formats. In addition, resize, rotate, shear, distort or transform images automagically."></meta>
<meta name="application-url" content="http://www.imagemagick.org"></meta>
<meta name="generator" content="PHP"></meta>
<meta name="keywords" content="command-line, tools:, identify, ImageMagick, PerlMagick, image processing, OpenMP, software development library, image, photo, software, Magick++, MagickWand"></meta>
<meta name="rating" content="GENERAL"></meta>
<meta name="robots" content="INDEX, FOLLOW"></meta>
<meta name="generator" content="ImageMagick Studio LLC"></meta>
<meta name="author" content="ImageMagick Studio LLC"></meta>
<meta name="revisit-after" content="2 DAYS"></meta>
<meta name="resource-type" content="document"></meta>
<meta name="copyright" content="Copyright (c) 1999-2012 ImageMagick Studio LLC"></meta>
<meta name="distribution" content="Global"></meta>
<link rel="icon" href="../images/wand.png"></link>
<link rel="shortcut icon" href="../images/wand.ico" type="images/x-icon"></link>
<link rel="canonical" href="../index.html"></link>
<link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"></link>
<!-- Add jQuery library -->
<script type="text/javascript" src="http://localhost/ajax/libs/jquery/1.7/jquery.min.js"></script>
<!-- Add mousewheel plugin (this is optional) -->
<script type="text/javascript" src="http://www.imagemagick.org/fancybox/lib/jquery.mousewheel-3.0.6.pack.js"></script>
<!-- Add fancyBox -->
<link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/jquery.fancybox.css?v=2.0.6" type="text/css" media="screen"></link>
<script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/jquery.fancybox.pack.js?v=2.0.6"></script>
<!-- Optionally add helpers - button, thumbnail and/or media -->
<link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-buttons.css?v=1.0.2" type="text/css" media="screen"></link>
<script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-buttons.js?v=1.0.2"></script>
<script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-media.js?v=1.0.0"></script>
<link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-thumbs.css?v=2.0.6" type="text/css" media="screen"></link>
<script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-thumbs.js?v=2.0.6"></script>
<script type="text/javascript">
$(document).ready(function() {
$(".fancybox").fancybox();
});
</script>
<!-- ImageMagick style -->
<style type="text/css" media="all">
@import url("../www/magick.css");
</style>
</head>
<body id="www-imagemagick-org">
<div class="titlebar">
<div style="margin: 17px auto; float: left;">
<script type="text/javascript">
<!--
google_ad_client = "pub-3129977114552745";
google_ad_slot = "5439289906";
google_ad_width = 728;
google_ad_height = 90;
//-->
</script>
</div>
<a href="../discourse-server">
<img src="../images/logo.jpg" alt="ImageMagick Logo" style="width: 123px; height: 118px; border: 0px; float: right;"></img></a>
<a href="../index.html">
<img src="../images/sprite.jpg" alt="ImageMagick Sprite" style="width: 114px; height: 118px; border: 0px; float: right;"></img></a>
</div>
<div class="westbar">
<div class="menu">
<a title="About ImageMagick" href="../index.html">About ImageMagick</a>
</div>
<div class="menu">
<a title="Binary Releases" href="binary-releases.html">Binary Releases</a>
</div>
<div class="sub">
<a title="Binary Release: Unix" href="binary-releases.html#unix">Unix</a>
</div>
<div class="sub">
<a title="Binary Release: MacOS X" href="binary-releases.html#macosx">Mac OS X</a>
</div>
<div class="sub">
<a title="Binary Release: iOS" href="binary-releases.html#iOS">iOS</a>
</div>
<div class="sub">
<a title="Binary Release: Windows" href="binary-releases.html#windows">Windows</a>
</div>
<div class="sep"></div>
<div class="menu">
<a title="Command-line Tools" href="command-line-tools.html">Command-line Tools</a>
</div>
<div class="sub">
<a title="Command-line Tools: Processing" href="command-line-processing.html">Processing</a>
</div>
<div class="sub">
<a title="Command-line Tools: Options" href="command-line-options.html">Options</a>
</div>
<div class="sub">
<a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
</div>
<div class="menu">
<a title="Program Interfaces" href="api.html">Program Interfaces</a>
</div>
<div class="sub">
<a title="Program Interface: MagickWand" href="magick-wand.html">MagickWand</a>
</div>
<div class="sub">
<a title="Program Interface: MagickCore" href="magick-core.html">MagickCore</a>
</div>
<div class="sub">
<a title="Program Interface: PerlMagick" href="perl-magick.html">PerlMagick</a>
</div>
<div class="sub">
<a title="Program Interface: Magick++" href="magick++.html">Magick++</a>
</div>
<div class="sep"></div>
<div class="menu">
<a title="Install from Source" href="install-source.html">Install from Source</a>
</div>
<div class="sub">
<a title="Install from Source: Unix" href="install-source.html#unix">Unix</a>
</div>
<div class="sub">
<a title="Install from Source: Windows" href="install-source.html#windows">Windows</a>
</div>
<div class="menu">
<a title="Resources" href="resources.html">Resources</a>
</div>
<div class="menu">
<a title="Architecture" href="architecture.html">Architecture</a>
</div>
<div class="menu">
<a title="Download" href="download.html">Download</a>
</div>
<div class="sep"></div>
<div class="menu">
<a title="Search" href="search.html">Search</a>
</div>
<div class="sep"></div>
<div class="menu">
<a title="Site Map" href="sitemap.html">Site Map</a>
</div>
<div class="sub">
<a title="Site Map: Links" href="links.html">Links</a>
</div>
<div class="sep"></div>
<div class="menu">
<a title="Support ImageMagick Development" href="support.html">Support ImageMagick Development</a>
</div>
</div>
<div class="eastbar">
<div> <a class="FlattrButton" style="display:none;" rev="flattr;button:compact;" href="../index.html"></a></div>
<noscript>
<a href="http://flattr.com/thing/947300/Convert-Edit-And-Compose-Images" target="_blank">
<img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr this" title="Flattr this" width="93" height="20" border="0"></img></a>
</noscript>
</div>
<div class="main">
<h1>ImageMagick Identify Command-line Tool</h1>
<p class="navigation-index">[<a href="identify.html#usage">Example Usage</a> • <a href="identify.html#options">Option Summary</a>]</p>
<div class="doc-section">
<p>The <code>identify</code> 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="command-line-processing.html">Command Line Processing</a> for advice on how to structure your <code>identify</code> command or see below for example usages of the command.</p>
</div>
<h2><a id="usage"></a>Example Usage</h2>
<div class="doc-section">
<p>We list a few examples of the <code>identify</code> command here to illustrate its usefulness and ease of use. To get started, lets identify an image in the JPEG format:</p>
<p class="crt"><span class="crtprompt"> $ </span><span class="crtin">identify rose.jpg</span><span class="crtout"> rose.jpg JPEG 640x480 sRGB 87kb 0.050u 0:01</span></p>
<p>Next, we look at the same image in greater detail:</p>
<p class="crt"><span class="crtprompt"> $ </span><span class="crtin">identify -verbose rose.jpg</span><span class="crtout">Image: rose.jpg <br></br>
Format: JPEG (Joint Photographic Experts Group JFIF format) <br></br>
Class: DirectClass <br></br>
Geometry: 70x46+0+0 <br></br>
Resolution: 72x72 <br></br>
Print size: 0.972222x0.638889 <br></br>
Units: PixelsPerInch <br></br>
Type: TrueColor <br></br>
Endianess: Undefined <br></br>
Colorspace: RGB <br></br>
Depth: 8-bit <br></br>
Channel depth: <br></br>
red: 8-bit <br></br>
green: 8-bit <br></br>
blue: 8-bit <br></br>
Channel statistics: <br></br>
red: <br></br>
min: 37 (0.145098) <br></br>
max: 255 (1) <br></br>
mean: 145.58 (0.5709) <br></br>
standard deviation: 67.3195 (0.263998) <br></br>
green: <br></br>
min: 31 (0.121569) <br></br>
max: 255 (1) <br></br>
mean: 89.2512 (0.350005) <br></br>
standard deviation: 52.0488 (0.204113) <br></br>
blue: <br></br>
min: 17 (0.0666667) <br></br>
max: 255 (1) <br></br>
mean: 80.4075 (0.315323) <br></br>
standard deviation: 54.0052 (0.211785) <br></br>
Rendering intent: Undefined <br></br>
Interlace: None <br></br>
Background color: white <br></br>
Border color: rgb(223,223,223) <br></br>
Matte color: grey74 <br></br>
Transparent color: black <br></br>
Page geometry: 70x46+0+0 <br></br>
Dispose: Undefined <br></br>
Iterations: 0 <br></br>
Compression: JPEG <br></br>
Quality: 100 <br></br>
Orientation: Undefined <br></br>
Properties: <br></br>
date:create: 2008-01-08T11:08:52-05:00 <br></br>
date:modify: 2005-04-07T12:48:13-04:00 <br></br>
jpeg:colorspace: 2 <br></br>
jpeg:sampling-factor: 2x2,1x1,1x1 <br></br>
signature: dcd00d6303f80f4fa53f991804cb026151c1e851b7a96255e82da87299583ebc <br></br>
Artifacts: <br></br>
verbose: true <br></br>
Tainted: False <br></br>
Filesize: 3.97266kb <br></br>
Number pixels: 3.14453kb <br></br>
Version: ImageMagick 6.8.7-0 2013-09-25 Q16 http://www.imagemagick.org</span></p>
<p>To get the print size in inches of an image at 72 DPI, use:</p>
<p class="crt"><span class="crtprompt"> $ </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>
<p>The depth and dimensions of a raw image must be specified on the command line:</p>
<p class="crt"><span class="crtprompt"> $ </span><span class="crtin">identify -depth 8 -size 640x480 image.raw</span><span class="crtout">image.raw RGB 640x480 sRGB 9kb 0.000u 0:01</span></p>
<p>Here we display the image texture features and the number of unique colors in the image:</p>
<p class="crt"><span class="crtprompt"> $ </span><span class="crtin">identify -verbose -features 1 -unique image.png</span></p>
<p>Here is a special define that outputs the location of the minimum or maximum pixel of the image:</p>
<p class="crt"><span class="crtprompt"> $ </span><span class="crtin">identify -pecision 5 -define identify:locate=maximum -define identify:limit=3 image.png</span></p>
<p>You can find additional examples of using <code>identify</code> in <a href="http://www.imagemagick.org/Usage/">Examples of ImageMagick Usage</a>.</p>
</div>
<h2><a id="options"></a>Option Summary</h2>
<div class="doc-section">
<p>The <code>identify</code> command recognizes these options. Click on an option to get more details about how that option works.</p>
<table class="doc">
<tbody>
<tr>
<th align="left">Option</th>
<th align="left">Description</th>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#alpha">-alpha</a></td>
<td valign="top">on, activate, off, deactivate, set, opaque, copy",
transparent, extract, background, or shape the alpha channel</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#antialias">-antialias</a></td>
<td valign="top">remove pixel-aliasing</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#authenticate">-authenticate <em class="option">value</em></a></td>
<td valign="top">decrypt image with this password</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#channel">-channel <em class="option">type</em></a></td>
<td valign="top">apply option to select image channels</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#clip">-clip</a></td>
<td valign="top">clip along the first path from the 8BIM profile</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#clip-mask">-clip-mask</a> <em class="option">filename</em></td>
<td valign="top">associate clip mask with the image</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#clip-path">-clip-path <em class="option">id</em></a></td>
<td valign="top">clip along a named path from the 8BIM profile</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#colorspace">-colorspace <em class="option">type</em></a></td>
<td valign="top">set image colorspace</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#crop">-crop <em class="option">geometry</em></a></td>
<td valign="top">crop the image</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#debug">-debug <em class="option">events</em></a></td>
<td valign="top">display copious debugging information</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#define">-define <em class="option">format:option</em></a></td>
<td valign="top">define one or more image format options</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#density">-density <em class="option">geometry</em></a></td>
<td valign="top">horizontal and vertical density of the image</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#depth">-depth <em class="option">value</em></a></td>
<td valign="top">image depth</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#endian">-endian <em class="option">type</em></a></td>
<td valign="top">endianness (MSB or LSB) of the image</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#extract">-extract <em class="option">geometry</em></a></td>
<td valign="top">extract area from image</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#features">-features <em class="option">distance</em></a></td>
<td valign="top">analyze image features (e.g. contract, correlations, etc.).</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#format_identify_">-format <em class="option">string</em></a></td>
<td valign="top">output formatted image characteristics</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#gamma">-gamma <em class="option">value</em></a></td>
<td valign="top">level of gamma correction</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#intensity">-grayscale <em class="option">method</em></a></td>
<td valign="top">convert image to grayscale</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#help">-help</a></td>
<td valign="top">print program options</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#interlace">-interlace <em class="option">type</em></a></td>
<td valign="top">type of image interlacing scheme</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#interpolate">-interpolate <em class="option">method</em></a></td>
<td valign="top">pixel color interpolation method</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#limit">-limit <em class="option">type value</em></a></td>
<td valign="top">pixel cache resource limit</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#list">-list <em class="option">type</em></a></td>
<td valign="top">Color, Configure, Delegate, Format, Magic, Module, Resource, or Type</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#log">-log <em class="option">format</em></a></td>
<td valign="top">format of debugging information</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#mask">-mask <em class="option">filename</em></a></td>
<td valign="top">associate a mask with the image</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#monitor">-monitor</a></td>
<td valign="top">monitor progress</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#negate">-negate</a></td>
<td valign="top">replace each pixel with its complementary color </td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#precision">-precision <em class="option">value</em></a></td>
<td valign="top">set the maximum number of significant digits to be printed</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#quiet">-quiet</a></td>
<td valign="top">suppress all warning messages</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#regard-warnings">-regard-warnings</a></td>
<td valign="top">pay attention to warning messages.</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#respect-parentheses">-respect-parentheses</a></td>
<td valign="top">settings remain in effect until parenthesis boundary.</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#sampling-factor">-sampling-factor <em class="option">geometry</em></a></td>
<td valign="top">horizontal and vertical sampling factor</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#set">-set <em class="option">attribute value</em></a></td>
<td valign="top">set an image attribute</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#size">-size <em class="option">geometry</em></a></td>
<td valign="top">width and height of image</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#strip">-strip</a></td>
<td valign="top">strip image of all profiles and comments</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#unique">-unique</a></td>
<td valign="top">display image the number of unique colors in the image.</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#units">-units <em class="option">type</em></a></td>
<td valign="top">the units of image resolution</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#verbose">-verbose</a></td>
<td valign="top">print detailed information about the image</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#version">-version</a></td>
<td valign="top">print version information</td>
</tr>
<tr>
<td valign="top"><a href="command-line-options.html#virtual-pixel">-virtual-pixel <em class="option">method</em></a></td>
<td valign="top">access method for pixels outside the boundaries of the image</td>
</tr>
</tbody>
</table>
</div>
</div>
<div id="linkbar">
<span id="linkbar-west"> </span>
<span id="linkbar-center">
<a href="../discourse-server">Discourse Server</a> •
<a href="http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> •
<a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a> •
<a href="http://jqmagick.imagemagick.org/">JqMagick</a>
</span>
<span id="linkbar-east"> </span>
</div>
<div class="footer">
<span id="footer-west">© 1999-2014 ImageMagick Studio LLC</span>
<span id="footer-east"> <a href="contact.html">Contact the Wizards</a></span>
</div>
<div style="clear: both; margin: 0; width: 100%; "></div>
</body>
</html>