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

NAME

6       compare  -  mathematically and visually annotate the difference between
7       an image and its reconstruction.
8

SYNOPSIS

10       compare input-file input-file [options] output-file
11

OVERVIEW

13       The compare program is a member of the ImageMagick(1) suite  of  tools.
14       Use  it  to mathematically and visually annotate the difference between
15       an image and its reconstruction.
16
17       For more information about the compare command, point your  browser  to
18       file:///usr/share/doc/ImageMagick-6/www/compare.html@EXTRA_DOC_DIR@  or
19       http://imagemagick.org/script/compare.php.
20

DESCRIPTION

22       Image Settings:
23         -alpha option        on, activate, off, deactivate, set, opaque, copy
24                               transparent, extract, background, or shape
25         -authenticate value  decrypt image with this password
26         -background color    background color
27         -channel type        apply option to select image channels
28         -colorspace type     alternate image colorspace
29         -compose operator    set image composite operator
30         -compress type       type of pixel compression when writing the image
31         -decipher filename   convert cipher pixels to plain pixels
32         -define format:option
33                              define one or more image format options
34         -density geometry    horizontal and vertical density of the image
35         -depth value         image depth
36         -dissimilarity-threshold value
37                               maximum distortion for (sub)image match
38         -encipher filename   convert plain pixels to cipher pixels
39         -extract geometry    extract area from image
40         -format "string"     output formatted image characteristics
41         -fuzz distance       colors within this distance are considered equal
42         -gravity type        horizontal and vertical text placement
43         -identify            identify the format and characteristics  of  the
44       image
45         -interlace type      type of image interlacing scheme
46         -highlight-color color
47                              emphasize pixel differences with this color
48         -limit type value    pixel cache resource limit
49         -lowlight-color color
50                              de-emphasize pixel differences with this color
51         -mask filename       associate a mask with the image
52         -metric  type          measure  differences  between images with this
53       metric
54         -monitor             monitor progress
55         -passphrase filename get the passphrase from this file
56         -profile filename    add, delete, or apply an image profile
57         -quality value       JPEG/MIFF/PNG compression level
58         -quiet               suppress all warning messages
59         -quantize colorspace reduce colors in this colorspace
60         -regard-warnings     pay attention to warning messages
61         -repage geometry     size and location of an image canvas
62         -respect-parentheses settings  remain  in  effect  until  parenthesis
63       boundary
64         -sampling-factor geometry
65                              horizontal and vertical sampling factor
66         -seed value          seed a new sequence of pseudo-random numbers
67         -set attribute value set an image attribute
68         -similarity-threshold value
69                               minimum distortion for (sub)image match
70         -size geometry       width and height of image
71         -subimage-search     search for subimage
72         -synchronize         synchronize image to storage device
73         -taint               declare the image as modified
74         -transparent-color color
75                              transparent color
76         -type type           image type
77         -verbose             print detailed information about the image
78         -virtual-pixel method
79                              virtual pixel access method
80
81       Image Operators:
82         -brightness-contrast geometry
83                              improve brightness / contrast of the image
84         -distort method args
85                               distort  images  according  to given method and
86       args
87         -level value         adjust the level of image contrast
88         -resize geometry     resize the image
89         -rotate degrees      apply Paeth rotation to the image
90         -separate            separate an image channel into a grayscale image
91         -trim                trim image edges
92         -write filename      write images to this file
93
94       Image Sequence Operators:
95         -crop geometry       cut out a rectangular region of the image
96
97       Image Stack Operators:
98         -delete indexes      delete the image from the image sequence
99
100       Miscellaneous Options:
101         -debug events        display copious debugging information
102         -help                print program options
103         -log format          format of debugging information
104         -list type           print a list of supported option arguments
105         -version             print version information
106
107       By default, the image format of `file' is determined by its magic  num‐
108       ber.   To  specify a particular image format, precede the filename with
109       an image format name and a colon (i.e. ps:image) or specify  the  image
110       type as the filename suffix (i.e. image.ps).  Specify 'file' as '-' for
111       standard input or output.
112
113       Two images are considered similar if their difference according to  the
114       specified metric and fuzz value is 0, with the exception of the normal‐
115       ized cross correlation metric (NCC), where two  images  are  considered
116       similar  when their normalized cross correlation is 1. The default met‐
117       ric is NCC.
118
119       The compare program returns 2 on error, 0 if the images are similar, or
120       a value between 0 and 1 if they are not similar.
121

SEE ALSO

123       ImageMagick(1)
124
125
127       Copyright  (C)  1999-2020 ImageMagick Studio LLC. Additional copyrights
128       and      licenses      apply      to      this      software,       see
129       file:///usr/share/doc/ImageMagick-6/www/license.html@EXTRA_DOC_DIR@  or
130       http://imagemagick.org/script/license.php
131
132
133
134ImageMagick                Date: 2009/01/10 01:00:00                compare(1)
Impressum