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

# ColorObjectsProhibitingParams オブジェクト（IColorObjectsProhibitingParams インターフェイス）

> ABBYY FineReader Engine API の ColorObjectsProhibitingParams オブジェクト（IColorObjectsProhibitingParams インターフェイス）— 処理前の色オブジェクト（スタンプ、署名など）のフィルタリングを調整します。PageProcessingParams のサブオブジェクトです。

このオブジェクトは、処理の開始前に画像内の色オブジェクトを除外するためのフィルタリングパラメーターを調整するために使用します。この種の前処理は、認識対象のドキュメントに色付きのスタンプや署名などが含まれていて、それが認識品質の低下につながる可能性がある場合に役立ちます。このオブジェクトのプロパティを使用すると、除外する色のコレクションを設定できるほか、認識後に色オブジェクトを再度画像に戻すかどうかを指定できます。

このオブジェクトは、[PageProcessingParams](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageprocessingparams) オブジェクトのサブオブジェクトとしてのみ存在できます。親オブジェクトと一緒に作成するか、永続ストレージに書き込む必要があります。

<div id="properties">
  ## プロパティ
</div>

| 名前                                 | 型                                                                                                                                                                                                              | 説明                                                                                                                                                                                                                                |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Application                        | [エンジン](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface), [読み取り専用](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | [エンジン](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface) オブジェクトを返します。                                                                                                                                         |
| BackgroundColor                    | [int](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)                                                                                                      | 削除された色オブジェクトの代わりに使用する色を指定します。 <Note> int 値は、RGB の 3 要素から次の式で計算されます: ( 赤の値 ) + (256 x 緑の値 ) + (65536 x 青の値 )。ここで、赤の値は 1 番目の要素、緑の値は 2 番目の要素、青の値は 3 番目の要素です。たとえば、白の int 値は 16777215 です。 </Note> このプロパティの既定値は -1 で、この場合、色は自動的に選択されます。 |
| ColorHues                          | [IntsCollection](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/intscollection)                                                                                                        | フィルター処理するオブジェクトの色相のコレクションを、HSL 表現で指定します。色相を表す数値は、0 から 255 の範囲でなければなりません。値 0 は赤、43 は黄、85 は緑、171 は青、213 は紫に対応します。既定ではコレクションは空で、これはすべての色オブジェクトが除去され、グレースケール画像のみが処理に渡されることを意味します。                                                     |
| RestoreColorObjectsAfterProcessing | [VARIANT\_BOOL](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)                                                                                            | 処理完了後に、色オブジェクトを画像上に再配置するかどうかを指定します。高品質の認識テキストと、スタンプや署名などがすべて保持されたカラー画像の両方を取得する必要がある場合は、このプロパティを TRUE に設定します。これは、たとえば image-on-text PDF にエクスポートする場合に役立ちます。このプロパティの既定値は TRUE です。                                                    |

<div id="related-objects">
  ## 関連オブジェクト
</div>

<img src="https://mintcdn.com/abbyy/6udH-pkk8zkVafYH/images/fine-reader/engine/colorobjectsprohibitingparams.gif?s=4e7ff3dbb9cd21a87d58a8ec3c8b652d" alt="ColorObjectsProhibitingParams" width="244" height="54" data-path="images/fine-reader/engine/colorobjectsprohibitingparams.gif" />[](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageprocessingparams#colorobjectsprohibitingparams)[](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageprocessingparams)

[オブジェクト図](/ja/fine-reader/engine/api-reference/object-diagram)

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

色オブジェクトのフィルタリングで同様の処理を行い、さらに抽出したカラーレイヤーを別の画像として保存できる [ImageDocument](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument) オブジェクトの [RemoveColorObjectsEx](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument/removecolorobjectsex-method) メソッドの使用もご検討ください。

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

[前処理、解析、認識、合成のチューニングパラメーター](/ja/fine-reader/engine/guided-tour/advanced-techniques/tuning-parameters-of-preprocessing-analysis-recognition-and-synthesis)

[プロパティの操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)