ImageDocument オブジェクト（IImageDocument インターフェイス）

ABBYY FineReader Engine API の ImageDocument オブジェクト（IImageDocument インターフェイス）— 開いている画像を表し、4 つの image plane（black-and-white、gray、color、preview）のルートであるとともに、認識精度または視覚的な表示を向上させるための画像前処理メソッド一式を提供します。

このオブジェクトは、開いている画像、つまり「画像ドキュメント」に対応します。その属性は画像の属性を反映します。ImageDocument オブジェクトは、Image オブジェクト、すなわち「image plane」のコレクションのルートです。各画像ドキュメントには、black-and-white、gray、color、preview の 4 つの「image plane」が含まれます。これらには対応するプロパティからアクセスできます。

このオブジェクトには、画像の前処理メソッドが多数用意されています。これらのメソッドの一部は写真にのみ適しており、ほかのメソッドはあらゆる種類のドキュメントに使用できます。認識精度を向上させるメソッドもあれば、画像の見栄えだけを改善するメソッドもありますが、その場合は認識精度が低下することがあります。後者は認識後にのみ使用してください。各メソッドの説明をよく読み、そのメソッドが自分のシナリオで使用できるかどうかを確認してください。以下に、画像前処理メソッドの推奨される使用順序を示します (一覧の中から、自分のシナリオに適したメソッドのみを使用してください) 。

• 認識精度を向上させるには:
  1. 画像を切り抜く
  2. 局所コントラストを強調する
  3. 向きを補正する (必要なパラメーターを指定して Transform メソッドを使用)
  4. 画像を反転または鏡像化する (必要なパラメーターを指定して Transform メソッドを使用)
  5. 傾きを補正する
  6. 見開きページを分割する (FRDocument object の SplitPages メソッドを使用)
  7. 幾何学的なゆがみを除去する
  8. ごみを除去する
  9. ノイズを除去する
  10. モーションブラーを除去する
  11. 色オブジェクトを抑制する
  12. 色オブジェクトを除去する
• 画像の見た目を改善するには:
  1. 明るさを均一化し、背景を白くする
  2. 画像のテクスチャを滑らかにする
  3. 画像にディザリングを適用する

これらの前処理メソッドはすべて、開いている画像に適用する必要があることに注意してください。画像に対する一部の変更は、画像を開く処理の途中で適用することもできます。画像を開く際の前処理について詳しくは、PrepareImageMode オブジェクトと PagePreprocessingParams オブジェクトの説明を参照してください。

ImageDocument オブジェクトは、いわゆる「connectable object」です。Windows 用 FRE の Visual Basic では、WithEvents として宣言できます。C++ (サポート対象のすべてのオペレーティングシステム) では、これは IConnectionPointContainer インターフェイスをサポートしていることを意味します。処理中の通知イベントを受け取るには、C++ ユーザーは IImageDocumentEvents インターフェイスから派生したオブジェクトを作成し、次の操作を行う必要があります。

• Linux および macOS: AdviseFREngineObject グローバル関数を呼び出して、そのオブジェクトを ImageDocument オブジェクトに advise します。
• Windows: 標準的な COM の手段で、オブジェクトと、ImageDocument オブジェクトに実装されているイベントソースとの接続を設定します。

Windows: ImageDocument オブジェクトのメソッドは、特別な送出インターフェイスを通じてページ処理の進行状況に関する情報を通知します。これらのインターフェイスは、IImageDocumentEvents (C++ 用) および dispinterface DIImageDocumentEvents (Visual Basic 用) です。Visual Basic ユーザーは、イベントインターフェイス実装の詳細を気にする必要はありません。この開発プラットフォームには、それらを簡単に処理するための手段が用意されているためです。

​

