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 magick 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-7/www/compare.html or https://image‐
19 magick.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 -colorspace type alternate image colorspace
28 -compose operator set image composite operator
29 -compress type type of pixel compression when writing the image
30 -decipher filename convert cipher pixels to plain pixels
31 -define format:option
32 define one or more image format options
33 -density geometry horizontal and vertical density of the image
34 -depth value image depth
35 -dissimilarity-threshold value
36 maximum distortion for (sub)image match
37 -encipher filename convert plain pixels to cipher pixels
38 -extract geometry extract area from image
39 -format "string" output formatted image characteristics
40 -fuzz distance colors within this distance are considered equal
41 -gravity type horizontal and vertical text placement
42 -identify identify the format and characteristics of the
43 image
44 -interlace type type of image interlacing scheme
45 -highlight-color color
46 emphasize pixel differences with this color
47 -limit type value pixel cache resource limit
48 -lowlight-color color
49 de-emphasize pixel differences with this color
50 -metric type measure differences between images with this
51 metric
52 -monitor monitor progress
53 -negate replace each pixel with its complementary color
54 -profile filename add, delete, or apply an image profile
55 -quality value JPEG/MIFF/PNG compression level
56 -quiet suppress all warning messages
57 -quantize colorspace reduce colors in this colorspace
58 -read-mask filename associate a read mask with the image
59 -regard-warnings pay attention to warning messages
60 -repage geometry size and location of an image canvas
61 -respect-parentheses settings remain in effect until parenthesis
62 boundary
63 -sampling-factor geometry
64 horizontal and vertical sampling factor
65 -seed value seed a new sequence of pseudo-random numbers
66 -set attribute value set an image attribute
67 -similarity-threshold value
68 minimum distortion for (sub)image match
69 -size geometry width and height of image
70 -subimage-search search for subimage
71 -synchronize synchronize image to storage device
72 -taint declare the image as modified
73 -transparent-color color
74 transparent color
75 -type type image type
76 -write-mask filename associate a write mask with the image
77 -verbose print detailed information about the image
78 -virtual-pixel method
79 virtual pixel access method
80 Image Operators:
82 -auto-orient automatically orient image
83 -brightness-contrast geometry
84 improve brightness / contrast of the image
85 -distort method args
86 distort images according to given method and
87 args
88 -level value adjust the level of image contrast
89 -resize geometry resize the image
90 -rotate degrees apply Paeth rotation to the image
91 -sigmoidal-contrast geometry
92 lightness rescaling using sigmoidal contrast en‐
93 hancement
94 -trim trim image edges
95 Image Channel Operators:
97 -separate separate an image channel into a grayscale image
98 Image Sequence Operators:
100 -crop geometry cut out a rectangular region of the image
101 -write filename write images to this file
102 Image Stack Operators:
104 -delete indexes delete the image from the image sequence
105 Miscellaneous Options:
107 -channel mask set the image channel mask
108 -debug events display copious debugging information
109 -help print program options
110 -log format format of debugging information
111 -list type print a list of supported option arguments
112 -version print version information
113 By default, the image format of `file' is determined by its magic num‐
115 ber. To specify a particular image format, precede the filename with
116 an image format name and a colon (i.e. ps:image) or specify the image
117 type as the filename suffix (i.e. image.ps). Specify 'file' as '-' for
118 standard input or output.
119 Two images are considered similar if their difference according to the
121 specified metric and fuzz value is 0, with the exception of the normal‐
122 ized cross correlation metric (NCC), where two images are considered
123 similar when their normalized cross correlation is 1. The default met‐
124 ric is NCC.
125 The compare program returns 2 on error, 0 if the images are similar, or
127 a value between 0 and 1 if they are not similar.
128
130 ImageMagick(1)
131
134 Copyright (C) 1999 ImageMagick Studio LLC. Additional copyrights and
135 licenses apply to this software, see file:///usr/share/doc/Image‐
136 Magick-7/www/license.html or https://imagemagick.org/script/license.php
137ImageMagick Date: 2009/01/10 01:00:00 compare(1)