mediaLib Library Functions         mlibImageBlendMultiFp(3MLIB)



NAME
     mlibImageBlendMultiFp - blend multiple images

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

     mlibstatus mlibImageBlendMultiFp(mlibimage *dst,
          const mlibimage **srcs, const mlibimage **alphas, const mlibd64 *c,
          mlibs32 n);


DESCRIPTION
     The  mlibImageBlendMultiFp()  function   blends   multiple
     source  images,  using  multiple alpha images, into a single
     destination image.


     All images involved should have the same data type and  same
     size  and  the source and destination images should have the
     same number of  channels.   The  alpha  images  should  have
     either  1  channel  or  the  same  number of channels as the
     sources and destination.  A single-channel alpha image would
     be  applied  to  all  channels  of  the corresponding source
     image.  Single and multi-channel alpha images can  be  mixed
     in the same invocation.


     It uses the following equation:

                       n-1
                       SUM {alphas[k][x][y][j] * srcs[k][x][y][i]}
                       k=0
       dst[x][y][i] = ---------------------------------------------
                       n-1
                       SUM {alphas[k][x][y][j]}
                       k=0



     or

                                 n-1
       dst[x][y][i] = c[i]    if SUM {alphas[k][x][y][j]} = 0
                                 k=0



     where j = i for  multi-channel  alpha  images;  j  =  0  for
     signle-channel alpha images.





SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions         mlibImageBlendMultiFp(3MLIB)



PARAMETERS
     The function takes the following arguments:

     dst       Pointer to destination image.


     srcs      Pointer to an array of source images.


     alphas    Pointer to an array of alpha images.


     c         Background color.


     n         Number of source images to be blended.


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
     mlibImageBlendMulti(3MLIB),         mlibImageBlend(3MLIB),
     mlibImageBlendFp(3MLIB), attributes(5)















SunOS 5.11           Last change: 2 Mar 2007                    2