iflFIT(3)	  Image	Format Library C++ Reference Manual	     iflFIT(3)

NAME    [Toc]    [Back]

     iflFIT - FIT file format

HEADER FILE    [Toc]    [Back]

     #include <ifl/iflFIT.h>

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     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 userextension
 portion of the FIT file.	This tag is also supported with
     setItem().

TAG VALUES FOR SET ITEM    [Toc]    [Back]

     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    [Toc]    [Back]

     iflFile, ilFileImg


									PPPPaaaaggggeeee 2222