L_Doc2SetRecognizedCharacters

#include "ltdoc2.h"

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

Updates the recognized characters for specific recognized page.

Parameters

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.

Returns

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

Comments

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.

✅ IMPORTANT

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.

✅ IMPORTANT

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