Manual Pages for UNIX Operating System command usage for man mlib_ImageBlendColor_Inp

mediaLib Library Functions        mlib_ImageBlendColor_Inp(3MLIB)



NAME
     mlib_ImageBlendColor_Inp - blend an image and  a  color,  in
     place

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

     mlib_status mlib_ImageBlendColor_Inp(mlib_image *srcdst,
          const mlib_s32 *color, mlib_s32 cmask);


DESCRIPTION
     The mlib_ImageBlendColor_Inp() function blends an image  and
     a color with the alpha channel.


     It uses the following equation:

       Cd = Cs*As + Cc*(1 - As)
       Ad = 1.0



     where, Cs and Cd are the RGB color components of the  source
     and  destination  images,  respectively.   As and Ad are the
     alpha components  of  the  source  and  destination  images,
     respectively.  Cc  is  the  color  component of the constant
     color.


     For MLIB_BYTE images, the alpha coefficients are in Q8  for-
     mat.  For  MLIB_SHORT  images, the alpha coefficients are in
     Q15 format and must be positive.   For  MLIB_USHORT  images,
     the  alpha  coefficients  are  in  Q16 format.  For MLIB_INT
     images, the alpha coefficients are in Q31 format and must be
     positive.


     The images can have two to  four  channels.  The  length  of
     color  array must not be less than the number of channels in
     the images.

PARAMETERS
     The function takes the following arguments:

     srcdst    Pointer to the source and destination image.


     color     Array of constant color components.





SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions        mlib_ImageBlendColor_Inp(3MLIB)



     cmask     Channel mask to indicate the alpha  channel.  Each
               bit  of  cmask  represents a channel in the image.
               The channel corresponding to the highest bit  with
               value 1 is the alpha channel.


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:



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


SEE ALSO
     mlib_ImageBlendColor(3MLIB), mlib_ImageBlendColor_Fp(3MLIB),
     mlib_ImageBlendColor_Fp_Inp(3MLIB), attributes(5)



























SunOS 5.11           Last change: 2 Mar 2007                    2