NAME

xil_transpose − rotate or transpose an image

SYNOPSIS

#include <xil/xil.h>

void xil_transpose (XilImage src,

XilImage dst,
XilFlipType fliptype);

DESCRIPTION

This function reflects an image in some direction or rotates an image in multiples of 90 degrees.  src is the source image handle.  dst is the destination image handle.  fliptype is an enumeration constant that represents the direction of reflection as follows: fliptypeReflection Direction

XIL_FLIP_Y_AXISrotate horizontal, across the y axis

XIL_FLIP_X_AXISrotate vertical, across the x axis

XIL_FLIP_MAIN_DIAGONALrotate transpose across the main diagonal
XIL_FLIP_ANTIDIAGONALrotate transpose across the anti-diagonal
XIL_FLIP_90rotate counterclockwise 90 degrees
XIL_FLIP_180rotate counterclockwise 180 degrees
XIL_FLIP_270rotate counterclockwise 270 degrees

ROI Behavior

If an ROI (region of interest) is attached to the source image, it is used as a read mask and is also "flipped" 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

Reflect an image vertically across the X axis:

XilImage src, dst;
xil_transpose(src, dst, XIL_FLIP_X_AXIS);

NOTES

Source and destination images must be the same data type and number of bands.  This operation cannot be performed in place.  This operation ignores the location of an image’s origin. 
 

SunOS 5.6  —  Last change: 17 June 1993