Bezeichnung
doc:CreateImageFromMem -- erstellt ein neues Bild aus den Speicherdaten
Übersicht
img = doc:CreateImageFromMem(data, width, height, colorspace, bpc)
Beschreibung
doc:CreateImageFromMem() erstellt ein Bild aus Rohpixeldaten im Speicher. Das Argument data muss ein Speicherzeiger sein, der über den Hollywood-Befehl GetMemPointer() ermittelt wird. Dieser Befehl lädt die Daten ohne jegliche Konvertierung, so dass er in der Regel schneller ist als die anderen Befehle. bpc gibt die Bitgröße jeder Farbkomponente an und kann entweder 1, 2, 4 oder 8 sein.

Das Argument colorspace muss die Konstante #HPDF_CS_DEVICE_GRAY, #HPDF_CS_DEVICE_RGB oder #HPDF_CS_DEVICE_CMYK sein. Siehe doc:LoadRawImage für Details.

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

Eingaben
data
der Zeiger auf die Bilddaten
width
die Breite einer Bilddatei
height
die Höhe einer Bilddatei
colorspace
erlaubt sind #HPDF_CS_DEVICE_GRAY, #HPDF_CS_DEVICE_RGB oder #HPDF_CS_DEVICE_CMYK
bpc
die Bitgröße jeder Farbkomponente; gültige Werte sind entweder 1, 2, 4, oder 8
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.


Navigation zeigen