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, *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.