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.