<HTML VERSION="2.0">
<HEAD>
<TITLE>ImageMagick Image Description Utility</TITLE>
<LINK rev="made" href="mailto:magick@wizards.dupont.com">
<meta name="description" content="ImageMagick, version 4.2.2, is a package for
  display and interactive manipulation of images for the X Window System. It
  is written in C and interfaces to the X library, and therefore does not
  require any proprietary toolkit in order to compile.  Although the software
  is copyrighted, it is available for free and can be redistributed without
  fee.">
<meta name="keywords" content="ImageMagick, Image Magick, Image Magic,
  PerlMagick, Perl Magick, Perl Magic, CineMagick, PixelMagick, Pixel Magic,
  WebMagick, Web Magic, visualization, image processing, software development,
  simulation, image, software, AniMagick, Animagic, X11">
</HEAD>
<body background="../images/background.gif">
<A NAME="top"></A>
<CENTER>
<img src="../images/identify.gif" align=bottom width=219 height=55>
</CENTER>
<pre>
 
</pre>
<H2>
<A NAME="Contents">Contents</A>
</H2>
<UL> 
<LI><A HREF="#syno">Synopsis</A>
<LI><A HREF="#desc">Description</A>
<LI><A HREF="#opti">Options</A>
<LI><A HREF="#copy">Copyright</A>
<LI><A HREF="#auth">Authors</A>
</UL>
<DL>
<H2>
<A NAME="syno">
<DT>Synopsis
</A>
</H2>
<DD><B>identify</B> <EM>file</EM> [ <EM>file</EM> ... ]
</DL>
<P>   
<A HREF="#top"><I>Back to Contents</I></A>
<HR>
<DL>
<H2> 
<A NAME="desc">
<DT>Description
</A>
</H2>
<DD><B>identify</B> describes the format and characteristics of one or
more image files.  It will also report if an image is
incomplete or corrupt.  The information displayed includes
the scene 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.  An
example line output from <B>identify</B> follows:
<p>
<PRE>
    images/aquarium.miff 640x480 PseudoClass 256c 308135b MIFF 1s
</PRE>
<p>
If <B>-verbose</B> is set, expect additional output including any image
comment:
<p>
<PRE>
    Image: images/aquarium.miff
      class: PseudoClass
      colors: 256
      signature: eb5dca81dd93ae7e6ffae99a5275a53e
      matte: False
      geometry: 640x480
      depth: 8
      bytes: 308135
      format: MIFF
      comments:
 
        Imported from MTV raster image:  aquarium.mtv
</PRE>
</DL>
<P>
<A HREF="#top"><I>Back to Contents</I></A>
<HR>
<DL>
<H2>
<A NAME="opti">
<DT>Options
</A>
</H2>
<DL>
<P>
<DT><B>-ping</B>
<DD> efficiently determine image characteristics.
<p>
<DD> This is a more efficient and less memory intensive way to query if an image
exists and what its size is.  Note, only the size of the first image in
a multi-frame image file is returned.
<P>
<DT><B>-size</B> &lt;width&gt;{%}x&lt;height>{%}{+offset}{!}
<DD>width and height of the image.
<P>
<DD>Use this option to specify the width and height of
raw images whose dimensions are unknown such as <B>GRAY</B>,
<B>RGB</B>, or <B>CMYK</B>.  In addition to width and height, use
<B>-size</B> to skip any header information in the image or tell
the number of colors in a <B>MAP</B> image file, (e.g. -size 640x512+256). 
<P>
<DD>For Photo CD images, choose from these sizes:
<PRE>
   192x128
   384x256
   768x512
   1536x1024
   3072x2048
</PRE>
<DD>Finally, use this option to choose a particular resolution layer of a JBIG
or JPEG image (e.g. -size 1024x768).
<p>
<DT><B>-verbose</B>
<DD>print detailed information about the image.
<P>
<DD>This information is printed:  image name;  the image class
(<I>DirectClass</I> or <I>PseudoClass</I>);  the total number of unique
colors; whether there is a matte associated with the image; the number
of runlength packets; the image size; the depth of the image; the image
format; the image scene; and finally any image comment.  Refer to
<A HREF="miff.html">miff</A> for a description of the image class.
<P>
</DL>
<P>
<A HREF="#top"><I>Back to Contents</I></A>
<HR>
</DL>
<DL>
<H2>
<A NAME="copy">
<DT>Copyright
</A>
</H2>
<B>
<dd>Copyright 1999 E. I. du Pont de Nemours and Company
<p>
<dd>Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files ("ImageMagick"),
to deal in ImageMagick without restriction, including without limitation 
the rights to use, copy, modify, merge, publish, distribute, sublicense, 
and/or sell copies of ImageMagick, and to permit persons to whom the 
ImageMagick is furnished to do so, subject to the following conditions:
<p>
<dd>The above copyright notice and this permission notice shall be included in 
all copies or substantial portions of ImageMagick. 
<p>
<dd>The software is provided "as is", without warranty of any kind, express or 
implied, including but not limited to the warranties of merchantability, 
fitness for a particular purpose and noninfringement.In no event shall 
E. I. du Pont de Nemours and Company be liable for any claim, damages or 
other liability, whether in an action of contract, tort or otherwise,
arising from, out of or in connection with ImageMagick or the use or other 
dealings in ImageMagick. 
<p>
<dd>Except as contained in this notice, the name of the E. I. du Pont de 
Nemours and Company shall not be used in advertising or otherwise to 
promote the sale, use or other dealings in ImageMagick without prior 
written authorization from the E. I. du Pont de Nemours and Company. 
</B>
</DL>
<P>
<A HREF="#top"><I>Back to Contents</I></A>
<HR>
<DL>
<H2>
<A NAME="auth">
<DT>Authors
</A>
</H2>
<DD><I>John Cristy</I>, <A HREF="mailto:magick@wizards.dupont.com">
 <I>magick@wizards.dupont.com</I></A> <B>E.I. du Pont de Nemours and Company
Incorporated</B>.
</DL>
<A HREF="#top"><I>Back to Contents</I></A>
<p><hr><p>
<a href="../ImageMagick.html"><img alt="Home Page"
  src="../images/home.gif" width=40 height=40 align=middle border=0></a>
<font size="-2">Image manipulation software that works like magic.</font>
</body>
</html>
