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

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"\r
   2     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
   3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">\r
   4 <head>\r
   5   <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />\r
   6   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />\r
   7   <style type="text/css" media="screen,projection"><!--\r
   8     @import url("../www/magick.css");\r
   9   --></style>\r
  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>\r
  27 \r
  28 <body id="www-imagemagick-org">\r
  29 <div class="titlebar">\r
  30 <a href="../index.html">\r
  31   <img src="../images/script.png" alt="[ImageMagick]"\r
  32   style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>\r
  33 <a href="http://www.networkredux.com">\r
  34   <img src="../images/networkredux.png" alt="[sponsor]"\r
  35   style="margin: 45px auto; border: 0px; float: left;" /></a>\r
  36 <a href="http://www.imagemagick.org/discourse-server/">\r
  37   <img src="../images/logo.jpg" alt=""\r
  38   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  39 <a href="../index.html">\r
  40   <img src="../images/sprite.jpg" alt=""\r
  41   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  42 </div>\r
  43 \r
  44 <div class="eastbar">\r
  45 \r
  46 <div class="menu">
  47   <a href="../index.html">About ImageMagick</a>
  48 </div>
  49 <div class="sep"></div>\r
  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>\r
  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>\r
 106 <div class="menu">
 107   <a href="../www/download.html">Download</a>
 108 </div>
 109 <div class="sep"></div>\r
 110 <div class="menu">
 111   <a href="http://www.imagemagick.org/script/search.php">Search</a>
 112 </div>
 113 <div class="sep"></div>\r
 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>\r
 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.abi-stoff.de/abizeitung/" title="Abibuch">Abizeitung</a><!-- 20090501000200 -->
 127 </div>
 128 <div  class="sponsor">
 129   <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201003010120 Buchhorn -->
 130 </div>
 131 <div  class="sponsor">
 132   <a href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
 133 </div>
 134 <div  class="sponsor">
 135    <a href="http://www.goyax.de">Börse</a><!-- 201001000240 Gewiese digital-finance.de -->
 136 </div>
 137 <div  class="sponsor">
 138    <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012001200 allesdruck.de-->
 139 </div>
 140 <div  class="sponsor">
 141   <a href="http://www.blumenversender.com">Blumenversand</a><!-- 200911010120 -->
 142 </div>
 143 <div  class="sponsor">
 144   <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
 145 </div>
 146 </div>
 147 </div>
 148 \r
 149 \r
 150 </div>\r
 151 \r
 152 <div class="main">\r
 153 \r
 154 \r
 155 \r
 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/>
 224     Version: ImageMagick 6.5.6-7 2009-10-01 Q16 http://www.imagemagick.org</span></p>
 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",
 253 transparent, 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>
 410 \r
 411 </div>\r
 412 \r
 413 <div id="linkbar">\r
 414  <!--    <span id="linkbar-west">&nbsp;</span>  -->\r
 415     <span id="linkbar-center">\r
 416       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 417       <a href="../www/mailing-list.html">Mailing Lists</a> &bull;\r
 418     <a href="http://studio.webbyland.com/ImageMagick/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 419     </span>\r
 420     <span id="linkbar-east">&nbsp;</span>\r
 421   </div>\r
 422   <div class="footer">\r
 423     <span id="footer-west">&copy; 1999-2009 ImageMagick Studio LLC</span>\r
 424     <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 425   </div>\r
 426   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 427 </body>\r
 428 </html>\r