iflBMP(3)

NAME

iflBMP - Windows bitmap format image file

HEADER FILE

#include <ifl/iflBMP.h>

DESCRIPTION

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

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)

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

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

iflFile, ilFileImg