Name
pixcmp — compare two pix image files pixel by pixel
DESCRIPTION
pixcmp is a program to compare two BRL-CAD pix image files pixel by pixel. The following OPTIONS are available:
-l
Output pixel numbers, counting from 1, and values for all pixels that differ.
-b
Use bytes instead of pixels for both processing and output. With this option, the
-i
SKIP values should be specified as bytes instead of pixels.-i
SKIP
Skip the first SKIP pixels of input (for FILE1 and FILE2).
-i
SKIP1
:SKIP2Skip the first SKIP1 pixels of FILE1 and the first SKIP2 pixels of FILE2.
-s
Silent output. Only return an exit status.
SKIP1 and SKIP2 are the number of pixels to skip in each file.
If FILE is `-` or missing, pixcmp reads from the standard input.
RETURN VALUES
The
pixcmp
utility returns 0
if there are no differences, 1
if there are only off-by-one differences, 2
if there are off-by-many errors, 126
if there are file processing problems, and 127
if there are argument processing or usage errors.
EXAMPLES
pixcmp -l file1 file2
The two files are compared pixel by pixel with each difference printed instead of just the summary.
- pixdiff file1.pix file2.pix | pixcmp - file3.pix
The pixdiff tool compares the pixels in file1.pix with those in file2.pix and then outputs a resulting `diff` image which is then processed by pixcmp as input and compared against file3.pix, reporting on the differences.