<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

<!--ArborText, Inc., 1988-1999, v.4002-->

<!ENTITY synp-tt "SYNOPSIS">

<!ENTITY cmd "libtiff">

<!ENTITY % commonents SYSTEM "smancommon.ent">

%commonents;

<!ENTITY % gnomecommonents SYSTEM "gnomecommon.ent">

%gnomecommonents;

<!ENTITY % booktitles SYSTEM "booktitles.ent">

%booktitles;

<!ENTITY suncopy "Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.">

]>

<?Pub UDT _bookmark _target>

<?Pub EntList brvbar bull cross dash diam diams frac12 frac13 frac14 hellip

laquo lArr loz mdash nabla ndash para pound rArr raquo sect yen lt gt bsol>

<?Pub Inc>

<refentry id="libtiff-3">

<refmeta><refentrytitle>libtiff</refentrytitle><manvolnum>3</manvolnum>

<refmiscinfo class="date">06 Apr 2004</refmiscinfo>

<refmiscinfo class="sectdesc">&man3;</refmiscinfo>

<refmiscinfo class="software">&release;</refmiscinfo>

<refmiscinfo class="arch">generic</refmiscinfo>

<refmiscinfo class="copyright">&suncopy;</refmiscinfo>

</refmeta>

<indexterm><primary>libtiff</primary></indexterm><indexterm><primary>introduction

to <filename>libtiff</filename>, a library for reading and writing TIFF files

</primary></indexterm>

<refnamediv id="libtiff-3-name"><refname>libtiff</refname><refpurpose>introduction

to <filename>libtiff</filename>, a library for reading and writing TIFF files

</refpurpose></refnamediv>

<refsect1 id="libtiff-3-synp"><title>&synp-tt;</title>

<programlisting>#include &lt;tiffio.h>

cc [ <replaceable>flag</replaceable> ...] -I/usr/sfw/include <replaceable>

file</replaceable> [ <replaceable>library</replaceable> ... ]

-L/usr/sfw/lib -R/usr/sfw/lib -ltiff</programlisting>

</refsect1>

<refsect1 id="libtiff-3-desc"><title>&desc-tt;</title>

<para><filename>&cmd;</filename> is a library for reading and writing data

files encoded with the Tag Image File format, Revision 4.0 or later. The TIFF

file format is suitable for archiving multicolor and monochromatic image data.

</para>

</refsect1>

<refsect1 id="libtiff-3-exde"><title>&exde-tt;</title>

<para>The <filename>&cmd;</filename> library supports several compression

algorithms, as indicated by the Compression field, including:</para>

<itemizedlist>

<listitem><para>No compression (1)</para></listitem>

<listitem><para>CCITT 1D Huffman compression (2)</para></listitem>

<listitem><para>CCITT Group 3 Facsimile compression (3)</para></listitem>

<listitem><para>CCITT Group 4 Facsimile compression (4)</para></listitem>

<listitem><para>Lempel-Ziv &amp; Welch compression (5)</para></listitem>

<listitem><para>Baseline JPEG compression (7)</para></listitem>

<listitem><para>Word-aligned 1D Huffman compression (32771)</para></listitem>

<listitem><para>PackBits compression (32773)</para></listitem>

</itemizedlist>

<para>In addition, several nonstandard compression algorithms are supported:

</para>

<itemizedlist>

<listitem><para>4-bit compression algorithm used by the ThunderScan program

(32809) (decompression only)</para></listitem>

<listitem><para>NeXT's 2-bit compression algorithm (32766) (decompression

only)</para></listitem>

<listitem><para>Experimental LZ-style algorithm known as Deflate (32946)</para>

</listitem>

<listitem><para>Experimental CIE LogLuv compression scheme designed for images

with high dynamic range (32845 for LogL and 32845 for LogLuv)</para></listitem>

</itemizedlist>

<para>Directory information may be in either little- or big-endian byte order.

Byte swapping is automatically done by the library.</para>

<para>Data bit ordering may be either Most Significant Bit (MSB) to Least

Significant Bit (LSB), or LSB to MSB.</para>

<para>The library does not support files in which the BitsPerSample, Compression,

MinSampleValue, or MaxSampleValue fields are defined differently on a per-sample

basis. In Revision 6.0, the Compression tag is not defined on a per-sample

basis, so this is immaterial.</para>

<refsect2 id="libtiff-3-exde-data">

<title>Data Types</title>

<para>The <filename>&cmd;</filename> library makes extensive use of C typedefs

to promote portability. Two sets of typedefs are used, one for communication

with clients of the library and one for internal data structures and parsing

of the TIFF format. The following typedefs are exposed to users either through

function definitions or through parameters passed through the <literal>varargs

</literal> interfaces.</para>

<itemizedlist>

<listitem><para><literal>typedef unsigned short uint16;</literal> &mdash;

16-bit unsigned integer</para></listitem>

<listitem><para><literal>typedef unsigned &lt;thing> uint32;</literal> &mdash;

32-bit unsigned integer</para></listitem>

<listitem><para><literal>typedef unsigned int ttag_t;</literal> &mdash; directory

tag</para></listitem>

<listitem><para><literal>typedef uint16 tdir_t;</literal> &mdash; directory

index</para></listitem>

<listitem><para><literal>typedef uint16 tsample_t;</literal> &mdash; sample

number</para></listitem>

<listitem><para><literal>typedef uint32 tstrip_t;</literal> &mdash; strip

number</para></listitem>

<listitem><para><literal>typedef uint32 ttile_t;</literal> &mdash; tile number

