1compare(1) General Commands Manual compare(1)
2
6 compare - mathematically and visually annotate the difference between
7 an image and its reconstruction.
8
10 compare input-file input-file [options] output-file
11
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 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
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 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 Image Sequence Operators:
95 -crop geometry cut out a rectangular region of the image
96 Image Stack Operators:
98 -delete indexes delete the image from the image sequence
99 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 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 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 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
123 ImageMagick(1)
124
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
131ImageMagick Date: 2009/01/10 01:00:00 compare(1)