SubbandProcessInit

Initializes the subband process state structure.

Syntax

IppStatus ippsSubbandProcessInit_32f(IppsSubbandProcessState_32f* pState, int order, int frameSize, int windowLen, const Ipp32f* pWindow, Ipp8u* pInitBuf);

IppStatus ippsSubbandProcessInit_16s(IppsSubbandProcessState_16s* pState, int order, int frameSize, int windowLen, const Ipp32s* pWindow, Ipp8u* pInitBuf);

Parameters

pState	Pointer to the subband process state structure.
order	Number of subbands is equal to 2^{order - 1} + 1.
frameSize	Size of frame. Must be in range from 1 to 2^order.
windowLen	Window length.
pWindow	Pointer to window coefficients . May be NULL if the order, frameSize and windowLen are equal to one of the predefined sets: (5, 24, 128) or (6, 44, 256). In this case the predefined window is used.
pInitBuf	Pointer to the initialized buffer.

Description

The functions ippsSubbandProcessInit are declared in the ippsc.h file. These functions initialize the state structure for the subband process in the external buffer. The size of this buffer must be calculated by the function ippsSubbandProcessGetSize beforehand. The functions ippsSubbandAnalysis and ippsSubbandSynthesis use this state structure in their operation.

Return Values

ippStsNoErr	Indicates no error.
ippStsNullPtrErr	Indicates an error when one of the specified pointers is NULL.
ippStsBadArgErr	Indicates an error when order is less or equal to 0, or when windowLen is not divisible by 2^order, or when frameSize is less than or equal to 0, or when pWindow is NULL and the appropriate internal window does not exist.