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

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

ResamplePolyphaseSetFixedFilter

Sets polyphase resampling filter coefficients.

Syntax

IppStatus ippsResamplePolyphaseSetFixedFilter_16s(const Ipp16s* pSrc, int step, int height, IppsResamplingPolyphaseFixed_16s* pSpec);

IppStatus ippsResamplePolyphaseSetFixedFilter_32f(const Ipp32f* pSrc, int step, int height, IppsResamplingPolyphaseFixed_32f* pSpec);

Include Files

ipps.h

Domain Dependencies

Headers: ippcore.h, ippvm.h

Libraries: ippcore.lib, ippvm.lib

Parameters

pSrc

The pointer to the input vector of filter coefficients.

step

The row step in pSrc vector.

height

The number of filters (the number of rows in pSrc vector).

pSpec

The pointer to the resampling state structure.

Description

This function imports pre-calculated filter coefficients into the polyphase resampling structure. If the step value is less than the filter length, trailing filter coefficients are zeroed.

When allocating memory keep in mind that actual structure size of the filter is height * step + 1, because zero-phase subfilter has step + 1 coefficients. This function only works with structures obtained by using ResamplePolyphaseFixedInit function. The behavior for custom-created structures is undefined.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

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

ippStsSizeErr

Indicates an error when step or height is less than or equal to 0.

ippStsBadArgErr

Indicates that height is greater than the number of filters in pSpec structure.