Block オブジェクト（IBlock インターフェイス）

ABBYY FineReader Engine API の Block オブジェクト（IBlock インターフェイス）— 認識済みページ上の単一のブロックを表します。ブロックの型（テキスト、テーブル、ラスター画像/ベクター画像、バーコード、チェックマーク/グループ、セパレーター/グループ）、領域、レイヤー、および特定のブロックのサブタイプにキャストするためのメソッドを公開します。

このオブジェクトは、単一のブロックを表します。ページを認識する際、ABBYY FineReader Engine はまずページのレイアウトを解析し、ページ上のさまざまな型のブロックを検出します。ブロックは画像領域の認識方法を決定し、認識後は認識された情報を保持します。

ページ上の各ブロックは、text、table、ラスター画像、ベクター画像、バーコード、チェックマーク、チェックマークの group、セパレーター、セパレーターの group の9つの型のいずれかに属します。ブロックの型は Type プロパティで定義されます。Block オブジェクトは、自身を子オブジェクトのいずれかに型変換するメソッドを提供しており、これにより特定の型のブロックの拡張属性にアクセスできます。

画像上のブロックの位置は、その領域 (Region プロパティ) と、そのブロックが属するレイヤー (BlockLayerType プロパティ) によって定義されます。

FRPage のレイアウトから取得したブロックは、このページ、またはそのページが属するドキュメントに対してレイアウト解析を実行するいずれかのメソッド (Analyze や Process など) を呼び出すと無効になります。解析後は、新しいレイアウト内で必要なブロックを見つけ、新しい Block オブジェクトを使用して作業を続けてください。

​

プロパティ

	, read-only	Engine オブジェクトを返します。
		ブロックの region へのアクセスを提供します。region は矩形のコレクションです。他のブロック型とは異なり、テーブルブロックの region に含められる矩形は最大1つです。そのため、複数の矩形を含む region をテーブルブロックに割り当てようとするとエラーが発生します。region は、対応する画像の傾き補正済み black-and-white プレーン上における矩形の座標 (ピクセル単位) によって定義されます。 このプロパティは定数オブジェクトを返します。ブロックの region を変更するには、まず IEngine::CreateRegion メソッドを使用して中間の Region オブジェクトを取得し、必要なパラメーターを変更したうえで、取得したオブジェクトをプロパティに割り当ててください。
	, read-only	ABBYY FineReader Engine では、テキスト、テーブル、ラスター画像、ベクター画像、バーコード、チェックマーク、チェックマークグループ、区切り線、区切り線グループ、および自動解析というブロック型が使用されます (自動解析ブロックはビジュアルコンポーネントでのみ使用されます) 。各ブロック型には固有のプロパティがあります。 ブロック型は作成時に決定され、後から変更することはできません。ブロック型を変更する必要がある場合は、既存のブロックを削除し、まったく同じ場所に必要な型の新しいブロックを作成してください。 メソッドを使用して オブジェクトを作成し、 メソッドを使用して、置き換えるブロックの region をコピーします。 メソッドを呼び出して、レイアウトから古いブロックを削除します。 必要な型の新しいブロックを作成し、LayoutBlocks オブジェクトの メソッドを使用してレイアウトブロックのコレクションに追加します。古いブロックからコピーした Region を必須パラメーターの1つとして渡します。
	, read-only	ブロックの背景色を指定します。 int 値は、次の式を使用して RGB トリプレットから計算されます： (赤の値) + (256 × 緑の値) + (65536 × 青の値) 。ここで、赤の値はトリプレットの第1成分、緑の値は第2成分、青の値は第3成分です。たとえば、白の int 値は 16777215 です。 デフォルトでは、このプロパティの値は -1 で、色が透明であることを示します。
	, read-only	ブロックのレイヤー (背景、前景、または非表示) を指定します。ブロックは重ね合わせることができます。たとえば、テキストブロックを背景の画像ブロックの上に重ねることができます。 RasterPictureBlock および VectorPictureBlock については、 SetBlockLayerType メソッドを使用してレイヤーを変更できます。 デフォルトでは、このプロパティの値は BLT_Foreground です。
		ブロックの説明を格納します。 デフォルトでは、このプロパティの値は空の文字列です。
		ブロックの名前を格納します。任意の文字列を使用できます。 デフォルトでは、このプロパティの値は空の文字列です。
		任意の型のユーザー定義情報を Block 型のオブジェクトに関連付けることができます。

