FIRSetTaps

Sets the tap values in the FIR filter state structure.

Syntax

IppStatus ippsFIRSetTaps_16s(const Ipp16s* pTaps, IppsFIRState_16s* pState, int tapsFactor);

IppStatus ippsFIRSetTaps_32s(const Ipp32s* pTaps, IppsFIRState_32s* pState);

IppStatus ippsFIRSetTaps_32f(const Ipp32f* pTaps, IppsFIRState_32f* pState);

IppStatus ippsFIRSetTaps_64f(const Ipp64f* pTaps, IppsFIRState_64f* pState);

IppStatus ippsFIRSetTaps32f_16s(const Ipp32f* pTaps, IppsFIRState32f_16s* pState);

IppStatus ippsFIRSetTaps64f_16s(const Ipp64f* pTaps, IppsFIRState64f_16s* pState);

IppStatus ippsFIRSetTaps64f_32s(const Ipp64f* pTaps, IppsFIRState64f_32s* pState);

IppStatus ippsFIRSetTaps64f_32f(const Ipp64f* pTaps, IppsFIRState64f_32f* pState);

IppStatus ippsFIRSetTaps_32fc(const Ipp32fc* pTaps, IppsFIRState_32fc* pState);

IppStatus ippsFIRSetTaps_64fc(const Ipp64fc* pTaps, IppsFIRState_64fc* pState);

IppStatus ippsFIRSetTaps32fc_16sc(const Ipp32fc* pTaps, IppsFIRState32fc_16sc* pState);

IppStatus ippsFIRSetTaps64fc_16sc(const Ipp64fc* pTaps, IppsFIRState64fc_16sc* pState);

IppStatus ippsFIRSetTaps64fc_32sc(const Ipp64fc* pTaps, IppsFIRState64fc_32sc* pState);

IppStatus ippsFIRSetTaps64fc_32fc(const Ipp64fc* pTaps, IppsFIRState64fc_32fc* pState);

IppStatus ippsFIRSetTaps32s_16s32f(const Ipp32f* pTaps, IppsFIRState32s_16s* pState);

IppStatus ippsFIRSetTaps32sc_16sc32fc(const Ipp32fc* pTaps, IppsFIRState32sc_16sc* pState);

IppStatus ippsFIRSetTaps32s_16s(const Ipp32s* pTaps, IppsFIRState32s_16s* pState, int tapsFactor);

IppStatus ippsFIRSetTaps32sc_16sc(const Ipp32sc* pTaps, IppsFIRState32sc_16sc* pState, int tapsFactor);

Parameters

pState	Pointer to the FIR filter state structure.
pTaps	Pointer to the array containing the tap values.
tapsFactor	Scale factor for the taps.

Description

The function ippsFIRSetTaps is declared in the ipps.h file. This function sets new tap values in the previously initialized FIR filter state structure pState. New tap values must be specified in the array pTaps. The length of the array pTaps must be equal to the tapsLen parameter value of the initialized filter state.

To scale integer taps, use the tapsFactor value.

Before calling ippsFIRSetTaps function, the corresponding filter state structure must be initialized by calling the function ippsFIRInitAlloc or ippsFIRMRInitAlloc.

Return Values

ippStsNoErr	Indicates no error.
ippStsNullPtrErr	Indicates an error when one of the specified pointers is NULL.
ippStsContextMatchErr	Indicates an error when the state identifier is incorrect.