#include "ltdoc2.h"

L_LTDOC2_API L_INT EXT_FUNCTION L_Doc2SetRecognizedCharacters(hDoc, nPageIndex, pRecogChars, lCharsCount)

Updates the recognized characters for specific recognized page.


L_HDOC2 hDoc

Handle to the OCR document.

L_INT nPageIndex

Index of the page that will be updated with the recognized characters. This index is zero-based.

pRECOGCHARS2 pRecogChars

Array of RECOGCHARS2 structures, which contains the updated, recognized characters.

L_INT32 lCharsCount

Specifies the number of recognized characters in the pRecogChars array.


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


This function will update the recognized characters for a specific recognized page using the pRecogChars array. The number of updated recognized characters should equal the count passed in lCharsCount.


You should free the memory associated with pRecogChars parameter when it is no longer needed, by calling the L_Doc2FreeRecognizedCharacters / L_Doc2FreeRecognizedCharacters function.

This function can be called after a successful recognition process started by calling the L_Doc2Recognize / L_Doc2RecognizeExt function.


This function should not be called before calling the L_Doc2Recognize / L_Doc2RecognizeExt function.

To get the recognized characters for a specific recognized page, call the L_Doc2GetRecognizedCharacters / L_Doc2GetRecognizedCharactersExt function. To save the recognized characters to a file, call the L_Doc2SaveResultsToFileExt function.

To get the colors of the recognized characters, call the L_Doc2GetRecognizedCharactersColors / L_Doc2GetRecognizedCharactersColorsExt function.

Required DLLs and Libraries

Help Version 21.0.2021.4.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS OCR Module - OmniPage Engine C API Help