opensolaris man page for mlib_imagescalarblend

mlib_ImageScalarBlend(3MLIB)				    mediaLib Library Functions				      mlib_ImageScalarBlend(3MLIB)

NAME
       mlib_ImageScalarBlend - image blending with scalar

SYNOPSIS
       cc [ flag... ] file... -lmlib [ library... ]
       #include <mlib.h>

       mlib_status mlib_ImageScalarBlend(mlib_image dst, const mlib_image *src1,
	    const mlib_image *src2, const mlib_s32 *alpha);

DESCRIPTION
       The  mlib_ImageScalarBlend()  function  blends  the  first and second source images by adding each of their scaled pixels. The first source
       image is scaled by the scalar a, and the second source image is inverse scaled by (1 - a).

       It uses the following equation:

	 dst[x][y][i] = a[i]*src1[x][y][i] + (1 - a[i])*src2[x][y][i]

PARAMETERS
       The function takes the following arguments:

       dst	Pointer to destination image.

       src1	Pointer to first source image.

       src2	Pointer to second source image.

       alpha	Scalar blending factor. The a value equals (alpha * 2**(-31)). alpha[i] contains the blending factor for channel i.

RETURN VALUES
       The function returns MLIB_SUCCESS if successful. Otherwise it returns MLIB_FAILURE.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Committed 		   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       mlib_ImageScalarBlend_Fp(3MLIB), mlib_ImageScalarBlend_Fp_Inp(3MLIB), mlib_ImageScalarBlend_Inp(3MLIB), attributes(5)

SunOS 5.11							    2 Mar 2007					      mlib_ImageScalarBlend(3MLIB)