mediaLib Library Functions            mlibImageBlendColor(3MLIB)



NAME
     mlibImageBlendColor - blend an image and a color

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

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


DESCRIPTION
     The mlibImageBlendColor() 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 MLIBYTE images, the alpha coefficients are in Q8  for-
     mat.  For  MLIBSHORT  images, the alpha coefficients are in
     Q15 format and must be positive. For MLIBUSHORT images, the
     alpha  coefficients  are in Q16 format. For MLIBINT images,
     the alpha coefficients are in Q31 format and must  be  posi-
     tive.


     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:

     dst      Pointer to destination image.


     src      Pointer to source image.






SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions            mlibImageBlendColor(3MLIB)



     color    Array of constant color components.


     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 MLIBSUCES if  successful.  Otherwise
     it returns MLIBFAILURE.

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



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


SEE ALSO
     mlibImageBlendColorInp(3MLIB),
     mlibImageBlendColorFp(3MLIB),
     mlibImageBlendColorFpInp(3MLIB), attributes(5)























SunOS 5.11           Last change: 2 Mar 2007                    2