Manual Pages for UNIX Operating System command usage for man mlib_ImageChannelInsert

mediaLib Library Functions         mlib_ImageChannelInsert(3MLIB)



NAME
     mlib_ImageChannelInsert - channel insert

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

     mlib_status mlib_ImageChannelInsert(mlib_image *dst, const mlib_image *src,
          mlib_s32 cmask);


DESCRIPTION
     In the mlib_ImageChannelInsert() 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  MLIB_BYTE,
     MLIB_SHORT,   MLIB_USHORT,    MLIB_INT,    MLIB_FLOAT,    or
     MLIB_DOUBLE.

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 MLIB_SUCCESS if  successful.  Otherwise
     it returns MLIB_FAILURE.

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








SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions         mlib_ImageChannelInsert(3MLIB)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     mlib_ImageChannelCopy(3MLIB),
     mlib_ImageChannelExtract(3MLIB),
     mlib_ImageChannelMerge(3MLIB),
     mlib_ImageChannelSplit(3MLIB), attributes(5)









































SunOS 5.11           Last change: 2 Mar 2007                    2