ImageGear for C and C++ on Windows v19.7 - Updated
IG_REC_output_missing_symbol_set
API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Output Functions > IG_REC_output_missing_symbol_set

Specifies the code of the missing symbol.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_output_missing_symbol_set(
   AT_WCHAR MissSym
);

Arguments:

Name Type Description
MissSym AT_WCHAR The missing symbol to be set.

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.

Remarks:

The missing symbol is a special character that replaces any character that was recognized by the recognition engine but could not be represented in the final output document, since the character does not exist in the current Code Page.

  1. During the conversion to the final output document, the IG_REC_document_write function tries to find a replacement character with a similar shape for one not supported by the current Code Page. Only if this attempt is not successful, the missing symbol is placed in the final output document.
  2. If this function is not called, the default missing character, L"^" (the CIRCUMFLEX character) is applied.
  3. It is best to use a keyboard character for the missing symbol, so that it is supported by all Code Pages. If the defined missing symbol is itself missing from the selected Code Page, a character with a similar shape is set and an error is set with IGE_REC_CHR_MISSINGEXPORT_ERR value.
  4. If the missing symbol to be set is contained within the ANSI 1252 Code Page, you can define it with a literal string, e.g.: L"#". If it is not, a UNICODE value should be given.