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