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.h"
Chris@69: #include "stack_alloc.h"
Chris@69: #include "PLC.h"
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:     VARDECL( silk_decoder_control, psDecCtrl );
Chris@69:     opus_int         L, mv_len, ret = 0;
Chris@69:     SAVE_STACK;
Chris@69: 
Chris@69:     L = psDec->frame_length;
Chris@69:     ALLOC( psDecCtrl, 1, silk_decoder_control );
Chris@69:     psDecCtrl->LTP_scale_Q14 = 0;
Chris@69: 
Chris@69:     /* Safety checks */
Chris@69:     celt_assert( L > 0 && L <= MAX_FRAME_LENGTH );
Chris@69: 
Chris@69:     if(   lostFlag == FLAG_DECODE_NORMAL ||
Chris@69:         ( lostFlag == FLAG_DECODE_LBRR && psDec->LBRR_flags[ psDec->nFramesDecoded ] == 1 ) )
Chris@69:     {
Chris@69:         VARDECL( opus_int16, pulses );
Chris@69:         ALLOC( pulses, (L + SHELL_CODEC_FRAME_LENGTH - 1) &
Chris@69:                        ~(SHELL_CODEC_FRAME_LENGTH - 1), opus_int16 );
Chris@69:         /*********************************************/
Chris@69:         /* Decode quantization indices of side info  */
Chris@69:         /*********************************************/
Chris@69:         silk_decode_indices( psDec, psRangeDec, psDec->nFramesDecoded, lostFlag, condCoding );
Chris@69: 
Chris@69:         /*********************************************/
Chris@69:         /* Decode quantization indices of excitation */
Chris@69:         /*********************************************/
Chris@69:         silk_decode_pulses( psRangeDec, pulses, psDec->indices.signalType,
Chris@69:                 psDec->indices.quantOffsetType, psDec->frame_length );
Chris@69: 
Chris@69:         /********************************************/
Chris@69:         /* Decode parameters and pulse signal       */
Chris@69:         /********************************************/
Chris@69:         silk_decode_parameters( psDec, psDecCtrl, condCoding );
Chris@69: 
Chris@69:         /********************************************************/
Chris@69:         /* Run inverse NSQ                                      */
Chris@69:         /********************************************************/
Chris@69:         silk_decode_core( psDec, psDecCtrl, pOut, pulses, arch );
Chris@69: 
Chris@69:         /********************************************************/
Chris@69:         /* Update PLC state                                     */
Chris@69:         /********************************************************/
Chris@69:         silk_PLC( psDec, psDecCtrl, pOut, 0, arch );
Chris@69: 
Chris@69:         psDec->lossCnt = 0;
Chris@69:         psDec->prevSignalType = psDec->indices.signalType;
Chris@69:         celt_assert( psDec->prevSignalType >= 0 && psDec->prevSignalType <= 2 );
Chris@69: 
Chris@69:         /* A frame has been decoded without errors */
Chris@69:         psDec->first_frame_after_reset = 0;
Chris@69:     } else {
Chris@69:         /* Handle packet loss by extrapolation */
Chris@69:         psDec->indices.signalType = psDec->prevSignalType;
Chris@69:         silk_PLC( psDec, psDecCtrl, pOut, 1, arch );
Chris@69:     }
Chris@69: 
Chris@69:     /*************************/
Chris@69:     /* Update output buffer. */
Chris@69:     /*************************/
Chris@69:     celt_assert( psDec->ltp_mem_length >= psDec->frame_length );
Chris@69:     mv_len = psDec->ltp_mem_length - psDec->frame_length;
Chris@69:     silk_memmove( psDec->outBuf, &psDec->outBuf[ psDec->frame_length ], mv_len * sizeof(opus_int16) );
Chris@69:     silk_memcpy( &psDec->outBuf[ mv_len ], pOut, psDec->frame_length * sizeof( opus_int16 ) );
Chris@69: 
Chris@69:     /************************************************/
Chris@69:     /* Comfort noise generation / estimation        */
Chris@69:     /************************************************/
Chris@69:     silk_CNG( psDec, psDecCtrl, pOut, L );
Chris@69: 
Chris@69:     /****************************************************************/
Chris@69:     /* Ensure smooth connection of extrapolated and good frames     */
Chris@69:     /****************************************************************/
Chris@69:     silk_PLC_glue_frames( psDec, pOut, L );
Chris@69: 
Chris@69:     /* Update some decoder state variables */
Chris@69:     psDec->lagPrev = psDecCtrl->pitchL[ psDec->nb_subfr - 1 ];
Chris@69: 
Chris@69:     /* Set output frame length */
Chris@69:     *pN = L;
Chris@69: 
Chris@69:     RESTORE_STACK;
Chris@69:     return ret;
Chris@69: }