1mlib_ImageAffineTransformInmdeedxi(a3LMiLbIBL)ibrarymlFiubn_cItmiaognesAffineTransformIndex(3MLIB)
2
3
4

NAME

6       mlib_ImageAffineTransformIndex  -  affine  transformation  on  a  color
7       indexed image, checking the matrix first
8

SYNOPSIS

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

DESCRIPTION

19       The mlib_ImageAffineTransformIndex() function does  affine  transforma‐
20       tion  on  a  color  indexed image, checking the matrix first and taking
21       advantage 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 image data type must be MLIB_BYTE or MLIB_SHORT.
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;
55                   mtx[2] holds tx; mtx[3] holds c;  mtx[4]  holds  d;  mtx[5]
56                   holds ty.
57
58
59       filter      Type of resampling filter. It can be one of the following:
60
61                     MLIB_NEAREST
62                     MLIB_BILINEAR
63                     MLIB_BICUBIC
64                     MLIB_BICUBIC2
65
66
67
68       edge        Type of edge condition. It can be one of the following:
69
70                     MLIB_EDGE_DST_NO_WRITE
71                     MLIB_EDGE_DST_FILL_ZERO
72                     MLIB_EDGE_OP_NEAREST
73                     MLIB_EDGE_SRC_EXTEND
74                     MLIB_EDGE_SRC_PADDED
75
76
77
78       colormap    Internal  data  structure  for  inverse color mapping. This
79                   data  structure  is   generated   by   the   mlib_ImageCol‐
80                   orTrue2IndexInit() function.
81
82

RETURN VALUES

84       The  function  returns MLIB_SUCCESS if successful. Otherwise it returns
85       MLIB_FAILURE.
86

ATTRIBUTES

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

SEE ALSO

102       mlib_ImageAffine(3MLIB),                    mlib_ImageAffine_Fp(3MLIB),
103       mlib_ImageAffineIndex(3MLIB),         mlib_ImageAffineTransform(3MLIB),
104       mlib_ImageAffineTransform_Fp(3MLIB), attributes(5)
105
106
107
108SunOS 5.11                        2 Mar 20m0l7ib_ImageAffineTransformIndex(3MLIB)
Impressum