Manual Pages for UNIX Operating System command usage for man mlib_ImageInterpTableCreate

mediaLib Library Functions     mlib_ImageInterpTableCreate(3MLIB)



NAME
     mlib_ImageInterpTableCreate - creates an interpolation table

SYNOPSIS
     cc [ flag... ] file... -lmlib [ library... ]
     #include 

     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 inter-
     polation table based on prameters spedified.


     This function creates an internal data structure, an  inter-
     polation  table,  which  can be used by some image geometric
     functions  for  implementing  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.






SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions     mlib_ImageInterpTableCreate(3MLIB)



     width             Width of the interpolation kernel in  pix-
                       els.


     height            Height of the interpolation kernel in pix-
                       els.


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


     topPadding        Number of pixels lying above the  interpo-
                       lation kernel key position.


     subsampleBitsH    Numbers of bits used  for  the  horizontal
                       subsample position.


     subsampleBitsV    Numbers of bits used for the vertical sub-
                       sample 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  attri-
     butes:















SunOS 5.11           Last change: 2 Mar 2007                    2






mediaLib Library Functions     mlib_ImageInterpTableCreate(3MLIB)



     ____________________________________________________________
    |       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           Last change: 2 Mar 2007                    3