man pages section 1: User Commands

Exit Print View

Updated: July 2014

identify (1)


identify - describes the format and characteristics of one or more image files.


identify [options] input-file


User Commands                                         identify(1)

     identify  -  describes the format and characteristics of one
     or more image files.

     identify [options] input-file

     The identify program is a member of the ImageMagick(1) suite
     of  tools.   It  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  (by  default  off  use   -define
     unique=true  option),  the number of bytes in the image, the
     format of the image (JPEG, PNM, etc.), and finally the  num-
     ber  of  seconds it took to read and process the image. Many
     more attributes are available with the verbose option.

     For more information about the identify command, point  your
     browser to file:///usr/share/doc/ImageMagick-6.8.3/www/iden-
     tify.html or

     Image Settings:
       -antialias           remove pixel-aliasing
       -authenticate value  decrypt image with this password
       -channel type        apply option to select image channels
       -crop geometry       cut out a rectangular region  of  the
       -define format:option
                            define   one  or  more  image  format
       -define unique=true  return the number of unique colors in
     the image
       -density  geometry     horizontal  and vertical density of
     the image
       -depth value         image depth
       -endian type         endianness (MSB or LSB) of the image
       -extract geometry    extract area from image
       -features distance   analyze  image  features  (e.g.  con-
     trast, correlation)
       -format  "string"      output formatted image characteris-
       -fuzz distance       colors within this distance are  con-
     sidered equal
       -interlace type      type of image interlacing scheme
       -interpolate method  pixel color interpolation method
       -limit type value    pixel cache resource limit
       -list  type            Color, Configure, Delegate, Format,
     Magic, Module,

ImageMagick   Last change: Date: 2009/01/10 01:00:00            1

User Commands                                         identify(1)

                            Resource, or Type
       -matte               store matte channel if the image  has
       -monitor             monitor progress
       -ping                    efficiently    determine    image
       -quiet               suppress all warning messages
       -regard-warnings     pay attention to warning messages
       -sampling-factor geometry
                            horizontal and vertical sampling fac-
       -seed  value          seed a new sequence of pseudo-random
       -set attribute value set an image attribute
       -size geometry       width and height of image
       -strip               strip image of all profiles and  com-
       -unique               display  the number of unique colors
     in the image
       -units type          the units of image resolution
       -verbose             print detailed information about  the
       -virtual-pixel method
                            virtual pixel access method

     Image Operators:
       -negate               replace  each pixel with its comple-
     mentary color

     Miscellaneous Options:
       -debug events        display copious debugging information
       -help                print program options
       -log format          format of debugging information
       -list  type            print  a  list  of supported option
       -version             print version information

     By default, the image format of `file' is determined by  its
     magic number.  To specify a particular image format, precede
     the filename with an image format name  and  a  colon  (i.e.
     ps:image)  or  specify the image type as the filename suffix
     (i.e.  Specify 'file' as '-' for  standard  input
     or output.

     Although  some options appear to modify the file to be iden-
     tified, the identify command  is  strictly  read  only.  For
     instance, the crop option crops the in-memory image and then
     describes the result.

ImageMagick   Last change: Date: 2009/01/10 01:00:00            2

User Commands                                         identify(1)

     See  attributes(5)  for  descriptions   of   the   following

     |Availability   | image/imagemagick |
     |Stability      | Volatile          |

     Copyright  (C)  1999-2013 ImageMagick Studio LLC. Additional
     copyrights  and  licenses  apply  to  this   software,   see
     file:///usr/share/doc/ImageMagick-6.8.3/www/license.html  or

     This  software  was   built   from   source   available   at    The  original
     community  source  was  downloaded  from   http://image_mag-

     Further  information about this software can be found on the
     open  source  community  website   at   http://www.imagemag-

ImageMagick   Last change: Date: 2009/01/10 01:00:00            3