mediaLib Library Functions         mlibImageChannelInsert(3MLIB)



NAME
     mlibImageChannelInsert - channel insert

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

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


DESCRIPTION
     In the mlibImageChannelInsert() function, all N channels in
     the  source  image  are copied into the selected channels in
     the destination image, where N is the number of channels  in
     the source image. If more than N channels are selected, then
     the leftmost N channels are inserted. If less than  N  chan-
     nels are selected, then the function returns failure status.
     The channel mask is defined with respect to the  destination
     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         mlibImageChannelInsert(3MLIB)



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


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









































SunOS 5.11           Last change: 2 Mar 2007                    2