L_Doc2SelectLanguages

#include "ltdoc2.h"

L_LTDOC2_API L_INT EXT_FUNCTION L_Doc2SelectLanguages(hDoc, pLangIds, nLangCount)

Activates the specified languages into the OCR document engine.

Parameters

L_HDOC2 hDoc

Handle to the OCR document.

DOC2_LANGIDS * pLangIds

Array of language ids that will be activated.

L_INT nLangCount

Number of language array elements in pLangIds.

Returns

Value Meaning
SUCCESS The function was successful.
< 1 An error occurred. Refer to Return Codes.

Comments

Defines the main part of the Language environment of the Character Set.

If this function is not called to specify the language(s) to be recognized, the default value, the English language, is applied.

To get the currently supported languages, call the L_Doc2GetSupportedLanguages function.

To get the current activated languages, call the L_Doc2GetSelectedLanguages / L_Doc2GetSelectedLanguagesExt function.

To get the character options for the current activated languages, call the L_Doc2GetCharLangsOptions / L_Doc2GetCharLangsOptionsExt function.

To recognize page or set of pages, call the L_Doc2Recognize / L_Doc2RecognizeExt function.

Required DLLs and Libraries

See Also

Functions

Topics

Example

L_INT Doc2SelectLanguagesExample(L_HDOC2 hDoc) 
{ 
   L_INT nRet; 
   CHAROPTIONS2 CharOpts; 
   DOC2_LANGIDS SelLangs[1]; 
 
   SelLangs[0] = DOC2_LANG_ID_ENGLISH; 
 
   nRet = L_Doc2SelectLanguages(hDoc, SelLangs, 1); 
   if (nRet != SUCCESS) 
   { 
      MessageBox(NULL, TEXT("Couldn't set English as the default language."), TEXT("Error!"), MB_OK); 
      return nRet; 
   } 
 
   ZeroMemory(&CharOpts, sizeof(CHAROPTIONS2)); 
   nRet = L_Doc2GetCharLangsOptions(hDoc, &CharOpts, sizeof(CHAROPTIONS2)); 
   if(nRet != SUCCESS) 
      return nRet; 
 
   if (CharOpts.CharFilter != DOC2_ZONE_CHAR_FILTER_ALL) 
      CharOpts.CharFilter = DOC2_ZONE_CHAR_FILTER_ALL; 
 
   nRet = L_Doc2SetCharLangsOptions (hDoc, &CharOpts); 
   if(nRet != SUCCESS) 
      return nRet; 
 
   if (CharOpts.pszCharFilterPlus) 
      GlobalFreePtr(CharOpts.pszCharFilterPlus); 
 
   if (CharOpts.pszCharPlus) 
      GlobalFreePtr(CharOpts.pszCharPlus); 
   return SUCCESS; 
} 
Help Version 21.0.2021.4.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS OCR Module - OmniPage Engine C API Help