> ## 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 RemoveColorObjectsEx del objeto ImageDocument

> Método RemoveColorObjectsEx del objeto ImageDocument en la API de ABBYY FineReader Engine: elimina todos los objetos de color de los tonos especificados y los sustituye por un color indicado; opcionalmente, guarda por separado una imagen de los objetos extraídos; solo para imágenes en color.

Este método elimina de la imagen todos los objetos de color de los tonos especificados y los sustituye por el color indicado. También permite guardar por separado una imagen que contenga únicamente los objetos extraídos.

<Warning>
  Este método solo puede usarse con imágenes en color.
</Warning>

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

**ColorHues**

\[in] Hace referencia al objeto [IntsCollection](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/intscollection), que contiene una colección de los tonos de los objetos que se deben filtrar, en representación HSL. Puede pasar null para este parámetro; en ese caso, se eliminan todos los objetos de color y solo permanece la imagen en gris.

El número que especifica un tono debe estar en el intervalo de 0 a 255. El valor 0 corresponde al color rojo, 43 — al amarillo, 85 — al verde, 171 — al azul, 213 — al púrpura.

**BackgroundColor**

\[in] Especifica el color que debe sustituir a los objetos de color eliminados. Si pasa -1 para este parámetro, el color de fondo se determina automáticamente.

**ColorLayer**

\[out, retval] Un puntero a la variable de puntero IImage\* que recibe el puntero de interfaz del objeto [Image](/es/fine-reader/engine/api-reference/image-related-objects/image) de salida que contiene los objetos de color extraídos.

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

Este método aplica un filtrado por color al plano de imagen [color](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color) de ImageDocument. Todas las demás páginas se eliminan de ImageDocument. Se volverán a crear cuando sea necesario.

También existe un modo especial de preprocesamiento que realiza el mismo tipo de filtrado de objetos de color antes de reconocer la imagen y puede restaurarlos automáticamente antes de la exportación: [IPageProcessingParams::ProhibitColorObjectsAtProcessing](/es/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageprocessingparams#prohibitcolorobjectsatprocessing). Elija la configuración más adecuada para su caso de uso.

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

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