1mlib_ImageAffine_Fp(3MLIB)mediaLib Library Functionsmlib_ImageAffine_Fp(3MLIB)
2
3
4

NAME

6       mlib_ImageAffine_Fp - image affine transformation
7

SYNOPSIS

9       cc [ flag... ] file... -lmlib [ library... ]
10       #include <mlib.h>
11
12       mlib_status mlib_ImageAffine_Fp(mlib_image *dst, const mlib_image *src,
13            const mlib_d64 *mtx, mlib_filter filter, mlib_edge edge);
14
15

DESCRIPTION

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

PARAMETERS

40       The function takes the following arguments:
41
42       dst       Pointer to destination image.
43
44
45       src       Pointer to source image.
46
47
48       mtx       Transformation matrix. mtx[0] holds a; mtx[1] holds b; mtx[2]
49                 holds tx; mtx[3] holds c; mtx[4] holds d; mtx[5] holds ty.
50
51
52       filter    Type of resampling filter. It can be one of the following:
53
54                   MLIB_NEAREST
55                   MLIB_BILINEAR
56                   MLIB_BICUBIC
57                   MLIB_BICUBIC2
58
59
60
61       edge      Type of edge condition. It can be one of the following:
62
63                   MLIB_EDGE_DST_NO_WRITE
64                   MLIB_EDGE_DST_FILL_ZERO
65                   MLIB_EDGE_OP_NEAREST
66                   MLIB_EDGE_SRC_EXTEND
67                   MLIB_EDGE_SRC_PADDED
68
69
70

RETURN VALUES

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

ATTRIBUTES

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

SEE ALSO

90       mlib_ImageAffine(3MLIB),                  mlib_ImageAffineIndex(3MLIB),
91       mlib_ImageAffineTransform(3MLIB),  mlib_ImageAffineTransform_Fp(3MLIB),
92       mlib_ImageAffineTransformIndex(3MLIB),    mlib_ImageSetPaddings(3MLIB),
93       attributes(5)
94
95
96
97SunOS 5.11                        2 Mar 2007        mlib_ImageAffine_Fp(3MLIB)
Impressum