Manual Pages for UNIX Operating System command usage for man mlib_VideoColorBlendABGR

mediaLib Library Functions        mlib_VideoColorBlendABGR(3MLIB)



NAME
     mlib_VideoColorBlendABGR,
     mlib_VideoColorBlendABGR_ResetAlpha - image blend

SYNOPSIS
     cc [ flag... ] file... -lmlib [ library... ]
     #include 

     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.




SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions        mlib_VideoColorBlendABGR(3MLIB)



     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.






SunOS 5.11           Last change: 2 Mar 2007                    2






mediaLib Library Functions        mlib_VideoColorBlendABGR(3MLIB)



     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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     mlib_VideoColorBlendABGR_Inp(3MLIB), attributes(5)
















SunOS 5.11           Last change: 2 Mar 2007                    3