Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 3/22/2024
Public
Document Table of Contents

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.

CAUTION:

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 is NULL.

ippStsSizeErr

Indicates an error condition if any field of the roiSize is less than 2.