Diese Methode entfernt aus dem Bild alle farbigen Objekte in den angegebenen Farbtönen und ersetzt sie durch die angegebene Farbe. Außerdem können Sie ein separates Bild speichern, das nur die extrahierten Objekte enthält.
Diese Methode kann nur bei Farbbildern verwendet werden.
HRESULT RemoveColorObjectsEx(
IIntsCollection* ColorHues,
int BackgroundColor,
IImage** ColorLayer
);
Image RemoveColorObjectsEx(
IIntsCollection ColorHues,
int BackgroundColor
);
Function RemoveColorObjectsEx( _
ColorHues As IIntsCollection, _
BackgroundColor As Integer _
) As Image
ColorHues
[in] Verweist auf das IntsCollection-Objekt, das eine Sammlung der Farbtöne der zu filternden Objekte in HSL-Darstellung enthält. Sie können für diesen Parameter null übergeben; in diesem Fall werden alle farbigen Objekte entfernt, und es bleibt nur das Graustufenbild erhalten.
Die Zahl, die einen Farbton angibt, muss im Bereich von 0 bis 255 liegen. Der Wert 0 entspricht Rot, 43 — Gelb, 85 — Grün, 171 — Blau, 213 — Violett.
BackgroundColor
[in] Gibt die Farbe an, durch die die entfernten farbigen Objekte ersetzt werden. Wenn Sie für diesen Parameter -1 übergeben, wird die Hintergrundfarbe automatisch bestimmt.
ColorLayer
[out, retval] Ein Zeiger auf die IImage*-Zeigervariable, die den Schnittstellenzeiger des Ausgabe-Image-Objekts empfängt, das die extrahierten farbigen Objekte enthält.
Diese Methode hat keine spezifischen Rückgabewerte. Sie gibt die Standard-Rückgabewerte von ABBYY FineReader Engine-Funktionen zurück.
Diese Methode wendet eine Farbfilterung auf die Farbebene des ImageDocument an. Alle anderen Seiten werden aus dem ImageDocument gelöscht. Sie werden bei Bedarf neu erstellt.
Es gibt außerdem einen speziellen Vorverarbeitungsmodus, der dieselbe Filterung von Farbobjekten vor der Bilderkennung durchführt und sie vor dem Export automatisch wiederherstellen kann: IPageProcessingParams::ProhibitColorObjectsAtProcessing. Wählen Sie die für Ihr Szenario am besten geeignete Einstellung.
ImageDocument