mediaLib Library Functions        mlibImageChannelExtract(3MLIB)



NAME
     mlibImageChannelExtract - channel extract

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

     mlibstatus mlibImageChannelExtract(mlibimage *dst,
          const mlibimage *src, mlibs32 cmask);


DESCRIPTION
     In the mlibImageChannelExtract() function, the  selected  N
     channels in the source image are copied into the destination
     image, where N is the number of channels in the  destination
     image.  If more than N channels are selected, then the left-
     most N channels are extracted. If less than N  channels  are
     selected,  then  the  function  returns  failure status. The
     channel mask is defined with respect to  the  source  image.
     The  data  type  of  the image can be MLIBYTE, MLIBSHORT,
     MLIBUSHORT, MLIBINT, MLIBFLOAT, or MLIBDOUBLE.

PARAMETERS
     The function takes the following arguments:

     dst      Pointer to a destination image.


     src      Pointer to a source image.


     cmask    Source or destination channel selection mask.  Each
              bit  of  the mask represents a channel in the image
              data. The least significant bit (LSB) of  the  mask
              corresponds  to the last channel in the image data.
              A bit with a value of 1 indicates that the  channel
              is selected.


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        mlibImageChannelExtract(3MLIB)



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


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









































SunOS 5.11           Last change: 2 Mar 2007                    2