mediaLib Library Functions            mlibImageBlendMulti(3MLIB)



NAME
     mlibImageBlendMulti - blend multiple images

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

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


DESCRIPTION
     The mlibImageBlendMulti() function blends  multiple  source
     images,  using multiple alpha images, into a single destina-
     tion 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.

PARAMETERS




SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions            mlibImageBlendMulti(3MLIB)



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
















SunOS 5.11           Last change: 2 Mar 2007                    2