> ## 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.

# ImageDocument オブジェクトの RemoveColorObjectsEx メソッド

> ABBYY FineReader Engine API の ImageDocument オブジェクトの RemoveColorObjectsEx メソッド。指定した色相のカラーオブジェクトをすべて削除し、指定した色に置き換えます。必要に応じて、抽出したオブジェクトのみを含む別の画像を保存することもできます。カラー画像のみ。

このメソッドは、指定した色相のカラーオブジェクトを画像からすべて削除し、指定した色に置き換えます。また、抽出したオブジェクトだけを含む別の画像として保存することもできます。

<Warning>
  このメソッドは、カラー画像でのみ使用できます。
</Warning>

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

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

```cpp theme={null}
HRESULT RemoveColorObjectsEx(
  IIntsCollection* ColorHues,
  int              BackgroundColor,
  IImage**         ColorLayer
);
```

### C\#

```csharp theme={null}
Image RemoveColorObjectsEx(
  IIntsCollection ColorHues,
  int            BackgroundColor
);
```

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

```vb theme={null}
Function RemoveColorObjectsEx( _
  ColorHues As IIntsCollection, _
  BackgroundColor As Integer _
) As Image
```

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

**ColorHues**

\[in] フィルター処理するオブジェクトの色相のコレクションを HSL 表現で格納した [IntsCollection](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/intscollection) オブジェクトを指定します。このパラメーターには null を渡すこともでき、その場合はすべてのカラーオブジェクトが削除され、グレー画像だけが残ります。

色相を指定する数値は、0 から 255 の範囲でなければなりません。値 0 は赤、43 は黄、85 は緑、171 は青、213 は紫に対応します。

**BackgroundColor**

\[in] 削除されたカラーオブジェクトの置換に使用する色を指定します。このパラメーターに -1 を渡すと、背景色は自動的に決定されます。

**ColorLayer**

\[out, retval] 抽出されたカラーオブジェクトを含む出力 [Image](/ja/fine-reader/engine/api-reference/image-related-objects/image) オブジェクトのインターフェイス ポインターを受け取る IImage\* ポインター変数へのポインターです。

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

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

<div id="remarks">
  ## 備考
</div>

このメソッドは、ImageDocument の [color](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color) 画像プレーンにカラー フィルタリングを適用します。それ以外のページはすべて ImageDocument から削除され、必要に応じて再作成されます。

また、画像認識の前に同様のカラーオブジェクトのフィルタリングを実行し、エクスポート前にそれらを自動的に復元できる特別な前処理モードもあります: [IPageProcessingParams::ProhibitColorObjectsAtProcessing](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageprocessingparams#prohibitcolorobjectsatprocessing)。ご利用のシナリオに最も適した設定を選択してください。

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

[ImageDocument](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument)