YCbCr420ToYCrCb420_Filter
Convert 4:2:0 YCbCr image to 4:2:0 YCrCb image with deinterlace filtering.
Syntax
IppStatus ippiYCbCr420ToYCrCb420_Filter_8u_P2P3R(const Ipp8u*
pSrcY
, int
srcYStep
, const Ipp8u*
pSrcCbCr
, int
srcCbCrStep
, Ipp8u*
pDst
[3], int
dstStep
[3], IppiSize
roiSize
, int
layout
);
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
- pSrcY
- Pointer to the ROI in the luminance plane of the source image.
- srcYStep
- Distance in bytes between starts of consecutive lines in the luminance plane of the source image.
- pSrcCbCr
- Pointer to the ROI in the interleaved chrominance plane of the source image.
- srcCbCrStep
- Distance in bytes between starts of consecutive lines in the interleaved chrominance plane of the source image.
- pDst
- Array of pointers to the ROI in each plane of the destination image.
- dstStep
- Array of distances in bytes between starts of consecutive lines in the destination image planes.
- roiSize
- Size of the source and destination ROI in pixels, height and width should be multiple of 2.
- layout
- Slice layout. Possible values:
- IPP_UPPER
- Upper (first) slice
- IPP_CENTER
- Middle slices
- IPP_LOWER
- Lowermost (last) slice
- IPP_LOWER && IPP_UPPER && IPP_CENTER
- Image is not sliced
Description
This function operates with ROI (see Regions of Interest in Intel IPP).
This function converts the
4:2:0
two-plane source image to the 4:2:0 three-plane image. The first plane of the source image pSrcY
contains luminance samples Y0
, Y1
, Y2
, ..., the second plane pSrcCbCr
contains interleaved chrominance samples Cb0
, Cr0
, Cb1
, Cr1
, .... The destination image pDst
has the following order of pointers: Y
-plane, Cr
-plane, Cb
-plane. The function additionally performs deinterlace filtering. Commonly it is used to process sliced images. In this case the slice layout
should be specified, since the function processes the first (upper), last (lowermost), and intermediate (middle) slices differently. The height of slices should be a multiple of 16. The function may be applied to a not-sliced image as well.The image slices should be processed exactly in the following order: the first slice, intermediate slices, the last slice.
Return Values
- ippStsNoErr
- Indicates no error. Any other value indicates an error.
- ippStsNullPtrErr
- Indicates an error condition if any of the specified pointers isNULL.
- ippStsSizeErr
- Indicates an error condition if any field of theroiSizeis less than 2.