mediaLib Library Functions          mlibImageChannelSplit(3MLIB)



NAME
     mlibImageChannelSplit - channel split

SYNOPSIS
     cc [ flag... ] file... -lmlib [ library... ]
     #include 

     mlibstatus mlibImageChannelSplit(mlibimage **dsts,
          const mlibimage *src);


DESCRIPTION
     The  mlibImageChannelSplit()  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 MLIBYTE,
     MLIBSHORT,   MLIBUSHORT,    MLIBINT,    MLIBFLOAT,    or
     MLIBDOUBLE.  The source image must have the number of chan-
     nels 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 MLIBSUCES if  successful.  Otherwise
     it returns MLIBFAILURE.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:










SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions          mlibImageChannelSplit(3MLIB)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     mlibImageChannelCopy(3MLIB),
     mlibImageChannelExtract(3MLIB),
     mlibImageChannelInsert(3MLIB),
     mlibImageChannelMerge(3MLIB), attributes(5)









































SunOS 5.11           Last change: 2 Mar 2007                    2