1mlib_ImageChannelInsert(3MLmIeBd)iaLib Library Functimolnisb_ImageChannelInsert(3MLIB)
2
3
4

NAME

6       mlib_ImageChannelInsert - channel insert
7

SYNOPSIS

9       cc [ flag... ] file... -lmlib [ library... ]
10       #include <mlib.h>
11
12       mlib_status mlib_ImageChannelInsert(mlib_image *dst, const mlib_image *src,
13            mlib_s32 cmask);
14
15

DESCRIPTION

17       In the mlib_ImageChannelInsert() function, all N channels in the source
18       image are copied into the selected channels in the  destination  image,
19       where  N  is the number of channels in the source image. If more than N
20       channels are selected, then the leftmost N channels  are  inserted.  If
21       less  than  N  channels are selected, then the function returns failure
22       status. The channel mask is defined with  respect  to  the  destination
23       image.  The  data  type  of  the  image  can  be MLIB_BYTE, MLIB_SHORT,
24       MLIB_USHORT, MLIB_INT, MLIB_FLOAT, or MLIB_DOUBLE.
25

PARAMETERS

27       The function takes the following arguments:
28
29       dst      Pointer to a destination image.
30
31
32       src      Pointer to a source image.
33
34
35       cmask    Source or destination channel selection mask. Each bit of  the
36                mask represents a channel in the image data. The least signif‐
37                icant bit (LSB) of the mask corresponds to the last channel in
38                the  image  data.  A  bit with a value of 1 indicates that the
39                channel is selected.
40
41

RETURN VALUES

43       The function returns MLIB_SUCCESS if successful. Otherwise  it  returns
44       MLIB_FAILURE.
45

ATTRIBUTES

47       See attributes(5) for descriptions of the following attributes:
48
49
50
51
52       ┌─────────────────────────────┬─────────────────────────────┐
53       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
54       ├─────────────────────────────┼─────────────────────────────┤
55       │Interface Stability          │Committed                    │
56       ├─────────────────────────────┼─────────────────────────────┤
57       │MT-Level                     │MT-Safe                      │
58       └─────────────────────────────┴─────────────────────────────┘
59

SEE ALSO

61       mlib_ImageChannelCopy(3MLIB),          mlib_ImageChannelExtract(3MLIB),
62       mlib_ImageChannelMerge(3MLIB),           mlib_ImageChannelSplit(3MLIB),
63       attributes(5)
64
65
66
67SunOS 5.11                        2 Mar 2007    mlib_ImageChannelInsert(3MLIB)
Impressum