mlib_ImageChannelSplit(3MLIB)

Name

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:

See also

mlib_ImageChannelCopy(3MLIB), mlib_ImageChannelExtract(3MLIB), mlib_ImageChannelInsert(3MLIB), mlib_ImageChannelMerge(3MLIB), attributes(5)