re_readimagefile()

extern ReImageHandle KADMOS_API re_readimagefile
(ReFileHandle rfh, long image_number, ReImage *image);

Parameter:

rfh: Handle auf die zu lesende Bild-Datei, die mit re_openimagefile() geöffnt wurde.
image_number: Nummer des zu lesenden Bildes (erstes Bild hat die Nummer 0).
image: Pointer auf die Bild-Struktur.

Rückgabewert:

Handle auf den allokierten Speicherplatz, NULL im Fehlerfall.

Bemerkung:

Es wird das durch image_number gegebene Bild in die durch image gegebene Struktur eingelesen. 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. Die Numerierung der Bilder beginnt mit der Nummer 0. Bei leeren Bild-Dateien und leeren Bildern (Höhe*Breite==0) wird nur der Pointer NULL zurückgegeben, ohne Fehlermeldung.