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;
}