L_Doc2DetectOrientationDegreeExt

#include "ltdoc2.h"

L_LTDOC2_API L_INT L_Doc2DetectOrientationDegreeExt(hDoc, nDocId, nPageIndex, pnRotate)

Determines the angle by which the specified page needs to be oriented. No rotation is performed.

Parameters

L_HDOC2 hDoc

Handle to the OCR document.

L_INT nDocId

Document ID created by calling L_Doc2CreateDocument.

L_INT nPageIndex

Zero-based index of the page for which to get the orientation angle.

L_INT * pnRotate

Pointer to a variable to be updated with the orientation angle, in degrees. Possible values are: +90, +180, and +270. Rrotation is clockwise.

Returns

Comments

✎ NOTE

This function just provides the angle of orientation that is needed. No rotation is performed. To automatically orient the page, call L_Doc2AutoOrientPage / L_Doc2AutoOrientPageExt.

If the specified page does not need to be oriented, the pnRotate parameter is updated with 0.

Orienting the page makes it more readable during recognition by making sure the top of the page is positioned properly. That is, a page that is oriented correctly like this:

is much more readable than the same page oriented like this:

Required DLLs and Libraries

• LTDOC2
• For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

L_INT Doc2DetectOrientationDegreeExampleExt(L_HDOC2 hDoc, L_INT nDocId, L_INT nPageIndex) 
{ 
   L_INT nRet; 
   L_INT nRotate = 0; 
 
   nRet = L_Doc2DetectOrientationDegreeExt(hDoc, nDocId, nPageIndex, &nRotate); 
   if (nRet == SUCCESS) 
   { 
      L_TCHAR szBuffer[1024]; 
      wsprintf(szBuffer, TEXT("Orientation degree = %d"), nRotate); 
      MessageBox(NULL, szBuffer, TEXT("Notice!"), MB_OK); 
   } 
   else 
      return nRet; 
   return SUCCESS; 
}