ImageGear for C and C++ on Windows v19.1 - Updated
IG_REC_image_orient
API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Recognition Image Preprocessing Functions > IG_REC_image_orient

Immediately rotates and/or mirrors the hImage image according to the Orientation parameter.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_image_orient(
   HIG_REC_IMAGE hImage,
   enumIGRecImgRotate Orientation
);

Arguments:

Name Type Description
hImage HIG_REC_IMAGE Handle of the image.
Orientation enumIGRecImgRotate Image orientation to be performed.

Return Value:

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

Supported Raster Image Formats:

See IG_REC_image_import.

Example:

 
Copy Code
AT_ERRCOUNT ErrCount = 0;
HIGEAR higImage = 0;
HIG_REC_IMAGE higRecImage = 0;

ErrCount += IG_load_file("Image.tif", &higImage); 
ErrCount += IG_REC_image_import(higImage, &higRecImage);
ErrCount += IG_REC_image_orient(higRecImage, IG_REC_IMG_ROTATE_AUTO);

//...

ErrCount += IG_REC_image_delete(higRecImage);
ErrCount += IG_image_delete(higImage);

Remarks:

When this function is called, the coordinates of all defined zones in the zone list will be automatically recalculated, i.e., the zones are also rotated.

An alternative to this function is the IG_REC_image_preprocess function with the required Image orientation mode.

See Also

HIG_REC_IMAGE