1mlib_ImageAffineTable_Fp(3MmLeIdBi)aLib Library Functmiloinbs_ImageAffineTable_Fp(3MLIB)
2
3
4

NAME

6       mlib_ImageAffineTable_Fp  -  affine transformation on an image with ta‐
7       ble-driven interpolation
8

SYNOPSIS

10       cc [ flag... ] file... -lmlib [ library... ]
11       #include <mlib.h>
12
13       mlib_status mlib_ImageAffineTable_Fp(mlib_image *dst,
14            const mlib_image *src, const mlib_d64 *mtx,
15            const void *interp_table, mlib_edge edge);
16
17

DESCRIPTION

19       The mlib_ImageAffineTable_Fp() function does affine transformation on a
20       floating-point image with table-driven interpolation.
21
22
23       The following equation represents the affine transformation:
24
25         xd = a*xs + b*ys + tx
26         yd = c*xs + d*ys + ty
27
28
29
30       where  a  point with coordinates (xs, ys) in the source image is mapped
31       to a point with coordinates (xd, yd) in the destination image.
32
33
34       The data type of the images can be MLIB_FLOAT or MLIB_DOUBLE.
35
36
37       The width and height of the destination image can be different from the
38       width and height of the source image.
39
40
41       The  center  of  the  upper-left corner pixel of an image is located at
42       (0.5, 0.5).
43

PARAMETERS

45       The function takes the following arguments:
46
47       dst             Pointer to destination image.
48
49
50       src             Pointer to source image.
51
52
53       mtx             Transformation matrix. mtx[0] holds a; mtx[1] holds  b;
54                       mtx[2] holds tx; mtx[3] holds c; mtx[4] holds d; mtx[5]
55                       holds ty.
56
57
58       interp_table    Pointer to an interpolation table. The table is created
59                       by the mlib_ImageInterpTableCreate() function.
60
61
62       edge            Type of edge condition. It can be one of the following:
63
64                         MLIB_EDGE_DST_NO_WRITE
65                         MLIB_EDGE_DST_FILL_ZERO
66                         MLIB_EDGE_OP_NEAREST
67                         MLIB_EDGE_SRC_EXTEND
68                         MLIB_EDGE_SRC_PADDED
69
70
71

RETURN VALUES

73       The  function  returns MLIB_SUCCESS if successful. Otherwise it returns
74       MLIB_FAILURE.
75

ATTRIBUTES

77       See attributes(5) for descriptions of the following attributes:
78
79
80
81
82       ┌─────────────────────────────┬─────────────────────────────┐
83       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
84       ├─────────────────────────────┼─────────────────────────────┤
85       │Interface Stability          │Committed                    │
86       ├─────────────────────────────┼─────────────────────────────┤
87       │MT-Level                     │MT-Safe                      │
88       └─────────────────────────────┴─────────────────────────────┘
89

SEE ALSO

91       mlib_ImageInterpTableCreate(3MLIB), mlib_ImageInterpTableDelete(3MLIB),
92       mlib_ImageAffineTable(3MLIB),                  mlib_ImageAffine(3MLIB),
93       mlib_ImageAffine_Fp(3MLIB), attributes(5)
94
95
96
97SunOS 5.11                        2 Mar 2007   mlib_ImageAffineTable_Fp(3MLIB)
Impressum