img = doc:LoadPNGImage(filename[, cache])
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.
True
) oder nicht
(False
) (Standard ist False
)#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.