> ## 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 AddReplaceWhitePixelsRegion del objeto ImageModification

> Método AddReplaceWhitePixelsRegion del objeto ImageModification en la API de ABBYY FineReader Engine — Agrega una nueva región de replace white pixels al array interno; reemplaza puntos blancos por un color especificado.

Este método agrega una nueva región de "replace white pixels" al arreglo interno de regiones de "replace white pixels" del objeto [ImageModification](/es/fine-reader/engine/api-reference/image-related-objects/imagemodification). Para eliminar todas las regiones de "replace white pixels" agregadas previamente, llame al método [IImageModification::ClearReplaceWhitePixelsRegions](/es/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearreplacewhitepixelsregions-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 [gray](/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 (o de gray). 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 AddReplaceWhitePixelsRegion(
  IRegion* Region,
  int      Color,
  int      StrokesExpansion
);
```

### C\#

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

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

```vb theme={null}
Sub AddReplaceWhitePixelsRegion( _
  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 "replace white pixels" que se va a agregar.

Color

\[in] Esta variable especifica el color con el que se reemplazan los píxeles blancos. 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 del triplete 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 del triplete, valor de verde es el segundo componente del triplete y valor de azul es el tercer componente del triplete. 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 negras de la imagen antes del reemplazo. Este parámetro debe ser un valor 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 blancos de la imagen que se encuentren dentro de las regiones "replace white pixels" 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 sus resultados también se aplicarán a los planos de imagen [gray](/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)

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