PngExtendedParams-Objekt (IPngExtendedParams-Schnittstelle)

PngExtendedParams-Objekt (IPngExtendedParams-Schnittstelle) in der ABBYY FineReader Engine API — Parameter zum Speichern eines Schwarzweißbilds als PNG (IFF_Png) über IImage.WriteToFile; persistentes Objekt, das in Datei/Speicher gespeichert werden kann.

Dieses Objekt stellt Funktionen zur Feinabstimmung der Parameter für das Speichern eines Schwarzweißbilds im PNG-Format (IFF_Png-Format) mithilfe der Methode IImage::WriteToFile bereit. Ein Zeiger auf dieses Objekt wird der Methode IImage::WriteToFile als Eingabeparameter übergeben und beeinflusst dadurch die Eigenschaften des resultierenden Bilds. Alle Eigenschaften eines neu erstellten Objekts dieses Typs werden auf sinnvolle Standardwerte gesetzt. Den Standardwert einer bestimmten Eigenschaft entnehmen Sie der jeweiligen Eigenschaftsbeschreibung.

Das PngExtendedParams-Objekt ist ein persistentes Objekt. Das bedeutet, dass der aktuelle Zustand des Objekts in einen persistenten Speicher geschrieben werden kann. Das Objekt kann später durch Einlesen seines Zustands aus dem persistenten Speicher wiederhergestellt werden. Die folgenden Methoden stellen die Persistenz des Objekts sicher:

Linux: SaveToFile und LoadFromFile

Windows: SaveToFile, LoadFromFile, SaveToMemory und LoadFromMemory.

​

Eigenschaften

Name	Type	Description
Application	Engine, nur lesbar	Gibt das Engine-Objekt zurück.
TransparentColor	int	Legt die Farbe fest, die beim Speichern des Bildes im PNG-Format durch transparente Bereiche ersetzt werden soll. Derzeit werden nur Schwarz und Weiß unterstützt. Der int-Wert wird aus dem RGB-Triplet mithilfe der folgenden Formel berechnet: ( Rotwert ) + (256 × Grünwert ) + (65536 × Blauwert ), wobei der Rotwert die erste, der Grünwert die zweite und der Blauwert die dritte Triplet-Komponente ist. Der int-Wert der Farbe Weiß beträgt beispielsweise 16777215. Der Standardwert dieser Eigenschaft ist -1, was bedeutet, dass keine Farben durch Transparenz ersetzt werden.

​

Methoden

Name	Beschreibung
CopyFrom	Initialisiert die Eigenschaften des aktuellen Objekts mit den Werten entsprechender Eigenschaften eines anderen Objekts.
LoadFromFile	Stellt den Inhalt des Objekts aus einer Datei auf dem Datenträger wieder her.
LoadFromMemory	Stellt den Inhalt des Objekts aus dem globalen Speicher wieder her. Nur unter Windows.
SaveToFile	Speichert den Inhalt des Objekts in einer Datei auf dem Datenträger.
SaveToMemory	Speichert den Inhalt des Objekts im globalen Speicher. Nur unter Windows.

​

Ausgabeparameter

Dieses Objekt ist der Ausgabeparameter der Methode CreatePngExtendedParams des Engine-Objekts.

​

Eingabeparameter

Dieses Objekt ist der Eingabeparameter der Methode WriteToFile des Objekts Image.

​

Siehe auch

ImageFileFormatEnum

Arbeiten mit Bildern

Arbeiten mit Eigenschaften