mlib_ImageRotateIndex

- rotate color-indexed image

Synopsis

cc [ flag... ] file... -lmlib [ library... ]
#include <mlib.h>

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 different 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.

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 mapping. 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 attributes:

See Also

mlib_ImageRotate(3MLIB), mlib_ImageRotate_Fp(3MLIB), attributes(5)