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: #ifdef HAVE_CONFIG_H
Chris@69: #include "config.h"
Chris@69: #endif
Chris@69: 
Chris@69: #include "main_FLP.h"
Chris@69: #include "tuning_parameters.h"
Chris@69: 
Chris@69: /* Processing of gains */
Chris@69: void silk_process_gains_FLP(
Chris@69:     silk_encoder_state_FLP          *psEnc,                             /* I/O  Encoder state FLP                           */
Chris@69:     silk_encoder_control_FLP        *psEncCtrl,                         /* I/O  Encoder control FLP                         */
Chris@69:     opus_int                        condCoding                          /* I    The type of conditional coding to use       */
Chris@69: )
Chris@69: {
Chris@69:     silk_shape_state_FLP *psShapeSt = &psEnc->sShape;
Chris@69:     opus_int     k;
Chris@69:     opus_int32   pGains_Q16[ MAX_NB_SUBFR ];
Chris@69:     silk_float   s, InvMaxSqrVal, gain, quant_offset;
Chris@69: 
Chris@69:     /* Gain reduction when LTP coding gain is high */
Chris@69:     if( psEnc->sCmn.indices.signalType == TYPE_VOICED ) {
Chris@69:         s = 1.0f - 0.5f * silk_sigmoid( 0.25f * ( psEncCtrl->LTPredCodGain - 12.0f ) );
Chris@69:         for( k = 0; k < psEnc->sCmn.nb_subfr; k++ ) {
Chris@69:             psEncCtrl->Gains[ k ] *= s;
Chris@69:         }
Chris@69:     }
Chris@69: 
Chris@69:     /* Limit the quantized signal */
Chris@69:     InvMaxSqrVal = ( silk_float )( pow( 2.0f, 0.33f * ( 21.0f - psEnc->sCmn.SNR_dB_Q7 * ( 1 / 128.0f ) ) ) / psEnc->sCmn.subfr_length );
Chris@69: 
Chris@69:     for( k = 0; k < psEnc->sCmn.nb_subfr; k++ ) {
Chris@69:         /* Soft limit on ratio residual energy and squared gains */
Chris@69:         gain = psEncCtrl->Gains[ k ];
Chris@69:         gain = ( silk_float )sqrt( gain * gain + psEncCtrl->ResNrg[ k ] * InvMaxSqrVal );
Chris@69:         psEncCtrl->Gains[ k ] = silk_min_float( gain, 32767.0f );
Chris@69:     }
Chris@69: 
Chris@69:     /* Prepare gains for noise shaping quantization */
Chris@69:     for( k = 0; k < psEnc->sCmn.nb_subfr; k++ ) {
Chris@69:         pGains_Q16[ k ] = (opus_int32)( psEncCtrl->Gains[ k ] * 65536.0f );
Chris@69:     }
Chris@69: 
Chris@69:     /* Save unquantized gains and gain Index */
Chris@69:     silk_memcpy( psEncCtrl->GainsUnq_Q16, pGains_Q16, psEnc->sCmn.nb_subfr * sizeof( opus_int32 ) );
Chris@69:     psEncCtrl->lastGainIndexPrev = psShapeSt->LastGainIndex;
Chris@69: 
Chris@69:     /* Quantize gains */
Chris@69:     silk_gains_quant( psEnc->sCmn.indices.GainsIndices, pGains_Q16,
Chris@69:             &psShapeSt->LastGainIndex, condCoding == CODE_CONDITIONALLY, psEnc->sCmn.nb_subfr );
Chris@69: 
Chris@69:     /* Overwrite unquantized gains with quantized gains and convert back to Q0 from Q16 */
Chris@69:     for( k = 0; k < psEnc->sCmn.nb_subfr; k++ ) {
Chris@69:         psEncCtrl->Gains[ k ] = pGains_Q16[ k ] / 65536.0f;
Chris@69:     }
Chris@69: 
Chris@69:     /* Set quantizer offset for voiced signals. Larger offset when LTP coding gain is low or tilt is high (ie low-pass) */
Chris@69:     if( psEnc->sCmn.indices.signalType == TYPE_VOICED ) {
Chris@69:         if( psEncCtrl->LTPredCodGain + psEnc->sCmn.input_tilt_Q15 * ( 1.0f / 32768.0f ) > 1.0f ) {
Chris@69:             psEnc->sCmn.indices.quantOffsetType = 0;
Chris@69:         } else {
Chris@69:             psEnc->sCmn.indices.quantOffsetType = 1;
Chris@69:         }
Chris@69:     }
Chris@69: 
Chris@69:     /* Quantizer boundary adjustment */
Chris@69:     quant_offset = silk_Quantization_Offsets_Q10[ psEnc->sCmn.indices.signalType >> 1 ][ psEnc->sCmn.indices.quantOffsetType ] / 1024.0f;
Chris@69:     psEncCtrl->Lambda = LAMBDA_OFFSET
Chris@69:                       + LAMBDA_DELAYED_DECISIONS * psEnc->sCmn.nStatesDelayedDecision
Chris@69:                       + LAMBDA_SPEECH_ACT        * psEnc->sCmn.speech_activity_Q8 * ( 1.0f /  256.0f )
Chris@69:                       + LAMBDA_INPUT_QUALITY     * psEncCtrl->input_quality
Chris@69:                       + LAMBDA_CODING_QUALITY    * psEncCtrl->coding_quality
Chris@69:                       + LAMBDA_QUANT_OFFSET      * quant_offset;
Chris@69: 
Chris@69:     silk_assert( psEncCtrl->Lambda > 0.0f );
Chris@69:     silk_assert( psEncCtrl->Lambda < 2.0f );
Chris@69: }