extern ReImageHandle KADMOS_API re_readimagefile (ReFileHandle rfh, long image_number, ReImage *image);
rfh
re_openimagefile()
.image_number
image
ReImage
.Handle of the allocated memory, NULL
in case of error.
The function reads the image given by image_number
from the image file given by file_handle
allocates
sufficient memory, and fills in the ReImage data structure image accordingly. This image can directly be processed by
rec_do()
, rel_do()
, or rep_do()
. In case of error the NULL
pointer
will be returned, the error text can be retrieved with re_GetErrorText()
. In case of success a handle of
the allocated memory will be returned. This memory can be freed by a call to re_freeimage()
with the given handle.
The image numbers of the file start with 0. After reading an image from the file, re_endofimagefile()
can be
used to check if the end of the file has been reached. In case of empty image files or empty images (height*width==0
)
the functions re_readimagefile()
and re_readimage()
don't throw an error any more. They simply
return with NULL
.