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