extern ReImageHandle KADMOS_API re_createimage(ReImage *image);
imageHandle of the allocated memory, NULL in case of error.
Before calling this function, the data structure image has to be set with the requested image format (imgtype,
width, height, bitsperpixel, color, ...). Only image->data
has not to be set. At the call of re_createimage() memory is allocated for the image pixels,
image->data is set with a related pointer, and a ReImageHandle is returned for a later call of
re_freeimage() to free the allocated memory.