iflFIT(3)

NAME

iflFIT - FIT file format

HEADER FILE

#include <ifl/iflFIT.h>

DESCRIPTION

This FIT image file format is an SGI internally-developed format, it was primarly intended as a programming example, but like most image formats has taken on a life of its own.

The FIT format supports the full flexibility of the IFL model: all data types, color models, orders, orientations and page sizes are supported. The FIT format can be especially useful with mutli-spectral imagery with large number of channels as it supports paging in the channel dimension. It can also be a handy format for storing volume data. Like all file formats supported by IFL you access FIT images via the generic object class (or the ilFileImg object for IL users).

The default extension for image files in the FIT format is '.fit'. When you create a file with that extension IFL will assume you want the FIT 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 theses methods are enumerated in the following sections.

TAG VALUES FOR GET ITEM

The followng tag values are supported with getItem():

iflFITextensionSize
iflStatus getItem(iflFITextensionSize, int* extSize)

This function returns the size in bytes of the user-extension data area in extSize.

iflFITextensionData
iflStatus getItem(iflFITextensionData, void* extData, int length)

This function is used to read length bytes of extData from the user- extension portion of the FIT file. This tag is also supported with setItem().

TAG VALUES FOR SET ITEM

The followng tag values are supported with setItem():

iflFITextensionSize
iflStatus setItem(iflFITextensionSize, int extSize)

This function can be called before any data is written to a newly-created FIT file. Calling the function will reserve extSize bytes of space for user extensions to the file format. This reserved area can then be accessed using getItem() and setItem() with the iflFITextensionData tag value.

iflFITextensionData
iflStatus setItem(iflFITextensionData, void* extData, int length)

This function is used to write length bytes of extData to the user extension portion of the FIT file. Space must be either be reserved first with the iflFITextensionSize tag or the extension data must be written before and image data is written to the file.

SEE ALSO

iflFile, ilFileImg