opensolaris man page for mlib_imageinterptablecreate

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 subsampleBitsH, 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	     |Committed 		   |
       +-----------------------------+-----------------------------+
       |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.11							    2 Mar 2007					mlib_ImageInterpTableCreate(3MLIB)