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

NAME    [Toc]    [Back]

     iflBMP - Windows bitmap format image file

HEADER FILE    [Toc]    [Back]

     #include <ifl/iflBMP.h>

DESCRIPTION    [Toc]    [Back]

     This Image	Format Library provides	support	to read/write image files
     stored in Windows Bitmap Image File (BMP) format.

     The default extension for image files in the BMP format is	'.bmp'.	 When
     you create	a file with that extension IFL will assume you want the	BMP
     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    [Toc]    [Back]

     The following tag values are supported with getItem():


   iflBMPHorizResolution
	  iflStatus getItem(iflBMPHorizResolution,
			    unsigned int* resolution)


     This item gets the	image's	horizontal resolution in pixels	per meter. It
     is	intended as a hint for applications that perform device	independent
     rendering.


   iflBMPVertResolution
	  iflStatus getItem(iflBMPVertResolution,
			     unsigned int* resolution)


     This item gets the	image's	vertical resolution in pixels per meter. It is
     intended as a hint	for applications that perform device independent
     rendering.


   iflBMPSignificantColors
	  iflStatus getItem(iflBMPSignificantColors,
			    unsigned int* colorCount)






									Page 1






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



     This item gets the	number of significant colors in	the image's colormap.
     It	is intended as a hint for applications that render the image to
     devices with fewer	colors than available in the colormap. It can be
     assumed that the colors presented in the colormap (see getColormap()) are
     ordered such that the significant colors appear at	the lower addresses.

TAG VALUES FOR SET ITEM    [Toc]    [Back]

     The following tag values are supported with setItem():


   iflBMPHorizResolution
	  iflStatus setItem(iflBMPHorizResolution,
			    unsigned int index)


     This item gets the	image's	horizontal resolution in pixels	per meter. It
     is	intended as a hint for applications that perform device	independent
     rendering.	If not set, the	format defaults	this value to 75 pixels	per
     inch.


   iflBMPVertResolution
	  iflStatus setItem(iflBMPVertResolution,
			    unsigned int interlaced)


     This item sets the	image's	vertical resolution in pixels per meter. It is
     intended as a hint	for applications that perform device independent
     rendering.	If not set, the	format defaults	this value to 75 pixels	per
     inch.


   iflBMPSignificantColors
	  iflStatus setItem(iflBMPSignificantColors,
			    unsigned int delayTime)


     This item gets the	number of significant colors in	the image's colormap.
     It	is intended as a hint for applications that render the image to
     devices with fewer	colors than available in the colormap. For this	to
     function properly,	the colormap (see setColormap()) must be sorted	such
     that the significant colors appear	first.

SEE ALSO    [Toc]    [Back]

     iflFile, ilFileImg


									PPPPaaaaggggeeee 2222