man-pages/man1/compare-im6.q16.1.html
2021-03-31 01:06:50 +01:00

143 lines
12 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of compare-im6.q16</TITLE>
</HEAD><BODY>
<H1>compare-im6.q16</H1>
Section: User Commands (1)<BR>Updated: Date: 2009/01/10 01:00:00<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
compare - mathematically and visually annotate the difference between an image and its reconstruction.
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<DL COMPACT>
<DT id="1"><B>compare-im6.q16</B> <I>input-file</I> <I>input-file</I> [<I>options</I>] <I>output-file</I><DD>
</DL>
<A NAME="lbAD">&nbsp;</A>
<H2>OVERVIEW</H2>
The <B>compare-im6.q16</B> program is a member of the <A HREF="/cgi-bin/man/man2html?1+ImageMagick-ims6.q16">ImageMagick-ims6.q16</A>(1) suite of tools. Use it to mathematically and visually annotate the difference between an image and its reconstruction.
<P>
For more information about the compare command, point your browser to <A HREF="file:///usr/share/doc/imagemagick-6-common/html/www/compare.html">file:///usr/share/doc/imagemagick-6-common/html/www/compare.html</A> (on debian system you may install the imagemagick-6 package) or <A HREF="http://imagemagick.org/script/compare.php.">http://imagemagick.org/script/compare.php.</A>
<A NAME="lbAE">&nbsp;</A>
<H2>DESCRIPTION</H2>
Image Settings:
<BR>&nbsp;&nbsp;-alpha&nbsp;option&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;on,&nbsp;activate,&nbsp;off,&nbsp;deactivate,&nbsp;set,&nbsp;opaque,&nbsp;copy
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;transparent,&nbsp;extract,&nbsp;background,&nbsp;or&nbsp;shape
<BR>&nbsp;&nbsp;-authenticate&nbsp;value&nbsp;&nbsp;decrypt&nbsp;image&nbsp;with&nbsp;this&nbsp;password
<BR>&nbsp;&nbsp;-background&nbsp;color&nbsp;&nbsp;&nbsp;&nbsp;background&nbsp;color
<BR>&nbsp;&nbsp;-channel&nbsp;type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;apply&nbsp;option&nbsp;to&nbsp;select&nbsp;image&nbsp;channels
<BR>&nbsp;&nbsp;-colorspace&nbsp;type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;alternate&nbsp;image&nbsp;colorspace
<BR>&nbsp;&nbsp;-compose&nbsp;operator&nbsp;&nbsp;&nbsp;&nbsp;set&nbsp;image&nbsp;composite&nbsp;operator
<BR>&nbsp;&nbsp;-compress&nbsp;type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;type&nbsp;of&nbsp;pixel&nbsp;compression&nbsp;when&nbsp;writing&nbsp;the&nbsp;image
<BR>&nbsp;&nbsp;-decipher&nbsp;filename&nbsp;&nbsp;&nbsp;convert&nbsp;cipher&nbsp;pixels&nbsp;to&nbsp;plain&nbsp;pixels
<BR>&nbsp;&nbsp;-define&nbsp;format:option
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;define&nbsp;one&nbsp;or&nbsp;more&nbsp;image&nbsp;format&nbsp;options
<BR>&nbsp;&nbsp;-density&nbsp;geometry&nbsp;&nbsp;&nbsp;&nbsp;horizontal&nbsp;and&nbsp;vertical&nbsp;density&nbsp;of&nbsp;the&nbsp;image
<BR>&nbsp;&nbsp;-depth&nbsp;value&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;image&nbsp;depth
<BR>&nbsp;&nbsp;-dissimilarity-threshold&nbsp;value
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;maximum&nbsp;distortion&nbsp;for&nbsp;(sub)image&nbsp;match
<BR>&nbsp;&nbsp;-encipher&nbsp;filename&nbsp;&nbsp;&nbsp;convert&nbsp;plain&nbsp;pixels&nbsp;to&nbsp;cipher&nbsp;pixels
<BR>&nbsp;&nbsp;-extract&nbsp;geometry&nbsp;&nbsp;&nbsp;&nbsp;extract&nbsp;area&nbsp;from&nbsp;image
<BR>&nbsp;&nbsp;-format&nbsp;&quot;string&quot;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;output&nbsp;formatted&nbsp;image&nbsp;characteristics
<BR>&nbsp;&nbsp;-fuzz&nbsp;distance&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;colors&nbsp;within&nbsp;this&nbsp;distance&nbsp;are&nbsp;considered&nbsp;equal
<BR>&nbsp;&nbsp;-gravity&nbsp;type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;horizontal&nbsp;and&nbsp;vertical&nbsp;text&nbsp;placement
<BR>&nbsp;&nbsp;-identify&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;identify&nbsp;the&nbsp;format&nbsp;and&nbsp;characteristics&nbsp;of&nbsp;the&nbsp;image
<BR>&nbsp;&nbsp;-interlace&nbsp;type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;type&nbsp;of&nbsp;image&nbsp;interlacing&nbsp;scheme
<BR>&nbsp;&nbsp;-highlight-color&nbsp;color
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;emphasize&nbsp;pixel&nbsp;differences&nbsp;with&nbsp;this&nbsp;color
<BR>&nbsp;&nbsp;-limit&nbsp;type&nbsp;value&nbsp;&nbsp;&nbsp;&nbsp;pixel&nbsp;cache&nbsp;resource&nbsp;limit
<BR>&nbsp;&nbsp;-lowlight-color&nbsp;color
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;de-emphasize&nbsp;pixel&nbsp;differences&nbsp;with&nbsp;this&nbsp;color
<BR>&nbsp;&nbsp;-mask&nbsp;filename&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;associate&nbsp;a&nbsp;mask&nbsp;with&nbsp;the&nbsp;image
<BR>&nbsp;&nbsp;-metric&nbsp;type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;measure&nbsp;differences&nbsp;between&nbsp;images&nbsp;with&nbsp;this&nbsp;metric
<BR>&nbsp;&nbsp;-monitor&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;monitor&nbsp;progress
<BR>&nbsp;&nbsp;-passphrase&nbsp;filename&nbsp;get&nbsp;the&nbsp;passphrase&nbsp;from&nbsp;this&nbsp;file
<BR>&nbsp;&nbsp;-profile&nbsp;filename&nbsp;&nbsp;&nbsp;&nbsp;add,&nbsp;delete,&nbsp;or&nbsp;apply&nbsp;an&nbsp;image&nbsp;profile
<BR>&nbsp;&nbsp;-quality&nbsp;value&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;JPEG/MIFF/PNG&nbsp;compression&nbsp;level
<BR>&nbsp;&nbsp;-quiet&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;suppress&nbsp;all&nbsp;warning&nbsp;messages
<BR>&nbsp;&nbsp;-quantize&nbsp;colorspace&nbsp;reduce&nbsp;colors&nbsp;in&nbsp;this&nbsp;colorspace
<BR>&nbsp;&nbsp;-regard-warnings&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pay&nbsp;attention&nbsp;to&nbsp;warning&nbsp;messages
<BR>&nbsp;&nbsp;-repage&nbsp;geometry&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;size&nbsp;and&nbsp;location&nbsp;of&nbsp;an&nbsp;image&nbsp;canvas
<BR>&nbsp;&nbsp;-respect-parentheses&nbsp;settings&nbsp;remain&nbsp;in&nbsp;effect&nbsp;until&nbsp;parenthesis&nbsp;boundary
<BR>&nbsp;&nbsp;-sampling-factor&nbsp;geometry
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;horizontal&nbsp;and&nbsp;vertical&nbsp;sampling&nbsp;factor
<BR>&nbsp;&nbsp;-seed&nbsp;value&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;seed&nbsp;a&nbsp;new&nbsp;sequence&nbsp;of&nbsp;pseudo-random&nbsp;numbers
<BR>&nbsp;&nbsp;-set&nbsp;attribute&nbsp;value&nbsp;set&nbsp;an&nbsp;image&nbsp;attribute
<BR>&nbsp;&nbsp;-similarity-threshold&nbsp;value
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;minimum&nbsp;distortion&nbsp;for&nbsp;(sub)image&nbsp;match
<BR>&nbsp;&nbsp;-size&nbsp;geometry&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;width&nbsp;and&nbsp;height&nbsp;of&nbsp;image
<BR>&nbsp;&nbsp;-subimage-search&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;search&nbsp;for&nbsp;subimage
<BR>&nbsp;&nbsp;-synchronize&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;synchronize&nbsp;image&nbsp;to&nbsp;storage&nbsp;device
<BR>&nbsp;&nbsp;-taint&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;declare&nbsp;the&nbsp;image&nbsp;as&nbsp;modified
<BR>&nbsp;&nbsp;-transparent-color&nbsp;color
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;transparent&nbsp;color
<BR>&nbsp;&nbsp;-type&nbsp;type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;image&nbsp;type
<BR>&nbsp;&nbsp;-verbose&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;detailed&nbsp;information&nbsp;about&nbsp;the&nbsp;image
<BR>&nbsp;&nbsp;-virtual-pixel&nbsp;method
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;virtual&nbsp;pixel&nbsp;access&nbsp;method
<P>
Image Operators:
<BR>&nbsp;&nbsp;-brightness-contrast&nbsp;geometry
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;improve&nbsp;brightness&nbsp;/&nbsp;contrast&nbsp;of&nbsp;the&nbsp;image
<BR>&nbsp;&nbsp;-distort&nbsp;method&nbsp;args
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;distort&nbsp;images&nbsp;according&nbsp;to&nbsp;given&nbsp;method&nbsp;and&nbsp;args
<BR>&nbsp;&nbsp;-level&nbsp;value&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;adjust&nbsp;the&nbsp;level&nbsp;of&nbsp;image&nbsp;contrast
<BR>&nbsp;&nbsp;-resize&nbsp;geometry&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;resize&nbsp;the&nbsp;image
<BR>&nbsp;&nbsp;-rotate&nbsp;degrees&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;apply&nbsp;Paeth&nbsp;rotation&nbsp;to&nbsp;the&nbsp;image
<BR>&nbsp;&nbsp;-separate&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;separate&nbsp;an&nbsp;image&nbsp;channel&nbsp;into&nbsp;a&nbsp;grayscale&nbsp;image
<BR>&nbsp;&nbsp;-trim&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;trim&nbsp;image&nbsp;edges
<BR>&nbsp;&nbsp;-write&nbsp;filename&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;write&nbsp;images&nbsp;to&nbsp;this&nbsp;file
<P>
Image Sequence Operators:
<BR>&nbsp;&nbsp;-crop&nbsp;geometry&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cut&nbsp;out&nbsp;a&nbsp;rectangular&nbsp;region&nbsp;of&nbsp;the&nbsp;image
<P>
Image Stack Operators:
<BR>&nbsp;&nbsp;-delete&nbsp;indexes&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;delete&nbsp;the&nbsp;image&nbsp;from&nbsp;the&nbsp;image&nbsp;sequence
<P>
Miscellaneous Options:
<BR>&nbsp;&nbsp;-debug&nbsp;events&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;display&nbsp;copious&nbsp;debugging&nbsp;information
<BR>&nbsp;&nbsp;-help&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;program&nbsp;options
<BR>&nbsp;&nbsp;-log&nbsp;format&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;format&nbsp;of&nbsp;debugging&nbsp;information
<BR>&nbsp;&nbsp;-list&nbsp;type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;a&nbsp;list&nbsp;of&nbsp;supported&nbsp;option&nbsp;arguments
<BR>&nbsp;&nbsp;-version&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;version&nbsp;information
<P>
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.
<P>
Two images are considered similar if their difference according to the specified metric and fuzz value is 0, with the exception of the normalized cross correlation metric (NCC), where two images are considered similar when their normalized cross correlation is 1. The default metric is NCC.
<P>
The compare program returns 2 on error, 0 if the images are similar, or a value between 0 and 1 if they are not similar.
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>
<A HREF="/cgi-bin/man/man2html?1+ImageMagick-ims6.q16">ImageMagick-ims6.q16</A>(1)
<P>
<A NAME="lbAG">&nbsp;</A>
<H2>COPYRIGHT</H2>
<P>
<B>Copyright (C) 1999-2019 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see <A HREF="file:///usr/share/doc/imagemagick-6-common/html/www/license.html">file:///usr/share/doc/imagemagick-6-common/html/www/license.html</A> (on debian system you may install the imagemagick-6 package) or <A HREF="http://imagemagick.org/script/license.php">http://imagemagick.org/script/license.php</A></B>
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="2"><A HREF="#lbAB">NAME</A><DD>
<DT id="3"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="4"><A HREF="#lbAD">OVERVIEW</A><DD>
<DT id="5"><A HREF="#lbAE">DESCRIPTION</A><DD>
<DT id="6"><A HREF="#lbAF">SEE ALSO</A><DD>
<DT id="7"><A HREF="#lbAG">COPYRIGHT</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:09 GMT, March 31, 2021
</BODY>
</HTML>