</para></listitem>

<listitem><para><literal>typedef int32 tsize_t;</literal> &mdash; i/o size

in bytes</para></listitem>

<listitem><para><literal>typedef void* tdata_t;</literal> &mdash; image data

ref</para></listitem>

<listitem><para><literal>typedef void* thandle_t;</literal> &mdash; client

data handle</para></listitem>

<listitem><para><literal>typedef int32 toff_t;</literal> &mdash; file offset

</para></listitem>

</itemizedlist>

<para><literal>tstrip_t</literal>, <literal>ttile_t</literal>, and <literal>

tsize_t</literal> are limited to 32-bit quantities because they are stored

in 32-bit fields in the TIFF image. Similarly, <literal>tsample_t</literal>

is limited by the 16-bit field used to store the <literal>SamplesPerPixel

</literal> tag. <literal>tdir_t</literal> constrains the maximum number of

IFDs that may appear in an image and may be an arbitrary size without penalty.

</para>

<para><literal>ttag_t</literal> must be <literal>int</literal>, <literal>

unsigned int</literal>, <literal>pointer</literal>, or <literal>double</literal>

because the library uses a <literal>varargs</literal> interface and ANSI C

restricts the type of the parameter before an ellipsis to be a promoted type.

</para>

<para><literal>toff_t</literal> is defined as <literal>int32</literal> because

TIFF file offsets are unsigned 32-bit quantities. A signed value is used because

some interfaces return -1 on error.</para>

<para>User-specified data references are passed as opaque handles and only

cast at the lowest layers where their type is presumed.</para>

</refsect2>

<refsect2 id="libtiff-3-exde-routines">

<title>Library Routines</title>

<para>The following routines are part of the <filename>&cmd;</filename> library.

Consult specific reference pages for details on their operation. The reference

page names listed below are for systems where the full function names cannot

be encoded in the file system. On most systems, the command <command>man <replaceable>

function-name</replaceable></command> will work.</para>

<variablelist termlength="xtrawide">

<varlistentry><term><literal>_TIFFfree</literal></term><listitem><para>Release

allocated memory. See <citerefentry><refentrytitle>TIFFmemory</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>_TIFFmalloc</literal></term><listitem><para>

Dynamically allocate memory. See <citerefentry><refentrytitle>TIFFmemory</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>_TIFFmemcmp</literal></term><listitem><para>

Compare allocated memory. See <citerefentry><refentrytitle>TIFFmemory</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>_TIFFmemcpy</literal></term><listitem><para>

Copy allocated memory to another memory location. See <citerefentry><refentrytitle>

TIFFmemory</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>_TIFFmemset</literal></term><listitem><para>

Set allocated memory to known value. See <citerefentry><refentrytitle>TIFFmemory

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>_TIFFrealloc</literal></term><listitem><para>

Dynamically reallocate memory. See <citerefentry><refentrytitle>TIFFmemory

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFbuffer</literal></term><listitem><para>Specify

i/o buffer for reading or writing. See <citerefentry><refentrytitle>TIFFbuffer

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFCheckTile</literal></term><listitem><para>

Every <replaceable>x,y,z,sample</replaceable> is within image. See <citerefentry>

<refentrytitle>TIFFtile</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.

</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFClientOpen</literal></term><listitem><para>

Open a file for reading or writing. See <citerefentry><refentrytitle>TIFFOpen

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFClose</literal></term><listitem><para>Close

an open file. See <citerefentry><refentrytitle>TIFFClose</refentrytitle><manvolnum>

3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFcodec</literal></term><listitem><para>Work

with codecs. See <citerefentry><refentrytitle>TIFFcodec</refentrytitle><manvolnum>

3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFComputeStrip</literal></term><listitem><para>

Return strip containing <replaceable>x,y,z,sample</replaceable>. See <citerefentry>

<refentrytitle>TIFFstrip</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.

</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFComputeTile</literal></term><listitem><para>

Return tile containing <replaceable>y,sample</replaceable>. See <citerefentry>

<refentrytitle>TIFFtile</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.

</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFCurrentDirectory</literal></term><listitem>

<para>Return index of current directory. See <citerefentry><refentrytitle>

TIFFquery</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFCurrentRow</literal></term><listitem><para>

Return index of current scanline. See <citerefentry><refentrytitle>TIFFquery

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFCurrentStrip</literal></term><listitem><para>

Return index of current strip. See <citerefentry><refentrytitle>TIFFquery

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFCurrentTile</literal></term><listitem><para>

Return index of current tile. See <citerefentry><refentrytitle>TIFFquery</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFDefaultStripSize</literal></term><listitem>

<para>Return size of a strip. See <citerefentry><refentrytitle>TIFFstrip</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFDefaultTileSize</literal></term><listitem>

<para>Return size of a tile. See <citerefentry><refentrytitle>TIFFtile</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFError</literal></term><listitem><para>Library

error handler. See <citerefentry><refentrytitle>TIFFError</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFFdOpen</literal></term><listitem><para>Open

a file for reading or writing. See <citerefentry><refentrytitle>TIFFOpen</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFFileName</literal></term><listitem><para>

Return name of open file. See <citerefentry><refentrytitle>TIFFquery</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFFileno</literal></term><listitem><para>Return

open file descriptor. See <citerefentry><refentrytitle>TIFFquery</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFFindCODEC</literal></term><listitem><para>

Find a codec. See <citerefentry><refentrytitle>TIFFcodec</refentrytitle><manvolnum>

