1mlib_ImageAffineTransform_Fmpe(d3iMaLLIiBb)Library Fmulnicbt_iIomnasgeAffineTransform_Fp(3MLIB)
2
3
4

NAME

6       mlib_ImageAffineTransform_Fp  -  affine  transformation  on  an  image,
7       checking the matrix first
8

SYNOPSIS

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

DESCRIPTION

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

PARAMETERS

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

RETURN VALUES

78       The function returns MLIB_SUCCESS if successful. Otherwise  it  returns
79       MLIB_FAILURE.
80

ATTRIBUTES

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

SEE ALSO

96       mlib_ImageAffine(3MLIB),                    mlib_ImageAffine_Fp(3MLIB),
97       mlib_ImageAffineIndex(3MLIB),         mlib_ImageAffineTransform(3MLIB),
98       mlib_ImageAffineTransformIndex(3MLIB),    mlib_ImageSetPaddings(3MLIB),
99       attributes(5)
100
101
102
103SunOS 5.11                        2 Mar 2007mlib_ImageAffineTransform_Fp(3MLIB)
Impressum