re_image2bmp()

extern ReImageHandle KADMOS_API re_image2bmp(const ReImage *image, void **bmp_buffer);

Parameter:

image
Das zu wandelnde Bild.
bmp_buffer
Pointer zur Aufnahme der Speicherplatzadresse des erzeugten Bildes (BITMAPINFOHEADER*).

Rückgabewert:

Handle auf den allokierten Speicherplatz, NULL im Fehlerfall.

Bemerkung:

Ein unter image gegebenes Bild wird aus dem ReImage-Format ein Bitmap-Format gewandelt. Die Funktion allokiert einen passenden Speicherbereich für das zu erzeugende Bitmap. Die Adresse des Speicherplatzes wird unter bmp_buffer zurückgegeben. Die Bitmap-Bits werden auf folgender Position zurückgegeben:

(char *)bmp_buffer + (BITMAPINFOHEADER*)bmp_buffer->biSize
+ (BITMAPINFOHEADER*)bmp_buffer->biClrUsed * sizeof(RGBQUAD)

Im Fehlerfall wird ein NULL-Pointer zurückgegeben, der Fehlertext kann mit re_GetErrorText() abgerufen werden. Im Erfolgsfall wird ein Handle zu dem allokierten Speicherplatz zurückgegeben. Dieser Speicher kann durch Aufruf von re_freeimage() mit dem zurückgelieferten Handle wieder freigegeben werden.

Verweise: