<meta content="groff -Thtml, see www.gnu.org" name="generator">

<meta content="text/css" name="Content-Style">

<title>INTRO</title>

INTRO

NAME

SYNOPSIS

DESCRIPTION

DATA TYPES

LIST OF ROUTINES

TAG USAGE

PSEUDO TAGS

DIAGNOSTICS

SEE ALSO

BUGS

NAME

       cols="2" cellspacing="0" cellpadding="0">

<big>libtiff − introduction to libtiff, a</big>

library for reading and writing TIFF

<big>files</big>

SYNOPSIS

       cols="2" cellspacing="0" cellpadding="0">

<big>#include <tiffio.h></big>

<big>cc file.c -ltiff</big>

DESCRIPTION

       cols="2" cellspacing="0" cellpadding="0">

<big>libtiff is a library for reading and writing</big>

data files encoded with the Tag Image File format,

Revision 6.0 (or revision 5.0 or revision 4.0). This file

format is suitable for archiving multi-color and

monochromatic image data.

<big>The library supports several compression algorithms,</big>

as indicated by the Compression field, including: no

compression (1), CCITT <big>1D Huffman compression</big>

(2), CCITT <big>Group 3 Facsimile compression</big>

(3), CCITT <big>Group 4 Facsimile compression (4),</big>

Lempel-Ziv & Welch compression (5), baseline JPEG

compression (7), word-aligned 1D Huffman compression

(32771), and PackBits compression (32773). In addition,

several nonstandard compression algorithms are supported:

the 4-bit compression algorithm used by the

ThunderScan program (32809) (decompression only),

NeXT’s 2-bit compression algorithm (32766)

(decompression only), an experimental LZ-style algorithm

known as Deflate (32946), and an experimental CIE LogLuv

compression scheme designed for images with high dynamic

range (32845 for LogL and 32845 for LogLuv). Directory

information may be in either little- or big-endian byte

order−byte swapping is automatically done by the

library. Data bit ordering may be either Most Significant

Bit ( MSB <big>) to Least Significant Bit (</big> LSB

<big>) or</big> LSB <big>to</big> MSB. <big>Finally, the</big>

library does not support files in which the

BitsPerSample, Compression,

MinSampleValue, or MaxSampleValue fields are

defined differently on a per-sample basis (in Rev. 6.0 the

Compression tag is not defined on a per-sample basis,

so this is immaterial).

DATA TYPES

       cols="2" cellspacing="0" cellpadding="0">

<big>The library makes extensive use of C typedefs to</big>

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

<big>format. The following typedefs are exposed to users</big>

either through function definitions or through parameters

passed through the varargs interfaces.

       cols="3" cellspacing="0" cellpadding="0">

<big>typedef unsigned short uint16;</big>

<big>16-bit unsigned integer</big>

<big>typedef unsigned <thing></big>

uint32;

<big>32-bit unsigned integer</big>

<big>typedef unsigned int ttag_t;</big>

<big>directory tag</big>

<big>typedef uint16 tdir_t;</big>

<big>directory index</big>

<big>typedef uint16 tsample_t;</big>

<big>sample number</big>

<big>typedef uint32 tstrip_t;</big>

<big>strip number</big>

<big>typedef uint32 ttile_t;</big>

<big>tile number</big>

<big>typedef int32 tsize_t;</big>

<big>i/o size in bytes</big>

<big>typedef void* tdata_t;</big>

<big>image data ref</big>

<big>typedef void* thandle_t;</big>

<big>client data handle</big>

<big>typedef int32 toff_t;</big>

<big>file offset</big>

       cols="2" cellspacing="0" cellpadding="0">

<big>Note that tstrip_t, ttile_t, and</big>

tsize_t are constrained to be no more than 32-bit

quantities by 32-bit fields they are stored in in the

TIFF <big>image. Likewise tsample_t is limited by the</big>

16-bit field used to store the SamplesPerPixel tag.

tdir_t constrains the maximum number of IFDs

<big>that may appear in an image and may be an arbitrary</big>

size (w/o penalty). ttag_t must be either int,

unsigned int, pointer, or double because the library uses a

varargs interface and ANSI C <big>restricts the type</big>

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

toff_t is defined as int32 because TIFF file offsets

are (unsigned) 32-bit quantities. A signed value is used

because some interfaces return −1 on error. Finally,

note that user-specified data references are passed as

opaque handles and only cast at the lowest layers where

their type is presumed.

LIST OF ROUTINES

       cols="2" cellspacing="0" cellpadding="0">

<big>The following routines are part of the library.</big>

Consult specific manual pages for details on their

operation; on most systems doing ‘‘man

function-name’’ will work.

<big>Name Description</big>

       cols="3" cellspacing="0" cellpadding="0">

<big>TIFFCheckpointDirectory</big>

