メインコンテンツへスキップ
このメソッドは、ImageModification オブジェクトが内部で保持する「黒ピクセル置換」領域の配列に、新しい「黒ピクセル置換」領域を追加します。前に追加した「黒ピクセル置換」領域をすべて削除するには、IImageModification::ClearReplaceBlackPixelsRegions メソッドを呼び出します。変更を画像の単一の color (または gray) プレーンに適用する場合は、その color (gray) プレーン上で領域の座標を指定する必要があります。変更を ImageModification オブジェクト全体に適用する場合は、傾き補正済みの black-and-white 画像プレーン上で座標を指定する必要があります。

​
構文

​
C++

HRESULT AddReplaceBlackPixelsRegion(
  IRegion* Region,
  int      Color,
  int      StrokesExpansion
);

​
C#

void AddReplaceBlackPixelsRegion(
  IRegion Region,
  int    Color,
  int    StrokesExpansion
);

​
Visual Basic .NET

Sub AddReplaceBlackPixelsRegion( _
  Region As IRegion, _
  Color As Integer, _
  [StrokesExpansion As Integer = 0] _
)

​
パラメーター

Region [in] Region 型のこのパラメーターは、追加する「黒ピクセル置換」領域を指定します。 Color [in] この変数は、黒いピクセルの置換に使用する色を指定します。このパラメーターの値には -1 を指定することもでき、その場合、色は透明を意味します。
int 値は、RGB の 3 要素から次の式で計算されます: ( 赤の値 ) + (256 x 緑の値 ) + (65536 x 青の値 )。ここで、赤の値は 1 番目の要素、緑の値は 2 番目の要素、青の値は 3 番目の要素です。たとえば、白の int 値は 16777215 です。
StrokesExpansion [in] この変数は、置換前に白黒画像平面上の白い領域をどれだけ拡張するか (ピクセル単位) を指定します。このパラメーターには 0 以上の値を指定する必要があります。

​
戻り値

このメソッド固有の戻り値はありません。戻り値としては、ABBYY FineReader Engine 関数の標準的な戻り値が返されます。

​
注記

IImageDocument::Modify メソッドを適用すると、“黒ピクセル置換” 領域内の画像の黒いピクセルは、指定した色のピクセルに置き換えられます。この操作は black-and-white 画像プレーンに対して実行されますが、その結果は gray および color 画像プレーンにも反映されます。

​
関連項目

ImageModification ClearReplaceBlackPixelsRegions