L_Doc2UpdatePage

#include "ltdoc2.h"

L_LTDOC2_API L_INT EXT_FUNCTION L_Doc2UpdatePage(hDoc, pBitmap, nPageIndex)

L_HDOC2 hDoc;

handle to the OCR document

pBITMAPHANDLE pBitmap;

pointer to the bitmap handle

L_INT nPageIndex;

page position

Updates the current page with a new bitmap.

Parameter

Description

hDoc

Handle to the OCR document.

pBitmap

Pointer to the bitmap handle that references the new page to be updated into the internal OCR list of pages.

nPageIndex

Index of the page to be updated. This is a zero-based index.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Use this function to update the content of a page after performing image processing on it.

For example, after a page is flipped using the L_FlipBitmap function, this function should then be called to update the OCR page.

Before using this function it is necessary to lock the page for updating by calling the L_Doc2LockPage function, and after the update is completed, and then unlock the page by calling the L_Doc2UnlockPage function.

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.

See Also

Functions:

L_Doc2AddPage, L_Doc2GetPageCount, L_Doc2RemovePage, L_Doc2ExportPage, L_Doc2GetPageInfo, L_Doc2LockPage, L_Doc2UnlockPage, L_Doc2CleanupPages

Topics:

OCR Functions: Pages

 

Working with Pages

Example

L_INT Doc2UpdatePageExample(L_HDOC2 hDoc, L_INT nPageIndex, pBITMAPHANDLE pBitmap) 
{ 
   L_INT nRet; 
   nRet = L_Doc2LockPage (hDoc, nPageIndex); 
   if(nRet != SUCCESS) 
      return nRet; 
   nRet = L_Doc2UpdatePage(hDoc, pBitmap, nPageIndex); 
   if (nRet != SUCCESS) 
   { 
      MessageBox(NULL, TEXT("An error occurred during L_Doc2UpdatePage."), TEXT("Error!"), MB_OK); 
      return nRet; 
   } 
   else 
      MessageBox(NULL, TEXT("The specified page is updated."), TEXT("Notice!"), MB_OK); 
   nRet = L_Doc2UnlockPage (hDoc, nPageIndex); 
   if(nRet != SUCCESS) 
      return nRet; 
   return SUCCESS; 
} 

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Professional OCR C API Help