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

# RemoveColorObjectsEx-Methode des ImageDocument-Objekts

> RemoveColorObjectsEx-Methode des ImageDocument-Objekts in der ABBYY FineReader Engine API — Entfernt alle Farbobjekte in den angegebenen Farbtönen und ersetzt sie durch eine angegebene Farbe; speichert optional ein separates Bild mit den extrahierten Objekten; nur für Farbbilder.

Diese Methode entfernt aus dem Bild alle Farbobjekte 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.

<Warning>
  Diese Methode kann nur bei Farbbildern verwendet werden.
</Warning>

<div id="syntax">
  ## 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">
  ## Parameter
</div>

**ColorHues**

\[in] Verweist auf das [IntsCollection](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/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 Farbobjekte 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 Farbobjekte 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](/de/fine-reader/engine/api-reference/image-related-objects/image)-Objekts empfängt, das die extrahierten Farbobjekte enthält.

<div id="return-values">
  ## Rückgabewerte
</div>

Diese Methode hat keine spezifischen Rückgabewerte. Sie gibt die [Standard-Rückgabewerte von ABBYY FineReader Engine-Funktionen](/de/fine-reader/engine/api-reference/return-codes) zurück.

<div id="remarks">
  ## Hinweise
</div>

Diese Methode wendet eine Farbfilterung auf die [Farb](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color)ebene 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](/de/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageprocessingparams#prohibitcolorobjectsatprocessing). Wählen Sie die für Ihr Szenario am besten geeignete Einstellung.

<div id="see-also">
  ## Siehe auch
</div>

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