Manual Pages for UNIX Operating System command usage for man mlib_ImageRotateIndex

mediaLib Library Functions           mlib_ImageRotateIndex(3MLIB)



NAME
     mlib_ImageRotateIndex - rotate color-indexed image

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

     mlib_status mlib_ImageRotateIndex(mlib_image *dst, const mlib_image *src,
          mlib_d64 angle, mlib_d64 xcenter, mlib_d64 ycenter, mlib_filter filter,
          mlib_edge edge, const void *colormap);


DESCRIPTION
     The  mlib_ImageRotateIndex()  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 MLIB_BYTE or MLIB_SHORT.


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



     ycenter     Y coordinate of rotation center  in  the  source
                 image.


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

                   MLIB_NEAREST
                   MLIB_BILINEAR
                   MLIB_BICUBIC
                   MLIB_BICUBIC2



     edge        Type of edge condition. It can  be  one  of  the
                 following:

                   MLIB_EDGE_DST_NO_WRITE
                   MLIB_EDGE_DST_FILL_ZERO
                   MLIB_EDGE_OP_NEAREST
                   MLIB_EDGE_SRC_EXTEND
                   MLIB_EDGE_SRC_PADDED



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


RETURN VALUES
     The function returns MLIB_SUCCESS if  successful.  Otherwise
     it returns MLIB_FAILURE.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     mlib_ImageRotate(3MLIB), mlib_ImageRotate_Fp(3MLIB),  attri-
     butes(5)



SunOS 5.11           Last change: 2 Mar 2007                    2