YCbCrToBGR565Dither, YCbCrToBGR555Dither, YCbCrToBGR444Dither

Convert a YCbCr image to the 16-bit per pixel BGR image with dithering.

Syntax

Case 1: Operation on pixel-order data

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

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

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

Case 2: Conversion from planar to pixel-order data

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

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

IppStatus ippiYCbCrToBGR444Dither_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 ippiYCbCrToBGR565Dither, ippiYCbCrToBGR555Dither, ippiYCbCrToBGR444Dither 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 B'G'R' image pDst according to the same formulas as the function ippiYCbCrToBGR does.

The destination image pDst is a packed 16-bit BGR 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): BGR565 (5 bits for blue, 6 bits for green, 5 bits for red), BGR555 (5 bits for blue, green, red), or BGR444 (4 bits for blue, green, red). Bit reduction is performed using the Bayer's threshold dithering algorithm with a 4x4 matrix [Tho91].

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.