mlib_ImageInterpTableCreate(3MLIB)			    mediaLib Library Functions				mlib_ImageInterpTableCreate(3MLIB)

NAME

       mlib_ImageInterpTableCreate - creates an interpolation table

SYNOPSIS

       cc [ flag... ] file... -lmlib [ library... ]
       #include <mlib.h>

       void *mlib_ImageInterpTableCreate(mlib_type type, mlib_s32 width, mlib_s32 height, mlib_s32 leftPadding, mlib_s32 topPadding, mlib_s32 sub-
       sampleBitsH, mlib_s32 subsampleBitsV, mlib_s32 precisionBits, const void *dataH, const void *dataV);

DESCRIPTION

       The mlib_ImageInterpTableCreate() function creates an interpolation table based on prameters spedified.

       This function creates an internal data structure, an interpolation table, which can be used by some image geometric  functions  for  imple-
       menting a table-driven interpolation algorithm.

       The  parameter  type  defines  the type of dataH/dataV input arrays and can be MLIB_BYTE, MLIB_SHORT, MLIB_USHORT, MLIB_INT, MLIB_FLOAT, or
       MLIB_DOUBLE.

       The dataH array should have at least width*2**subsampleBitsH entries.  dataH[i*2**subsampleBitsH] holds the coefficient	for  the  leftmost
       neighboring  pixel,  dataH[i*2**subsampleBitsH  +  1]  holds  the  coefficient  for  the  second  neighboring  pixel  from  left,  ..., and
       dataH[i*2**subsampleBitsH + width - 1] holds the coefficient for the rightmost neighboring pixel, where i = 0, 1, 2, ..., 2**subsampleBitsH
       - 1.

       The  dataV  array  should  have	at  least height*2**subsampleBitsV entries or should be NULL.  If dataV is NULL, then dataH is used in its
       place, and in this case the parameters topPadding, height, and subsampleBitsV are ignored.

PARAMETERS

       The function takes the following arguments:

       type	       Data type of the coefficients.

       width	       Width of the interpolation kernel in pixels.

       height	       Height of the interpolation kernel in pixels.

       leftPadding     Number of pixels lying to the left of the interpolation kernel key position.

       topPadding      Number of pixels lying above the interpolation kernel key position.

       subsampleBitsH  Numbers of bits used for the horizontal subsample position.

       subsampleBitsV  Numbers of bits used for the vertical subsample position.

       precisionBits   Number of fractional bits used to describe the coefficients.

       dataH	       Pointer to horizontal coefficient data.

       dataV	       Pointer to vertical coefficient data.

RETURN VALUES

       The function returns a pointer to an interpolation table.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       mlib_ImageInterpTableDelete(3MLIB),  mlib_ImageAffineTable(3MLIB),   mlib_ImageZoomTranslateTable(3MLIB),   mlib_ImageGridWarpTable(3MLIB),
       mlib_ImagePolynomialWarpTable(3MLIB), attributes(5)

SunOS 5.10							    9 Nov 2004					mlib_ImageInterpTableCreate(3MLIB)