The recognized data is stored in memory if the IG_REC_image_recognize() function has been successfully called. In this case the application can access the recognized data with a IG_REC_letters_get() function call. The recognized data will be available as an array of AT_REC_LETTER structures providing significantly more information than the character code itself. This occupies 76 bytes for each recognized character, and this type of output offers the most detailed information on the recognition.
Since this function creates a new memory object containing the recognized data, after having evaluated (processed) the result, the application should call the IG_REC_free() function to free this memory area.
The application can slightly change the recognized data before converting it to a recognition data file. The IG_REC_letters_set() function can be used to update the recognized data belonging to the hImg image. Be careful to modify only those fields whose change is necessary.
The recognized data can be saved in any supported output format using either IG_REC_output_direct_text_write() or IG_REC_document_write(). The output format must be specified first with either IG_REC_output_text_format_set or IG_REC_output_format_set() function, respectively.
Note that you can keep the recognized data not only in memory, but it also can be saved to the disk file in the native data format using IG_REC_document_save(). The data being saved can be later loaded using IG_REC_document_open() and converted to any output format.