DTWAIN_GetOCRTextInfoLongEx
|
The DTWAIN_GetOCRTextInfoLongEx returns information concerning the characters in the returned text after an OCR engine has processed an image file.
BOOL DTWAIN_GetOCRTextInfoLongEx (
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_GetOCRTextInfoLongEx returns information concerning characters that the OCR engine has produced after processing an image file. See the nWhichItem table in the DTWAIN_GetOCRTextInfoLong topic as to the type of information that can be returned.
The pBuffer is a pointer to a buffer of LONG 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_GetOCRTextInfoLongEx works exactly the same way as DTWAIN_GetOCRTextInfoLong, except that DTWAIN_GetOCRTextInfoLong only returns information for a single character, while DTWAIN_GetOCRTextInfoLongEx returns all of the information to a buffer supplied by the caller.
For floating point information concerning the characters in the OCR-ed text, the DTWAIN_GetOCRTextInfoFloatEx should be used. If your application desires to get just a single character's information, call DTWAIN_GetOCRTextInfoLong.
Example
Prerequisite Function Call(s) DTWAIN_SelectOCREngine, or DTWAIN_SelectOCREngineByName, or DTWAIN_SelectDefaultOCREngine |