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

# Méthode AddReplaceBlackPixelsRegion de l’objet ImageModification

> Méthode AddReplaceBlackPixelsRegion de l’objet ImageModification dans l’API ABBYY FineReader Engine — Ajoute une nouvelle région de « remplacement des pixels noirs » au tableau interne ; remplace les points noirs par une couleur spécifiée.

Cette méthode ajoute une nouvelle région de « remplacement des pixels noirs » au tableau interne des régions de « remplacement des pixels noirs » de l'objet [ImageModification](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification). Pour supprimer toutes les régions de « remplacement des pixels noirs » ajoutées précédemment, appelez la méthode [IImageModification::ClearReplaceBlackPixelsRegions](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearreplaceblackpixelsregions-method). Si la modification doit être appliquée à un seul plan [couleur](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color) (ou [gris](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#gray)) de l'image, les coordonnées de la région doivent être spécifiées sur ce plan couleur (ou gris). Si la modification doit être appliquée à l'ensemble de l'objet [ImageModification](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification), les coordonnées doivent être spécifiées sur le plan de l'image [noir et blanc](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white) redressée.

<div id="syntax">
  ## Syntaxe
</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">
  ## Paramètres
</div>

Region

\[in] Ce paramètre de type [Region](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region) spécifie la région « remplacement des pixels noirs » à ajouter.

Color

\[in] Cette variable spécifie la couleur utilisée pour remplacer les pixels noirs. La valeur de ce paramètre peut être -1, ce qui signifie que la couleur est transparente.

<Note>
  La valeur entière int est calculée à partir du triplet RGB à l’aide de la formule : ( red value ) + (256 x green value ) + (65536 x blue value ), où red value est le premier composant du triplet, green value le deuxième composant et blue value le troisième composant. Par exemple, la valeur int de la couleur blanche est égale à 16777215.
</Note>

StrokesExpansion

\[in] Cette variable spécifie l’extension (en pixels) des zones blanches dans le plan de l’image en noir et blanc avant le remplacement. Ce paramètre doit être non négatif.

<div id="return-values">
  ## Valeurs de retour
</div>

Cette méthode n’a pas de valeur de retour spécifique. Elle renvoie les [valeurs de retour standard des fonctions d’ABBYY FineReader Engine](/fr/fine-reader/engine/api-reference/return-codes).

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

Les pixels noirs de l’image situés dans les zones « remplacement des pixels noirs » seront remplacés par des pixels de la couleur spécifiée lors de l’application de la méthode [IImageDocument::Modify](/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument/modify-method). Cette opération est effectuée sur le plan d’image [noir et blanc](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white), mais ses résultats seront également appliqués aux plans d’image [gris](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#gray) et [couleur](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color).

<div id="see-also">
  ## Voir aussi
</div>

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

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