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

ID 790148
Date 10/31/2024
Public
Document Table of Contents

YCbCr411ToYCbCr420, YCbCr411To420

Converts 4:1:1 YCbCr image to 4:2:0 YCbCr image.

Syntax

IppStatus ippiYCbCr411ToYCbCr420_8u_P3R(const Ipp8u* pSrc[3], int srcStep[3], Ipp8u* pDst[3], int dstStep[3], IppiSize roiSize);

IppStatus ippiYCbCr411ToYCbCr420_8u_P3P2R(const Ipp8u* pSrc[3], int srcStep[3], Ipp8u* pDstY, int dstYStep, Ipp8u* pDstCbCr, int dstCbCrStep, IppiSize roiSize);

IppStatus ippiYCbCr411ToYCbCr420_8u_P2P3R(const Ipp8u* pSrcY, int srcYStep, const Ipp8u* pSrcCbCr, int srcCbCrStep, Ipp8u* pDst[3], int dstStep[3], IppiSize roiSize);

IppStatus ippiYCbCr411To420_8u_P3R(const Ipp8u* pSrc[3], int srcStep[3], Ipp8u* pDst[3], int dstStep[3], IppiSize roiSize);

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

Array of pointers to the ROI in each plane for a three-plane source image.

srcStep

Array of distances in bytes between starts of consecutive lines in each plane for a three-plane source image.

pSrcY

Pointer to the ROI in the luminance plane for a two-plane source image.

srcYStep

Distance in bytes between starts of consecutive lines in the luminance plane of a source image.

pSrcCbCr

Pointer to the ROI in the interleaved chrominance plane for a two-plane 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 for a three-plane destination image.

dstStep

Array of distances in bytes between starts of consecutive lines in each plane for a three-plane destination image.

pDstY

Pointer to the ROI in the luminance plane for a two-plane destination image.

dstYStep

Distance in bytes between starts of consecutive lines in the luminance plane of a destination image.

pDstCbCr

Pointer to the ROI in the interleaved chrominance plane for a two-plane destination image.

dstCbCrStep

Distance in bytes between starts of consecutive lines in the chrominance plane of a destination image.

roiSize

Size of the ROI in pixels, its width should be multiple of 4, its height should be multiple of 2.

Description

This function operates with ROI (see Regions of Interest in Intel IPP).

This function converts the 4:1:1 planar source image pSrc (see Table “Planar Image Formats”) to the 4:2:0 planar image pDst. Both source and destination images can be three- or two-plane. Three-plane images has the following order of pointers: Y-plane, Cb-plane, Cr-plane (see Table “Planar Image Formats”). Two-plane images contain luminance samples Y0, Y1, Y2, .. in the first plane, and interleaved chrominance samples Cb0, Cr0, Cb1, Cr1, ... in the second plane.

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 roiSize.width is less than 4 or roiSize.height is less than 2.