Gets all alternative character codes for the recognized data of the specified image.
Copy Code
|
|
---|---|
AT_ERRCOUNT ACCUAPI IG_REC_alternative_letter_codes_get( HIG_REC_IMAGE hImage, AT_WCHAR*** lplplpAlternativeCodes, LPAT_INT lpAlternativeCodesCount ); |
Name | Type | Description |
---|---|---|
hImage | HIG_REC_IMAGE | Image handle. |
lplplpAlternativeCodes | AT_WCHAR*** | Pointer to an array of AT_WCHAR strings, to receive the array or alternative codes. The array and the strings are allocated by the toolkit. |
lpAlternativeCodesCount | LPAT_INT | Pointer to a variable to return the total number of alternative code strings in the array. You shall pass this count to IG_REC_wstring_array_free to properly free the array. |
This function does not process image pixels.
Copy Code
|
|
---|---|
AT_ERRCOUNT ErrCount = 0; HIGEAR higImage = 0; HIG_REC_IMAGE higRecImage = 0; AT_WCHAR** lplpAlternativeCodes = 0; AT_INT nAlternativeCodesCount = 0; ErrCount += IG_load_file("Image.tif", &higImage); ErrCount += IG_REC_image_import(higImage, &higRecImage); ErrCount += IG_REC_image_recognize(higRecImage); ErrCount += IG_REC_alternative_letter_codes_get(higRecImage, &lplpAlternativeCodes, &nAlternativeCodesCount); //... ErrCount += IG_REC_wstring_array_free(lplpAlternativeCodes, nAlternativeCodesCount); ErrCount += IG_REC_image_delete(higRecImage); ErrCount += IG_image_delete(higImage); |
This function gets an array of wide char strings containing all alternative character codes for the specified image. Each string contains one alternative for the letter code. Alternative codes for each letter are stored consecutively in the array.
In the array of recognized letters, each letter may point to one or more alternative codes for this letter. The AT_REC_LETTER structure contains AlternativeCodeIndex and AlternativeCodesCount fields, which specify the index of the first alternative code string in the array returned by IG_REC_alternative_letter_codes_get, and the number of alternative codes.
The function can be called after a successful IG_REC_image_recognize call.
Use IG_REC_wstring_array_free to free the array when it is no longer needed.