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 ifpSrcorpDstpointer isNULL.
- ippStsSizeErr
- Indicates an error condition ifroiSizehas a field with a zero or negative value.