]> granicus.if.org Git - imagemagick/blob - utilities/identify.1.in
(no commit message)
[imagemagick] / utilities / identify.1.in
1 .TH identify 1 "Date: 2009/01/10 01:00:00" "ImageMagick"
2 .SH NAME
3 identify \- describes the format and characteristics of one or more image files.
4 .SH SYNOPSIS
5 .TP
6 \fBidentify\fP [\fIoptions\fP] \fIinput-file\fP
7 .SH OVERVIEW
8 The \fBidentify\fP 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 \fI-define unique=true\fP 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.
9
10 For more information about the identify command, point your browser to file://@DOCUMENTATION_PATH@/www/identify.html or http://www.imagemagick.org/script/identify.php.
11 .SH DESCRIPTION
12 Image Settings:
13   \-antialias           remove pixel-aliasing
14   \-authenticate value  decrypt image with this password
15   \-channel type        apply option to select image channels
16   \-crop geometry       cut out a rectangular region of the image
17   \-define format:option
18                        define one or more image format options
19   \-define unique=true  return the number of unique colors in the image
20   \-density geometry    horizontal and vertical density of the image
21   \-depth value         image depth
22   \-extract geometry    extract area from image
23   \-features distance   analyze image features (e.g. contrast, correlation)
24   \-format "string"     output formatted image characteristics
25   \-fuzz distance       colors within this distance are considered equal
26   \-interlace type      type of image interlacing scheme
27   \-interpolate method  pixel color interpolation method
28   \-limit type value    pixel cache resource limit
29   \-list type           Color, Configure, Delegate, Format, Magic, Module,
30                        Resource, or Type
31   \-matte               store matte channel if the image has one
32   \-monitor             monitor progress
33   \-ping                efficiently determine image attributes
34   \-quiet               suppress all warning messages
35   \-regard-warnings     pay attention to warning messages
36   \-sampling-factor geometry
37                        horizontal and vertical sampling factor
38   \-seed value          seed a new sequence of pseudo-random numbers
39   \-set attribute value set an image attribute
40   \-size geometry       width and height of image
41   \-strip               strip image of all profiles and comments
42   \-unique              display the number of unique colors in the image
43   \-units type          the units of image resolution
44   \-verbose             print detailed information about the image
45   \-virtual-pixel method
46                        virtual pixel access method
47
48 Image Operators:
49   \-negate              replace each pixel with its complementary color 
50
51 Miscellaneous Options:
52   \-debug events        display copious debugging information
53   \-help                print program options
54   \-log format          format of debugging information
55   \-list type           print a list of supported option arguments
56   \-version             print version information
57
58 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. image.ps).  Specify 'file' as '-' for standard input or output.
59 .SH SEE ALSO
60 ImageMagick(1)
61
62 .SH COPYRIGHT
63
64 \fBCopyright (C) 1999-2012 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file://@DOCUMENTATION_PATH@/www/license.html or http://www.imagemagick.org/script/license.php\fP