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

Engine time spent on the image from the start of the recognition process. This includes the time lRecogTime defined above and additional steps as follows: the time necessary for sorting the output from the different recognition modules, the time spent with the checking subsystem, and the time required to produce the recognition results (e.g., the time necessary to write the recognition results to the recognition data file)._lReadingTime_ can also include the time needed to transfer the recognition results from the current image to the final output document, supposing that the statistical information was requested after converting to the final output document. Measured in 1/1000ths of a second.

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.