libimp(3)

LIBRARY DESCRIPTION
     libimp provides a C Language application programming interface (API) for
     reading and writing Silicon Graphics Image Format files and for
     performing a number of format independent image processing operations.
     These format independent operations include color space conversion and
     filtered image zooming.

     libimp provides all functionality of the libimage library. In addition,
     libimp provides function prototypes, a documented interface, reliable
     error reporting and a number of other enhancements.

LIBRARY ACCESS
     A program that calls libimp functions must include the imp.h header file
     located in the /usr/include directory. In addition, the program must link
     with the libimp.a library located in /usr/lib. The link line would look
     like:

      ... -limp ...

FUNCTIONS
     The libimp library consists of two main sets of functions. The first set
     of functions performs operations on SGI Image Format files. The second
     set of functions performs operations on image data in a format
     independent manner.

     SGI IMAGE FORMAT FILE FUNCTIONS

     Image Access
               impOpen
               impOpenFd
               impOpenBuf
               impOpenExt
               impOpenFdExt
               impOpenBufExt
               impClose
               impCloseFd

     Image I/O
               impReadRow
               impReadRowB
               impWriteRow
               impWriteRowB


     FORMAT INDEPENDENT FUNCTIONS

     Zooming
               impCreateZoom
               impDestroyZoom
               impResetZoom
               impZoomRow
     Data Packing
               impPackRow
               impUnpackRow

     Math Operations
               impZeroRow
               impInitRow
               impCopyRow
               impSAddRow
               impVAddRow
               impSSubRow
               impVSubRow
               impSMulRow
               impSDivRow
               impClampRow

     Color Space Conversion
               impRGBtoW       impWtoRGB
               impRGBtoK       impKtoRGB
               impRGBtoCMY     impCMYtoRGB
               impRGBtoYIQ     impYIQtoRGB
               impRGBtoYUV     impYUVtoRGB
               impRGBtoYCbCr   impYCbCrtoRGB
               impRGBtoCMYK    impCMYKtoRGB
               impRGBtoDevCMYK
               impRGBtoHSV     impHSVtoRGB
               impRGBtoHLS     impHLStoRGB

     Error Handling
               impPerror
               impErrorString

ACKNOWLEDGEMENTS
     The libimp library is based heavily on the libimage and libgutil
     libraries. These libraries have been available as gifts for a number of
     years on SGI workstations. The principal author of these libraries is
     Paul Haeberli. The zooming code is adapted from the libgutil izoom code
     written by Paul Haeberli and Paul Heckbert.