Line data    Source code

       1             : /******************************************************************************************************
       2             : 
       3             :    (C) 2022-2025 IVAS codec Public Collaboration with portions copyright Dolby International AB, Ericsson AB,
       4             :    Fraunhofer-Gesellschaft zur Foerderung der angewandten Forschung e.V., Huawei Technologies Co. LTD.,
       5             :    Koninklijke Philips N.V., Nippon Telegraph and Telephone Corporation, Nokia Technologies Oy, Orange,
       6             :    Panasonic Holdings Corporation, Qualcomm Technologies, Inc., VoiceAge Corporation, and other
       7             :    contributors to this repository. All Rights Reserved.
       8             : 
       9             :    This software is protected by copyright law and by international treaties.
      10             :    The IVAS codec Public Collaboration consisting of Dolby International AB, Ericsson AB,
      11             :    Fraunhofer-Gesellschaft zur Foerderung der angewandten Forschung e.V., Huawei Technologies Co. LTD.,
      12             :    Koninklijke Philips N.V., Nippon Telegraph and Telephone Corporation, Nokia Technologies Oy, Orange,
      13             :    Panasonic Holdings Corporation, Qualcomm Technologies, Inc., VoiceAge Corporation, and other
      14             :    contributors to this repository retain full ownership rights in their respective contributions in
      15             :    the software. This notice grants no license of any kind, including but not limited to patent
      16             :    license, nor is any license granted by implication, estoppel or otherwise.
      17             : 
      18             :    Contributors are required to enter into the IVAS codec Public Collaboration agreement before making
      19             :    contributions.
      20             : 
      21             :    This software is provided "AS IS", without any express or implied warranties. The software is in the
      22             :    development stage. It is intended exclusively for experts who have experience with such software and
      23             :    solely for the purpose of inspection. All implied warranties of non-infringement, merchantability
      24             :    and fitness for a particular purpose are hereby disclaimed and excluded.
      25             : 
      26             :    Any dispute, controversy or claim arising under or in relation to providing this software shall be
      27             :    submitted to and settled by the final, binding jurisdiction of the courts of Munich, Germany in
      28             :    accordance with the laws of the Federal Republic of Germany excluding its conflict of law rules and
      29             :    the United Nations Convention on Contracts on the International Sales of Goods.
      30             : 
      31             : *******************************************************************************************************/
      32             : 
      33             : /*====================================================================================
      34             :     EVS Codec 3GPP TS26.443 Nov 04, 2021. Version 12.14.0 / 13.10.0 / 14.6.0 / 15.4.0 / 16.3.0
      35             :   ====================================================================================*/
      36             : 
      37             : #include <stdint.h>
      38             : #include "options.h"
      39             : #ifdef DEBUGGING
      40             : #include "debug.h"
      41             : #endif
      42             : #include "prot.h"
      43             : #include "ivas_cnst.h"
      44             : #include "wmc_auto.h"
      45             : 
      46             : /*--------------------------------------------------------------------------
      47             :  *  get_delay()
      48             :  *
      49             :  *  Function returns various types of delays in the codec in ns.
      50             :  *--------------------------------------------------------------------------*/
      51             : 
      52             : /*! r: delay value in ns */
      53       19365 : int32_t get_delay(
      54             :     const int16_t enc_dec,                  /* i  : encoder/decoder flag                */
      55             :     const int32_t io_fs,                    /* i  : input/output sampling frequency     */
      56             :     const IVAS_FORMAT ivas_format,          /* i  : IVAS format                         */
      57             :     HANDLE_CLDFB_FILTER_BANK hCldfb,        /* i  : Handle of Cldfb analysis            */
      58             :     const int16_t flag_binaural_split_coded /* i  : split rendering on/off flag         */
      59             : )
      60             : {
      61       19365 :     int32_t delay = 0;
      62             : 
      63       19365 :     if ( enc_dec == ENC )
      64             :     {
      65         627 :         if ( ivas_format == MONO_FORMAT ) /* EVS mono */
      66             :         {
      67           3 :             delay = ( DELAY_FIR_RESAMPL_NS + ACELP_LOOK_NS );
      68             :         }
      69             :         else /* IVAS */
      70             :         {
      71         624 :             delay = IVAS_ENC_DELAY_NS;
      72             : 
      73         624 :             if ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT )
      74             :             {
      75         119 :                 delay = 0; /* All delay is compensated in the decoder with MASA */
      76             :             }
      77             :         }
      78         627 :         if ( ivas_format == SBA_FORMAT || ivas_format == SBA_ISM_FORMAT )
      79             :         {
      80             :             /* compensate for DirAC/SPAR filterbank delay */
      81         281 :             delay += IVAS_FB_ENC_DELAY_NS;
      82             :         }
      83             :     }
      84             :     else /* DEC */
      85             :     {
      86       18738 :         if ( ivas_format == MONO_FORMAT ) /* EVS mono */
      87             :         {
      88           9 :             if ( io_fs == 8000 )
      89             :             {
      90           0 :                 delay = DELAY_CLDFB_NS;
      91             :             }
      92             :             else
      93             :             {
      94           9 :                 delay = DELAY_BWE_TOTAL_NS;
      95             :             }
      96             :         }
      97             :         else /* IVAS */
      98             :         {
      99       18729 :             delay = IVAS_DEC_DELAY_NS;
     100             : 
     101       18729 :             if ( !flag_binaural_split_coded )
     102             :             {
     103       18729 :                 if ( hCldfb != NULL )
     104             :                 {
     105             :                     /* compensate for filterbank delay */
     106        1353 :                     delay += IVAS_FB_DEC_DELAY_NS;
     107             :                 }
     108             :             }
     109             : 
     110       18729 :             if ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT )
     111             :             {
     112       17214 :                 delay += IVAS_ENC_DELAY_NS; /* Compensate also the encoder delay in the decoder with MASA */
     113             :             }
     114             :         }
     115             :     }
     116             : 
     117       19365 :     return delay;
     118             : }