YCbCrToRGB565, YCbCrToRGB555, YCbCrToRGB444

Convert a YCbCr image to the 16-bit per pixel RGB image.

Syntax

Case 1: Operation on pixel-order data

IppStatus ippiYCbCrToRGB565_8u16u_C3R(const Ipp8u* pSrc, int srcStep, Ipp16u* pDst, int dstStep, IppiSize roiSize);

IppStatus ippiYCbCrToRGB555_8u16u_C3R(const Ipp8u* pSrc, int srcStep, Ipp16u* pDst, int dstStep, IppiSize roiSize);

IppStatus ippiYCbCrToRGB444_8u16u_C3R(const Ipp8u* pSrc, int srcStep, Ipp16u* pDst, int dstStep, IppiSize roiSize);

Case 2: Conversion from planar to pixel-order data

IppStatus ippiYCbCrToRGB565_8u16u_P3C3R(const Ipp8u* pSrc[3], int srcStep, Ipp16u* pDst, int dstStep, IppiSize roiSize);

IppStatus ippiYCbCrToRGB555_8u16u_P3C3R(const Ipp8u* pSrc[3], int srcStep, Ipp16u* pDst, int dstStep, IppiSize roiSize);

IppStatus ippiYCbCrToRGB444_8u16u_P3C3R(const Ipp8u* pSrc[3], int srcStep, Ipp16u* pDst, int dstStep, IppiSize roiSize);

Parameters

pSrc	Pointer to the source image ROI for pixel-order image. An array of pointers to ROI in each separate source color planes for planar images.
srcStep	Distance in bytes between starts of consecutive lines in the source image.
pDst	Pointer to the destination image ROI.
dstStep	Distance in bytes between starts of consecutive lines in the destination image.
roiSize	Size of the source and destination ROI in pixels.

Description

The functions ippiYCbCrToRGB565, ippiYCbCrToRGB555, ippiYCbCrToRGB444 are declared in the ippcc.h file. They operate with ROI (see Regions of Interest in Intel IPP).

These functions convert the Y'Cb'Cr' image pSrc to the gamma-corrected R'G'B' image pDst according to the same formulas as the function ippiYCbCrToRGB does.

The destination image pDst is a packed 16-bit RGB image with reduced bit depth; all 3 channel intensities for a pixel are packed into two consecutive bytes (16u data type). It can be in one of three possible formats (see Figure 16-bit Pixel Formats for more details): RGB565 (5 bits for red, 6 bits for green, 5 bits for blue), RGB555 (5 bits for red, green, blue), or RGB444 (4 bits for red, green, blue). Bit reduction is performed by discarding the least significant bits in the image after color conversion.

Return Values

ippStsNoErr	Indicates no error. Any other value indicates an error or a warning.
ippStsNullPtrErr	Indicates an error condition if pSrc or pDst is NULL.
ippStsSizeErr	Indicates an error condition if roiSize has a field with a zero or negative value.