ImageModification オブジェクト（IImageModification インターフェイス）

ABBYY FineReader Engine API の ImageModification オブジェクト（IImageModification インターフェイス）— IImageDocument.Modify の画像変更パラメーター（クリップ、ペイント、反転、黒ピクセル置換、白ピクセル置換、ごみ除去の各領域、および伸張）を格納します。

このオブジェクトは、画像変更のパラメーターを格納するために使用されます。画像を変更するメソッド IImageDocument::Modify は、ほかのいくつかのメソッドと同様に、このオブジェクトへの参照を入力パラメーターとして受け取ります。ImageModification では、伸張、クリッピング領域、色反転領域、ペイント領域、ピクセル置換領域、ごみ除去領域の設定など、画像に対して幅広い操作を行えます。画像は次のように変更されます。

• 領域内のテキストの色とごみのサイズが決定されます。
• クリッピング領域内の画像部分が切り取られます。
• “Paint” 領域は対応する色で塗りつぶされます。
• “invert” 領域内の色は反転されます。
• “黒ピクセル置換” 領域内の黒い点は、対応する色の点に置き換えられます。
• “白ピクセル置換” 領域内の白い点は、対応する色の点に置き換えられます。
• “remove ごみ” 領域内のごみは除去されます。この変更は、白黒イメージプレーンにのみ適用できます。
• 画像は StretchRatio プロパティで定義されたストレッチ比で伸張されます。

このオブジェクトに追加されるすべての領域は、画像矩形の境界を超えてはなりません。

ImageModification オブジェクトは永続オブジェクトです。これは、オブジェクトの現在の状態を永続ストレージに書き込めることを意味します。後で、永続ストレージからオブジェクトの状態を読み取ることで、オブジェクトを再作成できます。次のメソッドは、オブジェクトの永続化を提供します。

Linux: SaveToFile および LoadFromFile

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

​

プロパティ

Name	Type	Description
Application	Engine, 読み取り専用	Engine オブジェクトを返します。
StretchRatio	double	画像に適用するストレッチ比を指定します。既定値は 1.0 で、これはストレッチなしを意味します。

​

メソッド

名前	説明
AddClipRegion	クリッピング領域の内部配列に、新しいクリッピング領域を追加します。
AddInvertRegion	色反転領域の内部配列に、新しい色反転領域を追加します。
AddPaintRegion	ペイント領域の内部配列に、新しいペイント領域を追加します。
AddReplaceBlackPixelsRegion	「黒ピクセル置換」領域の内部配列に、新しい「黒ピクセル置換」領域を追加します。
AddReplaceWhitePixelsRegion	「白ピクセル置換」領域の内部配列に、新しい「白ピクセル置換」領域を追加します。
ClearClipRegions	クリッピング領域の内部配列をクリアします。
ClearInvertRegions	色反転領域の内部配列をクリアします。
ClearPaintRegions	ペイント領域の内部配列をクリアします。
ClearReplaceBlackPixelsRegions	「黒ピクセル置換」領域の内部配列をクリアします。
ClearReplaceWhitePixelsRegions	「白ピクセル置換」領域の内部配列をクリアします。
CopyFrom	現在のオブジェクトのプロパティを、別のオブジェクトの対応するプロパティの値で初期化します。
LoadFromFile	ディスク上のファイルからオブジェクトの内容を復元します。
LoadFromMemory	グローバルメモリからオブジェクトの内容を復元します。 Windows のみ。
SaveToFile	オブジェクトの内容をディスク上のファイルに保存します。
SaveToMemory	オブジェクトの内容をグローバルメモリに保存します。 Windows のみ。

​

出力パラメーター

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

​

入力パラメーター

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

• Image オブジェクトの WriteToFile、EstimateBitmapSize (Win) 、GetBitmap (Win) メソッド
• ImageDocument オブジェクトの Modify メソッド。

​

サンプル

C# code

int splitStartPosition;
int splitEndPosition;
bool isVerticalSplit;
FREngine.IFRDocument frDoc;
FREngine.IFRPage page;
// ドキュメントページの画像を2つのページに分割します
// 画像のサイズ
int width = page.ImageDocument.ColorImage.Width;
int height = page.ImageDocument.ColorImage.Height;
// ページを複製
frDoc.AddPage(page);
FREngine.IFRPage secondPage = frDoc.Pages[frDoc.Pages.Count - 1];
// 1つ目と2つ目のページを切り抜き
FREngine.IImageModification firstModification = engine.CreateImageModification();
FREngine.IRegion firstClipRegion = engine.CreateRegion();
FREngine.IImageModification secondModification = engine.CreateImageModification();
FREngine.IRegion secondClipRegion = engine.CreateRegion();
if (isVerticalSplit)
{
 firstClipRegion.AddRect(0, 0, splitStartPosition, height - 1 );
 secondClipRegion.AddRect(splitEndPosition, 0, width - 1, height - 1);
}
else
{
 firstClipRegion.AddRect(0, 0, width - 1, splitStartPosition);
 secondClipRegion.AddRect(0, splitEndPosition, width - 1, height - 1);
}
firstModification.AddClipRegion(firstClipRegion);
page.ImageDocument.Modify(firstModification);
secondModification.AddClipRegion(secondClipRegion);
secondPage.ImageDocument.Modify(secondModification);

​

関連項目

画像の操作

プロパティの操作