\title{Identify}
\toctitle{Identify}
\titlerunning{Identify}
\maketitle\label{Identify}

\section{NAME}
identify - describe an image or image sequence.

\section{Synopsis}

{\bf identify} {\it file\/} [ {\it file\/} ... ]


\section{Description}

{\bf Identify} 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 {\bf identify} follows:
\begin{verbatim}
    images/aquarium.miff 640x480 PseudoClass 256c
           308135b MIFF 1s
\end{verbatim}

If {\tt -verbose} is set, expect additional output including any image
comment:

\begin{verbatim}
    Image: images/aquarium.miff
    class: PseudoClass
    colors: 256
    signature: eb5dca81dd93ae7e6ffae99a527eb5dca8...
    matte: False
    geometry: 640x480
       depth: 8
    bytes: 308135
    format: MIFF
    comments:
    Imported from MTV raster image: aquarium.mtv
\end{verbatim}

For some formats, additional format-specific information about the file
will be written if the {\tt -debug coder} or {\tt -debug all} option
is used.


\section{Options}

Options are processed in command line order. Any option you specify on
the command line remains in effect for the set of images immediately
following, until the set is terminated by the appearance of any option
or {\bf -noop}.

For a more detailed description of each option, see
{\it ImageMagick(1)\/}.


\subsubsection{-authenticate $<$string$>$}
decrypt image with this password
\subsubsection{-cache $<$threshold$>$}
megabytes of memory available to the pixel cache
\subsubsection{-debug $<$events$>$}
enable debug printout
\subsubsection{-density $<$width$>$x$<$height$>$}
vertical and horizontal resolution in pixels of the image
\subsubsection{-depth $<$value$>$}
depth of the image
\subsubsection{-format $<$string$>$}
output formatted image characteristics
\subsubsection{-help}
print usage instructions
\subsubsection{-interlace $<$type$>$}
the type of interlacing scheme
\subsubsection{-limit $<$type$>$ $<$value$>$}
Disk, Map, or Memory resource limit
\subsubsection{-log $<$string$>$}
\subsubsection{-ping}
efficiently determine image characteristics
\subsubsection{-sampling-factor $<$horizontal\_factor$>$x$<$vertical\_factor$>$}
sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encoder.
\subsubsection{-size $<$width$>$x$<$height$>$\{+offset\}}
width and height of the image
\subsubsection{-verbose}
print detailed information about the image
\subsubsection{-version}
print ImageMagick version string

For a more detailed description of each option, see
{\it ImageMagick(1)\/}.




\section{Authors}

{\it 
John Cristy, ImageMagick Studio LLC,\newline{}
Glenn Randers-Pehrson, ImageMagick Studio LLC.
\/}



