1mlib_ImageRotate_Fp(3MLIB)mediaLib Library Functionsmlib_ImageRotate_Fp(3MLIB)
2
3
4
6 mlib_ImageRotate_Fp - rotate image
7
9 cc [ flag... ] file... -lmlib [ library... ]
10 #include <mlib.h>
11
12 mlib_status mlib_ImageRotate_Fp(mlib_image *dst, const mlib_image *src,
13 mlib_d64 angle, mlib_d64 xcenter, mlib_d64 ycenter, mlib_filter filter,
14 mlib_edge edge);
15
16
18 The mlib_ImageRotate_Fp() function rotates a floating-point source
19 image around a user-defined rotation center in the user-defined radi‐
20 ans.
21
22
23 The width and height of the destination image can be different from the
24 width and height of the source image. The (xcenter, ycenter) point of
25 the source image is mapped to the center of the destination image. You
26 should ensure that the destination buffer is large enough to hold the
27 resulting bounding box to avoid clipping part of the image.
28
29
30 The center of the upper-left corner pixel of an image is located at
31 (0.5, 0.5).
32
34 The function takes the following arguments:
35
36 dst Pointer to destination image.
37
38
39 src Pointer to source image.
40
41
42 angle Angle of rotation. The angle is measured in radians clock‐
43 wise.
44
45
46 xcenter X coordinate of rotation center in the source image.
47
48
49 ycenter Y coordinate of rotation center in the source image.
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
72 The function returns MLIB_SUCCESS if successful. Otherwise it returns
73 MLIB_FAILURE.
74
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
90 mlib_ImageRotate(3MLIB), mlib_ImageRotateIndex(3MLIB), attributes(5)
91
92
93
94SunOS 5.11 2 Mar 2007 mlib_ImageRotate_Fp(3MLIB)