<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!--ARC : LSARC 2003/085 libtiff, libjpeg, and libpng-->
<!ENTITY exam-tt "EXAMPLES">
<!ENTITY cmd "tiffcmp">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY suncopy "Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.">
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="tiffcmp-1">
<!-- %Z%%M% %I% %E% SMI; -->
<refmeta><refentrytitle>tiffcmp</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">26 Mar 2004</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&release;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
</refmeta>
<indexterm><primary>tiffcmp</primary></indexterm><indexterm><primary>compare
two TIFF files</primary></indexterm>
<refnamediv id="tiffcmp-1-name"><refname>tiffcmp</refname><refpurpose>compare
two TIFF files</refpurpose></refnamediv>
<refsynopsisdiv id="tiffcmp-1-synp"><title>&synp-tt;</title>
<cmdsynopsis><command>&cmd;</command><arg choice="opt"><option role="nodash"><replaceable>
options</replaceable></option></arg><arg choice="plain" rep="norepeat"><option
role="nodash"><replaceable>file1.tif</replaceable></option></arg><arg choice="plain"
rep="norepeat"><option role="nodash"><replaceable>file2.tif</replaceable></option></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1 id="tiffcmp-1-desc"><title>&desc-tt;</title>
<para><command>&cmd;</command> 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 comparing data. Files
are compared on a scanline-by-scanline basis after decompression. Most directory
tags are checked, notable exceptions are GrayResponseCurve, ColorResponseCurve,
and ColorMap tags. Data is not compared if any of the BitsPerSample, SamplesPerPixel,
or ImageWidth values are not equal. By default, <command>&cmd;</command> terminates
if any difference is encountered.</para>
</refsect1>
<refsect1 id="tiffcmp-1-opts"><title>&opts-tt;</title>
<para>The following options are supported:</para>
<variablelist termlength="narrow">
<varlistentry><term><option>l</option></term><listitem><para>List each byte
of image data that differs between the files.</para>
</listitem></varlistentry>
<varlistentry><term><option>t</option></term><listitem><para>Ignore any differences
in directory tags.</para>
</listitem></varlistentry>
</variablelist>
<variablelist termlength="narrow"></variablelist></refsect1>
<refsect1 id="tiffcmp-1-oper"><title>&oper-tt;</title>
<para>The following operands are supported:</para>
<variablelist termlength="narrow">
<varlistentry><term><option role="nodash"><replaceable>filex.tif</replaceable></option></term>
<listitem><para>The names of the TIFF files to be compared.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1 id="tiffcmp-1-attr"><title>&attr-tt;</title>
<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
for descriptions of the following attributes:</para>
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
<colspec colname="COLSPEC1" colwidth="1*">
<thead>
<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
valign="middle">ATTRIBUTE VALUE</entry></row>
</thead>
<tbody>
<row><entry><para>Availability</para></entry><entry><para>image/library/libtiff</para></entry>
</row>
<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
colname="COLSPEC1"><para>Uncommitted</para></entry></row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="tiffcmp-1-also"><title>&also-tt;</title>
<!--Reference to another man page-->
<!--Reference to a Help manual-->
<!--Reference to a book.-->
<para>
<citerefentry><refentrytitle>pal2rgb</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>tiffinfo</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>tiffcp</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>tiffmedian</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>libtiff</refentrytitle><manvolnum>3</manvolnum></citerefentry>
</para>
</refsect1>
<refsect1 id="tiffcmp-1-note"><title>&note-tt;</title>
<para>Tags that are not recognized by the library are not compared. Such tags
may also generate spurious diagnostics.</para>
<para>Updated by Breda McColgan, Sun Microsystems Inc., 2004.</para>
</refsect1>
</refentry>
