1identify(1) General Commands Manual identify(1)
2
6 identify - describes the format and characteristics of one or more im‐
7 age files.
8
10 identify [options] input-file
11
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 For more information about the identify command, point your browser to
24 file:///usr/share/doc/ImageMagick-6/www/identify.html or http://image‐
25 magick.org/script/identify.php.
26
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 -channel type apply option to select image channels
34 -clip clip along the first path from the 8BIM profile
35 -clip-mask filename associate a clip mask with the image
36 -clip-path id clip along a named path from the 8BIM profile
37 -colorspace type alternate image colorspace
38 -crop geometry cut out a rectangular region of the image
39 -define format:option
40 define one or more image format options
41 -define unique=true return the number of unique colors in the image
42 -density geometry horizontal and vertical density of the image
43 -depth value image depth
44 -endian type endianness (MSB or LSB) of the image
45 -extract geometry extract area from image
46 -features distance analyze image features (e.g. contrast, correla‐
47 tion)
48 -format "string" output formatted image characteristics
49 -fuzz distance colors within this distance are considered equal
50 -gamma value of gamma correction
51 -interlace type type of image interlacing scheme
52 -interpolate method pixel color interpolation method
53 -limit type value pixel cache resource limit
54 -list type Color, Configure, Delegate, Format, Magic, Mod‐
55 ule,
56 Resource, or Type
57 -mask filename associate a mask with the image
58 -matte store matte channel if the image has one
59 -moments report image moments
60 -monitor monitor progress
61 -ping efficiently determine image attributes
62 -precision value maximum number of significant digits to print
63 -quiet suppress all warning messages
64 -regard-warnings pay attention to warning messages
65 -respect-parentheses settings remain in effect until parenthesis
66 boundary
67 -sampling-factor geometry
68 horizontal and vertical sampling factor
69 -seed value seed a new sequence of pseudo-random numbers
70 -set attribute value set an image attribute
71 -size geometry width and height of image
72 -strip strip image of all profiles and comments
73 -unique display the number of unique colors in the image
74 -units type the units of image resolution
75 -verbose print detailed information about the image
76 -virtual-pixel method
77 virtual pixel access method
78 Image Operators:
80 -auto-orient automatically orient image
81 -grayscale method convert image to grayscale
82 -negate replace each pixel with its complementary color
83 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 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
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
104 ImageMagick(1)
105
108 Copyright (C) 1999-2021 ImageMagick Studio LLC. Additional copyrights
109 and licenses apply to this software, see file:///usr/share/doc/Image‐
110 Magick-6/www/license.html or http://imagemagick.org/script/license.php
111ImageMagick Date: 2009/01/10 01:00:00 identify(1)