re_readimage(), re_wreadimage()

extern ReImageHandle KADMOS_API re_readimage
  (const char *file_title, ReImage *image);

extern ReImageHandle KADMOS_API re_wreadimage
  (const wchar_t *file_title, ReImage *image);

Parameter:

file_title: String mit dem Namen der Bilddatei.
image: Pointer auf eine ReImage Datenstruktur.

Rückgabewert:

Handle auf den allokierten Speicherplatz, NULL im Fehlerfall.

Bemerkung:

Diese Funktionen lesen das (ggf. erste) Bild aus einer durch file_title gegebenen Datei, allokieren einen passenden Speicherbereich, und füllen die durch image gegebene ReImage Datenstruktur so aus, dass dieses Bild direkt von rec_do(), rel_do() oder rep_do() verarbeitet werden kann. 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. Bei leeren Bild-Dateien und leeren Bildern (Hühe*Breite==0) wird nur der Pointer NULL zurückgegeben, ohne Fehlermeldung.