Collapse All Expand All

L_DocSetRecognizeModuleTradeOff

#include "ltdoc.h"

L_LTDOC_API L_INT L_DocSetRecognizeModuleTradeOff(hDoc, TradeOff)

L_HDOC hDoc;	/* handle to the OCR document */
RECOGMODULE_TRADEOFF TradeOff;	/* trade-off setting */

Specifies the tradeoff setting of the OCR document engine that will be applied during auto-zoning and recognition.

Parameter	Description
hDoc	Handle to the OCR document.
TradeOff	Value that represents the trade-off setting to be set. For a list of possible values, refer to RECOGMODULE_TRADEOFF.

Returns

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

Comments

Specifies the tradeoff setting of the OCR document engine that will be applied during auto-zoning and recognition.

To apply auto-zone detection in a specific page, call L_DocFindZones. To recognize a page, call L_DocRecognize.

The OCR document engine trade-off setting is effective for the following recognition modules:

• RECOGMODULE_MTEXT_OMNIFONT: omnifont multi-lingual module.

• RECOGMODULE_MULTI_LINGUAL_OMNIFONT: omnifont module.

• RECOGMODULE_HAND_PRINTED_NUMERAL: handprinted numeral module.

• RECOGMODULE_RER_PRINTED: handprint module.

This setting does not influence the behavior of any other RECOGMODULE recognition module. Not all of the above modules interpret the settings in the same way.

If this function is not called, the default value RECGMD_ACCURATE is applied.

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_DocGetRecognizeModuleTradeOff, L_DocSetMOROptions, L_DocGetMOROptions, L_DocSetHandPrintOptions, L_DocGetHandPrintOptions, L_DocSetOMROptions, L_DocGetOMROptions
Topics:	OCR Functions: Recognition
	Recognizing Document Pages

Example

For an example, refer to L_DocRecognize.