Retrieves input signal from prediction error, using frequency domain prediction procedure.
Syntax
IppStatus ippsFDPInv_32f_I(Ipp32f* pSrcDst, const int* pBandsOffset, int predictorBandsNumber, Ipp8u* pPredictionUsed, IppsFDPState_32f* pFDPState);
Parameters
pSrcDst |
Pointer to the input and output data array for the in-place operation. |
pDstpBandsOffset |
Pointer to the band offset vector. |
predictorBandsNumber |
Number of scale factor bands. |
pPredictionUsed |
Pointer to array of flags showing whether prediction will be used in certain scale factor band. |
pFDPState |
Pointer to the predictor specific state structure. |
Description
This function is declared in the ippac.h header file. The function ippsFDPInv applies the procedure of frequency domain prediction to specific bands of the input spectral vector pSrcDst. Positions of bands are defined by the parameters predictorBandsNumber and pBandsOffset.
For each scale factor band i, if pPredictionUsed[i] is not equal to 0, all values of pSrcDst within the band are treated as a prediction error and the original signal is restored. If pPredictionUsed[ i] is equal to 0, all values of pSrcDst within the band are treated as a signal and will be passed without any changes.
Regardless of the pPredictionUsed flag, the coefficients of each predictor are updated.
Note
The function operates on the assumption that the end of the last band coincides with the end of the spectral data vector, that is, the size of pSrcDst vector is stored in the pBandsOffset[predictorBandsNumber] element.
See code example of using ippsFDPInv function.
Return Values
ippStsNoErr |
Indicates no error. |
ippStsNullPtrErr |
Indicates an error when at least oneof the specified pointers is NULL. |
ippStsSizeErr |
Indicates an error when predictorBandsNumber is less than or equal to 0. |
ippStsContextMatchErr |
Indicates an error when the state structure is invalid. |
ippStsMisalignedBuf |
Indicates misaligned arrays. Supply aligned data for better performance. |