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

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

YCbCr420ToYCbCr411

Converts YCbCr image from 4:2:0 sampling format to 4:1:1 format.

Syntax

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

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

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

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

IppStatus ippiYCbCr1620To420_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:2:0 source image to the 4:1:1 destination image. The source two-plane image is converted to destination three-plane image and vice versa. The first plane of the two-plane image contains luminance samples Y0, Y1, Y2, ..., the second plane contains interleaved chrominance samples Cb0, Cr0, Cb1, Cr1, .... The three-plane image has the following order of pointers: Y-plane, Cb-plane, Cr-plane (see Table “Planar Image Formats”).

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.