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 <stdint.h>
34 : #include <math.h>
35 : #include "options.h"
36 : #include "ivas_cnst.h"
37 : #include "ivas_prot.h"
38 : #include "ivas_rom_com.h"
39 : #include "ivas_stat_enc.h"
40 : #include "wmc_auto.h"
41 : #include "prot.h"
42 :
43 :
44 : /*-----------------------------------------------------------------------*
45 : * Local function prototypes
46 : *-----------------------------------------------------------------------*/
47 :
48 : static void combine_freqbands_and_subframes( MASA_ENCODER_HANDLE hMasa );
49 :
50 : static void find_n_largest( const float *input, int16_t *largestIndices, const int16_t numElements, const int16_t numLargest );
51 :
52 : static void move_metadata_to_qmetadata( const MASA_ENCODER_HANDLE hMasa, IVAS_QMETADATA_HANDLE hQMeta );
53 :
54 : static void detect_metadata_composition( const MASA_ENCODER_HANDLE hMasa, uint8_t *joinedSubframes, uint8_t *coherencePresent, uint8_t *isTwoDir );
55 :
56 : static void compensate_energy_ratios( MASA_ENCODER_HANDLE hMasa );
57 :
58 : static int16_t encode_lfe_to_total_energy_ratio( MASA_ENCODER_HANDLE hMasa, BSTR_ENC_HANDLE hMetaData, const int32_t ivas_total_brate );
59 :
60 : static void ivas_encode_masaism_metadata( MASA_ENCODER_HANDLE hMasa, IVAS_QMETADATA_HANDLE hQMetaData, BSTR_ENC_HANDLE hMetaData, ISM_METADATA_HANDLE hIsmMeta[], const int16_t nchan_ism, const int16_t low_bitrate_mode, const int16_t omasa_nbands, const int16_t omasa_nblocks, const int16_t idx_separated_object, const int16_t ism_imp );
61 :
62 : static void reduce_metadata_further( MASA_ENCODER_HANDLE hMasa, IVAS_QMETADATA_HANDLE hqmetadata, const IVAS_FORMAT ivas_format );
63 :
64 : static void average_masa_metadata( MASA_METADATA_FRAME *masaMetadata, float energy[MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS], const SPHERICAL_GRID_DATA *sphGrid, const uint8_t useSphGrid );
65 :
66 : static void copy_masa_metadata_subframe( const MASA_METADATA_HANDLE hMetaFrom, const uint8_t sfFrom, MASA_METADATA_HANDLE hMetaTo, const uint8_t sfTo );
67 :
68 : static void copy_masa_metadata( const MASA_METADATA_HANDLE hMetaFrom, MASA_METADATA_HANDLE hMetaTo );
69 :
70 : static uint8_t are_masa_subframes_similar( const MASA_METADATA_HANDLE frame1, const uint8_t sf1_idx, const MASA_METADATA_HANDLE frame2, const uint8_t sf2_idx );
71 :
72 : static void detect_framing_async( MASA_ENCODER_HANDLE hMasa );
73 :
74 : static void masa_metadata_direction_alignment( MASA_ENCODER_HANDLE hMasa );
75 :
76 :
77 : /*-----------------------------------------------------------------------*
78 : * Local constants
79 : *-----------------------------------------------------------------------*/
80 :
81 : #define LOWBITRATE_ONSET_ALPHA 0.2f /* Onset values are for processing in frames */
82 : #define LOWBITRATE_ONSET_BETA 0.92f
83 : #define LOWBITRATE_ONSET_GAIN 1.4f
84 : #define LOWBITRATE_NUM_BANDS 5
85 :
86 :
87 : /*-----------------------------------------------------------------------*
88 : * ivas_masa_enc_open()
89 : *
90 : * open and initialize MASA encoder
91 : *-----------------------------------------------------------------------*/
92 :
93 1912 : ivas_error ivas_masa_enc_open(
94 : Encoder_Struct *st_ivas /* i/o: IVAS encoder handle */
95 : )
96 : {
97 : int16_t i;
98 : MASA_ENCODER_HANDLE hMasa;
99 : ENCODER_CONFIG_HANDLE hEncoderConfig;
100 : ivas_error error;
101 : int32_t ism_total_brate;
102 :
103 1912 : error = IVAS_ERR_OK;
104 :
105 1912 : if ( ( hMasa = (MASA_ENCODER_HANDLE) malloc( sizeof( MASA_ENCODER ) ) ) == NULL )
106 : {
107 0 : return ( IVAS_ERROR( IVAS_ERR_FAILED_ALLOC, "Can not allocate memory for MASA encoder\n" ) );
108 : }
109 :
110 1912 : hEncoderConfig = st_ivas->hEncoderConfig;
111 :
112 1912 : generate_gridEq( &( hMasa->data.Sph_Grid16 ) );
113 :
114 1912 : if ( hEncoderConfig->ivas_format == MASA_FORMAT || hEncoderConfig->ivas_format == MASA_ISM_FORMAT )
115 : {
116 1449 : hMasa->data.num_Cldfb_instances = st_ivas->nchan_transport;
117 : }
118 : else
119 : {
120 463 : hMasa->data.num_Cldfb_instances = 0;
121 : }
122 :
123 4562 : for ( i = 0; i < hMasa->data.num_Cldfb_instances; i++ )
124 : {
125 2650 : if ( ( error = openCldfb( &( hMasa->data.cldfbAnaEnc[i] ), CLDFB_ANALYSIS, hEncoderConfig->input_Fs, CLDFB_PROTOTYPE_5_00MS ) ) != IVAS_ERR_OK )
126 : {
127 0 : return error;
128 : }
129 : }
130 :
131 1912 : ism_total_brate = 0;
132 1912 : if ( hEncoderConfig->ivas_format == MASA_ISM_FORMAT && st_ivas->nSCE > 0 && ( st_ivas->ism_mode == ISM_MASA_MODE_DISC || st_ivas->ism_mode == ISM_MASA_MODE_PARAM_ONE_OBJ || st_ivas->ism_mode == ISM_MASA_MODE_MASA_ONE_OBJ ) )
133 : {
134 1867 : for ( i = 0; i < st_ivas->nSCE; i++ )
135 : {
136 1166 : ism_total_brate += st_ivas->hSCE[i]->element_brate;
137 : }
138 : }
139 :
140 1912 : ivas_masa_set_elements( st_ivas->hEncoderConfig->ivas_total_brate, st_ivas->mc_mode, st_ivas->nchan_transport, st_ivas->hQMetaData, &hEncoderConfig->element_mode_init, &st_ivas->nSCE, &st_ivas->nCPE, hEncoderConfig->ivas_format, st_ivas->ism_mode, ism_total_brate );
141 :
142 1912 : mvs2s( DirAC_block_grouping, hMasa->config.block_grouping, MAX_PARAM_SPATIAL_SUBFRAMES + 1 );
143 1912 : mvs2s( MASA_band_grouping_24, hMasa->config.band_grouping, MASA_FREQUENCY_BANDS + 1 );
144 :
145 :
146 1912 : hMasa->data.onset_detector_1 = 0.0f;
147 1912 : hMasa->data.onset_detector_2 = 0.0f;
148 :
149 1912 : set_zero( hMasa->data.lfeToTotalEnergyRatio, MAX_PARAM_SPATIAL_SUBFRAMES );
150 1912 : hMasa->data.prevq_lfeToTotalEnergyRatio = 0.0f;
151 1912 : hMasa->data.prevq_lfeIndex = 0;
152 :
153 1912 : hMasa->data.sync_state.prev_sim_stop = 0;
154 1912 : hMasa->data.sync_state.prev_offset = 0;
155 1912 : hMasa->data.sync_state.frame_mode = MASA_FRAME_4SF;
156 :
157 1912 : set_zero( hMasa->data.dir_align_state.previous_azi_dir1, MASA_FREQUENCY_BANDS );
158 1912 : set_zero( hMasa->data.dir_align_state.previous_ele_dir1, MASA_FREQUENCY_BANDS );
159 1912 : set_zero( hMasa->data.dir_align_state.previous_azi_dir2, MASA_FREQUENCY_BANDS );
160 1912 : set_zero( hMasa->data.dir_align_state.previous_ele_dir2, MASA_FREQUENCY_BANDS );
161 :
162 1912 : if ( hEncoderConfig->ivas_format == MASA_ISM_FORMAT )
163 : {
164 : OMASA_ENCODER_DATA_HANDLE hOmasaData;
165 :
166 935 : if ( ( hOmasaData = (OMASA_ENCODER_DATA_HANDLE) malloc( sizeof( OMASA_ENCODER_DATA_STATE ) ) ) == NULL )
167 : {
168 0 : return ( IVAS_ERROR( IVAS_ERR_FAILED_ALLOC, "Can not allocate memory for OMASA data encoder\n" ) );
169 : }
170 4675 : for ( i = 0; i < MAX_PARAM_SPATIAL_SUBFRAMES; i++ )
171 : {
172 3740 : set_f( hOmasaData->masa_to_total_energy_ratio[i], 0, MASA_FREQUENCY_BANDS );
173 : }
174 935 : hOmasaData->lp_noise_CPE = -1;
175 935 : hOmasaData->omasa_stereo_sw_cnt = OMASA_STEREO_SW_CNT_MAX;
176 :
177 935 : if ( st_ivas->ism_mode != ISM_MASA_MODE_DISC )
178 : {
179 453 : if ( ( hOmasaData->hOmasaEnergy = (OMASA_ENCODER_ENERGY_HANDLE) malloc( sizeof( OMASA_ENCODER_ENERGY_STATE ) ) ) == NULL )
180 : {
181 0 : return ( IVAS_ERROR( IVAS_ERR_FAILED_ALLOC, "Can not allocate memory for OMASA energy handle\n" ) );
182 : }
183 : }
184 : else
185 : {
186 482 : hOmasaData->hOmasaEnergy = NULL;
187 : }
188 :
189 935 : hMasa->data.hOmasaData = hOmasaData;
190 : }
191 : else
192 : {
193 977 : hMasa->data.hOmasaData = NULL;
194 : }
195 :
196 1912 : st_ivas->hMasa = hMasa;
197 :
198 1912 : return error;
199 : }
200 :
201 :
202 : /*-----------------------------------------------------------------------*
203 : * ivas_masa_enc_close()
204 : *
205 : * close MASA encoder
206 : *-----------------------------------------------------------------------*/
207 :
208 6352 : void ivas_masa_enc_close(
209 : MASA_ENCODER_HANDLE *hMasa /* i/o: MASA metadata structure */
210 : )
211 : {
212 : int16_t i;
213 :
214 6352 : if ( hMasa == NULL || *hMasa == NULL )
215 : {
216 4440 : return;
217 : }
218 :
219 4562 : for ( i = 0; i < ( *hMasa )->data.num_Cldfb_instances; i++ )
220 : {
221 2650 : deleteCldfb( &( ( *hMasa )->data.cldfbAnaEnc[i] ) );
222 : }
223 :
224 1912 : if ( ( *hMasa )->data.hOmasaData != NULL )
225 : {
226 935 : if ( ( *hMasa )->data.hOmasaData->hOmasaEnergy != NULL )
227 : {
228 451 : free( ( *hMasa )->data.hOmasaData->hOmasaEnergy );
229 451 : ( *hMasa )->data.hOmasaData->hOmasaEnergy = NULL;
230 : }
231 :
232 935 : free( ( *hMasa )->data.hOmasaData );
233 935 : ( *hMasa )->data.hOmasaData = NULL;
234 : }
235 :
236 1912 : free( ( *hMasa ) );
237 1912 : ( *hMasa ) = NULL;
238 :
239 1912 : return;
240 : }
241 :
242 :
243 : /*-----------------------------------------------------------------------*
244 : * ivas_masa_encode()
245 : *
246 : * main MASA encoder function
247 : *-----------------------------------------------------------------------*/
248 :
249 172476 : ivas_error ivas_masa_encode(
250 : MASA_ENCODER_HANDLE hMasa, /* i/o: MASA encoder structure */
251 : IVAS_QMETADATA_HANDLE hQMetaData, /* i/o: q_metadata handle */
252 : BSTR_ENC_HANDLE hMetaData, /* i/o: Metadata bitstream handle */
253 : int16_t *nb_bits_metadata, /* o : number of metadata bits written */
254 : const int16_t nchan_transport, /* i : number of MASA input/transport channels */
255 : const IVAS_FORMAT ivas_format, /* i : IVAS format */
256 : const int32_t ivas_total_brate, /* i : IVAS total bitrate */
257 : const int16_t Opt_DTX_ON, /* i : DTX on flag */
258 : const int16_t element_mode, /* i : element mode */
259 : const ISM_MODE ism_mode, /* i : ISM format mode */
260 : const int16_t nchan_ism, /* i : number of ISM channels */
261 : ISM_METADATA_HANDLE hIsmMetaData[MAX_NUM_OBJECTS], /* i : ISM metadata handle */
262 : const int16_t idx_separated_object, /* i : index of the separated object */
263 : OMASA_ENC_HANDLE hOMasa, /* i : OMASA encoder handle */
264 : const int16_t ism_imp, /* i : importance of separated object */
265 : const int16_t flag_omasa_ener_brate /* i : less bitrate for objects in OMASA flag */
266 : )
267 : {
268 : MASA_DIRECTIONAL_SPATIAL_META *h_orig_metadata;
269 : int16_t i, j;
270 : int16_t masa_sid_descriptor;
271 : int16_t low_bitrate_mode;
272 : int32_t masa_total_brate;
273 : ivas_error error;
274 :
275 172476 : masa_sid_descriptor = -1;
276 172476 : h_orig_metadata = NULL;
277 172476 : low_bitrate_mode = 0;
278 :
279 172476 : if ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT )
280 : {
281 : /* Create the MASA SID descriptor for the metadata and CPE mode, in order to have the SID frame self-contained. */
282 154346 : if ( Opt_DTX_ON && hQMetaData != NULL )
283 : {
284 11978 : if ( nchan_transport == 2 ) /* this is MASA format in CPE only */
285 : {
286 6266 : masa_sid_descriptor = 0; /* for IVAS_CPE_DFT */
287 6266 : if ( element_mode == IVAS_CPE_MDCT )
288 : {
289 3388 : masa_sid_descriptor = 1;
290 : }
291 : }
292 : }
293 :
294 : /* Validate and compensate ratios as necessary */
295 154346 : compensate_energy_ratios( hMasa );
296 :
297 154346 : if ( Opt_DTX_ON )
298 : {
299 11978 : if ( ( h_orig_metadata = (MASA_DIRECTIONAL_SPATIAL_META *) malloc( MASA_MAXIMUM_DIRECTIONS * sizeof( MASA_DIRECTIONAL_SPATIAL_META ) ) ) == NULL )
300 : {
301 0 : return ( IVAS_ERROR( IVAS_ERR_FAILED_ALLOC, "Can not allocate memory for MASA encoder\n" ) );
302 : }
303 :
304 35934 : for ( i = 0; i < MASA_MAXIMUM_DIRECTIONS; i++ )
305 : {
306 119780 : for ( j = 0; j < MAX_PARAM_SPATIAL_SUBFRAMES; j++ )
307 : {
308 95824 : mvr2r( hMasa->masaMetadata.directional_meta[i].azimuth[j], h_orig_metadata[i].azimuth[j], MASA_FREQUENCY_BANDS );
309 95824 : mvr2r( hMasa->masaMetadata.directional_meta[i].elevation[j], h_orig_metadata[i].elevation[j], MASA_FREQUENCY_BANDS );
310 95824 : mvr2r( hMasa->masaMetadata.directional_meta[i].energy_ratio[j], h_orig_metadata[i].energy_ratio[j], MASA_FREQUENCY_BANDS );
311 95824 : mvs2s( (int16_t *) ( hMasa->masaMetadata.directional_meta[i].spherical_index[j] ), (int16_t *) ( h_orig_metadata[i].spherical_index[j] ), MASA_FREQUENCY_BANDS );
312 : }
313 : }
314 : }
315 :
316 154346 : if ( ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT ) && ivas_total_brate >= IVAS_384k )
317 : {
318 21626 : hMasa->config.mergeRatiosOverSubframes = 0;
319 : }
320 :
321 : /* Combine frequency bands and sub-frames */
322 154346 : combine_freqbands_and_subframes( hMasa );
323 : }
324 :
325 172476 : if ( hMasa->config.numberOfDirections == 2 && hMasa->config.numTwoDirBands < hMasa->config.numCodingBands && ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT ) )
326 : {
327 56180 : if ( ( ivas_format == MASA_ISM_FORMAT && ism_mode != ISM_MODE_NONE && ism_mode != ISM_MASA_MODE_MASA_ONE_OBJ ) || ( ivas_format != MASA_ISM_FORMAT ) )
328 : {
329 : /* Combine directions */
330 39628 : ivas_masa_combine_directions( hMasa );
331 : }
332 :
333 : /* If we joined all bands, then metadata is now one directional. */
334 56180 : if ( hMasa->config.numTwoDirBands == 0 )
335 : {
336 26852 : hMasa->config.numberOfDirections = 1;
337 26852 : hMasa->masaMetadata.descriptive_meta.numberOfDirections = 0;
338 26852 : hQMetaData->no_directions = 1;
339 : }
340 : }
341 :
342 : /* Reset qmetadata bit budget */
343 172476 : hQMetaData->metadata_max_bits = hMasa->config.max_metadata_bits;
344 172476 : if ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT )
345 : {
346 154346 : if ( ivas_format == MASA_ISM_FORMAT && ism_mode != ISM_MODE_NONE )
347 : {
348 : /* write the number of objects in ISM_MASA format*/
349 64200 : push_next_indice( hMetaData, nchan_ism - 1, NO_BITS_MASA_ISM_NO_OBJ );
350 64200 : hQMetaData->metadata_max_bits -= NO_BITS_MASA_ISM_NO_OBJ;
351 :
352 : /* write index of separated object if needed */
353 64200 : if ( ism_mode == ISM_MASA_MODE_PARAM_ONE_OBJ && nchan_ism > 1 )
354 : {
355 11288 : push_next_indice( hMetaData, idx_separated_object, NO_BITS_MASA_ISM_NO_OBJ );
356 11288 : hQMetaData->metadata_max_bits -= NO_BITS_MASA_ISM_NO_OBJ;
357 : }
358 :
359 : /* write ISM importance flag (one per object) */
360 64200 : if ( ism_mode == ISM_MASA_MODE_PARAM_ONE_OBJ )
361 : {
362 11288 : push_next_indice( hMetaData, hIsmMetaData[0]->ism_imp, ISM_METADATA_FLAG_BITS );
363 11288 : hQMetaData->metadata_max_bits -= ISM_METADATA_FLAG_BITS;
364 : }
365 52912 : else if ( ism_mode == ISM_MASA_MODE_MASA_ONE_OBJ )
366 : {
367 10430 : if ( hIsmMetaData[0]->ism_md_null_flag )
368 : {
369 : /* signal NULL metadata frame */
370 0 : push_next_indice( hMetaData, 1, ISM_METADATA_MD_FLAG_BITS );
371 0 : hQMetaData->metadata_max_bits -= ISM_METADATA_MD_FLAG_BITS;
372 :
373 : /* write the ISM class to ISM_NO_META and again the true ISM class */
374 0 : push_next_indice( hMetaData, ISM_NO_META, ISM_METADATA_FLAG_BITS );
375 0 : hQMetaData->metadata_max_bits -= ISM_METADATA_FLAG_BITS;
376 0 : push_next_indice( hMetaData, hIsmMetaData[0]->ism_imp, ISM_METADATA_FLAG_BITS );
377 0 : hQMetaData->metadata_max_bits -= ISM_METADATA_FLAG_BITS;
378 : }
379 : else
380 : {
381 10430 : push_next_indice( hMetaData, hIsmMetaData[0]->ism_imp, ISM_METADATA_FLAG_BITS );
382 10430 : hQMetaData->metadata_max_bits -= ISM_METADATA_FLAG_BITS;
383 :
384 10430 : if ( hIsmMetaData[0]->ism_imp == ISM_NO_META )
385 : {
386 : /* signal low-rate ISM_NO_META frame */
387 0 : push_next_indice( hMetaData, 0, ISM_METADATA_MD_FLAG_BITS );
388 0 : hQMetaData->metadata_max_bits -= ISM_METADATA_MD_FLAG_BITS;
389 :
390 : /* signal presence of MD in low-rate ISM_NO_META frame */
391 0 : push_next_indice( hMetaData, hIsmMetaData[0]->ism_md_lowrate_flag, ISM_METADATA_INACTIVE_FLAG_BITS );
392 0 : hQMetaData->metadata_max_bits -= ISM_METADATA_INACTIVE_FLAG_BITS;
393 : }
394 : }
395 : }
396 42482 : else if ( ism_mode == ISM_MASA_MODE_DISC )
397 : {
398 125072 : for ( i = 0; i < nchan_ism; i++ )
399 : {
400 82590 : if ( hIsmMetaData[i]->ism_md_null_flag )
401 : {
402 : /* signal NULL metadata frame */
403 0 : push_next_indice( hMetaData, 1, ISM_METADATA_MD_FLAG_BITS );
404 0 : hQMetaData->metadata_max_bits -= ISM_METADATA_MD_FLAG_BITS;
405 :
406 : /* write the ISM class to ISM_NO_META and again the true ISM class */
407 0 : push_next_indice( hMetaData, ISM_NO_META, ISM_METADATA_FLAG_BITS );
408 0 : hQMetaData->metadata_max_bits -= ISM_METADATA_FLAG_BITS;
409 0 : push_next_indice( hMetaData, hIsmMetaData[i]->ism_imp, ISM_METADATA_FLAG_BITS );
410 0 : hQMetaData->metadata_max_bits -= ISM_METADATA_FLAG_BITS;
411 : }
412 : else
413 : {
414 82590 : push_next_indice( hMetaData, hIsmMetaData[i]->ism_imp, ISM_METADATA_FLAG_BITS );
415 82590 : hQMetaData->metadata_max_bits -= ISM_METADATA_FLAG_BITS;
416 :
417 82590 : if ( hIsmMetaData[i]->ism_imp == ISM_NO_META )
418 : {
419 : /* signal low-rate ISM_NO_META frame */
420 0 : push_next_indice( hMetaData, 0, ISM_METADATA_MD_FLAG_BITS );
421 0 : hQMetaData->metadata_max_bits -= ISM_METADATA_MD_FLAG_BITS;
422 :
423 : /* signal presence of MD in low-rate ISM_NO_META frame */
424 0 : push_next_indice( hMetaData, hIsmMetaData[i]->ism_md_lowrate_flag, ISM_METADATA_INACTIVE_FLAG_BITS );
425 0 : hQMetaData->metadata_max_bits -= ISM_METADATA_INACTIVE_FLAG_BITS;
426 : }
427 : }
428 : }
429 :
430 42482 : if ( ivas_total_brate == IVAS_128k && nchan_ism >= 3 )
431 : {
432 732 : push_next_indice( hMetaData, flag_omasa_ener_brate, 1 );
433 732 : hQMetaData->metadata_max_bits -= 1;
434 : }
435 : }
436 : }
437 : else
438 : {
439 90146 : if ( ivas_format == MASA_ISM_FORMAT && ism_mode == ISM_MODE_NONE )
440 : {
441 : /* use the MASA number of transport channels bit to signal if there are 1 or 2 objects */
442 20190 : if ( nchan_ism == 1 || nchan_ism == 2 )
443 : {
444 9504 : push_next_indice( hMetaData, nchan_ism - 1, MASA_TRANSP_BITS );
445 : }
446 : else
447 : {
448 : /* for 3 or 4 objects write already the number of MASA directions */
449 10686 : push_next_indice( hMetaData, hQMetaData->no_directions - 1, MASA_TRANSP_BITS );
450 : }
451 : }
452 : else
453 : {
454 : /* write the number of MASA transport channels */
455 69956 : push_next_indice( hMetaData, nchan_transport - 1, MASA_TRANSP_BITS );
456 : }
457 90146 : hQMetaData->metadata_max_bits -= MASA_TRANSP_BITS;
458 : }
459 :
460 154346 : if ( ivas_format == MASA_ISM_FORMAT && ism_mode == ISM_MODE_NONE )
461 : {
462 20190 : if ( nchan_ism >= 3 ) /* if 3 or 4 objects */
463 : {
464 10686 : push_next_indice( hMetaData, 5 - nchan_ism, MASA_HEADER_BITS );
465 : }
466 : else
467 : {
468 9504 : push_next_indice( hMetaData, 3, MASA_HEADER_BITS );
469 : }
470 20190 : hQMetaData->metadata_max_bits -= MASA_HEADER_BITS;
471 : }
472 : else
473 : {
474 : /* the MASA_ISM_FORMAT is not signalled here */
475 : /* write reserved bits */
476 134156 : push_next_indice( hMetaData, 0, MASA_HEADER_BITS );
477 134156 : hQMetaData->metadata_max_bits -= MASA_HEADER_BITS;
478 : }
479 154346 : if ( !( ivas_format == MASA_ISM_FORMAT && ism_mode == ISM_MODE_NONE && nchan_ism > 2 ) )
480 : {
481 : /* write number of directions */
482 143660 : push_next_indice( hMetaData, hQMetaData->no_directions - 1, 1 );
483 143660 : hQMetaData->metadata_max_bits -= 1;
484 : }
485 : /* write subframe mode */
486 154346 : push_next_indice( hMetaData, hQMetaData->q_direction[0].cfg.nblocks == 1 ? 1 : 0, MASA_SUBFRAME_BITS );
487 154346 : hQMetaData->metadata_max_bits -= MASA_SUBFRAME_BITS;
488 : }
489 :
490 172476 : if ( ivas_format == MC_FORMAT )
491 : {
492 : int16_t lfeBitsWritten;
493 18130 : lfeBitsWritten = encode_lfe_to_total_energy_ratio( hMasa, hMetaData, ivas_total_brate );
494 18130 : hQMetaData->metadata_max_bits -= lfeBitsWritten;
495 : }
496 :
497 : /* Move data from encoder to qmetadata */
498 172476 : if ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT )
499 : {
500 154346 : move_metadata_to_qmetadata( hMasa, hQMetaData );
501 : }
502 :
503 172476 : if ( hMasa->config.max_metadata_bits < MINIMUM_BIT_BUDGET_NORMAL_META && !hMasa->config.joinedSubframes )
504 : {
505 82051 : reduce_metadata_further( hMasa, hQMetaData, ivas_format );
506 :
507 82051 : low_bitrate_mode = ( ivas_total_brate <= 32000 );
508 :
509 : /* Write low bitrate mode. 1 signals that we have merged through time, 0 signals merge through frequency. */
510 82051 : push_next_indice( hMetaData, hQMetaData->q_direction[0].cfg.nblocks == 1 ? 1 : 0, MASA_LOWBITRATE_MODE_BITS );
511 82051 : hQMetaData->metadata_max_bits -= MASA_LOWBITRATE_MODE_BITS;
512 : }
513 :
514 : /* Encode MASA+ISM metadata */
515 172476 : if ( ivas_format == MASA_ISM_FORMAT && ism_mode == ISM_MASA_MODE_PARAM_ONE_OBJ )
516 : {
517 : /* encode MASA/ISM energy ratios */
518 11288 : ivas_encode_masaism_metadata( hMasa, hQMetaData, hMetaData, hIsmMetaData, nchan_ism, low_bitrate_mode, hOMasa->nCodingBands, hOMasa->nSubframes, idx_separated_object, ism_imp );
519 : }
520 : else
521 : {
522 161188 : if ( ivas_format == MASA_ISM_FORMAT )
523 : {
524 73102 : hMasa->data.hOmasaData->masa_to_total_energy_ratio[0][0] = -1; /* signals NOT to adjust the energy ratios */
525 : }
526 : }
527 :
528 : /* Encode metadata */
529 172476 : masa_total_brate = ivas_total_brate;
530 172476 : if ( ivas_format == MASA_ISM_FORMAT && ism_mode == ISM_MASA_MODE_DISC )
531 : {
532 42482 : masa_total_brate = calculate_cpe_brate_MASA_ISM( ism_mode, ivas_total_brate, nchan_ism );
533 : }
534 :
535 172476 : if ( masa_total_brate >= IVAS_384k )
536 : {
537 4216 : if ( masa_total_brate >= IVAS_512k )
538 : {
539 1480 : if ( ( error = ivas_qmetadata_enc_encode_hr_384_512( hMetaData, hQMetaData, 16, 4 ) ) != IVAS_ERR_OK )
540 : {
541 0 : return error;
542 : }
543 : }
544 : else
545 : {
546 2736 : if ( ( error = ivas_qmetadata_enc_encode_hr_384_512( hMetaData, hQMetaData, 11, 3 ) ) != IVAS_ERR_OK )
547 : {
548 0 : return error;
549 : }
550 : }
551 : }
552 : else
553 : {
554 168260 : if ( ( error = ivas_qmetadata_enc_encode( hMetaData, hQMetaData, 0 ) ) != IVAS_ERR_OK )
555 : {
556 0 : return error;
557 : }
558 : }
559 :
560 172476 : if ( ivas_format == MASA_ISM_FORMAT && ism_mode == ISM_MASA_MODE_PARAM_ONE_OBJ )
561 : {
562 : /* Modify spatial metadata based on the MASA-to-total energy ratios */
563 11288 : ivas_omasa_modify_masa_energy_ratios( hQMetaData, hMasa->data.hOmasaData->masa_to_total_energy_ratio );
564 : }
565 :
566 172476 : *nb_bits_metadata = hMetaData->nb_bits_tot;
567 :
568 172476 : if ( ivas_format == MASA_FORMAT && Opt_DTX_ON )
569 : {
570 : /* save old values */
571 11978 : uint8_t numCodingBands = hMasa->config.numCodingBands;
572 11978 : uint8_t numTwoDirBands = hMasa->config.numTwoDirBands;
573 11978 : int16_t nbands = hQMetaData->q_direction[0].cfg.nbands;
574 11978 : uint8_t numberOfDirections = hMasa->config.numberOfDirections;
575 11978 : uint8_t numberOfDirectionsMeta = hMasa->masaMetadata.descriptive_meta.numberOfDirections;
576 11978 : uint16_t numberOfDirectionsQMetaData = hQMetaData->no_directions;
577 :
578 11978 : if ( !( hMasa->config.numberOfDirections == 1 && hQMetaData->q_direction->cfg.nbands == 5 ) )
579 : {
580 12861 : for ( i = 0; i < MASA_MAXIMUM_DIRECTIONS; i++ )
581 : {
582 42870 : for ( j = 0; j < MAX_PARAM_SPATIAL_SUBFRAMES; j++ )
583 : {
584 34296 : mvr2r( h_orig_metadata[i].azimuth[j], hMasa->masaMetadata.directional_meta[i].azimuth[j], MASA_FREQUENCY_BANDS );
585 34296 : mvr2r( h_orig_metadata[i].elevation[j], hMasa->masaMetadata.directional_meta[i].elevation[j], MASA_FREQUENCY_BANDS );
586 34296 : mvr2r( h_orig_metadata[i].energy_ratio[j], hMasa->masaMetadata.directional_meta[i].energy_ratio[j], MASA_FREQUENCY_BANDS );
587 : }
588 : }
589 :
590 : /* Force to have 5 bands and 1 direction */
591 4287 : hMasa->config.numCodingBands = 5;
592 4287 : hMasa->config.numTwoDirBands = 0;
593 4287 : combine_freqbands_and_subframes( hMasa );
594 4287 : hQMetaData->q_direction[0].cfg.nbands = 5;
595 :
596 4287 : if ( hMasa->config.numberOfDirections == 2 && hMasa->config.numTwoDirBands < hMasa->config.numCodingBands )
597 : {
598 : /* Combine directions */
599 680 : ivas_masa_combine_directions( hMasa );
600 :
601 : /* If we joined all bands, then metadata is now one directional. */
602 680 : if ( hMasa->config.numTwoDirBands == 0 )
603 : {
604 680 : hMasa->config.numberOfDirections = 1;
605 680 : hMasa->masaMetadata.descriptive_meta.numberOfDirections = 0;
606 680 : hQMetaData->no_directions = 1;
607 : }
608 : }
609 :
610 4287 : move_metadata_to_qmetadata( hMasa, hQMetaData );
611 :
612 25722 : for ( j = hQMetaData->q_direction[0].cfg.start_band; j < hQMetaData->q_direction[0].cfg.nbands; ++j )
613 : {
614 21435 : hQMetaData->q_direction[0].band_data[j].energy_ratio_index[0] = masa_sq( 1.0f - hQMetaData->q_direction[0].band_data[j].energy_ratio[0], diffuseness_thresholds, DIRAC_DIFFUSE_LEVELS );
615 : }
616 : }
617 :
618 11978 : free( h_orig_metadata );
619 :
620 11978 : ivas_qmetadata_enc_sid_encode( hMetaData, hQMetaData, masa_sid_descriptor, 0, ivas_format );
621 :
622 : /* restore old values */
623 11978 : hMasa->config.numCodingBands = numCodingBands;
624 11978 : hMasa->config.numTwoDirBands = numTwoDirBands;
625 11978 : hQMetaData->q_direction[0].cfg.nbands = nbands;
626 11978 : hMasa->config.numberOfDirections = numberOfDirections;
627 11978 : hMasa->masaMetadata.descriptive_meta.numberOfDirections = numberOfDirectionsMeta;
628 11978 : hQMetaData->no_directions = numberOfDirectionsQMetaData;
629 : }
630 :
631 172476 : return IVAS_ERR_OK;
632 : }
633 :
634 :
635 : /*-----------------------------------------------------------------------*
636 : * ivas_masa_estimate_energy()
637 : *
638 : *
639 : *-----------------------------------------------------------------------*/
640 :
641 154346 : void ivas_masa_estimate_energy(
642 : MASA_ENCODER_HANDLE hMasa, /* i/o: MASA encoder structure */
643 : float *data_f[], /* i : Input audio channels */
644 : const int16_t input_frame, /* i : frame length */
645 : const int16_t nchan_transport /* i : number of MASA input/transport channels */
646 : )
647 : {
648 : float Input_RealBuffer[MASA_MAX_TRANSPORT_CHANNELS][CLDFB_NO_CHANNELS_MAX];
649 : float Input_ImagBuffer[MASA_MAX_TRANSPORT_CHANNELS][CLDFB_NO_CHANNELS_MAX];
650 : int16_t block_m_idx, band_m_idx;
651 : int16_t mrange[2], brange[2];
652 : int16_t i, j, ts, l_ts, maxBin;
653 :
654 154346 : maxBin = (int16_t) ( (float) CLDFB_NO_CHANNELS_MAX * (float) input_frame / L_FRAME48k + 0.5f );
655 :
656 154346 : l_ts = input_frame / CLDFB_NO_COL_MAX;
657 :
658 771730 : for ( block_m_idx = 0; block_m_idx < MAX_PARAM_SPATIAL_SUBFRAMES; block_m_idx++ )
659 : {
660 617384 : mrange[0] = hMasa->config.block_grouping[block_m_idx];
661 617384 : mrange[1] = hMasa->config.block_grouping[block_m_idx + 1];
662 :
663 617384 : set_zero( hMasa->data.energy[block_m_idx], MASA_FREQUENCY_BANDS );
664 :
665 3086920 : for ( ts = mrange[0]; ts < mrange[1]; ts++ )
666 : {
667 6865888 : for ( i = 0; i < nchan_transport; i++ )
668 : {
669 4396352 : cldfbAnalysis_ts( &( data_f[i][l_ts * ts] ), Input_RealBuffer[i], Input_ImagBuffer[i], l_ts, hMasa->data.cldfbAnaEnc[i] );
670 : }
671 :
672 61738400 : for ( band_m_idx = 0; band_m_idx < MASA_FREQUENCY_BANDS; band_m_idx++ )
673 : {
674 59268864 : brange[0] = hMasa->config.band_grouping[band_m_idx];
675 59268864 : brange[1] = hMasa->config.band_grouping[band_m_idx + 1];
676 :
677 164781312 : for ( i = 0; i < nchan_transport; i++ )
678 : {
679 105512448 : if ( brange[0] > maxBin )
680 : {
681 804000 : hMasa->data.energy[block_m_idx][band_m_idx] = 0;
682 804000 : continue;
683 : }
684 104708448 : else if ( brange[1] >= maxBin )
685 : {
686 4958752 : brange[1] = maxBin;
687 : }
688 :
689 351881568 : for ( j = brange[0]; j < brange[1]; j++ )
690 : {
691 247173120 : hMasa->data.energy[block_m_idx][band_m_idx] += Input_RealBuffer[i][j] * Input_RealBuffer[i][j] + Input_ImagBuffer[i][j] * Input_ImagBuffer[i][j];
692 : }
693 : }
694 : }
695 : }
696 : }
697 :
698 154346 : return;
699 : }
700 :
701 :
702 : /*-----------------------------------------------------------------------*
703 : * ivas_masa_enc_config()
704 : *
705 : * Frame-by-frame configuration of MASA encoder
706 : *-----------------------------------------------------------------------*/
707 :
708 154809 : ivas_error ivas_masa_enc_config(
709 : Encoder_Struct *st_ivas /* i/o: IVAS encoder structure */
710 : )
711 : {
712 : int16_t i;
713 : MASA_ENCODER_HANDLE hMasa;
714 : IVAS_QMETADATA_HANDLE hQMetaData;
715 : IVAS_FORMAT ivas_format;
716 : uint8_t joinedSubframes;
717 : uint8_t coherencePresent;
718 : uint8_t isActualTwoDir; /* Flag to tell that when there are two directions present in metadata, they both contain meaningful information. */
719 : int32_t ivas_total_brate;
720 : uint8_t maxBand;
721 : int16_t maxBin, sf;
722 : ivas_error error;
723 : int32_t ism_total_brate;
724 : int32_t masa_total_brate;
725 :
726 154809 : error = IVAS_ERR_OK;
727 :
728 154809 : hMasa = st_ivas->hMasa;
729 154809 : hQMetaData = st_ivas->hQMetaData;
730 154809 : ivas_format = st_ivas->hEncoderConfig->ivas_format;
731 154809 : ivas_total_brate = st_ivas->hEncoderConfig->ivas_total_brate;
732 :
733 154809 : ism_total_brate = 0;
734 154809 : if ( ivas_format == MASA_ISM_FORMAT && st_ivas->nSCE > 0 && ( st_ivas->ism_mode == ISM_MASA_MODE_DISC || st_ivas->ism_mode == ISM_MASA_MODE_PARAM_ONE_OBJ || st_ivas->ism_mode == ISM_MASA_MODE_MASA_ONE_OBJ ) )
735 : {
736 168508 : for ( i = 0; i < st_ivas->nSCE; i++ )
737 : {
738 104308 : ism_total_brate += st_ivas->hSCE[i]->element_brate;
739 : }
740 : }
741 :
742 154809 : ivas_masa_set_elements( ivas_total_brate, st_ivas->mc_mode, st_ivas->nchan_transport, hQMetaData, &st_ivas->hEncoderConfig->element_mode_init, &st_ivas->nSCE, &st_ivas->nCPE, ivas_format, st_ivas->ism_mode, ism_total_brate );
743 :
744 154809 : hQMetaData->is_masa_ivas_format = 1;
745 :
746 154809 : if ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT )
747 : {
748 154346 : masa_metadata_direction_alignment( hMasa );
749 :
750 154346 : detect_framing_async( hMasa ); /* detect the offset, set 1sf/4sf mode based on this. potentially also shift the metadata using a history buffer */
751 :
752 154346 : if ( hMasa->data.sync_state.frame_mode == MASA_FRAME_1SF && hMasa->data.sync_state.prev_offset != 0 )
753 : {
754 : /* average over sub-frames */
755 0 : average_masa_metadata( &( hMasa->masaMetadata ), hMasa->data.energy, &( hMasa->data.Sph_Grid16 ), ivas_total_brate == IVAS_512k ? TRUE : FALSE );
756 : }
757 :
758 : /* Inspect metadata for parameter changes that affect coding. */
759 154346 : detect_metadata_composition( hMasa, &joinedSubframes, &coherencePresent, &isActualTwoDir );
760 154346 : hMasa->config.joinedSubframes = joinedSubframes;
761 154346 : hMasa->config.coherencePresent = coherencePresent;
762 154346 : hMasa->config.numberOfDirections = ( hMasa->masaMetadata.descriptive_meta.numberOfDirections + 1 ) == 2 && isActualTwoDir ? 2 : 1;
763 : }
764 463 : else if ( ivas_format == MC_FORMAT && st_ivas->mc_mode == MC_MODE_MCMASA )
765 : {
766 : /* For McMASA, these are set only once as this function is called only once. */
767 463 : hMasa->config.joinedSubframes = 0;
768 463 : hMasa->config.numberOfDirections = 1;
769 : }
770 :
771 154809 : if ( ivas_format == MASA_ISM_FORMAT )
772 : {
773 84390 : ivas_masa_set_coding_config( &( hMasa->config ), hMasa->data.band_mapping, st_ivas->hCPE[0]->element_brate, st_ivas->nchan_transport, MC_MODE_NONE );
774 : }
775 : else
776 : {
777 70419 : ivas_masa_set_coding_config( &( hMasa->config ), hMasa->data.band_mapping, ivas_total_brate, st_ivas->nchan_transport, ( ivas_format == MC_FORMAT && st_ivas->mc_mode == MC_MODE_MCMASA ) );
778 : }
779 :
780 : /* Setup importance weights for two-direction band selection. */
781 154809 : if ( hMasa->config.numberOfDirections == 2 )
782 : {
783 56580 : set_f( hMasa->data.importanceWeight, 1.0f, hMasa->config.numCodingBands );
784 :
785 56580 : if ( hMasa->config.numCodingBands == 5 )
786 : {
787 45120 : hMasa->data.importanceWeight[4] = 0.7f;
788 : }
789 11460 : else if ( hMasa->config.numCodingBands == 8 )
790 : {
791 354 : hMasa->data.importanceWeight[7] = 0.7f;
792 : }
793 11106 : else if ( hMasa->config.numCodingBands == 10 )
794 : {
795 0 : hMasa->data.importanceWeight[8] = 0.7f;
796 0 : hMasa->data.importanceWeight[9] = 0.1f;
797 : }
798 11106 : else if ( hMasa->config.numCodingBands == 12 )
799 : {
800 7950 : hMasa->data.importanceWeight[10] = 0.7f;
801 7950 : hMasa->data.importanceWeight[11] = 0.1f;
802 : }
803 3156 : else if ( hMasa->config.numCodingBands == 18 )
804 : {
805 1818 : hMasa->data.importanceWeight[14] = 0.8f;
806 1818 : hMasa->data.importanceWeight[15] = 0.5f;
807 1818 : hMasa->data.importanceWeight[16] = 0.2f;
808 1818 : hMasa->data.importanceWeight[17] = 0.0f;
809 : }
810 1338 : else if ( hMasa->config.numCodingBands == 24 )
811 : {
812 1338 : hMasa->data.importanceWeight[20] = 0.8f;
813 1338 : hMasa->data.importanceWeight[21] = 0.5f;
814 1338 : hMasa->data.importanceWeight[22] = 0.2f;
815 1338 : hMasa->data.importanceWeight[23] = 0.0f;
816 : }
817 :
818 56580 : if ( hMasa->config.numTwoDirBands == hMasa->config.numCodingBands )
819 : {
820 400 : set_c( (int8_t *) hMasa->data.twoDirBands, 1, hMasa->config.numCodingBands );
821 : }
822 : }
823 : else
824 : {
825 98229 : set_c( (int8_t *) hMasa->data.twoDirBands, 0, hMasa->config.numCodingBands );
826 : }
827 :
828 : /* Set qmeta to correct values */
829 154809 : if ( ( error = ivas_qmetadata_allocate_memory( hQMetaData, hMasa->config.numCodingBands, hMasa->config.numberOfDirections == 2 && hMasa->config.numTwoDirBands != 0 ? 2 : 1, hMasa->config.useCoherence ) ) != IVAS_ERR_OK )
830 : {
831 0 : return error;
832 : }
833 :
834 339346 : for ( i = 0; i < hQMetaData->no_directions; i++ )
835 : {
836 184537 : hQMetaData->q_direction[i].cfg.nbands = hMasa->config.numCodingBands;
837 184537 : hQMetaData->q_direction[i].cfg.nblocks = hMasa->config.joinedSubframes == TRUE ? 1 : MAX_PARAM_SPATIAL_SUBFRAMES;
838 :
839 184537 : if ( ivas_format == MC_FORMAT )
840 : {
841 463 : hQMetaData->q_direction[i].cfg.mc_ls_setup = st_ivas->hEncoderConfig->mc_input_setup;
842 : }
843 : else
844 : {
845 : /* Just to be sure that this default value is maintained */
846 184074 : hQMetaData->q_direction[i].cfg.mc_ls_setup = MC_LS_SETUP_INVALID;
847 : }
848 : }
849 :
850 154809 : hQMetaData->all_coherence_zero = !hMasa->config.coherencePresent;
851 :
852 154809 : ivas_set_qmetadata_maxbit_req( hQMetaData, ivas_format );
853 :
854 : /* Find maximum band usable */
855 154809 : maxBin = (int16_t) ( st_ivas->hEncoderConfig->input_Fs * INV_CLDFB_BANDWIDTH );
856 154809 : maxBand = 0;
857 3978659 : while ( maxBand <= MASA_FREQUENCY_BANDS && MASA_band_grouping_24[maxBand] <= maxBin )
858 : {
859 3823850 : maxBand++;
860 : }
861 154809 : maxBand--;
862 :
863 154809 : st_ivas->hQMetaData->q_direction->cfg.inactiveBands = 0;
864 154809 : masa_total_brate = ivas_total_brate;
865 154809 : if ( ivas_format == MASA_ISM_FORMAT && st_ivas->ism_mode == ISM_MASA_MODE_DISC )
866 : {
867 42482 : masa_total_brate = calculate_cpe_brate_MASA_ISM( st_ivas->ism_mode, ivas_total_brate, st_ivas->hEncoderConfig->nchan_ism );
868 : }
869 154809 : if ( masa_total_brate >= IVAS_384k && ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT ) )
870 : {
871 : int16_t continueLoop;
872 4216 : continueLoop = 1;
873 8432 : while ( maxBand > 5 && continueLoop )
874 : {
875 4241 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
876 : {
877 4241 : if ( hMasa->data.energy[sf][maxBand - 1] > 100000 )
878 : {
879 4216 : continueLoop = 0;
880 4216 : break;
881 : }
882 : }
883 4216 : if ( continueLoop )
884 : {
885 0 : maxBand--;
886 : }
887 : }
888 :
889 4216 : if ( maxBand < MASA_MAXIMUM_CODING_SUBBANDS )
890 : {
891 1460 : st_ivas->hQMetaData->q_direction->cfg.inactiveBands = MASA_MAXIMUM_CODING_SUBBANDS - maxBand;
892 : }
893 : else
894 : {
895 2756 : st_ivas->hQMetaData->q_direction->cfg.inactiveBands = 0;
896 : }
897 : }
898 :
899 154809 : masa_sample_rate_band_correction( &( hMasa->config ), hMasa->data.band_mapping, hQMetaData, maxBand, masa_total_brate >= IVAS_384k, NULL );
900 :
901 154809 : if ( hMasa->config.numTwoDirBands >= hMasa->config.numCodingBands )
902 : {
903 400 : hMasa->config.numTwoDirBands = hMasa->config.numCodingBands;
904 400 : set_c( (int8_t *) hMasa->data.twoDirBands, 1, hMasa->config.numCodingBands );
905 : }
906 :
907 : /* Transmit stereo signals using a mono downmix at lowest bitrates */
908 154809 : if ( ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT ) && st_ivas->nCPE == 1 && st_ivas->hCPE[0]->hStereoDft != NULL && st_ivas->hCPE[0]->hStereoDft->hConfig != NULL )
909 : {
910 56330 : st_ivas->hCPE[0]->hStereoDft->hConfig->force_mono_transmission = ( ivas_total_brate - ism_total_brate < MASA_STEREO_MIN_BITRATE ) ? 1 : 0;
911 : }
912 :
913 154809 : if ( ivas_format == MASA_ISM_FORMAT && ( st_ivas->ism_mode == ISM_MASA_MODE_MASA_ONE_OBJ || st_ivas->ism_mode == ISM_MASA_MODE_PARAM_ONE_OBJ || st_ivas->ism_mode == ISM_MASA_MODE_DISC ) )
914 : {
915 64200 : if ( st_ivas->hCPE[0]->element_mode == IVAS_CPE_DFT || st_ivas->hMasa->data.hOmasaData->omasa_stereo_sw_cnt < OMASA_STEREO_SW_CNT_MAX )
916 : {
917 21160 : st_ivas->hMasa->data.hOmasaData->lp_noise_CPE = st_ivas->hCPE[0]->hCoreCoder[0]->lp_noise;
918 : }
919 : else
920 : {
921 43040 : st_ivas->hMasa->data.hOmasaData->lp_noise_CPE = ( st_ivas->hCPE[0]->hCoreCoder[0]->lp_noise + st_ivas->hCPE[0]->hCoreCoder[1]->lp_noise ) / CPE_CHANNELS;
922 : }
923 : }
924 :
925 154809 : return error;
926 : }
927 :
928 :
929 : /*-----------------------------------------------------------------------*
930 : * ivas_masa_surrcoh_signicant()
931 : *
932 : * Determine if surrounding coherence is significant in this frame and should be encoded
933 : *-----------------------------------------------------------------------*/
934 :
935 5152 : uint8_t ivas_masa_surrcoh_signicant(
936 : float surroundingCoherence[MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS], /* i : Surround coherence */
937 : float diffuse_to_total_ratio[MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS], /* i : Diffuse to total ratio */
938 : const int16_t nSubFrames, /* i : Number of sub frames */
939 : const int16_t nBands /* i : Number of frequency bands */
940 : )
941 : {
942 : float significanceMeasure1, significanceMeasure2, significanceMeasure;
943 : float surrCohToTotal, surrCohToTotalSum, surrCohToTotalTimesDiffSum, diffSum;
944 : int16_t sf, band;
945 5152 : float surrCohSignificanceCoef = 0.4f;
946 5152 : float threshold = 0.1f;
947 :
948 11779 : for ( sf = 0; sf < nSubFrames; sf++ )
949 : {
950 8083 : surrCohToTotalSum = 0.0f;
951 8083 : surrCohToTotalTimesDiffSum = 0.0f;
952 8083 : diffSum = 0.0f;
953 150300 : for ( band = 0; band < nBands; band++ )
954 : {
955 142217 : surrCohToTotal = diffuse_to_total_ratio[sf][band] * surroundingCoherence[sf][band];
956 142217 : surrCohToTotalSum += surrCohToTotal;
957 142217 : surrCohToTotalTimesDiffSum += diffuse_to_total_ratio[sf][band] * surrCohToTotal;
958 142217 : diffSum += diffuse_to_total_ratio[sf][band];
959 : }
960 8083 : significanceMeasure1 = surrCohToTotalSum / (float) nBands;
961 8083 : significanceMeasure2 = surrCohSignificanceCoef * surrCohToTotalTimesDiffSum / ( diffSum + EPSILON );
962 8083 : significanceMeasure = max( significanceMeasure1, significanceMeasure2 );
963 :
964 8083 : if ( significanceMeasure > threshold )
965 : {
966 1456 : return 1; /* Surrounding coherence was significant in at least one subframe */
967 : }
968 : }
969 :
970 3696 : return 0; /* Surrounding coherence was not significant in any subframe */
971 : }
972 :
973 :
974 : /*-----------------------------------------------------------------------*
975 : * Local functions
976 : *-----------------------------------------------------------------------*/
977 :
978 158633 : static void combine_freqbands_and_subframes(
979 : MASA_ENCODER_HANDLE hMasa )
980 : {
981 : int16_t i, j, k, m;
982 : float aziRad, eleRad;
983 : float x[MASA_MAXIMUM_DIRECTIONS][MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS];
984 : float y[MASA_MAXIMUM_DIRECTIONS][MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS];
985 : float z[MASA_MAXIMUM_DIRECTIONS][MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS];
986 : float vecLen;
987 : float xSum, ySum, zSum;
988 : float energySum;
989 : float spreadCohSum;
990 : float surrCohSum;
991 : float energyRatioSum;
992 : float surrCohTemp;
993 : float energyRatioTemp;
994 : float energy[MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS];
995 : int16_t brange[2];
996 : uint8_t numCodingBands;
997 : uint8_t numSf;
998 : uint8_t numDirections;
999 : MASA_METADATA_HANDLE hMeta;
1000 : uint8_t mergeRatiosOverSubframes;
1001 : uint8_t computeCoherence;
1002 :
1003 158633 : numCodingBands = hMasa->config.numCodingBands;
1004 158633 : numDirections = hMasa->config.numberOfDirections;
1005 158633 : numSf = hMasa->config.joinedSubframes == TRUE ? 1 : MAX_PARAM_SPATIAL_SUBFRAMES;
1006 158633 : hMeta = &( hMasa->masaMetadata );
1007 :
1008 158633 : mergeRatiosOverSubframes = hMasa->config.mergeRatiosOverSubframes;
1009 158633 : computeCoherence = hMasa->config.useCoherence && hMasa->config.coherencePresent;
1010 :
1011 : /* If metadata subframes are joined then we need all energy to be in the first subframe for combining.
1012 : * This optimizes following computations a bit.
1013 : * Note: If energy is used elsewhere, then this can cause problems and local energy should be used. */
1014 158633 : if ( numSf == 1 )
1015 : {
1016 26400 : for ( j = 1; j < MAX_PARAM_SPATIAL_SUBFRAMES; j++ )
1017 : {
1018 495000 : for ( k = 0; k < MASA_FREQUENCY_BANDS; k++ )
1019 : {
1020 475200 : hMasa->data.energy[0][k] += hMasa->data.energy[j][k];
1021 : }
1022 : }
1023 : }
1024 :
1025 158633 : if ( numCodingBands <= MAX_REDUCED_NBANDS )
1026 : {
1027 : /* reduce metadata *frequency* resolution. time resolution is not touched */
1028 342696 : for ( i = 0; i < numDirections; i++ )
1029 : {
1030 969653 : for ( j = 0; j < numSf; j++ ) /* NB: for numSf==1, operates only on first sub-frame */
1031 : {
1032 19258600 : for ( k = 0; k < MASA_FREQUENCY_BANDS; k++ )
1033 : {
1034 18488256 : aziRad = hMeta->directional_meta[i].azimuth[j][k] / 180.0f * EVS_PI;
1035 18488256 : eleRad = hMeta->directional_meta[i].elevation[j][k] / 180.0f * EVS_PI;
1036 18488256 : vecLen = hMeta->directional_meta[i].energy_ratio[j][k] * hMasa->data.energy[j][k];
1037 :
1038 18488256 : x[i][j][k] = cosf( aziRad ) * cosf( eleRad ) * vecLen;
1039 18488256 : y[i][j][k] = sinf( aziRad ) * cosf( eleRad ) * vecLen;
1040 18488256 : z[i][j][k] = sinf( eleRad ) * vecLen;
1041 : }
1042 : }
1043 : }
1044 :
1045 342696 : for ( i = 0; i < numDirections; i++ )
1046 : {
1047 969653 : for ( j = 0; j < numSf; j++ )
1048 : {
1049 5444328 : for ( k = 0; k < numCodingBands; k++ )
1050 : {
1051 4673984 : brange[0] = hMasa->data.band_mapping[k];
1052 4673984 : brange[1] = hMasa->data.band_mapping[k + 1];
1053 :
1054 4673984 : xSum = 0.0f;
1055 4673984 : ySum = 0.0f;
1056 4673984 : zSum = 0.0f;
1057 4673984 : energySum = 0.0f;
1058 4673984 : spreadCohSum = 0.0f;
1059 :
1060 22768818 : for ( m = brange[0]; m < brange[1]; m++ )
1061 : {
1062 18094834 : xSum += x[i][j][m];
1063 18094834 : ySum += y[i][j][m];
1064 18094834 : zSum += z[i][j][m];
1065 18094834 : energySum += hMasa->data.energy[j][m];
1066 : }
1067 :
1068 4673984 : aziRad = atan2f( ySum, xSum );
1069 4673984 : eleRad = atan2f( zSum, sqrtf( xSum * xSum + ySum * ySum ) );
1070 :
1071 4673984 : hMeta->directional_meta[i].azimuth[j][k] = aziRad / EVS_PI * 180.0f;
1072 4673984 : hMeta->directional_meta[i].elevation[j][k] = eleRad / EVS_PI * 180.0f;
1073 :
1074 4673984 : vecLen = sqrtf( xSum * xSum + ySum * ySum + zSum * zSum );
1075 4673984 : hMeta->directional_meta[i].energy_ratio[j][k] = vecLen / ( energySum + EPSILON );
1076 :
1077 4673984 : if ( computeCoherence )
1078 : {
1079 11539982 : for ( m = brange[0]; m < brange[1]; m++ )
1080 : {
1081 8824492 : spreadCohSum += hMeta->directional_meta[i].spread_coherence[j][m] * hMasa->data.energy[j][m];
1082 : }
1083 2715490 : hMeta->directional_meta[i].spread_coherence[j][k] = spreadCohSum / ( energySum + EPSILON );
1084 :
1085 2715490 : if ( i == 0 )
1086 : {
1087 1865468 : surrCohSum = 0.0f;
1088 7962618 : for ( m = brange[0]; m < brange[1]; m++ )
1089 : {
1090 6097150 : surrCohSum += hMeta->common_meta.surround_coherence[j][m] * hMasa->data.energy[j][m];
1091 : }
1092 1865468 : hMeta->common_meta.surround_coherence[j][k] = surrCohSum / ( energySum + EPSILON );
1093 : }
1094 : }
1095 :
1096 4673984 : if ( i == 0 )
1097 : {
1098 3317548 : energy[j][k] = energySum;
1099 : }
1100 : }
1101 : }
1102 : }
1103 : }
1104 15246 : else if ( mergeRatiosOverSubframes ) /* keep frequency resolution */
1105 : {
1106 8700 : for ( j = 0; j < numSf; j++ )
1107 : {
1108 170000 : for ( k = 0; k < numCodingBands; k++ )
1109 : {
1110 163040 : energy[j][k] = hMasa->data.energy[j][k];
1111 : }
1112 : }
1113 : }
1114 :
1115 158633 : if ( mergeRatiosOverSubframes )
1116 : {
1117 876892 : for ( k = 0; k < numCodingBands; k++ )
1118 : {
1119 747103 : energySum = 0.0f;
1120 3735515 : for ( j = 0; j < numSf; j++ )
1121 : {
1122 2988412 : energySum += energy[j][k];
1123 : }
1124 :
1125 747103 : if ( computeCoherence )
1126 : {
1127 390862 : surrCohSum = 0.0f;
1128 1954310 : for ( j = 0; j < numSf; j++ )
1129 : {
1130 1563448 : surrCohSum += energy[j][k] * hMeta->common_meta.surround_coherence[j][k];
1131 : }
1132 390862 : surrCohTemp = surrCohSum / ( energySum + EPSILON );
1133 :
1134 1954310 : for ( j = 0; j < numSf; j++ )
1135 : {
1136 1563448 : hMeta->common_meta.surround_coherence[j][k] = surrCohTemp;
1137 : }
1138 : }
1139 :
1140 1737484 : for ( i = 0; i < numDirections; i++ )
1141 : {
1142 990381 : energyRatioSum = 0.0f;
1143 4951905 : for ( j = 0; j < numSf; j++ )
1144 : {
1145 3961524 : energyRatioSum += energy[j][k] * hMeta->directional_meta[i].energy_ratio[j][k];
1146 : }
1147 990381 : energyRatioTemp = energyRatioSum / ( energySum + EPSILON );
1148 :
1149 4951905 : for ( j = 0; j < numSf; j++ )
1150 : {
1151 3961524 : hMeta->directional_meta[i].energy_ratio[j][k] = energyRatioTemp;
1152 : }
1153 : }
1154 : }
1155 : }
1156 :
1157 158633 : return;
1158 : }
1159 :
1160 :
1161 : /*-------------------------------------------------------------------*
1162 : * ivas_masa_combine_directions()
1163 : *
1164 : *
1165 : *-------------------------------------------------------------------*/
1166 :
1167 56860 : void ivas_masa_combine_directions(
1168 : MASA_ENCODER_HANDLE hMasa )
1169 : {
1170 : int16_t i, j, k;
1171 : uint8_t numCodingBands;
1172 : uint8_t numSf;
1173 : uint8_t numDirections;
1174 : uint8_t computeCoherence;
1175 : MASA_METADATA_HANDLE hMeta;
1176 :
1177 : float aziRad;
1178 : float eleRad;
1179 : float x[MASA_MAXIMUM_DIRECTIONS][MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS];
1180 : float y[MASA_MAXIMUM_DIRECTIONS][MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS];
1181 : float z[MASA_MAXIMUM_DIRECTIONS][MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS];
1182 : float vecLen;
1183 : float xSum[MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS];
1184 : float ySum[MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS];
1185 : float zSum[MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS];
1186 : float sumVecLen[MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS];
1187 : float tempImportance;
1188 : float importance[MASA_FREQUENCY_BANDS];
1189 : int16_t indicesOfLargest[MASA_FREQUENCY_BANDS];
1190 :
1191 : float ambience1dir;
1192 : float ambience2dir;
1193 : float ambienceIncrease;
1194 : float ratioSum;
1195 : float origSurrCohEne;
1196 : float newSurrCohEne;
1197 :
1198 56860 : numCodingBands = hMasa->config.numCodingBands;
1199 56860 : numDirections = hMasa->config.numberOfDirections;
1200 56860 : numSf = hMasa->config.joinedSubframes == TRUE ? 1 : MAX_PARAM_SPATIAL_SUBFRAMES;
1201 :
1202 56860 : hMeta = &( hMasa->masaMetadata );
1203 :
1204 56860 : computeCoherence = hMasa->config.useCoherence && hMasa->config.coherencePresent;
1205 :
1206 170580 : for ( i = 0; i < numDirections; i++ )
1207 : {
1208 551500 : for ( j = 0; j < numSf; j++ )
1209 : {
1210 5770656 : for ( k = 0; k < numCodingBands; k++ )
1211 : {
1212 5332876 : aziRad = hMeta->directional_meta[i].azimuth[j][k] / 180.0f * EVS_PI;
1213 5332876 : eleRad = hMeta->directional_meta[i].elevation[j][k] / 180.0f * EVS_PI;
1214 5332876 : vecLen = hMeta->directional_meta[i].energy_ratio[j][k];
1215 :
1216 5332876 : x[i][j][k] = cosf( aziRad ) * cosf( eleRad ) * vecLen;
1217 5332876 : y[i][j][k] = sinf( aziRad ) * cosf( eleRad ) * vecLen;
1218 5332876 : z[i][j][k] = sinf( eleRad ) * vecLen;
1219 : }
1220 : }
1221 : }
1222 :
1223 : /* Compute sum vector */
1224 275750 : for ( j = 0; j < numSf; j++ )
1225 : {
1226 2885328 : for ( k = 0; k < numCodingBands; k++ )
1227 : {
1228 2666438 : xSum[j][k] = x[0][j][k] + x[1][j][k];
1229 2666438 : ySum[j][k] = y[0][j][k] + y[1][j][k];
1230 2666438 : zSum[j][k] = z[0][j][k] + z[1][j][k];
1231 2666438 : sumVecLen[j][k] = sqrtf( xSum[j][k] * xSum[j][k] + ySum[j][k] * ySum[j][k] + zSum[j][k] * zSum[j][k] );
1232 : }
1233 : }
1234 :
1235 : /* Estimate the importance of having two directions instead of one */
1236 753408 : for ( i = 0; i < numCodingBands; i++ )
1237 : {
1238 696548 : importance[i] = 0.0f;
1239 3362986 : for ( j = 0; j < numSf; j++ )
1240 : {
1241 2666438 : tempImportance = hMeta->directional_meta[0].energy_ratio[j][i] + hMeta->directional_meta[1].energy_ratio[j][i] - sumVecLen[j][i];
1242 2666438 : importance[i] += tempImportance;
1243 : }
1244 696548 : importance[i] /= (float) numSf;
1245 696548 : importance[i] *= hMasa->data.importanceWeight[i];
1246 : }
1247 :
1248 : /* Determine bands where to use two directions */
1249 56860 : find_n_largest( importance, indicesOfLargest, numCodingBands, hMasa->config.numTwoDirBands );
1250 :
1251 753408 : for ( i = 0; i < numCodingBands; i++ )
1252 : {
1253 696548 : hMasa->data.twoDirBands[i] = 0;
1254 : }
1255 :
1256 159150 : for ( i = 0; i < hMasa->config.numTwoDirBands; i++ )
1257 : {
1258 102290 : hMasa->data.twoDirBands[indicesOfLargest[i]] = 1;
1259 : }
1260 :
1261 : /* Combine directions on the remaining bands */
1262 753408 : for ( i = 0; i < numCodingBands; i++ )
1263 : {
1264 696548 : if ( hMasa->data.twoDirBands[i] == 0 )
1265 : {
1266 2869668 : for ( j = 0; j < numSf; j++ )
1267 : {
1268 2275410 : aziRad = atan2f( ySum[j][i], xSum[j][i] );
1269 2275410 : eleRad = atan2f( zSum[j][i], sqrtf( xSum[j][i] * xSum[j][i] + ySum[j][i] * ySum[j][i] ) );
1270 :
1271 2275410 : hMeta->directional_meta[0].azimuth[j][i] = aziRad / EVS_PI * 180.0f;
1272 2275410 : hMeta->directional_meta[0].elevation[j][i] = eleRad / EVS_PI * 180.0f;
1273 :
1274 2275410 : ratioSum = hMeta->directional_meta[0].energy_ratio[j][i] + hMeta->directional_meta[1].energy_ratio[j][i];
1275 2275410 : if ( computeCoherence )
1276 : {
1277 536916 : hMeta->directional_meta[0].spread_coherence[j][i] =
1278 536916 : ( hMeta->directional_meta[0].spread_coherence[j][i] * hMeta->directional_meta[0].energy_ratio[j][i] + hMeta->directional_meta[1].spread_coherence[j][i] * hMeta->directional_meta[1].energy_ratio[j][i] ) / ( ratioSum + EPSILON );
1279 : }
1280 :
1281 2275410 : ambience2dir = 1.0f - ratioSum;
1282 2275410 : hMeta->directional_meta[0].energy_ratio[j][i] = sumVecLen[j][i] / ( hMeta->directional_meta[0].energy_ratio[j][i] + hMeta->directional_meta[1].energy_ratio[j][i] + ambience2dir / 2.0f );
1283 2275410 : hMeta->directional_meta[1].energy_ratio[j][i] = 0.0f;
1284 2275410 : hMeta->common_meta.diffuse_to_total_ratio[j][i] = 1.0f - hMeta->directional_meta[0].energy_ratio[j][i];
1285 2275410 : if ( computeCoherence )
1286 : {
1287 536916 : ambience1dir = 1.0f - hMeta->directional_meta[0].energy_ratio[j][i];
1288 536916 : ambienceIncrease = max( ambience1dir - ambience2dir, 0.0f );
1289 :
1290 536916 : origSurrCohEne = ambience2dir * hMeta->common_meta.surround_coherence[j][i];
1291 536916 : newSurrCohEne = ambienceIncrease * hMeta->directional_meta[0].spread_coherence[j][i];
1292 536916 : hMeta->common_meta.surround_coherence[j][i] = min( 1.0f, ( origSurrCohEne + newSurrCohEne ) / ( ambience1dir + EPSILON ) );
1293 : }
1294 : }
1295 : }
1296 : }
1297 :
1298 56860 : return;
1299 : }
1300 :
1301 :
1302 56860 : static void find_n_largest(
1303 : const float *input,
1304 : int16_t *largestIndices,
1305 : const int16_t numElements,
1306 : const int16_t numLargest )
1307 : {
1308 : int16_t i, j;
1309 : float largestValue;
1310 : int16_t largestIndex;
1311 : float values[MASA_FREQUENCY_BANDS];
1312 :
1313 753408 : for ( j = 0; j < numElements; j++ )
1314 : {
1315 696548 : values[j] = input[j];
1316 : }
1317 :
1318 159150 : for ( i = 0; i < numLargest; i++ )
1319 : {
1320 102290 : largestValue = values[0];
1321 102290 : largestIndex = 0;
1322 1123944 : for ( j = 1; j < numElements; j++ )
1323 : {
1324 1021654 : if ( values[j] > largestValue )
1325 : {
1326 165342 : largestValue = values[j];
1327 165342 : largestIndex = j;
1328 : }
1329 : }
1330 102290 : largestIndices[i] = largestIndex;
1331 102290 : values[largestIndex] = -1.0f;
1332 : }
1333 :
1334 56860 : return;
1335 : }
1336 :
1337 :
1338 158633 : static void move_metadata_to_qmetadata(
1339 : const MASA_ENCODER_HANDLE hMasa,
1340 : IVAS_QMETADATA_HANDLE hQMeta )
1341 : {
1342 : int16_t dir, sf, band;
1343 : uint8_t numCodingBands;
1344 : uint8_t numDirections;
1345 : uint8_t numSf;
1346 : MASA_METADATA_HANDLE hMeta;
1347 :
1348 158633 : numCodingBands = hMasa->config.numCodingBands;
1349 158633 : numDirections = hMasa->config.numberOfDirections;
1350 158633 : numSf = hMasa->config.joinedSubframes == TRUE ? 1 : MAX_PARAM_SPATIAL_SUBFRAMES;
1351 158633 : hMeta = &( hMasa->masaMetadata );
1352 :
1353 346994 : for ( dir = 0; dir < numDirections; dir++ )
1354 : {
1355 918117 : for ( sf = 0; sf < numSf; sf++ )
1356 : {
1357 6402684 : for ( band = 0; band < numCodingBands; band++ )
1358 : {
1359 5672928 : hQMeta->q_direction[dir].band_data[band].azimuth[sf] = hMeta->directional_meta[dir].azimuth[sf][band];
1360 5672928 : hQMeta->q_direction[dir].band_data[band].elevation[sf] = hMeta->directional_meta[dir].elevation[sf][band];
1361 5672928 : hQMeta->q_direction[dir].band_data[band].energy_ratio[sf] = hMeta->directional_meta[dir].energy_ratio[sf][band];
1362 5672928 : hQMeta->q_direction[dir].band_data[band].spherical_index[sf] = hMeta->directional_meta[dir].spherical_index[sf][band];
1363 5672928 : if ( hQMeta->q_direction[dir].coherence_band_data != NULL )
1364 : {
1365 4238314 : hQMeta->q_direction[dir].coherence_band_data[band].spread_coherence[sf] = (uint8_t) roundf( hMeta->directional_meta[dir].spread_coherence[sf][band] * UINT8_MAX );
1366 : }
1367 : }
1368 : }
1369 : }
1370 :
1371 773365 : for ( sf = 0; sf < numSf; sf++ )
1372 : {
1373 5343106 : for ( band = 0; band < numCodingBands; band++ )
1374 : {
1375 4728374 : if ( hQMeta->surcoh_band_data != NULL )
1376 : {
1377 3293760 : hQMeta->surcoh_band_data[band].surround_coherence[sf] = (uint8_t) roundf( hMeta->common_meta.surround_coherence[sf][band] * UINT8_MAX );
1378 : }
1379 : }
1380 : }
1381 :
1382 158633 : if ( numDirections > 1 )
1383 : {
1384 282962 : for ( band = 0; band < numCodingBands; band++ )
1385 : {
1386 253234 : hQMeta->twoDirBands[band] = hMasa->data.twoDirBands[band];
1387 : }
1388 29728 : hQMeta->numTwoDirBands = hMasa->config.numTwoDirBands;
1389 : }
1390 :
1391 : /* Copy spread coherence for DCT-based coding */
1392 158633 : if ( numSf == 1 && hMasa->config.useCoherence )
1393 : {
1394 7820 : for ( dir = 0; dir < numDirections; dir++ )
1395 : {
1396 18232 : for ( sf = 1; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1397 : {
1398 237168 : for ( band = 0; band < numCodingBands; band++ )
1399 : {
1400 223494 : hQMeta->q_direction[dir].coherence_band_data[band].spread_coherence[sf] = hQMeta->q_direction[dir].coherence_band_data[band].spread_coherence[0];
1401 : }
1402 : }
1403 : }
1404 : }
1405 :
1406 158633 : return;
1407 : }
1408 :
1409 :
1410 : /* This function studies parametric MASA metadata to provide information for codec configuration */
1411 154346 : static void detect_metadata_composition(
1412 : const MASA_ENCODER_HANDLE hMasa, /* i : MASA encoder data */
1413 : uint8_t *joinedSubframes, /* o : Result of subframe composition */
1414 : uint8_t *coherencePresent, /* o : Result of coherence presence */
1415 : uint8_t *isTwoDir /* o : Result of two direction check */
1416 : )
1417 : {
1418 : MASA_METADATA_FRAME *hMeta;
1419 : int8_t sf, band, dir, numDir;
1420 : int16_t nSubFrames;
1421 154346 : uint8_t dirValid[2] = { FALSE, FALSE };
1422 154346 : uint8_t cohPresent = FALSE;
1423 154346 : uint8_t sfDiffer = FALSE;
1424 : uint8_t sfSimilar;
1425 :
1426 154346 : hMeta = &( hMasa->masaMetadata );
1427 154346 : numDir = hMeta->descriptive_meta.numberOfDirections + 1;
1428 :
1429 154346 : *isTwoDir = FALSE;
1430 :
1431 : /* First check for valid two directions */
1432 154346 : if ( numDir == 1 )
1433 : {
1434 97766 : dirValid[0] = TRUE;
1435 : }
1436 : else
1437 : {
1438 : /* Default assumption */
1439 56580 : *isTwoDir = TRUE;
1440 :
1441 : /* Check for direct-to-total ratio values */
1442 169740 : for ( dir = 0; dir < numDir; dir++ )
1443 : {
1444 113160 : sf = 0;
1445 226320 : while ( !dirValid[dir] && sf < MAX_PARAM_SPATIAL_SUBFRAMES )
1446 : {
1447 113160 : band = 0;
1448 226320 : while ( !dirValid[dir] && band < MASA_FREQUENCY_BANDS )
1449 : {
1450 113160 : if ( hMeta->directional_meta[dir].energy_ratio[sf][band] >= MASA_RATIO_THRESHOLD )
1451 : {
1452 113160 : dirValid[dir] = TRUE;
1453 : }
1454 113160 : band++;
1455 : }
1456 113160 : sf++;
1457 : }
1458 : }
1459 :
1460 56580 : if ( dirValid[1] == FALSE )
1461 : {
1462 : /* This handles also case where both are false. Then we just use first dir metadata. */
1463 0 : *isTwoDir = FALSE;
1464 : }
1465 56580 : else if ( dirValid[0] == FALSE && dirValid[1] == TRUE )
1466 : {
1467 0 : *isTwoDir = FALSE;
1468 : /* Copy data to first direction */
1469 0 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1470 : {
1471 0 : for ( band = 0; band < MASA_FREQUENCY_BANDS; band++ )
1472 : {
1473 0 : hMeta->directional_meta[0].spherical_index[sf][band] = hMeta->directional_meta[1].spherical_index[sf][band];
1474 0 : hMeta->directional_meta[0].azimuth[sf][band] = hMeta->directional_meta[1].azimuth[sf][band];
1475 0 : hMeta->directional_meta[0].elevation[sf][band] = hMeta->directional_meta[1].elevation[sf][band];
1476 0 : hMeta->directional_meta[0].energy_ratio[sf][band] = hMeta->directional_meta[1].energy_ratio[sf][band];
1477 0 : hMeta->directional_meta[0].spread_coherence[sf][band] = hMeta->directional_meta[1].spread_coherence[sf][band];
1478 : }
1479 : }
1480 : }
1481 :
1482 56580 : if ( *isTwoDir == FALSE )
1483 : {
1484 : /* Further checks will be done with just one direction */
1485 0 : numDir = 1;
1486 : }
1487 : }
1488 :
1489 : /* Check if data over subframes is identical. Check is done by comparing to first subframe. */
1490 154346 : sfSimilar = TRUE;
1491 154346 : sf = 1;
1492 321592 : while ( ( sfSimilar == TRUE ) && ( sf < MAX_PARAM_SPATIAL_SUBFRAMES ) )
1493 : {
1494 167246 : sfSimilar = are_masa_subframes_similar( hMeta, 0, hMeta, sf );
1495 167246 : sf++;
1496 : }
1497 154346 : sfDiffer = sfSimilar == TRUE ? FALSE : TRUE;
1498 :
1499 : /* Further checks can be done with just one subframe if they are identical */
1500 154346 : nSubFrames = sfDiffer == TRUE ? MAX_PARAM_SPATIAL_SUBFRAMES : 1;
1501 :
1502 : /* Check spread coherence */
1503 154346 : dir = 0;
1504 308692 : while ( cohPresent == FALSE && dir < numDir )
1505 : {
1506 154346 : sf = 0;
1507 319732 : while ( cohPresent == FALSE && sf < nSubFrames )
1508 : {
1509 165386 : band = 0;
1510 1089519 : while ( cohPresent == FALSE && band < MASA_FREQUENCY_BANDS )
1511 : {
1512 : /* Check coherences for presence of coherence */
1513 924133 : if ( hMeta->directional_meta[dir].spread_coherence[sf][band] >= MASA_COHERENCE_THRESHOLD )
1514 : {
1515 151919 : cohPresent = TRUE;
1516 : }
1517 924133 : band++;
1518 : }
1519 165386 : sf++;
1520 : }
1521 154346 : dir++;
1522 : }
1523 :
1524 : /* Check surround coherence separately if we do not have already knowledge of coherence */
1525 154346 : if ( cohPresent == FALSE )
1526 : {
1527 2427 : cohPresent = ivas_masa_surrcoh_signicant( hMeta->common_meta.surround_coherence, hMeta->common_meta.diffuse_to_total_ratio, nSubFrames, MASA_FREQUENCY_BANDS );
1528 : }
1529 :
1530 : /* Set output flags */
1531 154346 : *joinedSubframes = sfDiffer == TRUE ? FALSE : TRUE;
1532 154346 : *coherencePresent = cohPresent;
1533 :
1534 154346 : return;
1535 : }
1536 :
1537 :
1538 : /* Check and compensate energy ratios. This function verifies that energy ratios follow the principle of summing to one.
1539 : * In addition, it implements simple remainder-to-total handling where remainder energy is proportionally added to other
1540 : * ratios. */
1541 154346 : static void compensate_energy_ratios(
1542 : MASA_ENCODER_HANDLE hMasa )
1543 : {
1544 : int16_t sf, band, dir;
1545 : float ratioSum;
1546 : MASA_METADATA_HANDLE hMeta;
1547 : uint8_t numDirs;
1548 :
1549 154346 : hMeta = &( hMasa->masaMetadata );
1550 154346 : numDirs = hMasa->config.numberOfDirections;
1551 :
1552 771730 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1553 : {
1554 15434600 : for ( band = 0; band < MASA_FREQUENCY_BANDS; band++ )
1555 : {
1556 : /* Remainder is always set to zero and energy removal is compensated in following steps
1557 : * to other ratios. */
1558 14817216 : hMeta->common_meta.remainder_to_total_ratio[sf][band] = 0.0f;
1559 :
1560 14817216 : ratioSum = 0;
1561 35066112 : for ( dir = 0; dir < numDirs; dir++ )
1562 : {
1563 20248896 : ratioSum += hMeta->directional_meta[dir].energy_ratio[sf][band];
1564 : }
1565 14817216 : ratioSum += hMeta->common_meta.diffuse_to_total_ratio[sf][band];
1566 :
1567 14817216 : if ( ratioSum == 0.0f )
1568 : {
1569 0 : for ( dir = 0; dir < numDirs; dir++ )
1570 : {
1571 0 : hMeta->directional_meta[dir].energy_ratio[sf][band] = 0.0f;
1572 : }
1573 0 : hMeta->common_meta.diffuse_to_total_ratio[sf][band] = 1.0f;
1574 : }
1575 14817216 : else if ( ratioSum != 1.0f )
1576 : {
1577 637791 : for ( dir = 0; dir < numDirs; dir++ )
1578 : {
1579 425194 : hMeta->directional_meta[dir].energy_ratio[sf][band] /= ratioSum;
1580 : }
1581 212597 : hMeta->common_meta.diffuse_to_total_ratio[sf][band] /= ratioSum;
1582 : }
1583 : }
1584 : }
1585 :
1586 154346 : return;
1587 : }
1588 :
1589 :
1590 : /* If the bit budget is very low, reduce metadata further to either 1 subframe and 5 bands, or 1 band and 4 subframes, based on which works better */
1591 82051 : static void reduce_metadata_further(
1592 : MASA_ENCODER_HANDLE hMasa,
1593 : IVAS_QMETADATA_HANDLE hqmetadata,
1594 : const IVAS_FORMAT ivas_format )
1595 : {
1596 : int16_t sf;
1597 : int16_t band;
1598 : int16_t selectedBand;
1599 : float energy[MAX_PARAM_SPATIAL_SUBFRAMES][LOWBITRATE_NUM_BANDS];
1600 : float totalEnergySum;
1601 : uint8_t numCodingBands;
1602 : uint8_t computeCoherence;
1603 : float onset_filter;
1604 : float bandEnergy;
1605 : uint8_t mergeOverFreqBands;
1606 : float meanRatio;
1607 :
1608 82051 : numCodingBands = hMasa->config.numCodingBands;
1609 82051 : computeCoherence = hMasa->config.useCoherence && hMasa->config.coherencePresent;
1610 :
1611 : /* Set default values */
1612 82051 : selectedBand = 0;
1613 82051 : mergeOverFreqBands = 0;
1614 :
1615 : /* Get energy for the input data in 4-subframe, 5-band format */
1616 82051 : totalEnergySum = 0.0f;
1617 82051 : if ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT ) /* Energy data is in 4-subframe, 24-band format */
1618 : {
1619 350180 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1620 : {
1621 : int16_t brange[2];
1622 : float eneSum;
1623 : int16_t m;
1624 :
1625 1680864 : for ( band = 0; band < numCodingBands; band++ )
1626 : {
1627 1400720 : brange[0] = hMasa->data.band_mapping[band];
1628 1400720 : brange[1] = hMasa->data.band_mapping[band + 1];
1629 :
1630 1400720 : eneSum = 0.0f;
1631 8052720 : for ( m = brange[0]; m < brange[1]; m++ )
1632 : {
1633 6652000 : eneSum += hMasa->data.energy[sf][m];
1634 : }
1635 1400720 : energy[sf][band] = eneSum;
1636 1400720 : totalEnergySum += eneSum;
1637 : }
1638 : }
1639 : }
1640 : else /* Energy data is already in 4-subframe, 5-band format */
1641 : {
1642 60075 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1643 : {
1644 288360 : for ( band = 0; band < numCodingBands; band++ )
1645 : {
1646 240300 : energy[sf][band] = hMasa->data.energy[sf][band];
1647 240300 : totalEnergySum += energy[sf][band];
1648 : }
1649 : }
1650 : }
1651 :
1652 : /* Determine onsets */
1653 82051 : hMasa->data.onset_detector_1 = hMasa->data.onset_detector_1 * LOWBITRATE_ONSET_ALPHA;
1654 82051 : hMasa->data.onset_detector_1 = max( hMasa->data.onset_detector_1, totalEnergySum );
1655 :
1656 82051 : hMasa->data.onset_detector_2 = LOWBITRATE_ONSET_BETA * hMasa->data.onset_detector_2 + ( 1.0f - LOWBITRATE_ONSET_BETA ) * hMasa->data.onset_detector_1;
1657 82051 : hMasa->data.onset_detector_2 = LOWBITRATE_ONSET_GAIN * min( hMasa->data.onset_detector_1, hMasa->data.onset_detector_2 );
1658 :
1659 82051 : onset_filter = min( max( hMasa->data.onset_detector_2 / ( hMasa->data.onset_detector_1 + EPSILON ), 0.0f ), 1.0f );
1660 :
1661 : /* If we have onset, continue checking if we should reduce in frequency instead of time. */
1662 82051 : if ( onset_filter < 0.99f )
1663 : {
1664 : /* Determine one frequency band to use to represent all frequency bands */
1665 75440 : for ( band = numCodingBands - 1; band >= 0; band-- )
1666 : {
1667 : float threshold;
1668 : float bandRatio;
1669 :
1670 75054 : threshold = totalEnergySum / ( MAX_PARAM_SPATIAL_SUBFRAMES * LOWBITRATE_NUM_BANDS ) * 0.5f; /* Average energy multiplied with energy ratio of 0.5f */
1671 75054 : bandRatio = hqmetadata->q_direction[0].band_data[band].energy_ratio[0];
1672 :
1673 75054 : bandEnergy = 0.0f;
1674 375270 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1675 : {
1676 300216 : bandEnergy += energy[sf][band];
1677 : }
1678 :
1679 75054 : if ( bandEnergy / MAX_PARAM_SPATIAL_SUBFRAMES * bandRatio > threshold )
1680 : {
1681 21965 : selectedBand = band;
1682 21965 : break;
1683 : }
1684 : }
1685 :
1686 : /* Determine if to merge over frequency instead of time */
1687 22351 : meanRatio = 0.0f;
1688 111755 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1689 : {
1690 536424 : for ( band = 0; band < numCodingBands; band++ )
1691 : {
1692 447020 : meanRatio += hqmetadata->q_direction[0].band_data[band].energy_ratio[sf] * energy[sf][band];
1693 : }
1694 : }
1695 22351 : meanRatio /= ( totalEnergySum + EPSILON );
1696 :
1697 : /* If the ratio of the selected band is larger than the average ratio of all bands and if there is an onset, merge over frequency bands.
1698 : * Otherwise, merge over subframes. */
1699 22351 : if ( hqmetadata->q_direction[0].band_data[selectedBand].energy_ratio[0] > meanRatio )
1700 : {
1701 12912 : mergeOverFreqBands = 1;
1702 : }
1703 : else
1704 : {
1705 9439 : mergeOverFreqBands = 0;
1706 : }
1707 : }
1708 : else
1709 : {
1710 59700 : mergeOverFreqBands = 0;
1711 : }
1712 :
1713 : /* Merge values over subframes or frequency bands, depending on which one is less important */
1714 82051 : if ( !mergeOverFreqBands ) /* Merge values over subframes */
1715 : {
1716 : float xSum, ySum, zSum;
1717 : float bandSumEnergy;
1718 : float aziRad, eleRad;
1719 : float x, y, z;
1720 : float veclen;
1721 :
1722 414834 : for ( band = 0; band < numCodingBands; band++ )
1723 : {
1724 345695 : xSum = 0.0f;
1725 345695 : ySum = 0.0f;
1726 345695 : zSum = 0.0f;
1727 345695 : bandSumEnergy = 0.0f;
1728 :
1729 1728475 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1730 : {
1731 1382780 : aziRad = hqmetadata->q_direction[0].band_data[band].azimuth[sf] / 180.0f * EVS_PI;
1732 1382780 : eleRad = hqmetadata->q_direction[0].band_data[band].elevation[sf] / 180.0f * EVS_PI;
1733 1382780 : veclen = hqmetadata->q_direction[0].band_data[band].energy_ratio[sf] * energy[sf][band];
1734 :
1735 1382780 : x = cosf( aziRad ) * cosf( eleRad ) * veclen;
1736 1382780 : y = sinf( aziRad ) * cosf( eleRad ) * veclen;
1737 1382780 : z = sinf( eleRad ) * veclen;
1738 :
1739 1382780 : xSum += x;
1740 1382780 : ySum += y;
1741 1382780 : zSum += z;
1742 :
1743 1382780 : bandSumEnergy += energy[sf][band];
1744 : }
1745 :
1746 345695 : aziRad = atan2f( ySum, xSum );
1747 345695 : eleRad = atan2f( zSum, sqrtf( xSum * xSum + ySum * ySum ) );
1748 :
1749 345695 : hqmetadata->q_direction[0].band_data[band].azimuth[0] = aziRad / EVS_PI * 180.0f;
1750 345695 : hqmetadata->q_direction[0].band_data[band].elevation[0] = eleRad / EVS_PI * 180.0f;
1751 :
1752 : /* Energy ratio is already merged through time */
1753 :
1754 345695 : if ( computeCoherence && hqmetadata->q_direction[0].coherence_band_data != NULL )
1755 : {
1756 : float spreadCoh;
1757 38700 : float spreadCohSum = 0.0f;
1758 193500 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1759 : {
1760 154800 : spreadCoh = (float) hqmetadata->q_direction[0].coherence_band_data[band].spread_coherence[sf] / 255.0f;
1761 154800 : spreadCohSum += spreadCoh * energy[sf][band];
1762 : }
1763 38700 : hqmetadata->q_direction[0].coherence_band_data[band].spread_coherence[0] = (uint8_t) roundf( spreadCohSum / ( bandSumEnergy + EPSILON ) * 255.0f );
1764 :
1765 : /* Copy spread coherence to the rest of subframes for the coherence coding algorithm. */
1766 154800 : for ( sf = 1; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1767 : {
1768 116100 : hqmetadata->q_direction[0].coherence_band_data[band].spread_coherence[sf] = hqmetadata->q_direction[0].coherence_band_data[band].spread_coherence[0];
1769 : }
1770 :
1771 : /* Surround coherence is already merged through time */
1772 : }
1773 : }
1774 :
1775 69139 : hqmetadata->q_direction->cfg.nblocks = 1;
1776 69139 : hMasa->config.joinedSubframes = 1;
1777 : }
1778 : else /* Merge values over frequency bands */
1779 : {
1780 : /* Use the selected frequency band to represent all data */
1781 64560 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1782 : {
1783 51648 : hqmetadata->q_direction[0].band_data[0].azimuth[sf] = hqmetadata->q_direction[0].band_data[selectedBand].azimuth[sf];
1784 51648 : hqmetadata->q_direction[0].band_data[0].elevation[sf] = hqmetadata->q_direction[0].band_data[selectedBand].elevation[sf];
1785 51648 : hqmetadata->q_direction[0].band_data[0].energy_ratio[sf] = hqmetadata->q_direction[0].band_data[selectedBand].energy_ratio[sf];
1786 51648 : if ( hqmetadata->q_direction[0].coherence_band_data != NULL )
1787 : {
1788 7348 : hqmetadata->q_direction[0].coherence_band_data[0].spread_coherence[sf] = hqmetadata->q_direction[0].coherence_band_data[selectedBand].spread_coherence[sf];
1789 : }
1790 51648 : if ( hqmetadata->surcoh_band_data != NULL )
1791 : {
1792 7348 : hqmetadata->surcoh_band_data[0].surround_coherence[sf] = hqmetadata->surcoh_band_data[selectedBand].surround_coherence[sf];
1793 : }
1794 : }
1795 :
1796 : /* Copy coherence to rest of bands for the coherence coding algorithm. */
1797 64560 : for ( band = 1; band < numCodingBands; band++ )
1798 : {
1799 51648 : if ( hqmetadata->q_direction[0].coherence_band_data != NULL )
1800 : {
1801 36740 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1802 : {
1803 29392 : hqmetadata->q_direction[0].coherence_band_data[band].spread_coherence[sf] = hqmetadata->q_direction[0].coherence_band_data[0].spread_coherence[sf];
1804 : }
1805 : }
1806 51648 : if ( hqmetadata->q_direction[0].coherence_band_data != NULL )
1807 : {
1808 36740 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1809 : {
1810 29392 : hqmetadata->surcoh_band_data[band].surround_coherence[sf] = hqmetadata->surcoh_band_data[0].surround_coherence[sf];
1811 : }
1812 : }
1813 : }
1814 :
1815 12912 : hqmetadata->q_direction[0].cfg.nbands = 1;
1816 : }
1817 :
1818 82051 : return;
1819 : }
1820 :
1821 :
1822 18130 : static int16_t encode_lfe_to_total_energy_ratio(
1823 : MASA_ENCODER_HANDLE hMasa, /* i/o: MASA encoder structure */
1824 : BSTR_ENC_HANDLE hMetaData, /* i/o: Metadata bitstream handle */
1825 : const int32_t ivas_total_brate /* i : IVAS total bitrate */
1826 : )
1827 : {
1828 : int16_t i;
1829 : float xq;
1830 : int16_t VQLevels;
1831 : float maxLFESubFrameEner;
1832 : float log2LFEaverage;
1833 : float log2LFEratio[4];
1834 : float xqv[4];
1835 : float linearLFEaverage;
1836 : int16_t lfeToTotalEnergyRatioIndices[3];
1837 : int16_t lfeAdaptiveVQBits;
1838 : int16_t lfeBitsWritten;
1839 :
1840 18130 : VQLevels = 0;
1841 18130 : lfeAdaptiveVQBits = 0;
1842 :
1843 : /* Determine maximum amount of LFE energy in any subframe */
1844 18130 : maxLFESubFrameEner = 0.0f;
1845 90650 : for ( i = 0; i < MAX_PARAM_SPATIAL_SUBFRAMES; i++ )
1846 : {
1847 72520 : if ( hMasa->data.lfeToTotalEnergyRatio[i] > maxLFESubFrameEner )
1848 : {
1849 37406 : maxLFESubFrameEner = hMasa->data.lfeToTotalEnergyRatio[i];
1850 : }
1851 : }
1852 :
1853 : /* Set default values for the indices */
1854 72520 : for ( i = 0; i < 3; i++ )
1855 : {
1856 54390 : lfeToTotalEnergyRatioIndices[i] = 0;
1857 : }
1858 :
1859 : /* Check if there is enough energy in any subframe. If not, send only 1 bit (0) and abort. */
1860 : /* If there is enough LFE energy at least in one subframe, quantize it. */
1861 18130 : if ( maxLFESubFrameEner > 0.005f )
1862 : {
1863 : /* Convert energy to log2 domain, and clamp it to reasonable values */
1864 5440 : log2LFEaverage = 0.0f;
1865 27200 : for ( i = 0; i < MAX_PARAM_SPATIAL_SUBFRAMES; i++ )
1866 : {
1867 21760 : log2LFEratio[i] = log2f( max( 0.001f, hMasa->data.lfeToTotalEnergyRatio[i] ) );
1868 21760 : if ( log2LFEratio[i] > 1.0f ) /* Corresponds to linear value 2.0f */
1869 : {
1870 0 : log2LFEratio[i] = 1.0f;
1871 : }
1872 21760 : else if ( log2LFEratio[i] < -9.0f )
1873 : {
1874 875 : log2LFEratio[i] = -9.0f;
1875 : }
1876 21760 : log2LFEaverage += 0.25f * log2LFEratio[i];
1877 : }
1878 :
1879 5440 : if ( ivas_total_brate == IVAS_13k2 )
1880 : {
1881 : /* Calculate adaptive 1-bit LFE quantizer index */
1882 683 : linearLFEaverage = exp2f( log2LFEaverage ); /* Convert back to linear domain */
1883 683 : if ( ( linearLFEaverage > MCMASA_LFE_1BIT_THRES ) && ( linearLFEaverage > ( 0.5f * ( MCMASA_LFE_BETA + hMasa->data.prevq_lfeToTotalEnergyRatio ) + 0.5f * ( MCMASA_LFE_ALPHA * hMasa->data.prevq_lfeToTotalEnergyRatio ) ) ) )
1884 : {
1885 360 : lfeToTotalEnergyRatioIndices[0] = 1;
1886 360 : if ( hMasa->data.prevq_lfeIndex == 1 )
1887 : {
1888 226 : hMasa->data.prevq_lfeToTotalEnergyRatio = hMasa->data.prevq_lfeToTotalEnergyRatio + MCMASA_LFE_THETA * MCMASA_LFE_BETA; /* larger "bump-up" to LFE-to-total energy ratio */
1889 : }
1890 : else
1891 : {
1892 134 : hMasa->data.prevq_lfeToTotalEnergyRatio = hMasa->data.prevq_lfeToTotalEnergyRatio + MCMASA_LFE_BETA; /* default "bump-up" to LFE-to-total energy ratio */
1893 : }
1894 : }
1895 : else
1896 : {
1897 323 : hMasa->data.prevq_lfeToTotalEnergyRatio = MCMASA_LFE_ALPHA * hMasa->data.prevq_lfeToTotalEnergyRatio; /* exponential decay */
1898 : }
1899 :
1900 683 : if ( hMasa->data.prevq_lfeToTotalEnergyRatio > 1.0f )
1901 : {
1902 0 : hMasa->data.prevq_lfeToTotalEnergyRatio = 1.0f;
1903 : }
1904 683 : hMasa->data.prevq_lfeIndex = lfeToTotalEnergyRatioIndices[0]; /* Update to previous frame's index memories */
1905 : }
1906 : else /* Bitrate >= 16.4 kbps */
1907 : {
1908 : /* Do 1st stage scalar quantization */
1909 4757 : lfeToTotalEnergyRatioIndices[0] = 1;
1910 4757 : lfeToTotalEnergyRatioIndices[1] = usquant( log2LFEaverage, &xq, MCMASA_LFE_QLOW, MCMASA_LFE_DELTA, 8 );
1911 :
1912 4757 : if ( ivas_total_brate >= IVAS_24k4 ) /* Vector quantization is applied if bitrate >= 24.4 kbps */
1913 : {
1914 : /* Remove scalar value from the vector*/
1915 20455 : for ( i = 0; i < MAX_PARAM_SPATIAL_SUBFRAMES; i++ )
1916 : {
1917 16364 : log2LFEratio[i] -= xq;
1918 : }
1919 :
1920 : /* Vector quantize residual with energy adaptive bit allocation */
1921 4091 : switch ( lfeToTotalEnergyRatioIndices[1] )
1922 : {
1923 787 : case 0:
1924 : case 1:
1925 787 : VQLevels = 0;
1926 787 : lfeAdaptiveVQBits = 0;
1927 787 : break;
1928 395 : case 2:
1929 395 : VQLevels = 2;
1930 395 : lfeAdaptiveVQBits = 1;
1931 395 : break;
1932 281 : case 3:
1933 281 : VQLevels = 4;
1934 281 : lfeAdaptiveVQBits = 2;
1935 281 : break;
1936 542 : case 4:
1937 542 : VQLevels = 8;
1938 542 : lfeAdaptiveVQBits = 3;
1939 542 : break;
1940 2086 : default:
1941 2086 : VQLevels = 16;
1942 2086 : lfeAdaptiveVQBits = 4;
1943 : }
1944 :
1945 4091 : if ( VQLevels > 0 )
1946 : {
1947 3304 : lfeToTotalEnergyRatioIndices[2] = vquant( log2LFEratio, 0, xqv, McMASA_LFEGain_vectors, 4, VQLevels );
1948 : }
1949 : }
1950 : }
1951 : }
1952 :
1953 : /* Write first LFE bit */
1954 18130 : lfeBitsWritten = 0;
1955 18130 : push_next_indice( hMetaData, lfeToTotalEnergyRatioIndices[0], 1 );
1956 18130 : lfeBitsWritten += 1;
1957 :
1958 18130 : if ( lfeToTotalEnergyRatioIndices[0] == 1 && ivas_total_brate >= IVAS_16k4 )
1959 : {
1960 : /* If bitrate >= 16.4kbit/s, send 1-bit on/off + 3-bit scalar */
1961 4757 : push_next_indice( hMetaData, lfeToTotalEnergyRatioIndices[1], 3 );
1962 4757 : lfeBitsWritten += 3;
1963 :
1964 : /* If bitrate >= 24.4kbit/s, use adaptive 1 + (3.. 7) bit quantizer */
1965 4757 : if ( ivas_total_brate >= IVAS_24k4 )
1966 : {
1967 : /* Vector quantize residual with energy adaptive bit allocation */
1968 4091 : if ( lfeAdaptiveVQBits > 0 )
1969 : {
1970 3304 : push_next_indice( hMetaData, lfeToTotalEnergyRatioIndices[2], lfeAdaptiveVQBits );
1971 3304 : lfeBitsWritten += lfeAdaptiveVQBits;
1972 : }
1973 : }
1974 : }
1975 :
1976 18130 : return lfeBitsWritten;
1977 : }
1978 :
1979 :
1980 : /*-------------------------------------------------------------------*
1981 : * ivas_masa_enc_reconfigure()
1982 : *
1983 : * Reconfigure IVAS MASA encoder
1984 : *-------------------------------------------------------------------*/
1985 :
1986 69956 : void ivas_masa_enc_reconfigure(
1987 : Encoder_Struct *st_ivas /* i/o: IVAS encoder structure */
1988 : )
1989 : {
1990 : int16_t n, tmp;
1991 : int16_t sce_id, cpe_id;
1992 : int32_t ivas_total_brate;
1993 : int32_t ism_total_brate;
1994 :
1995 69956 : ivas_total_brate = st_ivas->hEncoderConfig->ivas_total_brate;
1996 :
1997 69956 : ism_total_brate = 0;
1998 69956 : if ( st_ivas->hEncoderConfig->ivas_format == MASA_ISM_FORMAT && st_ivas->nSCE > 0 && ( st_ivas->ism_mode == ISM_MASA_MODE_DISC || st_ivas->ism_mode == ISM_MASA_MODE_PARAM_ONE_OBJ || st_ivas->ism_mode == ISM_MASA_MODE_MASA_ONE_OBJ ) )
1999 : {
2000 0 : for ( sce_id = 0; sce_id < st_ivas->nSCE; sce_id++ )
2001 : {
2002 0 : ism_total_brate += st_ivas->hSCE[sce_id]->element_brate;
2003 : }
2004 : }
2005 :
2006 69956 : if ( ivas_total_brate != st_ivas->hEncoderConfig->last_ivas_total_brate )
2007 : {
2008 1974 : for ( sce_id = 0; sce_id < st_ivas->nSCE; sce_id++ )
2009 : {
2010 674 : copy_encoder_config( st_ivas, st_ivas->hSCE[sce_id]->hCoreCoder[0], 0 );
2011 674 : st_ivas->hSCE[sce_id]->element_brate = ivas_total_brate / st_ivas->nchan_transport;
2012 674 : st_ivas->hSCE[sce_id]->hCoreCoder[0]->total_brate = st_ivas->hSCE[sce_id]->element_brate; /* dummy initialization for getting right pointers initialization of input buffers in init_coder_ace_plus() */
2013 : }
2014 :
2015 1926 : for ( cpe_id = 0; cpe_id < st_ivas->nCPE; cpe_id++ )
2016 : {
2017 626 : st_ivas->hCPE[cpe_id]->element_brate = ( ivas_total_brate / st_ivas->nchan_transport ) * CPE_CHANNELS;
2018 :
2019 : /* prepare bitstream buffers */
2020 1878 : for ( n = 0; n < CPE_CHANNELS; n++ )
2021 : {
2022 1252 : copy_encoder_config( st_ivas, st_ivas->hCPE[cpe_id]->hCoreCoder[n], 0 );
2023 1252 : st_ivas->hCPE[cpe_id]->hCoreCoder[n]->total_brate = st_ivas->hCPE[cpe_id]->element_brate / ( st_ivas->nCPE > 1 ? 1 : CPE_CHANNELS ); /* dummy initialization for getting right pointers initialization of input buffers in init_coder_ace_plus() */
2024 : }
2025 :
2026 626 : if ( ivas_total_brate - ism_total_brate < MIN_BRATE_MDCT_STEREO )
2027 : {
2028 226 : st_ivas->hCPE[cpe_id]->element_mode = IVAS_CPE_DFT;
2029 : }
2030 : else
2031 : {
2032 400 : st_ivas->hCPE[cpe_id]->element_mode = IVAS_CPE_MDCT;
2033 : }
2034 : }
2035 :
2036 1300 : ivas_masa_set_elements( ivas_total_brate, st_ivas->mc_mode, st_ivas->nchan_transport, st_ivas->hQMetaData, &tmp, &tmp, &tmp, st_ivas->hEncoderConfig->ivas_format, st_ivas->ism_mode, ism_total_brate );
2037 : }
2038 :
2039 69956 : return;
2040 : }
2041 :
2042 :
2043 : /*-------------------------------------------------------------------*
2044 : * average_masa_metadata()
2045 : *
2046 : * Average MASA metadata frame subframe contents: applies aggregation over time
2047 : *-------------------------------------------------------------------*/
2048 :
2049 0 : static void average_masa_metadata(
2050 : MASA_METADATA_FRAME *hMeta,
2051 : float energy[MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS],
2052 : const SPHERICAL_GRID_DATA *Sph_Grid16,
2053 : const uint8_t useSphGrid )
2054 : {
2055 : int16_t i, j, k;
2056 : float azi_rad, ele_rad;
2057 : uint8_t numDirections;
2058 :
2059 : /* use the nominal values without data-adaptivity */
2060 0 : numDirections = hMeta->descriptive_meta.numberOfDirections + 1;
2061 :
2062 : /* azi/ele/nrg into vectors for each sub-frame and band */
2063 0 : for ( i = 0; i < numDirections; i++ )
2064 : {
2065 0 : for ( k = 0; k < MASA_FREQUENCY_BANDS; k++ )
2066 : {
2067 : float x_sum, y_sum, z_sum, energy_sum, vec_len, spread_coh_sum, surr_coh_sum;
2068 :
2069 0 : x_sum = 0.0f;
2070 0 : y_sum = 0.0f;
2071 0 : z_sum = 0.0f;
2072 0 : energy_sum = 0.0f;
2073 0 : spread_coh_sum = 0.0f;
2074 0 : surr_coh_sum = 0.0f;
2075 0 : for ( j = 0; j < MAX_PARAM_SPATIAL_SUBFRAMES; j++ )
2076 : {
2077 0 : azi_rad = hMeta->directional_meta[i].azimuth[j][k] / 180.0f * EVS_PI;
2078 0 : ele_rad = hMeta->directional_meta[i].elevation[j][k] / 180.0f * EVS_PI;
2079 0 : vec_len = hMeta->directional_meta[i].energy_ratio[j][k] * energy[j][k];
2080 :
2081 : /* energy-weighted sum over subframes */
2082 0 : x_sum += cosf( azi_rad ) * cosf( ele_rad ) * vec_len;
2083 0 : y_sum += sinf( azi_rad ) * cosf( ele_rad ) * vec_len;
2084 0 : z_sum += sinf( ele_rad ) * vec_len;
2085 :
2086 0 : energy_sum += energy[j][k];
2087 :
2088 0 : spread_coh_sum += hMeta->directional_meta[i].spread_coherence[j][k] * energy[j][k];
2089 0 : if ( i == 0 )
2090 : {
2091 : /* this is in common metadata and not in each direction */
2092 0 : surr_coh_sum += hMeta->common_meta.surround_coherence[j][k] * energy[j][k];
2093 : }
2094 : }
2095 :
2096 : /* the data from the combined sub-frames is written into the first sub-frame band */
2097 0 : j = 0;
2098 0 : hMeta->directional_meta[i].azimuth[j][k] = atan2f( y_sum, x_sum ) / EVS_PI * 180.0f;
2099 0 : hMeta->directional_meta[i].elevation[j][k] = atan2f( z_sum, sqrtf( x_sum * x_sum + y_sum * y_sum ) ) / EVS_PI * 180.0f;
2100 0 : if ( useSphGrid == TRUE )
2101 : {
2102 0 : hMeta->directional_meta[i].spherical_index[j][k] = index_theta_phi_16( &( hMeta->directional_meta[i].elevation[j][k] ),
2103 0 : &( hMeta->directional_meta[i].azimuth[j][k] ), Sph_Grid16 );
2104 : }
2105 0 : vec_len = sqrtf( x_sum * x_sum + y_sum * y_sum + z_sum * z_sum );
2106 0 : hMeta->directional_meta[i].energy_ratio[j][k] = vec_len / ( energy_sum + EPSILON );
2107 :
2108 0 : hMeta->directional_meta[i].spread_coherence[j][k] = spread_coh_sum / ( energy_sum + EPSILON );
2109 0 : if ( i == 0 )
2110 : {
2111 0 : hMeta->common_meta.surround_coherence[j][k] = surr_coh_sum / ( energy_sum + EPSILON );
2112 : }
2113 :
2114 : /* copy the same value to all subframes */
2115 0 : for ( j = 1; j < MAX_PARAM_SPATIAL_SUBFRAMES; j++ )
2116 : {
2117 0 : hMeta->directional_meta[i].azimuth[j][k] = hMeta->directional_meta[i].azimuth[0][k];
2118 0 : hMeta->directional_meta[i].elevation[j][k] = hMeta->directional_meta[i].elevation[0][k];
2119 0 : hMeta->directional_meta[i].energy_ratio[j][k] = hMeta->directional_meta[i].energy_ratio[0][k];
2120 0 : hMeta->directional_meta[i].spread_coherence[j][k] = hMeta->directional_meta[i].spread_coherence[0][k];
2121 0 : if ( i == 0 )
2122 : {
2123 0 : hMeta->common_meta.surround_coherence[j][k] = hMeta->common_meta.surround_coherence[0][k];
2124 : }
2125 : }
2126 : }
2127 : }
2128 :
2129 0 : for ( k = 0; k < MASA_FREQUENCY_BANDS; k++ )
2130 : {
2131 0 : for ( j = 0; j < MAX_PARAM_SPATIAL_SUBFRAMES; j++ )
2132 : {
2133 0 : if ( numDirections == 2 )
2134 : {
2135 0 : hMeta->common_meta.diffuse_to_total_ratio[j][k] = max( 0.0f, 1.0f - hMeta->directional_meta[1].energy_ratio[j][k] - hMeta->directional_meta[0].energy_ratio[j][k] );
2136 : }
2137 : else
2138 : {
2139 0 : hMeta->common_meta.diffuse_to_total_ratio[j][k] = max( 0.0f, 1.0f - hMeta->directional_meta[0].energy_ratio[j][k] );
2140 : }
2141 0 : hMeta->common_meta.remainder_to_total_ratio[j][k] = 0.0f;
2142 : }
2143 : }
2144 :
2145 0 : return;
2146 : }
2147 :
2148 :
2149 : /*-------------------------------------------------------------------*
2150 : * copy_masa_metadata_subframe()
2151 : *
2152 : * Copy MASA metadata frame subframe contents
2153 : *-------------------------------------------------------------------*/
2154 :
2155 617384 : static void copy_masa_metadata_subframe(
2156 : const MASA_METADATA_HANDLE hMetaFrom, /* i : MASA frame metdata to be copied */
2157 : const uint8_t sfFrom, /* i : subframe index of the copy source */
2158 : MASA_METADATA_HANDLE hMetaTo, /* o : MASA frame metadata copy destination */
2159 : const uint8_t sfTo /* i : subframe index of the copy target */
2160 : )
2161 : {
2162 : uint8_t dir;
2163 : uint8_t band;
2164 :
2165 : /* directional metadata */
2166 1852152 : for ( dir = 0; dir < MASA_MAXIMUM_DIRECTIONS; dir++ )
2167 : {
2168 30869200 : for ( band = 0; band < MASA_FREQUENCY_BANDS; band++ )
2169 : {
2170 29634432 : hMetaTo->directional_meta[dir].spherical_index[sfTo][band] = hMetaFrom->directional_meta[dir].spherical_index[sfFrom][band];
2171 : }
2172 1234768 : mvr2r( hMetaFrom->directional_meta[dir].azimuth[sfFrom], hMetaTo->directional_meta[dir].azimuth[sfTo], MASA_FREQUENCY_BANDS );
2173 1234768 : mvr2r( hMetaFrom->directional_meta[dir].elevation[sfFrom], hMetaTo->directional_meta[dir].elevation[sfTo], MASA_FREQUENCY_BANDS );
2174 1234768 : mvr2r( hMetaFrom->directional_meta[dir].energy_ratio[sfFrom], hMetaTo->directional_meta[dir].energy_ratio[sfTo], MASA_FREQUENCY_BANDS );
2175 1234768 : mvr2r( hMetaFrom->directional_meta[dir].spread_coherence[sfFrom], hMetaTo->directional_meta[dir].spread_coherence[sfTo], MASA_FREQUENCY_BANDS );
2176 : }
2177 :
2178 : /* common metadata */
2179 617384 : mvr2r( hMetaFrom->common_meta.diffuse_to_total_ratio[sfFrom], hMetaTo->common_meta.diffuse_to_total_ratio[sfTo], MASA_FREQUENCY_BANDS );
2180 617384 : mvr2r( hMetaFrom->common_meta.surround_coherence[sfFrom], hMetaTo->common_meta.surround_coherence[sfTo], MASA_FREQUENCY_BANDS );
2181 617384 : mvr2r( hMetaFrom->common_meta.remainder_to_total_ratio[sfFrom], hMetaTo->common_meta.remainder_to_total_ratio[sfTo], MASA_FREQUENCY_BANDS );
2182 :
2183 617384 : return;
2184 : }
2185 :
2186 :
2187 : /*-------------------------------------------------------------------*
2188 : * copy_masa_metadata()
2189 : *
2190 : * Copy MASA metada frame contents
2191 : *-------------------------------------------------------------------*/
2192 :
2193 154346 : static void copy_masa_metadata(
2194 : const MASA_METADATA_HANDLE hMetaFrom, /* i : MASA frame metadata to be copied */
2195 : MASA_METADATA_HANDLE hMetaTo /* o : MASA frame metadata copy destination */
2196 : )
2197 : {
2198 : uint8_t sf, byte_idx;
2199 :
2200 : /* descriptive metadata */
2201 1389114 : for ( byte_idx = 0; byte_idx < 8; byte_idx++ )
2202 : {
2203 1234768 : hMetaTo->descriptive_meta.formatDescriptor[byte_idx] = hMetaFrom->descriptive_meta.formatDescriptor[byte_idx];
2204 : }
2205 :
2206 154346 : hMetaTo->descriptive_meta.numberOfDirections = hMetaFrom->descriptive_meta.numberOfDirections;
2207 154346 : hMetaTo->descriptive_meta.numberOfChannels = hMetaFrom->descriptive_meta.numberOfChannels;
2208 154346 : hMetaTo->descriptive_meta.sourceFormat = hMetaFrom->descriptive_meta.sourceFormat;
2209 154346 : hMetaTo->descriptive_meta.transportDefinition = hMetaFrom->descriptive_meta.transportDefinition;
2210 154346 : hMetaTo->descriptive_meta.channelAngle = hMetaFrom->descriptive_meta.channelAngle;
2211 154346 : hMetaTo->descriptive_meta.channelDistance = hMetaFrom->descriptive_meta.channelDistance;
2212 154346 : hMetaTo->descriptive_meta.channelLayout = hMetaFrom->descriptive_meta.channelLayout;
2213 :
2214 : /* directional and common metadata */
2215 771730 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
2216 : {
2217 617384 : copy_masa_metadata_subframe( hMetaFrom, sf, hMetaTo, sf );
2218 : }
2219 :
2220 154346 : return;
2221 : }
2222 :
2223 :
2224 : /*-------------------------------------------------------------------*
2225 : * are_masa_subframes_similar()
2226 : *
2227 : * Compare the similarity of MASA metadata in two sub-frames
2228 : *-------------------------------------------------------------------*/
2229 :
2230 : /* r: similarity decision */
2231 635285 : static uint8_t are_masa_subframes_similar(
2232 : const MASA_METADATA_HANDLE frame1, /* i : MASA metadata frame 1 */
2233 : const uint8_t sf1_idx, /* i : index of the subframe of frame1 to inspect */
2234 : const MASA_METADATA_HANDLE frame2, /* i : MASA metadata frame 2 */
2235 : const uint8_t sf2_idx /* i : index of the subframe of frame2 to inspect */
2236 : )
2237 : {
2238 : uint8_t num_dir;
2239 : uint8_t dir;
2240 : uint8_t band_idx;
2241 : uint8_t sf_differ;
2242 :
2243 635285 : num_dir = frame1->descriptive_meta.numberOfDirections;
2244 635285 : dir = 0;
2245 635285 : band_idx = 0;
2246 635285 : sf_differ = FALSE;
2247 :
2248 635285 : if ( num_dir != frame2->descriptive_meta.numberOfDirections )
2249 : {
2250 0 : sf_differ = TRUE;
2251 : }
2252 : else
2253 : {
2254 : /* check per-direction metadata */
2255 635285 : dir = 0;
2256 635285 : band_idx = 0;
2257 :
2258 1286770 : while ( ( sf_differ == FALSE ) && ( dir <= num_dir ) )
2259 : {
2260 651485 : band_idx = 0;
2261 1969085 : while ( ( sf_differ == FALSE ) && ( band_idx < MASA_FREQUENCY_BANDS ) )
2262 : {
2263 : float azi_dif;
2264 1914185 : azi_dif = fabsf( frame1->directional_meta[dir].azimuth[sf1_idx][band_idx] - frame2->directional_meta[dir].azimuth[sf2_idx][band_idx] );
2265 1914185 : azi_dif = azi_dif > 180.0f ? 360.0f - azi_dif : azi_dif;
2266 :
2267 1914185 : if ( azi_dif > MASA_ANGLE_TOLERANCE )
2268 : {
2269 582030 : sf_differ = TRUE;
2270 582030 : break;
2271 : }
2272 :
2273 1332155 : if ( fabsf( frame1->directional_meta[dir].elevation[sf1_idx][band_idx] - frame2->directional_meta[dir].elevation[sf2_idx][band_idx] ) > MASA_ANGLE_TOLERANCE )
2274 : {
2275 14536 : sf_differ = TRUE;
2276 14536 : break;
2277 : }
2278 :
2279 1317619 : if ( fabsf( frame1->directional_meta[dir].energy_ratio[sf1_idx][band_idx] - frame2->directional_meta[dir].energy_ratio[sf2_idx][band_idx] ) > MASA_RATIO_TOLERANCE )
2280 : {
2281 19 : sf_differ = TRUE;
2282 19 : break;
2283 : }
2284 :
2285 1317600 : if ( fabsf( frame1->directional_meta[dir].spread_coherence[sf1_idx][band_idx] - frame2->directional_meta[dir].spread_coherence[sf2_idx][band_idx] ) > MASA_COHERENCE_TOLERANCE )
2286 : {
2287 0 : sf_differ = TRUE;
2288 0 : break;
2289 : }
2290 :
2291 1317600 : band_idx++;
2292 : }
2293 651485 : dir++;
2294 : }
2295 :
2296 : /* check the common metadata */
2297 635285 : while ( ( sf_differ == FALSE ) && ( band_idx < MASA_FREQUENCY_BANDS ) )
2298 : {
2299 0 : if ( fabsf( frame1->common_meta.surround_coherence[sf1_idx][band_idx] - frame2->common_meta.surround_coherence[sf2_idx][band_idx] ) > MASA_COHERENCE_TOLERANCE )
2300 : {
2301 0 : sf_differ = TRUE;
2302 0 : break;
2303 : }
2304 :
2305 0 : band_idx++;
2306 : }
2307 : }
2308 :
2309 635285 : if ( sf_differ )
2310 : {
2311 596585 : return FALSE;
2312 : }
2313 : else
2314 : {
2315 38700 : return TRUE;
2316 : }
2317 : }
2318 :
2319 :
2320 : /*-------------------------------------------------------------------*
2321 : * detect_framing_async()
2322 : *
2323 : * Compare the similarity of MASA metadata in two sub-frames
2324 : * Analysis result is stored in hMasa->data.sync_state, and
2325 : * potentially hMasa->masaMetadata is modified
2326 : *-------------------------------------------------------------------*/
2327 :
2328 154346 : static void detect_framing_async(
2329 : MASA_ENCODER_HANDLE hMasa /* i/o: MASA encoder structure */
2330 : )
2331 : {
2332 : MASA_METADATA_HANDLE current_meta;
2333 : MASA_METADATA_HANDLE previous_meta;
2334 : MASA_SYNC_HANDLE sync_state;
2335 : MASA_FRAME_MODE frame_mode;
2336 : uint8_t n_sim_start, n_sim_stop, sf_idx;
2337 : uint8_t found_offset;
2338 :
2339 154346 : current_meta = &( hMasa->masaMetadata ); /* metadata from current frame */
2340 154346 : sync_state = &( hMasa->data.sync_state ); /* synchronization structure */
2341 154346 : previous_meta = &( sync_state->previous_metadata );
2342 :
2343 : /* check current frame, how many are similar from the start and from the end */
2344 154346 : n_sim_start = 1;
2345 173696 : for ( sf_idx = n_sim_start; sf_idx < MAX_PARAM_SPATIAL_SUBFRAMES; sf_idx++ )
2346 : {
2347 167246 : if ( are_masa_subframes_similar( current_meta, 0, current_meta, sf_idx ) == TRUE )
2348 : {
2349 19350 : n_sim_start = sf_idx + 1;
2350 : }
2351 : else
2352 : {
2353 147896 : break;
2354 : }
2355 : }
2356 :
2357 : /* number of similar sub-frames starting from the end of the frame */
2358 154346 : if ( n_sim_start == MAX_PARAM_SPATIAL_SUBFRAMES ) /* shortcut */
2359 : {
2360 6450 : n_sim_stop = n_sim_start;
2361 : }
2362 : else
2363 : {
2364 147896 : n_sim_stop = 1;
2365 147896 : for ( sf_idx = 2; sf_idx < MAX_PARAM_SPATIAL_SUBFRAMES; sf_idx++ )
2366 : {
2367 : /* we need to check only the two middle sub-frames, as all being the same would have taken the shortcut above */
2368 147896 : if ( are_masa_subframes_similar( current_meta, MAX_PARAM_SPATIAL_SUBFRAMES - 1, current_meta, MAX_PARAM_SPATIAL_SUBFRAMES - sf_idx ) == TRUE )
2369 : {
2370 0 : n_sim_stop = sf_idx;
2371 : }
2372 : else
2373 : {
2374 147896 : break;
2375 : }
2376 : }
2377 : }
2378 :
2379 154346 : frame_mode = MASA_FRAME_4SF; /* default mode: 4sf */
2380 154346 : if ( sync_state->prev_offset > MAX_PARAM_SPATIAL_SUBFRAMES - 2 )
2381 : {
2382 : /* earlier offset was large => reset the offset */
2383 0 : found_offset = 0;
2384 : }
2385 : else
2386 : {
2387 : /* keep previous offset unless something else is found. alternatively, we could reset always */
2388 154346 : found_offset = sync_state->prev_offset;
2389 : }
2390 :
2391 154346 : if ( ( n_sim_start == MAX_PARAM_SPATIAL_SUBFRAMES ) && ( n_sim_stop == MAX_PARAM_SPATIAL_SUBFRAMES ) )
2392 : {
2393 : /* full frame consists of similar sub-frames */
2394 6450 : frame_mode = MASA_FRAME_1SF;
2395 6450 : if ( ( sync_state->prev_sim_stop != 0 ) && ( are_masa_subframes_similar( current_meta, 0, previous_meta, MAX_PARAM_SPATIAL_SUBFRAMES - 1 ) == TRUE ) )
2396 : {
2397 : /* > 4 sub-frames of similar data */
2398 0 : if ( sync_state->prev_sim_stop < 3 )
2399 : {
2400 : /* can nicely align the framing with the earlier data and a small offset */
2401 0 : found_offset = sync_state->prev_sim_stop;
2402 : }
2403 : else
2404 : {
2405 : /* too many similar sub-frames to determine the offset accurately => keep earlier value */
2406 0 : found_offset = sync_state->prev_offset;
2407 : }
2408 : }
2409 : else
2410 : {
2411 : /* earlier window was different => reset the offset */
2412 6450 : found_offset = 0;
2413 : }
2414 : }
2415 147896 : else if ( n_sim_stop == 3 )
2416 : {
2417 : /* first sub-frame different that the rest 3
2418 : => make a risky guess that the future sf would be the same too and we're in an offset case */
2419 0 : frame_mode = MASA_FRAME_1SF;
2420 0 : found_offset = 3;
2421 : }
2422 147896 : else if ( ( sync_state->prev_sim_stop > 0 ) && ( are_masa_subframes_similar( current_meta, 0, previous_meta, MAX_PARAM_SPATIAL_SUBFRAMES - 1 ) == TRUE ) )
2423 : {
2424 : /* seeing data similar to past */
2425 0 : if ( ( n_sim_start > 1 ) && ( n_sim_start + sync_state->prev_sim_stop >= MAX_PARAM_SPATIAL_SUBFRAMES ) )
2426 : {
2427 : /* with the past, would have at least one long frame similar subframes */
2428 0 : frame_mode = MASA_FRAME_1SF;
2429 :
2430 0 : if ( sync_state->prev_offset == 0 )
2431 : {
2432 0 : found_offset = min( 2, sync_state->prev_sim_stop );
2433 : }
2434 : else
2435 : {
2436 0 : found_offset = sync_state->prev_offset;
2437 : }
2438 : }
2439 : }
2440 :
2441 : /* keep the original contents of the frame, but then perform interpolation later */
2442 : /* just copy current frame to storage */
2443 154346 : copy_masa_metadata( current_meta, previous_meta );
2444 :
2445 154346 : sync_state->prev_sim_stop = n_sim_stop;
2446 154346 : sync_state->prev_offset = found_offset;
2447 154346 : sync_state->frame_mode = frame_mode;
2448 :
2449 154346 : return;
2450 : }
2451 :
2452 :
2453 : /*-------------------------------------------------------------------*
2454 : * masa_metadata_direction_alignment()
2455 : *
2456 : * In 2dir MASA metadata, determine the ordering of the directional
2457 : * fields such that the azi/ele change across time is minimized.
2458 : *-------------------------------------------------------------------*/
2459 :
2460 154346 : static void masa_metadata_direction_alignment(
2461 : MASA_ENCODER_HANDLE hMasa /* i/o: MASA encoder handle */
2462 : )
2463 : {
2464 : uint8_t band, n_dirs;
2465 : MASA_DIR_ALIGN_HANDLE hAlignState;
2466 : MASA_METADATA_HANDLE hMeta;
2467 :
2468 154346 : hAlignState = &( hMasa->data.dir_align_state );
2469 154346 : hMeta = &( hMasa->masaMetadata );
2470 :
2471 154346 : n_dirs = hMeta->descriptive_meta.numberOfDirections + 1; /* 1-based */
2472 3858650 : for ( band = 0; band < MASA_FREQUENCY_BANDS; band++ )
2473 : {
2474 : uint8_t sf;
2475 : float diff_swap, diff_no_swap;
2476 :
2477 : /* trade 2*(cos+sin) against storing the values between frames */
2478 : float prev_ele_dir1_sin, prev_ele_dir2_sin;
2479 : float prev_ele_dir1_cos, prev_ele_dir2_cos;
2480 :
2481 3704304 : prev_ele_dir1_sin = sinf( hAlignState->previous_ele_dir1[band] );
2482 3704304 : prev_ele_dir2_sin = sinf( hAlignState->previous_ele_dir2[band] );
2483 :
2484 3704304 : prev_ele_dir1_cos = cosf( hAlignState->previous_ele_dir1[band] );
2485 3704304 : prev_ele_dir2_cos = cosf( hAlignState->previous_ele_dir2[band] );
2486 :
2487 18521520 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
2488 : {
2489 : float azi_rad1, ele_rad1;
2490 : float azi_rad2, ele_rad2;
2491 : float cos_ele1, cos_ele2;
2492 : float sin_ele1, sin_ele2;
2493 :
2494 14817216 : azi_rad1 = hMeta->directional_meta[0].azimuth[sf][band] * PI_OVER_180;
2495 14817216 : ele_rad1 = hMeta->directional_meta[0].elevation[sf][band] * PI_OVER_180;
2496 :
2497 14817216 : if ( n_dirs > 1 )
2498 : {
2499 5431680 : azi_rad2 = hMeta->directional_meta[1].azimuth[sf][band] * PI_OVER_180;
2500 5431680 : ele_rad2 = hMeta->directional_meta[1].elevation[sf][band] * PI_OVER_180;
2501 :
2502 : /* quick checks to detect constant data and earlier flip */
2503 5431680 : if ( fabsf( azi_rad1 - hAlignState->previous_azi_dir1[band] ) < EPSILON &&
2504 159578 : fabsf( azi_rad2 - hAlignState->previous_azi_dir2[band] ) < EPSILON &&
2505 137700 : fabsf( ele_rad1 - hAlignState->previous_ele_dir1[band] ) < EPSILON &&
2506 137700 : fabsf( ele_rad2 - hAlignState->previous_ele_dir2[band] ) < EPSILON )
2507 : {
2508 137700 : diff_swap = 1.0f;
2509 137700 : diff_no_swap = 0.0f;
2510 : /* cached values that will be used for the short-cuts and over-written by the real computations, if done */
2511 137700 : sin_ele1 = prev_ele_dir1_sin;
2512 137700 : sin_ele2 = prev_ele_dir2_sin;
2513 137700 : cos_ele1 = prev_ele_dir1_cos;
2514 137700 : cos_ele2 = prev_ele_dir2_cos;
2515 : }
2516 5293980 : else if ( fabsf( azi_rad1 - hAlignState->previous_azi_dir2[band] ) < EPSILON &&
2517 58884 : fabsf( azi_rad2 - hAlignState->previous_azi_dir1[band] ) < EPSILON &&
2518 56700 : fabsf( ele_rad1 - hAlignState->previous_ele_dir2[band] ) < EPSILON &&
2519 56700 : fabsf( ele_rad2 - hAlignState->previous_ele_dir1[band] ) < EPSILON )
2520 : {
2521 56700 : diff_swap = 0.0f;
2522 56700 : diff_no_swap = 1.0f;
2523 : /* cached values that will be used for the short-cuts and over-written by the real computations, if done */
2524 56700 : sin_ele1 = prev_ele_dir2_sin;
2525 56700 : sin_ele2 = prev_ele_dir1_sin;
2526 56700 : cos_ele1 = prev_ele_dir2_cos;
2527 56700 : cos_ele2 = prev_ele_dir1_cos;
2528 : }
2529 : else
2530 : {
2531 : /* angular distance of the two vectors */
2532 : /* pre-compute values for re-use */
2533 5237280 : sin_ele1 = sinf( ele_rad1 );
2534 5237280 : sin_ele2 = sinf( ele_rad2 );
2535 :
2536 5237280 : cos_ele1 = cosf( ele_rad1 );
2537 5237280 : cos_ele2 = cosf( ele_rad2 );
2538 :
2539 5237280 : diff_no_swap = acosf( cos_ele1 * prev_ele_dir1_cos * cosf( azi_rad1 - hAlignState->previous_azi_dir1[band] ) + sin_ele1 * prev_ele_dir1_sin ) +
2540 5237280 : acosf( cos_ele2 * prev_ele_dir2_cos * cosf( azi_rad2 - hAlignState->previous_azi_dir2[band] ) + sin_ele2 * prev_ele_dir2_sin );
2541 :
2542 5237280 : diff_swap = acosf( cos_ele1 * prev_ele_dir2_cos * cosf( azi_rad1 - hAlignState->previous_azi_dir2[band] ) + sin_ele1 * prev_ele_dir2_sin ) +
2543 5237280 : acosf( cos_ele2 * prev_ele_dir1_cos * cosf( azi_rad2 - hAlignState->previous_azi_dir1[band] ) + sin_ele2 * prev_ele_dir1_sin );
2544 : }
2545 : }
2546 : else
2547 : {
2548 : /* 1dir */
2549 9385536 : sin_ele1 = sinf( ele_rad1 );
2550 9385536 : cos_ele1 = cosf( ele_rad1 );
2551 :
2552 9385536 : azi_rad2 = 0.0f;
2553 9385536 : ele_rad2 = 0.0f;
2554 :
2555 9385536 : sin_ele2 = 0.0f; /* sin(0) */
2556 9385536 : cos_ele2 = 1.0f; /* cos(0) */
2557 :
2558 9385536 : diff_swap = 1.0f;
2559 9385536 : diff_no_swap = 0.0f;
2560 : }
2561 :
2562 14817216 : if ( n_dirs > 1 && diff_no_swap > diff_swap )
2563 440472 : {
2564 : /* swap the metadata of the two directions in this TF-tile */
2565 : float tmp_val;
2566 : uint16_t tmp_int_val;
2567 440472 : tmp_val = hMeta->directional_meta[0].azimuth[sf][band];
2568 440472 : hMeta->directional_meta[0].azimuth[sf][band] = hMeta->directional_meta[1].azimuth[sf][band];
2569 440472 : hMeta->directional_meta[1].azimuth[sf][band] = tmp_val;
2570 :
2571 440472 : tmp_val = hMeta->directional_meta[0].elevation[sf][band];
2572 440472 : hMeta->directional_meta[0].elevation[sf][band] = hMeta->directional_meta[1].elevation[sf][band];
2573 440472 : hMeta->directional_meta[1].elevation[sf][band] = tmp_val;
2574 440472 : tmp_int_val = hMeta->directional_meta[0].spherical_index[sf][band];
2575 440472 : hMeta->directional_meta[0].spherical_index[sf][band] = hMeta->directional_meta[1].spherical_index[sf][band];
2576 440472 : hMeta->directional_meta[1].spherical_index[sf][band] = tmp_int_val;
2577 440472 : tmp_val = hMeta->directional_meta[0].energy_ratio[sf][band];
2578 440472 : hMeta->directional_meta[0].energy_ratio[sf][band] = hMeta->directional_meta[1].energy_ratio[sf][band];
2579 440472 : hMeta->directional_meta[1].energy_ratio[sf][band] = tmp_val;
2580 :
2581 440472 : tmp_val = hMeta->directional_meta[0].spread_coherence[sf][band];
2582 440472 : hMeta->directional_meta[0].spread_coherence[sf][band] = hMeta->directional_meta[1].spread_coherence[sf][band];
2583 440472 : hMeta->directional_meta[1].spread_coherence[sf][band] = tmp_val;
2584 :
2585 440472 : hAlignState->previous_azi_dir1[band] = azi_rad2;
2586 440472 : hAlignState->previous_ele_dir1[band] = ele_rad2;
2587 :
2588 440472 : hAlignState->previous_azi_dir2[band] = azi_rad1;
2589 440472 : hAlignState->previous_ele_dir2[band] = ele_rad1;
2590 :
2591 440472 : prev_ele_dir1_cos = cos_ele2;
2592 440472 : prev_ele_dir1_sin = sin_ele2;
2593 :
2594 440472 : prev_ele_dir2_cos = cos_ele1;
2595 440472 : prev_ele_dir2_sin = sin_ele1;
2596 : }
2597 : else
2598 : {
2599 14376744 : hAlignState->previous_azi_dir1[band] = azi_rad1;
2600 14376744 : hAlignState->previous_ele_dir1[band] = ele_rad1;
2601 :
2602 14376744 : hAlignState->previous_azi_dir2[band] = azi_rad2;
2603 14376744 : hAlignState->previous_ele_dir2[band] = ele_rad2;
2604 :
2605 14376744 : prev_ele_dir1_cos = cos_ele1;
2606 14376744 : prev_ele_dir1_sin = sin_ele1;
2607 :
2608 14376744 : prev_ele_dir2_cos = cos_ele2;
2609 14376744 : prev_ele_dir2_sin = sin_ele2;
2610 : }
2611 : } /* sf */
2612 : } /* band */
2613 :
2614 154346 : return;
2615 : }
2616 :
2617 :
2618 : /*-------------------------------------------------------------------*
2619 : * ivas_merge_masa_metadata()
2620 : *
2621 : *
2622 : *-------------------------------------------------------------------*/
2623 :
2624 30620 : void ivas_merge_masa_metadata(
2625 : MASA_ENCODER_HANDLE hMasa, /* i/o: MASA enc handle. source for MASA metadata and combined metadata will be here */
2626 : OMASA_SPATIAL_META_HANDLE hOMasaMeta /* i : ISM-object metadata to be merged with the MASA metadata */
2627 : )
2628 : {
2629 : int16_t sf, band;
2630 : uint8_t numCodingBands;
2631 : uint8_t numDirections;
2632 : uint8_t numSf;
2633 : MASA_METADATA_HANDLE hMeta;
2634 : float energyTimesRatioISM;
2635 : float energyTimesRatioMASA[2];
2636 : float total_diff_nrg;
2637 : float eneBand;
2638 : float energyMerged[MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS];
2639 30620 : OMASA_ENCODER_ENERGY_HANDLE hOmasaEnergy = hMasa->data.hOmasaData->hOmasaEnergy;
2640 :
2641 30620 : numCodingBands = hMasa->config.numCodingBands;
2642 30620 : numDirections = hMasa->config.numberOfDirections;
2643 30620 : numSf = hMasa->config.joinedSubframes == TRUE ? 1 : MAX_PARAM_SPATIAL_SUBFRAMES;
2644 30620 : hMeta = &( hMasa->masaMetadata );
2645 :
2646 153100 : for ( sf = 0; sf < numSf; sf++ )
2647 : {
2648 3025200 : for ( band = 0; band < numCodingBands; band++ )
2649 : {
2650 : int16_t merge_dest;
2651 : float dir_sum;
2652 : uint8_t band_n_dirs;
2653 2902720 : if ( numDirections == 1 || ( numDirections == 2 && hMasa->data.twoDirBands[band] == 0 ) )
2654 : {
2655 2902720 : band_n_dirs = 1;
2656 : }
2657 : else
2658 : {
2659 0 : band_n_dirs = 2;
2660 : }
2661 :
2662 : /* Compute energies */
2663 2902720 : eneBand = hMasa->data.energy[sf][band];
2664 2902720 : energyMerged[sf][band] = eneBand + hOmasaEnergy->energy_ism[sf][band];
2665 :
2666 : /* Compute weights */
2667 2902720 : energyTimesRatioMASA[0] = eneBand * hMeta->directional_meta[0].energy_ratio[sf][band];
2668 2902720 : if ( band_n_dirs == 2 )
2669 : {
2670 0 : energyTimesRatioMASA[1] = eneBand * hMeta->directional_meta[1].energy_ratio[sf][band];
2671 : }
2672 : else
2673 : {
2674 2902720 : energyTimesRatioMASA[1] = 0.0f;
2675 : }
2676 :
2677 : /* target is original MASA diffuseness */
2678 2902720 : total_diff_nrg = eneBand * hMeta->common_meta.diffuse_to_total_ratio[sf][band];
2679 :
2680 : /* criterion is mean of ISM ratio and new ratio */
2681 2902720 : energyTimesRatioISM = ( hOMasaMeta->directional_meta[0].energy_ratio[sf][band] + ( 1.0f - total_diff_nrg / ( EPSILON + eneBand + hOmasaEnergy->energy_ism[sf][band] ) ) ) / 2.0f * hMasa->data.hOmasaData->hOmasaEnergy->energy_ism[sf][band];
2682 :
2683 : /* Determine combined metadata based on the weights */
2684 2902720 : merge_dest = -1;
2685 2902720 : if ( ( band_n_dirs == 1 && energyTimesRatioMASA[0] < energyTimesRatioISM ) ||
2686 0 : ( band_n_dirs == 2 && energyTimesRatioMASA[0] < energyTimesRatioMASA[1] && energyTimesRatioMASA[0] < energyTimesRatioISM ) )
2687 : {
2688 : /* 1dir and ISM the most energetic, or 2dir and ISM the more energetic than MASA1 */
2689 1288164 : merge_dest = 0;
2690 : }
2691 1614556 : else if ( band_n_dirs == 2 && energyTimesRatioMASA[1] <= energyTimesRatioMASA[0] && energyTimesRatioMASA[1] < energyTimesRatioISM )
2692 : {
2693 : /* 2dir and ISM the most energetic and MASA2 the least energetic */
2694 0 : merge_dest = 1;
2695 : }
2696 :
2697 2902720 : if ( merge_dest >= 0 ) /* replace one MASA with ISM */
2698 : {
2699 1288164 : hMeta->directional_meta[merge_dest].azimuth[sf][band] = hOMasaMeta->directional_meta[0].azimuth[sf][band];
2700 1288164 : hMeta->directional_meta[merge_dest].elevation[sf][band] = hOMasaMeta->directional_meta[0].elevation[sf][band];
2701 :
2702 : /* limit with the earlier direct-energy ratio */
2703 1288164 : dir_sum = 1.0f - total_diff_nrg / ( EPSILON + eneBand + hOmasaEnergy->energy_ism[sf][band] ); /* new dir ratio */
2704 1288164 : hMeta->directional_meta[merge_dest].energy_ratio[sf][band] = min( dir_sum, hOMasaMeta->directional_meta[0].energy_ratio[sf][band] ); /* clip with original ISM dir */
2705 1288164 : hMeta->common_meta.diffuse_to_total_ratio[sf][band] = 1.0f - hMeta->directional_meta[merge_dest].energy_ratio[sf][band];
2706 :
2707 1288164 : if ( hMasa->config.useCoherence )
2708 : {
2709 0 : hMeta->directional_meta[merge_dest].spread_coherence[sf][band] = hOMasaMeta->directional_meta[0].spread_coherence[sf][band];
2710 0 : hMeta->common_meta.surround_coherence[sf][band] = hOMasaMeta->common_meta.surround_coherence[sf][band];
2711 : }
2712 :
2713 : /* recompute direct energy ratios to match the diffuse ratio */
2714 : float direct_quota, direct_scaler;
2715 1288164 : direct_quota = 1.0f - hMeta->common_meta.diffuse_to_total_ratio[sf][band];
2716 1288164 : if ( band_n_dirs == 1 )
2717 : {
2718 1288164 : hMeta->directional_meta[0].energy_ratio[sf][band] = direct_quota;
2719 : }
2720 : else
2721 : {
2722 0 : dir_sum = hMeta->directional_meta[0].energy_ratio[sf][band] + hMeta->directional_meta[1].energy_ratio[sf][band];
2723 0 : direct_scaler = direct_quota / ( EPSILON + dir_sum );
2724 0 : hMeta->directional_meta[0].energy_ratio[sf][band] *= direct_scaler;
2725 0 : hMeta->directional_meta[1].energy_ratio[sf][band] *= direct_scaler;
2726 : }
2727 : }
2728 : }
2729 : }
2730 :
2731 153100 : for ( sf = 0; sf < numSf; sf++ )
2732 : {
2733 3025200 : for ( band = 0; band < numCodingBands; band++ )
2734 : {
2735 2902720 : hMasa->data.energy[sf][band] = energyMerged[sf][band];
2736 : }
2737 : }
2738 :
2739 30620 : return;
2740 : }
2741 :
2742 :
2743 212165 : static void quantize_ratio_ism_vector(
2744 : const float *ratio_ism,
2745 : int16_t *idx,
2746 : const int16_t nchan_ism,
2747 : const float masa_to_total_energy_ratio,
2748 : const int16_t idx_sep_object )
2749 : {
2750 : int16_t i, j, best_i, best_i2;
2751 : float dist, div, tmp, dist2, best_dist;
2752 : int16_t part_idx_sum, max_sum_idx;
2753 : float ratio_ism_loc[MAX_NUM_OBJECTS];
2754 : int16_t no_ism_loc;
2755 :
2756 212165 : max_sum_idx = ( 1 << PARAM_ISM_POW_RATIO_NBITS ) - 1;
2757 :
2758 212165 : if ( idx_sep_object > -1 )
2759 : {
2760 212165 : if ( ratio_ism[idx_sep_object] < 1.0f / (float) ( max_sum_idx ) )
2761 : {
2762 : /* take it out from quantize function */
2763 207140 : mvr2r( ratio_ism, ratio_ism_loc, idx_sep_object );
2764 207140 : mvr2r( &ratio_ism[idx_sep_object + 1], &ratio_ism_loc[idx_sep_object], nchan_ism - idx_sep_object - 1 );
2765 207140 : no_ism_loc = nchan_ism - 1;
2766 : }
2767 : else
2768 : {
2769 5025 : no_ism_loc = nchan_ism;
2770 5025 : mvr2r( ratio_ism, ratio_ism_loc, nchan_ism );
2771 : }
2772 : }
2773 : else
2774 : {
2775 0 : no_ism_loc = nchan_ism;
2776 0 : mvr2r( ratio_ism, ratio_ism_loc, nchan_ism );
2777 : }
2778 :
2779 212165 : if ( nchan_ism > 1 )
2780 : {
2781 212165 : if ( masa_to_total_energy_ratio >= MASA2TOTAL_THR )
2782 : {
2783 32683 : distribute_evenly_ism( idx, max_sum_idx, nchan_ism );
2784 : }
2785 : else
2786 : {
2787 179482 : if ( no_ism_loc > 1 )
2788 : {
2789 :
2790 177037 : dist = 0.0f;
2791 177037 : div = 1.0f / (float) ( max_sum_idx );
2792 :
2793 177037 : part_idx_sum = 0;
2794 :
2795 686573 : for ( i = 0; i < no_ism_loc; i++ )
2796 : {
2797 509536 : idx[i] = (int16_t) ( ( ratio_ism_loc[i] ) * ( max_sum_idx ) );
2798 509536 : part_idx_sum += idx[i];
2799 :
2800 509536 : tmp = ( ratio_ism_loc[i] - ( idx[i] * div ) );
2801 509536 : dist += ( tmp * tmp );
2802 : }
2803 :
2804 177037 : best_dist = dist;
2805 177037 : best_i2 = -1;
2806 351533 : while ( part_idx_sum < max_sum_idx )
2807 : {
2808 174496 : best_i = -1;
2809 : /* check which index to increase by 1 for a possible improvement */
2810 :
2811 676941 : for ( i = 0; i < no_ism_loc; i++ )
2812 : {
2813 502445 : idx[i]++;
2814 502445 : dist2 = 0.0f;
2815 :
2816 1974920 : for ( j = 0; j < no_ism_loc; j++ )
2817 : {
2818 1472475 : tmp = ( ratio_ism_loc[i] - ( idx[i] * div ) );
2819 1472475 : dist2 += ( tmp * tmp );
2820 : }
2821 :
2822 502445 : if ( dist2 < best_dist )
2823 : {
2824 137344 : best_i2 = best_i;
2825 137344 : best_i = i;
2826 137344 : best_dist = dist2;
2827 : }
2828 502445 : idx[i]--;
2829 : }
2830 174496 : if ( best_i > -1 )
2831 : {
2832 129140 : idx[best_i]++;
2833 129140 : part_idx_sum++;
2834 : }
2835 : else
2836 : {
2837 45356 : if ( best_i2 > -1 )
2838 : {
2839 7001 : idx[best_i2]++;
2840 7001 : part_idx_sum++;
2841 : }
2842 : else
2843 : {
2844 38355 : idx[no_ism_loc - 1] += max_sum_idx - part_idx_sum;
2845 38355 : part_idx_sum = max_sum_idx;
2846 : }
2847 : }
2848 : }
2849 177037 : assert( sum_s( idx, no_ism_loc ) == max_sum_idx );
2850 : }
2851 : else
2852 : {
2853 2445 : idx[0] = max_sum_idx;
2854 : }
2855 :
2856 179482 : if ( no_ism_loc < nchan_ism )
2857 : {
2858 : /* insert back the ratio of the separated object */
2859 535317 : for ( i = nchan_ism - 1; i > idx_sep_object; i-- )
2860 : {
2861 359984 : idx[i] = idx[i - 1];
2862 : }
2863 175333 : idx[idx_sep_object] = 0;
2864 : }
2865 : }
2866 : }
2867 : else
2868 : {
2869 0 : idx[0] = (int16_t) ( ( ratio_ism[0] ) * ( ( 1 << PARAM_ISM_POW_RATIO_NBITS ) - 1 ) + 0.5f );
2870 : }
2871 :
2872 212165 : return;
2873 : }
2874 :
2875 :
2876 38435 : static int16_t index_slice_enum(
2877 : const int16_t *ratio_ism_idx,
2878 : const int16_t nchan_ism )
2879 : {
2880 : int16_t i;
2881 : int16_t x, index;
2882 : int16_t base;
2883 :
2884 38435 : if ( nchan_ism == 2 )
2885 : {
2886 737 : index = ratio_ism_idx[0];
2887 : }
2888 : else
2889 : {
2890 37698 : x = ratio_ism_idx[nchan_ism - 2];
2891 37698 : base = 10;
2892 108791 : for ( i = nchan_ism - 3; i >= 0; i-- )
2893 : {
2894 71093 : x += ratio_ism_idx[i] * base;
2895 71093 : base *= 10;
2896 : }
2897 :
2898 37698 : index = 0;
2899 37698 : i = 0;
2900 5944718 : while ( i <= x )
2901 : {
2902 5907020 : if ( valid_ratio_index( i, 7, nchan_ism - 1 ) )
2903 : {
2904 1614556 : index++;
2905 : }
2906 5907020 : i++;
2907 : }
2908 37698 : index--;
2909 : }
2910 :
2911 38435 : return index;
2912 : }
2913 :
2914 :
2915 438663 : static void transform_difference_index(
2916 : const int16_t *diff_idx,
2917 : int16_t *idx,
2918 : const int16_t len )
2919 : {
2920 : int16_t i;
2921 1433511 : for ( i = 0; i < len; i++ )
2922 : {
2923 994848 : if ( diff_idx[i] <= 0 )
2924 : {
2925 800660 : idx[i] = -2 * diff_idx[i];
2926 : }
2927 : else
2928 : {
2929 194188 : idx[i] = 2 * diff_idx[i] - 1;
2930 : }
2931 : }
2932 :
2933 438663 : return;
2934 : }
2935 :
2936 :
2937 140897 : static void transform_index_and_GR_encode(
2938 : int16_t *diff_idx, /* i : differenc eindex to encode */
2939 : const int16_t len, /* i : input length */
2940 : const int16_t GR_order, /* i : GR order */
2941 : BSTR_ENC_HANDLE hMetaData /* i/o: metadata bitstream handle */
2942 : )
2943 : {
2944 : int16_t i;
2945 : int16_t idx[IVAS_MAX_NUM_OBJECTS];
2946 :
2947 : /* transform difference index into positive */
2948 140897 : transform_difference_index( diff_idx, idx, len );
2949 :
2950 : /* GR encoding */
2951 455357 : for ( i = 0; i < len; i++ )
2952 : {
2953 314460 : ivas_qmetadata_encode_extended_gr( hMetaData, idx[i], 100, GR_order );
2954 : }
2955 :
2956 140897 : return;
2957 : }
2958 :
2959 :
2960 11288 : static int16_t try_differential(
2961 : const int16_t numCodingBands,
2962 : const float *masa_to_total_energy_ratio,
2963 : int16_t ratio_ism_idx[MASA_FREQUENCY_BANDS][MAX_NUM_OBJECTS],
2964 : const int16_t nchan_ism,
2965 : const int16_t bits_index,
2966 : int16_t *p_b_signif )
2967 : {
2968 : int16_t b, i;
2969 : int16_t nbits0;
2970 : int16_t b_signif;
2971 : int16_t ratio_ism_idx_ref[MAX_NUM_OBJECTS];
2972 : int16_t diff_idx[MAX_NUM_OBJECTS];
2973 :
2974 11288 : b_signif = 0;
2975 14011 : while ( ( b_signif < numCodingBands ) && ( masa_to_total_energy_ratio[b_signif] >= MASA2TOTAL_THR ) )
2976 : {
2977 2723 : b_signif++;
2978 : }
2979 :
2980 11288 : nbits0 = 0;
2981 :
2982 11288 : if ( b_signif < numCodingBands )
2983 : {
2984 10819 : nbits0 = bits_index;
2985 10819 : mvs2s( ratio_ism_idx[b_signif], ratio_ism_idx_ref, nchan_ism );
2986 :
2987 56079 : for ( b = b_signif + 1; b < numCodingBands; b++ )
2988 : {
2989 45260 : if ( masa_to_total_energy_ratio[b] < MASA2TOTAL_THR )
2990 : {
2991 39240 : v_sub_s( ratio_ism_idx[b], ratio_ism_idx_ref, diff_idx, nchan_ism );
2992 39240 : mvs2s( ratio_ism_idx[b], ratio_ism_idx_ref, nchan_ism );
2993 :
2994 : /* transform difference index into positive */
2995 39240 : transform_difference_index( diff_idx, diff_idx, nchan_ism - 1 );
2996 :
2997 : /* GR encoding */
2998 147234 : for ( i = 0; i < nchan_ism - 1; i++ )
2999 : {
3000 107994 : nbits0 += ivas_qmetadata_encode_extended_gr_length( diff_idx[i], 100, 0 );
3001 : }
3002 : }
3003 : }
3004 : }
3005 11288 : *p_b_signif = b_signif;
3006 :
3007 11288 : return nbits0;
3008 : }
3009 :
3010 :
3011 3018 : static void differential_coding_first_subframe(
3012 : BSTR_ENC_HANDLE hMetaData,
3013 : const float *masa_to_total_energy_ratio,
3014 : const int16_t b_signif,
3015 : int16_t ratio_ism_idx[MASA_FREQUENCY_BANDS][MAX_NUM_OBJECTS],
3016 : const int16_t nchan_ism,
3017 : const int16_t numCodingBands,
3018 : const int16_t bits_index )
3019 : {
3020 : int16_t index, b;
3021 : int16_t ratio_ism_idx_ref[MAX_NUM_OBJECTS];
3022 : int16_t diff_idx[MAX_NUM_OBJECTS];
3023 :
3024 : /* differential encoding*/
3025 3018 : push_next_indice( hMetaData, 0, 1 );
3026 :
3027 3018 : if ( b_signif < numCodingBands )
3028 : {
3029 3018 : index = index_slice_enum( ratio_ism_idx[b_signif], nchan_ism );
3030 3018 : push_next_indice( hMetaData, index, bits_index );
3031 :
3032 3018 : mvs2s( ratio_ism_idx[b_signif], ratio_ism_idx_ref, nchan_ism );
3033 :
3034 16338 : for ( b = b_signif + 1; b < numCodingBands; b++ )
3035 : {
3036 13320 : if ( masa_to_total_energy_ratio[b] < MASA2TOTAL_THR )
3037 : {
3038 11624 : v_sub_s( ratio_ism_idx[b], ratio_ism_idx_ref, diff_idx, nchan_ism );
3039 11624 : mvs2s( ratio_ism_idx[b], ratio_ism_idx_ref, nchan_ism );
3040 :
3041 : /* transform difference index into positive */
3042 11624 : transform_index_and_GR_encode( diff_idx, nchan_ism - 1, 0, hMetaData );
3043 : }
3044 : }
3045 : }
3046 :
3047 3018 : return;
3048 : }
3049 :
3050 :
3051 7801 : static void independent_coding_ratio_ism_idx(
3052 : int16_t ratio_ism_idx[MASA_FREQUENCY_BANDS][MAX_NUM_OBJECTS], /* i : ISM ratios */
3053 : const float *masa_to_total_energy_ratio, /* i : MASA to total ratios */
3054 : const int16_t nchan_ism, /* i : number of objects */
3055 : const int16_t numCodingBands, /* i : number of subbands */
3056 : const int16_t bits_index, /* i : number of bits per index */
3057 : BSTR_ENC_HANDLE hMetaData /* i/o: metadata bitstream handle */
3058 : )
3059 : {
3060 : int16_t b, index;
3061 :
3062 47654 : for ( b = 0; b < numCodingBands; b++ )
3063 : {
3064 39853 : if ( masa_to_total_energy_ratio[b] < MASA2TOTAL_THR )
3065 : {
3066 35417 : index = index_slice_enum( ratio_ism_idx[b], nchan_ism );
3067 35417 : push_next_indice( hMetaData, index, bits_index );
3068 : }
3069 : }
3070 :
3071 7801 : return;
3072 : }
3073 :
3074 :
3075 251082 : static void remove_sep_obj(
3076 : int16_t *diff_idx, /* i/o: array of difference of indexes */
3077 : const int16_t nchan_ism, /* i : number of objects */
3078 : const int16_t idx_sep_obj /* i : index of separated object, to be taken out of array */
3079 : )
3080 : {
3081 : int16_t i;
3082 :
3083 758844 : for ( i = idx_sep_obj; i < nchan_ism - 1; i++ )
3084 : {
3085 507762 : diff_idx[i] = diff_idx[i + 1];
3086 : }
3087 :
3088 251082 : return;
3089 : }
3090 :
3091 :
3092 258526 : static void estimate_bits_subband_ism_ratio(
3093 : const int16_t *ratio_ism_idx,
3094 : const int16_t *ratio_ism_idx_ref, /* ( i/o ) */
3095 : const int16_t nchan_ism,
3096 : const int16_t shift_one,
3097 : const int16_t idx_sep_obj,
3098 : int16_t *p_nbits0,
3099 : int16_t *p_nbits1 )
3100 : {
3101 : int16_t diff_idx[MAX_NUM_OBJECTS];
3102 : int16_t nbits0, nbits1;
3103 : int16_t i;
3104 :
3105 258526 : nbits0 = 0;
3106 258526 : nbits1 = 0;
3107 :
3108 : /* take difference with respect to previous subframe */
3109 258526 : v_sub_s( ratio_ism_idx, ratio_ism_idx_ref, diff_idx, nchan_ism );
3110 :
3111 258526 : if ( shift_one )
3112 : {
3113 167388 : remove_sep_obj( diff_idx, nchan_ism, idx_sep_obj );
3114 : }
3115 :
3116 : /* transform difference index into positive */
3117 258526 : transform_difference_index( diff_idx, diff_idx, nchan_ism - 1 - shift_one );
3118 :
3119 : /* GR encoding */
3120 830920 : for ( i = 0; i < nchan_ism - 1 - shift_one; i++ )
3121 : {
3122 572394 : nbits0 += ivas_qmetadata_encode_extended_gr_length( diff_idx[i], 100, 0 );
3123 572394 : nbits1 += ivas_qmetadata_encode_extended_gr_length( diff_idx[i], 100, 1 );
3124 : }
3125 :
3126 258526 : *p_nbits0 = nbits0;
3127 258526 : *p_nbits1 = nbits1;
3128 :
3129 258526 : return;
3130 : }
3131 :
3132 :
3133 42131 : static int16_t encode_ratio_ism_subframe(
3134 : int16_t ratio_ism_idx[MASA_FREQUENCY_BANDS][MAX_NUM_OBJECTS],
3135 : const int16_t nchan_ism,
3136 : const uint8_t numCodingBands,
3137 : const int16_t sf,
3138 : int16_t ratio_ism_idx_prev_sf[MASA_FREQUENCY_BANDS][MAX_NUM_OBJECTS],
3139 : BSTR_ENC_HANDLE hMetaData,
3140 : const float *masa_to_total_energy_ratio,
3141 : const int16_t shift_one,
3142 : const int16_t idx_separated_obj )
3143 : {
3144 : int16_t b, b_signif;
3145 : int16_t diff_idx[MAX_NUM_OBJECTS];
3146 : int16_t nbits, nbits0, nbits1, GR_order, GR_order_sb;
3147 : int16_t differential_subframe;
3148 : int16_t ratio_ism_idx_ref[MAX_NUM_OBJECTS];
3149 : int16_t bits_index;
3150 : int16_t nbits00, nbits11;
3151 : int16_t idx_sep_obj_local;
3152 : #ifdef DEBUGGING
3153 : int16_t bits_pos0;
3154 : #endif
3155 :
3156 42131 : idx_sep_obj_local = idx_separated_obj;
3157 42131 : if ( idx_separated_obj > -1 )
3158 : {
3159 42131 : if ( idx_separated_obj == nchan_ism - 1 )
3160 : {
3161 1226 : idx_sep_obj_local = 0;
3162 : }
3163 : }
3164 42131 : nbits = 0;
3165 42131 : nbits0 = 0;
3166 42131 : nbits1 = 0;
3167 :
3168 : #ifdef DEBUGGING
3169 : bits_pos0 = hMetaData->nb_bits_tot;
3170 : #endif
3171 42131 : differential_subframe = 1; /* the differences are taken with respect to previous subframe */
3172 :
3173 : /* first subframe */
3174 42131 : bits_index = 0;
3175 42131 : if ( sf == 0 )
3176 : {
3177 11288 : bits_index = bits_index_ism_ratio( nchan_ism );
3178 :
3179 11288 : nbits = 0;
3180 70090 : for ( b = 0; b < numCodingBands; b++ )
3181 : {
3182 58802 : if ( masa_to_total_energy_ratio[b] < MASA2TOTAL_THR )
3183 : {
3184 50059 : nbits += bits_index;
3185 : }
3186 : }
3187 :
3188 11288 : nbits0 = try_differential( numCodingBands, masa_to_total_energy_ratio, ratio_ism_idx, nchan_ism, bits_index, &b_signif );
3189 :
3190 11288 : if ( nbits <= nbits0 && nbits > 0 )
3191 : {
3192 : /* independent encoding */
3193 7801 : push_next_indice( hMetaData, 1, 1 );
3194 7801 : independent_coding_ratio_ism_idx( ratio_ism_idx, masa_to_total_energy_ratio, nchan_ism, numCodingBands, bits_index, hMetaData );
3195 7801 : nbits = nbits + 1;
3196 : }
3197 : else
3198 : {
3199 3487 : if ( nbits > 0 )
3200 : {
3201 3018 : differential_coding_first_subframe( hMetaData, masa_to_total_energy_ratio, b_signif, ratio_ism_idx, nchan_ism, numCodingBands, bits_index );
3202 3018 : nbits = nbits0 + 1;
3203 : }
3204 : }
3205 :
3206 : #ifdef DEBUGGING
3207 : assert( nbits == ( hMetaData->nb_bits_tot - bits_pos0 ) );
3208 : #endif
3209 : }
3210 : else
3211 : {
3212 : /* not first subframe */
3213 30843 : if ( shift_one == 1 && nchan_ism == 2 )
3214 : {
3215 150 : nbits = 0;
3216 : }
3217 : else
3218 : {
3219 30693 : nbits0 = 0;
3220 30693 : nbits1 = 0;
3221 :
3222 183906 : for ( b = 0; b < numCodingBands; b++ )
3223 : {
3224 153213 : if ( masa_to_total_energy_ratio[b] < MASA2TOTAL_THR )
3225 : {
3226 129273 : estimate_bits_subband_ism_ratio( ratio_ism_idx[b], ratio_ism_idx_prev_sf[b], nchan_ism, shift_one, idx_sep_obj_local, &nbits00, &nbits11 );
3227 129273 : nbits0 += nbits00;
3228 129273 : nbits1 += nbits11;
3229 : }
3230 : }
3231 30693 : if ( nbits0 < nbits1 )
3232 : {
3233 23178 : GR_order = 0;
3234 23178 : nbits = nbits0;
3235 : }
3236 : else
3237 : {
3238 7515 : GR_order = 1;
3239 7515 : nbits = nbits1;
3240 : }
3241 :
3242 30693 : if ( numCodingBands > 1 )
3243 : {
3244 : /* try the difference from subband to subband; first subband is compared to previous subframe first subband*/
3245 : /* take difference with respect to previous subframe only for first subband */
3246 30630 : nbits0 = 0;
3247 30630 : nbits1 = 0;
3248 30630 : b_signif = 0;
3249 38018 : while ( ( b_signif < numCodingBands ) && ( masa_to_total_energy_ratio[b_signif] >= MASA2TOTAL_THR ) )
3250 : {
3251 7388 : b_signif++;
3252 : }
3253 :
3254 30630 : if ( b_signif < numCodingBands )
3255 : {
3256 29490 : estimate_bits_subband_ism_ratio( ratio_ism_idx[b_signif], ratio_ism_idx_prev_sf[b_signif], nchan_ism, shift_one, idx_sep_obj_local, &nbits0, &nbits1 );
3257 :
3258 29490 : mvs2s( ratio_ism_idx[b_signif], ratio_ism_idx_ref, nchan_ism );
3259 :
3260 145762 : for ( b = b_signif + 1; b < numCodingBands; b++ )
3261 : {
3262 116272 : if ( masa_to_total_energy_ratio[b] < MASA2TOTAL_THR )
3263 : {
3264 99763 : estimate_bits_subband_ism_ratio( ratio_ism_idx[b], ratio_ism_idx_ref, nchan_ism, shift_one, idx_sep_obj_local, &nbits00, &nbits11 );
3265 99763 : nbits0 += nbits00;
3266 99763 : nbits1 += nbits11;
3267 99763 : mvs2s( ratio_ism_idx[b], ratio_ism_idx_ref, nchan_ism );
3268 : }
3269 : }
3270 :
3271 29490 : if ( nbits0 < nbits1 )
3272 : {
3273 7877 : GR_order_sb = 0;
3274 : }
3275 : else
3276 : {
3277 21613 : GR_order_sb = 1;
3278 21613 : nbits0 = nbits1;
3279 : }
3280 :
3281 29490 : if ( nbits0 < nbits )
3282 : {
3283 2662 : differential_subframe = 0;
3284 2662 : nbits = nbits0;
3285 2662 : GR_order = GR_order_sb;
3286 : }
3287 :
3288 29490 : if ( nbits > 0 )
3289 : {
3290 : /* write prediction type */
3291 29490 : push_next_indice( hMetaData, differential_subframe, 1 );
3292 : /* write GR order */
3293 29490 : push_next_indice( hMetaData, GR_order, 1 );
3294 29490 : nbits++; /* for the prediction type */
3295 29490 : nbits++; /* for GR_order */
3296 :
3297 : /* write data */
3298 29490 : if ( differential_subframe )
3299 : {
3300 160968 : for ( b = 0; b < numCodingBands; b++ )
3301 : {
3302 134140 : if ( masa_to_total_energy_ratio[b] < MASA2TOTAL_THR )
3303 : {
3304 : /* take difference with respect to previous subframe */
3305 117974 : v_sub_s( ratio_ism_idx[b], ratio_ism_idx_prev_sf[b], diff_idx, nchan_ism );
3306 :
3307 117974 : if ( shift_one )
3308 : {
3309 79730 : remove_sep_obj( diff_idx, nchan_ism, idx_sep_obj_local );
3310 : }
3311 :
3312 117974 : transform_index_and_GR_encode( diff_idx, nchan_ism - 1 - shift_one, GR_order, hMetaData );
3313 : }
3314 : }
3315 : }
3316 : else
3317 : {
3318 2662 : v_sub_s( ratio_ism_idx[b_signif], ratio_ism_idx_prev_sf[b_signif], diff_idx, nchan_ism );
3319 :
3320 2662 : if ( shift_one )
3321 : {
3322 805 : remove_sep_obj( diff_idx, nchan_ism, idx_sep_obj_local );
3323 : }
3324 :
3325 2662 : transform_index_and_GR_encode( diff_idx, nchan_ism - 1 - shift_one, GR_order, hMetaData );
3326 :
3327 2662 : mvs2s( ratio_ism_idx[b_signif], ratio_ism_idx_ref, nchan_ism - shift_one );
3328 :
3329 12962 : for ( b = b_signif + 1; b < numCodingBands; b++ )
3330 : {
3331 : /* take difference with respect to previous subband */
3332 10300 : if ( masa_to_total_energy_ratio[b] < MASA2TOTAL_THR )
3333 : {
3334 8617 : v_sub_s( ratio_ism_idx[b], ratio_ism_idx_ref, diff_idx, nchan_ism );
3335 :
3336 8617 : if ( shift_one )
3337 : {
3338 3159 : remove_sep_obj( diff_idx, nchan_ism, idx_sep_obj_local );
3339 : }
3340 :
3341 8617 : transform_index_and_GR_encode( diff_idx, nchan_ism - 1 - shift_one, GR_order, hMetaData );
3342 :
3343 8617 : mvs2s( ratio_ism_idx[b], ratio_ism_idx_ref, nchan_ism - shift_one );
3344 : }
3345 : }
3346 : }
3347 : }
3348 : }
3349 : }
3350 : else
3351 : {
3352 : /* only differential wrt previous subframe is possible */
3353 : /* write the differential to subframe case and no bit to signal the difference type */
3354 :
3355 63 : if ( nbits > 0 )
3356 : {
3357 : /* write GR order */
3358 20 : push_next_indice( hMetaData, GR_order, 1 );
3359 20 : nbits++; /* for GR_order */
3360 : /* write data */
3361 : /* only one subband */
3362 20 : if ( masa_to_total_energy_ratio[0] < MASA2TOTAL_THR )
3363 : {
3364 : /* take difference with respect to previous subframe */
3365 20 : v_sub_s( ratio_ism_idx[0], ratio_ism_idx_prev_sf[0], diff_idx, nchan_ism );
3366 :
3367 20 : if ( shift_one )
3368 : {
3369 0 : remove_sep_obj( diff_idx, nchan_ism, idx_sep_obj_local );
3370 : }
3371 :
3372 20 : transform_index_and_GR_encode( diff_idx, nchan_ism - 1 - shift_one, GR_order, hMetaData );
3373 : }
3374 : }
3375 : }
3376 :
3377 : #ifdef DEBUGGING
3378 : assert( nbits == ( hMetaData->nb_bits_tot - bits_pos0 ) );
3379 : #endif
3380 : }
3381 : }
3382 :
3383 42131 : return nbits;
3384 : }
3385 :
3386 :
3387 11288 : static void ivas_encode_masaism_metadata(
3388 : MASA_ENCODER_HANDLE hMasa,
3389 : IVAS_QMETADATA_HANDLE hQMetaData, /* i/o: q_metadata handle */
3390 : BSTR_ENC_HANDLE hMetaData, /* i/o: metadata bitstream handle */
3391 : ISM_METADATA_HANDLE hIsmMeta[], /* i/o: ISM metadata handles */
3392 : const int16_t nchan_ism, /* i : number of ISM channels */
3393 : const int16_t low_bitrate_mode, /* i : is low bitrate more? 1/0 */
3394 : const int16_t omasa_nbands,
3395 : const int16_t omasa_nblocks,
3396 : const int16_t idx_separated_object,
3397 : const int16_t ism_imp )
3398 : {
3399 : int16_t sf, band;
3400 : uint8_t numCodingBands;
3401 : uint8_t numSf;
3402 : int16_t brange[2];
3403 : float eneBand;
3404 : int16_t bin;
3405 : int16_t obj;
3406 : int16_t bits_ism[MAX_NUM_OBJECTS];
3407 : uint16_t idx_sph;
3408 : float theta_q, phi_q;
3409 : uint16_t index_theta, index_phi;
3410 : float ratio_ism[MASA_FREQUENCY_BANDS][MAX_NUM_OBJECTS];
3411 : int16_t ratio_ism_idx[MASA_FREQUENCY_BANDS][MAX_NUM_OBJECTS], ratio_ism_idx_prev_sf[MASA_FREQUENCY_BANDS][MAX_NUM_OBJECTS];
3412 : float step;
3413 : int16_t inv_step;
3414 : float energy_ism, energy_ism_ind[MAX_NUM_OBJECTS];
3415 : int16_t tmp, rotate;
3416 : int16_t n_ism_tmp, i;
3417 11288 : OMASA_ENCODER_DATA_HANDLE hOmasaData = hMasa->data.hOmasaData;
3418 11288 : OMASA_ENCODER_ENERGY_HANDLE hOmasaEnergy = hOmasaData->hOmasaEnergy;
3419 : int16_t nbands_work;
3420 :
3421 : /* use the values from hQMetaData */
3422 11288 : numCodingBands = (uint8_t) hQMetaData->q_direction->cfg.nbands;
3423 11288 : numSf = (int8_t) hQMetaData->q_direction->cfg.nblocks;
3424 11288 : nbands_work = min( numCodingBands, omasa_nbands );
3425 11288 : if ( numCodingBands == 1 )
3426 : {
3427 355 : for ( sf = 0; sf < numSf; sf++ )
3428 : {
3429 284 : if ( sum_f( hOmasaEnergy->energy_ism[sf], omasa_nbands ) == 0.0f )
3430 : {
3431 0 : hOmasaData->masa_to_total_energy_ratio[sf][0] = 1.0f;
3432 : }
3433 : else
3434 : {
3435 284 : brange[0] = hMasa->data.band_mapping[0];
3436 284 : brange[1] = hMasa->data.band_mapping[omasa_nbands];
3437 284 : eneBand = 0.0f;
3438 6920 : for ( bin = brange[0]; bin < brange[1]; bin++ )
3439 : {
3440 6636 : eneBand += hMasa->data.energy[sf][bin];
3441 : }
3442 :
3443 284 : energy_ism = 0.0f;
3444 852 : for ( obj = 0; obj < nchan_ism; obj++ )
3445 : {
3446 568 : energy_ism_ind[obj] = 0.0f;
3447 : }
3448 :
3449 1704 : for ( band = 0; band < omasa_nbands; band++ )
3450 : {
3451 1420 : energy_ism += hOmasaEnergy->energy_ism[sf][band];
3452 4260 : for ( obj = 0; obj < nchan_ism; obj++ )
3453 : {
3454 2840 : energy_ism_ind[obj] += hOmasaEnergy->energy_ism[sf][band] * hOmasaEnergy->energy_ratio_ism[sf][band][obj];
3455 : }
3456 : }
3457 :
3458 852 : for ( obj = 0; obj < nchan_ism; obj++ )
3459 : {
3460 568 : hOmasaEnergy->energy_ratio_ism[sf][0][obj] = energy_ism_ind[obj] / energy_ism;
3461 : }
3462 284 : hOmasaData->masa_to_total_energy_ratio[sf][0] = eneBand / ( eneBand + energy_ism + EPSILON );
3463 : }
3464 : }
3465 : }
3466 11217 : else if ( numSf == 1 )
3467 : {
3468 8688 : for ( band = 0; band < nbands_work; band++ )
3469 : {
3470 7681 : energy_ism = 0.0f; /* ISM energy for current subband */
3471 30291 : for ( obj = 0; obj < nchan_ism; obj++ )
3472 : {
3473 22610 : energy_ism_ind[obj] = 0.0f;
3474 : }
3475 24797 : for ( sf = 0; sf < omasa_nblocks; sf++ )
3476 : {
3477 17116 : energy_ism += hOmasaEnergy->energy_ism[sf][band];
3478 58596 : for ( obj = 0; obj < nchan_ism; obj++ )
3479 : {
3480 41480 : energy_ism_ind[obj] += hOmasaEnergy->energy_ism[sf][band] * hOmasaEnergy->energy_ratio_ism[sf][band][obj];
3481 : }
3482 : }
3483 :
3484 7681 : if ( energy_ism == 0.0f )
3485 : {
3486 0 : hOmasaData->masa_to_total_energy_ratio[0][band] = 1.0f;
3487 : }
3488 : else
3489 : {
3490 30291 : for ( obj = 0; obj < nchan_ism; obj++ )
3491 : {
3492 22610 : hOmasaEnergy->energy_ratio_ism[0][band][obj] = energy_ism_ind[obj] / energy_ism;
3493 : }
3494 7681 : brange[0] = hMasa->data.band_mapping[band];
3495 7681 : brange[1] = hMasa->data.band_mapping[band + 1];
3496 :
3497 7681 : eneBand = 0.0f;
3498 24797 : for ( sf = 0; sf < omasa_nblocks; sf++ )
3499 : {
3500 84676 : for ( bin = brange[0]; bin < brange[1]; bin++ )
3501 : {
3502 67560 : eneBand += hMasa->data.energy[sf][bin];
3503 : }
3504 : }
3505 7681 : hOmasaData->masa_to_total_energy_ratio[0][band] = eneBand / ( eneBand + energy_ism + EPSILON );
3506 : }
3507 : }
3508 1007 : for ( band = nbands_work; band < numCodingBands; band++ )
3509 : {
3510 0 : hOmasaData->masa_to_total_energy_ratio[0][band] = 1.0f;
3511 :
3512 0 : for ( obj = 0; obj < nchan_ism; obj++ )
3513 : {
3514 0 : hOmasaEnergy->energy_ratio_ism[0][band][obj] = hOmasaEnergy->energy_ratio_ism[0][nbands_work - 1][obj];
3515 : }
3516 : }
3517 : }
3518 : else
3519 : {
3520 51050 : for ( sf = 0; sf < numSf; sf++ )
3521 : {
3522 245040 : for ( band = 0; band < nbands_work; band++ )
3523 : {
3524 204200 : if ( hOmasaEnergy->energy_ism[sf][band] == 0.0f )
3525 : {
3526 680 : hOmasaData->masa_to_total_energy_ratio[sf][band] = 1.0f;
3527 : }
3528 : else
3529 : {
3530 203520 : brange[0] = hMasa->data.band_mapping[band];
3531 203520 : brange[1] = hMasa->data.band_mapping[band + 1];
3532 :
3533 203520 : eneBand = 0.0f;
3534 1168928 : for ( bin = brange[0]; bin < brange[1]; bin++ )
3535 : {
3536 965408 : eneBand += hMasa->data.energy[sf][bin];
3537 : }
3538 203520 : hOmasaData->masa_to_total_energy_ratio[sf][band] = eneBand / ( eneBand + hOmasaEnergy->energy_ism[sf][band] + EPSILON );
3539 : }
3540 : }
3541 40840 : for ( band = nbands_work; band < numCodingBands; band++ )
3542 : {
3543 0 : hOmasaData->masa_to_total_energy_ratio[sf][band] = 1.0f;
3544 :
3545 0 : for ( obj = 0; obj < nchan_ism; obj++ )
3546 : {
3547 0 : hOmasaEnergy->energy_ratio_ism[sf][band][obj] = hOmasaEnergy->energy_ratio_ism[sf][nbands_work - 1][obj];
3548 : }
3549 : }
3550 : }
3551 : }
3552 11288 : ivas_omasa_encode_masa_to_total( hOmasaData->masa_to_total_energy_ratio, hMetaData, low_bitrate_mode, numCodingBands, numSf );
3553 :
3554 : /* quantize ism_ratios */
3555 11288 : if ( nchan_ism > 1 )
3556 : {
3557 11288 : inv_step = ( ( 1 << PARAM_ISM_POW_RATIO_NBITS ) - 1 );
3558 11288 : step = 1.0f / inv_step;
3559 :
3560 11288 : rotate = 0;
3561 11288 : n_ism_tmp = 0;
3562 :
3563 53419 : for ( sf = 0; sf < numSf; sf++ )
3564 : {
3565 254296 : for ( band = 0; band < numCodingBands; band++ )
3566 : {
3567 1026103 : for ( obj = 0; obj < nchan_ism; obj++ )
3568 : {
3569 813938 : assert( ( hOmasaEnergy->energy_ratio_ism[sf][band][obj] >= 0 ) && ( hOmasaEnergy->energy_ratio_ism[sf][band][obj] <= 1 ) );
3570 813938 : ratio_ism[band][obj] = hOmasaEnergy->energy_ratio_ism[sf][band][obj];
3571 : }
3572 :
3573 : /* Quantize ISM ratios */
3574 212165 : quantize_ratio_ism_vector( ratio_ism[band], ratio_ism_idx[band], nchan_ism, hOmasaData->masa_to_total_energy_ratio[sf][band], idx_separated_object );
3575 212165 : if ( n_ism_tmp == numCodingBands && ratio_ism_idx[band][idx_separated_object] != 0 && hOmasaData->masa_to_total_energy_ratio[sf][band] < MASA2TOTAL_THR )
3576 : {
3577 315 : i = 0;
3578 1955 : while ( ratio_ism_idx[band][idx_separated_object] > 0 )
3579 : {
3580 1640 : if ( i != idx_separated_object )
3581 : {
3582 1124 : ratio_ism_idx[band][i]++;
3583 1124 : ratio_ism_idx[band][idx_separated_object]--;
3584 : }
3585 1640 : i++;
3586 1640 : if ( i == nchan_ism )
3587 : {
3588 306 : i = 0;
3589 : }
3590 : }
3591 : }
3592 :
3593 : /* reconstructed values */
3594 212165 : reconstruct_ism_ratios( ratio_ism_idx[band], nchan_ism, step, hOmasaEnergy->q_energy_ratio_ism[sf][band] );
3595 : }
3596 :
3597 42131 : if ( ( nchan_ism > 2 ) && ( idx_separated_object == nchan_ism - 1 ) )
3598 : {
3599 : /* rotate components */
3600 1162 : rotate = 1;
3601 6986 : for ( band = 0; band < numCodingBands; band++ )
3602 : {
3603 5824 : if ( hOmasaData->masa_to_total_energy_ratio[sf][band] < MASA2TOTAL_THR )
3604 : {
3605 5102 : tmp = ratio_ism_idx[band][nchan_ism - 1];
3606 5102 : ratio_ism_idx[band][nchan_ism - 1] = ratio_ism_idx[band][0];
3607 5102 : ratio_ism_idx[band][0] = tmp;
3608 5102 : if ( sf == 0 && tmp == 0 )
3609 : {
3610 1180 : n_ism_tmp += 1;
3611 : }
3612 :
3613 5102 : if ( n_ism_tmp == numCodingBands )
3614 : {
3615 2609 : assert( tmp == 0 );
3616 : }
3617 : }
3618 : }
3619 : }
3620 : else
3621 : {
3622 40969 : if ( idx_separated_object > -1 )
3623 : {
3624 247310 : for ( band = 0; band < numCodingBands; band++ )
3625 : {
3626 206341 : if ( hOmasaData->masa_to_total_energy_ratio[sf][band] < MASA2TOTAL_THR )
3627 : {
3628 174380 : if ( ratio_ism_idx[band][idx_separated_object] == 0 && sf == 0 )
3629 : {
3630 47183 : n_ism_tmp++;
3631 : }
3632 : }
3633 : }
3634 : }
3635 : }
3636 :
3637 : /* encode data for current subframe */
3638 42131 : if ( sf > 0 && n_ism_tmp == numCodingBands )
3639 : {
3640 17562 : encode_ratio_ism_subframe( ratio_ism_idx, nchan_ism, numCodingBands, sf, ratio_ism_idx_prev_sf, hMetaData, hOmasaData->masa_to_total_energy_ratio[sf], 1, idx_separated_object );
3641 : }
3642 : else
3643 : {
3644 24569 : encode_ratio_ism_subframe( ratio_ism_idx, nchan_ism, numCodingBands, sf, ratio_ism_idx_prev_sf, hMetaData, hOmasaData->masa_to_total_energy_ratio[sf], 0, idx_separated_object );
3645 : }
3646 :
3647 : /* calculate quantized ISM ratios */
3648 : /* save previous subframe indexes */
3649 254296 : for ( band = 0; band < numCodingBands; band++ )
3650 : {
3651 212165 : mvs2s( ratio_ism_idx[band], ratio_ism_idx_prev_sf[band], nchan_ism );
3652 : }
3653 :
3654 42131 : if ( rotate )
3655 : {
3656 6986 : for ( band = 0; band < numCodingBands; band++ )
3657 : {
3658 5824 : if ( hOmasaData->masa_to_total_energy_ratio[sf][band] < MASA2TOTAL_THR )
3659 : {
3660 5102 : tmp = ratio_ism_idx[band][nchan_ism - 1];
3661 5102 : ratio_ism_idx[band][nchan_ism - 1] = ratio_ism_idx[band][0];
3662 5102 : ratio_ism_idx[band][0] = tmp;
3663 : }
3664 : }
3665 : }
3666 : }
3667 : }
3668 :
3669 11288 : calculate_nbits_meta( nchan_ism, hOmasaEnergy->q_energy_ratio_ism, hOmasaData->masa_to_total_energy_ratio, numSf, numCodingBands, bits_ism, idx_separated_object, ism_imp );
3670 :
3671 : /* quantize directions */
3672 53586 : for ( obj = 0; obj < nchan_ism; obj++ )
3673 : {
3674 42298 : if ( bits_ism[obj] < 8 )
3675 : {
3676 : /* check is same as previous */
3677 16821 : if ( ( fabs( hIsmMeta[obj]->elevation - hIsmMeta[obj]->q_elevation_old ) < 0.01f ) && ( fabs( hIsmMeta[obj]->azimuth - hIsmMeta[obj]->q_azimuth_old ) < 0.01f ) )
3678 : {
3679 514 : push_next_indice( hMetaData, 1, 1 );
3680 : /* the old stays the same */
3681 : }
3682 : else
3683 : {
3684 16307 : push_next_indice( hMetaData, 0, 1 );
3685 16307 : idx_sph = quantize_direction( hIsmMeta[obj]->elevation, hIsmMeta[obj]->azimuth, bits_ism[obj], &theta_q, &phi_q, &index_theta, &index_phi, MC_LS_SETUP_INVALID );
3686 16307 : push_next_indice( hMetaData, idx_sph, bits_ism[obj] );
3687 16307 : hIsmMeta[obj]->q_elevation_old = hIsmMeta[obj]->elevation;
3688 16307 : hIsmMeta[obj]->q_azimuth_old = hIsmMeta[obj]->azimuth;
3689 : }
3690 : }
3691 : else
3692 : {
3693 25477 : idx_sph = quantize_direction( hIsmMeta[obj]->elevation, hIsmMeta[obj]->azimuth, bits_ism[obj], &theta_q, &phi_q, &index_theta, &index_phi, MC_LS_SETUP_INVALID );
3694 25477 : push_next_indice( hMetaData, idx_sph, bits_ism[obj] );
3695 25477 : hIsmMeta[obj]->q_elevation_old = hIsmMeta[obj]->elevation;
3696 25477 : hIsmMeta[obj]->q_azimuth_old = hIsmMeta[obj]->azimuth;
3697 : }
3698 : }
3699 :
3700 11288 : return;
3701 : }
3702 :
3703 :
3704 : /*-------------------------------------------------------------------*
3705 : * ivas_merge_masa_transports()
3706 : *
3707 : * Merge MASA transport channels
3708 : *-------------------------------------------------------------------*/
3709 :
3710 41908 : void ivas_merge_masa_transports(
3711 : float data_in_f1[][L_FRAME48k],
3712 : float *data_in_f2[],
3713 : float *data_out_f[],
3714 : const int16_t input_frame,
3715 : const int16_t num_transport_channels )
3716 : {
3717 : int16_t i, j;
3718 :
3719 125724 : for ( i = 0; i < num_transport_channels; i++ )
3720 : {
3721 75537256 : for ( j = 0; j < input_frame; j++ )
3722 : {
3723 75453440 : data_out_f[i][j] = data_in_f1[i][j] + data_in_f2[i][j];
3724 : }
3725 : }
3726 :
3727 41908 : return;
3728 : }
|
