mlib_ImageChannelSplit(3MLmediaLib Library Functimlib_ImageChannelSplit(3MLIB)NAMEmlib_ImageChannelSplit - channel split
SYNOPSIS
cc [ flag... ] file... -lmlib [ library... ]
#include <mlib.h>
mlib_status mlib_ImageChannelSplit(mlib_image **dsts,
const mlib_image *src);
DESCRIPTION
The mlib_ImageChannelSplit() function converts a multi-channel image
into an array of single-channel images.
A0 A1 A2 ...
A0 B0 C0 A1 B1 C1 A2 B2 C2 ... ===> B0 B1 B2 ...
C0 C1 C2 ...
All images must have the same type, same width, and same height. The
data type of the images can be MLIB_BYTE, MLIB_SHORT, MLIB_USHORT,
MLIB_INT, MLIB_FLOAT, or MLIB_DOUBLE. The source image must have the
number of channels equal to the number of images in the dsts array. The
destination images must be single-channel images.
PARAMETERS
The function takes the following arguments:
dsts Pointer to an array of single-channel destination images.
src Pointer to a multi-channel source image.
RETURN VALUES
The function returns MLIB_SUCCESS if successful. Otherwise it returns
MLIB_FAILURE.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOmlib_ImageChannelCopy(3MLIB), mlib_ImageChannelExtract(3MLIB),
mlib_ImageChannelInsert(3MLIB), mlib_ImageChannelMerge(3MLIB),
attributes(5)SunOS 5.10 2 Mar 2007 mlib_ImageChannelSplit(3MLIB)