Bezeichnung
doc:LoadRawImage -- lädt ein Rohbild aus einer Datei
Übersicht
img = doc:LoadRawImage(filename, width, height, colorspace)
Beschreibung
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:
8-Bit-Graustufenbild. Der Graustufen-Farbraum beschreibt jedes Pixel mit einem Byte. Für jedes Byte ist 0 die maximale Dunkelheit und 255 die maximale Helligkeit. Die Größe der Bilddaten ist width * height Bytes.

#HPDF_CS_DEVICE_RGB:
24 Bit RGB-Farbbild. Der 24-Bit-RGB-Farbraum beschreibt jedes Pixel mit drei Bytes (rot, grün, blau). Für jedes Byte ist 0 die maximale Dunkelheit, 255 die maximale Helligkeit. Die Größe der Bilddaten ist width * height * 3 bytes.

#HPDF_CS_DEVICE_CMYK
32-Bit-CMYK-Farbbild. Der 32-Bit-CMYK-Farbraum beschreibt jedes Pixel mit vier Bytes (Cyan, Magenta, Gelb, Schwarz). Die Größe der Bilddaten ist 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.

Eingaben
filename
ein Pfad zu einer Bilddatei
width
die Breite der Rohpixeldaten
height
die Höhe der Rohpixeldaten
colorspace
#HPDF_CS_DEVICE_GRAY, #HPDF_CS_DEVICE_RGB oder #HPDF_CS_DEVICE_CMYK (siehe oben)
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_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.


Navigation zeigen