mediaLib Library Functions         mlibImageBlend1FpInp(3MLIB)



NAME
     mlibImageBlend1FpInp - blend with an alpha image

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

     mlibstatus mlibImageBlend1FpInp(mlibimage *src1dst,
          const mlibimage *src2, const mlibimage *alpha);


DESCRIPTION
     The mlibImageBlend1FpInp()  function  blends  two  images
     together, in place, on a pixel-by-pixel basis using an alpha
     image, when alpha is also on a pixel basis. The alpha  image
     can  be  a  single-channel  image or have the same number of
     channels as the source and destination images.


     It uses the following equation when the  alpha  image  is  a
     single-channel image:

       src1dst[x][y][i] = alpha[x][y][0]*src1dst[x][y][i] ]
                          (1 - alpha[x][y][0])*src2[x][y][i]



     It uses the following equation when the alpha image has  the
     same  number  of  channels  as  the  source  and destination
     images:

       src1dst[x][y][i] = alpha[x][y][i]*src1dst[x][y][i] ]
                          (1 - alpha[x][y][i])*src2[x][y][i]


PARAMETERS
     The function takes the following arguments:

     src1dst    Pointer to first source and destination image.


     src2       Pointer to second source image.


     alpha      Alpha image used to control blending. The  pixels
                in  this image should have values in the range of
                [0.0,1.0].


RETURN VALUES
     The function returns MLIBSUCES if  successful.  Otherwise
     it returns MLIBFAILURE.



SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions         mlibImageBlend1FpInp(3MLIB)



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



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


SEE ALSO
     mlibImageBlend(3MLIB),           mlibImageBlendFp(3MLIB),
     mlibImageBlend1Inp(3MLIB), mlibImageBlend2FpInp(3MLIB),
     mlibImageBlend2Inp(3MLIB), attributes(5)




































SunOS 5.11           Last change: 2 Mar 2007                    2