Specifies the Spelling language for the language checking of the checking subsystem.

Declaration:

AT_ERRCOUNT ACCUAPI IG_REC_spelling_language_set(
   enumIGRecLanguages Lang
);

Arguments:

Return Value:

Supported Raster Image Formats:

This function does not process image pixels.

Example:

AT_ERRCOUNT ErrCount = 0;
HIG_REC_IMAGE higRecImage = 0;
HIGEAR higImage = 0;

ErrCount += IG_load_file("Image.tif", &higImage); 
ErrCount += IG_REC_image_import(higImage, &higRecImage);

//...

ErrCount += IG_REC_spelling_is_enabled_set(TRUE);
ErrCount += IG_REC_correction_is_enabled_set(TRUE);
ErrCount += IG_REC_spelling_language_set(IG_REC_LANG_ENG);
ErrCount += IG_REC_image_recognize(higRecImage);

//...

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

Remarks:

1. Spelling language is a page-level setting. Once spell checking is specified, it is applied to all zones on the page, except in zones with their IG_REC_ZCF_LANGDICT_PROHIBIT flag set. This is useful for excluding zones containing mostly proper names or text in a different language.
2. When the SpellLang parameter is IG_REC_LANG_NO, or if it specifies a language for which there is no language dictionary available, the language checking won't be activated during recognition.
3. When the SpellLang parameter is set to IG_REC_LANG_AUTO, the language checking will be performed according to the actual recognition language selection (IG_REC_languages_set) as follows:
   • If the recognition language selection is empty, there won't be language checking.
   • If one language has been set for the Language environment of the Character Set, that language will be automatically selected for language checking assuming that the appropriate Language dictionary is available.
   • If two or more languages are selected for recognition, language checking will be done for all selected languages for which a Language dictionary is available.
4. The available spelling languages can be enumerated through the IG_REC_spelling_language_first_get and IG_REC_spelling_language_next_get functions. They will enumerate those dictionaries present in the Recognition Binary directory.
5. The application should call this (and other checking-related functions) BEFORE calling the IG_REC_image_recognize function.
6. If this function is not called to specify the Spelling language, the default value of IG_REC_LANG_AUTO is applied.