ColorObjectsProhibitingParams-Objekt (IColorObjectsProhibitingParams-Interface)

ColorObjectsProhibitingParams-Objekt (IColorObjectsProhibitingParams-Interface) in der ABBYY FineReader Engine API — Konfiguriert die Filterung von Farbobjekten (Stempel, Unterschriften usw.) vor der Verarbeitung; Unterobjekt von PageProcessingParams.

Dieses Objekt wird verwendet, um die Parameter für das Herausfiltern von Farbobjekten aus dem Bild vor Beginn der Verarbeitung anzupassen. Diese Art der Vorverarbeitung kann in Fällen nützlich sein, in denen das zu erkennende Dokument farbige Stempel, Unterschriften usw. enthält, die die Erkennungsqualität beeinträchtigen können. Mithilfe der Eigenschaften dieses Objekts können Sie die Farbsammlung festlegen, die herausgefiltert werden soll, und angeben, ob die Farbobjekte nach der Erkennung wieder in das Bild eingefügt werden sollen.

Dieses Objekt kann nur als Unterobjekt des Objekts PageProcessingParams vorhanden sein. Es muss zusammen mit dem übergeordneten Objekt erstellt oder in persistenten Speicher geschrieben werden.

​

Eigenschaften

Name	Typ	Beschreibung
Application	Engine, nur lesbar	Gibt das Engine-Objekt zurück.
BackgroundColor	int	Gibt die Farbe an, die die entfernten Farbobjekte ersetzen soll. Der int-Wert wird anhand des RGB-Tripels mit der Formel berechnet: ( Rotwert ) + (256 x Grünwert ) + (65536 x Blauwert ), wobei der Rotwert die erste Komponente des Tripels ist, der Grünwert die zweite Komponente und der Blauwert die dritte Komponente. Zum Beispiel beträgt der int-Wert der Farbe Weiß 16777215. Der Standardwert dieser Eigenschaft ist -1; das bedeutet, dass die Farbe automatisch ausgewählt wird.
ColorHues	IntsCollection	Gibt die Sammlung der Farbtöne der Objekte an, die in der HSL-Darstellung gefiltert werden sollen. Die Zahl, die einen Farbton angibt, muss im Bereich von 0 bis 255 liegen. Der Wert 0 entspricht Rot, 43 Gelb, 85 Grün, 171 Blau und 213 Violett. Standardmäßig ist die Sammlung leer; das bedeutet, dass alle Farbobjekte herausgefiltert werden und nur das Graustufenbild zur Verarbeitung übergeben wird.
RestoreColorObjectsAfterProcessing	VARIANT_BOOL	Gibt an, ob die Farbobjekte nach Abschluss der Verarbeitung wieder in das Bild eingefügt werden sollen. Verwenden Sie diese Eigenschaft mit dem Wert TRUE, wenn Sie sowohl hochwertig erkannten Text als auch das Farbbild mit allen Stempeln, Unterschriften usw. an Ort und Stelle erhalten möchten. Dies kann beispielsweise beim Export in ein Image-on-Text-PDF nützlich sein. Der Standardwert dieser Eigenschaft ist TRUE.

​

Verwandte Objekte

Objektdiagramm

​

Hinweise

Ziehen Sie auch die Methode RemoveColorObjectsEx des ImageDocument-Objekts in Betracht, die dieselbe Filterung von Farbobjekten durchführt, es Ihnen jedoch ermöglicht, die extrahierte Farbebene in einem separaten Bild zu speichern.

​

Siehe auch

Einstellen von Parametern für die Vorverarbeitung, Analyse, Erkennung und Synthese

Arbeiten mit Eigenschaften