> ## 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étodo AddReplaceBlackPixelsRegion del objeto ImageModification

> Método AddReplaceBlackPixelsRegion del objeto ImageModification en la API de ABBYY FineReader Engine: agrega una nueva región para reemplazar píxeles negros al arreglo interno; reemplaza puntos negros por un color especificado.

Este método agrega una nueva región de "reemplazar píxeles negros" al arreglo interno de regiones de "reemplazar píxeles negros" del objeto [ImageModification](/es/fine-reader/engine/api-reference/image-related-objects/imagemodification). Para eliminar todas las regiones de "reemplazar píxeles negros" agregadas anteriormente, llame al método [IImageModification::ClearReplaceBlackPixelsRegions](/es/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearreplaceblackpixelsregions-method). Si la modificación debe aplicarse a un único plano [color](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color) (o [gris](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#gray)) de la imagen, las coordenadas de la región deben especificarse en ese plano de color (gris). Si la modificación debe aplicarse a todo el objeto [ImageModification](/es/fine-reader/engine/api-reference/image-related-objects/imagemodification), las coordenadas deben especificarse en el plano de imagen [blanco y negro](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white) con la inclinación corregida.

<div id="syntax">
  ## Sintaxis
</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">
  ## Parámetros
</div>

Region

\[in] Este parámetro del tipo [Region](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region) especifica la región "reemplazar píxeles negros" que se va a añadir.

Color

\[in] Esta variable especifica el color con el que se sustituyen los píxeles negros. El valor de este parámetro puede ser -1, lo que significa que el color es transparente.

<Note>
  El valor `int` se calcula a partir de la terna RGB mediante la fórmula: ( valor de rojo ) + (256 x valor de verde ) + (65536 x valor de azul ), donde valor de rojo es el primer componente de la terna, valor de verde es el segundo componente y valor de azul es el tercer componente. Por ejemplo, el valor `int` del color blanco es 16777215.
</Note>

StrokesExpansion

\[in] Esta variable especifica la expansión (en píxeles) de las áreas blancas del plano de imagen en blanco y negro antes de la sustitución. Este parámetro debe ser no negativo.

<div id="return-values">
  ## Valores de retorno
</div>

Este método no tiene valores de retorno específicos. Devuelve los [valores de retorno estándar de las funciones de ABBYY FineReader Engine](/es/fine-reader/engine/api-reference/return-codes).

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

Los píxeles negros de la imagen que se encuentren dentro de las regiones "reemplazar píxeles negros" se sustituirán por píxeles del color especificado cuando se aplique el método [IImageDocument::Modify](/es/fine-reader/engine/api-reference/image-related-objects/imagedocument/modify-method). Esta operación se realiza en el plano de imagen [blanco y negro](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white), pero los resultados también se aplicarán a los planos de imagen [gris](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#gray) y [color](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color).

<div id="see-also">
  ## Consulte también
</div>

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

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