VG3_image_clone_reference()

Clone an image as a reference to the original image.

SYNTAX

struct vg3_image * VG3_image_clone_reference(struct vg3_window *wstruct, struct vg3_image *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 return pointer to the original image. Thus the image must be unloaded twice to be really unloaded.