iflFIT(3) Image Format Library C++ Reference Manual iflFIT(3)NAMEiflFIT - 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
Page 1
iflFIT(3) Image Format Library C++ Reference Manual iflFIT(3)
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
Page 2
