Region オブジェクト（IRegion インターフェイス）

ABBYY FineReader Engine API の Region オブジェクト（IRegion インターフェイス）— 重なりのない矩形の集合として、左から右または上から下の順に FineReader Engine ブロックの領域を格納する補助オブジェクト。

これは補助オブジェクトです。ABBYY FineReader Engine のブロック領域に関する情報を格納するために使用されます。

領域は、一連の矩形として表されます。

• 互いに交差したり重なったりしないように配置される
• 左から右、または上から下の順に追加される

ABBYY FineReader Engine の領域の例を以下に示します。

空の Region オブジェクトは、IEngine::CreateRegion メソッドを呼び出して作成できます。その後、IRegion::AddRect メソッドを呼び出して、矩形を 1 つずつ追加できます。Region オブジェクトはこの順序での追加に最適化されており、この方法が矩形を追加する最も高速な方法であるため、矩形は上から下 (または左から右) の順に追加することをお勧めします。

Region オブジェクトは永続オブジェクトです。つまり、オブジェクトの現在の状態を永続ストレージに書き込むことができます。後で、永続ストレージからオブジェクトの状態を読み取ることで、オブジェクトを再作成できます。次のメソッドを使用すると、オブジェクトを永続化できます。

Linux: SaveToFile、および LoadFromFile

Windows SaveToFile、LoadFromFile、SaveToMemory、および LoadFromMemory。

​

プロパティ

名前	型	説明
Application	Engine, 読み取り専用	Engine オブジェクトを返します。
Bottom	int, 読み取り専用	指定されたRectangleの下辺の座標を返します。
BoundingRectangle	FRRectangle, 読み取り専用	領域全体を含む最小のRectangleを返します。
Count	int, 読み取り専用	領域内のRectangleの数を保持します。
IsEmpty	VARIANT_BOOL, 読み取り専用	領域が空かどうかを示します。
Left	int, 読み取り専用	指定されたRectangleの左辺の座標を返します。
Right	int, 読み取り専用	指定されたRectangleの右辺の座標を返します。
Top	int, 読み取り専用	指定されたRectangleの上辺の座標を返します。

​

メソッド

Name	Description
AddRect	領域に領域を追加します。
AddRegion	既存の領域に新しい領域を追加します。
CopyFrom	別のオブジェクトの対応するプロパティの値を使用して、現在のオブジェクトのプロパティを初期化します。
CutRect	領域からRectangle領域を切り取ります。
HasIntersectionWithRect	領域が指定したRectangleと交差するかどうかを判定します。
HasIntersectionWithRegion	領域が指定した領域と交差するかどうかを判定します。
IsEqual	領域が指定した領域と等しいかどうかを判定します。
IsPointInRegion	指定した点が領域内にあるかどうかを判定します。
IsRectInRegion	指定したRectangleが領域内に含まれているかどうかを判定します。
IsRegionInRegion	指定した領域が領域内に含まれているかどうかを判定します。
LoadFromFile	ディスク上のファイルからオブジェクトの内容を復元します。
LoadFromMemory 注: Windows のみ。	グローバルメモリからオブジェクトの内容を復元します。
MakeEmpty	領域からすべてのRectangleを削除します。
SaveToFile	オブジェクトの内容をディスク上のファイルに保存します。
SaveToMemory 注: Windows のみ。	オブジェクトの内容をグローバルメモリに保存します。

​

関連オブジェクト

オブジェクト図

​

出力パラメーター

このオブジェクトは、Engine オブジェクトの CreateRegion メソッドの出力パラメーターです。

​

入力パラメーター

このオブジェクトは、次のメソッドの入力パラメーターとして渡されます。

• AnalyzeRegion、SynthesizeBusinessCard、SynthesizeBusinessCardEx メソッド (FRPage オブジェクトの)
• RemoveColorObjects、RemoveMotionBlur、RemoveGarbage、SmoothImage、SaveImageRegionTo メソッド (ImageDocument オブジェクトの)
• AddNew メソッド (CheckmarkGroup オブジェクトの)
• AddNew メソッド (SeparatorGroup オブジェクトの)
• Add、InsertAt メソッド (RegionsCollection オブジェクトの)
• SetImageData メソッド (TrainingImage オブジェクトの)
• AddClipRegion、AddInvertRegion、AddPaintRegion、AddReplaceBlackPixelsRegion、AddReplaceWhitePixelsRegion メソッド (ImageModification オブジェクトの)
• Windows Visual Components:
  • OnAnalyzeRegion、OnToolChangeBlockRegion メソッド (IImageViewerEvents インターフェイスの)
  • OnAnalyzeRegion、OnToolChangeBlockRegion メソッド (IZoomViewerEvents インターフェイスの)

​

サンプル

このオブジェクトは、名刺認識 (macOS) のサンプルコードで使用されます。

​

関連項目

プロパティの操作