mlib_VideoColorBlendABGR(3MLIB) 			    mediaLib Library Functions				   mlib_VideoColorBlendABGR(3MLIB)

NAME

       mlib_VideoColorBlendABGR, mlib_VideoColorBlendABGR_ResetAlpha - image blend

SYNOPSIS

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

       void mlib_VideoColorBlendABGR(mlib_u32 *dst,
	    const mlib_u32 *src1,const mlib_u32 *src2,
	    mlib_s32 src1_w, mlib_s32 src1_h,
	    mlib_s32 src2_w,mlib_s32 src2_h,
	    mlib_s32 src2_x, mlib_s32 src2_y,
	    mlib_s32 dst_lb,mlib_s32 src1_lb,
	    mlib_s32 src2_lb, mlib_blend src1_blend,
	    mlib_blend src2_blend);

       void mlib_VideoColorBlendABGR_ResetAlpha(mlib_u32 *dst,
	    const mlib_u32 *src1,const mlib_u32 *src2,
	    mlib_s32 src1_w, mlib_s32 src1_h,
	    mlib_s32 src2_w,mlib_s32 src2_h,
	    mlib_s32 src2_x, mlib_s32 src2_y,
	    mlib_s32 dst_lb, mlib_s32 src1_lb,
	    mlib_s32 src2_lb, mlib_blend src1_blend,
	    mlib_blend src2_blend);

DESCRIPTION

       The functions use the following equation for blending images:

	   dst = (src1 * src1_blend) + (src2 * src2_blend)

       The  two  multi-banded  source  images  (src1  and  src2) are blended together and stored in the destination image (dst). The image buffers
       pointed to by dst, src1, and src2 contain 4-banded ABGR images, 8 bits per component. src1_w and src1_h are  the  dimensions  of  the  src1
       input  buffer. src2_w and src2_h are the dimensions of the src2 input buffer. The output buffer must be at least as large as the src1 input
       buffer. src2_x and src2_y are the offset of the src2 input buffer relative to src1. Where pixels in src2 overlap pixels in src1, the pixels
       are  blended.  Pixels  in  src1	which are outside of src2 are copied into dst. Pixels in the dst image outside of src1 are left unchanged.
       src1_blend specifies the blend function to be applied to the pixels of src1 image and src2_blend specifies the blend function to be applied
       to the pixels of src2.

       Possible blend functions are:

	   MLIB_BLEND_ZERO
	   MLIB_BLEND_ONE
	   MLIB_BLEND_SRC_ALPHA
	   MLIB_BLEND_ONE_MINUS_SRC_ALPHA
	   MLIB_BLEND_DST_ALPHA
	   MLIB_BLEND_ONE_MINUS_DST_ALPHA

       MLIB_BLEND_SRC_ALPHA  is  the  alpha component of image src2 scaled to the range 0.0 to 1.0. MLIB_BLEND_DST_ALPHA is the alpha component of
       image src1 scaled to the range 0.0 to 1.0. All pixel components are treated as unsigned 8-bit quantities and  the  output  pixel  component
       values are clamped to the range 0 to 255.

       For  the mlib_VideoColorBlendABGR_ResetAlpha() function,  the alpha value of every pixel in destination image is set to 0 after blending is
       complete.

PARAMETERS

       Each of the functions takes the following arguments:

       dst	     Pointer to output image.

       src1	     Pointer to 1st input image.

       src2	     Pointer to 2nd input image.

       src1_w	     src1 image width in pixels.

       src1_h	     src1 image height in rows.

       src2_w	     src2 image width in pixels.

       src2_h	     src2 image height in rows.

       src2_x	     src2 horizontal displacement (in pixels), relative to the upper-left corner of src1.

       src2_y	     src2 vertical displacement (in rows), relative to the upper-left corner of src1.

       dst_lb	     Linebytes for output image.

       src1_lb	     Linebytes for 1st input image.

       src2_lb	     Linebytes for 2nd input image.

       src1_blend    Blend function for src1 image.

       src2_blend    Blend function for src2 image.

RETURN VALUES

       None.

ATTRIBUTES

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

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

SEE ALSO

       mlib_VideoColorBlendABGR_Inp(3MLIB), attributes(5)

SunOS 5.11							    2 Mar 2007					   mlib_VideoColorBlendABGR(3MLIB)