Vai al contenuto principale
Questo oggetto viene utilizzato per regolare i parametri di filtro degli oggetti colorati nell’immagine prima di avviare l’elaborazione. Questo tipo di pre-elaborazione può essere utile nei casi in cui il documento da riconoscere contenga timbri colorati, firme ecc., che possono ridurre la qualità del riconoscimento. Tramite le proprietà di questo oggetto, è possibile configurare l’insieme dei colori da filtrare e specificare se, dopo il riconoscimento, gli oggetti colorati devono essere ripristinati nell’immagine. Questo oggetto può esistere solo come sotto-oggetto dell’oggetto PageProcessingParams. Deve essere creato o scritto nell’archiviazione persistente insieme all’oggetto padre.

​
Proprietà

NomeTipoDescrizione
ApplicationEngine, di sola letturaRestituisce l’oggetto Engine.
BackgroundColorintSpecifica il colore che deve sostituire gli oggetti colorati rimossi. <Note> Il valore int viene calcolato a partire dalla tripletta RGB usando la formula: ( valore del rosso ) + (256 x valore del verde ) + (65536 x valore del blu ), dove il valore del rosso è il primo componente della tripletta, il valore del verde è il secondo componente e il valore del blu è il terzo componente. Ad esempio, il valore int del colore bianco è 16777215. </Note> Il valore predefinito di questa proprietà è -1, il che significa che il colore verrà selezionato automaticamente.
ColorHuesIntsCollectionSpecifica la raccolta delle tonalità degli oggetti che devono essere filtrati, nella rappresentazione HSL. 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. Per impostazione predefinita, la raccolta è vuota, il che significa che tutti gli oggetti colorati verranno filtrati e che verrà elaborata solo l’immagine in scala di grigi.
RestoreColorObjectsAfterProcessingVARIANT_BOOLSpecifica se, al termine dell’elaborazione, gli oggetti colorati devono essere ripristinati sull’immagine. Imposta questa proprietà su TRUE quando devi ottenere sia testo riconosciuto di buona qualità sia l’immagine a colori con tutti i timbri, le firme ecc. al loro posto. Questo può essere utile, ad esempio, durante l’esportazione in PDF image-on-text. Il valore predefinito di questa proprietà è TRUE.
ColorObjectsProhibitingParams Diagramma degli oggetti

​
Osservazioni

Considera anche l’uso del metodo RemoveColorObjectsEx dell’oggetto ImageDocument, che esegue la stessa operazione di filtraggio degli oggetti colorati, ma consente di salvare il livello di colore estratto in un’immagine separata.

​
Vedi anche

Messa a punto dei parametri di pre-elaborazione, analisi, riconoscimento e sintesi Lavorare con le proprietà