re_bmp2image()

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

Parameter:

bmp_buffer
Speicherplatzadresse des zu wandelnden BITMAPINFOHEADERs.
bmp_bits
Speicherplatz der Bildpunkte falls nicht NULL.
image
Adresse einer Struktur zur Aufnahme des Resultats.

Rückgabewert:

Handle auf den allokierten Speicherplatz, NULL im Fehlerfall.

Bemerkung:

Ein unter bmp_buffer gegebener BITMAPINFOHEADER und die unter bmp_bits gegebenen Bildpunkte werden in das ReImage-Format gewandelt. Ist bmp_bits = NULL, so werden die Bildpunkte anschliessend an den BITMAPINFOHEADER erwartet:

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

Die Funktion allokiert einen passenden Speicherbereich für das zu erzeugende Bild. 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: