STATUS

typedef struct _tagStatus
{
   L_UINT uStructSize;
   L_INT nRecogChrCount;
   L_INT nRecogWordCount;
   L_INT nRejectChrCount;
   L_INT nRejectWordCount;
   L_INT32 lRecogTime;
   L_INT32 lReadingTime;
   L_INT32 lPreprocTime;
   L_INT32 lDecompTime;
} STATUS, L_FAR *pSTATUS;

The STATUS structure will be filled when calling L_DocGetStatus.

Member

Description

uStructSize

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

nRecogChrCount

Number of recognized characters on the image

nRecogWordCount

Number of recognized words on the image

nRejectChrCount

Number of rejected characters on the image

nRejectWordCount

Number of words on the image corrected by the checking subsystem

lRecogTime

Engine time spent on recognition of the image content. This is the pure recognition time that the image spent in the different recognition modules involved in the recognition process of the image. Measured in 1/1000 of a second.

lReadingTime

Engine time spent on the image from the start of the recognition process. This includes the time lRecogTime defined above and further steps as follows: It also consists of the time necessary for sorting the output coming from the different recognition modules, the time spent with the checking subsystem, and the time required to produce the recognition result (e.g. the time necessary to write the recognition result into the recognition data file).

 

This field may also include the time needed for transferring the recognition result from the current image into the final output document – supposing that the statistical information was requested after converting to the final output document. Measured in 1/1000 of a second.

lPreprocTime

Engine time spent on image pre-processing. Measured in 1/1000 of a second.

lDecompTime

Engine time spent on the image’s page-layout decomposition, i.e. auto-zoning (the PID_DECOMPOSITION process). Measured in 1/1000 of a second.

Comments

The total processing time that a single image spends in the Engine until the recognition data or the final output document is produced can be calculated as follows:lTotal = lReadingTime + lPreprocTime + lDecompTime.

The accuracy of the Engine timing values provided in this structure depends on the resolution of the system timer, i.e. the timing resolution for Windows 95/98 is approximately 55 ms, for Windows NT, Windows 2000, or Windows XP it is 10 ms.

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