<big>writes the current state of the directory</big>

<big>TIFFCheckTile</big>

<big>very x,y,z,sample is within image</big>

<big>TIFFCIELabToRGBInit</big>

<big>initialize CIE L*a*b* 1976 to RGB conversion</big>

state

<big>TIFFCIELabToXYZ</big>

<big>perform CIE L*a*b* 1976 to CIE XYZ</big>

conversion

<big>TIFFClientOpen</big>

<big>open a file for reading or writing</big>

<big>TIFFClose</big>

<big>close an open file</big>

<big>TIFFComputeStrip</big>

<big>return strip containing y,sample</big>

<big>TIFFComputeTile</big>

<big>return tile containing x,y,z,sample</big>

<big>TIFFCurrentDirectory</big>

<big>return index of current directory</big>

<big>TIFFCurrentRow</big>

<big>return index of current scanline</big>

<big>TIFFCurrentStrip</big>

<big>return index of current strip</big>

<big>TIFFCurrentTile</big>

<big>return index of current tile</big>

<big>TIFFDataWidth</big>

<big>return the size of TIFF data types</big>

<big>TIFFError</big>

<big>library error handler</big>

<big>TIFFFdOpen</big>

<big>open a file for reading or writing</big>

<big>TIFFFileName</big>

<big>return name of open file</big>

<big>TIFFFileno</big>

<big>return open file descriptor</big>

<big>TIFFFindCODEC</big>

<big>find standard codec for the specific</big>

scheme

<big>TIFFFlush</big>

<big>flush all pending writes</big>

<big>TIFFFlushData</big>

<big>flush pending data writes</big>

<big>TIFFGetBitRevTable</big>

<big>return bit reversal table</big>

<big>TIFFGetField</big>

<big>return tag value in current directory</big>

<big>TIFFGetFieldDefaulted</big>

<big>return tag value in current directory</big>

<big>TIFFGetMode</big>

<big>return open file mode</big>

<big>TIFFGetVersion</big>

<big>return library version string</big>

<big>TIFFIsCODECConfigured</big>

<big>check, whether we have working codec</big>

<big>TIFFIsMSB2LSB</big>

<big>return true if image data is being</big>

returned

<big>with bit 0 as the most significant bit</big>

<big>TIFFIsTiled</big>

<big>return true if image data is tiled</big>

<big>TIFFIsByteSwapped</big>

<big>return true if image data is byte-swapped</big>

<big>TIFFNumberOfStrips</big>

<big>return number of strips in an image</big>

<big>TIFFNumberOfTiles</big>

<big>return number of tiles in an image</big>

<big>TIFFOpen</big>

<big>open a file for reading or writing</big>

<big>TIFFPrintDirectory</big>

<big>print description of the current</big>

directory

<big>TIFFReadBufferSetup</big>

<big>specify i/o buffer for reading</big>

<big>TIFFReadDirectory</big>

<big>read the next directory</big>

<big>TIFFReadEncodedStrip</big>

<big>read and decode a strip of data</big>

<big>TIFFReadEncodedTile</big>

<big>read and decode a tile of data</big>

<big>TIFFReadRawStrip</big>

<big>read a raw strip of data</big>

<big>TIFFReadRawTile</big>

<big>read a raw tile of data</big>

<big>TIFFReadRGBAImage</big>

<big>read an image into a fixed format raster</big>

<big>TIFFReadScanline</big>

<big>read and decode a row of data</big>

<big>TIFFReadTile</big>

<big>read and decode a tile of data</big>

<big>TIFFRegisterCODEC</big>

<big>override standard codec for the specific</big>

scheme

<big>TIFFReverseBits</big>

<big>reverse bits in an array of bytes</big>

<big>TIFFRGBAImageBegin</big>

<big>setup decoder state for TIFFRGBAImageGet</big>

<big>TIFFRGBAImageEnd</big>

<big>release TIFFRGBAImage decoder state</big>

<big>TIFFRGBAImageGet</big>

<big>read and decode an image</big>

<big>TIFFRGBAImageOK</big>

<big>is image readable by TIFFRGBAImageGet</big>

<big>TIFFScanlineSize</big>

<big>return size of a scanline</big>

<big>TIFFSetDirectory</big>

<big>set the current directory</big>

<big>TIFFSetSubDirectory</big>

<big>set the current directory</big>

<big>TIFFSetErrorHandler</big>

<big>set error handler function</big>

<big>TIFFSetField</big>

<big>set a tag’s value in the current</big>

directory

<big>TIFFSetWarningHandler</big>

<big>set warning handler function</big>

<big>TIFFStripSize</big>

<big>returns size of a strip</big>

<big>TIFFRawStripSize</big>

<big>returns the number of bytes in a raw</big>

strip

<big>TIFFSwabShort</big>

<big>swap bytes of short</big>