L_OcrPage_SetRecognizedCharacters

#include "ltocr.h"

L_LTOCR_API L_INT EXT_FUNCTION L_OcrPage_SetRecognizedCharacters(page, pageCharacters)

L_OcrPage page; handle to the OCR page
const L_OcrPageCharacters* pageCharacters; pointer to L_OcrPageCharacters structure that contains the modified page characters to set back in the page

Sets the recognized character data of this L_OcrPage

Parameter Description
page Handle to the OCR page.
pageCharacters Pointer to L_OcrPageCharacters structure that contains the modified page characters to set back in the page.

Returns

SUCCESS The function was successful.
< 1 An error occurred. Refer to Return Codes.

Comments

Use this method to set the recognized characters of a page after you modify them. To get the recognized characters of a page use L_OcrPage_GetRecognizedCharacters.

You must call this method after the L_OcrPage has been recognized with the L_OcrPage_Recognize method. i.e., if the value of the L_OcrPage_IsRecognized method of this page is L_FALSE, then calling this method will return SUCCESS and 'pageCharacters' parameter won't be updated.

You can use the L_OcrPage_GetRecognizedCharacters to examine the recognized character data. This data contain information about the character codes, their confidence, guess codes, location and position in the page as well as font information. For more information, refer to L_OcrCharacter.

If you wish to modify and the apply recognition data back to the page, Use L_OcrPage_SetRecognizedCharacters.

Use L_OcrPage_GetZoneWords to get the recognized words of a zone.

Notes on spaces: The LEADTOOLS Advantage OCR engine will not return any space characters when using the L_OcrPage_GetRecognizedCharacters method.

The L_OcrPage_SetRecognizedCharacters method will accept space characters in the LEADTOOLS Advantage engine. However, these space characters will be used when generating the final document (PDF) and might affect the final output. Therefore, it is not recommended that you insert space characters when using the LEADTOOLS Advantage engine.

Note: You should call L_OcrPage_FreePageCharacters on the 'pageCharacters' parameter to free its allocated memory when no longer needed.

Required DLLs and Libraries

LTOCR
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.
Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Advantage OCR C API Help