mediaLib Library Functions             mlibImageZoomBlend(3MLIB)



NAME
     mlibImageZoomBlend - image scaling with alpha blending

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

     mlibstatus mlibImageZoomBlend(mlibimage *dst, const mlibimage *src,
          mlibd64 zoomx, mlibd64 zoomy, mlibfilter filter, mlibedge edge,
          mlibblend blend, mlibs32 alpha, mlibs32 cmask);


DESCRIPTION
     The mlibImageZoomBlend() function will  enlarge  or  minify
     the  source  image  by the X and Y zoom factors and blend it
     with the destination image.


     This     function     is     a     special      case      of
     mlibImageZoomTranslateBlend() with the center of the source
     image being mapped to the center of the destination image.


     The center of the upper-left corner pixel  of  an  image  is
     considered to be located at (0.5, 0.5).


     Both src and dst must be of type MLIBYTE.  They  can  have
     either 3 or 4 channels.


     The src image cannot have width or height larger than 32767.

PARAMETERS
     The function takes the following arguments:

     dst       Pointer to destination image.


     src       Pointer to first source image.


     zoomx     X zoom factor. zoomx > 0.0.


     zoomy     Y zoom factor. zoomy > 0.0.


     filter    Type of resampling filter. It can be  one  of  the
               following:

                 MLIBNEAREST



SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions             mlibImageZoomBlend(3MLIB)



                 MLIBILINEAR
                 MLIBICUBIC
                 MLIBICUBIC2



     edge      Type of edge condition. It can be one of the  fol-
               lowing:

                 MLIBEDGEDSTNOWRITE
                 MLIBEDGEDSTFILZERO
                 MLIBEDGEOPNEAREST
                 MLIBEDGESRCEXTEND
                 MLIBEDGESRCEXTENDINDEF
                 MLIBEDGESRCPADED



     blend     Type of alpha blending. It can be one of the  fol-
               lowing:

                 MLIBLENDGTKSRC
                 MLIBLENDGTKSRCOVER
                 MLIBLENDGTKSRCOVER2



     alpha     Overall alpha for blending.


     cmask     Channel mask to indicate the alpha channel.


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                    2






mediaLib Library Functions             mlibImageZoomBlend(3MLIB)



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


SEE ALSO
     mlibImageZoomTranslateBlend(3MLIB),
     mlibImageZoomTranslateTableBlend(3MLIB), attributes(5)











































SunOS 5.11           Last change: 2 Mar 2007                    3