プロパティ

	, read-only	オブジェクトを返します。
	, read-only	現在の ImageDocument オブジェクトの 白黒 イメージプレーンへのアクセスを提供します。
	, read-only	現在の ImageDocument オブジェクトの カラー イメージプレーンへのアクセスを提供します。
	, read-only	現在の ImageDocument オブジェクトの グレー イメージプレーンへのアクセスを提供します。
	, read-only	画像ドキュメントの ID を格納します。
	, read-only	画像ドキュメントの各カラープレーンは、それぞれ固有のカラー型を持ちます。このプロパティは、各カラープレーン (白黒、グレー、カラー) の対応する値の最大値を、画像ドキュメント全体のカラー型として指定します。
	, read-only	画像ドキュメントがメモリのみに格納されているか、ディスク上のフォルダとしても保存されているかを指定します。 SaveTo メソッドを呼び出した後も、このプロパティの値は変更されません。 LoadImageDoc メソッドを呼び出して画像ドキュメントを再読み込みする必要があります。
	, read-only	ディスク上のオブジェクトの内部表現を含むフォルダへのパスを格納します。IsInMemory プロパティの値が TRUE の場合、このプロパティは空の文字列を返します。 SaveTo メソッドを呼び出した後も、このプロパティの値は変更されません。 LoadImageDoc メソッドを呼び出して画像ドキュメントを再読み込みする必要があります。
	, read-only	現在の変更状態におけるピクセル座標の情報を含む オブジェクトを返します。 このプロパティは、画像処理中に2つの状態間で座標を変換する必要がある場合に役立ちます。
	、読み取り専用	ImageDocument オブジェクトがメモリに読み込まれてから、または最後に メソッドが呼び出されてから、変更が加えられたかどうかを示します。
	、読み取り専用	画像を開いてから適用された回転を示します。
	、読み取り専用	このプロパティが TRUE の場合、画像を開いてから色が反転されたことを示します。
	、読み取り専用	このプロパティが TRUE の場合、画像を開いてから垂直軸を中心にミラー反転されたことを示します。
	、読み取り専用	このプロパティは、画像の傾きが、開く際、前処理中、または メソッドの呼び出し時に完全に補正されたかどうかを示します。 補正された傾き角度の正接は SkewAngle プロパティに格納されます。
	、読み取り専用	画像に対して検出され、開く際、前処理中、または メソッドの呼び出し時に補正された傾き角度の正接を格納します。傾き角度が負の場合、画像は時計回りに回転しています。角度が正の場合、画像は反時計回りに回転しています。画像は任意の点を中心に回転できます。傾き補正後の画像のサイズは、常に元の画像より大きくなります。 画像にさらに変更を加えると、このプロパティの値は 0 にリセットされます。補正された傾き角度の値が必要な場合は、画像を編集する他のメソッドを呼び出す前に保存してください。
	、読み取り専用	ImageDocument オブジェクトがテキストを含むファイルから作成されたかどうかを示します。たとえば、PDF ファイルにはテキストレイヤーを含めることができます。
	、読み取り専用	ImageDocument オブジェクトが写真ファイルから作成されたかどうかを示します。
	、読み取り専用	現在の ImageDocument オブジェクトのソース画像ファイルの形式に関する情報を提供します。この情報が利用できない場合、またはスキャナーから画像を受信した場合、このプロパティの値は IFF_UnknownFormat になります。
	、読み取り専用	画像の取得に使用されたスキャナーに関する情報を提供します。ソース画像のパラメーターに関する情報が利用できない場合、またはファイルから画像を受信した場合、このプロパティの値は空文字列になります。
	、読み取り専用	現在の ImageDocument オブジェクトのスキャン強度しきい値に関する情報を提供します。ソース画像のパラメーターに関する情報が利用できない場合、またはファイルから画像を取得した場合、このプロパティの値は -1 になります。
	、読み取り専用	現在の ImageDocument オブジェクトのソース画像の水平解像度に関する情報を提供します。ソース画像のパラメーターに関する情報が利用できない場合、このプロパティの値は 0 になります。
	、読み取り専用	現在の ImageDocument オブジェクトのソース画像の垂直解像度に関する情報を提供します。ソース画像のパラメーターに関する情報が利用できない場合、このプロパティの値は 0 になります。

