L_Doc2SetOMROptions

#include "ltdoc2.h"

L_LTDOC2_API L_INT EXT_FUNCTION L_Doc2SetOMROptions(hDoc, pOMROpts)

L_HDOC2 hDoc;	/* handle to the OCR document */
pOMROPTIONS2 pOMROpts;	/* pointer to OMROPTIONS2 */

Sets the OMR options to be used in next recognition process.

Parameter	Description
hDoc	Handle to the OCR document.
pOMROpts	Pointer to an OMROPTIONS2 structure, which contains the options to be set.

Returns

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

Comments

Sets the OMR options to be used in the next recognition process.

This function will be used only when the recognition module is DOC2_RECOGMODULE_OMR.

To get the current hand print options, call the L_DocGetOMROptions function.

To recognize a page, call the L_DocRecognize 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_DocSetRecognizeModuleTradeOff, L_DocGetRecognizeModuleTradeOff, L_DocSetMOROptions, L_DocGetMOROptions, L_DocSetHandPrintOptions, L_DocGetHandPrintOptions, L_DocGetOMROptions
Topics:	OCR Functions: Recognition
	Recognizing Document Pages

Example

L_LTDOC2TEX_API  L_INT Doc2SetOMROptionsExample(L_HDOC2 hDoc)
{
   L_INT nRet;
   OMROPTIONS2 OMROpts;

   ZeroMemory(&OMROpts, sizeof(OMROPTIONS2));

   nRet = L_Doc2GetOMROptions(hDoc, &OMROpts, sizeof(OMROPTIONS2));
   if(nRet != SUCCESS)
      return nRet;

   if (!OMROpts.bFill)
      OMROpts.bFill = TRUE;

   if (OMROpts.Frame != DOC2_OMR_WITH_FRAME)
      OMROpts.Frame = DOC2_OMR_WITH_FRAME;

   if (OMROpts.Sense != DOC2_OMR_SENSE_HIGHEST)
      OMROpts.Sense = DOC2_OMR_SENSE_HIGHEST;

   nRet = L_Doc2SetOMROptions(hDoc, &OMROpts);
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}