​

メソッド

名前	説明
GetAsBarcodeBlock	ブロックを BarcodeBlock オブジェクトとして返します。ブロックがバーコード ブロックでない場合は、NULL が返されます。
GetAsCheckmarkBlock	ブロックを CheckmarkBlock オブジェクトとして返します。ブロックがチェックマーク ブロックでない場合は、NULL が返されます。
GetAsCheckmarkGroup	ブロックを CheckmarkGroup オブジェクトとして返します。ブロックがチェックマーク グループ ブロックでない場合は、NULL が返されます。
GetAsRasterPictureBlock	ブロックを RasterPictureBlock オブジェクトとして返します。ブロックがラスター画像ブロックでない場合は、NULL が返されます。
GetAsSeparatorBlock	ブロックを SeparatorBlock オブジェクトとして返します。ブロックがセパレーター ブロックでない場合は、NULL が返されます。
GetAsSeparatorGroup	ブロックを SeparatorGroup オブジェクトとして返します。ブロックがセパレーター グループ ブロックでない場合は、NULL が返されます。
GetAsTableBlock	ブロックを TableBlock オブジェクトとして返します。ブロックがテーブルブロックでない場合は、NULL が返されます。
GetAsTextBlock	ブロックを TextBlock オブジェクトとして返します。ブロックがテキスト ブロックでない場合は、NULL が返されます。
GetAsVectorPictureBlock	ブロックを VectorPictureBlock オブジェクトとして返します。ブロックがベクター画像ブロックでない場合は、NULL が返されます。
Move	ブロックの領域を指定したベクトル分だけ移動します。

​

関連オブジェクト

​

Windows

​

Linux および macOS

オブジェクト図

​

出力パラメーター

このオブジェクトは、LayoutBlocksオブジェクトのItemメソッドおよびAddNewメソッドの出力パラメーターです。

​

サンプル

C# コード

int picturesCount = 0;
int suspiciousCharsCount = 0;
int totalCharsCount = 0;
int barcodesCount = 0;
// テキスト内の文字数、疑わしい文字数、画像数、バーコード数を計算します
void computeStatisticsForBlock(FREngine.IBlock block)
{
 if (block.Type == FREngine.BlockTypeEnum.BT_Table)
 {
  FREngine.ITableBlock tableBlock = block.GetAsTableBlock();
  for (int iCell = 0; iCell < tableBlock.Cells.Count; iCell++)
  {
   computeStatisticsForBlock(tableBlock.Cells[iCell].Block);
  }
 }
 else if (block.Type == FREngine.BlockTypeEnum.BT_Text)
 {
  FREngine.ITextBlock textBlock = block.GetAsTextBlock();
  int paragraphsCount = textBlock.Text.Paragraphs.Count;
  for (int iPar = 0; iPar < paragraphsCount; iPar++)
  {
   FREngine.IParagraph par = textBlock.Text.Paragraphs[iPar];
   string text = par.Text;
   totalCharsCount += text.Length;
   FREngine.ICharParams charParams = engine.CreateCharParams();
   for (int iChar = 0; iChar < text.Length; iChar++)
   {
    par.GetCharParams(iChar, charParams);
    if (charParams.IsSuspicious)
    {
     suspiciousCharsCount++;
    }
   }
  }
 }
 else if (block.Type == FREngine.BlockTypeEnum.BT_RasterPicture || block.Type == FREngine.BlockTypeEnum.BT_VectorPicture)
 {
  picturesCount++;
 }
 else if (block.Type == FREngine.BlockTypeEnum.BT_Barcode)
 {
  barcodesCount++;
 }
}

このオブジェクトは、次のコード サンプルで使用されています。

• Linux: CustomLanguage, CommandLineInterface

• Windows: CustomLanguage, CommandLineInterface, RecognizedTextProcessing、およびデモ ツール: Engine の定義済み処理プロファイル。

​

関連項目

LayoutBlocks

Layout と Block の操作

プロパティ の操作