LanguageDatabase Object (ILanguageDatabase Interface)

LanguageDatabase object (ILanguageDatabase interface) in the ABBYY FineReader Engine API — Provides advanced operations for working with FineReader Engine predefined and custom recognition languages, including creating compound text languages and managing user dictionaries.

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

Name	Description
CreateCompoundTextLanguage	Creates the TextLanguage object of one or more predefined and/or custom languages included in the language database.
CreateNewDictionary	Creates a new empty user dictionary at the specified location and returns interface pointer of the Dictionary object associated with it.
CreateTextLanguage	Creates the TextLanguage object.
LoadFrom	Loads custom languages into the language database.
OpenDictionaryExtension	Provides 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.
OpenExistingDictionary	Opens an existing user dictionary for editing.

Output parameter

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

Samples

C# code

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:

• Linux: CustomLanguage, CommandLineInterface
• Windows: CustomLanguage, CommandLineInterface; and demo tools: BatchProcessingRecognition, MultiProcessingRecognition, PDFExportProfiles

See also

Working with Languages