iflTIFF(3)

NAME

iflTIFF - a TIFF formatted image file

HEADER FILE

#include <ifl/iflTIFF.h>

DESCRIPTION

The Image Format Library provides support for reading and writing image files with the Tag Image File format (TIFF), Revision 6.0. This file format is suitable for archiving multicolor and monochromatic image data.

As specified by the TIFF Compression field, iflTIFF supports several compression algorithms, including:

no compression,
Group 3 Facsimile compression,
Group 4 Facsimile compression,
Lemple-Ziv & Welch compression,
PackBits compression, and
JPEG compression.

iflTIFF also uses the following TIFF 6.0 extensions:

Tilewidth (tag = 322)
Tilelength (tag = 323)
SampleFormat (tag = 339)

These tags provide the necessary support for the image data types and tiles as defined by IL. N.B. The TIFF 6.0 tile extensions Tilewidth and Tilelength restrict their values to be multiples of 16.

To provide the full flexibility of the IL model, additional extensions have also been made to iflTIFF. Two new fields, Imagedepth (tag 32997) and Tiledepth (tag 32998) have been added to define image depth (IL's z dimension).

The default extensions for image files in the TIFF format are '.tif' and '.tiff'. When you create a file with that extension IFL will assume you want the TIFF format, unless you override it with the iflFormat parameter.

In addition to all the standard iflFile methods, this format supprts an number of format specific operations via the getItem() and setItem() methods. The tag values supported by these methods are enumerated in the following sections.

TAG VALUES FOR GET ITEM

The getItem() function is used to retrieve any of the TIFF 6.0 fields as defined in the /usr/include/il/ilTIFF.h file.

TAG VALUES FOR SET ITEM

The setItem() function is used to set any of the TIFF fields with the exception of:

TIFFTAG_IMAGEWIDTH      TIFFTAG_IMAGELENGTH
TIFFTAG_BITSPERSAMPLE      TIFFTAG_SAMPLESPERPIXEL
TIFFTAG_ROWSPERSTRIP      TIFFTAG_TILEWIDTH
TIFFTAG_TILELENGTH      TIFFTAG_TILEDEPTH
TIFFTAG_DATATYPE      TIFFTAG_IMAGEDEPTH
TIFFTAG_PLANARCONFIG      TIFFTAG_COLORMAP TIFFTAG_SAMPLEFORMAT

SEE ALSO

iflFile, ilFileImg, "TIFF 6.0 Specification"