Visible to Intel only — GUID: GUID-880EC694-5E3A-4A36-9E0F-7174A386C1DB
Visible to Intel only — GUID: GUID-880EC694-5E3A-4A36-9E0F-7174A386C1DB
YCbCrToRGB
Converts a YCbCr image to the RGB color model.
Syntax
Case 1: Operation on pixel-order data
IppStatus ippiYCbCrToRGB_<mod>(const Ipp8u* pSrc, int srcStep, Ipp8u* pDst, int dstStep, IppiSize roiSize);
Supported values for mod:
8u_C3R | 8u_AC4R |
Case 2: Operation on planar data
IppStatus ippiYCbCrToRGB_8u_P3R(const Ipp8u* pSrc[3], int srcStep, Ipp8u* pDst[3], int dstStep, IppiSize roiSize);
IppStatus ippiYCbCrToRGB_8u_P3C3R(const Ipp8u* pSrc[3], int srcStep, Ipp8u* pDst, int dstStep, IppiSize roiSize);
Case 3: Conversion from planar to pixel-order data
IppStatus ippiYCbCrToRGB_8u_P3C4R(const Ipp8u* pSrc[3], int srcStep, Ipp8u* pDst , int dstStep, IppiSize roiSize, Ipp8u aval);
Include Files
ippcc.h
Domain Dependencies
Headers: ippcore.h, ippvm.h, ipps.h, ippi.h
Libraries: ippcore.lib, ippvm.lib, ipps.lib, ippi.lib
Parameters
pSrc |
Pointer to the source image ROI for pixel-order image. Array of pointers to the 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. Array of pointers to the ROI in the separate destination color planes for planar images. |
dstStep |
Distance in bytes between starts of consecutive lines in the destination image. |
roiSize |
Size of the source and destination ROI in pixels. |
aval |
Constant value to create the fourth channel. |
Description
This function operates with ROI (see Regions of Interest in Intel IPP).
This function converts the Y'Cb'Cr' image pSrc to the 24-bit gamma-corrected R'G'B' image pDst. The following formulas are used for conversion:
R' = 1.164*(Y' - 16) + 1.596*(Cr' - 128)
G' = 1.164*(Y' - 16) - 0.813*(Cr' - 128) - 0.392*(Cb' - 128)
B' = 1.164*(Y' - 16) + 2.017*(Cb' - 128)
The output R'G'B' values are saturated to the range [0..255].
The fourth channel is created by setting channel values to the constant value aval.
Return Values
ippStsNoErr |
Indicates no error. Any other value indicates an error or a warning. |
ippStsNullPtrErr |
Indicates an error condition if pSrc or pDst pointer is NULL. |
ippStsSizeErr |
Indicates an error condition if roiSize has a field with a zero or negative value. |