ImageGear for C and C++ on Windows v19.3 - Updated
IG_REC_spelling_is_enabled_set
API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Spelling Settings Functions > IG_REC_spelling_is_enabled_set

Enables or disables the checking subsystem.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_spelling_is_enabled_set(
   AT_BOOL bChksubsystem
);

Arguments:

Name Type Description
bChksubsystem AT_BOOL Flag that indicates whether the checking subsystem is enabled or disabled.

Return Value:

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

Supported Raster Image Formats:

This function does not process image pixels.

Example:

 
Copy Code
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_image_recognize(higRecImage);

//...

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

Remarks:

Running the checking subsystem may improve the overall throughput by marking suspicious words and characters, making it easier to correct them. It can also be set to improve accuracy by auto-correcting suspicious recognized words.

  1. The functionality of the checking subsystem consists of three parts:
    • Spell checking (use of the Language dictionary)
    • UD-checking (use of the User dictionary)
    • User-written checking (use of user-written callback functions)

    Once the checking subsystem has been enabled, it can still be configured to use any combination of these three possible checking methods.

    • The language for spell checking (the Spelling language) is specified with IG_REC_spelling_language_set.
    • The User dictionary is specified with IG_REC_UD_set. During UD-checking, the recognized result of a zone is checked against the UDitems belonging to the zone's UserDictionarySection section in the User dictionary.
    • For user-written checking of the zone contents, LPFNIG_REC_WORD_CHECK callback functions should be written giving a different type of control to the programmer to influence the decision of the checking.
  2. Depending on the current setting of the Correction mode, the checking subsystem will either only mark non-compliant words or can be permitted to auto-correct them. The Correction mode can be specified by the IG_REC_correction_is_enabled_set function.
  3. By default the checking subsystem is enabled.