Gets recognition data belonging to the page as an array of AT_REC_LETTER structures.
Copy Code
|
|
---|---|
AT_ERRCOUNT ACCUAPI IG_REC_letters_get( HIG_REC_IMAGE hImage, LPAT_REC_LETTER* ppLetter, LPAT_INT pLength ); |
Name | Type | Description |
---|---|---|
hImage | HIG_REC_IMAGE | Handle of the recognition image. |
ppLetter | LPAT_REC_LETTER* | Pointer to an array of AT_REC_LETTER structures returned. |
pLength | LPAT_INT | Pointer to a variable to receive a number of elements in the array. |
See IG_REC_image_import.
Copy Code
|
|
---|---|
HIGEAR higImage = 0; AT_ERRCOUNT ErrCount = 0; HIG_REC_IMAGE higRecImage = 0; LPAT_REC_LETTER pLetters = NULL; AT_INT nZoneCount = 0; AT_INT nZoneIndex = 0; AT_INT nLetterCount = 0; AT_INT nLetterIndex = 0; ErrCount += IG_load_file("Image.tif", &higImage); ErrCount += IG_REC_image_import(higImage, &higRecImage); ErrCount += IG_REC_image_recognize(higRecImage); ErrCount += IG_REC_zones_count_get(higRecImage, &nZoneCount); ErrCount += IG_REC_letters_get(higRecImage, &pLetters, &nLetterCount); for (nZoneIndex = 0; nZoneIndex < nZoneCount; ++nZoneIndex) { for (nLetterIndex = 0; nLetterIndex < nLetterCount; ++nLetterIndex) { if (pLetters[nLetterIndex].ZoneIndex == nZoneIndex) { //... } } } ErrCount += IG_REC_free(pLetters); ErrCount += IG_REC_image_delete(higRecImage); ErrCount += IG_image_delete(higImage); |
The function creates new memory object that must be destroyed with IG_REC_free when it is no longer needed.
The function returns 0 errors when the recognition data does not exist. IGW_REC_EXTENDED_WARNING is added to the error stack in this case. Check the error stack with IG_warning_check() to determine whether the recognition data is presented or not.
The function doesn't change the output parameters (*ppLetter and *pLength) in the case of an error or warning. Make sure to initialize them with zero before the call.