NAME

xil_copy − copy an image

SYNOPSIS

#include <xil/xil.h>

void xil_copy (XilImage src,

XilImage dst);

DESCRIPTION

This routine copies a src (source) image into a specified dst (destination) image. The source and destination images must be the same data type and have the same number of bands. 

ERRORS

For a complete list of XIL error messages by number, consult Appendix B of the XIL Programmer’s Guide. 

EXAMPLES

Copy image1 into tmp_image :

XilImage image1, tmp_image;
xil_copy(image1, tmp_image);

NOTES

If overlapping but not coincident sibling images (children of the same parent) are specified as the source and destination, xil_copy() detects the overlap and correctly generates the destination image. All other operations generate a warning message under these conditions and have undefined results, as discussed in xil_create_child(3). 

SEE ALSO

xil_copy_pattern(3), xil_copy_with_planemask(3). 

SunOS 5.6  —  Last change: 08 February 1994