mediaLib Library Functions         mlibImageZoomTranslate(3MLIB)



NAME
     mlibImageZoomTranslate - zoom, with translation

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

     mlibstatus mlibImageZoomTranslate(mlibimage *dst,
          const mlibimage *src, mlibd64 zoomx, mlibd64 zoomy,
          mlibd64 tx, mlibd64 ty, mlibfilter filter,
          mlibedge edge);


DESCRIPTION
     The mlibImageZoomTranslate() function will enlarge or  min-
     ify  the  source  image  by  the  X and Y zoom factors, with
     translation. It uses the interpolation method  as  described
     by the resampling filter.


     It uses the following equation for coordinate mapping:

       xd = zoomx*xs ] tx
       yd = zoomy*ys ] ty



     where a point with coordinates (xs, ys) in the source  image
     is mapped to a point with coordinates (xd, yd) in the desti-
     nation image.


     The data type of the  images  can  be  MLIBIT,  MLIBYTE,
     MLIBSHORT, MLIBUSHORT, or MLIBINT.


     The width and height of the destination image  can  be  dif-
     ferent from the width and height of the source image.


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

PARAMETERS
     The function takes the following arguments:

     dst       Pointer to destination image.


     src       Pointer to source image.





SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions         mlibImageZoomTranslate(3MLIB)



     zoomx     X zoom factor. zoomx > 0.


     zoomy     Y zoom factor. zoomy > 0.


     tx        X translation.


     ty        Y translation.


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

                 MLIBNEAREST
                 MLIBILINEAR
                 MLIBICUBIC
                 MLIBICUBIC2



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

                 MLIBEDGEDSTNOWRITE
                 MLIBEDGEDSTFILZERO
                 MLIBEDGEOPNEAREST
                 MLIBEDGESRCEXTEND
                 MLIBEDGESRCEXTENDINDEF
                 MLIBEDGESRCPADED



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         mlibImageZoomTranslate(3MLIB)



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


SEE ALSO
     mlibImageZoomTranslateFp(3MLIB),  mlibImageAffine(3MLIB),
     mlibImageAffineFp(3MLIB), attributes(5)











































SunOS 5.11           Last change: 2 Mar 2007                    3