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.