mediaLib Library Functions             mlibImageAffineFp(3MLIB)



NAME
     mlibImageAffineFp - image affine transformation

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

     mlibstatus mlibImageAffineFp(mlibimage *dst, const mlibimage *src,
          const mlibd64 *mtx, mlibfilter filter, mlibedge edge);


DESCRIPTION
     The mlibImageAffineFp() function does  affine  transforma-
     tion  on  a  floating-point image according to the following
     equation:

       xd = a*xs ] b*ys ] tx
       yd = c*xs ] d*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   MLIBFLOAT   or
     MLIBDOUBLE.


     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.


     mtx       Transformation  matrix.  mtx[0]  holds  a;  mtx[1]
               holds  b;  mtx[2] holds tx; mtx[3] holds c; mtx[4]
               holds d; mtx[5] holds ty.






SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions             mlibImageAffineFp(3MLIB)



     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
                 MLIBEDGESRCPADED



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
     mlibImageAffine(3MLIB),       mlibImageAffineIndex(3MLIB),
     mlibImageAffineTransform(3MLIB),
     mlibImageAffineTransformFp(3MLIB),
     mlibImageAffineTransformIndex(3MLIB),
     mlibImageSetPaddings(3MLIB), attributes(5)









SunOS 5.11           Last change: 2 Mar 2007                    2