Bezeichnung
doc:LoadPNGImage -- lädt ein externes PNG-Bild
Übersicht
img = doc:LoadPNGImage(filename[, cache])
Beschreibung
doc:LoadPNGImage() lädt eine externe PNG-Bilddatei. Mit dem optionalen Argument cache können Sie einstellen, ob diese Methode das gesamte PNG-Bild im Speicher zwischenspeichern soll oder nicht. Wenn Sie ein PNG-Bild mehrmals einbetten müssen, ist es schneller, dieses Argument auf True zu setzen.

Beachten Sie, dass beim Einbetten von PNG-Bildern in ein PDF nicht im PNG-Format, sondern als rohe, unkomprimierte Pixel eingebettet werden (obwohl Sie die Kompression für die Pixeldaten aktivieren können, indem Sie doc:SetCompressionMode() aufrufen). Das einzige Bildformat, das direkt in PDF-Dokumente eingebettet werden kann, ist JPEG. Verwenden Sie doc:LoadJPEGImage(), um ein JPEG-Bild zum Einbetten in ein PDF zu laden.

Wenn doc:LoadPNGImage() erfolgreich ist, gibt er die Kennung eines Bildobjekts zurück. Andernfalls wird Nil zurückgegeben und der Fehler-Handler wird aufgerufen.

Eingaben
filename
Pfad zu einer PNG-Bilddatei
cache
optional: aktiviert das Caching (True) oder nicht (False) (Standard ist False)
Rückgabewerte
img
Kennung des Bildes
Fehler
#HPDF_INVALID_DOCUMENT - Eine ungültige Dokument-Kennung wurde festgelegt.

#HPDF_FAILED_TO_ALLOC_MEM - Speicherzuordnung ist fehlgeschlagen.

#HPDF_UNSUPPORTED_FUNC - Die Bibliothek ist nicht für die Verwendung von PNGLIB konfiguriert.

#HPDF_LIBPNG_ERROR - Fehlschlag beim Aufruf der PNGLIB-Funktion.

#HPDF_INVALID_PNG_IMAGE - Ungültiges PNG-Format.


Navigation zeigen