EncodeImage

EncodeImage()

Syntax

*Puffer = EncodeImage(#Image [, ImagePlugin [, Flags [, Tiefe]]])

Beschreibung

Kodiert das angegebene Bild in einen Speicherpuffer.

Parameter

#Image Das zu kodierende Bild.
ImagePlugin (optional)
Das Format, in welchem das Bild kodiert werden soll. Dies kann einer der folgenden Werte sein:
  #PB_ImagePlugin_BMP      : Speichert das Bild als BMP (Standard)
  #PB_ImagePlugin_JPEG     : kodiert das Bild in JPEG (es muss UseJPEGImageEncoder() verwendet werden)
  #PB_ImagePlugin_JPEG2000 : kodiert das Bild in JPEG2000 (es muss UseJPEG2000ImageEncoder() verwendet werden)
  #PB_ImagePlugin_PNG      : kodiert das Bild in PNG (es muss UsePNGImageEncoder() verwendet werden)
Flags (optional)
Parameter für das Image-Plugin. Derzeit wird nur die Qualitäts-Einstellung unterstützt: ein Wert von 0 (schlechte Qualität) bis 10 (maximale Qualität). Nur die JPEG- und JPEG 2000 Plugins unterstützen dies derzeit (die Standard-Qualität wird auf '7' gesetzt, wenn keine Flags angegeben werden).

Wenn ein Bild mit einer "palettized" Tiefe (feste Farbpalette mit 1, 4 oder 8 Bit) kodiert wird, ist das folgende Flag in Kombination verfügbar:
  #PB_Image_FloydSteinberg: Anwenden eines Floyd-Steinberg-Dithering.
Tiefe (optional) Die Tiefe, in welchem das Bild gespeichert werden soll. Gültige Werte sind 1, 4, 8, 24 und 32. Der Standard-Wert ist die originale Bild-Tiefe. Derzeit unterstützt nur der PNG-Encoder das "palettized" Bild-Format (1, 4 oder 8 Bit).

Rückgabewert

Gibt einen Zeiger auf einen neu reservierten Speicherpuffer zurück, welcher das kodierte Bild enthält, oder Null, wenn das Kodieren fehlgeschlagen ist. MemorySize() kann verwendet werden, um die Größe des kodierten Bildes zu ermitteln. FreeMemory() muss verwendet werden, um den Puffer nach dessen Verwendung freizugeben.

Siehe auch

LoadImage(), ImagePlugin Bibliothek

Unterstützte OS

Alle

<- CreateImage() - Image Inhaltsverzeichnis - FreeImage() ->

#Image	Das zu kodierende Bild.
ImagePlugin (optional)	Das Format, in welchem das Bild kodiert werden soll. Dies kann einer der folgenden Werte sein: #PB_ImagePlugin_BMP : Speichert das Bild als BMP (Standard) #PB_ImagePlugin_JPEG : kodiert das Bild in JPEG (es muss UseJPEGImageEncoder() verwendet werden) #PB_ImagePlugin_JPEG2000 : kodiert das Bild in JPEG2000 (es muss UseJPEG2000ImageEncoder() verwendet werden) #PB_ImagePlugin_PNG : kodiert das Bild in PNG (es muss UsePNGImageEncoder() verwendet werden)
Flags (optional)	Parameter für das Image-Plugin. Derzeit wird nur die Qualitäts-Einstellung unterstützt: ein Wert von 0 (schlechte Qualität) bis 10 (maximale Qualität). Nur die JPEG- und JPEG 2000 Plugins unterstützen dies derzeit (die Standard-Qualität wird auf '7' gesetzt, wenn keine Flags angegeben werden). Wenn ein Bild mit einer "palettized" Tiefe (feste Farbpalette mit 1, 4 oder 8 Bit) kodiert wird, ist das folgende Flag in Kombination verfügbar: #PB_Image_FloydSteinberg: Anwenden eines Floyd-Steinberg-Dithering.
Tiefe (optional)	Die Tiefe, in welchem das Bild gespeichert werden soll. Gültige Werte sind 1, 4, 8, 24 und 32. Der Standard-Wert ist die originale Bild-Tiefe. Derzeit unterstützt nur der PNG-Encoder das "palettized" Bild-Format (1, 4 oder 8 Bit).