Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

identify (1)

Name

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

Synopsis

identify [options] input-file

Description

identify(1)                 General Commands Manual                identify(1)



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

SYNOPSIS
       identify [options] input-file

OVERVIEW
       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 number 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/www/identify.html                or
       http://imagemagick.org/script/identify.php.

DESCRIPTION
       Image Settings:
         -alpha option        on, activate, off, deactivate, set, opaque, copy
                              transparent, extract, background, or shape
         -antialias           remove pixel-aliasing
         -authenticate value  decrypt image with this password
         -channel type        apply option to select image channels
         -clip                clip along the first path from the 8BIM profile
         -clip-mask filename  associate a clip mask with the image
         -clip-path id        clip along a named path from the 8BIM profile
         -colorspace type     alternate image colorspace
         -crop geometry       cut out a rectangular region of the image
         -define format:option
                              define one or more image format options
         -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. contrast,  correla-
       tion)
         -format "string"     output formatted image characteristics
         -fuzz distance       colors within this distance are considered equal
         -gamma value         of gamma correction
         -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, Mod-
       ule,
                              Resource, or Type
         -mask filename       associate a mask with the image
         -matte               store matte channel if the image has one
         -moments             report image moments
         -monitor             monitor progress
         -ping                efficiently determine image attributes
         -precision value     maximum number of significant digits to print
         -quiet               suppress all warning messages
         -regard-warnings     pay attention to warning messages
         -respect-parentheses settings  remain  in  effect  until  parenthesis
       boundary
         -sampling-factor geometry
                              horizontal and vertical sampling factor
         -seed value          seed a new sequence of pseudo-random numbers
         -set attribute value set an image attribute
         -size geometry       width and height of image
         -strip               strip image of all profiles and comments
         -unique              display the number of unique colors in the image
         -units type          the units of image resolution
         -verbose             print detailed information about the image
         -virtual-pixel method
                              virtual pixel access method

       Image Operators:
         -grayscale method    convert image to grayscale
         -negate              replace each pixel with its complementary color

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

       By  default, the image format of `file' is determined by its magic num-
       ber.  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. image.ps).  Specify 'file' as '-' for
       standard input or output.

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



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE   |
       +---------------+-------------------+
       |Availability   | image/imagemagick |
       +---------------+-------------------+
       |Stability      | Volatile          |
       +---------------+-------------------+
SEE ALSO
       ImageMagick(1)


COPYRIGHT
       Copyright  (C)  1999-2019 ImageMagick Studio LLC. Additional copyrights
       and      licenses      apply      to      this      software,       see
       file:///usr/share/doc/ImageMagick-6/www/license.html                 or
       http://imagemagick.org/script/license.php



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source   was   downloaded   from     https://www.imagemagick.org//down-
       load/ImageMagick-6.9.10-34.tar.gz

       Further information about this software can be found on the open source
       community website at https://www.imagemagick.org/.



ImageMagick                Date: 2009/01/10 01:00:00               identify(1)