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: Title of the image file.
image: Pointer of a structure ReImage.

Return value:

Handle of the allocated memory, NULL in case of error.

Comment:

These functions read the (possibly first) image from a file given by file_title, allocate a suitable memory area, and fill the with image given data structure ReImage so that this image can be processed directly by rec_do(), rel_do() or rep_do(). If an error occurs, a NULL pointer is returned, the error text can be retrieved with re_GetErrorText(). If successful, a handle is returned to the allocated memory location. By calling re_freeimage() with the returned handle the allocated memory will be freed. For empty image files and empty images (height * width == 0), only the pointer NULL is returned, without error message.