Vai al contenuto principale
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.

Sintassi

C++

HRESULT RemoveColorObjectsEx(
  IIntsCollection* ColorHues,
  int              BackgroundColor,
  IImage**         ColorLayer
);

C#

Image RemoveColorObjectsEx(
  IIntsCollection ColorHues,
  int            BackgroundColor
);

Visual Basic .NET

Function RemoveColorObjectsEx( _
  ColorHues As IIntsCollection, _
  BackgroundColor As Integer _
) As Image

Parametri

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.

Valori restituiti

Questo metodo non ha valori restituiti specifici. Restituisce i valori restituiti standard delle funzioni di ABBYY FineReader Engine.

Note

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.

Vedi anche

ImageDocument