Manual Pages for UNIX Operating System command usage for man mlib_ImageBlend2_Fp_Inp

mediaLib Library Functions         mlib_ImageBlend2_Fp_Inp(3MLIB)



NAME
     mlib_ImageBlend2_Fp_Inp - blend with an alpha image

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

     mlib_status mlib_ImageBlend2_Fp_Inp(mlib_image *src2dst,
          const mlib_image *src1, const mlib_image *alpha);


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


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

       src2dst[x][y][i] = alpha[x][y][0]*src1[x][y][i] +
                          (1 - alpha[x][y][0])*src2dst[x][y][i]



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

       src2dst[x][y][i] = alpha[x][y][i]*src1[x][y][i] +
                          (1 - alpha[x][y][i])*src2dst[x][y][i]



     It uses the following equation:




PARAMETERS
     The function takes the following arguments:

     src2dst    Pointer to second source and destination image.


     src1       Pointer to first source image.


     alpha      Alpha image used to control blending. The  pixels
                in  this image should have values in the range of



SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions         mlib_ImageBlend2_Fp_Inp(3MLIB)



                [0.0, 1.0].


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_ImageBlend(3MLIB),           mlib_ImageBlend_Fp(3MLIB),
     mlib_ImageBlend1_Fp_Inp(3MLIB), mlib_ImageBlend1_Inp(3MLIB),
     mlib_ImageBlend2_Inp(3MLIB), attributes(5)





























SunOS 5.11           Last change: 2 Mar 2007                    2