PROGRESSDATA

typedef struct _tagProgressData
{
   L_UINT uStructSize;
   OCRPROCID Id;
   L_INT nPercent;
   L_INT nAccecptCharCount;
   L_INT nRejectedCharCount;
   L_INT32 lObjSize;
   L_UCHAR *uObjData;
} PROGRESSDATA, * pPROGRESSDATA;

The PROGRESSDATA structure used for PROGRESSCALLBACK function.

Member

Description

uStructSize

Specifies the structure size. It should be equal to sizeof(PROGRESSDATA).

Id

Identifier of the process currently running. For a list of possible values, refer to OCRPROCID.

nPercent

Progress of the current process expressed as a percentage

nAccecptCharCount

Number of recognized characters accepted during the recognition process.

nRejectedCharCount

Number of characters rejected during the recognition process

lObjSize

Size of the uObjData buffer containing the real time information

uObjData

Sample text from the recognized characters (typically 30-80 chars) in UNICODE for real-time information.

Comments

The uObjSize and uObjData fields are also recognition specific fields. They serve for real time display purposes. These fields are applicable only if the Id member is PROC_RECOGNITION.

The nAccecptCharCount and nRejectedCharCount fields are recognition specific fields. They are applicable only if the Id member is PROC_RECOGNIZE_MOR, PROC_RECOGNITION or PROC_RECOGNITION3.

pPROGRESSDATA is a pointer to a PROGRESSDATA structure. Where the function parameter type is pPROGRESSDATA, declare a PROGRESSDATA variable, update the structure's fields, and pass the variable's address in the parameter. Declaring a pPROGRESSDATA variable is necessary only if the program requires a pointer.

This structure will be filled only when PROGRESSCALLBACK is called. The PROGRESSCALLBACK function will be called if you have set a callback function with L_DocSetProgressCB.