mlib_ImageInterpTableCreatmediaLib Library Fmlib_ImageInterpTableCreate(3MLIB)NAMEmlib_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 ta‐
ble based on prameters spedified.
This function creates an internal data structure, an interpolation ta‐
ble, which can be used by some image geometric functions for implement‐
ing 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**subsam‐
pleBitsH + width - 1] holds the coefficient for the rightmost neighbor‐
ing 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 interpola‐
tion 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 posi‐
tion.
precisionBits Number of fractional bits used to describe the coef‐
ficients.
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 ALSOmlib_ImageInterpTableDelete(3MLIB), mlib_ImageAffineTable(3MLIB),
mlib_ImageZoomTranslateTable(3MLIB), mlib_ImageGridWarpTable(3MLIB),
mlib_ImagePolynomialWarpTable(3MLIB), attributes(5)SunOS 5.10 2 Mar 2007mlib_ImageInterpTableCreate(3MLIB)