Calculates the gain of the adaptive-codebook vector and the filtered codebook vector.
Syntax
IppStatus ippsAdaptiveCodebookGain_GSMAMR_16s (const Ipp16s* pSrcAdptTarget, const Ipp16s* pSrcFltAdptVector, Ipp16s* pResultAdptGain);
IppStatus ippsAdaptiveCodebookGainCoeffs_GSMAMR_16s (const Ipp16s* pSrcAdptTarget, const Ipp16s* pSrcFltAdptVector, Ipp16s* pResultAdptGain, Ipp16s* pResultAdptGainCoeffs);
Parameters
pSrcAdptTarget |
Pointer to the adaptive target signal vector [40]. |
pSrcFltAdptVector |
Pointer to the filtered adaptive-codebook vector [40], in Q12. |
pResultAdptGain |
Pointer to the output adaptive-codebook gain gp, in Q14. |
pResultAdptGainCoeffs |
Pointer to the output gain coefficients vector [4] , in Q15. |
Description
The functions ippsAdaptiveCodebookGain_GSMAMR and ippsAdaptiveCodebookGainCoeffs_GSMAMR are declared in ippsc.h file.
ippsAdaptiveCodebookGain_GSMAMR_16s. This function calculates the adaptive-codebook gain gp as given by:
bounded by 0 ≤gp ≤ 1.2, in Q14,
where x is the adaptive target signal vector, and y is the filtered adaptive-codebook vector.
See also the ippsAdaptiveCodebookGain_G729 function.
ippsAdaptiveCodebookGainCoeffs_GSMAMR_16s. This function calculates the adaptive-codebook gain gp in the same way as the ippsAdaptiveCodebookGain_GSMAMR_16s function does, and additionally returns the gain in a different representation given by the following formula:
The mantissas cxy , cyy and exponents expxy , expyy for both the normalized denominator and normalized numerator are returned in the pResultAdptGainCoeffs vector:
pResultAdptGainCoeffs[0] = cyy,
pResultAdptGainCoeffs[1] = expyy,
pResultAdptGainCoeffs[2] = cxy,
pResultAdptGainCoeffs[3] = expxy.
If cxy < 4, then zero gain is returned.
Return Values
ippStsNoErr |
Indicates no error. |
IppStsNullPtrErr |
Indicates an error when one of the specified pointers is NULL. |