NAME

xil_copy_pattern − replicate the source image into the destination image

SYNOPSIS

#include <xil/xil.h>

void xil_copy_pattern (XilImage src,

XilImage dst);

DESCRIPTION

This routine replicates the source image into the destination image.  src is the source image handle.  dst is the destination image handle. 

For example, if the the size of the source image is 64 x 64 and the size of the destination image is 256 x 128, then the destination image will have (256 / 64 ) ∗ (128 / 64) = 8 copies of the source image.  The size of the destination image does not have to be an even multiple of the size of the source image. 

ROI Behavior

The source image ROI is repeated to be the same size as the destination image before intersection with the destination ROI. 

ERRORS

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

EXAMPLES

Replicate the source image into the destination image:

XilImage src, dst;
xil_copy_pattern(src, dst);

NOTES

Source and destination images must be the same data type and have the same number of bands.  In-place operations are not supported. 

SEE ALSO

xil_copy(3)
 

SunOS 5.6  —  Last change: 09 June 1993