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             : #include <assert.h>
      34             : #include <stdint.h>
      35             : #include "options.h"
      36             : #ifdef DEBUGGING
      37             : #include "debug.h"
      38             : #endif
      39             : #include <math.h>
      40             : #include "prot.h"
      41             : #include "ivas_prot.h"
      42             : #include "wmc_auto.h"
      43             : 
      44             : 
      45             : /*---------------------------------------------------------------
      46             :  * ivas_mc_mode_select()
      47             :  *
      48             :  * selects the multichannel mode base on bitrate and LS setup
      49             :  * ---------------------------------------------------------------*/
      50             : 
      51             : /*! r : MC format mode */
      52     6169290 : MC_MODE ivas_mc_mode_select(
      53             :     const MC_LS_SETUP mc_ls_setup, /* i  : MC loudspeaker setup           */
      54             :     const int32_t total_brate      /* i  : IVAS total bitrate             */
      55             : )
      56             : {
      57     6169290 :     MC_MODE mc_mode = MC_MODE_MCT;
      58             : 
      59     6169290 :     switch ( mc_ls_setup )
      60             :     {
      61     3311659 :         case MC_LS_SETUP_5_1:
      62     3311659 :             if ( total_brate < IVAS_48k )
      63             :             {
      64      706871 :                 mc_mode = MC_MODE_MCMASA;
      65             :             }
      66     2604788 :             else if ( total_brate < IVAS_96k )
      67             :             {
      68      679779 :                 mc_mode = MC_MODE_PARAMMC;
      69             :             }
      70     3311659 :             break;
      71      368376 :         case MC_LS_SETUP_7_1:
      72      368376 :             if ( total_brate < IVAS_48k )
      73             :             {
      74       71741 :                 mc_mode = MC_MODE_MCMASA;
      75             :             }
      76      296635 :             else if ( total_brate < IVAS_128k )
      77             :             {
      78       95873 :                 mc_mode = MC_MODE_PARAMMC;
      79             :             }
      80      368376 :             break;
      81      475177 :         case MC_LS_SETUP_5_1_2:
      82      475177 :             if ( total_brate < IVAS_48k )
      83             :             {
      84      114978 :                 mc_mode = MC_MODE_MCMASA;
      85             :             }
      86      360199 :             else if ( total_brate < IVAS_128k )
      87             :             {
      88      190515 :                 mc_mode = MC_MODE_PARAMMC;
      89             :             }
      90      475177 :             break;
      91      476554 :         case MC_LS_SETUP_5_1_4:
      92      476554 :             if ( total_brate < IVAS_96k )
      93             :             {
      94      144254 :                 mc_mode = MC_MODE_MCMASA;
      95             :             }
      96      332300 :             else if ( total_brate < IVAS_160k )
      97             :             {
      98       26914 :                 mc_mode = MC_MODE_PARAMMC;
      99             :             }
     100      476554 :             break;
     101     1537524 :         case MC_LS_SETUP_7_1_4:
     102     1537524 :             if ( total_brate < IVAS_128k )
     103             :             {
     104      485201 :                 mc_mode = MC_MODE_MCMASA;
     105             :             }
     106     1052323 :             else if ( total_brate < IVAS_160k )
     107             :             {
     108       74151 :                 mc_mode = MC_MODE_PARAMMC;
     109             :             }
     110      978172 :             else if ( total_brate < IVAS_192k )
     111             :             {
     112      309018 :                 mc_mode = MC_MODE_PARAMUPMIX;
     113             :             }
     114     1537524 :             break;
     115           0 :         default:
     116           0 :             assert( 0 && "LS Setup not supported or defined for MC mode!\n" );
     117             :     }
     118             : 
     119     6169290 :     return mc_mode;
     120             : }
     121             : 
     122             : 
     123             : /*---------------------------------------------------------------
     124             :  * ivas_mc_setup_get_num_channels()
     125             :  *
     126             :  * returns the number of channels (including the LFE) for a MC LS setup
     127             :  * ---------------------------------------------------------------*/
     128             : 
     129             : /*! r : number of loudspeaker channels */
     130     1421561 : int16_t ivas_mc_ls_setup_get_num_channels(
     131             :     const MC_LS_SETUP mc_ls_setup /* i  : multi channel loudspeaker setup */
     132             : )
     133             : {
     134             :     int16_t nchan;
     135             : 
     136     1421561 :     nchan = 0;
     137             : 
     138     1421561 :     switch ( mc_ls_setup )
     139             :     {
     140      827175 :         case MC_LS_SETUP_5_1:
     141      827175 :             nchan = 6;
     142      827175 :             break;
     143       91486 :         case MC_LS_SETUP_7_1:
     144       91486 :             nchan = 8;
     145       91486 :             break;
     146       77722 :         case MC_LS_SETUP_5_1_2:
     147       77722 :             nchan = 8;
     148       77722 :             break;
     149      134779 :         case MC_LS_SETUP_5_1_4:
     150      134779 :             nchan = 10;
     151      134779 :             break;
     152      290399 :         case MC_LS_SETUP_7_1_4:
     153      290399 :             nchan = 12;
     154      290399 :             break;
     155           0 :         default:
     156           0 :             assert( 0 && "LS Setup not supported or defined for MC mode!\n" );
     157             :     }
     158             : 
     159     1421561 :     return nchan;
     160             : }
     161             : 
     162             : 
     163             : /*---------------------------------------------------------------
     164             :  * ivas_mc_map_output_config_to_mc_ls_setup()
     165             :  *
     166             :  * maps output configuration multi channel loudspeaker setup
     167             :  * ---------------------------------------------------------------*/
     168             : 
     169             : /*! r : multi channel loudspeaker setup */
     170     7415542 : MC_LS_SETUP ivas_mc_map_output_config_to_mc_ls_setup(
     171             :     const AUDIO_CONFIG output_config /* i  : output audio configuration */
     172             : )
     173             : {
     174             :     MC_LS_SETUP mc_ls_setup;
     175             : 
     176     7415542 :     mc_ls_setup = MC_LS_SETUP_INVALID;
     177             : 
     178     7415542 :     switch ( output_config )
     179             :     {
     180     3968037 :         case IVAS_AUDIO_CONFIG_5_1:
     181     3968037 :             mc_ls_setup = MC_LS_SETUP_5_1;
     182     3968037 :             break;
     183      455407 :         case IVAS_AUDIO_CONFIG_7_1:
     184      455407 :             mc_ls_setup = MC_LS_SETUP_7_1;
     185      455407 :             break;
     186      550750 :         case IVAS_AUDIO_CONFIG_5_1_2:
     187      550750 :             mc_ls_setup = MC_LS_SETUP_5_1_2;
     188      550750 :             break;
     189      622460 :         case IVAS_AUDIO_CONFIG_5_1_4:
     190      622460 :             mc_ls_setup = MC_LS_SETUP_5_1_4;
     191      622460 :             break;
     192     1818888 :         case IVAS_AUDIO_CONFIG_7_1_4:
     193     1818888 :             mc_ls_setup = MC_LS_SETUP_7_1_4;
     194     1818888 :             break;
     195           0 :         default:
     196           0 :             assert( 0 && "Output config is not a valid MC loudspeaker setup!\n" );
     197             :     }
     198             : 
     199     7415542 :     return mc_ls_setup;
     200             : }
     201             : 
     202             : 
     203             : /*---------------------------------------------------------------
     204             :  * ivas_mc_map_ls_setup_to_output_config
     205             :  *
     206             :  * maps multi channel loudspeaker setup to audio configuration
     207             :  * ---------------------------------------------------------------*/
     208             : 
     209             : /*! r: audio configuration*/
     210     5220090 : AUDIO_CONFIG ivas_mc_map_ls_setup_to_output_config(
     211             :     const MC_LS_SETUP mc_ls_setup /* i  : multi channel loudspeaker setup*/
     212             : )
     213             : {
     214             :     AUDIO_CONFIG audio_config;
     215     5220090 :     audio_config = IVAS_AUDIO_CONFIG_INVALID;
     216             : 
     217     5220090 :     switch ( mc_ls_setup )
     218             :     {
     219     2785058 :         case MC_LS_SETUP_5_1:
     220     2785058 :             audio_config = IVAS_AUDIO_CONFIG_5_1;
     221     2785058 :             break;
     222      317038 :         case MC_LS_SETUP_7_1:
     223      317038 :             audio_config = IVAS_AUDIO_CONFIG_7_1;
     224      317038 :             break;
     225      412582 :         case MC_LS_SETUP_5_1_2:
     226      412582 :             audio_config = IVAS_AUDIO_CONFIG_5_1_2;
     227      412582 :             break;
     228      418264 :         case MC_LS_SETUP_5_1_4:
     229      418264 :             audio_config = IVAS_AUDIO_CONFIG_5_1_4;
     230      418264 :             break;
     231     1287148 :         case MC_LS_SETUP_7_1_4:
     232     1287148 :             audio_config = IVAS_AUDIO_CONFIG_7_1_4;
     233     1287148 :             break;
     234           0 :         default:
     235           0 :             assert( 0 && "MC loudspeaker setup is not valid!\n" );
     236             :     }
     237             : 
     238     5220090 :     return audio_config;
     239             : }