3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFFlush</literal></term><listitem><para>Flush

all pending writes. See <citerefentry><refentrytitle>TIFFFlush</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFFlushData</literal></term><listitem><para>

Flush pending data writes. See <citerefentry><refentrytitle>TIFFFlush</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFGetBitRevTable</literal></term><listitem>

<para>Return bit reversal table. See <citerefentry><refentrytitle>TIFFswab

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFGetField</literal></term><listitem><para>

Return tag value in current directory. See <citerefentry><refentrytitle>TIFFGetField

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFGetFieldDefaulted</literal></term><listitem>

<para>Return tag value in current directory. See <citerefentry><refentrytitle>

TIFFGetField</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFGetMode</literal></term><listitem><para>

Return open file mode. See <citerefentry><refentrytitle>TIFFquery</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFGetVersion</literal></term><listitem><para>

Return library version string. See <citerefentry><refentrytitle>TIFFquery

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFIsByteSwapped</literal></term><listitem>

<para>Return true if image data is byte-swapped. See <citerefentry><refentrytitle>

TIFFquery</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFIsMSB2LSB</literal></term><listitem><para>

Return true if image data is returned with bit 0 as the most significant bit.

See <citerefentry><refentrytitle>TIFFquery</refentrytitle><manvolnum>3tiff

</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFIsTiled</literal></term><listitem><para>

Return true if image data is tiled. See <citerefentry><refentrytitle>TIFFquery

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFIsUpSampled</literal></term><listitem><para>

Return true if image data is up-sampled. See <citerefentry><refentrytitle>

TIFFquery</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFLastDirectory</literal></term><listitem>

<para>Return a non-zero value if the current directory is the last directory

in the file. See <citerefentry><refentrytitle>TIFFquery</refentrytitle><manvolnum>

3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFmemory</literal></term><listitem><para>Manage

memory. See <citerefentry><refentrytitle>TIFFmemory</refentrytitle><manvolnum>

3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFNumberOfStrips</literal></term><listitem>

<para>Return number of strips in an image. See <citerefentry><refentrytitle>

TIFFstrip</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFNumberOfTiles</literal></term><listitem>

<para>Return number of tiles in an image. See <citerefentry><refentrytitle>

TIFFtile</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFOpen</literal></term><listitem><para>Open

a file for reading or writing. See <citerefentry><refentrytitle>TIFFOpen</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFPrintDirectory</literal></term><listitem>

<para>Print description of the current directory. See <citerefentry><refentrytitle>

TIFFPrintDirectory</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.

</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFquery</literal></term><listitem><para>Return

information about image. See <citerefentry><refentrytitle>TIFFquery

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFRasterScanlineSize</literal></term><listitem>

<para>Return size of a raster scanline. See <citerefentry><refentrytitle>

TIFFsize</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFReadBufferSetup</literal></term><listitem>

<para>Specify i/o buffer for reading. See <citerefentry><refentrytitle>TIFFbuffer

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFReadDirectory</literal></term><listitem>

<para>Read the next directory. See <citerefentry><refentrytitle>TIFFReadDirectory

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFReadEncodedStrip</literal></term><listitem>

<para>Read and decode a strip of data. See <citerefentry><refentrytitle>TIFFReadEncodedStrip

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFReadEncodedTile</literal></term><listitem>

<para>Read and decode a tile of data. See <citerefentry><refentrytitle>TIFFReadEncodedTile

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFReadRawStrip</literal></term><listitem><para>

Read a raw strip of data. See <citerefentry><refentrytitle>TIFFReadRawStrip

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFReadRawTile</literal></term><listitem><para>

Read a raw tile of data. See <citerefentry><refentrytitle>TIFFReadRawTile

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFReadRGBAImage</literal></term><listitem>

<para>Read an image into a fixed format raster. See <citerefentry><refentrytitle>

TIFFReadRGBAImage</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.

</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFReadRGBAStrip</literal></term><listitem>

<para>Read an image strip into a fixed format raster. See <citerefentry><refentrytitle>

TIFFReadRGBAStrip</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.

</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFReadRGBATile</literal></term><listitem><para>

Read an image tile into a fixed format raster. See <citerefentry><refentrytitle>

TIFFReadRGBATile</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.

</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFReadScanline</literal></term><listitem><para>

Read and decode a row of data. See <citerefentry><refentrytitle>TIFFReadScanline

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFReadTile</literal></term><listitem><para>

Read and decode a tile of data. See <citerefentry><refentrytitle>TIFFReadTile

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFRegisterCODEC</literal></term><listitem>

<para>Register a codec. See <citerefentry><refentrytitle>TIFFcodec</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFReverseBits</literal></term><listitem><para>

Reverse bits in an array of bytes. See <citerefentry><refentrytitle>TIFFswab

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFRGBAImage</literal></term><listitem><para>

Read and decode an image into a raster. See <citerefentry><refentrytitle>

TIFFRGBAImage</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.

</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFRGBAImageBegin</literal></term><listitem>

<para>Set up decoder state for <literal>TIFFRGBAImageGet</literal>. See <citerefentry>

<refentrytitle>TIFFRGBAImage</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.

</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFRGBAImageEnd</literal></term><listitem><para>

Release <literal>TIFFRGBAImage</literal> decoder state. See <citerefentry>

<refentrytitle>TIFFRGBAImage</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.

</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFRGBAImageGet</literal></term><listitem><para>

Read and decode an image. See <citerefentry><refentrytitle>TIFFRGBAImage</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFRGBAImageOK</literal></term><listitem><para>

