STATUS2

typedef struct _tagStatus2 
{ 
   L_UINT uStructSize; 
   L_INT nRecogChrCount; 
   L_INT nRecogWordCount; 
   L_INT nRejectChrCount; 
   L_INT32 lRecogTime; 
   L_INT32 lReadingTime; 
   L_INT32 lPreprocTime; 
   L_INT32 lDecompTime; 
} STATUS2, *pSTATUS2; 

The STATUS2 structure is filled when calling L_Doc2GetStatus / L_Doc2GetStatusExt.

Members

uStructSize

Structure size. Set it to sizeof(STATUS2).

nRecogChrCount

Number of characters on the image that were recognized.

nRecogWordCount

Number of words on the image that were recognized.

nRejectChrCount

Number of characters on the image that were rejected.

lRecogTime

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

lReadingTime

lPreprocTime

Engine time spent on image pre-processing. Measured in 1/1000ths 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/1000ths 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. The timing resolution for Windows 95/98 is approximately 55 ms, for Windows NT, Windows 2000, and for Windows XP it is 10 ms.

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