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

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

ResizeYUV420LanczosInit

Initializes the spec structure for the NV12 resize transform by interpolation with the Lanczos filter.

Syntax

IppStatus ippiResizeYUV420LanczosInit(IppiSize srcSize, IppiSize dstSize, Ipp32u numLobes, IppiResizeYUV420Spec* pSpec, Ipp8u* pInitBuf);

Include Files

ippi.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib

Parameters

srcSize

Size in pixels of the source image.

dstSize

Size in pixels of the destination image.

numLobes

Parameter for Lanczos filters. Possible values are 2 or 3.

pSpec

Pointer to the spec structure for the resize filter.

pInitBuf

Pointer to the temporal buffer for the cubic filter initialization.

Description

This function initializes the IppiResizeYUV420Spec structure for the resize algorithm with the Lanczos filter interpolation method. This method is based on the 2-lobed or 3-lobed Lanzos window function as an interpolation function depending on the value of the numLobes parameter.

To calculate the size of the spec structure object, call the ippiResizeYUV420GetSize function.

The function ippiResizeYUV420LanczosInit requires the external buffer pInitBuf. Prior to using this function, you need to call ippiResizeYUV420GetSize for the corresponding flavors to compute the size of the buffer.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

Indicates an error if one of the specified pointers is NULL.

ippStsResizeNoOperation

Indicates an error if width or height of the image is equal to zero.

ippStsSizeWrn

Indicates a warning if width or height of the image is odd.

ippStsSizeErr

Indicates an error in the following cases:

  • if width or height of the source or destination image is equal to 1,

  • if width or height of the source or destination image is negative,

  • if the source image size is less than the Lanczos interpolation filter size: 8x8 for 2-lobed Lanczos function, or 12x12 for 3-lobed Lanczos function.

ippStsNotSupportedModeErr

Indicates an error if the requested mode is not supported.