DTWAIN_GetOCRTextInfoFloatEx

Top  Previous  Next

The DTWAIN_GetOCRTextInfoFloatEx returns information concerning the characters in the returned text after an OCR engine has processed an image file.

 

BOOL DTWAIN_GetOCRTextInfoFloatEx (

DTWAIN_OCRTEXTINFOHANDLE

TextInfoHandle

LONG

nWhichItem,

LPLONG

pBuffer,

LONG

bufSize );

 

Parameters:

TextInfoHandle

The value returned by DTWAIN_GetOCRTextInfoHandle.

 

nWhichItem

Character information that is to be retrieved.

 

pBuffer

Pointer to a buffer of LONG values that, on return, will be filled with the information about the characters.

 

bufSize

Maximum size of the buffer pBuffer.

 

Returns:

If successful, TRUE.  On failure, FALSE is returned.   Call DTWAIN_GetLastError on further information on the failure.

 

Comments:

DTWAIN_GetOCRTextInfoFloatEx returns information concerning characters that the OCR engine has produced after processing an image file.  See the nWhichItem table in the DTWAIN_GetOCRTextInfoFloat topic as to the type of information that can be returned.

 

The pBuffer is a pointer to a buffer of DTWAIN_FLOAT values that the caller must supply to the function.  On return, pBuffer will be filled in with the requested character information.

 

The bufSize is the maximum number of characters that bufSize can hold.

 

The DTWAIN_GetOCRTextInfoFloatEx works exactly the same way as DTWAIN_GetOCRTextInfoFloat, except that DTWAIN_GetOCRTextInfoFloat only returns information for a single character, while DTWAIN_GetOCRTextInfoFloatEx returns all of the information to a buffer supplied by the caller.

 

For LONG information concerning the characters in the OCR-ed text, the DTWAIN_GetOCRTextInfoLongEx should be used.  If your application desires to get just a single character's information, call DTWAIN_GetOCRTextInfoFloat.

 

Example

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

DTWAIN_InitOCRInterface

DTWAIN_SelectOCREngine, or DTWAIN_SelectOCREngineByName, or DTWAIN_SelectDefaultOCREngine

DTWAIN_ExecuteOCR

DTWAIN_GetOCRTextInfoHandle