L_DocEnableParallelRecognition

#include "ltdoc.h"

L_LTDOC_API L_INT L_DocEnableParallelRecognition (hDoc, bEnable)

L_HDOC hDoc;

/* handle to the OCR document. */

L_BOOL bEnable;

/* flag */

Enables or disables the Parallel Recognition Mode of the OCR engine.

Parameter

Description

hDoc

Handle to the OCR document.

bEnable

Value that indicates whether to enable or disable the Parallel Recognition Mode. Possible values are:

 

Value

Meaning

 

TRUE

Enable the Parallel Recognition Mode. (default)

 

FALSE

Disable the Parallel Recognition Mode.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

If the host PC has two processors or a hyper-threaded one, enabling the Parallel Recognition Mode can speed up the recognition process by allowing the two recognition engines to run in parallel.

The OCR engine may use Parallel Recognition Mode when a zone is associated with any of the following recognition modules:

image\sqrblit.gif RECOGMODULE_MTEXT_OMNIFONT

image\sqrblit.gif RECOGMODULE_OMNIFONT_FRX

image\sqrblit.gif RECOGMODULE_OMNIFONT_PLUS3W

To determine whether the parallel recognition mode is enabled, call L_DocIsParallelRecognitionEnabled.

To get information on a particular zone, call L_DocGetZone. The recognition module associated with the zone is found in pZONEDATA. RecogModule, which is updated by the L_DocGetZone function.

If L_DocEnableParallelRecognition is not called within an application, then by default, parallel recognition is enabled.

Required DLLs and Libraries

LTDOC

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_DocRecognize, L_DocIsParallelRecognitionEnabled

Topics:

Recognizing Document Pages

 

Working with Zones

 

OCR Functions: Recognition

 

OCR Functions: Zones

Example

For an example, refer to L_DocIsParallelRecognitionEnabled.