C# サンプルは、Windows 版 FRE でのみ使用できます。
これは Dictionary オブジェクトを使用して作成できます。Dictionary オブジェクトでは、そのメソッドを使って単語を追加または削除できます。Windows では、Dictionary オブジェクトを使用して、Dictionary ダイアログ から辞書を編集することもできます。このダイアログでは、Windows ANSI および Unicode エンコーディングの任意のテキストファイルをインポートできます (唯一の要件は、単語がスペースまたはその他の非アルファベット文字で区切られていることです) 。この種類の辞書は、UserDictionaryDescription オブジェクトで記述されます。FineReader Engine のユーザー辞書は .amd ファイル形式で、どの言語に対しても作成できます。辞書サポートのない言語では、標準辞書の代わりとして使用できます。ABBYY FineReader のユーザー辞書は、FineReader Engine では辞書拡張と呼ばれ、.ame ファイルです。これは、辞書サポートがある言語についてのみ、その言語の標準辞書の拡張として作成できます。
- 標準辞書 (StandardDictionaryDescription) の場合は、言語の ID を定義する
LanguageId プロパティを指定します。
- ユーザー辞書 (UserDictionaryDescription) の場合は、ユーザー辞書へのパスを指定する
FileName プロパティを指定します。
- 正規表現ベースの辞書 (RegExpDictionaryDescription) の場合は、正規表現を指定するために SetText メソッドを使用します。ABBYY FineReader Engine での正規表現の使用を参照してください。
- 外部辞書 (ExternalDictionaryDescription) の場合は、辞書を指定するために SetDictionary メソッドを使用します。
すべての辞書タイプには重みが割り当てられます。辞書の重みは、認識時に検出されたその辞書内の単語の重みに影響します。weight パラメーターはパーセンテージで表され、0 以上である必要があります。重みが 0 であっても、その辞書が存在しないことを自動的に意味するわけではありません。100 パーセントを超える重みも使用できますが、このようなパラメーターを使用する際には十分な注意が必要です。重みは IDictionaryDescription::Weight プロパティで指定し、既定値は 100 です。
標準辞書には CanUseTrigrams オプションもあり、選択した辞書に基づいて作成されたトライグラムをプログラムで使用することを許可または禁止できます。トライグラムは 3 文字の組み合わせです。こうした組み合わせのすべてが実際の単語に現れるわけではありません。辞書にないトライグラムを含む単語は、発音不能である可能性が非常に高くなります。トライグラムは、信頼性の低い単語を除外するために使用されます。“general” 標準辞書ではトライグラムを有効にし、用語辞書では無効にすることをお勧めします。
テキスト認識言語 (TextLanguage オブジェクト) には、その言語の単語を含む辞書と、使用禁止語を含む辞書の両方を設定できます。前者は、テキスト言語の各基本言語に対して指定され、IBaseLanguage::DictionaryDescriptions プロパティから参照できます。基本言語には辞書が関連付けられていない場合もあります。使用禁止語辞書は、ITextLanguage::ProhibitingDictionaries プロパティを通じて、テキスト認識言語に直接関連付けられます。
認識時に辞書内の単語だけを許可する場合は、IBaseLanguage::AllowWordsFromDictionaryOnly プロパティを TRUE に設定します。この場合、基本言語の辞書に見つからない単語が認識結果のテキストに現れるのは、ABBYY FineReader Engine が辞書候補をまったく見つけられなかった場合に限られます。
- 利用可能なメソッドのいずれかを使用して TextLanguage オブジェクトを作成します (例: LanguageDatabase オブジェクトの CreateTextLanguage メソッド) 。
- 新しいテキスト言語の基本言語コレクションを取得します (BaseLanguages プロパティを使用) 。
- 新しい BaseLanguage オブジェクトを作成し、基本言語のコレクションに追加します。
- 新しい基本言語の辞書記述コレクションを取得します (DictionaryDescriptions プロパティ) 。
- 辞書記述を作成し、それを基本言語の辞書記述コレクションに追加します。DictionaryDescriptions コレクションの AddNew メソッドを使用します。
- [任意] 作成した辞書の重みを指定します。
- 辞書の識別プロパティを指定します。標準辞書の場合は LanguageId プロパティ、ユーザー辞書の場合は FileName プロパティ、正規表現ベースの辞書の場合は IRegExpDictionaryDescription::SetText メソッドを呼び出し、外部辞書の場合は IExternalDictionaryDescription::SetDictionary メソッドを呼び出します。
- [任意] BaseLanguage オブジェクトのその他のプロパティを指定します。
- [任意] TextLanguage オブジェクトの ProhibitingDictionaries プロパティを使用して禁止辞書を設定します。
- 作成した TextLanguage オブジェクトを RecognizerParams オブジェクトの TextLanguage プロパティに割り当てます。
これらの手順を Windows で実装するには、以下のコード サンプルを参照してください。
// グローバル ABBYY FineReader Engine オブジェクト
FREngine::IEnginePtr Engine;
// LanguageDatabase オブジェクト
FREngine::ILanguageDatabasePtr languageDatabase;
...
// TextLanguage オブジェクトを作成し、その基本言語コレクションを取得
FREngine::ITextLanguagePtr pTextLang = languageDatabase->CreateTextLanguage();
FREngine::IBaseLanguagesPtr pBaseLangCollection = pTextLang->BaseLanguages;
// BaseLanguage オブジェクトを作成し、その辞書記述コレクションを取得
FREngine::IBaseLanguagePtr pBaseLang = pBaseLangCollection->AddNew();
pBaseLang->InternalName = L"SampleBaseLanguage";
pBaseLang->PutLetterSet( FREngine::BLLS_Alphabet, L"abc123" );
FREngine::IDictionaryDescriptionsPtr pDictDescCollection = pBaseLang->DictionaryDescriptions;
// 標準辞書記述を作成し、コレクションに追加
FREngine::IDictionaryDescriptionPtr pDicDescription =
pDictDescCollection->AddNew( FREngine::DT_SystemDictionary);
// [optional] 作成した辞書の重みを指定
pDicDescription->Weight = 100;
// 辞書の識別プロパティを指定
FREngine::IStandardDictionaryDescriptionPtr pStandardDic = pDicDescription->GetAsStandardDictionaryDescription();
pStandardDic->LanguageId = FREngine::LI_EnglishUnitedStates;
// [optional] BaseLanguage のその他のプロパティを指定
pBaseLang->AllowWordsFromDictionaryOnly = VARIANT_TRUE;
// RecognizerParams オブジェクトを作成
FREngine::IRecognizerParamsPtr pParams = Engine->CreateRecognizerParams();
// 作成した TextLanguage オブジェクトを TextLanguage プロパティに割り当て
pParams->TextLanguage = pTextLang;
...
// グローバル ABBYY FineReader Engine オブジェクト
FREngine.IEngine engine;
// LanguageDatabase オブジェクト
FREngine.ILanguageDatabase languageDatabase;
...
// TextLanguage オブジェクトを作成し、そのベース言語のコレクションを取得します
FREngine.ITextLanguage TextLang = languageDatabase.CreateTextLanguage();
FREngine.IBaseLanguages BaseLangCollection = TextLang.BaseLanguages;
// BaseLanguage オブジェクトを作成し、その辞書記述のコレクションを取得します
FREngine.IBaseLanguage BaseLang = BaseLangCollection.AddNew();
BaseLang.InternalName = "SampleBaseLanguage";
BaseLang.set_LetterSet( FREngine.BaseLanguageLetterSetEnum.BLLS_Alphabet, "abc123" );
FREngine.IDictionaryDescriptions DictDescCollection = BaseLang.DictionaryDescriptions;
// 標準辞書の記述を作成してコレクションに追加します
FREngine.IDictionaryDescription DicDescription = DictDescCollection.AddNew( FREngine.DictionaryTypeEnum.DT_SystemDictionary );
// [任意] 作成した辞書の重みを指定します
DicDescription.Weight = 100;
// 辞書の識別プロパティを指定します
FREngine.IStandardDictionaryDescription StandardDic = DicDescription.GetAsStandardDictionaryDescription();
StandardDic.LanguageId = FREngine.LanguageIdEnum.LI_EnglishUnitedStates;
// [任意] BaseLanguage のその他のプロパティを指定します
BaseLang.AllowWordsFromDictionaryOnly = true;
// RecognizerParams オブジェクトを作成します
FREngine.IRecognizerParams recParams = engine.CreateRecognizerParams();
// 作成した TextLanguage オブジェクトを TextLanguage プロパティに割り当てます
recParams.TextLanguage = TextLang;
...
キャッシュ辞書を使用するには、IEngine::AutoCleanRecognizerSession プロパティを FALSE に設定する必要があります。AutoCleanRecognizerSession プロパティの既定値は TRUE です。つまり、FineReader Engine は各ページの認識後に認識セッションをクリーンアップし、その際にキャッシュ辞書もクリーンアップされます。ユーザーデータが誤って破棄されるのを防ぐため、FineReader Engine はこのモードでのキャッシュ辞書の使用を禁止しています。キャッシュ辞書を使用する場合は、必要に応じて IEngine::CleanRecognizerSession メソッドを呼び出し、認識セッションを手動でクリーンアップする必要があります。認識セッションをクリーンアップする必要があるタイミングについては、このメソッドの説明を参照してください。 