granicus.if.org Git - imagemagick/blob - www/identify.html

   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",
 247 transparent, 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>