Chris@69: /*********************************************************************** Chris@69: Copyright (c) 2006-2011, Skype Limited. All rights reserved. Chris@69: Redistribution and use in source and binary forms, with or without Chris@69: modification, are permitted provided that the following conditions Chris@69: are met: Chris@69: - Redistributions of source code must retain the above copyright notice, Chris@69: this list of conditions and the following disclaimer. Chris@69: - Redistributions in binary form must reproduce the above copyright Chris@69: notice, this list of conditions and the following disclaimer in the Chris@69: documentation and/or other materials provided with the distribution. Chris@69: - Neither the name of Internet Society, IETF or IETF Trust, nor the Chris@69: names of specific contributors, may be used to endorse or promote Chris@69: products derived from this software without specific prior written Chris@69: permission. Chris@69: THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" Chris@69: AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE Chris@69: IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE Chris@69: ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE Chris@69: LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR Chris@69: CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF Chris@69: SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS Chris@69: INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN Chris@69: CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) Chris@69: ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE Chris@69: POSSIBILITY OF SUCH DAMAGE. Chris@69: ***********************************************************************/ Chris@69: Chris@69: #ifndef SILK_MAIN_H Chris@69: #define SILK_MAIN_H Chris@69: Chris@69: #include "SigProc_FIX.h" Chris@69: #include "define.h" Chris@69: #include "structs.h" Chris@69: #include "tables.h" Chris@69: #include "PLC.h" Chris@69: #include "control.h" Chris@69: #include "debug.h" Chris@69: #include "entenc.h" Chris@69: #include "entdec.h" Chris@69: Chris@69: #if defined(OPUS_X86_MAY_HAVE_SSE4_1) Chris@69: #include "x86/main_sse.h" Chris@69: #endif Chris@69: Chris@69: #if (defined(OPUS_ARM_ASM) || defined(OPUS_ARM_MAY_HAVE_NEON_INTR)) Chris@69: #include "arm/NSQ_del_dec_arm.h" Chris@69: #endif Chris@69: Chris@69: /* Convert Left/Right stereo signal to adaptive Mid/Side representation */ Chris@69: void silk_stereo_LR_to_MS( Chris@69: stereo_enc_state *state, /* I/O State */ Chris@69: opus_int16 x1[], /* I/O Left input signal, becomes mid signal */ Chris@69: opus_int16 x2[], /* I/O Right input signal, becomes side signal */ Chris@69: opus_int8 ix[ 2 ][ 3 ], /* O Quantization indices */ Chris@69: opus_int8 *mid_only_flag, /* O Flag: only mid signal coded */ Chris@69: opus_int32 mid_side_rates_bps[], /* O Bitrates for mid and side signals */ Chris@69: opus_int32 total_rate_bps, /* I Total bitrate */ Chris@69: opus_int prev_speech_act_Q8, /* I Speech activity level in previous frame */ Chris@69: opus_int toMono, /* I Last frame before a stereo->mono transition */ Chris@69: opus_int fs_kHz, /* I Sample rate (kHz) */ Chris@69: opus_int frame_length /* I Number of samples */ Chris@69: ); Chris@69: Chris@69: /* Convert adaptive Mid/Side representation to Left/Right stereo signal */ Chris@69: void silk_stereo_MS_to_LR( Chris@69: stereo_dec_state *state, /* I/O State */ Chris@69: opus_int16 x1[], /* I/O Left input signal, becomes mid signal */ Chris@69: opus_int16 x2[], /* I/O Right input signal, becomes side signal */ Chris@69: const opus_int32 pred_Q13[], /* I Predictors */ Chris@69: opus_int fs_kHz, /* I Samples rate (kHz) */ Chris@69: opus_int frame_length /* I Number of samples */ Chris@69: ); Chris@69: Chris@69: /* Find least-squares prediction gain for one signal based on another and quantize it */ Chris@69: opus_int32 silk_stereo_find_predictor( /* O Returns predictor in Q13 */ Chris@69: opus_int32 *ratio_Q14, /* O Ratio of residual and mid energies */ Chris@69: const opus_int16 x[], /* I Basis signal */ Chris@69: const opus_int16 y[], /* I Target signal */ Chris@69: opus_int32 mid_res_amp_Q0[], /* I/O Smoothed mid, residual norms */ Chris@69: opus_int length, /* I Number of samples */ Chris@69: opus_int smooth_coef_Q16 /* I Smoothing coefficient */ Chris@69: ); Chris@69: Chris@69: /* Quantize mid/side predictors */ Chris@69: void silk_stereo_quant_pred( Chris@69: opus_int32 pred_Q13[], /* I/O Predictors (out: quantized) */ Chris@69: opus_int8 ix[ 2 ][ 3 ] /* O Quantization indices */ Chris@69: ); Chris@69: Chris@69: /* Entropy code the mid/side quantization indices */ Chris@69: void silk_stereo_encode_pred( Chris@69: ec_enc *psRangeEnc, /* I/O Compressor data structure */ Chris@69: opus_int8 ix[ 2 ][ 3 ] /* I Quantization indices */ Chris@69: ); Chris@69: Chris@69: /* Entropy code the mid-only flag */ Chris@69: void silk_stereo_encode_mid_only( Chris@69: ec_enc *psRangeEnc, /* I/O Compressor data structure */ Chris@69: opus_int8 mid_only_flag Chris@69: ); Chris@69: Chris@69: /* Decode mid/side predictors */ Chris@69: void silk_stereo_decode_pred( Chris@69: ec_dec *psRangeDec, /* I/O Compressor data structure */ Chris@69: opus_int32 pred_Q13[] /* O Predictors */ Chris@69: ); Chris@69: Chris@69: /* Decode mid-only flag */ Chris@69: void silk_stereo_decode_mid_only( Chris@69: ec_dec *psRangeDec, /* I/O Compressor data structure */ Chris@69: opus_int *decode_only_mid /* O Flag that only mid channel has been coded */ Chris@69: ); Chris@69: Chris@69: /* Encodes signs of excitation */ Chris@69: void silk_encode_signs( Chris@69: ec_enc *psRangeEnc, /* I/O Compressor data structure */ Chris@69: const opus_int8 pulses[], /* I pulse signal */ Chris@69: opus_int length, /* I length of input */ Chris@69: const opus_int signalType, /* I Signal type */ Chris@69: const opus_int quantOffsetType, /* I Quantization offset type */ Chris@69: const opus_int sum_pulses[ MAX_NB_SHELL_BLOCKS ] /* I Sum of absolute pulses per block */ Chris@69: ); Chris@69: Chris@69: /* Decodes signs of excitation */ Chris@69: void silk_decode_signs( Chris@69: ec_dec *psRangeDec, /* I/O Compressor data structure */ Chris@69: opus_int16 pulses[], /* I/O pulse signal */ Chris@69: opus_int length, /* I length of input */ Chris@69: const opus_int signalType, /* I Signal type */ Chris@69: const opus_int quantOffsetType, /* I Quantization offset type */ Chris@69: const opus_int sum_pulses[ MAX_NB_SHELL_BLOCKS ] /* I Sum of absolute pulses per block */ Chris@69: ); Chris@69: Chris@69: /* Check encoder control struct */ Chris@69: opus_int check_control_input( Chris@69: silk_EncControlStruct *encControl /* I Control structure */ Chris@69: ); Chris@69: Chris@69: /* Control internal sampling rate */ Chris@69: opus_int silk_control_audio_bandwidth( Chris@69: silk_encoder_state *psEncC, /* I/O Pointer to Silk encoder state */ Chris@69: silk_EncControlStruct *encControl /* I Control structure */ Chris@69: ); Chris@69: Chris@69: /* Control SNR of redidual quantizer */ Chris@69: opus_int silk_control_SNR( Chris@69: silk_encoder_state *psEncC, /* I/O Pointer to Silk encoder state */ Chris@69: opus_int32 TargetRate_bps /* I Target max bitrate (bps) */ Chris@69: ); Chris@69: Chris@69: /***************/ Chris@69: /* Shell coder */ Chris@69: /***************/ Chris@69: Chris@69: /* Encode quantization indices of excitation */ Chris@69: void silk_encode_pulses( Chris@69: ec_enc *psRangeEnc, /* I/O compressor data structure */ Chris@69: const opus_int signalType, /* I Signal type */ Chris@69: const opus_int quantOffsetType, /* I quantOffsetType */ Chris@69: opus_int8 pulses[], /* I quantization indices */ Chris@69: const opus_int frame_length /* I Frame length */ Chris@69: ); Chris@69: Chris@69: /* Shell encoder, operates on one shell code frame of 16 pulses */ Chris@69: void silk_shell_encoder( Chris@69: ec_enc *psRangeEnc, /* I/O compressor data structure */ Chris@69: const opus_int *pulses0 /* I data: nonnegative pulse amplitudes */ Chris@69: ); Chris@69: Chris@69: /* Shell decoder, operates on one shell code frame of 16 pulses */ Chris@69: void silk_shell_decoder( Chris@69: opus_int16 *pulses0, /* O data: nonnegative pulse amplitudes */ Chris@69: ec_dec *psRangeDec, /* I/O Compressor data structure */ Chris@69: const opus_int pulses4 /* I number of pulses per pulse-subframe */ Chris@69: ); Chris@69: Chris@69: /* Gain scalar quantization with hysteresis, uniform on log scale */ Chris@69: void silk_gains_quant( Chris@69: opus_int8 ind[ MAX_NB_SUBFR ], /* O gain indices */ Chris@69: opus_int32 gain_Q16[ MAX_NB_SUBFR ], /* I/O gains (quantized out) */ Chris@69: opus_int8 *prev_ind, /* I/O last index in previous frame */ Chris@69: const opus_int conditional, /* I first gain is delta coded if 1 */ Chris@69: const opus_int nb_subfr /* I number of subframes */ Chris@69: ); Chris@69: Chris@69: /* Gains scalar dequantization, uniform on log scale */ Chris@69: void silk_gains_dequant( Chris@69: opus_int32 gain_Q16[ MAX_NB_SUBFR ], /* O quantized gains */ Chris@69: const opus_int8 ind[ MAX_NB_SUBFR ], /* I gain indices */ Chris@69: opus_int8 *prev_ind, /* I/O last index in previous frame */ Chris@69: const opus_int conditional, /* I first gain is delta coded if 1 */ Chris@69: const opus_int nb_subfr /* I number of subframes */ Chris@69: ); Chris@69: Chris@69: /* Compute unique identifier of gain indices vector */ Chris@69: opus_int32 silk_gains_ID( /* O returns unique identifier of gains */ Chris@69: const opus_int8 ind[ MAX_NB_SUBFR ], /* I gain indices */ Chris@69: const opus_int nb_subfr /* I number of subframes */ Chris@69: ); Chris@69: Chris@69: /* Interpolate two vectors */ Chris@69: void silk_interpolate( Chris@69: opus_int16 xi[ MAX_LPC_ORDER ], /* O interpolated vector */ Chris@69: const opus_int16 x0[ MAX_LPC_ORDER ], /* I first vector */ Chris@69: const opus_int16 x1[ MAX_LPC_ORDER ], /* I second vector */ Chris@69: const opus_int ifact_Q2, /* I interp. factor, weight on 2nd vector */ Chris@69: const opus_int d /* I number of parameters */ Chris@69: ); Chris@69: Chris@69: /* LTP tap quantizer */ Chris@69: void silk_quant_LTP_gains( Chris@69: opus_int16 B_Q14[ MAX_NB_SUBFR * LTP_ORDER ], /* O Quantized LTP gains */ Chris@69: opus_int8 cbk_index[ MAX_NB_SUBFR ], /* O Codebook Index */ Chris@69: opus_int8 *periodicity_index, /* O Periodicity Index */ Chris@69: opus_int32 *sum_gain_dB_Q7, /* I/O Cumulative max prediction gain */ Chris@69: opus_int *pred_gain_dB_Q7, /* O LTP prediction gain */ Chris@69: const opus_int32 XX_Q17[ MAX_NB_SUBFR*LTP_ORDER*LTP_ORDER ], /* I Correlation matrix in Q18 */ Chris@69: const opus_int32 xX_Q17[ MAX_NB_SUBFR*LTP_ORDER ], /* I Correlation vector in Q18 */ Chris@69: const opus_int subfr_len, /* I Number of samples per subframe */ Chris@69: const opus_int nb_subfr, /* I Number of subframes */ Chris@69: int arch /* I Run-time architecture */ Chris@69: ); Chris@69: Chris@69: /* Entropy constrained matrix-weighted VQ, for a single input data vector */ Chris@69: void silk_VQ_WMat_EC_c( Chris@69: opus_int8 *ind, /* O index of best codebook vector */ Chris@69: opus_int32 *res_nrg_Q15, /* O best residual energy */ Chris@69: opus_int32 *rate_dist_Q8, /* O best total bitrate */ Chris@69: opus_int *gain_Q7, /* O sum of absolute LTP coefficients */ Chris@69: const opus_int32 *XX_Q17, /* I correlation matrix */ Chris@69: const opus_int32 *xX_Q17, /* I correlation vector */ Chris@69: const opus_int8 *cb_Q7, /* I codebook */ Chris@69: const opus_uint8 *cb_gain_Q7, /* I codebook effective gain */ Chris@69: const opus_uint8 *cl_Q5, /* I code length for each codebook vector */ Chris@69: const opus_int subfr_len, /* I number of samples per subframe */ Chris@69: const opus_int32 max_gain_Q7, /* I maximum sum of absolute LTP coefficients */ Chris@69: const opus_int L /* I number of vectors in codebook */ Chris@69: ); Chris@69: Chris@69: #if !defined(OVERRIDE_silk_VQ_WMat_EC) Chris@69: #define silk_VQ_WMat_EC(ind, res_nrg_Q15, rate_dist_Q8, gain_Q7, XX_Q17, xX_Q17, cb_Q7, cb_gain_Q7, cl_Q5, subfr_len, max_gain_Q7, L, arch) \ Chris@69: ((void)(arch),silk_VQ_WMat_EC_c(ind, res_nrg_Q15, rate_dist_Q8, gain_Q7, XX_Q17, xX_Q17, cb_Q7, cb_gain_Q7, cl_Q5, subfr_len, max_gain_Q7, L)) Chris@69: #endif Chris@69: Chris@69: /************************************/ Chris@69: /* Noise shaping quantization (NSQ) */ Chris@69: /************************************/ Chris@69: Chris@69: void silk_NSQ_c( Chris@69: const silk_encoder_state *psEncC, /* I Encoder State */ Chris@69: silk_nsq_state *NSQ, /* I/O NSQ state */ Chris@69: SideInfoIndices *psIndices, /* I/O Quantization Indices */ Chris@69: const opus_int16 x16[], /* I Input */ Chris@69: opus_int8 pulses[], /* O Quantized pulse signal */ Chris@69: const opus_int16 PredCoef_Q12[ 2 * MAX_LPC_ORDER ], /* I Short term prediction coefs */ Chris@69: const opus_int16 LTPCoef_Q14[ LTP_ORDER * MAX_NB_SUBFR ], /* I Long term prediction coefs */ Chris@69: const opus_int16 AR_Q13[ MAX_NB_SUBFR * MAX_SHAPE_LPC_ORDER ], /* I Noise shaping coefs */ Chris@69: const opus_int HarmShapeGain_Q14[ MAX_NB_SUBFR ], /* I Long term shaping coefs */ Chris@69: const opus_int Tilt_Q14[ MAX_NB_SUBFR ], /* I Spectral tilt */ Chris@69: const opus_int32 LF_shp_Q14[ MAX_NB_SUBFR ], /* I Low frequency shaping coefs */ Chris@69: const opus_int32 Gains_Q16[ MAX_NB_SUBFR ], /* I Quantization step sizes */ Chris@69: const opus_int pitchL[ MAX_NB_SUBFR ], /* I Pitch lags */ Chris@69: const opus_int Lambda_Q10, /* I Rate/distortion tradeoff */ Chris@69: const opus_int LTP_scale_Q14 /* I LTP state scaling */ Chris@69: ); Chris@69: Chris@69: #if !defined(OVERRIDE_silk_NSQ) Chris@69: #define silk_NSQ(psEncC, NSQ, psIndices, x16, pulses, PredCoef_Q12, LTPCoef_Q14, AR_Q13, \ Chris@69: HarmShapeGain_Q14, Tilt_Q14, LF_shp_Q14, Gains_Q16, pitchL, Lambda_Q10, LTP_scale_Q14, arch) \ Chris@69: ((void)(arch),silk_NSQ_c(psEncC, NSQ, psIndices, x16, pulses, PredCoef_Q12, LTPCoef_Q14, AR_Q13, \ Chris@69: HarmShapeGain_Q14, Tilt_Q14, LF_shp_Q14, Gains_Q16, pitchL, Lambda_Q10, LTP_scale_Q14)) Chris@69: #endif Chris@69: Chris@69: /* Noise shaping using delayed decision */ Chris@69: void silk_NSQ_del_dec_c( Chris@69: const silk_encoder_state *psEncC, /* I Encoder State */ Chris@69: silk_nsq_state *NSQ, /* I/O NSQ state */ Chris@69: SideInfoIndices *psIndices, /* I/O Quantization Indices */ Chris@69: const opus_int16 x16[], /* I Input */ Chris@69: opus_int8 pulses[], /* O Quantized pulse signal */ Chris@69: const opus_int16 PredCoef_Q12[ 2 * MAX_LPC_ORDER ], /* I Short term prediction coefs */ Chris@69: const opus_int16 LTPCoef_Q14[ LTP_ORDER * MAX_NB_SUBFR ], /* I Long term prediction coefs */ Chris@69: const opus_int16 AR_Q13[ MAX_NB_SUBFR * MAX_SHAPE_LPC_ORDER ], /* I Noise shaping coefs */ Chris@69: const opus_int HarmShapeGain_Q14[ MAX_NB_SUBFR ], /* I Long term shaping coefs */ Chris@69: const opus_int Tilt_Q14[ MAX_NB_SUBFR ], /* I Spectral tilt */ Chris@69: const opus_int32 LF_shp_Q14[ MAX_NB_SUBFR ], /* I Low frequency shaping coefs */ Chris@69: const opus_int32 Gains_Q16[ MAX_NB_SUBFR ], /* I Quantization step sizes */ Chris@69: const opus_int pitchL[ MAX_NB_SUBFR ], /* I Pitch lags */ Chris@69: const opus_int Lambda_Q10, /* I Rate/distortion tradeoff */ Chris@69: const opus_int LTP_scale_Q14 /* I LTP state scaling */ Chris@69: ); Chris@69: Chris@69: #if !defined(OVERRIDE_silk_NSQ_del_dec) Chris@69: #define silk_NSQ_del_dec(psEncC, NSQ, psIndices, x16, pulses, PredCoef_Q12, LTPCoef_Q14, AR_Q13, \ Chris@69: HarmShapeGain_Q14, Tilt_Q14, LF_shp_Q14, Gains_Q16, pitchL, Lambda_Q10, LTP_scale_Q14, arch) \ Chris@69: ((void)(arch),silk_NSQ_del_dec_c(psEncC, NSQ, psIndices, x16, pulses, PredCoef_Q12, LTPCoef_Q14, AR_Q13, \ Chris@69: HarmShapeGain_Q14, Tilt_Q14, LF_shp_Q14, Gains_Q16, pitchL, Lambda_Q10, LTP_scale_Q14)) Chris@69: #endif Chris@69: Chris@69: /************/ Chris@69: /* Silk VAD */ Chris@69: /************/ Chris@69: /* Initialize the Silk VAD */ Chris@69: opus_int silk_VAD_Init( /* O Return value, 0 if success */ Chris@69: silk_VAD_state *psSilk_VAD /* I/O Pointer to Silk VAD state */ Chris@69: ); Chris@69: Chris@69: /* Get speech activity level in Q8 */ Chris@69: opus_int silk_VAD_GetSA_Q8_c( /* O Return value, 0 if success */ Chris@69: silk_encoder_state *psEncC, /* I/O Encoder state */ Chris@69: const opus_int16 pIn[] /* I PCM input */ Chris@69: ); Chris@69: Chris@69: #if !defined(OVERRIDE_silk_VAD_GetSA_Q8) Chris@69: #define silk_VAD_GetSA_Q8(psEnC, pIn, arch) ((void)(arch),silk_VAD_GetSA_Q8_c(psEnC, pIn)) Chris@69: #endif Chris@69: Chris@69: /* Low-pass filter with variable cutoff frequency based on */ Chris@69: /* piece-wise linear interpolation between elliptic filters */ Chris@69: /* Start by setting transition_frame_no = 1; */ Chris@69: void silk_LP_variable_cutoff( Chris@69: silk_LP_state *psLP, /* I/O LP filter state */ Chris@69: opus_int16 *frame, /* I/O Low-pass filtered output signal */ Chris@69: const opus_int frame_length /* I Frame length */ Chris@69: ); Chris@69: Chris@69: /******************/ Chris@69: /* NLSF Quantizer */ Chris@69: /******************/ Chris@69: /* Limit, stabilize, convert and quantize NLSFs */ Chris@69: void silk_process_NLSFs( Chris@69: silk_encoder_state *psEncC, /* I/O Encoder state */ Chris@69: opus_int16 PredCoef_Q12[ 2 ][ MAX_LPC_ORDER ], /* O Prediction coefficients */ Chris@69: opus_int16 pNLSF_Q15[ MAX_LPC_ORDER ], /* I/O Normalized LSFs (quant out) (0 - (2^15-1)) */ Chris@69: const opus_int16 prev_NLSFq_Q15[ MAX_LPC_ORDER ] /* I Previous Normalized LSFs (0 - (2^15-1)) */ Chris@69: ); Chris@69: Chris@69: opus_int32 silk_NLSF_encode( /* O Returns RD value in Q25 */ Chris@69: opus_int8 *NLSFIndices, /* I Codebook path vector [ LPC_ORDER + 1 ] */ Chris@69: opus_int16 *pNLSF_Q15, /* I/O Quantized NLSF vector [ LPC_ORDER ] */ Chris@69: const silk_NLSF_CB_struct *psNLSF_CB, /* I Codebook object */ Chris@69: const opus_int16 *pW_QW, /* I NLSF weight vector [ LPC_ORDER ] */ Chris@69: const opus_int NLSF_mu_Q20, /* I Rate weight for the RD optimization */ Chris@69: const opus_int nSurvivors, /* I Max survivors after first stage */ Chris@69: const opus_int signalType /* I Signal type: 0/1/2 */ Chris@69: ); Chris@69: Chris@69: /* Compute quantization errors for an LPC_order element input vector for a VQ codebook */ Chris@69: void silk_NLSF_VQ( Chris@69: opus_int32 err_Q26[], /* O Quantization errors [K] */ Chris@69: const opus_int16 in_Q15[], /* I Input vectors to be quantized [LPC_order] */ Chris@69: const opus_uint8 pCB_Q8[], /* I Codebook vectors [K*LPC_order] */ Chris@69: const opus_int16 pWght_Q9[], /* I Codebook weights [K*LPC_order] */ Chris@69: const opus_int K, /* I Number of codebook vectors */ Chris@69: const opus_int LPC_order /* I Number of LPCs */ Chris@69: ); Chris@69: Chris@69: /* Delayed-decision quantizer for NLSF residuals */ Chris@69: opus_int32 silk_NLSF_del_dec_quant( /* O Returns RD value in Q25 */ Chris@69: opus_int8 indices[], /* O Quantization indices [ order ] */ Chris@69: const opus_int16 x_Q10[], /* I Input [ order ] */ Chris@69: const opus_int16 w_Q5[], /* I Weights [ order ] */ Chris@69: const opus_uint8 pred_coef_Q8[], /* I Backward predictor coefs [ order ] */ Chris@69: const opus_int16 ec_ix[], /* I Indices to entropy coding tables [ order ] */ Chris@69: const opus_uint8 ec_rates_Q5[], /* I Rates [] */ Chris@69: const opus_int quant_step_size_Q16, /* I Quantization step size */ Chris@69: const opus_int16 inv_quant_step_size_Q6, /* I Inverse quantization step size */ Chris@69: const opus_int32 mu_Q20, /* I R/D tradeoff */ Chris@69: const opus_int16 order /* I Number of input values */ Chris@69: ); Chris@69: Chris@69: /* Unpack predictor values and indices for entropy coding tables */ Chris@69: void silk_NLSF_unpack( Chris@69: opus_int16 ec_ix[], /* O Indices to entropy tables [ LPC_ORDER ] */ Chris@69: opus_uint8 pred_Q8[], /* O LSF predictor [ LPC_ORDER ] */ Chris@69: const silk_NLSF_CB_struct *psNLSF_CB, /* I Codebook object */ Chris@69: const opus_int CB1_index /* I Index of vector in first LSF codebook */ Chris@69: ); Chris@69: Chris@69: /***********************/ Chris@69: /* NLSF vector decoder */ Chris@69: /***********************/ Chris@69: void silk_NLSF_decode( Chris@69: opus_int16 *pNLSF_Q15, /* O Quantized NLSF vector [ LPC_ORDER ] */ Chris@69: opus_int8 *NLSFIndices, /* I Codebook path vector [ LPC_ORDER + 1 ] */ Chris@69: const silk_NLSF_CB_struct *psNLSF_CB /* I Codebook object */ Chris@69: ); Chris@69: Chris@69: /****************************************************/ Chris@69: /* Decoder Functions */ Chris@69: /****************************************************/ Chris@69: opus_int silk_init_decoder( Chris@69: silk_decoder_state *psDec /* I/O Decoder state pointer */ Chris@69: ); Chris@69: Chris@69: /* Set decoder sampling rate */ Chris@69: opus_int silk_decoder_set_fs( Chris@69: silk_decoder_state *psDec, /* I/O Decoder state pointer */ Chris@69: opus_int fs_kHz, /* I Sampling frequency (kHz) */ Chris@69: opus_int32 fs_API_Hz /* I API Sampling frequency (Hz) */ Chris@69: ); Chris@69: Chris@69: /****************/ Chris@69: /* Decode frame */ Chris@69: /****************/ Chris@69: opus_int silk_decode_frame( Chris@69: silk_decoder_state *psDec, /* I/O Pointer to Silk decoder state */ Chris@69: ec_dec *psRangeDec, /* I/O Compressor data structure */ Chris@69: opus_int16 pOut[], /* O Pointer to output speech frame */ Chris@69: opus_int32 *pN, /* O Pointer to size of output frame */ Chris@69: opus_int lostFlag, /* I 0: no loss, 1 loss, 2 decode fec */ Chris@69: opus_int condCoding, /* I The type of conditional coding to use */ Chris@69: int arch /* I Run-time architecture */ Chris@69: ); Chris@69: Chris@69: /* Decode indices from bitstream */ Chris@69: void silk_decode_indices( Chris@69: silk_decoder_state *psDec, /* I/O State */ Chris@69: ec_dec *psRangeDec, /* I/O Compressor data structure */ Chris@69: opus_int FrameIndex, /* I Frame number */ Chris@69: opus_int decode_LBRR, /* I Flag indicating LBRR data is being decoded */ Chris@69: opus_int condCoding /* I The type of conditional coding to use */ Chris@69: ); Chris@69: Chris@69: /* Decode parameters from payload */ Chris@69: void silk_decode_parameters( Chris@69: silk_decoder_state *psDec, /* I/O State */ Chris@69: silk_decoder_control *psDecCtrl, /* I/O Decoder control */ Chris@69: opus_int condCoding /* I The type of conditional coding to use */ Chris@69: ); Chris@69: Chris@69: /* Core decoder. Performs inverse NSQ operation LTP + LPC */ Chris@69: void silk_decode_core( Chris@69: silk_decoder_state *psDec, /* I/O Decoder state */ Chris@69: silk_decoder_control *psDecCtrl, /* I Decoder control */ Chris@69: opus_int16 xq[], /* O Decoded speech */ Chris@69: const opus_int16 pulses[ MAX_FRAME_LENGTH ], /* I Pulse signal */ Chris@69: int arch /* I Run-time architecture */ Chris@69: ); Chris@69: Chris@69: /* Decode quantization indices of excitation (Shell coding) */ Chris@69: void silk_decode_pulses( Chris@69: ec_dec *psRangeDec, /* I/O Compressor data structure */ Chris@69: opus_int16 pulses[], /* O Excitation signal */ Chris@69: const opus_int signalType, /* I Sigtype */ Chris@69: const opus_int quantOffsetType, /* I quantOffsetType */ Chris@69: const opus_int frame_length /* I Frame length */ Chris@69: ); Chris@69: Chris@69: /******************/ Chris@69: /* CNG */ Chris@69: /******************/ Chris@69: Chris@69: /* Reset CNG */ Chris@69: void silk_CNG_Reset( Chris@69: silk_decoder_state *psDec /* I/O Decoder state */ Chris@69: ); Chris@69: Chris@69: /* Updates CNG estimate, and applies the CNG when packet was lost */ Chris@69: void silk_CNG( Chris@69: silk_decoder_state *psDec, /* I/O Decoder state */ Chris@69: silk_decoder_control *psDecCtrl, /* I/O Decoder control */ Chris@69: opus_int16 frame[], /* I/O Signal */ Chris@69: opus_int length /* I Length of residual */ Chris@69: ); Chris@69: Chris@69: /* Encoding of various parameters */ Chris@69: void silk_encode_indices( Chris@69: silk_encoder_state *psEncC, /* I/O Encoder state */ Chris@69: ec_enc *psRangeEnc, /* I/O Compressor data structure */ Chris@69: opus_int FrameIndex, /* I Frame number */ Chris@69: opus_int encode_LBRR, /* I Flag indicating LBRR data is being encoded */ Chris@69: opus_int condCoding /* I The type of conditional coding to use */ Chris@69: ); Chris@69: Chris@69: #endif