FRPage オブジェクトの DetectOrientation メソッド

このメソッドは、画像上のテキストの向きを検出します。向きの検出に成功した場合は TextOrientation オブジェクトを返し、検出に失敗した場合は NULL を返します。

​

構文

​

C++

HRESULT DetectOrientation(
  IObjectsExtractionParams*    ExtractionParams,
  IRecognizerParams*           RecognizerParams,
  ITextOrientation**           Result
);

​

C#

ITextOrientation DetectOrientation(
  IObjectsExtractionParams    ExtractionParams,
  IRecognizerParams           RecognizerParams
);

​

Visual Basic .NET

Function DetectOrientation( _
  [ExtractionParams As IObjectsExtractionParams = Nothing], _
  [RecognizerParams As IRecognizerParams = Nothing] _
) As ITextOrientation

​

Parameters

ExtractionParams

[in] この変数は、オブジェクト抽出のパラメータを格納する ObjectsExtractionParams オブジェクトを参照します。このパラメータには 0 を指定できます。その場合、オブジェクトはデフォルトのパラメータで抽出されます。プロファイルが読み込まれている場合は、そのプロファイルで設定されたパラメータが使用されます。

RecognizerParams

[in] この変数は、ページ認識のパラメータを格納する RecognizerParams オブジェクトを参照します。このパラメータには 0 を指定できます。その場合、デフォルトのパラメータが使用されます。プロファイルが読み込まれている場合は、そのプロファイルで設定されたパラメータが使用されます。

Result

[out, retval] TextOrientation 出力オブジェクトのインターフェースポインタを受け取る ITextOrientation* ポインタ変数へのポインタです。このオブジェクトを通じて、ページ上のテキストの向きにアクセスできます。向きの検出に失敗した場合は、NULL が返されます。

​

戻り値

このメソッドに固有の戻り値はありません。ABBYY FineReader Engine 関数の標準的な戻り値を返します。

​

サンプル

C# コード

FREngine.IFRDocument frdoc;
// ドキュメントが作成され、画像が追加済みであることを前提とします
// ドキュメント内の各ページの向きを取得する
int pagesCount = frDoc.Pages.Count;
FREngine.RotationTypeEnum[] rotations = new FREngine.RotationTypeEnum[pagesCount];
for (int i = 0; i < pagesCount; i++)
{
 FREngine.IFRPage page = frDoc.Pages[i];
 FREngine.ITextOrientation ori = page.DetectOrientation(null, null);
 rotations[i] = FREngine.RotationTypeEnum.RT_UnknownRotation;
 if( ori != null ) {
  rotations[i] = ori.RotationType;
 }
}

​

関連項目

FRPage

IPagePreprocessingParams::CorrectOrientationMode

プロファイルの操作