Determine whether image is readable by <literal>TIFFRGBAImageGet</literal>.

See <citerefentry><refentrytitle>TIFFRGBAImage</refentrytitle><manvolnum>

3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFScanlineSize</literal></term><listitem><para>

Return size of a scanline. See <citerefentry><refentrytitle>TIFFsize</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFSetDirectory</literal></term><listitem><para>

Set the current directory. See <citerefentry><refentrytitle>TIFFSetDirectory

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFSetSubDirectory</literal></term><listitem>

<para>Set the current directory. See <citerefentry><refentrytitle>TIFFSetDirectory

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFSetErrorHandler</literal></term><listitem>

<para>Set error handler function. See <citerefentry><refentrytitle>TIFFError

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFSetField</literal></term><listitem><para>

Set tag value in the current directory. See <citerefentry><refentrytitle>

TIFFSetField</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFSetWarningHandler</literal></term><listitem>

<para>Set warning handler function. See <citerefentry><refentrytitle>TIFFWarning

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFsize</literal></term><listitem><para>Return

the size. See <citerefentry><refentrytitle>TIFFsize</refentrytitle><manvolnum>

3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFstrip</literal></term><listitem><para>Work

with strips. See <citerefentry><refentrytitle>TIFFstrip</refentrytitle><manvolnum>

3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFStripSize</literal></term><listitem><para>

Return size of a strip. See <citerefentry><refentrytitle>TIFFstrip</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFswab</literal></term><listitem><para>Swap

bytes. See <citerefentry><refentrytitle>TIFFswab</refentrytitle><manvolnum>

3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFSwabShort</literal></term><listitem><para>

Swap bytes of short. See <citerefentry><refentrytitle>TIFFswab</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFSwabLong</literal></term><listitem><para>

Swap bytes of long. See <citerefentry><refentrytitle>TIFFswab</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFSwabArrayOfShort</literal></term><listitem>

<para>Swap bytes of an array of shorts. See <citerefentry><refentrytitle>

TIFFswab</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFSwabArrayOfLong</literal></term><listitem>

<para>Swap bytes of an array of longs. See <citerefentry><refentrytitle>TIFFswab

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFtile</literal></term><listitem><para>Return

tile information. See <citerefentry><refentrytitle>TIFFtile</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFTileRowSize</literal></term><listitem><para>

Return size of a row in a tile. See <citerefentry><refentrytitle>TIFFtile

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFTileSize</literal></term><listitem><para>

Return size of a tile. See <citerefentry><refentrytitle>TIFFtile</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFUnregisterCODEC</literal></term><listitem>

<para>Unregister a codec. See <citerefentry><refentrytitle>TIFFcodec</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFVGetField</literal></term><listitem><para>

Return tag value in current directory. See <citerefentry><refentrytitle>TIFFGetField

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFVGetFieldDefaulted</literal></term><listitem>

<para>Return tag value in current directory. See <citerefentry><refentrytitle>

TIFFGetField</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFVSetField</literal></term><listitem><para>

Set tag value in current directory. See <citerefentry><refentrytitle>TIFFSetField

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFVStripSize</literal></term><listitem><para>

Return size of a strip. See <citerefentry><refentrytitle>TIFFstrip</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFVTileSize</literal></term><listitem><para>

Return size of a tile. See <citerefentry><refentrytitle>TIFFtile</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFWarning</literal></term><listitem><para>

Library warning handler. See <citerefentry><refentrytitle>TIFFWarning</refentrytitle>

<manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFWriteBufferSetup</literal></term><listitem>

<para>Specify i/o buffer for writing. See <citerefentry><refentrytitle>TIFFbuffer

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFWriteDirectory</literal></term><listitem>

<para>Write the current directory. See <citerefentry><refentrytitle>TIFFWriteDirectory

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFWriteEncodedStrip</literal></term><listitem>

<para>Compress and write a strip of data. See <citerefentry><refentrytitle>

TIFFWriteEncodedStrip</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.

</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFWriteEncodedTile</literal></term><listitem>

<para>Compress and write a tile of data. See <citerefentry><refentrytitle>

TIFFWriteEncodedTile</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.

</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFWriteRawStrip</literal></term><listitem>

<para>Write a raw strip of data. See <citerefentry><refentrytitle>TIFFWriteRawStrip

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFWriteRawTile</literal></term><listitem><para>

Write a raw tile of data. See <citerefentry><refentrytitle>TIFFWriteRawTile

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFWriteScanline</literal></term><listitem>

<para>Write a scanline of data. See <citerefentry><refentrytitle>TIFFWriteScanline

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>TIFFWriteTile</literal></term><listitem><para>

Compress and write a tile of data. See <citerefentry><refentrytitle>TIFFWriteTile

</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>

</listitem></varlistentry>

</variablelist></refsect2>

<refsect2 id="libtiff-3-exde-tags">

<title>Tag Usage</title>

<para>The table below lists the TIFF tags that are recognized and supported

by the <filename>&cmd;</filename> library. If no use is indicated in the table,

then the library reads and writes the tag, but does not use the tag internally.

Note that some tags are meaningful only when a particular compression scheme

is used. For example, <literal>Group3Options</literal> is only useful if Compression

is set to <literal>CCITT Group 3</literal> encoding. Tags of this sort are

considered codec-specific tags and the library does not recognize them except

when the Compression tag has been previously set to the relevant compression

scheme.</para>

<informaltable frame="all">

