Este método remove da imagem todos os objetos em cor dos matizes especificados e os substitui pela cor especificada. Ele também permite salvar uma imagem separada que contenha apenas os objetos extraídos.
Este método pode ser usado somente com imagens em cor.
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] Refere-se ao objeto IntsCollection, que contém uma coleção dos matizes dos objetos que devem ser filtrados, na representação HSL. Você pode passar null para esse parâmetro; nesse caso, todos os objetos em cor serão removidos e restará apenas a imagem em cinza.
O número que especifica um matiz deve estar no intervalo de 0 a 255. O valor 0 corresponde à cor vermelha, 43 — à amarela, 85 — à verde, 171 — à azul, 213 — à roxa.
BackgroundColor
[in] Especifica a cor que deve substituir os objetos em cor removidos. Se você passar -1 para esse parâmetro, a cor de fundo será determinada automaticamente.
ColorLayer
[out, retval] Um ponteiro para a variável de ponteiro IImage* que recebe o ponteiro de interface do objeto Image de saída, que contém os objetos em cor extraídos.
Este método não tem valores de retorno específicos. Retorna os valores de retorno padrão das funções do ABBYY FineReader Engine.
Este método aplica filtragem por cor ao plano de cor da imagem do ImageDocument. Todas as demais páginas são excluídas do ImageDocument. Elas serão criadas sob demanda.
Também há um modo especial de pré-processamento que executa o mesmo tipo de filtragem de objetos em cor antes do reconhecimento da imagem e pode restaurá-los automaticamente antes da exportação: IPageProcessingParams::ProhibitColorObjectsAtProcessing. Escolha a configuração mais adequada para o seu cenário.
ImageDocument