L_Doc2SetRecognizedCharacters

#include "ltdoc2.h"

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

L_HDOC2 hDoc;	/* handle to the OCR document */
L_INT nPageIndex;	/* page index */
pRECOGCHARS2 pRecogChars;	/* array of RECOGCHARS2 */
L_INT32 lCharsCount;	/* number of recognized characters */

Updates the recognized characters for specific recognized page.

Parameter	Description
hDoc	Handle to the OCR document.
nPageIndex	Index of the page that will be updated with the recognized characters. This index is zero-based.
pRecogChars	Array of RECOGCHARS2 structures, which contains the updated, recognized characters.
lCharsCount	Specifies the number of recognized characters in the pRecogChars array.

Returns

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.

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

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

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

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

To get the colors of the recognized characters, call the L_Doc2GetRecognizedCharactersColors 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_Doc2GetStatus, L_Doc2Recognize, L_Doc2SetRecognitionResultOptions, L_Doc2GetRecognitionResultOptions, L_Doc2EnumOutputFileFormats, L_Doc2GetTextFormatInfo, L_Doc2SaveResultsToFile, L_Doc2SetSpecialChar, L_Doc2GetSpecialChar, L_Doc2GetRecognizedCharacters, L_Doc2FreeRecognizedCharacters, L_Doc2GetRecognizedWords, L_Doc2FreeRecognizedWords, L_Doc2GetRecognizedCharactersColors
Topics:	OCR Functions: Recognition
	Recognizing Document Pages

Example

For an example, refer to L_Doc2GetRecognizedCharacters.