<tgroup cols="4" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="25*">

<colspec colname="COLSPEC1" colwidth="25*"><colspec colname="COLSPEC2" colwidth="25*">

<colspec colname="COLSPEC3" colwidth="25*">

<thead>

<row rowsep="1"><entry colsep="1" rowsep="1"><para>TAG NAME</para></entry>

<entry colsep="1" rowsep="1"><para>VALUE</para></entry><entry colsep="1" rowsep="1"><para>

R/W</para></entry><entry colsep="1" rowsep="1"><para>LIBRARY USE / NOTES</para></entry>

</row>

</thead>

<tbody>

<row><entry colsep="1" rowsep="1"><para><literal>Artist</literal></para></entry>

<entry colsep="1" rowsep="1"><para>315</para></entry><entry colsep="1" rowsep="1"><para>

R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>

<row><entry colsep="1" rowsep="1"><para><literal>BadFaxLines</literal></para></entry>

<entry colsep="1" rowsep="1"><para>326</para></entry><entry colsep="1" rowsep="1"><para>

R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>

<row><entry colsep="1" rowsep="1"><para><literal>BitsPerSample</literal></para></entry>

<entry colsep="1" rowsep="1"><para>258</para></entry><entry colsep="1" rowsep="1"><para>

R/W</para></entry><entry colsep="1" rowsep="1"><para>Lots.</para></entry>

</row>

<row><entry colsep="1" rowsep="1"><para><literal>CellLength</literal></para></entry>

<entry colsep="1" rowsep="1"><para>265</para></entry><entry colsep="1" rowsep="1"><para></para></entry>

<entry colsep="1" rowsep="1"><para>Parsed but ignored.</para></entry></row>

<row><entry colsep="1" rowsep="1"><para><literal>CellWidth</literal></para></entry>

<entry colsep="1" rowsep="1"><para>264</para></entry><entry colsep="1" rowsep="1"><para></para></entry>

<entry colsep="1" rowsep="1"><para>Parsed but ignored.</para></entry></row>

<row><entry colsep="1" rowsep="1"><para><literal>CleanFaxData</literal></para></entry>

<entry colsep="1" rowsep="1"><para>327</para></entry><entry colsep="1" rowsep="1"><para>

R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>

<row><entry colsep="1" rowsep="1"><para><literal>ColorMap</literal></para></entry>

<entry colsep="1" rowsep="1"><para>320</para></entry><entry colsep="1" rowsep="1"><para>

R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>

<row><entry colsep="1" rowsep="1"><para><literal>ColorResponseUnit</literal></para></entry>

<entry colsep="1" rowsep="1"><para>300</para></entry><entry colsep="1" rowsep="1"><para></para></entry>

<entry colsep="1" rowsep="1"><para>Parsed but ignored.</para></entry></row>

<row><entry colsep="1" rowsep="1"><para><literal>Compression</literal></para></entry>

<entry colsep="1" rowsep="1"><para>259</para></entry><entry colsep="1" rowsep="1"><para>

R/W</para></entry><entry colsep="1" rowsep="1"><para>Choosing codec.</para></entry>

</row>

<row><entry colsep="1" rowsep="1"><para><literal>ConsecutiveBadFaxLines</literal></para></entry>

<entry colsep="1" rowsep="1"><para>328</para></entry><entry colsep="1" rowsep="1"><para>

R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>

<row><entry colsep="1" rowsep="1"><para><literal>DataType</literal></para></entry>

<entry colsep="1" rowsep="1"><para>32996</para></entry><entry colsep="1" rowsep="1"><para>

R</para></entry><entry colsep="1" rowsep="1"><para>Obsoleted by <literal>

SampleFormat</literal> tag.</para></entry></row>

<row><entry colsep="1" rowsep="1"><para><literal>DateTime</literal></para></entry>

<entry colsep="1" rowsep="1"><para>306</para></entry><entry colsep="1" rowsep="1"><para>

R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>

<row><entry colsep="1" rowsep="1"><para><literal>DocumentName</literal></para></entry>

<entry colsep="1" rowsep="1"><para>269</para></entry><entry colsep="1" rowsep="1"><para>

R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>

<row><entry colsep="1" rowsep="1"><para><literal>DotRange</literal></para></entry>

<entry colsep="1" rowsep="1"><para>336</para></entry><entry colsep="1" rowsep="1"><para>

R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>

<row><entry colsep="1" rowsep="1"><para><literal>ExtraSamples</literal></para></entry>

<entry colsep="1" rowsep="1"><para>338</para></entry><entry colsep="1" rowsep="1"><para>

R/W</para></entry><entry colsep="1" rowsep="1"><para>Lots.</para></entry>

</row>

<row><entry colsep="1" rowsep="1"><para><literal>FaxRecvParams</literal></para></entry>

<entry colsep="1" rowsep="1"><para>34908</para></entry><entry colsep="1" rowsep="1"><para>

R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>

<row><entry colsep="1" rowsep="1"><para><literal>FaxSubAddress</literal></para></entry>

<entry colsep="1" rowsep="1"><para>34909</para></entry><entry colsep="1" rowsep="1"><para>

R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>

<row><entry colsep="1" rowsep="1"><para><literal>FaxRecvTime</literal></para></entry>

<entry colsep="1" rowsep="1"><para>34910</para></entry><entry colsep="1" rowsep="1"><para>

R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>

<row><entry colsep="1" rowsep="1"><para><literal>FillOrder</literal></para></entry>

<entry colsep="1" rowsep="1"><para>266</para></entry><entry colsep="1" rowsep="1"><para>

