ImageGear for C and C++ on Windows v19.3 - Updated
IG_REC_letters_set
API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Letter Access Functions > IG_REC_letters_set

Puts letters onto the selected output converter.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_letters_set(
   HIG_REC_IMAGE hImage,
   LPAT_REC_LETTER pLetter,
   AT_INT Length
);

Arguments:

Name Type Description
hImage HIG_REC_IMAGE Handle of the recognition image.
pLetter LPAT_REC_LETTER Letter array.
Length AT_INT Number of letters in the array.

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

See IG_REC_image_import.

Example:

 
Copy Code
AT_ERRCOUNT ErrCount = 0;
HIGEAR higImage = 0;
HIG_REC_IMAGE higRecImage = 0;
LPAT_REC_LETTER pLetters = 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_letters_get(higRecImage, &pLetters, &nLetterCount);

for (nLetterIndex = 0; nLetterIndex < nLetterCount; ++nLetterIndex)
{
    if (pLetters[nLetterIndex].Code == (AT_WCHAR)'A')
    {
        pLetters[nLetterIndex].Code = (AT_WCHAR)'Z';
    }
}

ErrCount += IG_REC_letters_set(higRecImage, pLetters, nLetterCount);
ErrCount += IG_REC_image_recognize(higRecImage);

//...

ErrCount += IG_REC_free(pLetters);
ErrCount += IG_REC_image_delete(higRecImage);
ErrCount += IG_image_delete(higImage);

See Also

HIG_REC_IMAGE