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

構文

C++

HRESULT RemoveColorObjectsEx(
  IIntsCollection* ColorHues,
  int              BackgroundColor,
  IImage**         ColorLayer
);

C#

Image RemoveColorObjectsEx(
  IIntsCollection ColorHues,
  int            BackgroundColor
);

Visual Basic .NET

Function RemoveColorObjectsEx( _
  ColorHues As IIntsCollection, _
  BackgroundColor As Integer _
) As Image

パラメーター

ColorHues [in] フィルター処理するオブジェクトの色相のコレクションを HSL 表現で格納した IntsCollection オブジェクトを指定します。このパラメーターには null を渡すこともでき、その場合はすべてのカラーオブジェクトが削除され、グレー画像だけが残ります。 色相を指定する数値は、0 から 255 の範囲でなければなりません。値 0 は赤、43 は黄、85 は緑、171 は青、213 は紫に対応します。 BackgroundColor [in] 削除されたカラーオブジェクトの置換に使用する色を指定します。このパラメーターに -1 を渡すと、背景色は自動的に決定されます。 ColorLayer [out, retval] 抽出されたカラーオブジェクトを含む出力 Image オブジェクトのインターフェイス ポインターを受け取る IImage* ポインター変数へのポインターです。

戻り値

このメソッド固有の戻り値はありません。ABBYY FineReader Engine 関数の標準戻り値を返します。

備考

このメソッドは、ImageDocument の color 画像プレーンにカラー フィルタリングを適用します。それ以外のページはすべて ImageDocument から削除され、必要に応じて再作成されます。 また、画像認識の前に同様のカラーオブジェクトのフィルタリングを実行し、エクスポート前にそれらを自動的に復元できる特別な前処理モードもあります: IPageProcessingParams::ProhibitColorObjectsAtProcessing。ご利用のシナリオに最も適した設定を選択してください。

関連項目

ImageDocument