R/W</para></entry><entry colsep="1" rowsep="1"><para>Control bit order.</para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>FreeByteCounts

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

289</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para></para></entry>

<entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Parsed but ignored.

</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>FreeOffsets

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

288</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para></para></entry>

<entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Parsed but ignored.

</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>GrayResponseCurve

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

291</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para></para></entry>

<entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Parsed but ignored.

</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>GrayResponseUnit

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

290</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para></para></entry>

<entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Parsed but ignored.

</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Group3Options

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

292</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Used

by Group 3 codec.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Group4Options

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

293</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>HostComputer

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

316</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>ImageDepth

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

32997</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>

R/W</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Tile/strip

calculations.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>ImageDescription

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

270</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>ImageLength

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

257</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Lots.

</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>ImageWidth

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

256</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Lots.

</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>InkNames

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

333</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>InkSet

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

332</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>JPEGTables

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

347</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Used

by JPEG codec.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Make</literal></para></entry>

<entry colname="COLSPEC1" colsep="1" rowsep="1"><para>271</para></entry><entry

colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W</para></entry><entry colname="COLSPEC3"

colsep="1" rowsep="1"><para></para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Matteing

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

32995</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>

R</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Obsoleted

by <literal>ExtraSamples</literal> tag.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>MaxSampleValue

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

281</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>MinSampleValue

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

280</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Model

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

272</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>NewSubFileType

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

254</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Called <literal>

SubFileType</literal> in spec.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>NumberOfInks

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

334</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Orientation

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

274</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>PageName

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

285</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>PageNumber

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

297</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>PhotometricInterpretation

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

262</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Used

by Group 3 and JPEG codecs.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>PlanarConfiguration

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

284</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Data

i/o.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Predictor

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

317</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Used

by LZW and Deflate codecs.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>PrimaryChromacities

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

319</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>ReferenceBlackWhite

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

532</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>ResolutionUnit

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

296</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Used

by Group 3 codec.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>RowsPerStrip

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

278</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Data

i/o.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>SampleFormat

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

339</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>SamplesPerPixel

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

277</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Lots.

</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>SMinSampleValue

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

340</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>SMaxSampleValue

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

341</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Software

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

305</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>StoNits

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

37439</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>

R/W</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>StripByteCounts

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

279</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Data

i/o.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>StripOffsets

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

273</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Data

i/o.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>SubFileType

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

255</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Called <literal>

OSubFileType</literal> in spec.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>TargetPrinter

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

337</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Thresholding

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

263</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>TileByteCounts

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

324</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Data

i/o.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>TileDepth

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

32998</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>

R/W</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Tile/strip

calculations.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>TileLength

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

323</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Data

i/o.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>TileOffsets

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

324</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Data

i/o.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>TileWidth

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

322</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Data

i/o.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>TransferFunction

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

301</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>WhitePoint

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

318</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>XPosition

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

286</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>XResolution

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

282</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>YCbCrCoefficients

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

529</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Used

by TIFFRGBAImage support.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>YCbCrPositioning

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

531</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Tile/strip

size calulcations.</para></entry></row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>YCbCrSubsampling

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

530</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>YPosition

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

286</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>

</row>

<row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>YResolution

</literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>

283</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W

</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Used

by Group 3 codec.</para></entry></row>

</tbody>

</tgroup>

</informaltable>

</refsect2>

<refsect2 id="libtiff-3-exde-pseudo">

<title>Pseudo Tags</title>

<para>In addition to the normal TIFF tags, the <filename>&cmd;</filename>

library supports a collection of tags whose values lie in a range outside

the valid range of TIFF tags. These tags are termed pseudo-tags and are used

to control various codec-specific functions within the library. The table

below summarizes the defined pseudo-tags.</para>

<informaltable frame="all">

<tgroup cols="4" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="25*">

<colspec colname="COLSPEC1" colwidth="25*"><colspec colname="COLSPEC2" colwidth="25*">

<colspec colname="COLSPEC3" colwidth="25*">

<thead>

<row><entry colname="COLSPEC0"><para>TAG NAME</para></entry><entry colname="COLSPEC1"><para>

CODEC</para></entry><entry colname="COLSPEC2"><para>R/W</para></entry><entry

colname="COLSPEC3"><para>LIBRARY USE / NOTES</para></entry></row>

</thead>

<tbody>

<row><entry colname="COLSPEC0"><para><literal>TIFFTAG_FAXMODE</literal></para></entry>

<entry colname="COLSPEC1"><para>G3</para></entry><entry colname="COLSPEC2"><para>

R/W</para></entry><entry colname="COLSPEC3"><para>General codec operation.

</para></entry></row>

<row><entry colname="COLSPEC0"><para><literal>TIFFTAG_FAXFILLFUNC</literal></para></entry>

<entry colname="COLSPEC1"><para>G3/G4</para></entry><entry colname="COLSPEC2"><para>

R/W</para></entry><entry colname="COLSPEC3"><para>Bitmap fill function.</para></entry>

</row>

<row><entry colname="COLSPEC0"><para><literal>TIFFTAG_JPEGQUALITY</literal></para></entry>

<entry colname="COLSPEC1"><para>JPEG</para></entry><entry colname="COLSPEC2"><para>

R/W</para></entry><entry colname="COLSPEC3"><para>Compression quality control.

</para></entry></row>

<row><entry colname="COLSPEC0"><para><literal>TIFFTAG_JPEGCOLORMODE</literal></para></entry>