​

メソッド

名称	説明
ApplySigmaFilter	このメソッドは、画像にノイズ低減フィルターを適用します。主に写真に効果的です。
ChangeResolution	画像の解像度を変更します。
CorrectShadowsAndHighlights	画像の過度な影やハイライトを補正します。
CorrectSkew	画像の傾きを補正します。
CropImage	画像内の文書の境界を検出して、画像を切り抜きます。
DitherImage	Floyd–Steinberg または Bayer (順序付き) ディザリングアルゴリズムを使用して、画像にディザリングを適用します。
EnhanceLocalContrast	画像の局所的なコントラストを高めます。
EqualizeBrightness	画像の明るさを均一化します。このメソッドは、グレースケール画像およびカラー画像でのみ使用できます。
FindBlackSquares	画像内の黒い四角形を検出します。
GetPreviewImage	現在のImageDocumentオブジェクトの94 * 60サイズのプレビュー画像プレーンにアクセスします。このサイズのプレビューがまだ作成されていない場合は、この呼び出し中に作成されるため、多少時間がかかります。
GetPreviewImageSpecificSize	現在のImageDocumentオブジェクトのpreview画像プレーンにアクセスし、サイズを指定できます。このサイズのプレビューがまだ作成されていない場合は、この呼び出し時に作成されるため、多少時間がかかることがあります。
GetTextBackgroundColor	画像上の指定した矩形内にあるテキストと背景の色を検出します。
Modify	画像を変更できます。このメソッドでは、Transform メソッドよりも高度な変更を行えます。
RemoveColorObjects	画像全体またはその一部から、指定した色オブジェクトを削除します。このメソッドは、カラー画像でのみ使用できます。
RemoveColorObjectsEx	画像から指定した色相のすべての色オブジェクトを削除し、指定した色に置き換えます。削除したオブジェクトは、別の画像として保存できます。
RemoveGarbage	画像からごみ (一定のサイズ未満の余分な点) を除去します。
RemoveGeometricalDistortions	画像の幾何学的な歪み (ページの端付近で線が曲がるなど) を補正します。
RemoveMotionBlur	画像からモーションブラーを除去します。
RemoveNoise	画像のノイズを低減します。
SaveImageRegionTo	画像の各部分をディスク上のフォルダーに保存します。保存される画像は ABBYY FineReader Engine の内部形式です。
SaveModified	現在のImageDocumentオブジェクトに加えられたすべての変更を、ディスク上のフォルダーに保存します。
SaveTo	ImageDocument オブジェクトの内容をディスク上のフォルダーに保存します。画像は ABBYY FineReader Engine の内部形式で保存されます。
SaveToFile	ImageDocument オブジェクトの内容をファイルに保存します。
SaveToMemory 注: Windows 専用。	ImageDocument オブジェクトの内容をグローバル メモリに保存します。
SmoothImage	画像を平滑化できます。このメソッドは、グレースケール画像およびカラー画像でのみ使用できます。
SmoothTexture	非線形フィルターを使用して画像を滑らかにします。テクスチャのある画像に適しています。このメソッドは、各辺が3ピクセル以上のグレー画像およびカラー画像でのみ使用できます。
Transform	画像に対して、限られた種類の変換を適用します。

​

関連するオブジェクト

オブジェクト図

​

出力パラメーター

このオブジェクトは、Engine オブジェクトの次のメソッドにおける出力パラメーターです。LoadImageDocFromFile、LoadImageDocFromMemory (Windows のみ) 、LoadImageDoc、OpenBitmap、OpenDib、OpenBitmapBits、OpenImageFileFromMemory。

​

入力パラメーター

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

• AddImageDocument メソッド (FRDocument オブジェクト)
• SetImageData メソッド (TrainingImage オブジェクト)

​

サンプル

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

Linux: CommandLineInterface および BCR

macOS: 名刺認識

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

​

関連項目

IImageDocumentEvents

画像の操作

使用

プロパティの使用