> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 言語の使用

> SetPredefinedTextLanguage を使用して ABBYY FineReader Engine の認識言語を設定し、LanguageDetectionMode で自動検出を使用するか、カスタムのアルファベットを使ってカスタム言語を作成します。

主要な認識パラメーターの 1 つは、認識時に使用する言語です。解析と認識を実行する前に、適切な言語を設定しておくことが重要です。認識言語は、[IRecognizerParams::SetPredefinedTextLanguage](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams/setpredefinedtextlanguage-method) メソッドを使って簡単に指定できます。このメソッドは、[IRecognizerParams::TextLanguage](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams#textlanguage) プロパティに反映されます。既定では、このパラメーターは英語の認識言語で初期化されています。言語の自動検出を使用することもできます (詳細は [IRecognizerParams::LanguageDetectionMode](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams#languagedetectionmode) プロパティを参照してください) 。

<Warning>
  言語の自動検出で対象となるのは、事前定義言語のみです (一覧は [ABBYY FineReader Engine の事前定義言語](/ja/fine-reader/engine/specifications/predefined-languages) を参照してください) 。
</Warning>

以下では、ABBYY FineReader Engine が既定でサポートしている言語と、認識言語を扱うための高度な機能を提供するオブジェクトについて、役立つ情報を紹介します。

<div id="predefined-languages">
  ## 事前定義言語
</div>

ABBYY FineReader Engine には、既定でサポートされる一連の言語が用意されています。これらの言語は「事前定義言語」と呼ばれます。利用可能な事前定義言語のコレクションは [PredefinedLanguages](/ja/fine-reader/engine/api-reference/language-related-objects/predefinedlanguages) オブジェクトで表され、[Engine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface) オブジェクトの PredefinedLanguages プロパティからアクセスできます。これは [PredefinedLanguage](/ja/fine-reader/engine/api-reference/language-related-objects/predefinedlanguage) オブジェクトのコレクションです。

事前定義言語は、内部名によって識別されます。対応する事前定義言語の名前を使って、[IRecognizerParams::SetPredefinedTextLanguage](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams/setpredefinedtextlanguage-method) メソッドにより、認識言語を直接指定できます。事前定義言語の内部名の一覧については、[ABBYY FineReader Engine の事前定義言語](/ja/fine-reader/engine/specifications/predefined-languages) を参照してください。

<div id="recognition-language-for-a-text">
  ## テキストの認識言語
</div>

認識時に使用される言語は、[TextLanguage](/ja/fine-reader/engine/api-reference/language-related-objects/textlanguage) オブジェクトで表されます。認識パラメーターを指定する [RecognizerParams](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams) オブジェクトには、TextLanguage オブジェクトへの参照が格納されます。認識関数は、このオブジェクトを、入力パラメーターとして渡される [PageProcessingParams](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageprocessingparams) オブジェクトのサブオブジェクトとして受け取るか、[Layout](/ja/fine-reader/engine/api-reference/layout-related-objects/layout) オブジェクト内のブロックから取得します。

TextLanguage オブジェクトでは、主に次のプロパティを利用できます。

* 内部名。内部言語には一意の名前を付けることをお勧めします。ABBYY FineReader Engine の配布パッケージに含まれる言語には、すでに一意の名前が設定されています。新しい言語の名前も、必ず一意にしてください。
* 文字セット。TextLanguage オブジェクトには、次の文字セットが含まれます。単語間に現れる可能性のある句読点、使用禁止文字、および単語の直前または直後にのみ付く追加の句読点です。
* 禁止辞書。TextLanguage オブジェクトの ProhibitingDictionaries プロパティを使用すると、禁止辞書のコレクションを作成できます。これらの辞書に含まれる単語は、認識された単語の候補として使用できません。ただし、ほかに候補がなく、禁止語を使用する以外に選択肢がない場合は、これらの辞書の単語が認識テキストに現れることがあります。[辞書の使用方法](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-dictionaries) を参照してください。

<div id="recognition-language-for-characters">
  ## 文字の認識言語
</div>

認識時には、テキストは単語に分割され、各単語には1つまたは複数の認識言語が対応付けられます。単語内の各文字には1つの認識言語が割り当てられます。この認識言語は [BaseLanguage](/ja/fine-reader/engine/api-reference/language-related-objects/baselanguage) オブジェクトで表され、[ITextLanguage::BaseLanguages](/ja/fine-reader/engine/api-reference/language-related-objects/textlanguage#baselanguages) プロパティからアクセスできます。

BaseLanguage オブジェクトには、次のプロパティがあります。

* 内部名。内部言語には一意の名前を付けることをお勧めします。ABBYY FineReader Engine 配布パックに含まれる言語には、すでに一意の名前が設定されています。新しい言語の名前も必ず一意にしてください。

1つの基本認識言語が1つの認識単語に対応する場合、その単語内の各文字の [ICharParams::LanguageName](/ja/fine-reader/engine/api-reference/text-related-objects/charparams#languagename) プロパティには、認識後に基本言語の内部名が設定されます。複数の基本認識言語が1つの単語に対応する場合 (たとえば、2言語の複合語の場合) 、その単語内の文字の ICharParams::LanguageName プロパティは空になります。[ICharParams::LanguageId](/ja/fine-reader/engine/api-reference/text-related-objects/charparams#languageid) プロパティには、認識された単語にかかわらず、基本言語の識別子が格納されます。

* 文字セット。文字セットには、その言語のアルファベットを構成する文字、拡張アルファベットを構成する文字 (外来語で使用) 、単語の直前および直後に置く句読点、単語内での使用は許可されているものの内部スペルチェックシステムでは無視される文字、ならびに下付き文字および上付き文字で使用できる記号が含まれます。
* 辞書。単語の認識言語には辞書を関連付けることができます。[辞書の使用方法](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-dictionaries) を参照してください。

<div id="creating-a-compound-recognition-language">
  ## 複合認識言語の作成
</div>

ABBYY FineReader Engine では、あらかじめ定義された複数の認識言語を組み合わせて、複合認識言語を簡単に作成できます。これは [LanguageDatabase](/ja/fine-reader/engine/api-reference/language-related-objects/languagedatabase) オブジェクトを使用して行います。たとえば、英語とドイツ語の両方の単語を含む認識言語を作成できます。

1. [IEngine::CreateLanguageDatabase](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) メソッドを呼び出して、LanguageDatabase オブジェクトを作成します。
2. パラメーター "English,German" を指定して [ILanguageDatabase::CreateCompoundTextLanguage](/ja/fine-reader/engine/api-reference/language-related-objects/languagedatabase/createcompoundtextlanguage-method) メソッドを呼び出します。
3. 取得した [TextLanguage](/ja/fine-reader/engine/api-reference/language-related-objects/textlanguage) オブジェクトをテキスト認識に使用します。

<Warning>
  Visual Components は現在、Windows でのみサポートされています。
</Warning>

LanguageDatabase オブジェクトでは、Visual Components を使用して ABBYY FineReader Engine for Windows で作成したユーザー定義のカスタム言語をインポートすることもできます。Visual Components では、文字セット、辞書、およびユーザーが指定したその他のパラメーターを用いて、カスタム認識言語を作成できます。この方法で作成した認識言語は一連のファイルに保存され、LanguageDatabase オブジェクトを使用してアクセスできます。Visual Components で作成した言語を使用する場合は、次の手順に従います。

1. [IEngine::CreateLanguageDatabase](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) メソッドを呼び出して、LanguageDatabase オブジェクトを作成します。
2. [ILanguageDatabase::LoadFrom](/ja/fine-reader/engine/api-reference/language-related-objects/languagedatabase/loadfrom-method) メソッドを使用して、言語を LanguageDatabase オブジェクトに読み込みます。
3. LanguageDatabase オブジェクトから、必要な言語を名前で [TextLanguage](/ja/fine-reader/engine/api-reference/language-related-objects/textlanguage) オブジェクトとして取得します。
4. 取得した TextLanguage オブジェクトをテキスト認識に使用します。

<div id="see-also">
  ## 関連項目
</div>

[辞書の使用方法](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-dictionaries)

[スペースを含む単語の認識](/ja/fine-reader/engine/guided-tour/advanced-techniques/recognizing-words-with-spaces)

[中国語、日本語、韓国語の認識](/ja/fine-reader/engine/guided-tour/advanced-techniques/recognizing-cjk-languages)