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:
RECOGMODULE_MTEXT_OMNIFONT
RECOGMODULE_OMNIFONT_FRX
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: |
|
Topics: |
|
|
|
|
|
|
Example
For an example, refer to L_DocIsParallelRecognitionEnabled.