IG_IP_rotate_multiple_90

---

Group: Image Processing

Declaration:

AT_ERRCOUNT ACCUAPI IG_IP_rotate_multiple_90 (HIGEAR hIGear, AT_MODE 
nMult_90_Mode ); 

Arguments:

hIGear	HIGEAR handle of image to rotate
nMult_90_Mode	One of IG_ROTATE_0, IG_ROTATE_90, IG_ROTATE_180, or IG_ROTATE_270

Description:

This function will rotate the image referenced by hIGear clockwise about its center. The rotation must be a multiple of 90 degrees. If the rotation is either 90 or 270 degrees, the previous width of the image becomes the new height, and the previous height of the image becomes the new width. IG_ROTATE_0 does nothing and is included for completeness only.

To rotate by an arbitrary angle that may not be a multiple of 90 degrees, use functions IG_IP_rotate_any_angle()or IG_IP_rotate_any_angle_bkgrnd().

There is the global control parameter IP.ALPHA_PROCESSING_ENABLE telling whether this function should check and process associated alpha images. If this parameter is TRUE (default), the function checks HIGEAR for the presence of associated alpha images and apply the same operation on them. If this parameter is FALSE, only the main HIGEAR image is processed (backward compatible behavior).

Bits Per Pixel: 1, 4, 8, 9-16-bit gray level, 24, 32

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Example:

/* HIGEAR     handle of image to rotate   */ 

AT_MODE	       nRotateMode; /* Will be set to an IG_ROTATE_... constant */ 

BOOL	       bClockwiseFlag;/* Flag indicating direction to rotate  */ 

AT_ERRCOUNT		nErrcount;    /* Returned number of errors */ 

 ... 

/* If flag is TRUE, rotate 90 clockwise, else 90 counterclockwise:  */ 

if ( bClockwiseFlag ) 

	{ nRotateMode = IG_ROTATE_270; } /* Go clockwise 90 degrees  */ 

else 

	{ nRotateMode = IG_ROTATE_90;  } /* clockwise 90   */ 

nErrcount = IG_IP_rotate_multiple_90 ( hIGear, nRotateMode ); 

Sample: IMG_PROC, TIMING, THREADS, ART, Scan, TWAIN, JNI