1mlib_ImageZoomTranslate_Fp(m3eMdLiIaBL)ib Library Funmcltiibo_nIsmageZoomTranslate_Fp(3MLIB)
2
3
4

NAME

6       mlib_ImageZoomTranslate_Fp - zoom, with translation
7

SYNOPSIS

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

DESCRIPTION

19       The  mlib_ImageZoomTranslate_Fp()  function  will enlarge or minify the
20       floating-point source image by the X and Y zoom factors, with  transla‐
21       tion.  It  uses the interpolation method as described by the resampling
22       filter.
23
24
25       It uses the following equation for coordinate mapping:
26
27         xd = zoomx*xs + tx
28         yd = zoomy*ys + ty
29
30
31
32       where a point with coordinates (xs, ys) in the source image  is  mapped
33       to a point with coordinates (xd, yd) in the destination image.
34
35
36       The data type of the images can be MLIB_FLOAT or MLIB_DOUBLE.
37
38
39       The width and height of the destination image can be different from the
40       width and height of the source image.
41
42
43       The center of the upper-left corner pixel of an  image  is  located  at
44       (0.5, 0.5).
45

PARAMETERS

47       The function takes the following arguments:
48
49       dst       Pointer to destination image.
50
51
52       src       Pointer to source image.
53
54
55       zoomx     X zoom factor. zoomx > 0.
56
57
58       zoomy     Y zoom factor. zoomy > 0.
59
60
61       tx        X translation.
62
63
64       ty        Y translation.
65
66
67       filter    Type of resampling filter. It can be one of the following:
68
69                   MLIB_NEAREST
70                   MLIB_BILINEAR
71                   MLIB_BICUBIC
72                   MLIB_BICUBIC2
73
74
75
76       edge      Type of edge condition. It can be one of the following:
77
78                   MLIB_EDGE_DST_NO_WRITE
79                   MLIB_EDGE_DST_FILL_ZERO
80                   MLIB_EDGE_OP_NEAREST
81                   MLIB_EDGE_SRC_EXTEND
82                   MLIB_EDGE_SRC_EXTEND_INDEF
83                   MLIB_EDGE_SRC_PADDED
84
85
86

RETURN VALUES

88       The  function  returns MLIB_SUCCESS if successful. Otherwise it returns
89       MLIB_FAILURE.
90

ATTRIBUTES

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

SEE ALSO

106       mlib_ImageZoomTranslate(3MLIB),                mlib_ImageAffine(3MLIB),
107       mlib_ImageAffine_Fp(3MLIB), attributes(5)
108
109
110
111SunOS 5.11                        2 Mar 2007 mlib_ImageZoomTranslate_Fp(3MLIB)
Impressum