NAME

xil_blend − blend two images according to an alpha image

SYNOPSIS

#include <xil/xil.h>

void xil_blend ( XilImage src1,

XilImage src2,
XilImage dst,
XilImage alpha);

DESCRIPTION

This function blends two images according to an alpha image. For each pixel in the sources, the corresponding pixel in the alpha image provides a value that determines a linear combination of the source pixel values. The destination value is determined by this equation:

dst = (1.0 - normalize(alpha)) ∗ src1 + normalize(alpha) ∗ src2

src1 and src2 are the source image handles.  dst is the destination image handle.  alpha is the alpha image handle. 

ERRORS

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

EXAMPLES

Blend src1 and src2 according to alpha and put the result in dst:

XilImage src1, src2, dst, alpha;
xil_blend(src1, src2, dst, alpha);

NOTES

The source images and destination images must be the same type and have the same number of bands.  The alpha image must be a single-band image and can be any of the supported data types. In-place operations are supported. 
 

SunOS 5.6  —  Last change: 10 June 1993