VgaGames 3 - Video man-pages

[.. upper level ..]

VG3_image_clone_reference()

Clone an image as a reference to the original image.
SYNTAX
void * VG3_image_clone_reference(void *wstruct, void *imgptr)

FUNCTION PARAMETERS
wstruct Window-struct
imgptr Source image to clone

RETURN VALUE
Returns a pointer to the original image or NULL on failure.

ERRORS
On error VG3_errmsg() returns: EINVAL - error in argument

DESCRIPTION
Clone an image (not window) as a reference and returns pointer to the original image. Thus the image must be unloaded twice to be really unloaded.

SEE ALSO
VG3_image_create() VG3_image_text() VG3_image_clone() VG3_image_load()