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

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

ResamplePolyphaseGetSize, ResamplePolyphaseFixedGetSize

Get the size of the polyphase resampling structure.

Syntax

IppStatus ippsResamplePolyphaseGetSize_16s(Ipp32f window, int nStep, int* pSize, IppHintAlgorithm hint);

IppStatus ippsResamplePolyphaseGetSize_32f(Ipp32f window, int nStep, int* pSize, IppHintAlgorithm hint);

IppStatus ippsResamplePolyphaseFixedGetSize_16s(int inRate, int outRate, int len, int* pSize, int* pLen, int* pHeight, IppHintAlgorithm hint);

IppStatus ippsResamplePolyphaseFixedGetSize_32f(int inRate, int outRate, int len, int* pSize, int* pLen, int* pHeight, IppHintAlgorithm hint);

Include Files

ipps.h

Domain Dependencies

Headers: ippcore.h, ippvm.h

Libraries: ippcore.lib, ippvm.lib

Parameters

window

The size of the ideal lowpass filter window.

nStep

The discretization step for filter coefficients.

inRate

The input rate for fixed factor resampling.

outRate

The output rate for fixed factor resampling.

len

The filter length for fixed factor resampling.

pSize

The pointer to the variable that contains the size of the polyphase resampling structure.

pLen

The pointer to the variable that contains the real filter length.

pHeight

The pointer to the variable that contains the number of filters.

hint

Suggests using specific code (must be equal to ippAlgHintFast). Possible values for the hint parameter are given in Hint Arguments.

Description

These functions determine the size required for the fixed rate polyphase resampling structure and associated storage, the filter length, and the number of filters in the filter bank. The returned length of the filter is equal to min{l ≥ len, l%4}, the subfilter length for zero phase is greater by 1. These values can be used for export and import of fixed polyphase resampling filter.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

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

ippStsSizeErr

For ippsResamplePolyphaseGetSize function, indicates an error when inRate, outRate , nStep or len is less than or equal to 0. For ippsResamplePolyphaseFixedGetSize function, indicates an error when inRate, outRate, nStep or len is less than or equal to 0.

ippStsBadArgErr

Indicates an error when window is less than 2/nStep.