mediaLib Library Functions     mlibImageBlendColorFpInp(3MLIB)



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

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

     mlibstatus mlibImageBlendColorFpInp(mlibimage *srcdst,
          const mlibd64 *color, mlibs32 cmask);


DESCRIPTION
     The mlibImageBlendColorFpInp() 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 MLIBFLOAT and MLIBDOUBLE  images,  the  alpha  coeffi-
     cients are assumed to be in the range of [0.0, 1.0].


     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.


     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.



SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions     mlibImageBlendColorFpInp(3MLIB)



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
     mlibImageBlendColorFp(3MLIB), mlibImageBlendColor(3MLIB),
     mlibImageBlendColorInp(3MLIB), attributes(5)

































SunOS 5.11           Last change: 2 Mar 2007                    2