opensolaris man page for mlib_videocoloryuv2abgr420_w

mlib_VideoColorYUV2ABGR420_W(3MLIB)			    mediaLib Library Functions			       mlib_VideoColorYUV2ABGR420_W(3MLIB)

NAME
       mlib_VideoColorYUV2ABGR420_W - YUV to RGB color conversion

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

       mlib_status mlib_VideoColorYUV2ABGR420_W(mlib_u8 *abgr, const mlib_u8 *y,
	    const mlib_u8 *u, const mlib_u8 *v, mlib_s32 width, mlib_s32 height,
	    mlib_s32 abgr_stride, mlib_s32 y_stride, mlib_s32 uv_stride,
	    mlib_s32 left,mlib_s32 top, mlib_s32 right,
	    mlib_s32 bottom);

DESCRIPTION
       The  mlib_VideoColorYUV2ABGR420_W()  function  performs	YUV to RGB color conversion used in MPEG1 and MPEG2 video compression in the 4:2:0
       sequence. It performs color conversion together with window clipping.

       The luminance component is stored in Y, the chrominance components are stored in U and V, respectively. The size of the	chrominance  image
       depends	on the chroma format used by the sequence. In this sequence, the chrominance components are subsampled 2-to-1 in both the horizon-
       tal and vertical directions in respect to the luminance component.

PARAMETERS
       The function takes the following arguments:

       abgr	      Pointer to the destination packed ABGR image. abgr must be 8-byte aligned.

       y	      Pointer to the source Y component. y must be 8-byte aligned.

       u	      Pointer to the source U component. u must be 4-byte aligned.

       v	      Pointer to the source V component. v must be 4-byte aligned.

       width	      Width of the image. width must be a multiple of 8.

       height	      Height of the image. height must be a multiple of 2.

       abgr_stride    Stride, in bytes, between adjacent rows in the ABGR image. abgr_stride must be a multiple of 8.

       y_stride       Stride, in bytes, between adjacent rows in the Y component image. y_stride must be a multiple of 8.

       uv_stride      Stride, in bytes, between adjacent rows in the U and V component images. uv_stride must be a multiple of 8.

       left	      Left border of clipping window. 0 <= left < right <= width.

       top	      Top border of clipping window. 0 <= top < bottom <= height.

       right	      Left border of clipping window. 0 <= left < right <= width.

       bottom	      Bottom border of clipping window. 0 <= top < bottom <= height.

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_VideoColorYUV2ABGR420_WX2(3MLIB),	 mlib_VideoColorYUV2ABGR420_WX3(3MLIB),    mlib_VideoColorYUV2ABGR420_X2(3MLIB),    mlib_VideoCol-
       orYUV2ABGR420_X3(3MLIB), attributes(5)

SunOS 5.11							    2 Mar 2007				       mlib_VideoColorYUV2ABGR420_W(3MLIB)