opensolaris man page for mlib_imagescalarblend_inp

mlib_ImageScalarBlend_Inp(3MLIB)			    mediaLib Library Functions				  mlib_ImageScalarBlend_Inp(3MLIB)

NAME
       mlib_ImageScalarBlend_Inp - image blending with scalar, in place

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

       mlib_status mlib_ImageScalarBlend_Inp(mlib_image *src1dst,
	    const mlib_image *src2, const mlib_s32 *alpha);

DESCRIPTION
       The  mlib_ImageScalarBlend_Inp()  function  blends  the	first and second source images by adding each of their scaled pixels in place. 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:

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

PARAMETERS
       The function takes the following arguments:

       src1dst	  Pointer to first source and destination 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(3MLIB), mlib_ImageScalarBlend_Fp(3MLIB), mlib_ImageScalarBlend_Fp_Inp(3MLIB), attributes(5)

SunOS 5.11							    2 Mar 2007					  mlib_ImageScalarBlend_Inp(3MLIB)