ImageGear for C and C++ on Windows v19.4 - Updated
Recognized Data Kept in Memory
User Guide > How to Work with... > OCR > How to... > Assess and Analyze OCR Output > Recognized Data Kept in Memory

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.

You can keep the recognized data not only in memory, but also save it to a disk file in native data format using IG_REC_document_save(). The saved data can be later loaded using IG_REC_document_open() and converted to any output format.

Native data files are not compatible between 32-bit and 64-bit versions of the ImageGear Recognition component.