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 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.

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:

See Also

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