VgaGames 3 - Video man-pages

[.. upper level ..]

VG3_image_copy()

Copy an image onto the window or another image.
SYNTAX
struct vg3_rect VG3_image_copy(void *wstruct, void *imgdst, void *imgsrc, int xm, int ym, struct vg3_image_attributes *imgattr, int dryrun)

FUNCTION PARAMETERS
wstruct Window-struct
imgdst Destination image, or NULL = window
imgsrc Source image, or NULL = window
xm Central x-position of the source on the destination
ym Central y-position of the source on the destination
imgattr Image-attributes to copy the image modified, or NULL if no modification is wanted
dryrun Dry-run, do not copy, just return the coordinates

RETURN VALUE
Returns the coordinates of the image on the destination.

DESCRIPTION
Copy an image onto the window or another image. The destination xm/ym on the destination is calculated from the middle of the source image. E.g. the source has a width of 5 pixels and a height of 7 pixels, then to put it on the destination at the left upper corner, xm must be 2 (middle of 0 to 4) and ym must be 3 (middle of 0 to 6).