1mlib_ImageInterpTableCreatem(e3dMiLaILBi)b Library Fumnlcitbi_oInmsageInterpTableCreate(3MLIB)
2
3
4

NAME

6       mlib_ImageInterpTableCreate - creates an interpolation table
7

SYNOPSIS

9       cc [ flag... ] file... -lmlib [ library... ]
10       #include <mlib.h>
11
12       void *mlib_ImageInterpTableCreate(mlib_type type, mlib_s32 width,
13            mlib_s32 height, mlib_s32 leftPadding, mlib_s32 topPadding,
14            mlib_s32 subsampleBitsH, mlib_s32 subsampleBitsV,
15            mlib_s32 precisionBits, const void *dataH, const void *dataV);
16
17

DESCRIPTION

19       The mlib_ImageInterpTableCreate() function creates an interpolation ta‐
20       ble based on prameters spedified.
21
22
23       This function creates an internal data structure, an interpolation  ta‐
24       ble, which can be used by some image geometric functions for implement‐
25       ing a table-driven interpolation algorithm.
26
27
28       The parameter type defines the type of dataH/dataV input arrays and can
29       be   MLIB_BYTE,   MLIB_SHORT,  MLIB_USHORT,  MLIB_INT,  MLIB_FLOAT,  or
30       MLIB_DOUBLE.
31
32
33       The dataH array should have at least  width*2**subsampleBitsH  entries.
34       dataH[i*2**subsampleBitsH]  holds  the  coefficient  for  the  leftmost
35       neighboring pixel, dataH[i*2**subsampleBitsH + 1] holds the coefficient
36       for the second neighboring pixel from left, ..., and dataH[i*2**subsam‐
37       pleBitsH + width - 1] holds the coefficient for the rightmost neighbor‐
38       ing pixel, where i = 0, 1, 2, ..., 2**subsampleBitsH - 1.
39
40
41       The  dataV  array should have at least height*2**subsampleBitsV entries
42       or should be NULL.  If dataV is NULL, then dataH is used in its  place,
43       and  in this case the parameters topPadding, height, and subsampleBitsV
44       are ignored.
45

PARAMETERS

47       The function takes the following arguments:
48
49       type              Data type of the coefficients.
50
51
52       width             Width of the interpolation kernel in pixels.
53
54
55       height            Height of the interpolation kernel in pixels.
56
57
58       leftPadding       Number of pixels lying to the left of the  interpola‐
59                         tion kernel key position.
60
61
62       topPadding        Number of pixels lying above the interpolation kernel
63                         key position.
64
65
66       subsampleBitsH    Numbers of bits used  for  the  horizontal  subsample
67                         position.
68
69
70       subsampleBitsV    Numbers of bits used for the vertical subsample posi‐
71                         tion.
72
73
74       precisionBits     Number of fractional bits used to describe the  coef‐
75                         ficients.
76
77
78       dataH             Pointer to horizontal coefficient data.
79
80
81       dataV             Pointer to vertical coefficient data.
82
83

RETURN VALUES

85       The function returns a pointer to an interpolation table.
86

ATTRIBUTES

88       See attributes(5) for descriptions of the following attributes:
89
90
91
92
93       ┌─────────────────────────────┬─────────────────────────────┐
94       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
95       ├─────────────────────────────┼─────────────────────────────┤
96       │Interface Stability          │Committed                    │
97       ├─────────────────────────────┼─────────────────────────────┤
98       │MT-Level                     │MT-Safe                      │
99       └─────────────────────────────┴─────────────────────────────┘
100

SEE ALSO

102       mlib_ImageInterpTableDelete(3MLIB),       mlib_ImageAffineTable(3MLIB),
103       mlib_ImageZoomTranslateTable(3MLIB),    mlib_ImageGridWarpTable(3MLIB),
104       mlib_ImagePolynomialWarpTable(3MLIB), attributes(5)
105
106
107
108SunOS 5.11                        2 Mar 2007mlib_ImageInterpTableCreate(3MLIB)
Impressum