RotateImageOCR_S

Member of namespace

OCR_SR

Syntax

bool RotateImageOCR_S ()

Parameters

None

Returns

False if the ruleset with this action is not bound to a Page object of the Document Hierarchy, or if the action cannot locate the image file representing the current page. Otherwise, True.

Level

Page only.

Details

This action performs automatic rotation of black and white .TIF (or .TIFF) files. The automatic image rotation algorithm relies on, and works best with, images with good quality machine printed text. The page should include at least one text line which includes a machine printed text of at least 30 characters. If an image contains text with various orientations, for example vertical and horizontal, the image might be rotated undesirably. The automatic rotation algorithm does not fully work with images containing 9-pin dot-matrix text or other non-machine printed text.

This action performs other image enhancements such as deskew, if they are enabled. See OCR_SR actions to enable these settings.

Alternatively, automatic rotation and deskew can be performed automatically at the same time as recognition, if image enhancements are enabled. If automatic rotation is enabled during recognition, then it is not necessary to call this action prior to recognition unless the application requires the rotation to be fixed prior to recognition for some other application specific reason. For example, it may be desirable to perform automatic rotation before fingerprinting or using the Image Enhancement ruleset.

It is recommended that this action be called in a separate ruleset after recognition due to instances where the recognition engine does not release the image until the ruleset has completed. This problem can manifest as a cco does not exist error in the log file.

This action supports the automatic retry mechanism.

Example

RotateImageOCR_S()
RecognizePageICR_C()     

In this example, automatic image rotation is performed prior to full page recognition via the ICR_C actions.