Zum Hauptinhalt springen
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.

Properties

NameTypeDescription
ApplicationEngine, nur lesbarGibt das Engine-Objekt zurück.
TransparentColorintLegt 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. <Note> 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. </Note> Der Standardwert dieser Eigenschaft ist -1, was bedeutet, dass keine Farben durch Transparenz ersetzt werden.

Methoden

NameBeschreibung
CopyFromInitialisiert die Eigenschaften des aktuellen Objekts mit den Werten entsprechender Eigenschaften eines anderen Objekts.
LoadFromFileStellt den Inhalt des Objekts aus einer Datei auf dem Datenträger wieder her.
LoadFromMemory <Note> : Nur unter Windows. </Note>Stellt den Inhalt des Objekts aus dem globalen Speicher wieder her.
SaveToFileSpeichert den Inhalt des Objekts in einer Datei auf dem Datenträger.
SaveToMemory <Note> : Nur unter Windows. </Note>Speichert den Inhalt des Objekts im globalen Speicher.

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