L_DocAutoOrientPage

#include "ltdoc.h"

L_LTDOC_API L_INT L_DocAutoOrientPage(hDoc, nPageIndex)

L_HDOC hDoc;

/* handle to the OCR document */

L_INT nPageIndex;

/* page index */

Auto orients the specified page.

Parameter

Description

hDoc

Handle to the OCR document.

nPageIndex

Index of the page to auto orient. This is a zero-based index.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

This function automatically orients (rotates) the specified page to be readable and updates the image data. Use the L_DocDetectOrientationDegree if you just want the angle of orientation that is needed, without orienting the page.

Required DLLs and Libraries

LTDOC

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

See Also

Functions:

L_DocAddPage, L_DocGetPageCount, L_DocRemovePage, L_DocExportPage, L_DocUpdatePage, L_DocGetPageInfo, L_DocCleanupPages

Topics:

OCR Functions: Pages

 

Working with Pages

Example

 L_INT DocAutoOrientPageExample(L_HDOC hDoc,L_INT nPageIndex)
{
   L_INT nRet;
   nRet = L_DocAutoOrientPage(hDoc, nPageIndex);
   if (nRet != SUCCESS)
   {
      MessageBox(NULL, TEXT("Failure while auto orienting the current page"), TEXT("Notice!"), MB_OK);
      return nRet;
   }
   return SUCCESS;
}