iflGIF(3)

NAME
     iflGIF - GIF format image file


HEADER FILE
     #include <ifl/iflGIF.h>


DESCRIPTION
     This Image Format Library provides support to read/write image files
     stored in Compuserve Graphics Image File (GIF) format.

     The default extension for image files in the GIF format is '.gif'.  When
     you create a file with that extension IFL will assume you want the GIF
     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():


   iflGIFtransparentColor
          iflStatus getItem(iflGIFtransparentColor,
                            int* red, int* green, int* blue)


     If the GIF image being read has a transparent pixel i.e. it is intended
     that a single index value be treated as a transparent pixel, then the
     corresponding r,g,b values in the images colormap for that transparent
     index is returned in red, green and blue. If there is no transparent
     pixel then red, green and blue will be returned as -1.


   iflGIFtransparentIndex
          iflStatus getItem(iflGIFtransparentColor, int* index)


     If the GIF image being read has a transparent pixel i.e. it is intended
     that a single index value be treated as a transparent pixel, then the
     value of that transparent index is returned in index. If there is no
     transparent pixel then index will be returned as -1.


   iflGIFinterlace
          iflStatus getItem(iflGIFinterlace, int* interlaced)
     If the GIF image being read is interlaced then TRUE will be returned in
     interlaced, otherwise FALSE will be returned.


   iflGIFdelayTime
          iflStatus getItem(iflGIFdelayTime, int* delayTime)


     Returns the delay time for the current image in 1/100ths of a second or
     zero if no delay is specified.


TAG VALUES FOR SET ITEM
     The following tag values are supported with setItem():


   iflGIFtransparentIndex
          iflStatus setItem(iflGIFtransparentColor, int index)


     Set the index value of the image's transparent pixel to index.


   iflGIFinterlace
          iflStatus setItem(iflGIFinterlace, int interlaced)


     If interlaced = TRUE, then the GIF image produced will be interlaced;
     otherwise not.


   iflGIFdelayTime
          iflStatus setItem(iflGIFdelayTime, int delayTime)


     Sets the delay time for the current image in 1/100ths of a second.


SEE ALSO
     iflFile, ilFileImg