Searches for the fixed codebook vector.
Syntax
IppStatus ippsFixedCodebookSearch_RTA_32f(const Ipp32f* pSrcFixedTarget, const Ipp32f* pSrcImpulseResponse, Ipp32f* pDstFixedVector, int subFrameSize, int* pDstFixedIndex, Ipp32f* pDstGain, int numPulses, int complexity);
IppStatus ippsFixedCodebookSearchBuffer_RTA_32f(const Ipp32f* pSrcFixedTarget, const Ipp32f* pSrcImpulseResponse, Ipp32f* pDstFixedVector, int subFrameSize, int* pDstFixedIndex, Ipp32f* pDstGain, int numPulses, int complexity, Ipp8u* pBuffer);
IppStatus ippsFixedCodebookSearchRandom_RTA_32f(const Ipp32f* pSrcFixedTarget, const Ipp32f* pSrcImpulseResponse, Ipp32f* pDstFixedVector, int subFrameSize, int* pDstFixedIndex, Ipp32f* pDstGain, int codebookSize, int nStage, int gainLimit);
Parameters
pSrcFixedTarget |
Pointer to the input target signal [subFrameSize]. |
pSrcImpulseResponse |
Pointer to the input impulse response [subFrameSize]. |
pDstFixedVector |
Pointer to the output fixed codebook vector [subFrameSize]. |
subFrameSize |
Size of the subframe. |
pDstFixedIndex |
Pointer to the output fixed codebook search index value. |
pDstGain |
Pointer to the output optimal gain value. |
numPulses |
Number of pulses. |
complexity |
Complexity control parameter, possible values are: 0, 1, 2, 3. |
codebookSize |
Size of the random codebook, possible values: 64, 160, 256. |
nStage |
Number of stage, possible values: 1, 2, 2. |
pBuffer |
Pointer to the working buffer. |
gainLimit |
Flag that specifies the gain constrain limit, possible values: 0, 1, 2, 3, 4. |
Description
The functions ippsFixedCodebookSearch_RTA, ippsFixedCodebookSearchBuffer_RTA, and ippsFixedCodebookSearchRandom_RTA are declared in the ippsc.h file.
Caution
THE FUNCTION ippsFixedCodebookSearch_RTA IS DEPRECATED. Please use the function ippsFixedCodebookSearchBuffer_RTA instead.
These functions search for the fixed-codebook vector and corresponding vector index in the fixed (ippsFixedCodebookSearch_RTA, ippsFixedCodebookSearchBuffer_RTA) and random fixed (ippsFixedCodebookSearchRandom_RTA) codebooks respectively. The function ippsFixedCodebookSearchBuffer_RTA uses the internal buffer, which size must be calculated by the function ippsFixedCodebookSearchBuffer_RTA_GetBufferSize.
Return Values
ippStsNoErr |
Indicates no error. |
IppStsNullPtrErr |
Indicates an error when one of the specified pointers is NULL. |
IppStsSizeErr |
Indicates an error when subFrameSize is less than or equal to 0, is greater than 80. |
IppStsRangeErr |
Indicates an error when complexity is less than 0 or greater than 3; or nStage is not equal to 0, 1, or 2; or gainLimit is not equal to 0, 1, 2, 3, 4; or codebookSize is less than 1 or greater than 256; or numPulses is less than 5 or greater than 10. |