img = doc:LoadRawImage(filename, width, height, colorspace)
doc:LoadRawImage()
lädt ein Bild aus Rohpixeldaten, die
in einer externen Datei gespeichert sind. Dieser Befehl lädt
die Daten ohne Konvertierung. In der Regel ist dies schneller
als die anderen Befehle. Die Pixel werden Zeile für Zeile von
oben nach unten in dem durch den Parameter colorspace
festgelegten
Farbformat gespeichert, das auf eine der folgenden Konstanten
eingestellt werden muss:
#HPDF_CS_DEVICE_GRAY:
width * height
Bytes.
#HPDF_CS_DEVICE_RGB:
width * height * 3
bytes.
#HPDF_CS_DEVICE_CMYK
width * height * 4
bytes. Für jedes
Byte ist 0 die maximale Dunkelheit, 255 die maximale Helligkeit.
Wenn doc:LoadRawImage()
erfolgreich ist, gibt er die
Kennung eines Bildobjekts zurück. Andernfalls wird Nil
zurückgegeben
und der Fehler-Handler wird aufgerufen.
#HPDF_CS_DEVICE_GRAY
, #HPDF_CS_DEVICE_RGB
oder
#HPDF_CS_DEVICE_CMYK
(siehe oben)#HPDF_INVALID_DOCUMENT
- Eine ungültige Dokument-Kennung wurde festgelegt.
#HPDF_FAILED_TO_ALLOC_MEM
- Speicherzuordnung ist fehlgeschlagen.
#HPDF_INVALID_COLOR_SPACE
- Ein ungültiger Farbraumwert wurde angegeben.
#HPDF_INVALID_IMAGE
- Die Größe der Bilddaten ist ungültig.
#HPDF_FILE_IO_ERROR
- Es können keine Daten aus der Datei gelesen werden.