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

   1 .TH compare 1 "Date: 2009/01/10 01:00:00" "ImageMagick"
   2 .SH NAME
   3 compare \- mathematically and visually annotate the difference between an image and its reconstruction.
   4 .SH SYNOPSIS
   5 .TP
   6 \fBcompare\fP \fIinput-file\fP \fIinput-file\fP [\fIoptions\fP] \fIoutput-file\fP
   7 .SH OVERVIEW
   8 The \fBcompare\fP program is a member of the ImageMagick(1) suite of tools.  Use it to mathematically and visually annotate the difference between an image and its reconstruction.
   9
  10 For more information about the compare command, point your browser to file:///usr/local/share/doc/ImageMagick-7/www/compare.html or http://www.imagemagick.org/script/compare.php.
  11 .SH DESCRIPTION
  12 Image Settings:
  13   \-alpha option        on, activate, off, deactivate, set, opaque, copy
  14   \                     transparent, extract, background, or shape
  15   \-authenticate value  decrypt image with this password
  16   \-colorspace type     alternate image colorspace
  17   \-compose operator    set image composite operator
  18   \-compress type       type of pixel compression when writing the image
  19   \-decipher filename   convert cipher pixels to plain pixels
  20   \-define format:option
  21                        define one or more image format options
  22   \-density geometry    horizontal and vertical density of the image
  23   \-depth value         image depth
  24   \-dissimilarity-threshold value
  25                         maximum distortion for (sub)image match
  26   \-encipher filename   convert plain pixels to cipher pixels
  27   \-extract geometry    extract area from image
  28   \-format "string"     output formatted image characteristics
  29   \-fuzz distance       colors within this distance are considered equal
  30   \-identify            identify the format and characteristics of the image
  31   \-interlace type      type of image interlacing scheme
  32   \-highlight-color color
  33                        emphasize pixel differences with this color
  34   \-limit type value    pixel cache resource limit
  35   \-lowlight-color color
  36                        de-emphasize pixel differences with this color
  37   \-metric type         measure differences between images with this metric
  38   \-monitor             monitor progress
  39   \-profile filename    add, delete, or apply an image profile
  40   \-quality value       JPEG/MIFF/PNG compression level
  41   \-quiet               suppress all warning messages
  42   \-quantize colorspace reduce colors in this colorspace
  43   \-regard-warnings     pay attention to warning messages
  44   \-respect-parentheses settings remain in effect until parenthesis boundary
  45   \-sampling-factor geometry
  46                        horizontal and vertical sampling factor
  47   \-seed value          seed a new sequence of pseudo-random numbers
  48   \-set attribute value set an image attribute
  49   \-similarity-threshold value
  50                         minimum distortion for (sub)image match
  51   \-size geometry       width and height of image
  52   \-subimage-search     search for subimage
  53   \-synchronize         synchronize image to storage device
  54   \-taint               declare the image as modified
  55   \-transparent-color color
  56                        transparent color
  57   \-type type           image type
  58   \-verbose             print detailed information about the image
  59   \-virtual-pixel method
  60                        virtual pixel access method
  61
  62 Miscellaneous Options:
  63   \-channel mask        set the image channel mask
  64   \-debug events        display copious debugging information
  65   \-help                print program options
  66   \-log format          format of debugging information
  67   \-list type           print a list of supported option arguments
  68   \-version             print version information
  69
  70 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.
  71
  72 The compare program returns 2 on error otherwise 0 if the images are similar or
  73 1 if they are dissimilar.
  74 .SH SEE ALSO
  75 ImageMagick(1)
  76
  77 .SH COPYRIGHT
  78
  79 \fBCopyright (C) 1999-2014 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