<entry colname="COLSPEC1"><para>JPEG</para></entry><entry colname="COLSPEC2"><para>

R/W</para></entry><entry colname="COLSPEC3"><para>Control colorspace conversions.

</para></entry></row>

<row><entry colname="COLSPEC0"><para><literal>TIFFTAG_JPEGTABLESMODE</literal></para></entry>

<entry colname="COLSPEC1"><para>JPEG</para></entry><entry colname="COLSPEC2"><para>

R/W</para></entry><entry colname="COLSPEC3"><para>Control contents of <literal>

JPEGTables</literal> tag.</para></entry></row>

<row><entry colname="COLSPEC0"><para><literal>TIFFTAG_ZIPQUALITY</literal></para></entry>

<entry colname="COLSPEC1"><para>Deflate</para></entry><entry colname="COLSPEC2"><para>

R/W</para></entry><entry colname="COLSPEC3"><para>Compression quality level.

</para></entry></row>

<row><entry colname="COLSPEC0"><para><literal>TIFFTAG_PIXARLOGDATAFMT</literal></para></entry>

<entry colname="COLSPEC1"><para>PixarLog</para></entry><entry colname="COLSPEC2"><para>

R/W</para></entry><entry colname="COLSPEC3"><para>User data format.</para></entry>

</row>

<row><entry colname="COLSPEC0"><para><literal>TIFFTAG_PIXARLOGQUALITY</literal></para></entry>

<entry colname="COLSPEC1"><para>PixarLog</para></entry><entry colname="COLSPEC2"><para>

R/W</para></entry><entry colname="COLSPEC3"><para>Compression quality level.

</para></entry></row>

<row><entry colname="COLSPEC0"><para><literal>TIFFTAG_SGILOGDATAFMT</literal></para></entry>

<entry colname="COLSPEC1"><para>SGILog</para></entry><entry colname="COLSPEC2"><para>

R/W</para></entry><entry colname="COLSPEC3"><para>User data format.</para></entry>

</row>

</tbody>

</tgroup>

</informaltable>

<refsect3 id="libtiff-3-exde-pseudo-faxmode">

<title>TIFFTAG_FAXMODE</title>

