跳轉到主要內容
此方法會從影像中移除所有指定色相的彩色物件,並以指定的顏色加以取代。您也可以將僅包含擷取物件的影像另存為獨立影像。
此方法僅適用於彩色影像。

語法

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] 指向 IntsCollection 物件,此物件包含必須篩選之物件的色相集合,並以 HSL 表示。您可以為此參數傳遞 null;在此情況下,會移除所有彩色物件,只保留灰階影像。 用來指定色相的數值必須介於 0 到 255 之間。值 0 對應紅色,43 — 對應黃色,85 — 對應綠色,171 — 對應藍色,213 — 對應紫色。 BackgroundColor [in] 指定用來取代已移除彩色物件的顏色。如果您為此參數傳遞 -1,則會自動判定背景顏色。 ColorLayer [out, retval] 指向 IImage* 指標變數的指標。該變數會接收輸出 Image 物件的介面指標,其中包含擷取出的彩色物件。

傳回值

此方法沒有特定傳回值。它會傳回 ABBYY FineReader Engine 函式的標準傳回值

備註

此方法會將色彩篩選套用至 ImageDocument 的 color 影像平面。ImageDocument 中的所有其他頁面都會被刪除,並在需要時重新建立。 另有一種特殊的預處理模式,會在影像辨識前執行相同類型的色彩物件篩選,並可在匯出前自動將這些物件還原:IPageProcessingParams::ProhibitColorObjectsAtProcessing。請根據您的使用情境選擇最合適的設定。

另請參閱

ImageDocument