1identify(1)                 General Commands Manual                identify(1)
2
3
4

NAME

6       identify  - describes the format and characteristics of one or more im‐
7       age files.
8

SYNOPSIS

10       magick identify [options] input-file
11

OVERVIEW

13       The identify program is a member of the ImageMagick(1) suite of  tools.
14       It describes the format and characteristics of one or more image files.
15       It also reports if an image is incomplete or corrupt.  The  information
16       returned includes the image number, the file name, the width and height
17       of the image, whether the image is colormapped or not,  the  number  of
18       colors  in  the  image (by default off use -define unique=true option),
19       the number of bytes in the image, the format of the image  (JPEG,  PNM,
20       etc.),  and  finally  the number of seconds it took to read and process
21       the image. Many more attributes are available with the verbose option.
22
23       For more information about the identify command, point your browser  to
24       file:///usr/share/doc/ImageMagick-7/www/identify.html or https://image
25       magick.org/script/identify.php.
26

DESCRIPTION

28       Image Settings:
29         -alpha option        on, activate, off, deactivate, set, opaque, copy
30                              transparent, extract, background, or shape
31         -antialias           remove pixel-aliasing
32         -authenticate value  decrypt image with this password
33         -clip                clip along the first path from the 8BIM profile
34         -clip-mask filename  associate a clip mask with the image
35         -clip-path id        clip along a named path from the 8BIM profile
36         -colorspace type     alternate image colorspace
37         -crop geometry       cut out a rectangular region of the image
38         -define format:option
39                              define one or more image format options
40         -define unique=true  return the number of unique colors in the image
41         -density geometry    horizontal and vertical density of the image
42         -depth value         image depth
43         -endian type         endianness (MSB or LSB) of the image
44         -extract geometry    extract area from image
45         -features distance   analyze image features (e.g. contrast,  correla‐
46       tion)
47         -format "string"     output formatted image characteristics
48         -fuzz distance       colors within this distance are considered equal
49         -gamma value         of gamma correction
50         -interlace type      type of image interlacing scheme
51         -interpolate method  pixel color interpolation method
52         -limit type value    pixel cache resource limit
53         -list  type           Color, Configure, Delegate, Format, Magic, Mod‐
54       ule,
55                              Resource, or Type
56         -matte               store matte channel if the image has one
57         -moments             report image moments
58         -monitor             monitor progress
59         -ping                efficiently determine image attributes
60         -precision value     maximum number of significant digits to print
61         -quiet               suppress all warning messages
62         -read-mask filename  associate a read mask with the image
63         -regard-warnings     pay attention to warning messages
64         -respect-parentheses settings  remain  in  effect  until  parenthesis
65       boundary
66         -sampling-factor geometry
67                              horizontal and vertical sampling factor
68         -seed value          seed a new sequence of pseudo-random numbers
69         -set attribute value set an image attribute
70         -size geometry       width and height of image
71         -strip               strip image of all profiles and comments
72         -unique              display the number of unique colors in the image
73         -units type          the units of image resolution
74         -verbose             print detailed information about the image
75         -virtual-pixel method
76                              virtual pixel access method
77
78       Image Operators:
79         -auto-orient         automatically orient image
80         -channel mask        set the image channel mask
81         -grayscale method    convert image to grayscale
82         -negate              replace each pixel with its complementary color
83
84       Miscellaneous Options:
85         -debug events        display copious debugging information
86         -help                print program options
87         -list type           print a list of supported option arguments
88         -log format          format of debugging information
89         -version             print version information
90
91       By  default, the image format of `file' is determined by its magic num‐
92       ber.  To specify a particular image format, precede the  filename  with
93       an  image  format name and a colon (i.e. ps:image) or specify the image
94       type as the filename suffix (i.e. image.ps).  Specify 'file' as '-' for
95       standard input or output.
96

NOTE

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

SEE ALSO

103       ImageMagick(1)
104
105
107       Copyright  (C)  1999  ImageMagick Studio LLC. Additional copyrights and
108       licenses  apply  to  this  software,  see  file:///usr/share/doc/Image‐
109       Magick-7/www/license.html or https://imagemagick.org/script/license.php
110
111
112
113ImageMagick                Date: 2009/01/10 01:00:00               identify(1)
Impressum