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

​
構文

​
C++

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

​
C#

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

​
Visual Basic .NET

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

​
パラメーター

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

​
戻り値

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

​
注記

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

​
関連項目

ImageModification ClearReplaceWhitePixelsRegions