FIRGenBandstop
FIRGenBandstop
Computes bandstop FIR filter coefficients.
Syntax
IppStatus ippsFIRGenBandstop_64f(Ipp64f
rLowFreq
, Ipp64f
rHighFreq
, Ipp64f*
pTaps
, int
tapsLen
, IppWinType
winType
, IppBool
doNormal
, Ipp8u*
pBuffer
);
Include Files
ipps.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
Libraries:
ippcore.lib
,
ippvm.lib
Parameters
- rLowFreq
- Normalized low cutoff frequency, must be in the range (0, 0.5) and less thanrHighFreq.
- rHighFreq
- Normalized high cutoff frequency, must be in the range (0, 0.5) and greater thanrLowFreq.
- pTaps
- Pointer to the array where computed tap values are stored. The number of elements in the array istapsLen.
- tapsLen
- Number of elements in the array containing the tap values, must be equal or greater than 5.
- winType
- Specifies what type of window is used in computations. ThewinTypemust have one of the following values:
- ippWinBartlettBartlett window;
- ippWinBlackmanBlackman window;
- ippWinHammingHamming window;
- ippWinHannHann window.
- doNormal
- Specifies normalized or non-normalized sequence of the filter coefficients is computed. ThedoNormalmust have one of the following values:
- ippTrueThe function computes normalized sequence of coefficients.
- ippFalseThe function computes non-normalized sequence of coefficients.
- pBuffer
- Pointer to the buffer for internal calculations. To get the size of the buffer, use theippsFIRGenGetBufferSizefunction.
Description
This function computes
tapsLen
coefficients for bandstop FIR filter with the cutoff frequencies rLowFreq
and rHighFreq
by windowing the ideal infinite filter coefficients. The parameter winType
specifies the type of the window. For more information on window types used by the function, see Windowing Functions. The computed coefficients are stored in the array pTaps
.Return Values
- ippStsNoErr
- Indicates no error.
- ippStsNullPtrErr
- Indicates an error when thepTapspointer isNULL.
- ippStsSizeErr
- Indicates an error when thetapsLenis less than 5, orrLowFreqis greater than or equal torHighFreq, or one of the frequency parametersrLowFreqandrHighFreqis out of the range.