VG3_image_copy()
Copy an image onto the window or another image.SYNTAX
struct vg3_rect
VG3_image_copy(struct vg3_window *wstruct,
struct vg3_image *imgdst,
struct vg3_image *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).