Questo metodo rimuove dall’immagine tutti gli oggetti colorati delle tonalità specificate e li sostituisce con il colore indicato. Consente inoltre di salvare un’immagine separata contenente solo gli oggetti estratti.
Questo metodo può essere utilizzato solo con immagini a colori.
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] Fa riferimento all’oggetto IntsCollection, che contiene una raccolta delle tonalità degli oggetti da filtrare, nella rappresentazione HSL. Per questo parametro puoi passare null; in tal caso vengono rimossi tutti gli oggetti colorati e rimane solo l’immagine in scala di grigi.
Il numero che specifica una tonalità deve essere compreso nell’intervallo da 0 a 255. Il valore 0 corrisponde al rosso, 43 — al giallo, 85 — al verde, 171 — al blu, 213 — al viola.
BackgroundColor
[in] Specifica il colore che deve sostituire gli oggetti colorati rimossi. Se per questo parametro passi -1, il colore di sfondo viene determinato automaticamente.
ColorLayer
[out, retval] Puntatore alla variabile puntatore IImage* che riceve il puntatore all’interfaccia dell’oggetto Image di output contenente gli oggetti colorati estratti.
Questo metodo non ha valori restituiti specifici. Restituisce i valori restituiti standard delle funzioni di ABBYY FineReader Engine.
Questo metodo applica il filtraggio dei colori al piano di immagine color di ImageDocument. Tutte le altre pagine vengono eliminate da ImageDocument. Verranno ricreate su richiesta.
Esiste anche una speciale modalità di preelaborazione che esegue lo stesso tipo di filtraggio degli oggetti colorati prima del riconoscimento dell’immagine e può ripristinarli automaticamente prima dell’esportazione: IPageProcessingParams::ProhibitColorObjectsAtProcessing. Scegli l’impostazione più adatta al tuo caso d’uso.
ImageDocument