<para>Controls the operation of the Group 3 codec. Possible values (independent

bits that can be combined by or'ing them together) are: </para>

<variablelist>

<varlistentry><term><literal>FAXMODE_BYTEALIGN</literal></term><listitem>

<para>Align each encoded row to an 8-bit boundary.</para>

</listitem></varlistentry>

<varlistentry><term><literal>FAXMODE_CLASSIC</literal></term><listitem><para>

Enable old-style format in which the RTC is written at the end of the last

strip.</para>

</listitem></varlistentry>

<varlistentry><term><literal>FAXMODE_NOEOL</literal></term><listitem><para>

Do not write EOL codes at the start of each row of data.</para>

</listitem></varlistentry>

<varlistentry><term><literal>FAXMODE_NORTC</literal>, also called <literal>

FAXMODE_CLASSF</literal></term><listitem><para>Opposite of <literal>FAXMODE_CLASSIC

</literal>.</para>

</listitem></varlistentry>

<varlistentry><term><literal>FAXMODE_WORDALIGN</literal></term><listitem>

<para>Align each encoded row to a 16-bit boundary.</para>

</listitem></varlistentry>

</variablelist><para>The default value depends on the compression scheme.

This pseudo-tag is used by the various G3 and G4 codecs to share code.</para>

</refsect3>

<refsect3 id="libtiff-3-exde-pseudo-faxfillfunc">

<title>TIFFTAG_FAXFILLFUNC</title>

<para>Controls the function used to convert arrays of black and white runs

to packed bit arrays. This hook can be used to image decoded scanlines in

multi-bit depth rasters (for example, for display in colormap mode) or for

other purposes. The default value is a pointer to a builtin function that

images packed bilevel data.</para>

</refsect3>

<refsect3 status="" id="libtiff-3-exde-pseudo-iptcnewsphoto">

<title>TIFFTAG_IPTCNEWSPHOTO</title>

<para>Contains image metadata per the IPTC newsphoto specification: Headline,

captioning, credit, and so on. Used by most wire services.</para>

</refsect3>

<refsect3 id="libtiff-3-exde-pseudo-photoshop">

<title>TIFFTAG_PHOTOSHOP</title>

<para>Contains Photoshop captioning information and metadata. Photoshop uses

in parallel and redundantly alongside <literal>IPTCNEWSPHOTO</literal> information.

</para>

</refsect3>

<refsect3 id="libtiff-3-exde-pseudo-jpegquality">

<title>TIFFTAG_JPEGQUALITY</title>

<para>Controls the compression quality level used in the baseline algorithm.

Note that quality levels are in the range 0-100 with a default value of 75.

</para>

</refsect3>

<refsect3 id="libtiff-3-exde-pseudo-jpegcolormode">

<title>TIFFTAG_JPEGCOLORMODE</title>

<para>Controls whether or not conversion is done between RGB and YCbCr colorspaces.

Possible values are: <literal>JPEGCOLORMODE_RAW</literal> (do not convert),

and <literal>JPEGCOLORMODE_RGB</literal> (convert to/from RGB). The default

value is <literal>JPEGCOLORMODE_RAW</literal>.</para>

</refsect3>

<refsect3 id="libtiff-3-exde-pseudo-jpegtablesmode">

<title>TIFFTAG_JPEGTABLESMODE</title>

<para>Controls the information written in the <literal>JPEGTables</literal>

tag. Possible values (independent bits that can be combined by or'ing them

together) are: <literal>JPEGTABLESMODE_QUANT</literal> (include quantization

tables), and <literal>JPEGTABLESMODE_HUFF</literal> (include Huffman encoding

tables).</para>

</refsect3>

<refsect3 id="libtiff-3-exde-pseudo-zipquality">

<title>TIFFTAG_ZIPQUALITY</title>

<para>Controls the compression technique used by the Deflate codec. Quality

levels are in the range 1-9 with larger numbers yielding better compression

at the cost of more computation. The default quality level is 6 which yields

a good time-space tradeoff.</para>

</refsect3>

<refsect3 id="libtiff-3-exde-pseudo-pixarlogdatafmt">

<title>TIFFTAG_PIXARLOGDATAFMT</title>

<para>Controls the format of user data passed to the PixarLog codec when encoding

and passed from the PixarLog codec when decoding. Possible values are:</para>

<itemizedlist>

<listitem><para><literal>PIXARLOGDATAFMT_8BIT</literal> for 8-bit unsigned

pixels</para></listitem>

<listitem><para><literal>PIXARLOGDATAFMT_8BITABGR</literal> for 8-bit unsigned

ABGR-orderedpixels</para></listitem>

<listitem><para><literal>PIXARLOGDATAFMT_11BITLOG</literal> for 11-bit log-encoded

raw data</para></listitem>

<listitem><para><literal>PIXARLOGDATAFMT_12BITPICIO</literal> for 12-bit PICIO-compatible

data</para></listitem>

<listitem><para><literal>PIXARLOGDATAFMT_16BIT</literal> for 16-bit signed

samples</para></listitem>

<listitem><para><literal>PIXARLOGDATAFMT_FLOAT</literal> for 32-bit IEEE floating

point samples</para></listitem>

</itemizedlist>

</refsect3>

<refsect3 id="libtiff-3-exde-pseudo-pixarlogquality">

<title>TIFFTAG_PIXARLOGQUALITY</title>

<para>Controls the compression technique used by the PixarLog codec. This

value is treated identically to <literal>TIFFTAG_ZIPQUALITY</literal>.</para>

</refsect3>

<refsect3 id="libtiff-3-exde-pseudo-sgilogdatafmt">

<title>TIFFTAG_SGILOGDATAFMT</title>

<para>Controls the format of client data passed to the SGILog codec when encoding

and passed from the SGILog codec when decoding. Possible values are:</para>

<itemizedlist>

<listitem><para><literal>SGILOGDATAFMT_FLTXYZ</literal> for converting between

LogLuv and 32-bit IEEE floating valued XYZ pixels</para></listitem>

<listitem><para><literal>SGILOGDATAFMT_16BITLUV</literal> for 16-bit encoded

Luv pixels</para></listitem>

<listitem><para><literal>SGILOGDATAFMT_32BITRAW</literal> and <literal>SGILOGDATAFMT_24BITRAW

</literal> for no conversion of data</para></listitem>

<listitem><para><literal>SGILOGDATAFMT_8BITRGB</literal> for returning 8-bit

RGB data (valid only when decoding LogLuv-encoded data)</para></listitem>

<listitem><para><literal>SGILOGDATAFMT_FLTY</literal> for converting between

LogL and 32-bit IEEE floating valued Y pixels</para></listitem>

<listitem><para><literal>SGILOGDATAFMT_16BITL</literal> for 16-bit encoded

L pixels</para></listitem>

<listitem><para><literal>SGILOGDATAFMT_8BITGRY</literal> for returning 8-bit

greyscale data (valid only when decoding LogL-encoded data)</para></listitem>

</itemizedlist>

</refsect3>

</refsect2>

<refsect2 id="libtiff-3-exde-diags">

<title>Diagnostics</title>

<para>All error messages are directed through the <literal>TIFFError</literal>

routine. By default, messages are directed to <literal>stderr</literal> in

the form: <literal><replaceable>module</replaceable>: <replaceable>message

</replaceable>\\n</literal>. Warning messages are likewise directed through

the TIFFWarning routine.</para>

</refsect2>

</refsect1>

<refsect1 id="libtiff-3-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="libtiff-3-also"><title>&also-tt;</title>

<para>

<citerefentry><refentrytitle>fax2tiff</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>gif2tiff</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>pal2rgb</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>ppm2tiff</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>ras2tiff</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>rgb2ycbcr</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>sgi2tiff</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>tiff2bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>tiffcmp</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>tiffcp</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>tiffdither</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>tiffdump</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>tiffgt</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>tiffinfo</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>tiffmedian</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>tiffsplit</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>tiffsv</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>

</para>

<para><citetitle>Tag Image File Format Specification</citetitle> Revision

6.0, an Aldus Technical Memorandum.</para>

<para><citetitle>The Spirit of TIFF Class F</citetitle> an appendix to the

TIFF 5.0 specification prepared by Cygnet Technologies.</para>

</refsect1>

<refsect1 id="libtiff-3-note"><title>&note-tt;</title>

<para>The <filename>&cmd;</filename> library does not support multisample

images where some samples have different bits/sample.</para>

<para>The library does not support random access to compressed data that is

organized with more than one row per tile or strip. The library discards unknown

tags. The library should do more validity checking of a directory's contents.

</para>

<para>This man page was originally written by Sam Leffler. Updated by Breda

McColgan, Sun Microsystems Inc., 2004.</para>

</refsect1>

</refentry>