granicus.if.org Git - imagemagick/blob - utilities/identify.1

   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:///usr/local/share/doc/ImageMagick-7/www/identify.html or http://www.imagemagick.org/script/identify.php.
  11 .SH DESCRIPTION
  12 Image Settings:
  13   \-alpha option        on, activate, off, deactivate, set, opaque, copy
  14                        transparent, extract, background, or shape
  15   \-antialias           remove pixel-aliasing
  16   \-authenticate value  decrypt image with this password
  17   \-clip                clip along the first path from the 8BIM profile
  18   \-clip-mask filename  associate a clip mask with the image
  19   \-clip-path id        clip along a named path from the 8BIM profile
  20   \-colorspace type     alternate image colorspace
  21   \-crop geometry       cut out a rectangular region of the image
  22   \-define format:option
  23                        define one or more image format options
  24   \-define unique=true  return the number of unique colors in the image
  25   \-density geometry    horizontal and vertical density of the image
  26   \-depth value         image depth
  27   \-endian type         endianness (MSB or LSB) of the image
  28   \-extract geometry    extract area from image
  29   \-features distance   analyze image features (e.g. contrast, correlation)
  30   \-format "string"     output formatted image characteristics
  31   \-fuzz distance       colors within this distance are considered equal
  32   \-gamma value         of gamma correction
  33   \-interlace type      type of image interlacing scheme
  34   \-interpolate method  pixel color interpolation method
  35   \-limit type value    pixel cache resource limit
  36   \-list type           Color, Configure, Delegate, Format, Magic, Module,
  37                        Resource, or Type
  38   \-matte               store matte channel if the image has one
  39   \-moments             report image moments
  40   \-monitor             monitor progress
  41   \-ping                efficiently determine image attributes
  42   \-precision value     maximum number of significant digits to print
  43   \-quiet               suppress all warning messages
  44   \-read-mask filename  associate a read mask with the image
  45   \-regard-warnings     pay attention to warning messages
  46   \-respect-parentheses settings remain in effect until parenthesis boundary
  47   \-sampling-factor geometry
  48                        horizontal and vertical sampling factor
  49   \-seed value          seed a new sequence of pseudo-random numbers
  50   \-set attribute value set an image attribute
  51   \-size geometry       width and height of image
  52   \-strip               strip image of all profiles and comments
  53   \-unique              display the number of unique colors in the image
  54   \-units type          the units of image resolution
  55   \-verbose             print detailed information about the image
  56   \-virtual-pixel method
  57                        virtual pixel access method
  58
  59 Image Operators:
  60   \-channel mask        set the image channel mask
  61   \-grayscale method    convert image to grayscale
  62   \-negate              replace each pixel with its complementary color
  63
  64 Miscellaneous Options:
  65   \-debug events        display copious debugging information
  66   \-help                print program options
  67   \-list type           print a list of supported option arguments
  68   \-log format          format of debugging information
  69   \-version             print version information
  70
  71 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.
  72 .SH NOTE
  73 Although some options appear to modify the file to be identified, the identify command is strictly \fBread only\fP. For instance, the crop option crops the in-memory image and then describes the result.
  74 .SH SEE ALSO
  75 ImageMagick(1)
  76
  77 .SH COPYRIGHT
  78
  79 \fBCopyright (C) 1999-2018 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file:///usr/local/share/doc/ImageMagick-7/www/license.html or http://www.imagemagick.org/script/license.php\fP