mediaLib Library Functions           mlibImageScalarBlend(3MLIB)



NAME
     mlibImageScalarBlend - image blending with scalar

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

     mlibstatus mlibImageScalarBlend(mlibimage dst, const mlibimage *src1,
          const mlibimage *src2, const mlibs32 *alpha);


DESCRIPTION
     The mlibImageScalarBlend() function blends  the  first  and
     second  source images by adding each of their scaled pixels.
     The first source image is scaled by the scalar  a,  and  the
     second source image is inverse scaled by (1 - a).


     It uses the following equation:

       dst[x][y][i] = a[i]*src1[x][y][i] ] (1 - a[i])*src2[x][y][i]


PARAMETERS
     The function takes the following arguments:

     dst      Pointer to destination image.


     src1     Pointer to first source image.


     src2     Pointer to second source image.


     alpha    Scalar blending factor. The a value equals (alpha *
              2**(-31)).  alpha[i]  contains  the blending factor
              for channel i.


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           mlibImageScalarBlend(3MLIB)



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


SEE ALSO
     mlibImageScalarBlendFp(3MLIB),
     mlibImageScalarBlendFpInp(3MLIB),
     mlibImageScalarBlendInp(3MLIB), attributes(5)










































SunOS 5.11           Last change: 2 Mar 2007                    2