Skip to main content
This object provides means for performing advanced operations with recognition languages. It allows you to work with the whole set of ABBYY FineReader Engine predefined languages, and also to import custom languages. This object allows you to create compound recognition language of several predefined languages and/or imported custom languages.
Visual Components are currently only supported for Windows.
You may combine the loaded custom languages with each other and with predefined languages and use them for text recognition. You may choose not to load any custom languages into the language database. In this case, only the predefined languages will be available. In Windows, Visual Components, with their user interface, provide relatively simple way to create custom recognition languages. See the procedure of creating and importing recognition languages in the description of the ILanguageDatabase::LoadFrom method.
For Linux and macOS , you can create custom recognition languages in the Windows version of ABBYY FineReader Engine.

​
Properties

Name

Type

Description

Application

Engine, read-only

Returns the Engine object.

DictionaryExtensionsPath

BSTR

Specifies the full path to the folder with dictionary extension files (*.ame). These files contain words added to the dictionary by the user; they can only be created for languages that already have standard dictionary support. These files can be created in ABBYY FineReader, where they are called user dictionaries. ABBYY FineReader stores extensions of standard dictionaries in the %appdata%\ABBYY\FineReader\15\FineReaderShell\UserDictionaries folder.

You can edit dictionary extension as a user dictionary via the Dictionary object, which can be received with the help of the OpenDictionaryExtension method.

By default, this property contains the path to the UserDictionaries folder, located in the FineReader Engine data folder:

  • Linux for automatic installation: /var/lib/ABBYY/SDK/12/FineReader Engine
  • macOS for automatic installation: /Library/Application Support/ABBYY/SDK/12/FineReader Engine
  • Windows: FineReader Engine data folder

​
Methods

NameDescription
CreateCompoundTextLanguageCreates the TextLanguage object of one or more predefined and/or custom languages included in the language database.
CreateNewDictionaryCreates a new empty user dictionary at the specified location and returns interface pointer of the Dictionary object associated with it.
CreateTextLanguageCreates the TextLanguage object.
LoadFromLoads custom languages into the language database.
OpenDictionaryExtensionProvides access to the dictionary extension of the standard dictionary for the specified language. The path to the dictionary extension is defined by the DictionaryExtensionsPath property.
OpenExistingDictionaryOpens an existing user dictionary for editing.

​
Output parameter

This object is the output parameter of the CreateLanguageDatabase method of the Engine object.

​
Samples

FREngine.IEngine engine;
// Use LanguageDatabase to create a compound text language
FREngine.ILanguageDatabase langDatabase = Engine.CreateLanguageDatabase();
FREngine.ITextLanguage textLanguage =
 langDatabase.CreateCompoundTextLanguage( "English,German" );
The object is used in the following code samples:

​
See also

Working with Languages