xil_rotate(3)

NAME

xil_rotate − rotate an image

SYNOPSIS

#include <xil/xil.h>

void xil_rotate ( XilImage src,

XilImage dst,
char ∗interpolation,
float angle);

DESCRIPTION

This function rotates an image about its origin. By default, an image’s origin is its upper-left corner (0.0, 0.0). You can change the origin with the xil_set_origin() function.

src is the source image handle. dst is the destination image handle. interpolation is a string that specifies the type of interpolation to be used. The supported interpolation types are nearest (nearest neighbor), bilinear, bicubic, and general. angle is the angle of rotation in radians. A positive angle indicates counterclockwise rotation; a negative angle indicates clockwise rotation.

ROI Behavior

If an ROI (region of interest) is attached to the source image, it is used as a read mask and is rotated into the destination image’s space, where it is intersected with the destination ROI (if there is one).

ERRORS

For a complete list of XIL error messages by number, consult Appendix B of the XIL Programmer’s Guide.

EXAMPLES

Rotate an image clockwise by 45 degrees (.7854 radians) using bilinear interpolation:

XilImage src, dst;
xil_rotate(src, dst, "bilinear", -0.7854);

NOTES

The source and destination images to be rotated must be the same type and number of bands. This operation cannot be performed in place.

Museum

Related Articles