2003-06-18 05:58:48 -04:00
|
|
|
.\" $Header: /cvs/maptools/cvsroot/libtiff/man/tiffcmp.1,v 1.3 2003-06-18 09:58:48 dron Exp $
|
1999-07-27 17:50:26 -04:00
|
|
|
.\"
|
|
|
|
|
.\" Copyright (c) 1988-1997 Sam Leffler
|
|
|
|
|
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
|
|
|
|
|
.\"
|
|
|
|
|
.\" Permission to use, copy, modify, distribute, and sell this software and
|
|
|
|
|
.\" its documentation for any purpose is hereby granted without fee, provided
|
|
|
|
|
.\" that (i) the above copyright notices and this permission notice appear in
|
|
|
|
|
.\" all copies of the software and related documentation, and (ii) the names of
|
|
|
|
|
.\" Sam Leffler and Silicon Graphics may not be used in any advertising or
|
|
|
|
|
.\" publicity relating to the software without the specific, prior written
|
|
|
|
|
.\" permission of Sam Leffler and Silicon Graphics.
|
|
|
|
|
.\"
|
|
|
|
|
.\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
|
|
|
|
|
.\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
|
|
|
|
|
.\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
|
|
|
|
|
.\"
|
|
|
|
|
.\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
|
|
|
|
|
.\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
|
|
|
|
|
.\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
|
|
|
|
|
.\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
|
|
|
|
|
.\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
|
|
|
|
|
.\" OF THIS SOFTWARE.
|
|
|
|
|
.\"
|
|
|
|
|
.if n .po 0
|
|
|
|
|
.TH TIFFCMP 1 "September 26, 1994"
|
|
|
|
|
.SH NAME
|
|
|
|
|
tiffcmp \- compare two
|
|
|
|
|
.SM TIFF
|
|
|
|
|
files
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B tiffcmp
|
|
|
|
|
[
|
|
|
|
|
.I options
|
|
|
|
|
]
|
|
|
|
|
.I "file1.tif file2.tif"
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.I Tiffcmp
|
|
|
|
|
compares the tags and data in two files created according
|
|
|
|
|
to the Tagged Image File Format, Revision 6.0.
|
|
|
|
|
The schemes used for compressing data in each file
|
|
|
|
|
are immaterial when data are compared\-data are compared on
|
|
|
|
|
a scanline-by-scanline basis after decompression.
|
|
|
|
|
Most directory tags are checked; notable exceptions are:
|
|
|
|
|
.IR GrayResponseCurve ,
|
|
|
|
|
.IR ColorResponseCurve ,
|
|
|
|
|
and
|
|
|
|
|
.IR ColorMap
|
|
|
|
|
tags.
|
|
|
|
|
Data will not be compared if any of the
|
|
|
|
|
.IR BitsPerSample ,
|
|
|
|
|
.IR SamplesPerPixel ,
|
|
|
|
|
or
|
|
|
|
|
.I ImageWidth
|
|
|
|
|
values are not equal.
|
|
|
|
|
By default,
|
|
|
|
|
.I tiffcmp
|
|
|
|
|
will terminate if it encounters any difference.
|
|
|
|
|
.SH OPTIONS
|
|
|
|
|
.TP
|
|
|
|
|
.B \-l
|
|
|
|
|
List each byte of image data that differs between the files.
|
|
|
|
|
.TP
|
2003-06-18 05:58:48 -04:00
|
|
|
.B \-z number
|
|
|
|
|
List specified number of image data bytes that differs between the files.
|
|
|
|
|
.TP
|
1999-07-27 17:50:26 -04:00
|
|
|
.B \-t
|
|
|
|
|
Ignore any differences in directory tags.
|
|
|
|
|
.SH BUGS
|
|
|
|
|
Tags that are not recognized by the library are not
|
|
|
|
|
compared; they may also generate spurious diagnostics.
|
2001-06-28 22:46:45 -04:00
|
|
|
.PP
|
|
|
|
|
The image data of tiled files is not compared, since the TIFFReadScanline()
|
|
|
|
|
function is used. A error will be reported for tiled files.
|
|
|
|
|
.PP
|
|
|
|
|
The pixel and/or sample number reported in differences may be off
|
|
|
|
|
in some exotic cases.
|
1999-07-27 17:50:26 -04:00
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
.IR pal2rgb (1),
|
|
|
|
|
.IR tiffinfo (1),
|
|
|
|
|
.IR tiffcp (1),
|
|
|
|
|
.IR tiffmedian (1),
|
|
|
|
|
.IR libtiff (3)
|
