Este método elimina de la imagen todos los objetos en 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.
Este método solo puede usarse con imágenes en color.
HRESULT RemoveColorObjectsEx(
IIntsCollection* ColorHues,
int BackgroundColor,
IImage** ColorLayer
);
Image RemoveColorObjectsEx(
IIntsCollection ColorHues,
int BackgroundColor
);
Function RemoveColorObjectsEx( _
ColorHues As IIntsCollection, _
BackgroundColor As Integer _
) As Image
ColorHues
[in] Hace referencia al objeto 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 en 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 en 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 de salida que contiene los objetos en color extraídos.
Este método no tiene valores de retorno específicos. Devuelve los valores de retorno estándar de las funciones de ABBYY FineReader Engine.
Este método aplica un filtrado por color al plano de imagen 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. Elija la configuración más adecuada para su caso de uso.
ImageDocument