mediaLib Library Functions           mlibImageRotateIndex(3MLIB)



NAME
     mlibImageRotateIndex - rotate color-indexed image

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

     mlibstatus mlibImageRotateIndex(mlibimage *dst, const mlibimage *src,
          mlibd64 angle, mlibd64 xcenter, mlibd64 ycenter, mlibfilter filter,
          mlibedge edge, const void *colormap);


DESCRIPTION
     The  mlibImageRotateIndex()  function  rotates  the  source
     image  about  a user-defined rotation center in user-defined
     radians.


     The width and height of the destination image  can  be  dif-
     ferent  from  the  width and height of the source image. The
     (xcenter, ycenter) point of the source image  is  mapped  to
     the  center of the destination image. You should ensure that
     the destination buffer is large enough to hold the resulting
     bounding box to avoid clipping part of the image.


     The source and destination  images  must  be  single-channel
     images.


     The image data type must be MLIBYTE or MLIBSHORT.


     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.


     angle       Angle of rotation.  The  angle  is  measured  in
                 radians clockwise.


     xcenter     X coordinate of rotation center  in  the  source
                 image.




SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions           mlibImageRotateIndex(3MLIB)



     ycenter     Y coordinate of rotation center  in  the  source
                 image.


     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
                 following:

                   MLIBEDGEDSTNOWRITE
                   MLIBEDGEDSTFILZERO
                   MLIBEDGEOPNEAREST
                   MLIBEDGESRCEXTEND
                   MLIBEDGESRCPADED



     colormap    Internal data structure for inverse  color  map-
                 ping.  This  data  structure is generated by the
                 mlibImageColorTrue2IndexInit() function.


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
     mlibImageRotate(3MLIB), mlibImageRotateFp(3MLIB),  attri-
     butes(5)



SunOS 5.11           Last change: 2 Mar 2007                    2