Bezeichnung
doc:CreateImageFromBrush -- erstellt ein neues Bild von einem Hollywood-Pinsel
Übersicht
img = doc:CreateImageFromBrush(id[, table])
Beschreibung
doc:CreateImageFromBrush() erstellt ein Bild aus dem in id angegebenen Hollywood-Pinsel. Das Bild verwendet immer den RGB-Farbraum, d.h. #HPDF_CS_DEVICE_RGB.

Mit dem optionalen Argument table können weitere Optionen konfiguriert werden:

UseJPEG:
Wenn dieser Parameter auf True gesetzt ist, wird das Bild im JPEG-Dateiformat komprimiert. Sie können das Feld Quality verwenden, um die Kompressionsstufe einzustellen. Wenn UseJPEG auf False gesetzt ist, wird das Bild nicht komprimiert, aber Sie können doc:SetCompressionMode() verwenden, um die Kompression für Bilddaten zu aktivieren, obwohl sie nicht so gut wie JPEG ist. Standardwert ist False.

Quality:
Hier können Sie einen Wert zwischen 0 und 100 angeben, der die Kompressionsqualität für das JPEG-Format angibt. Ein Wert von 100 bedeutet beste Qualität, 0 bedeutet schlechteste Qualität. Die Standardeinstellung ist 90, was eine ziemlich gute Qualität bedeutet.

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

Eingaben
id
Identifikator des Pinsels, der in ein Bild konvertiert wird
table
optional: weitere Parameter in einer Tabelle (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.

Navigation zeigen