> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ImageModification オブジェクトの AddReplaceWhitePixelsRegion メソッド

> ABBYY FineReader Engine API の ImageModification オブジェクトの AddReplaceWhitePixelsRegion メソッド — 内部配列に新しい白ピクセル置換領域を追加し、白いドットを指定した色に置換します。

このメソッドは、[ImageModification](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification) オブジェクトが内部で保持する「白ピクセル置換」領域の配列に、新しい「白ピクセル置換」領域を追加します。以前に追加した「白ピクセル置換」領域をすべて削除するには、[IImageModification::ClearReplaceWhitePixelsRegions](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearreplacewhitepixelsregions-method) メソッドを呼び出します。変更を画像の単一の [color](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color) (または [gray](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#gray)) 画像プレーンに適用する場合は、領域の座標をその color (gray) 画像プレーン上で指定する必要があります。変更を [ImageModification](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification) 全体に適用する場合は、座標を傾き補正済みの [black-and-white](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white) 画像プレーン上で指定する必要があります。

<div id="syntax">
  ## 構文
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT AddReplaceWhitePixelsRegion(
  IRegion* Region,
  int      Color,
  int      StrokesExpansion
);
```

### C\#

```csharp theme={null}
void AddReplaceWhitePixelsRegion(
  IRegion Region,
  int     Color,
  int     StrokesExpansion
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Sub AddReplaceWhitePixelsRegion( _
  Region As IRegion, _
  Color  As Integer, _
  [StrokesExpansion As Integer = 0] _
)
```

<div id="parameters">
  ## パラメーター
</div>

Region

\[in] この[Region](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region)型のパラメーターは、追加する「白ピクセル置換」領域を指定します。

Color

\[in] この変数は、白色ピクセルの置換に使用する色を指定します。このパラメーターの値には -1 を指定できます。この場合、色が透明であることを意味します。

<Note>
  int 値は、RGB の各値から次の式で計算されます: ( 赤の値 ) + (256 x 緑の値 ) + (65536 x 青の値 )。ここで、赤の値は 1 番目の要素、緑の値は 2 番目の要素、青の値は 3 番目の要素です。たとえば、白色の int 値は 16777215 です。
</Note>

StrokesExpansion

\[in] この変数は、置換前に画像内の黒色領域を拡張する量 (ピクセル単位) を指定します。このパラメーターは 0 以上である必要があります。

<div id="return-values">
  ## 戻り値
</div>

このメソッド固有の戻り値はありません。戻り値として、[ABBYY FineReader Engine 関数の標準戻り値](/ja/fine-reader/engine/api-reference/return-codes)が返されます。

<div id="remarks">
  ## 注記
</div>

[IImageDocument::Modify](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument/modify-method) メソッドを適用すると、「白ピクセル置換」領域内の画像の白いピクセルは、指定した色のピクセルに置き換えられます。この操作は [black-and-white](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white) 画像プレーンに対して実行されますが、その結果は [gray](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#gray) および [color](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color) 画像プレーンにも反映されます。

<div id="see-also">
  ## 関連項目
</div>

[ImageModification](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification)

[ClearReplaceWhitePixelsRegions](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearreplacewhitepixelsregions-method)