xref: /aosp_15_r20/external/libopus/silk/decode_indices.c (revision a58d3d2adb790c104798cd88c8a3aff4fa8b82cc)
1*a58d3d2aSXin Li /***********************************************************************
2*a58d3d2aSXin Li Copyright (c) 2006-2011, Skype Limited. All rights reserved.
3*a58d3d2aSXin Li Redistribution and use in source and binary forms, with or without
4*a58d3d2aSXin Li modification, are permitted provided that the following conditions
5*a58d3d2aSXin Li are met:
6*a58d3d2aSXin Li - Redistributions of source code must retain the above copyright notice,
7*a58d3d2aSXin Li this list of conditions and the following disclaimer.
8*a58d3d2aSXin Li - Redistributions in binary form must reproduce the above copyright
9*a58d3d2aSXin Li notice, this list of conditions and the following disclaimer in the
10*a58d3d2aSXin Li documentation and/or other materials provided with the distribution.
11*a58d3d2aSXin Li - Neither the name of Internet Society, IETF or IETF Trust, nor the
12*a58d3d2aSXin Li names of specific contributors, may be used to endorse or promote
13*a58d3d2aSXin Li products derived from this software without specific prior written
14*a58d3d2aSXin Li permission.
15*a58d3d2aSXin Li THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
16*a58d3d2aSXin Li AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17*a58d3d2aSXin Li IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18*a58d3d2aSXin Li ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
19*a58d3d2aSXin Li LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20*a58d3d2aSXin Li CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21*a58d3d2aSXin Li SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22*a58d3d2aSXin Li INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23*a58d3d2aSXin Li CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24*a58d3d2aSXin Li ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25*a58d3d2aSXin Li POSSIBILITY OF SUCH DAMAGE.
26*a58d3d2aSXin Li ***********************************************************************/
27*a58d3d2aSXin Li 
28*a58d3d2aSXin Li #ifdef HAVE_CONFIG_H
29*a58d3d2aSXin Li #include "config.h"
30*a58d3d2aSXin Li #endif
31*a58d3d2aSXin Li 
32*a58d3d2aSXin Li #include "main.h"
33*a58d3d2aSXin Li 
34*a58d3d2aSXin Li /* Decode side-information parameters from payload */
silk_decode_indices(silk_decoder_state * psDec,ec_dec * psRangeDec,opus_int FrameIndex,opus_int decode_LBRR,opus_int condCoding)35*a58d3d2aSXin Li void silk_decode_indices(
36*a58d3d2aSXin Li     silk_decoder_state          *psDec,                         /* I/O  State                                       */
37*a58d3d2aSXin Li     ec_dec                      *psRangeDec,                    /* I/O  Compressor data structure                   */
38*a58d3d2aSXin Li     opus_int                    FrameIndex,                     /* I    Frame number                                */
39*a58d3d2aSXin Li     opus_int                    decode_LBRR,                    /* I    Flag indicating LBRR data is being decoded  */
40*a58d3d2aSXin Li     opus_int                    condCoding                      /* I    The type of conditional coding to use       */
41*a58d3d2aSXin Li )
42*a58d3d2aSXin Li {
43*a58d3d2aSXin Li     opus_int   i, k, Ix;
44*a58d3d2aSXin Li     opus_int   decode_absolute_lagIndex, delta_lagIndex;
45*a58d3d2aSXin Li     opus_int16 ec_ix[ MAX_LPC_ORDER ];
46*a58d3d2aSXin Li     opus_uint8 pred_Q8[ MAX_LPC_ORDER ];
47*a58d3d2aSXin Li 
48*a58d3d2aSXin Li     /*******************************************/
49*a58d3d2aSXin Li     /* Decode signal type and quantizer offset */
50*a58d3d2aSXin Li     /*******************************************/
51*a58d3d2aSXin Li     if( decode_LBRR || psDec->VAD_flags[ FrameIndex ] ) {
52*a58d3d2aSXin Li         Ix = ec_dec_icdf( psRangeDec, silk_type_offset_VAD_iCDF, 8 ) + 2;
53*a58d3d2aSXin Li     } else {
54*a58d3d2aSXin Li         Ix = ec_dec_icdf( psRangeDec, silk_type_offset_no_VAD_iCDF, 8 );
55*a58d3d2aSXin Li     }
56*a58d3d2aSXin Li     psDec->indices.signalType      = (opus_int8)silk_RSHIFT( Ix, 1 );
57*a58d3d2aSXin Li     psDec->indices.quantOffsetType = (opus_int8)( Ix & 1 );
58*a58d3d2aSXin Li 
59*a58d3d2aSXin Li     /****************/
60*a58d3d2aSXin Li     /* Decode gains */
61*a58d3d2aSXin Li     /****************/
62*a58d3d2aSXin Li     /* First subframe */
63*a58d3d2aSXin Li     if( condCoding == CODE_CONDITIONALLY ) {
64*a58d3d2aSXin Li         /* Conditional coding */
65*a58d3d2aSXin Li         psDec->indices.GainsIndices[ 0 ] = (opus_int8)ec_dec_icdf( psRangeDec, silk_delta_gain_iCDF, 8 );
66*a58d3d2aSXin Li     } else {
67*a58d3d2aSXin Li         /* Independent coding, in two stages: MSB bits followed by 3 LSBs */
68*a58d3d2aSXin Li         psDec->indices.GainsIndices[ 0 ]  = (opus_int8)silk_LSHIFT( ec_dec_icdf( psRangeDec, silk_gain_iCDF[ psDec->indices.signalType ], 8 ), 3 );
69*a58d3d2aSXin Li         psDec->indices.GainsIndices[ 0 ] += (opus_int8)ec_dec_icdf( psRangeDec, silk_uniform8_iCDF, 8 );
70*a58d3d2aSXin Li     }
71*a58d3d2aSXin Li 
72*a58d3d2aSXin Li     /* Remaining subframes */
73*a58d3d2aSXin Li     for( i = 1; i < psDec->nb_subfr; i++ ) {
74*a58d3d2aSXin Li         psDec->indices.GainsIndices[ i ] = (opus_int8)ec_dec_icdf( psRangeDec, silk_delta_gain_iCDF, 8 );
75*a58d3d2aSXin Li     }
76*a58d3d2aSXin Li 
77*a58d3d2aSXin Li     /**********************/
78*a58d3d2aSXin Li     /* Decode LSF Indices */
79*a58d3d2aSXin Li     /**********************/
80*a58d3d2aSXin Li     psDec->indices.NLSFIndices[ 0 ] = (opus_int8)ec_dec_icdf( psRangeDec, &psDec->psNLSF_CB->CB1_iCDF[ ( psDec->indices.signalType >> 1 ) * psDec->psNLSF_CB->nVectors ], 8 );
81*a58d3d2aSXin Li     silk_NLSF_unpack( ec_ix, pred_Q8, psDec->psNLSF_CB, psDec->indices.NLSFIndices[ 0 ] );
82*a58d3d2aSXin Li     celt_assert( psDec->psNLSF_CB->order == psDec->LPC_order );
83*a58d3d2aSXin Li     for( i = 0; i < psDec->psNLSF_CB->order; i++ ) {
84*a58d3d2aSXin Li         Ix = ec_dec_icdf( psRangeDec, &psDec->psNLSF_CB->ec_iCDF[ ec_ix[ i ] ], 8 );
85*a58d3d2aSXin Li         if( Ix == 0 ) {
86*a58d3d2aSXin Li             Ix -= ec_dec_icdf( psRangeDec, silk_NLSF_EXT_iCDF, 8 );
87*a58d3d2aSXin Li         } else if( Ix == 2 * NLSF_QUANT_MAX_AMPLITUDE ) {
88*a58d3d2aSXin Li             Ix += ec_dec_icdf( psRangeDec, silk_NLSF_EXT_iCDF, 8 );
89*a58d3d2aSXin Li         }
90*a58d3d2aSXin Li         psDec->indices.NLSFIndices[ i+1 ] = (opus_int8)( Ix - NLSF_QUANT_MAX_AMPLITUDE );
91*a58d3d2aSXin Li     }
92*a58d3d2aSXin Li 
93*a58d3d2aSXin Li     /* Decode LSF interpolation factor */
94*a58d3d2aSXin Li     if( psDec->nb_subfr == MAX_NB_SUBFR ) {
95*a58d3d2aSXin Li         psDec->indices.NLSFInterpCoef_Q2 = (opus_int8)ec_dec_icdf( psRangeDec, silk_NLSF_interpolation_factor_iCDF, 8 );
96*a58d3d2aSXin Li     } else {
97*a58d3d2aSXin Li         psDec->indices.NLSFInterpCoef_Q2 = 4;
98*a58d3d2aSXin Li     }
99*a58d3d2aSXin Li 
100*a58d3d2aSXin Li     if( psDec->indices.signalType == TYPE_VOICED )
101*a58d3d2aSXin Li     {
102*a58d3d2aSXin Li         /*********************/
103*a58d3d2aSXin Li         /* Decode pitch lags */
104*a58d3d2aSXin Li         /*********************/
105*a58d3d2aSXin Li         /* Get lag index */
106*a58d3d2aSXin Li         decode_absolute_lagIndex = 1;
107*a58d3d2aSXin Li         if( condCoding == CODE_CONDITIONALLY && psDec->ec_prevSignalType == TYPE_VOICED ) {
108*a58d3d2aSXin Li             /* Decode Delta index */
109*a58d3d2aSXin Li             delta_lagIndex = (opus_int16)ec_dec_icdf( psRangeDec, silk_pitch_delta_iCDF, 8 );
110*a58d3d2aSXin Li             if( delta_lagIndex > 0 ) {
111*a58d3d2aSXin Li                 delta_lagIndex = delta_lagIndex - 9;
112*a58d3d2aSXin Li                 psDec->indices.lagIndex = (opus_int16)( psDec->ec_prevLagIndex + delta_lagIndex );
113*a58d3d2aSXin Li                 decode_absolute_lagIndex = 0;
114*a58d3d2aSXin Li             }
115*a58d3d2aSXin Li         }
116*a58d3d2aSXin Li         if( decode_absolute_lagIndex ) {
117*a58d3d2aSXin Li             /* Absolute decoding */
118*a58d3d2aSXin Li             psDec->indices.lagIndex  = (opus_int16)ec_dec_icdf( psRangeDec, silk_pitch_lag_iCDF, 8 ) * silk_RSHIFT( psDec->fs_kHz, 1 );
119*a58d3d2aSXin Li             psDec->indices.lagIndex += (opus_int16)ec_dec_icdf( psRangeDec, psDec->pitch_lag_low_bits_iCDF, 8 );
120*a58d3d2aSXin Li         }
121*a58d3d2aSXin Li         psDec->ec_prevLagIndex = psDec->indices.lagIndex;
122*a58d3d2aSXin Li 
123*a58d3d2aSXin Li         /* Get countour index */
124*a58d3d2aSXin Li         psDec->indices.contourIndex = (opus_int8)ec_dec_icdf( psRangeDec, psDec->pitch_contour_iCDF, 8 );
125*a58d3d2aSXin Li 
126*a58d3d2aSXin Li         /********************/
127*a58d3d2aSXin Li         /* Decode LTP gains */
128*a58d3d2aSXin Li         /********************/
129*a58d3d2aSXin Li         /* Decode PERIndex value */
130*a58d3d2aSXin Li         psDec->indices.PERIndex = (opus_int8)ec_dec_icdf( psRangeDec, silk_LTP_per_index_iCDF, 8 );
131*a58d3d2aSXin Li 
132*a58d3d2aSXin Li         for( k = 0; k < psDec->nb_subfr; k++ ) {
133*a58d3d2aSXin Li             psDec->indices.LTPIndex[ k ] = (opus_int8)ec_dec_icdf( psRangeDec, silk_LTP_gain_iCDF_ptrs[ psDec->indices.PERIndex ], 8 );
134*a58d3d2aSXin Li         }
135*a58d3d2aSXin Li 
136*a58d3d2aSXin Li         /**********************/
137*a58d3d2aSXin Li         /* Decode LTP scaling */
138*a58d3d2aSXin Li         /**********************/
139*a58d3d2aSXin Li         if( condCoding == CODE_INDEPENDENTLY ) {
140*a58d3d2aSXin Li             psDec->indices.LTP_scaleIndex = (opus_int8)ec_dec_icdf( psRangeDec, silk_LTPscale_iCDF, 8 );
141*a58d3d2aSXin Li         } else {
142*a58d3d2aSXin Li             psDec->indices.LTP_scaleIndex = 0;
143*a58d3d2aSXin Li         }
144*a58d3d2aSXin Li     }
145*a58d3d2aSXin Li     psDec->ec_prevSignalType = psDec->indices.signalType;
146*a58d3d2aSXin Li 
147*a58d3d2aSXin Li     /***************/
148*a58d3d2aSXin Li     /* Decode seed */
149*a58d3d2aSXin Li     /***************/
150*a58d3d2aSXin Li     psDec->indices.Seed = (opus_int8)ec_dec_icdf( psRangeDec, silk_uniform4_iCDF, 8 );
151*a58d3d2aSXin Li }
152