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

# AddReplaceBlackPixelsRegion-Methode des ImageModification-Objekts

> AddReplaceBlackPixelsRegion-Methode des ImageModification-Objekts in der ABBYY FineReader Engine API — fügt dem internen Array eine neue „replace black pixels“-Region hinzu; ersetzt schwarze Punkte durch eine angegebene Farbe.

Diese Methode fügt dem internen Array von „replace black pixels“-Regionen des [ImageModification](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification)-Objekts eine neue „replace black pixels“-Region hinzu. Um alle zuvor hinzugefügten „replace black pixels“-Regionen zu entfernen, rufen Sie die Methode [IImageModification::ClearReplaceBlackPixelsRegions](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearreplaceblackpixelsregions-method) auf. Wenn die Modifikation auf eine einzelne [Farb-Bildebene](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color)- (oder [Graustufen-Bildebene](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#gray)-)Ebene des Bildes angewendet werden soll, sollten die Koordinaten der Region auf dieser Farb- (bzw. Graustufen-)Ebene angegeben werden. Wenn die Modifikation auf das gesamte [ImageModification](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification)-Objekt angewendet werden soll, sollten die Koordinaten auf der begradigten [Schwarzweiß](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white)-Bildebene angegeben werden.

<div id="syntax">
  ## Syntax
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT AddReplaceBlackPixelsRegion(
  IRegion* Region,
  int      Color,
  int      StrokesExpansion
);
```

### C\#

```csharp theme={null}
void AddReplaceBlackPixelsRegion(
  IRegion Region,
  int    Color,
  int    StrokesExpansion
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Sub AddReplaceBlackPixelsRegion( _
  Region As IRegion, _
  Color As Integer, _
  [StrokesExpansion As Integer = 0] _
)
```

<div id="parameters">
  ## Parameter
</div>

Region

\[in] Dieser Parameter vom Typ [Region](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region) gibt die hinzuzufügende „replace black pixels“-Region an.

Color

\[in] Diese Variable gibt die Farbe an, durch die die schwarzen Pixel ersetzt werden. Der Wert dieses Parameters kann -1 sein; das bedeutet, dass die Farbe transparent ist.

<Note>
  Der int-Wert wird aus dem RGB-Tripel anhand der Formel berechnet: ( Rotwert ) + (256 x Grünwert ) + (65536 x Blauwert ), wobei der Rotwert die erste Komponente des Tripels ist, der Grünwert die zweite und der Blauwert die dritte Komponente. Beispielsweise beträgt der int-Wert der Farbe Weiß 16777215.
</Note>

StrokesExpansion

\[in] Diese Variable gibt die Ausdehnung (in Pixeln) weißer Bereiche auf der Schwarzweiß-Bildebene vor dem Ersetzen an. Dieser Parameter muss größer oder gleich null sein.

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

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

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

Schwarze Pixel im Bild innerhalb der Regionen „replace black pixels“ werden durch Pixel der angegebenen Farbe ersetzt, wenn die Methode [IImageDocument::Modify](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument/modify-method) angewendet wird. Dieser Vorgang wird auf der [Schwarzweiß-Bildebene](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white) durchgeführt, die Ergebnisse werden jedoch auch auf die [Graustufen-Bildebene](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#gray) und die [Farb-Bildebene](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color) angewendet.

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

[ImageModification](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification)

[ClearReplaceBlackPixelsRegions](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearreplaceblackpixelsregions-method)