Line data Source code
1 : /******************************************************************************************************
2 :
3 : (C) 2022-2026 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 289 : 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 289 : error = IVAS_ERR_OK;
104 :
105 289 : 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 289 : hEncoderConfig = st_ivas->hEncoderConfig;
111 :
112 289 : generate_gridEq( &( hMasa->data.Sph_Grid16 ) );
113 :
114 289 : if ( hEncoderConfig->ivas_format == MASA_FORMAT || hEncoderConfig->ivas_format == MASA_ISM_FORMAT )
115 : {
116 74 : hMasa->data.num_Cldfb_instances = st_ivas->nchan_transport;
117 : }
118 : else
119 : {
120 215 : hMasa->data.num_Cldfb_instances = 0;
121 : }
122 :
123 423 : for ( i = 0; i < hMasa->data.num_Cldfb_instances; i++ )
124 : {
125 134 : 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 289 : ism_total_brate = 0;
132 289 : 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 89 : for ( i = 0; i < st_ivas->nSCE; i++ )
135 : {
136 58 : ism_total_brate += st_ivas->hSCE[i]->element_brate;
137 : }
138 : }
139 :
140 289 : 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 289 : mvs2s( DirAC_block_grouping, hMasa->config.block_grouping, MAX_PARAM_SPATIAL_SUBFRAMES + 1 );
143 289 : mvs2s( MASA_band_grouping_24, hMasa->config.band_grouping, MASA_FREQUENCY_BANDS + 1 );
144 :
145 :
146 289 : hMasa->data.onset_detector_1 = 0.0f;
147 289 : hMasa->data.onset_detector_2 = 0.0f;
148 :
149 289 : set_zero( hMasa->data.lfeToTotalEnergyRatio, MAX_PARAM_SPATIAL_SUBFRAMES );
150 289 : hMasa->data.prevq_lfeToTotalEnergyRatio = 0.0f;
151 289 : hMasa->data.prevq_lfeIndex = 0;
152 :
153 289 : hMasa->data.sync_state.prev_sim_stop = 0;
154 289 : hMasa->data.sync_state.prev_offset = 0;
155 289 : hMasa->data.sync_state.frame_mode = MASA_FRAME_4SF;
156 :
157 289 : set_zero( hMasa->data.dir_align_state.previous_azi_dir1, MASA_FREQUENCY_BANDS );
158 289 : set_zero( hMasa->data.dir_align_state.previous_ele_dir1, MASA_FREQUENCY_BANDS );
159 289 : set_zero( hMasa->data.dir_align_state.previous_azi_dir2, MASA_FREQUENCY_BANDS );
160 289 : set_zero( hMasa->data.dir_align_state.previous_ele_dir2, MASA_FREQUENCY_BANDS );
161 :
162 289 : if ( hEncoderConfig->ivas_format == MASA_ISM_FORMAT )
163 : {
164 : OMASA_ENCODER_DATA_HANDLE hOmasaData;
165 :
166 37 : 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 185 : for ( i = 0; i < MAX_PARAM_SPATIAL_SUBFRAMES; i++ )
171 : {
172 148 : set_f( hOmasaData->masa_to_total_energy_ratio[i], 0, MASA_FREQUENCY_BANDS );
173 : }
174 37 : hOmasaData->lp_noise_CPE = -1;
175 37 : hOmasaData->omasa_stereo_sw_cnt = OMASA_STEREO_SW_CNT_MAX;
176 :
177 37 : if ( st_ivas->ism_mode != ISM_MASA_MODE_DISC )
178 : {
179 21 : 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 16 : hOmasaData->hOmasaEnergy = NULL;
187 : }
188 :
189 37 : hMasa->data.hOmasaData = hOmasaData;
190 : }
191 : else
192 : {
193 252 : hMasa->data.hOmasaData = NULL;
194 : }
195 :
196 289 : st_ivas->hMasa = hMasa;
197 :
198 289 : return error;
199 : }
200 :
201 :
202 : /*-----------------------------------------------------------------------*
203 : * ivas_masa_enc_close()
204 : *
205 : * close MASA encoder
206 : *-----------------------------------------------------------------------*/
207 :
208 717 : void ivas_masa_enc_close(
209 : MASA_ENCODER_HANDLE *hMasa /* i/o: MASA metadata structure */
210 : )
211 : {
212 : int16_t i;
213 :
214 717 : if ( hMasa == NULL || *hMasa == NULL )
215 : {
216 428 : return;
217 : }
218 :
219 423 : for ( i = 0; i < ( *hMasa )->data.num_Cldfb_instances; i++ )
220 : {
221 134 : deleteCldfb( &( ( *hMasa )->data.cldfbAnaEnc[i] ) );
222 : }
223 :
224 289 : if ( ( *hMasa )->data.hOmasaData != NULL )
225 : {
226 37 : if ( ( *hMasa )->data.hOmasaData->hOmasaEnergy != NULL )
227 : {
228 26 : free( ( *hMasa )->data.hOmasaData->hOmasaEnergy );
229 26 : ( *hMasa )->data.hOmasaData->hOmasaEnergy = NULL;
230 : }
231 :
232 37 : free( ( *hMasa )->data.hOmasaData );
233 37 : ( *hMasa )->data.hOmasaData = NULL;
234 : }
235 :
236 289 : free( ( *hMasa ) );
237 289 : ( *hMasa ) = NULL;
238 :
239 289 : return;
240 : }
241 :
242 :
243 : /*-----------------------------------------------------------------------*
244 : * ivas_masa_encode()
245 : *
246 : * main MASA encoder function
247 : *-----------------------------------------------------------------------*/
248 :
249 72424 : 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 72424 : masa_sid_descriptor = -1;
276 72424 : h_orig_metadata = NULL;
277 72424 : low_bitrate_mode = 0;
278 :
279 72424 : 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 66274 : if ( Opt_DTX_ON && hQMetaData != NULL )
283 : {
284 6174 : if ( nchan_transport == 2 ) /* this is MASA format in CPE only */
285 : {
286 4166 : masa_sid_descriptor = 0; /* for IVAS_CPE_DFT */
287 4166 : if ( element_mode == IVAS_CPE_MDCT )
288 : {
289 1738 : masa_sid_descriptor = 1;
290 : }
291 : }
292 : }
293 :
294 : /* Validate and compensate ratios as necessary */
295 66274 : compensate_energy_ratios( hMasa );
296 :
297 66274 : if ( Opt_DTX_ON )
298 : {
299 6174 : 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 18522 : for ( i = 0; i < MASA_MAXIMUM_DIRECTIONS; i++ )
305 : {
306 61740 : for ( j = 0; j < MAX_PARAM_SPATIAL_SUBFRAMES; j++ )
307 : {
308 49392 : mvr2r( hMasa->masaMetadata.directional_meta[i].azimuth[j], h_orig_metadata[i].azimuth[j], MASA_FREQUENCY_BANDS );
309 49392 : mvr2r( hMasa->masaMetadata.directional_meta[i].elevation[j], h_orig_metadata[i].elevation[j], MASA_FREQUENCY_BANDS );
310 49392 : mvr2r( hMasa->masaMetadata.directional_meta[i].energy_ratio[j], h_orig_metadata[i].energy_ratio[j], MASA_FREQUENCY_BANDS );
311 49392 : 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 66274 : if ( ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT ) && ivas_total_brate >= IVAS_384k )
317 : {
318 5450 : hMasa->config.mergeRatiosOverSubframes = 0;
319 : }
320 :
321 : /* Combine frequency bands and sub-frames */
322 66274 : combine_freqbands_and_subframes( hMasa );
323 : }
324 :
325 72424 : if ( hMasa->config.numberOfDirections == 2 && hMasa->config.numTwoDirBands < hMasa->config.numCodingBands && ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT ) )
326 : {
327 23265 : 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 15638 : ivas_masa_combine_directions( hMasa );
331 : }
332 :
333 : /* If we joined all bands, then metadata is now one directional. */
334 23265 : if ( hMasa->config.numTwoDirBands == 0 )
335 : {
336 13608 : hMasa->config.numberOfDirections = 1;
337 13608 : hMasa->masaMetadata.descriptive_meta.numberOfDirections = 0;
338 13608 : hQMetaData->no_directions = 1;
339 : }
340 : }
341 :
342 : /* Reset qmetadata bit budget */
343 72424 : hQMetaData->metadata_max_bits = hMasa->config.max_metadata_bits;
344 72424 : if ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT )
345 : {
346 66274 : if ( ivas_format == MASA_ISM_FORMAT && ism_mode != ISM_MODE_NONE )
347 : {
348 : /* write the number of objects in ISM_MASA format*/
349 25208 : push_next_indice( hMetaData, nchan_ism - 1, NO_BITS_MASA_ISM_NO_OBJ );
350 25208 : hQMetaData->metadata_max_bits -= NO_BITS_MASA_ISM_NO_OBJ;
351 :
352 : /* write index of separated object if needed */
353 25208 : if ( ism_mode == ISM_MASA_MODE_PARAM_ONE_OBJ && nchan_ism > 1 )
354 : {
355 5790 : push_next_indice( hMetaData, idx_separated_object, NO_BITS_MASA_ISM_NO_OBJ );
356 5790 : hQMetaData->metadata_max_bits -= NO_BITS_MASA_ISM_NO_OBJ;
357 : }
358 :
359 : /* write ISM importance flag (one per object) */
360 25208 : if ( ism_mode == ISM_MASA_MODE_PARAM_ONE_OBJ )
361 : {
362 5790 : push_next_indice( hMetaData, hIsmMetaData[0]->ism_imp, ISM_METADATA_FLAG_BITS );
363 5790 : hQMetaData->metadata_max_bits -= ISM_METADATA_FLAG_BITS;
364 : }
365 19418 : else if ( ism_mode == ISM_MASA_MODE_MASA_ONE_OBJ )
366 : {
367 7826 : 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 7826 : push_next_indice( hMetaData, hIsmMetaData[0]->ism_imp, ISM_METADATA_FLAG_BITS );
382 7826 : hQMetaData->metadata_max_bits -= ISM_METADATA_FLAG_BITS;
383 :
384 7826 : if ( hIsmMetaData[0]->ism_imp == ISM_NO_META )
385 : {
386 : /* signal low-rate ISM_NO_META frame */
387 209 : push_next_indice( hMetaData, 0, ISM_METADATA_MD_FLAG_BITS );
388 209 : hQMetaData->metadata_max_bits -= ISM_METADATA_MD_FLAG_BITS;
389 :
390 : /* signal presence of MD in low-rate ISM_NO_META frame */
391 209 : push_next_indice( hMetaData, hIsmMetaData[0]->ism_md_lowrate_flag, ISM_METADATA_INACTIVE_FLAG_BITS );
392 209 : hQMetaData->metadata_max_bits -= ISM_METADATA_INACTIVE_FLAG_BITS;
393 : }
394 : }
395 : }
396 11592 : else if ( ism_mode == ISM_MASA_MODE_DISC )
397 : {
398 45094 : for ( i = 0; i < nchan_ism; i++ )
399 : {
400 33502 : 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 33502 : push_next_indice( hMetaData, hIsmMetaData[i]->ism_imp, ISM_METADATA_FLAG_BITS );
415 33502 : hQMetaData->metadata_max_bits -= ISM_METADATA_FLAG_BITS;
416 :
417 33502 : if ( hIsmMetaData[i]->ism_imp == ISM_NO_META )
418 : {
419 : /* signal low-rate ISM_NO_META frame */
420 80 : push_next_indice( hMetaData, 0, ISM_METADATA_MD_FLAG_BITS );
421 80 : hQMetaData->metadata_max_bits -= ISM_METADATA_MD_FLAG_BITS;
422 :
423 : /* signal presence of MD in low-rate ISM_NO_META frame */
424 80 : push_next_indice( hMetaData, hIsmMetaData[i]->ism_md_lowrate_flag, ISM_METADATA_INACTIVE_FLAG_BITS );
425 80 : hQMetaData->metadata_max_bits -= ISM_METADATA_INACTIVE_FLAG_BITS;
426 : }
427 : }
428 : }
429 :
430 11592 : if ( ivas_total_brate == IVAS_128k && nchan_ism >= 3 )
431 : {
432 288 : push_next_indice( hMetaData, flag_omasa_ener_brate, 1 );
433 288 : hQMetaData->metadata_max_bits -= 1;
434 : }
435 : }
436 : }
437 : else
438 : {
439 41066 : 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 7142 : if ( nchan_ism == 1 || nchan_ism == 2 )
443 : {
444 2318 : 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 4824 : 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 33924 : push_next_indice( hMetaData, nchan_transport - 1, MASA_TRANSP_BITS );
456 : }
457 41066 : hQMetaData->metadata_max_bits -= MASA_TRANSP_BITS;
458 : }
459 :
460 66274 : if ( ivas_format == MASA_ISM_FORMAT && ism_mode == ISM_MODE_NONE )
461 : {
462 7142 : if ( nchan_ism >= 3 ) /* if 3 or 4 objects */
463 : {
464 4824 : push_next_indice( hMetaData, 5 - nchan_ism, MASA_HEADER_BITS );
465 : }
466 : else
467 : {
468 2318 : push_next_indice( hMetaData, 3, MASA_HEADER_BITS );
469 : }
470 7142 : 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 59132 : push_next_indice( hMetaData, 0, MASA_HEADER_BITS );
477 59132 : hQMetaData->metadata_max_bits -= MASA_HEADER_BITS;
478 : }
479 66274 : if ( !( ivas_format == MASA_ISM_FORMAT && ism_mode == ISM_MODE_NONE && nchan_ism > 2 ) )
480 : {
481 : /* write number of directions */
482 61450 : push_next_indice( hMetaData, hQMetaData->no_directions - 1, 1 );
483 61450 : hQMetaData->metadata_max_bits -= 1;
484 : }
485 : /* write subframe mode */
486 66274 : push_next_indice( hMetaData, hQMetaData->q_direction[0].cfg.nblocks == 1 ? 1 : 0, MASA_SUBFRAME_BITS );
487 66274 : hQMetaData->metadata_max_bits -= MASA_SUBFRAME_BITS;
488 : }
489 :
490 72424 : if ( ivas_format == MC_FORMAT )
491 : {
492 : int16_t lfeBitsWritten;
493 6150 : lfeBitsWritten = encode_lfe_to_total_energy_ratio( hMasa, hMetaData, ivas_total_brate );
494 6150 : hQMetaData->metadata_max_bits -= lfeBitsWritten;
495 : }
496 :
497 : /* Move data from encoder to qmetadata */
498 72424 : if ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT )
499 : {
500 66274 : move_metadata_to_qmetadata( hMasa, hQMetaData );
501 : }
502 :
503 72424 : if ( hMasa->config.max_metadata_bits < MINIMUM_BIT_BUDGET_NORMAL_META && !hMasa->config.joinedSubframes )
504 : {
505 23123 : reduce_metadata_further( hMasa, hQMetaData, ivas_format );
506 :
507 23123 : 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 23123 : push_next_indice( hMetaData, hQMetaData->q_direction[0].cfg.nblocks == 1 ? 1 : 0, MASA_LOWBITRATE_MODE_BITS );
511 23123 : hQMetaData->metadata_max_bits -= MASA_LOWBITRATE_MODE_BITS;
512 : }
513 :
514 : /* Encode MASA+ISM metadata */
515 72424 : if ( ivas_format == MASA_ISM_FORMAT && ism_mode == ISM_MASA_MODE_PARAM_ONE_OBJ )
516 : {
517 : /* encode MASA/ISM energy ratios */
518 5790 : 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 66634 : if ( ivas_format == MASA_ISM_FORMAT )
523 : {
524 26560 : 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 72424 : masa_total_brate = ivas_total_brate;
530 72424 : if ( ivas_format == MASA_ISM_FORMAT && ism_mode == ISM_MASA_MODE_DISC )
531 : {
532 11592 : masa_total_brate = calculate_cpe_brate_MASA_ISM( ism_mode, ivas_total_brate, nchan_ism );
533 : }
534 :
535 72424 : if ( masa_total_brate >= IVAS_384k )
536 : {
537 3730 : if ( masa_total_brate >= IVAS_512k )
538 : {
539 1160 : 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 2570 : 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 68694 : if ( ( error = ivas_qmetadata_enc_encode( hMetaData, hQMetaData, 0 ) ) != IVAS_ERR_OK )
555 : {
556 0 : return error;
557 : }
558 : }
559 :
560 72424 : 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 5790 : ivas_omasa_modify_masa_energy_ratios( hQMetaData, hMasa->data.hOmasaData->masa_to_total_energy_ratio );
564 : }
565 :
566 72424 : *nb_bits_metadata = hMetaData->nb_bits_tot;
567 :
568 72424 : if ( ivas_format == MASA_FORMAT && Opt_DTX_ON )
569 : {
570 : /* save old values */
571 6174 : uint8_t numCodingBands = hMasa->config.numCodingBands;
572 6174 : uint8_t numTwoDirBands = hMasa->config.numTwoDirBands;
573 6174 : int16_t nbands = hQMetaData->q_direction[0].cfg.nbands;
574 6174 : uint8_t numberOfDirections = hMasa->config.numberOfDirections;
575 6174 : uint8_t numberOfDirectionsMeta = hMasa->masaMetadata.descriptive_meta.numberOfDirections;
576 6174 : uint16_t numberOfDirectionsQMetaData = hQMetaData->no_directions;
577 :
578 6174 : if ( !( hMasa->config.numberOfDirections == 1 && hQMetaData->q_direction->cfg.nbands == 5 ) )
579 : {
580 5853 : for ( i = 0; i < MASA_MAXIMUM_DIRECTIONS; i++ )
581 : {
582 19510 : for ( j = 0; j < MAX_PARAM_SPATIAL_SUBFRAMES; j++ )
583 : {
584 15608 : mvr2r( h_orig_metadata[i].azimuth[j], hMasa->masaMetadata.directional_meta[i].azimuth[j], MASA_FREQUENCY_BANDS );
585 15608 : mvr2r( h_orig_metadata[i].elevation[j], hMasa->masaMetadata.directional_meta[i].elevation[j], MASA_FREQUENCY_BANDS );
586 15608 : 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 1951 : hMasa->config.numCodingBands = 5;
592 1951 : hMasa->config.numTwoDirBands = 0;
593 1951 : combine_freqbands_and_subframes( hMasa );
594 1951 : hQMetaData->q_direction[0].cfg.nbands = 5;
595 :
596 1951 : if ( hMasa->config.numberOfDirections == 2 && hMasa->config.numTwoDirBands < hMasa->config.numCodingBands )
597 : {
598 : /* Combine directions */
599 80 : ivas_masa_combine_directions( hMasa );
600 :
601 : /* If we joined all bands, then metadata is now one directional. */
602 80 : if ( hMasa->config.numTwoDirBands == 0 )
603 : {
604 80 : hMasa->config.numberOfDirections = 1;
605 80 : hMasa->masaMetadata.descriptive_meta.numberOfDirections = 0;
606 80 : hQMetaData->no_directions = 1;
607 : }
608 : }
609 :
610 1951 : move_metadata_to_qmetadata( hMasa, hQMetaData );
611 :
612 11706 : for ( j = hQMetaData->q_direction[0].cfg.start_band; j < hQMetaData->q_direction[0].cfg.nbands; ++j )
613 : {
614 9755 : 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 6174 : free( h_orig_metadata );
619 :
620 6174 : ivas_qmetadata_enc_sid_encode( hMetaData, hQMetaData, masa_sid_descriptor, 0, ivas_format );
621 :
622 : /* restore old values */
623 6174 : hMasa->config.numCodingBands = numCodingBands;
624 6174 : hMasa->config.numTwoDirBands = numTwoDirBands;
625 6174 : hQMetaData->q_direction[0].cfg.nbands = nbands;
626 6174 : hMasa->config.numberOfDirections = numberOfDirections;
627 6174 : hMasa->masaMetadata.descriptive_meta.numberOfDirections = numberOfDirectionsMeta;
628 6174 : hQMetaData->no_directions = numberOfDirectionsQMetaData;
629 : }
630 :
631 72424 : return IVAS_ERR_OK;
632 : }
633 :
634 :
635 : /*-----------------------------------------------------------------------*
636 : * ivas_masa_estimate_energy()
637 : *
638 : *
639 : *-----------------------------------------------------------------------*/
640 :
641 66274 : 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 66274 : maxBin = (int16_t) ( (float) CLDFB_NO_CHANNELS_MAX * (float) input_frame / L_FRAME48k + 0.5f );
655 :
656 66274 : l_ts = input_frame / CLDFB_NO_COL_MAX;
657 :
658 331370 : for ( block_m_idx = 0; block_m_idx < MAX_PARAM_SPATIAL_SUBFRAMES; block_m_idx++ )
659 : {
660 265096 : mrange[0] = hMasa->config.block_grouping[block_m_idx];
661 265096 : mrange[1] = hMasa->config.block_grouping[block_m_idx + 1];
662 :
663 265096 : set_zero( hMasa->data.energy[block_m_idx], MASA_FREQUENCY_BANDS );
664 :
665 1325480 : for ( ts = mrange[0]; ts < mrange[1]; ts++ )
666 : {
667 2970624 : for ( i = 0; i < nchan_transport; i++ )
668 : {
669 1910240 : cldfbAnalysis_ts( &( data_f[i][l_ts * ts] ), Input_RealBuffer[i], Input_ImagBuffer[i], l_ts, hMasa->data.cldfbAnaEnc[i] );
670 : }
671 :
672 26509600 : for ( band_m_idx = 0; band_m_idx < MASA_FREQUENCY_BANDS; band_m_idx++ )
673 : {
674 25449216 : brange[0] = hMasa->config.band_grouping[band_m_idx];
675 25449216 : brange[1] = hMasa->config.band_grouping[band_m_idx + 1];
676 :
677 71294976 : for ( i = 0; i < nchan_transport; i++ )
678 : {
679 45845760 : if ( brange[0] > maxBin )
680 : {
681 72000 : hMasa->data.energy[block_m_idx][band_m_idx] = 0;
682 72000 : continue;
683 : }
684 45773760 : else if ( brange[1] >= maxBin )
685 : {
686 1975040 : brange[1] = maxBin;
687 : }
688 :
689 158612160 : for ( j = brange[0]; j < brange[1]; j++ )
690 : {
691 112838400 : 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 66274 : return;
699 : }
700 :
701 :
702 : /*-----------------------------------------------------------------------*
703 : * ivas_masa_enc_config()
704 : *
705 : * Frame-by-frame configuration of MASA encoder
706 : *-----------------------------------------------------------------------*/
707 :
708 66489 : 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 66489 : error = IVAS_ERR_OK;
727 :
728 66489 : hMasa = st_ivas->hMasa;
729 66489 : hQMetaData = st_ivas->hQMetaData;
730 66489 : ivas_format = st_ivas->hEncoderConfig->ivas_format;
731 66489 : ivas_total_brate = st_ivas->hEncoderConfig->ivas_total_brate;
732 :
733 66489 : ism_total_brate = 0;
734 66489 : 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 72326 : for ( i = 0; i < st_ivas->nSCE; i++ )
737 : {
738 47118 : ism_total_brate += st_ivas->hSCE[i]->element_brate;
739 : }
740 : }
741 :
742 66489 : 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 66489 : hQMetaData->is_masa_ivas_format = 1;
745 :
746 66489 : if ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT )
747 : {
748 66274 : masa_metadata_direction_alignment( hMasa );
749 :
750 66274 : 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 66274 : if ( hMasa->data.sync_state.frame_mode == MASA_FRAME_1SF && hMasa->data.sync_state.prev_offset != 0 )
753 : {
754 : /* average over sub-frames */
755 12004 : 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 66274 : detect_metadata_composition( hMasa, &joinedSubframes, &coherencePresent, &isActualTwoDir );
760 66274 : hMasa->config.joinedSubframes = joinedSubframes;
761 66274 : hMasa->config.coherencePresent = coherencePresent;
762 66274 : hMasa->config.numberOfDirections = ( hMasa->masaMetadata.descriptive_meta.numberOfDirections + 1 ) == 2 && isActualTwoDir ? 2 : 1;
763 : }
764 215 : 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 215 : hMasa->config.joinedSubframes = 0;
768 215 : hMasa->config.numberOfDirections = 1;
769 : }
770 :
771 66489 : if ( ivas_format == MASA_ISM_FORMAT )
772 : {
773 32350 : 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 34139 : 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 66489 : if ( hMasa->config.numberOfDirections == 2 )
782 : {
783 23553 : set_f( hMasa->data.importanceWeight, 1.0f, hMasa->config.numCodingBands );
784 :
785 23553 : if ( hMasa->config.numCodingBands == 5 )
786 : {
787 15551 : hMasa->data.importanceWeight[4] = 0.7f;
788 : }
789 8002 : else if ( hMasa->config.numCodingBands == 8 )
790 : {
791 1617 : hMasa->data.importanceWeight[7] = 0.7f;
792 : }
793 6385 : 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 6385 : else if ( hMasa->config.numCodingBands == 12 )
799 : {
800 3089 : hMasa->data.importanceWeight[10] = 0.7f;
801 3089 : hMasa->data.importanceWeight[11] = 0.1f;
802 : }
803 3296 : else if ( hMasa->config.numCodingBands == 18 )
804 : {
805 2024 : hMasa->data.importanceWeight[14] = 0.8f;
806 2024 : hMasa->data.importanceWeight[15] = 0.5f;
807 2024 : hMasa->data.importanceWeight[16] = 0.2f;
808 2024 : hMasa->data.importanceWeight[17] = 0.0f;
809 : }
810 1272 : else if ( hMasa->config.numCodingBands == 24 )
811 : {
812 1272 : hMasa->data.importanceWeight[20] = 0.8f;
813 1272 : hMasa->data.importanceWeight[21] = 0.5f;
814 1272 : hMasa->data.importanceWeight[22] = 0.2f;
815 1272 : hMasa->data.importanceWeight[23] = 0.0f;
816 : }
817 :
818 23553 : if ( hMasa->config.numTwoDirBands == hMasa->config.numCodingBands )
819 : {
820 286 : set_c( (int8_t *) hMasa->data.twoDirBands, 1, hMasa->config.numCodingBands );
821 : }
822 : }
823 : else
824 : {
825 42936 : set_c( (int8_t *) hMasa->data.twoDirBands, 0, hMasa->config.numCodingBands );
826 : }
827 :
828 : /* Set qmeta to correct values */
829 66489 : 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 142923 : for ( i = 0; i < hQMetaData->no_directions; i++ )
835 : {
836 76434 : hQMetaData->q_direction[i].cfg.nbands = hMasa->config.numCodingBands;
837 76434 : hQMetaData->q_direction[i].cfg.nblocks = hMasa->config.joinedSubframes == TRUE ? 1 : MAX_PARAM_SPATIAL_SUBFRAMES;
838 :
839 76434 : if ( ivas_format == MC_FORMAT )
840 : {
841 215 : 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 76219 : hQMetaData->q_direction[i].cfg.mc_ls_setup = MC_LS_SETUP_INVALID;
847 : }
848 : }
849 :
850 66489 : hQMetaData->all_coherence_zero = !hMasa->config.coherencePresent;
851 :
852 66489 : ivas_set_qmetadata_maxbit_req( hQMetaData, ivas_format );
853 :
854 : /* Find maximum band usable */
855 66489 : maxBin = (int16_t) ( st_ivas->hEncoderConfig->input_Fs * INV_CLDFB_BANDWIDTH );
856 66489 : maxBand = 0;
857 1724324 : while ( maxBand <= MASA_FREQUENCY_BANDS && MASA_band_grouping_24[maxBand] <= maxBin )
858 : {
859 1657835 : maxBand++;
860 : }
861 66489 : maxBand--;
862 :
863 66489 : st_ivas->hQMetaData->q_direction->cfg.inactiveBands = 0;
864 66489 : masa_total_brate = ivas_total_brate;
865 66489 : if ( ivas_format == MASA_ISM_FORMAT && st_ivas->ism_mode == ISM_MASA_MODE_DISC )
866 : {
867 11592 : masa_total_brate = calculate_cpe_brate_MASA_ISM( st_ivas->ism_mode, ivas_total_brate, st_ivas->hEncoderConfig->nchan_ism );
868 : }
869 66489 : if ( masa_total_brate >= IVAS_384k && ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT ) )
870 : {
871 : int16_t continueLoop;
872 3730 : continueLoop = 1;
873 8404 : while ( maxBand > 5 && continueLoop )
874 : {
875 8678 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
876 : {
877 7693 : if ( hMasa->data.energy[sf][maxBand - 1] > 100000 )
878 : {
879 3689 : continueLoop = 0;
880 3689 : break;
881 : }
882 : }
883 4674 : if ( continueLoop )
884 : {
885 985 : maxBand--;
886 : }
887 : }
888 :
889 3730 : if ( maxBand < MASA_MAXIMUM_CODING_SUBBANDS )
890 : {
891 502 : st_ivas->hQMetaData->q_direction->cfg.inactiveBands = MASA_MAXIMUM_CODING_SUBBANDS - maxBand;
892 : }
893 : else
894 : {
895 3228 : st_ivas->hQMetaData->q_direction->cfg.inactiveBands = 0;
896 : }
897 : }
898 :
899 66489 : masa_sample_rate_band_correction( &( hMasa->config ), hMasa->data.band_mapping, hQMetaData, maxBand, masa_total_brate >= IVAS_384k, NULL );
900 :
901 66489 : if ( hMasa->config.numTwoDirBands >= hMasa->config.numCodingBands )
902 : {
903 288 : hMasa->config.numTwoDirBands = hMasa->config.numCodingBands;
904 288 : 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 66489 : 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 25033 : st_ivas->hCPE[0]->hStereoDft->hConfig->force_mono_transmission = ( ivas_total_brate - ism_total_brate < MASA_STEREO_MIN_BITRATE ) ? 1 : 0;
911 : }
912 :
913 66489 : 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 25208 : 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 11759 : st_ivas->hMasa->data.hOmasaData->lp_noise_CPE = st_ivas->hCPE[0]->hCoreCoder[0]->lp_noise;
918 : }
919 : else
920 : {
921 13449 : 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 66489 : 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 13177 : 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 13177 : float surrCohSignificanceCoef = 0.4f;
946 13177 : float threshold = 0.1f;
947 :
948 25866 : for ( sf = 0; sf < nSubFrames; sf++ )
949 : {
950 15943 : surrCohToTotalSum = 0.0f;
951 15943 : surrCohToTotalTimesDiffSum = 0.0f;
952 15943 : diffSum = 0.0f;
953 387251 : for ( band = 0; band < nBands; band++ )
954 : {
955 371308 : surrCohToTotal = diffuse_to_total_ratio[sf][band] * surroundingCoherence[sf][band];
956 371308 : surrCohToTotalSum += surrCohToTotal;
957 371308 : surrCohToTotalTimesDiffSum += diffuse_to_total_ratio[sf][band] * surrCohToTotal;
958 371308 : diffSum += diffuse_to_total_ratio[sf][band];
959 : }
960 15943 : significanceMeasure1 = surrCohToTotalSum / (float) nBands;
961 15943 : significanceMeasure2 = surrCohSignificanceCoef * surrCohToTotalTimesDiffSum / ( diffSum + EPSILON );
962 15943 : significanceMeasure = max( significanceMeasure1, significanceMeasure2 );
963 :
964 15943 : if ( significanceMeasure > threshold )
965 : {
966 3254 : return 1; /* Surrounding coherence was significant in at least one subframe */
967 : }
968 : }
969 :
970 9923 : return 0; /* Surrounding coherence was not significant in any subframe */
971 : }
972 :
973 :
974 : /*-----------------------------------------------------------------------*
975 : * Local functions
976 : *-----------------------------------------------------------------------*/
977 :
978 68225 : 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 68225 : numCodingBands = hMasa->config.numCodingBands;
1004 68225 : numDirections = hMasa->config.numberOfDirections;
1005 68225 : numSf = hMasa->config.joinedSubframes == TRUE ? 1 : MAX_PARAM_SPATIAL_SUBFRAMES;
1006 68225 : hMeta = &( hMasa->masaMetadata );
1007 :
1008 68225 : mergeRatiosOverSubframes = hMasa->config.mergeRatiosOverSubframes;
1009 68225 : 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 68225 : if ( numSf == 1 )
1015 : {
1016 113772 : for ( j = 1; j < MAX_PARAM_SPATIAL_SUBFRAMES; j++ )
1017 : {
1018 2133225 : for ( k = 0; k < MASA_FREQUENCY_BANDS; k++ )
1019 : {
1020 2047896 : hMasa->data.energy[0][k] += hMasa->data.energy[j][k];
1021 : }
1022 : }
1023 : }
1024 :
1025 68225 : if ( numCodingBands <= MAX_REDUCED_NBANDS )
1026 : {
1027 : /* reduce metadata *frequency* resolution. time resolution is not touched */
1028 147715 : for ( i = 0; i < numDirections; i++ )
1029 : {
1030 320243 : for ( j = 0; j < numSf; j++ ) /* NB: for numSf==1, operates only on first sub-frame */
1031 : {
1032 5880100 : for ( k = 0; k < MASA_FREQUENCY_BANDS; k++ )
1033 : {
1034 5644896 : aziRad = hMeta->directional_meta[i].azimuth[j][k] / 180.0f * EVS_PI;
1035 5644896 : eleRad = hMeta->directional_meta[i].elevation[j][k] / 180.0f * EVS_PI;
1036 5644896 : vecLen = hMeta->directional_meta[i].energy_ratio[j][k] * hMasa->data.energy[j][k];
1037 :
1038 5644896 : x[i][j][k] = cosf( aziRad ) * cosf( eleRad ) * vecLen;
1039 5644896 : y[i][j][k] = sinf( aziRad ) * cosf( eleRad ) * vecLen;
1040 5644896 : z[i][j][k] = sinf( eleRad ) * vecLen;
1041 : }
1042 : }
1043 : }
1044 :
1045 147715 : for ( i = 0; i < numDirections; i++ )
1046 : {
1047 320243 : for ( j = 0; j < numSf; j++ )
1048 : {
1049 1746884 : for ( k = 0; k < numCodingBands; k++ )
1050 : {
1051 1511680 : brange[0] = hMasa->data.band_mapping[k];
1052 1511680 : brange[1] = hMasa->data.band_mapping[k + 1];
1053 :
1054 1511680 : xSum = 0.0f;
1055 1511680 : ySum = 0.0f;
1056 1511680 : zSum = 0.0f;
1057 1511680 : energySum = 0.0f;
1058 1511680 : spreadCohSum = 0.0f;
1059 :
1060 7040173 : for ( m = brange[0]; m < brange[1]; m++ )
1061 : {
1062 5528493 : xSum += x[i][j][m];
1063 5528493 : ySum += y[i][j][m];
1064 5528493 : zSum += z[i][j][m];
1065 5528493 : energySum += hMasa->data.energy[j][m];
1066 : }
1067 :
1068 1511680 : aziRad = atan2f( ySum, xSum );
1069 1511680 : eleRad = atan2f( zSum, sqrtf( xSum * xSum + ySum * ySum ) );
1070 :
1071 1511680 : hMeta->directional_meta[i].azimuth[j][k] = aziRad / EVS_PI * 180.0f;
1072 1511680 : hMeta->directional_meta[i].elevation[j][k] = eleRad / EVS_PI * 180.0f;
1073 :
1074 1511680 : vecLen = sqrtf( xSum * xSum + ySum * ySum + zSum * zSum );
1075 1511680 : hMeta->directional_meta[i].energy_ratio[j][k] = vecLen / ( energySum + EPSILON );
1076 :
1077 1511680 : if ( computeCoherence )
1078 : {
1079 3213733 : for ( m = brange[0]; m < brange[1]; m++ )
1080 : {
1081 2411141 : spreadCohSum += hMeta->directional_meta[i].spread_coherence[j][m] * hMasa->data.energy[j][m];
1082 : }
1083 802592 : hMeta->directional_meta[i].spread_coherence[j][k] = spreadCohSum / ( energySum + EPSILON );
1084 :
1085 802592 : if ( i == 0 )
1086 : {
1087 577530 : surrCohSum = 0.0f;
1088 2285125 : for ( m = brange[0]; m < brange[1]; m++ )
1089 : {
1090 1707595 : surrCohSum += hMeta->common_meta.surround_coherence[j][m] * hMasa->data.energy[j][m];
1091 : }
1092 577530 : hMeta->common_meta.surround_coherence[j][k] = surrCohSum / ( energySum + EPSILON );
1093 : }
1094 : }
1095 :
1096 1511680 : if ( i == 0 )
1097 : {
1098 1119313 : energy[j][k] = energySum;
1099 : }
1100 : }
1101 : }
1102 : }
1103 : }
1104 5549 : else if ( mergeRatiosOverSubframes ) /* keep frequency resolution */
1105 : {
1106 3825 : for ( j = 0; j < numSf; j++ )
1107 : {
1108 76500 : for ( k = 0; k < numCodingBands; k++ )
1109 : {
1110 73440 : energy[j][k] = hMasa->data.energy[j][k];
1111 : }
1112 : }
1113 : }
1114 :
1115 68225 : if ( mergeRatiosOverSubframes )
1116 : {
1117 256610 : for ( k = 0; k < numCodingBands; k++ )
1118 : {
1119 220036 : energySum = 0.0f;
1120 1100180 : for ( j = 0; j < numSf; j++ )
1121 : {
1122 880144 : energySum += energy[j][k];
1123 : }
1124 :
1125 220036 : if ( computeCoherence )
1126 : {
1127 119379 : surrCohSum = 0.0f;
1128 596895 : for ( j = 0; j < numSf; j++ )
1129 : {
1130 477516 : surrCohSum += energy[j][k] * hMeta->common_meta.surround_coherence[j][k];
1131 : }
1132 119379 : surrCohTemp = surrCohSum / ( energySum + EPSILON );
1133 :
1134 596895 : for ( j = 0; j < numSf; j++ )
1135 : {
1136 477516 : hMeta->common_meta.surround_coherence[j][k] = surrCohTemp;
1137 : }
1138 : }
1139 :
1140 509192 : for ( i = 0; i < numDirections; i++ )
1141 : {
1142 289156 : energyRatioSum = 0.0f;
1143 1445780 : for ( j = 0; j < numSf; j++ )
1144 : {
1145 1156624 : energyRatioSum += energy[j][k] * hMeta->directional_meta[i].energy_ratio[j][k];
1146 : }
1147 289156 : energyRatioTemp = energyRatioSum / ( energySum + EPSILON );
1148 :
1149 1445780 : for ( j = 0; j < numSf; j++ )
1150 : {
1151 1156624 : hMeta->directional_meta[i].energy_ratio[j][k] = energyRatioTemp;
1152 : }
1153 : }
1154 : }
1155 : }
1156 :
1157 68225 : return;
1158 : }
1159 :
1160 :
1161 : /*-------------------------------------------------------------------*
1162 : * ivas_masa_combine_directions()
1163 : *
1164 : *
1165 : *-------------------------------------------------------------------*/
1166 :
1167 23345 : 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 23345 : numCodingBands = hMasa->config.numCodingBands;
1199 23345 : numDirections = hMasa->config.numberOfDirections;
1200 23345 : numSf = hMasa->config.joinedSubframes == TRUE ? 1 : MAX_PARAM_SPATIAL_SUBFRAMES;
1201 :
1202 23345 : hMeta = &( hMasa->masaMetadata );
1203 :
1204 23345 : computeCoherence = hMasa->config.useCoherence && hMasa->config.coherencePresent;
1205 :
1206 70035 : for ( i = 0; i < numDirections; i++ )
1207 : {
1208 176036 : for ( j = 0; j < numSf; j++ )
1209 : {
1210 1820302 : for ( k = 0; k < numCodingBands; k++ )
1211 : {
1212 1690956 : aziRad = hMeta->directional_meta[i].azimuth[j][k] / 180.0f * EVS_PI;
1213 1690956 : eleRad = hMeta->directional_meta[i].elevation[j][k] / 180.0f * EVS_PI;
1214 1690956 : vecLen = hMeta->directional_meta[i].energy_ratio[j][k];
1215 :
1216 1690956 : x[i][j][k] = cosf( aziRad ) * cosf( eleRad ) * vecLen;
1217 1690956 : y[i][j][k] = sinf( aziRad ) * cosf( eleRad ) * vecLen;
1218 1690956 : z[i][j][k] = sinf( eleRad ) * vecLen;
1219 : }
1220 : }
1221 : }
1222 :
1223 : /* Compute sum vector */
1224 88018 : for ( j = 0; j < numSf; j++ )
1225 : {
1226 910151 : for ( k = 0; k < numCodingBands; k++ )
1227 : {
1228 845478 : xSum[j][k] = x[0][j][k] + x[1][j][k];
1229 845478 : ySum[j][k] = y[0][j][k] + y[1][j][k];
1230 845478 : zSum[j][k] = z[0][j][k] + z[1][j][k];
1231 845478 : 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 23345 : if ( hMasa->config.numTwoDirBands > 0 )
1236 : {
1237 : /* Estimate the importance of having two directions instead of one */
1238 119685 : for ( i = 0; i < numCodingBands; i++ )
1239 : {
1240 110028 : importance[i] = 0.0f;
1241 368142 : for ( j = 0; j < numSf; j++ )
1242 : {
1243 258114 : tempImportance = hMeta->directional_meta[0].energy_ratio[j][i] + hMeta->directional_meta[1].energy_ratio[j][i] - sumVecLen[j][i];
1244 258114 : importance[i] += tempImportance;
1245 : }
1246 110028 : importance[i] /= (float) numSf;
1247 110028 : importance[i] *= hMasa->data.importanceWeight[i];
1248 : }
1249 :
1250 : /* Determine bands where to use two directions */
1251 9657 : find_n_largest( importance, indicesOfLargest, numCodingBands, hMasa->config.numTwoDirBands );
1252 : }
1253 :
1254 353597 : for ( i = 0; i < numCodingBands; i++ )
1255 : {
1256 330252 : hMasa->data.twoDirBands[i] = 0;
1257 : }
1258 :
1259 60516 : for ( i = 0; i < hMasa->config.numTwoDirBands; i++ )
1260 : {
1261 37171 : hMasa->data.twoDirBands[indicesOfLargest[i]] = 1;
1262 : }
1263 :
1264 : /* Combine directions on the remaining bands */
1265 353597 : for ( i = 0; i < numCodingBands; i++ )
1266 : {
1267 330252 : if ( hMasa->data.twoDirBands[i] == 0 )
1268 : {
1269 1045873 : for ( j = 0; j < numSf; j++ )
1270 : {
1271 752792 : aziRad = atan2f( ySum[j][i], xSum[j][i] );
1272 752792 : eleRad = atan2f( zSum[j][i], sqrtf( xSum[j][i] * xSum[j][i] + ySum[j][i] * ySum[j][i] ) );
1273 :
1274 752792 : hMeta->directional_meta[0].azimuth[j][i] = aziRad / EVS_PI * 180.0f;
1275 752792 : hMeta->directional_meta[0].elevation[j][i] = eleRad / EVS_PI * 180.0f;
1276 :
1277 752792 : ratioSum = hMeta->directional_meta[0].energy_ratio[j][i] + hMeta->directional_meta[1].energy_ratio[j][i];
1278 752792 : if ( computeCoherence )
1279 : {
1280 195334 : hMeta->directional_meta[0].spread_coherence[j][i] =
1281 195334 : ( 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 );
1282 : }
1283 :
1284 752792 : ambience2dir = 1.0f - ratioSum;
1285 752792 : 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 );
1286 752792 : hMeta->directional_meta[1].energy_ratio[j][i] = 0.0f;
1287 752792 : hMeta->common_meta.diffuse_to_total_ratio[j][i] = 1.0f - hMeta->directional_meta[0].energy_ratio[j][i];
1288 752792 : if ( computeCoherence )
1289 : {
1290 195334 : ambience1dir = 1.0f - hMeta->directional_meta[0].energy_ratio[j][i];
1291 195334 : ambienceIncrease = max( ambience1dir - ambience2dir, 0.0f );
1292 :
1293 195334 : origSurrCohEne = ambience2dir * hMeta->common_meta.surround_coherence[j][i];
1294 195334 : newSurrCohEne = ambienceIncrease * hMeta->directional_meta[0].spread_coherence[j][i];
1295 195334 : hMeta->common_meta.surround_coherence[j][i] = min( 1.0f, ( origSurrCohEne + newSurrCohEne ) / ( ambience1dir + EPSILON ) );
1296 : }
1297 : }
1298 : }
1299 : }
1300 :
1301 23345 : return;
1302 : }
1303 :
1304 :
1305 9657 : static void find_n_largest(
1306 : const float *input,
1307 : int16_t *largestIndices,
1308 : const int16_t numElements,
1309 : const int16_t numLargest )
1310 : {
1311 : int16_t i, j;
1312 : float largestValue;
1313 : int16_t largestIndex;
1314 : float values[MASA_FREQUENCY_BANDS];
1315 :
1316 119685 : for ( j = 0; j < numElements; j++ )
1317 : {
1318 110028 : values[j] = input[j];
1319 : }
1320 :
1321 46828 : for ( i = 0; i < numLargest; i++ )
1322 : {
1323 37171 : largestValue = values[0];
1324 37171 : largestIndex = 0;
1325 583562 : for ( j = 1; j < numElements; j++ )
1326 : {
1327 546391 : if ( values[j] > largestValue )
1328 : {
1329 77535 : largestValue = values[j];
1330 77535 : largestIndex = j;
1331 : }
1332 : }
1333 37171 : largestIndices[i] = largestIndex;
1334 37171 : values[largestIndex] = -1.0f;
1335 : }
1336 :
1337 9657 : return;
1338 : }
1339 :
1340 :
1341 68225 : static void move_metadata_to_qmetadata(
1342 : const MASA_ENCODER_HANDLE hMasa,
1343 : IVAS_QMETADATA_HANDLE hQMeta )
1344 : {
1345 : int16_t dir, sf, band;
1346 : uint8_t numCodingBands;
1347 : uint8_t numDirections;
1348 : uint8_t numSf;
1349 : MASA_METADATA_HANDLE hMeta;
1350 :
1351 68225 : numCodingBands = hMasa->config.numCodingBands;
1352 68225 : numDirections = hMasa->config.numberOfDirections;
1353 68225 : numSf = hMasa->config.joinedSubframes == TRUE ? 1 : MAX_PARAM_SPATIAL_SUBFRAMES;
1354 68225 : hMeta = &( hMasa->masaMetadata );
1355 :
1356 146395 : for ( dir = 0; dir < numDirections; dir++ )
1357 : {
1358 293692 : for ( sf = 0; sf < numSf; sf++ )
1359 : {
1360 1956265 : for ( band = 0; band < numCodingBands; band++ )
1361 : {
1362 1740743 : hQMeta->q_direction[dir].band_data[band].azimuth[sf] = hMeta->directional_meta[dir].azimuth[sf][band];
1363 1740743 : hQMeta->q_direction[dir].band_data[band].elevation[sf] = hMeta->directional_meta[dir].elevation[sf][band];
1364 1740743 : hQMeta->q_direction[dir].band_data[band].energy_ratio[sf] = hMeta->directional_meta[dir].energy_ratio[sf][band];
1365 1740743 : hQMeta->q_direction[dir].band_data[band].spherical_index[sf] = hMeta->directional_meta[dir].spherical_index[sf][band];
1366 1740743 : if ( hQMeta->q_direction[dir].coherence_band_data != NULL )
1367 : {
1368 1268705 : hQMeta->q_direction[dir].coherence_band_data[band].spread_coherence[sf] = (uint8_t) roundf( hMeta->directional_meta[dir].spread_coherence[sf][band] * UINT8_MAX );
1369 : }
1370 : }
1371 : }
1372 : }
1373 :
1374 255796 : for ( sf = 0; sf < numSf; sf++ )
1375 : {
1376 1650942 : for ( band = 0; band < numCodingBands; band++ )
1377 : {
1378 1463371 : if ( hQMeta->surcoh_band_data != NULL )
1379 : {
1380 991333 : hQMeta->surcoh_band_data[band].surround_coherence[sf] = (uint8_t) roundf( hMeta->common_meta.surround_coherence[sf][band] * UINT8_MAX );
1381 : }
1382 : }
1383 : }
1384 :
1385 68225 : if ( numDirections > 1 )
1386 : {
1387 126847 : for ( band = 0; band < numCodingBands; band++ )
1388 : {
1389 116902 : hQMeta->twoDirBands[band] = hMasa->data.twoDirBands[band];
1390 : }
1391 9945 : hQMeta->numTwoDirBands = hMasa->config.numTwoDirBands;
1392 : }
1393 :
1394 : /* Copy spread coherence for DCT-based coding */
1395 68225 : if ( numSf == 1 && hMasa->config.useCoherence )
1396 : {
1397 33733 : for ( dir = 0; dir < numDirections; dir++ )
1398 : {
1399 75352 : for ( sf = 1; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1400 : {
1401 977241 : for ( band = 0; band < numCodingBands; band++ )
1402 : {
1403 920727 : hQMeta->q_direction[dir].coherence_band_data[band].spread_coherence[sf] = hQMeta->q_direction[dir].coherence_band_data[band].spread_coherence[0];
1404 : }
1405 : }
1406 : }
1407 : }
1408 :
1409 68225 : return;
1410 : }
1411 :
1412 :
1413 : /* This function studies parametric MASA metadata to provide information for codec configuration */
1414 66274 : static void detect_metadata_composition(
1415 : const MASA_ENCODER_HANDLE hMasa, /* i : MASA encoder data */
1416 : uint8_t *joinedSubframes, /* o : Result of subframe composition */
1417 : uint8_t *coherencePresent, /* o : Result of coherence presence */
1418 : uint8_t *isTwoDir /* o : Result of two direction check */
1419 : )
1420 : {
1421 : MASA_METADATA_FRAME *hMeta;
1422 : int8_t sf, band, dir, numDir;
1423 : int16_t nSubFrames;
1424 66274 : uint8_t dirValid[2] = { FALSE, FALSE };
1425 66274 : uint8_t cohPresent = FALSE;
1426 66274 : uint8_t sfDiffer = FALSE;
1427 : uint8_t sfSimilar;
1428 :
1429 66274 : hMeta = &( hMasa->masaMetadata );
1430 66274 : numDir = hMeta->descriptive_meta.numberOfDirections + 1;
1431 :
1432 66274 : *isTwoDir = FALSE;
1433 :
1434 : /* First check for valid two directions */
1435 66274 : if ( numDir == 1 )
1436 : {
1437 40202 : dirValid[0] = TRUE;
1438 : }
1439 : else
1440 : {
1441 : /* Default assumption */
1442 26072 : *isTwoDir = TRUE;
1443 :
1444 : /* Check for direct-to-total ratio values */
1445 78216 : for ( dir = 0; dir < numDir; dir++ )
1446 : {
1447 52144 : sf = 0;
1448 112250 : while ( !dirValid[dir] && sf < MAX_PARAM_SPATIAL_SUBFRAMES )
1449 : {
1450 60106 : band = 0;
1451 364588 : while ( !dirValid[dir] && band < MASA_FREQUENCY_BANDS )
1452 : {
1453 304482 : if ( hMeta->directional_meta[dir].energy_ratio[sf][band] >= MASA_RATIO_THRESHOLD )
1454 : {
1455 49490 : dirValid[dir] = TRUE;
1456 : }
1457 304482 : band++;
1458 : }
1459 60106 : sf++;
1460 : }
1461 : }
1462 :
1463 26072 : if ( dirValid[1] == FALSE )
1464 : {
1465 : /* This handles also case where both are false. Then we just use first dir metadata. */
1466 135 : *isTwoDir = FALSE;
1467 : }
1468 25937 : else if ( dirValid[0] == FALSE && dirValid[1] == TRUE )
1469 : {
1470 2384 : *isTwoDir = FALSE;
1471 : /* Copy data to first direction */
1472 11920 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1473 : {
1474 238400 : for ( band = 0; band < MASA_FREQUENCY_BANDS; band++ )
1475 : {
1476 228864 : hMeta->directional_meta[0].spherical_index[sf][band] = hMeta->directional_meta[1].spherical_index[sf][band];
1477 228864 : hMeta->directional_meta[0].azimuth[sf][band] = hMeta->directional_meta[1].azimuth[sf][band];
1478 228864 : hMeta->directional_meta[0].elevation[sf][band] = hMeta->directional_meta[1].elevation[sf][band];
1479 228864 : hMeta->directional_meta[0].energy_ratio[sf][band] = hMeta->directional_meta[1].energy_ratio[sf][band];
1480 228864 : hMeta->directional_meta[0].spread_coherence[sf][band] = hMeta->directional_meta[1].spread_coherence[sf][band];
1481 : }
1482 : }
1483 : }
1484 :
1485 26072 : if ( *isTwoDir == FALSE )
1486 : {
1487 : /* Further checks will be done with just one direction */
1488 2519 : numDir = 1;
1489 : }
1490 : }
1491 :
1492 : /* Check if data over subframes is identical. Check is done by comparing to first subframe. */
1493 66274 : sfSimilar = TRUE;
1494 66274 : sf = 1;
1495 201610 : while ( ( sfSimilar == TRUE ) && ( sf < MAX_PARAM_SPATIAL_SUBFRAMES ) )
1496 : {
1497 135336 : sfSimilar = are_masa_subframes_similar( hMeta, 0, hMeta, sf );
1498 135336 : sf++;
1499 : }
1500 66274 : sfDiffer = sfSimilar == TRUE ? FALSE : TRUE;
1501 :
1502 : /* Further checks can be done with just one subframe if they are identical */
1503 66274 : nSubFrames = sfDiffer == TRUE ? MAX_PARAM_SPATIAL_SUBFRAMES : 1;
1504 :
1505 : /* Check spread coherence */
1506 66274 : dir = 0;
1507 132712 : while ( cohPresent == FALSE && dir < numDir )
1508 : {
1509 66438 : sf = 0;
1510 137514 : while ( cohPresent == FALSE && sf < nSubFrames )
1511 : {
1512 71076 : band = 0;
1513 656040 : while ( cohPresent == FALSE && band < MASA_FREQUENCY_BANDS )
1514 : {
1515 : /* Check coherences for presence of coherence */
1516 584964 : if ( hMeta->directional_meta[dir].spread_coherence[sf][band] >= MASA_COHERENCE_THRESHOLD )
1517 : {
1518 53693 : cohPresent = TRUE;
1519 : }
1520 584964 : band++;
1521 : }
1522 71076 : sf++;
1523 : }
1524 66438 : dir++;
1525 : }
1526 :
1527 : /* Check surround coherence separately if we do not have already knowledge of coherence */
1528 66274 : if ( cohPresent == FALSE )
1529 : {
1530 12581 : cohPresent = ivas_masa_surrcoh_signicant( hMeta->common_meta.surround_coherence, hMeta->common_meta.diffuse_to_total_ratio, nSubFrames, MASA_FREQUENCY_BANDS );
1531 : }
1532 :
1533 : /* Set output flags */
1534 66274 : *joinedSubframes = sfDiffer == TRUE ? FALSE : TRUE;
1535 66274 : *coherencePresent = cohPresent;
1536 :
1537 66274 : return;
1538 : }
1539 :
1540 :
1541 : /* Check and compensate energy ratios. This function verifies that energy ratios follow the principle of summing to one.
1542 : * In addition, it implements simple remainder-to-total handling where remainder energy is proportionally added to other
1543 : * ratios. */
1544 66274 : static void compensate_energy_ratios(
1545 : MASA_ENCODER_HANDLE hMasa )
1546 : {
1547 : int16_t sf, band, dir;
1548 : float ratioSum;
1549 : MASA_METADATA_HANDLE hMeta;
1550 : uint8_t numDirs;
1551 :
1552 66274 : hMeta = &( hMasa->masaMetadata );
1553 66274 : numDirs = hMasa->config.numberOfDirections;
1554 :
1555 331370 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1556 : {
1557 6627400 : for ( band = 0; band < MASA_FREQUENCY_BANDS; band++ )
1558 : {
1559 : /* Remainder is always set to zero and energy removal is compensated in following steps
1560 : * to other ratios. */
1561 6362304 : hMeta->common_meta.remainder_to_total_ratio[sf][band] = 0.0f;
1562 :
1563 6362304 : ratioSum = 0;
1564 14985696 : for ( dir = 0; dir < numDirs; dir++ )
1565 : {
1566 8623392 : ratioSum += hMeta->directional_meta[dir].energy_ratio[sf][band];
1567 : }
1568 6362304 : ratioSum += hMeta->common_meta.diffuse_to_total_ratio[sf][band];
1569 :
1570 6362304 : if ( ratioSum == 0.0f )
1571 : {
1572 0 : for ( dir = 0; dir < numDirs; dir++ )
1573 : {
1574 0 : hMeta->directional_meta[dir].energy_ratio[sf][band] = 0.0f;
1575 : }
1576 0 : hMeta->common_meta.diffuse_to_total_ratio[sf][band] = 1.0f;
1577 : }
1578 6362304 : else if ( ratioSum != 1.0f )
1579 : {
1580 365040 : for ( dir = 0; dir < numDirs; dir++ )
1581 : {
1582 243360 : hMeta->directional_meta[dir].energy_ratio[sf][band] /= ratioSum;
1583 : }
1584 121680 : hMeta->common_meta.diffuse_to_total_ratio[sf][band] /= ratioSum;
1585 : }
1586 : }
1587 : }
1588 :
1589 66274 : return;
1590 : }
1591 :
1592 :
1593 : /* 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 */
1594 23123 : static void reduce_metadata_further(
1595 : MASA_ENCODER_HANDLE hMasa,
1596 : IVAS_QMETADATA_HANDLE hqmetadata,
1597 : const IVAS_FORMAT ivas_format )
1598 : {
1599 : int16_t sf;
1600 : int16_t band;
1601 : int16_t selectedBand;
1602 : float energy[MAX_PARAM_SPATIAL_SUBFRAMES][LOWBITRATE_NUM_BANDS];
1603 : float totalEnergySum;
1604 : uint8_t numCodingBands;
1605 : uint8_t computeCoherence;
1606 : float onset_filter;
1607 : float bandEnergy;
1608 : uint8_t mergeOverFreqBands;
1609 : float meanRatio;
1610 :
1611 23123 : numCodingBands = hMasa->config.numCodingBands;
1612 23123 : computeCoherence = hMasa->config.useCoherence && hMasa->config.coherencePresent;
1613 :
1614 : /* Set default values */
1615 23123 : selectedBand = 0;
1616 23123 : mergeOverFreqBands = 0;
1617 :
1618 : /* Get energy for the input data in 4-subframe, 5-band format */
1619 23123 : totalEnergySum = 0.0f;
1620 23123 : if ( ivas_format == MASA_FORMAT || ivas_format == MASA_ISM_FORMAT ) /* Energy data is in 4-subframe, 24-band format */
1621 : {
1622 95990 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1623 : {
1624 : int16_t brange[2];
1625 : float eneSum;
1626 : int16_t m;
1627 :
1628 460752 : for ( band = 0; band < numCodingBands; band++ )
1629 : {
1630 383960 : brange[0] = hMasa->data.band_mapping[band];
1631 383960 : brange[1] = hMasa->data.band_mapping[band + 1];
1632 :
1633 383960 : eneSum = 0.0f;
1634 2221840 : for ( m = brange[0]; m < brange[1]; m++ )
1635 : {
1636 1837880 : eneSum += hMasa->data.energy[sf][m];
1637 : }
1638 383960 : energy[sf][band] = eneSum;
1639 383960 : totalEnergySum += eneSum;
1640 : }
1641 : }
1642 : }
1643 : else /* Energy data is already in 4-subframe, 5-band format */
1644 : {
1645 19625 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1646 : {
1647 94200 : for ( band = 0; band < numCodingBands; band++ )
1648 : {
1649 78500 : energy[sf][band] = hMasa->data.energy[sf][band];
1650 78500 : totalEnergySum += energy[sf][band];
1651 : }
1652 : }
1653 : }
1654 :
1655 : /* Determine onsets */
1656 23123 : hMasa->data.onset_detector_1 = hMasa->data.onset_detector_1 * LOWBITRATE_ONSET_ALPHA;
1657 23123 : hMasa->data.onset_detector_1 = max( hMasa->data.onset_detector_1, totalEnergySum );
1658 :
1659 23123 : hMasa->data.onset_detector_2 = LOWBITRATE_ONSET_BETA * hMasa->data.onset_detector_2 + ( 1.0f - LOWBITRATE_ONSET_BETA ) * hMasa->data.onset_detector_1;
1660 23123 : hMasa->data.onset_detector_2 = LOWBITRATE_ONSET_GAIN * min( hMasa->data.onset_detector_1, hMasa->data.onset_detector_2 );
1661 :
1662 23123 : onset_filter = min( max( hMasa->data.onset_detector_2 / ( hMasa->data.onset_detector_1 + EPSILON ), 0.0f ), 1.0f );
1663 :
1664 : /* If we have onset, continue checking if we should reduce in frequency instead of time. */
1665 23123 : if ( onset_filter < 0.99f )
1666 : {
1667 : /* Determine one frequency band to use to represent all frequency bands */
1668 23840 : for ( band = numCodingBands - 1; band >= 0; band-- )
1669 : {
1670 : float threshold;
1671 : float bandRatio;
1672 :
1673 23484 : threshold = totalEnergySum / ( MAX_PARAM_SPATIAL_SUBFRAMES * LOWBITRATE_NUM_BANDS ) * 0.5f; /* Average energy multiplied with energy ratio of 0.5f */
1674 23484 : bandRatio = hqmetadata->q_direction[0].band_data[band].energy_ratio[0];
1675 :
1676 23484 : bandEnergy = 0.0f;
1677 117420 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1678 : {
1679 93936 : bandEnergy += energy[sf][band];
1680 : }
1681 :
1682 23484 : if ( bandEnergy / MAX_PARAM_SPATIAL_SUBFRAMES * bandRatio > threshold )
1683 : {
1684 5315 : selectedBand = band;
1685 5315 : break;
1686 : }
1687 : }
1688 :
1689 : /* Determine if to merge over frequency instead of time */
1690 5671 : meanRatio = 0.0f;
1691 28355 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1692 : {
1693 136104 : for ( band = 0; band < numCodingBands; band++ )
1694 : {
1695 113420 : meanRatio += hqmetadata->q_direction[0].band_data[band].energy_ratio[sf] * energy[sf][band];
1696 : }
1697 : }
1698 5671 : meanRatio /= ( totalEnergySum + EPSILON );
1699 :
1700 : /* 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.
1701 : * Otherwise, merge over subframes. */
1702 5671 : if ( hqmetadata->q_direction[0].band_data[selectedBand].energy_ratio[0] > meanRatio )
1703 : {
1704 3857 : mergeOverFreqBands = 1;
1705 : }
1706 : else
1707 : {
1708 1814 : mergeOverFreqBands = 0;
1709 : }
1710 : }
1711 : else
1712 : {
1713 17452 : mergeOverFreqBands = 0;
1714 : }
1715 :
1716 : /* Merge values over subframes or frequency bands, depending on which one is less important */
1717 23123 : if ( !mergeOverFreqBands ) /* Merge values over subframes */
1718 : {
1719 : float xSum, ySum, zSum;
1720 : float bandSumEnergy;
1721 : float aziRad, eleRad;
1722 : float x, y, z;
1723 : float veclen;
1724 :
1725 115596 : for ( band = 0; band < numCodingBands; band++ )
1726 : {
1727 96330 : xSum = 0.0f;
1728 96330 : ySum = 0.0f;
1729 96330 : zSum = 0.0f;
1730 96330 : bandSumEnergy = 0.0f;
1731 :
1732 481650 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1733 : {
1734 385320 : aziRad = hqmetadata->q_direction[0].band_data[band].azimuth[sf] / 180.0f * EVS_PI;
1735 385320 : eleRad = hqmetadata->q_direction[0].band_data[band].elevation[sf] / 180.0f * EVS_PI;
1736 385320 : veclen = hqmetadata->q_direction[0].band_data[band].energy_ratio[sf] * energy[sf][band];
1737 :
1738 385320 : x = cosf( aziRad ) * cosf( eleRad ) * veclen;
1739 385320 : y = sinf( aziRad ) * cosf( eleRad ) * veclen;
1740 385320 : z = sinf( eleRad ) * veclen;
1741 :
1742 385320 : xSum += x;
1743 385320 : ySum += y;
1744 385320 : zSum += z;
1745 :
1746 385320 : bandSumEnergy += energy[sf][band];
1747 : }
1748 :
1749 96330 : aziRad = atan2f( ySum, xSum );
1750 96330 : eleRad = atan2f( zSum, sqrtf( xSum * xSum + ySum * ySum ) );
1751 :
1752 96330 : hqmetadata->q_direction[0].band_data[band].azimuth[0] = aziRad / EVS_PI * 180.0f;
1753 96330 : hqmetadata->q_direction[0].band_data[band].elevation[0] = eleRad / EVS_PI * 180.0f;
1754 :
1755 : /* Energy ratio is already merged through time */
1756 :
1757 96330 : if ( computeCoherence && hqmetadata->q_direction[0].coherence_band_data != NULL )
1758 : {
1759 : float spreadCoh;
1760 10130 : float spreadCohSum = 0.0f;
1761 50650 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1762 : {
1763 40520 : spreadCoh = (float) hqmetadata->q_direction[0].coherence_band_data[band].spread_coherence[sf] / 255.0f;
1764 40520 : spreadCohSum += spreadCoh * energy[sf][band];
1765 : }
1766 10130 : hqmetadata->q_direction[0].coherence_band_data[band].spread_coherence[0] = (uint8_t) roundf( spreadCohSum / ( bandSumEnergy + EPSILON ) * 255.0f );
1767 :
1768 : /* Copy spread coherence to the rest of subframes for the coherence coding algorithm. */
1769 40520 : for ( sf = 1; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1770 : {
1771 30390 : hqmetadata->q_direction[0].coherence_band_data[band].spread_coherence[sf] = hqmetadata->q_direction[0].coherence_band_data[band].spread_coherence[0];
1772 : }
1773 :
1774 : /* Surround coherence is already merged through time */
1775 : }
1776 : }
1777 :
1778 19266 : hqmetadata->q_direction->cfg.nblocks = 1;
1779 19266 : hMasa->config.joinedSubframes = 1;
1780 : }
1781 : else /* Merge values over frequency bands */
1782 : {
1783 : /* Use the selected frequency band to represent all data */
1784 19285 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1785 : {
1786 15428 : hqmetadata->q_direction[0].band_data[0].azimuth[sf] = hqmetadata->q_direction[0].band_data[selectedBand].azimuth[sf];
1787 15428 : hqmetadata->q_direction[0].band_data[0].elevation[sf] = hqmetadata->q_direction[0].band_data[selectedBand].elevation[sf];
1788 15428 : hqmetadata->q_direction[0].band_data[0].energy_ratio[sf] = hqmetadata->q_direction[0].band_data[selectedBand].energy_ratio[sf];
1789 15428 : if ( hqmetadata->q_direction[0].coherence_band_data != NULL )
1790 : {
1791 2528 : hqmetadata->q_direction[0].coherence_band_data[0].spread_coherence[sf] = hqmetadata->q_direction[0].coherence_band_data[selectedBand].spread_coherence[sf];
1792 : }
1793 15428 : if ( hqmetadata->surcoh_band_data != NULL )
1794 : {
1795 2528 : hqmetadata->surcoh_band_data[0].surround_coherence[sf] = hqmetadata->surcoh_band_data[selectedBand].surround_coherence[sf];
1796 : }
1797 : }
1798 :
1799 : /* Copy coherence to rest of bands for the coherence coding algorithm. */
1800 19285 : for ( band = 1; band < numCodingBands; band++ )
1801 : {
1802 15428 : if ( hqmetadata->q_direction[0].coherence_band_data != NULL )
1803 : {
1804 12640 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1805 : {
1806 10112 : hqmetadata->q_direction[0].coherence_band_data[band].spread_coherence[sf] = hqmetadata->q_direction[0].coherence_band_data[0].spread_coherence[sf];
1807 : }
1808 : }
1809 15428 : if ( hqmetadata->q_direction[0].coherence_band_data != NULL )
1810 : {
1811 12640 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
1812 : {
1813 10112 : hqmetadata->surcoh_band_data[band].surround_coherence[sf] = hqmetadata->surcoh_band_data[0].surround_coherence[sf];
1814 : }
1815 : }
1816 : }
1817 :
1818 3857 : hqmetadata->q_direction[0].cfg.nbands = 1;
1819 : }
1820 :
1821 23123 : return;
1822 : }
1823 :
1824 :
1825 6150 : static int16_t encode_lfe_to_total_energy_ratio(
1826 : MASA_ENCODER_HANDLE hMasa, /* i/o: MASA encoder structure */
1827 : BSTR_ENC_HANDLE hMetaData, /* i/o: Metadata bitstream handle */
1828 : const int32_t ivas_total_brate /* i : IVAS total bitrate */
1829 : )
1830 : {
1831 : int16_t i;
1832 : float xq;
1833 : int16_t VQLevels;
1834 : float maxLFESubFrameEner;
1835 : float log2LFEaverage;
1836 : float log2LFEratio[4];
1837 : float xqv[4];
1838 : float linearLFEaverage;
1839 : int16_t lfeToTotalEnergyRatioIndices[3];
1840 : int16_t lfeAdaptiveVQBits;
1841 : int16_t lfeBitsWritten;
1842 :
1843 6150 : VQLevels = 0;
1844 6150 : lfeAdaptiveVQBits = 0;
1845 :
1846 : /* Determine maximum amount of LFE energy in any subframe */
1847 6150 : maxLFESubFrameEner = 0.0f;
1848 30750 : for ( i = 0; i < MAX_PARAM_SPATIAL_SUBFRAMES; i++ )
1849 : {
1850 24600 : if ( hMasa->data.lfeToTotalEnergyRatio[i] > maxLFESubFrameEner )
1851 : {
1852 12880 : maxLFESubFrameEner = hMasa->data.lfeToTotalEnergyRatio[i];
1853 : }
1854 : }
1855 :
1856 : /* Set default values for the indices */
1857 24600 : for ( i = 0; i < 3; i++ )
1858 : {
1859 18450 : lfeToTotalEnergyRatioIndices[i] = 0;
1860 : }
1861 :
1862 : /* Check if there is enough energy in any subframe. If not, send only 1 bit (0) and abort. */
1863 : /* If there is enough LFE energy at least in one subframe, quantize it. */
1864 6150 : if ( maxLFESubFrameEner > 0.005f )
1865 : {
1866 : /* Convert energy to log2 domain, and clamp it to reasonable values */
1867 1425 : log2LFEaverage = 0.0f;
1868 7125 : for ( i = 0; i < MAX_PARAM_SPATIAL_SUBFRAMES; i++ )
1869 : {
1870 5700 : log2LFEratio[i] = log2f( max( 0.001f, hMasa->data.lfeToTotalEnergyRatio[i] ) );
1871 5700 : if ( log2LFEratio[i] > 1.0f ) /* Corresponds to linear value 2.0f */
1872 : {
1873 0 : log2LFEratio[i] = 1.0f;
1874 : }
1875 5700 : else if ( log2LFEratio[i] < -9.0f )
1876 : {
1877 204 : log2LFEratio[i] = -9.0f;
1878 : }
1879 5700 : log2LFEaverage += 0.25f * log2LFEratio[i];
1880 : }
1881 :
1882 1425 : if ( ivas_total_brate == IVAS_13k2 )
1883 : {
1884 : /* Calculate adaptive 1-bit LFE quantizer index */
1885 157 : linearLFEaverage = exp2f( log2LFEaverage ); /* Convert back to linear domain */
1886 157 : 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 ) ) ) )
1887 : {
1888 105 : lfeToTotalEnergyRatioIndices[0] = 1;
1889 105 : if ( hMasa->data.prevq_lfeIndex == 1 )
1890 : {
1891 71 : hMasa->data.prevq_lfeToTotalEnergyRatio = hMasa->data.prevq_lfeToTotalEnergyRatio + MCMASA_LFE_THETA * MCMASA_LFE_BETA; /* larger "bump-up" to LFE-to-total energy ratio */
1892 : }
1893 : else
1894 : {
1895 34 : hMasa->data.prevq_lfeToTotalEnergyRatio = hMasa->data.prevq_lfeToTotalEnergyRatio + MCMASA_LFE_BETA; /* default "bump-up" to LFE-to-total energy ratio */
1896 : }
1897 : }
1898 : else
1899 : {
1900 52 : hMasa->data.prevq_lfeToTotalEnergyRatio = MCMASA_LFE_ALPHA * hMasa->data.prevq_lfeToTotalEnergyRatio; /* exponential decay */
1901 : }
1902 :
1903 157 : if ( hMasa->data.prevq_lfeToTotalEnergyRatio > 1.0f )
1904 : {
1905 0 : hMasa->data.prevq_lfeToTotalEnergyRatio = 1.0f;
1906 : }
1907 157 : hMasa->data.prevq_lfeIndex = lfeToTotalEnergyRatioIndices[0]; /* Update to previous frame's index memories */
1908 : }
1909 : else /* Bitrate >= 16.4 kbps */
1910 : {
1911 : /* Do 1st stage scalar quantization */
1912 1268 : lfeToTotalEnergyRatioIndices[0] = 1;
1913 1268 : lfeToTotalEnergyRatioIndices[1] = usquant( log2LFEaverage, &xq, MCMASA_LFE_QLOW, MCMASA_LFE_DELTA, 8 );
1914 :
1915 1268 : if ( ivas_total_brate >= IVAS_24k4 ) /* Vector quantization is applied if bitrate >= 24.4 kbps */
1916 : {
1917 : /* Remove scalar value from the vector*/
1918 5890 : for ( i = 0; i < MAX_PARAM_SPATIAL_SUBFRAMES; i++ )
1919 : {
1920 4712 : log2LFEratio[i] -= xq;
1921 : }
1922 :
1923 : /* Vector quantize residual with energy adaptive bit allocation */
1924 1178 : switch ( lfeToTotalEnergyRatioIndices[1] )
1925 : {
1926 199 : case 0:
1927 : case 1:
1928 199 : VQLevels = 0;
1929 199 : lfeAdaptiveVQBits = 0;
1930 199 : break;
1931 93 : case 2:
1932 93 : VQLevels = 2;
1933 93 : lfeAdaptiveVQBits = 1;
1934 93 : break;
1935 80 : case 3:
1936 80 : VQLevels = 4;
1937 80 : lfeAdaptiveVQBits = 2;
1938 80 : break;
1939 193 : case 4:
1940 193 : VQLevels = 8;
1941 193 : lfeAdaptiveVQBits = 3;
1942 193 : break;
1943 613 : default:
1944 613 : VQLevels = 16;
1945 613 : lfeAdaptiveVQBits = 4;
1946 : }
1947 :
1948 1178 : if ( VQLevels > 0 )
1949 : {
1950 979 : lfeToTotalEnergyRatioIndices[2] = vquant( log2LFEratio, 0, xqv, McMASA_LFEGain_vectors, 4, VQLevels );
1951 : }
1952 : }
1953 : }
1954 : }
1955 :
1956 : /* Write first LFE bit */
1957 6150 : lfeBitsWritten = 0;
1958 6150 : push_next_indice( hMetaData, lfeToTotalEnergyRatioIndices[0], 1 );
1959 6150 : lfeBitsWritten += 1;
1960 :
1961 6150 : if ( lfeToTotalEnergyRatioIndices[0] == 1 && ivas_total_brate >= IVAS_16k4 )
1962 : {
1963 : /* If bitrate >= 16.4kbit/s, send 1-bit on/off + 3-bit scalar */
1964 1268 : push_next_indice( hMetaData, lfeToTotalEnergyRatioIndices[1], 3 );
1965 1268 : lfeBitsWritten += 3;
1966 :
1967 : /* If bitrate >= 24.4kbit/s, use adaptive 1 + (3.. 7) bit quantizer */
1968 1268 : if ( ivas_total_brate >= IVAS_24k4 )
1969 : {
1970 : /* Vector quantize residual with energy adaptive bit allocation */
1971 1178 : if ( lfeAdaptiveVQBits > 0 )
1972 : {
1973 979 : push_next_indice( hMetaData, lfeToTotalEnergyRatioIndices[2], lfeAdaptiveVQBits );
1974 979 : lfeBitsWritten += lfeAdaptiveVQBits;
1975 : }
1976 : }
1977 : }
1978 :
1979 6150 : return lfeBitsWritten;
1980 : }
1981 :
1982 :
1983 : /*-------------------------------------------------------------------*
1984 : * ivas_masa_enc_reconfigure()
1985 : *
1986 : * Reconfigure IVAS MASA encoder
1987 : *-------------------------------------------------------------------*/
1988 :
1989 33924 : void ivas_masa_enc_reconfigure(
1990 : Encoder_Struct *st_ivas /* i/o: IVAS encoder structure */
1991 : )
1992 : {
1993 : int16_t n, tmp;
1994 : int16_t sce_id, cpe_id;
1995 : int32_t ivas_total_brate;
1996 : int32_t ism_total_brate;
1997 :
1998 33924 : ivas_total_brate = st_ivas->hEncoderConfig->ivas_total_brate;
1999 :
2000 33924 : ism_total_brate = 0;
2001 33924 : 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 ) )
2002 : {
2003 0 : for ( sce_id = 0; sce_id < st_ivas->nSCE; sce_id++ )
2004 : {
2005 0 : ism_total_brate += st_ivas->hSCE[sce_id]->element_brate;
2006 : }
2007 : }
2008 :
2009 33924 : if ( ivas_total_brate != st_ivas->hEncoderConfig->last_ivas_total_brate )
2010 : {
2011 384 : for ( sce_id = 0; sce_id < st_ivas->nSCE; sce_id++ )
2012 : {
2013 94 : copy_encoder_config( st_ivas, st_ivas->hSCE[sce_id]->hCoreCoder[0], 0 );
2014 94 : st_ivas->hSCE[sce_id]->element_brate = ivas_total_brate / st_ivas->nchan_transport;
2015 94 : 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() */
2016 : }
2017 :
2018 486 : for ( cpe_id = 0; cpe_id < st_ivas->nCPE; cpe_id++ )
2019 : {
2020 196 : st_ivas->hCPE[cpe_id]->element_brate = ( ivas_total_brate / st_ivas->nchan_transport ) * CPE_CHANNELS;
2021 :
2022 : /* prepare bitstream buffers */
2023 588 : for ( n = 0; n < CPE_CHANNELS; n++ )
2024 : {
2025 392 : copy_encoder_config( st_ivas, st_ivas->hCPE[cpe_id]->hCoreCoder[n], 0 );
2026 392 : 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() */
2027 : }
2028 :
2029 196 : if ( ivas_total_brate - ism_total_brate < MIN_BRATE_MDCT_STEREO )
2030 : {
2031 71 : st_ivas->hCPE[cpe_id]->element_mode = IVAS_CPE_DFT;
2032 : }
2033 : else
2034 : {
2035 125 : st_ivas->hCPE[cpe_id]->element_mode = IVAS_CPE_MDCT;
2036 : }
2037 : }
2038 :
2039 290 : 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 );
2040 : }
2041 :
2042 33924 : return;
2043 : }
2044 :
2045 :
2046 : /*-------------------------------------------------------------------*
2047 : * average_masa_metadata()
2048 : *
2049 : * Average MASA metadata frame subframe contents: applies aggregation over time
2050 : *-------------------------------------------------------------------*/
2051 :
2052 12004 : static void average_masa_metadata(
2053 : MASA_METADATA_FRAME *hMeta,
2054 : float energy[MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS],
2055 : const SPHERICAL_GRID_DATA *Sph_Grid16,
2056 : const uint8_t useSphGrid )
2057 : {
2058 : int16_t i, j, k;
2059 : float azi_rad, ele_rad;
2060 : uint8_t numDirections;
2061 :
2062 : /* use the nominal values without data-adaptivity */
2063 12004 : numDirections = hMeta->descriptive_meta.numberOfDirections + 1;
2064 :
2065 : /* azi/ele/nrg into vectors for each sub-frame and band */
2066 28177 : for ( i = 0; i < numDirections; i++ )
2067 : {
2068 404325 : for ( k = 0; k < MASA_FREQUENCY_BANDS; k++ )
2069 : {
2070 : float x_sum, y_sum, z_sum, energy_sum, vec_len, spread_coh_sum, surr_coh_sum;
2071 :
2072 388152 : x_sum = 0.0f;
2073 388152 : y_sum = 0.0f;
2074 388152 : z_sum = 0.0f;
2075 388152 : energy_sum = 0.0f;
2076 388152 : spread_coh_sum = 0.0f;
2077 388152 : surr_coh_sum = 0.0f;
2078 1940760 : for ( j = 0; j < MAX_PARAM_SPATIAL_SUBFRAMES; j++ )
2079 : {
2080 1552608 : azi_rad = hMeta->directional_meta[i].azimuth[j][k] / 180.0f * EVS_PI;
2081 1552608 : ele_rad = hMeta->directional_meta[i].elevation[j][k] / 180.0f * EVS_PI;
2082 1552608 : vec_len = hMeta->directional_meta[i].energy_ratio[j][k] * energy[j][k];
2083 :
2084 : /* energy-weighted sum over subframes */
2085 1552608 : x_sum += cosf( azi_rad ) * cosf( ele_rad ) * vec_len;
2086 1552608 : y_sum += sinf( azi_rad ) * cosf( ele_rad ) * vec_len;
2087 1552608 : z_sum += sinf( ele_rad ) * vec_len;
2088 :
2089 1552608 : energy_sum += energy[j][k];
2090 :
2091 1552608 : spread_coh_sum += hMeta->directional_meta[i].spread_coherence[j][k] * energy[j][k];
2092 1552608 : if ( i == 0 )
2093 : {
2094 : /* this is in common metadata and not in each direction */
2095 1152384 : surr_coh_sum += hMeta->common_meta.surround_coherence[j][k] * energy[j][k];
2096 : }
2097 : }
2098 :
2099 : /* the data from the combined sub-frames is written into the first sub-frame band */
2100 388152 : j = 0;
2101 388152 : hMeta->directional_meta[i].azimuth[j][k] = atan2f( y_sum, x_sum ) / EVS_PI * 180.0f;
2102 388152 : hMeta->directional_meta[i].elevation[j][k] = atan2f( z_sum, sqrtf( x_sum * x_sum + y_sum * y_sum ) ) / EVS_PI * 180.0f;
2103 388152 : if ( useSphGrid == TRUE )
2104 : {
2105 7656 : hMeta->directional_meta[i].spherical_index[j][k] = index_theta_phi_16( &( hMeta->directional_meta[i].elevation[j][k] ),
2106 7656 : &( hMeta->directional_meta[i].azimuth[j][k] ), Sph_Grid16 );
2107 : }
2108 388152 : vec_len = sqrtf( x_sum * x_sum + y_sum * y_sum + z_sum * z_sum );
2109 388152 : hMeta->directional_meta[i].energy_ratio[j][k] = vec_len / ( energy_sum + EPSILON );
2110 :
2111 388152 : hMeta->directional_meta[i].spread_coherence[j][k] = spread_coh_sum / ( energy_sum + EPSILON );
2112 388152 : if ( i == 0 )
2113 : {
2114 288096 : hMeta->common_meta.surround_coherence[j][k] = surr_coh_sum / ( energy_sum + EPSILON );
2115 : }
2116 :
2117 : /* copy the same value to all subframes */
2118 1552608 : for ( j = 1; j < MAX_PARAM_SPATIAL_SUBFRAMES; j++ )
2119 : {
2120 1164456 : hMeta->directional_meta[i].azimuth[j][k] = hMeta->directional_meta[i].azimuth[0][k];
2121 1164456 : hMeta->directional_meta[i].elevation[j][k] = hMeta->directional_meta[i].elevation[0][k];
2122 1164456 : hMeta->directional_meta[i].energy_ratio[j][k] = hMeta->directional_meta[i].energy_ratio[0][k];
2123 1164456 : hMeta->directional_meta[i].spread_coherence[j][k] = hMeta->directional_meta[i].spread_coherence[0][k];
2124 1164456 : if ( i == 0 )
2125 : {
2126 864288 : hMeta->common_meta.surround_coherence[j][k] = hMeta->common_meta.surround_coherence[0][k];
2127 : }
2128 : }
2129 : }
2130 : }
2131 :
2132 300100 : for ( k = 0; k < MASA_FREQUENCY_BANDS; k++ )
2133 : {
2134 1440480 : for ( j = 0; j < MAX_PARAM_SPATIAL_SUBFRAMES; j++ )
2135 : {
2136 1152384 : if ( numDirections == 2 )
2137 : {
2138 400224 : 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] );
2139 : }
2140 : else
2141 : {
2142 752160 : hMeta->common_meta.diffuse_to_total_ratio[j][k] = max( 0.0f, 1.0f - hMeta->directional_meta[0].energy_ratio[j][k] );
2143 : }
2144 1152384 : hMeta->common_meta.remainder_to_total_ratio[j][k] = 0.0f;
2145 : }
2146 : }
2147 :
2148 12004 : return;
2149 : }
2150 :
2151 :
2152 : /*-------------------------------------------------------------------*
2153 : * copy_masa_metadata_subframe()
2154 : *
2155 : * Copy MASA metadata frame subframe contents
2156 : *-------------------------------------------------------------------*/
2157 :
2158 265096 : static void copy_masa_metadata_subframe(
2159 : const MASA_METADATA_HANDLE hMetaFrom, /* i : MASA frame metdata to be copied */
2160 : const uint8_t sfFrom, /* i : subframe index of the copy source */
2161 : MASA_METADATA_HANDLE hMetaTo, /* o : MASA frame metadata copy destination */
2162 : const uint8_t sfTo /* i : subframe index of the copy target */
2163 : )
2164 : {
2165 : uint8_t dir;
2166 : uint8_t band;
2167 :
2168 : /* directional metadata */
2169 795288 : for ( dir = 0; dir < MASA_MAXIMUM_DIRECTIONS; dir++ )
2170 : {
2171 13254800 : for ( band = 0; band < MASA_FREQUENCY_BANDS; band++ )
2172 : {
2173 12724608 : hMetaTo->directional_meta[dir].spherical_index[sfTo][band] = hMetaFrom->directional_meta[dir].spherical_index[sfFrom][band];
2174 : }
2175 530192 : mvr2r( hMetaFrom->directional_meta[dir].azimuth[sfFrom], hMetaTo->directional_meta[dir].azimuth[sfTo], MASA_FREQUENCY_BANDS );
2176 530192 : mvr2r( hMetaFrom->directional_meta[dir].elevation[sfFrom], hMetaTo->directional_meta[dir].elevation[sfTo], MASA_FREQUENCY_BANDS );
2177 530192 : mvr2r( hMetaFrom->directional_meta[dir].energy_ratio[sfFrom], hMetaTo->directional_meta[dir].energy_ratio[sfTo], MASA_FREQUENCY_BANDS );
2178 530192 : mvr2r( hMetaFrom->directional_meta[dir].spread_coherence[sfFrom], hMetaTo->directional_meta[dir].spread_coherence[sfTo], MASA_FREQUENCY_BANDS );
2179 : }
2180 :
2181 : /* common metadata */
2182 265096 : mvr2r( hMetaFrom->common_meta.diffuse_to_total_ratio[sfFrom], hMetaTo->common_meta.diffuse_to_total_ratio[sfTo], MASA_FREQUENCY_BANDS );
2183 265096 : mvr2r( hMetaFrom->common_meta.surround_coherence[sfFrom], hMetaTo->common_meta.surround_coherence[sfTo], MASA_FREQUENCY_BANDS );
2184 265096 : mvr2r( hMetaFrom->common_meta.remainder_to_total_ratio[sfFrom], hMetaTo->common_meta.remainder_to_total_ratio[sfTo], MASA_FREQUENCY_BANDS );
2185 :
2186 265096 : return;
2187 : }
2188 :
2189 :
2190 : /*-------------------------------------------------------------------*
2191 : * copy_masa_metadata()
2192 : *
2193 : * Copy MASA metada frame contents
2194 : *-------------------------------------------------------------------*/
2195 :
2196 66274 : static void copy_masa_metadata(
2197 : const MASA_METADATA_HANDLE hMetaFrom, /* i : MASA frame metadata to be copied */
2198 : MASA_METADATA_HANDLE hMetaTo /* o : MASA frame metadata copy destination */
2199 : )
2200 : {
2201 : uint8_t sf, byte_idx;
2202 :
2203 : /* descriptive metadata */
2204 596466 : for ( byte_idx = 0; byte_idx < 8; byte_idx++ )
2205 : {
2206 530192 : hMetaTo->descriptive_meta.formatDescriptor[byte_idx] = hMetaFrom->descriptive_meta.formatDescriptor[byte_idx];
2207 : }
2208 :
2209 66274 : hMetaTo->descriptive_meta.numberOfDirections = hMetaFrom->descriptive_meta.numberOfDirections;
2210 66274 : hMetaTo->descriptive_meta.numberOfChannels = hMetaFrom->descriptive_meta.numberOfChannels;
2211 66274 : hMetaTo->descriptive_meta.sourceFormat = hMetaFrom->descriptive_meta.sourceFormat;
2212 66274 : hMetaTo->descriptive_meta.transportDefinition = hMetaFrom->descriptive_meta.transportDefinition;
2213 66274 : hMetaTo->descriptive_meta.channelAngle = hMetaFrom->descriptive_meta.channelAngle;
2214 66274 : hMetaTo->descriptive_meta.channelDistance = hMetaFrom->descriptive_meta.channelDistance;
2215 66274 : hMetaTo->descriptive_meta.channelLayout = hMetaFrom->descriptive_meta.channelLayout;
2216 :
2217 : /* directional and common metadata */
2218 331370 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
2219 : {
2220 265096 : copy_masa_metadata_subframe( hMetaFrom, sf, hMetaTo, sf );
2221 : }
2222 :
2223 66274 : return;
2224 : }
2225 :
2226 :
2227 : /*-------------------------------------------------------------------*
2228 : * are_masa_subframes_similar()
2229 : *
2230 : * Compare the similarity of MASA metadata in two sub-frames
2231 : *-------------------------------------------------------------------*/
2232 :
2233 : /* r: similarity decision */
2234 394082 : static uint8_t are_masa_subframes_similar(
2235 : const MASA_METADATA_HANDLE frame1, /* i : MASA metadata frame 1 */
2236 : const uint8_t sf1_idx, /* i : index of the subframe of frame1 to inspect */
2237 : const MASA_METADATA_HANDLE frame2, /* i : MASA metadata frame 2 */
2238 : const uint8_t sf2_idx /* i : index of the subframe of frame2 to inspect */
2239 : )
2240 : {
2241 : uint8_t num_dir;
2242 : uint8_t dir;
2243 : uint8_t band_idx;
2244 : uint8_t sf_differ;
2245 :
2246 394082 : num_dir = frame1->descriptive_meta.numberOfDirections;
2247 394082 : dir = 0;
2248 394082 : band_idx = 0;
2249 394082 : sf_differ = FALSE;
2250 :
2251 394082 : if ( num_dir != frame2->descriptive_meta.numberOfDirections )
2252 : {
2253 3339 : sf_differ = TRUE;
2254 : }
2255 : else
2256 : {
2257 : /* check per-direction metadata */
2258 390743 : dir = 0;
2259 390743 : band_idx = 0;
2260 :
2261 873189 : while ( ( sf_differ == FALSE ) && ( dir <= num_dir ) )
2262 : {
2263 482446 : band_idx = 0;
2264 7851072 : while ( ( sf_differ == FALSE ) && ( band_idx < MASA_FREQUENCY_BANDS ) )
2265 : {
2266 : float azi_dif;
2267 7545048 : azi_dif = fabsf( frame1->directional_meta[dir].azimuth[sf1_idx][band_idx] - frame2->directional_meta[dir].azimuth[sf2_idx][band_idx] );
2268 7545048 : azi_dif = azi_dif > 180.0f ? 360.0f - azi_dif : azi_dif;
2269 :
2270 7545048 : if ( azi_dif > MASA_ANGLE_TOLERANCE )
2271 : {
2272 170981 : sf_differ = TRUE;
2273 170981 : break;
2274 : }
2275 :
2276 7374067 : if ( fabsf( frame1->directional_meta[dir].elevation[sf1_idx][band_idx] - frame2->directional_meta[dir].elevation[sf2_idx][band_idx] ) > MASA_ANGLE_TOLERANCE )
2277 : {
2278 4044 : sf_differ = TRUE;
2279 4044 : break;
2280 : }
2281 :
2282 7370023 : 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 )
2283 : {
2284 581 : sf_differ = TRUE;
2285 581 : break;
2286 : }
2287 :
2288 7369442 : 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 )
2289 : {
2290 816 : sf_differ = TRUE;
2291 816 : break;
2292 : }
2293 :
2294 7368626 : band_idx++;
2295 : }
2296 482446 : dir++;
2297 : }
2298 :
2299 : /* check the common metadata */
2300 390743 : while ( ( sf_differ == FALSE ) && ( band_idx < MASA_FREQUENCY_BANDS ) )
2301 : {
2302 0 : if ( fabsf( frame1->common_meta.surround_coherence[sf1_idx][band_idx] - frame2->common_meta.surround_coherence[sf2_idx][band_idx] ) > MASA_COHERENCE_TOLERANCE )
2303 : {
2304 0 : sf_differ = TRUE;
2305 0 : break;
2306 : }
2307 :
2308 0 : band_idx++;
2309 : }
2310 : }
2311 :
2312 394082 : if ( sf_differ )
2313 : {
2314 179761 : return FALSE;
2315 : }
2316 : else
2317 : {
2318 214321 : return TRUE;
2319 : }
2320 : }
2321 :
2322 :
2323 : /*-------------------------------------------------------------------*
2324 : * detect_framing_async()
2325 : *
2326 : * Compare the similarity of MASA metadata in two sub-frames
2327 : * Analysis result is stored in hMasa->data.sync_state, and
2328 : * potentially hMasa->masaMetadata is modified
2329 : *-------------------------------------------------------------------*/
2330 :
2331 66274 : static void detect_framing_async(
2332 : MASA_ENCODER_HANDLE hMasa /* i/o: MASA encoder structure */
2333 : )
2334 : {
2335 : MASA_METADATA_HANDLE current_meta;
2336 : MASA_METADATA_HANDLE previous_meta;
2337 : MASA_SYNC_HANDLE sync_state;
2338 : MASA_FRAME_MODE frame_mode;
2339 : uint8_t n_sim_start, n_sim_stop, sf_idx;
2340 : uint8_t found_offset;
2341 :
2342 66274 : current_meta = &( hMasa->masaMetadata ); /* metadata from current frame */
2343 66274 : sync_state = &( hMasa->data.sync_state ); /* synchronization structure */
2344 66274 : previous_meta = &( sync_state->previous_metadata );
2345 :
2346 : /* check current frame, how many are similar from the start and from the end */
2347 66274 : n_sim_start = 1;
2348 141582 : for ( sf_idx = n_sim_start; sf_idx < MAX_PARAM_SPATIAL_SUBFRAMES; sf_idx++ )
2349 : {
2350 123971 : if ( are_masa_subframes_similar( current_meta, 0, current_meta, sf_idx ) == TRUE )
2351 : {
2352 75308 : n_sim_start = sf_idx + 1;
2353 : }
2354 : else
2355 : {
2356 48663 : break;
2357 : }
2358 : }
2359 :
2360 : /* number of similar sub-frames starting from the end of the frame */
2361 66274 : if ( n_sim_start == MAX_PARAM_SPATIAL_SUBFRAMES ) /* shortcut */
2362 : {
2363 17611 : n_sim_stop = n_sim_start;
2364 : }
2365 : else
2366 : {
2367 48663 : n_sim_stop = 1;
2368 71973 : for ( sf_idx = 2; sf_idx < MAX_PARAM_SPATIAL_SUBFRAMES; sf_idx++ )
2369 : {
2370 : /* we need to check only the two middle sub-frames, as all being the same would have taken the shortcut above */
2371 70274 : if ( are_masa_subframes_similar( current_meta, MAX_PARAM_SPATIAL_SUBFRAMES - 1, current_meta, MAX_PARAM_SPATIAL_SUBFRAMES - sf_idx ) == TRUE )
2372 : {
2373 23310 : n_sim_stop = sf_idx;
2374 : }
2375 : else
2376 : {
2377 46964 : break;
2378 : }
2379 : }
2380 : }
2381 :
2382 66274 : frame_mode = MASA_FRAME_4SF; /* default mode: 4sf */
2383 66274 : if ( sync_state->prev_offset > MAX_PARAM_SPATIAL_SUBFRAMES - 2 )
2384 : {
2385 : /* earlier offset was large => reset the offset */
2386 1937 : found_offset = 0;
2387 : }
2388 : else
2389 : {
2390 : /* keep previous offset unless something else is found. alternatively, we could reset always */
2391 64337 : found_offset = sync_state->prev_offset;
2392 : }
2393 :
2394 66274 : if ( ( n_sim_start == MAX_PARAM_SPATIAL_SUBFRAMES ) && ( n_sim_stop == MAX_PARAM_SPATIAL_SUBFRAMES ) )
2395 : {
2396 : /* full frame consists of similar sub-frames */
2397 17611 : frame_mode = MASA_FRAME_1SF;
2398 17611 : if ( ( sync_state->prev_sim_stop != 0 ) && ( are_masa_subframes_similar( current_meta, 0, previous_meta, MAX_PARAM_SPATIAL_SUBFRAMES - 1 ) == TRUE ) )
2399 : {
2400 : /* > 4 sub-frames of similar data */
2401 3202 : if ( sync_state->prev_sim_stop < 3 )
2402 : {
2403 : /* can nicely align the framing with the earlier data and a small offset */
2404 390 : found_offset = sync_state->prev_sim_stop;
2405 : }
2406 : else
2407 : {
2408 : /* too many similar sub-frames to determine the offset accurately => keep earlier value */
2409 2812 : found_offset = sync_state->prev_offset;
2410 : }
2411 : }
2412 : else
2413 : {
2414 : /* earlier window was different => reset the offset */
2415 14409 : found_offset = 0;
2416 : }
2417 : }
2418 48663 : else if ( n_sim_stop == 3 )
2419 : {
2420 : /* first sub-frame different that the rest 3
2421 : => make a risky guess that the future sf would be the same too and we're in an offset case */
2422 1699 : frame_mode = MASA_FRAME_1SF;
2423 1699 : found_offset = 3;
2424 : }
2425 46964 : else if ( ( sync_state->prev_sim_stop > 0 ) && ( are_masa_subframes_similar( current_meta, 0, previous_meta, MAX_PARAM_SPATIAL_SUBFRAMES - 1 ) == TRUE ) )
2426 : {
2427 : /* seeing data similar to past */
2428 14996 : if ( ( n_sim_start > 1 ) && ( n_sim_start + sync_state->prev_sim_stop >= MAX_PARAM_SPATIAL_SUBFRAMES ) )
2429 : {
2430 : /* with the past, would have at least one long frame similar subframes */
2431 9133 : frame_mode = MASA_FRAME_1SF;
2432 :
2433 9133 : if ( sync_state->prev_offset == 0 )
2434 : {
2435 343 : found_offset = min( 2, sync_state->prev_sim_stop );
2436 : }
2437 : else
2438 : {
2439 8790 : found_offset = sync_state->prev_offset;
2440 : }
2441 : }
2442 : }
2443 :
2444 : /* keep the original contents of the frame, but then perform interpolation later */
2445 : /* just copy current frame to storage */
2446 66274 : copy_masa_metadata( current_meta, previous_meta );
2447 :
2448 66274 : sync_state->prev_sim_stop = n_sim_stop;
2449 66274 : sync_state->prev_offset = found_offset;
2450 66274 : sync_state->frame_mode = frame_mode;
2451 :
2452 66274 : return;
2453 : }
2454 :
2455 :
2456 : /*-------------------------------------------------------------------*
2457 : * masa_metadata_direction_alignment()
2458 : *
2459 : * In 2dir MASA metadata, determine the ordering of the directional
2460 : * fields such that the azi/ele change across time is minimized.
2461 : *-------------------------------------------------------------------*/
2462 :
2463 66274 : static void masa_metadata_direction_alignment(
2464 : MASA_ENCODER_HANDLE hMasa /* i/o: MASA encoder handle */
2465 : )
2466 : {
2467 : uint8_t band, n_dirs;
2468 : MASA_DIR_ALIGN_HANDLE hAlignState;
2469 : MASA_METADATA_HANDLE hMeta;
2470 :
2471 66274 : hAlignState = &( hMasa->data.dir_align_state );
2472 66274 : hMeta = &( hMasa->masaMetadata );
2473 :
2474 66274 : n_dirs = hMeta->descriptive_meta.numberOfDirections + 1; /* 1-based */
2475 1656850 : for ( band = 0; band < MASA_FREQUENCY_BANDS; band++ )
2476 : {
2477 : uint8_t sf;
2478 : float diff_swap, diff_no_swap;
2479 :
2480 : /* trade 2*(cos+sin) against storing the values between frames */
2481 : float prev_ele_dir1_sin, prev_ele_dir2_sin;
2482 : float prev_ele_dir1_cos, prev_ele_dir2_cos;
2483 :
2484 1590576 : prev_ele_dir1_sin = sinf( hAlignState->previous_ele_dir1[band] );
2485 1590576 : prev_ele_dir2_sin = sinf( hAlignState->previous_ele_dir2[band] );
2486 :
2487 1590576 : prev_ele_dir1_cos = cosf( hAlignState->previous_ele_dir1[band] );
2488 1590576 : prev_ele_dir2_cos = cosf( hAlignState->previous_ele_dir2[band] );
2489 :
2490 7952880 : for ( sf = 0; sf < MAX_PARAM_SPATIAL_SUBFRAMES; sf++ )
2491 : {
2492 : float azi_rad1, ele_rad1;
2493 : float azi_rad2, ele_rad2;
2494 : float cos_ele1, cos_ele2;
2495 : float sin_ele1, sin_ele2;
2496 :
2497 6362304 : azi_rad1 = hMeta->directional_meta[0].azimuth[sf][band] * PI_OVER_180;
2498 6362304 : ele_rad1 = hMeta->directional_meta[0].elevation[sf][band] * PI_OVER_180;
2499 :
2500 6362304 : if ( n_dirs > 1 )
2501 : {
2502 2502912 : azi_rad2 = hMeta->directional_meta[1].azimuth[sf][band] * PI_OVER_180;
2503 2502912 : ele_rad2 = hMeta->directional_meta[1].elevation[sf][band] * PI_OVER_180;
2504 :
2505 : /* quick checks to detect constant data and earlier flip */
2506 2502912 : if ( fabsf( azi_rad1 - hAlignState->previous_azi_dir1[band] ) < EPSILON &&
2507 968951 : fabsf( azi_rad2 - hAlignState->previous_azi_dir2[band] ) < EPSILON &&
2508 792623 : fabsf( ele_rad1 - hAlignState->previous_ele_dir1[band] ) < EPSILON &&
2509 792623 : fabsf( ele_rad2 - hAlignState->previous_ele_dir2[band] ) < EPSILON )
2510 : {
2511 792620 : diff_swap = 1.0f;
2512 792620 : diff_no_swap = 0.0f;
2513 : /* cached values that will be used for the short-cuts and over-written by the real computations, if done */
2514 792620 : sin_ele1 = prev_ele_dir1_sin;
2515 792620 : sin_ele2 = prev_ele_dir2_sin;
2516 792620 : cos_ele1 = prev_ele_dir1_cos;
2517 792620 : cos_ele2 = prev_ele_dir2_cos;
2518 : }
2519 1710292 : else if ( fabsf( azi_rad1 - hAlignState->previous_azi_dir2[band] ) < EPSILON &&
2520 425633 : fabsf( azi_rad2 - hAlignState->previous_azi_dir1[band] ) < EPSILON &&
2521 420745 : fabsf( ele_rad1 - hAlignState->previous_ele_dir2[band] ) < EPSILON &&
2522 420721 : fabsf( ele_rad2 - hAlignState->previous_ele_dir1[band] ) < EPSILON )
2523 : {
2524 420707 : diff_swap = 0.0f;
2525 420707 : diff_no_swap = 1.0f;
2526 : /* cached values that will be used for the short-cuts and over-written by the real computations, if done */
2527 420707 : sin_ele1 = prev_ele_dir2_sin;
2528 420707 : sin_ele2 = prev_ele_dir1_sin;
2529 420707 : cos_ele1 = prev_ele_dir2_cos;
2530 420707 : cos_ele2 = prev_ele_dir1_cos;
2531 : }
2532 : else
2533 : {
2534 : /* angular distance of the two vectors */
2535 : /* pre-compute values for re-use */
2536 1289585 : sin_ele1 = sinf( ele_rad1 );
2537 1289585 : sin_ele2 = sinf( ele_rad2 );
2538 :
2539 1289585 : cos_ele1 = cosf( ele_rad1 );
2540 1289585 : cos_ele2 = cosf( ele_rad2 );
2541 :
2542 1289585 : diff_no_swap = acosf( cos_ele1 * prev_ele_dir1_cos * cosf( azi_rad1 - hAlignState->previous_azi_dir1[band] ) + sin_ele1 * prev_ele_dir1_sin ) +
2543 1289585 : acosf( cos_ele2 * prev_ele_dir2_cos * cosf( azi_rad2 - hAlignState->previous_azi_dir2[band] ) + sin_ele2 * prev_ele_dir2_sin );
2544 :
2545 1289585 : diff_swap = acosf( cos_ele1 * prev_ele_dir2_cos * cosf( azi_rad1 - hAlignState->previous_azi_dir2[band] ) + sin_ele1 * prev_ele_dir2_sin ) +
2546 1289585 : acosf( cos_ele2 * prev_ele_dir1_cos * cosf( azi_rad2 - hAlignState->previous_azi_dir1[band] ) + sin_ele2 * prev_ele_dir1_sin );
2547 : }
2548 : }
2549 : else
2550 : {
2551 : /* 1dir */
2552 3859392 : sin_ele1 = sinf( ele_rad1 );
2553 3859392 : cos_ele1 = cosf( ele_rad1 );
2554 :
2555 3859392 : azi_rad2 = 0.0f;
2556 3859392 : ele_rad2 = 0.0f;
2557 :
2558 3859392 : sin_ele2 = 0.0f; /* sin(0) */
2559 3859392 : cos_ele2 = 1.0f; /* cos(0) */
2560 :
2561 3859392 : diff_swap = 1.0f;
2562 3859392 : diff_no_swap = 0.0f;
2563 : }
2564 :
2565 6362304 : if ( n_dirs > 1 && diff_no_swap > diff_swap )
2566 849511 : {
2567 : /* swap the metadata of the two directions in this TF-tile */
2568 : float tmp_val;
2569 : uint16_t tmp_int_val;
2570 849511 : tmp_val = hMeta->directional_meta[0].azimuth[sf][band];
2571 849511 : hMeta->directional_meta[0].azimuth[sf][band] = hMeta->directional_meta[1].azimuth[sf][band];
2572 849511 : hMeta->directional_meta[1].azimuth[sf][band] = tmp_val;
2573 :
2574 849511 : tmp_val = hMeta->directional_meta[0].elevation[sf][band];
2575 849511 : hMeta->directional_meta[0].elevation[sf][band] = hMeta->directional_meta[1].elevation[sf][band];
2576 849511 : hMeta->directional_meta[1].elevation[sf][band] = tmp_val;
2577 849511 : tmp_int_val = hMeta->directional_meta[0].spherical_index[sf][band];
2578 849511 : hMeta->directional_meta[0].spherical_index[sf][band] = hMeta->directional_meta[1].spherical_index[sf][band];
2579 849511 : hMeta->directional_meta[1].spherical_index[sf][band] = tmp_int_val;
2580 849511 : tmp_val = hMeta->directional_meta[0].energy_ratio[sf][band];
2581 849511 : hMeta->directional_meta[0].energy_ratio[sf][band] = hMeta->directional_meta[1].energy_ratio[sf][band];
2582 849511 : hMeta->directional_meta[1].energy_ratio[sf][band] = tmp_val;
2583 :
2584 849511 : tmp_val = hMeta->directional_meta[0].spread_coherence[sf][band];
2585 849511 : hMeta->directional_meta[0].spread_coherence[sf][band] = hMeta->directional_meta[1].spread_coherence[sf][band];
2586 849511 : hMeta->directional_meta[1].spread_coherence[sf][band] = tmp_val;
2587 :
2588 849511 : hAlignState->previous_azi_dir1[band] = azi_rad2;
2589 849511 : hAlignState->previous_ele_dir1[band] = ele_rad2;
2590 :
2591 849511 : hAlignState->previous_azi_dir2[band] = azi_rad1;
2592 849511 : hAlignState->previous_ele_dir2[band] = ele_rad1;
2593 :
2594 849511 : prev_ele_dir1_cos = cos_ele2;
2595 849511 : prev_ele_dir1_sin = sin_ele2;
2596 :
2597 849511 : prev_ele_dir2_cos = cos_ele1;
2598 849511 : prev_ele_dir2_sin = sin_ele1;
2599 : }
2600 : else
2601 : {
2602 5512793 : hAlignState->previous_azi_dir1[band] = azi_rad1;
2603 5512793 : hAlignState->previous_ele_dir1[band] = ele_rad1;
2604 :
2605 5512793 : hAlignState->previous_azi_dir2[band] = azi_rad2;
2606 5512793 : hAlignState->previous_ele_dir2[band] = ele_rad2;
2607 :
2608 5512793 : prev_ele_dir1_cos = cos_ele1;
2609 5512793 : prev_ele_dir1_sin = sin_ele1;
2610 :
2611 5512793 : prev_ele_dir2_cos = cos_ele2;
2612 5512793 : prev_ele_dir2_sin = sin_ele2;
2613 : }
2614 : } /* sf */
2615 : } /* band */
2616 :
2617 66274 : return;
2618 : }
2619 :
2620 :
2621 : /*-------------------------------------------------------------------*
2622 : * ivas_merge_masa_metadata()
2623 : *
2624 : *
2625 : *-------------------------------------------------------------------*/
2626 :
2627 14968 : void ivas_merge_masa_metadata(
2628 : MASA_ENCODER_HANDLE hMasa, /* i/o: MASA enc handle. source for MASA metadata and combined metadata will be here */
2629 : OMASA_SPATIAL_META_HANDLE hOMasaMeta /* i : ISM-object metadata to be merged with the MASA metadata */
2630 : )
2631 : {
2632 : int16_t sf, band;
2633 : uint8_t numCodingBands;
2634 : uint8_t numDirections;
2635 : uint8_t numSf;
2636 : MASA_METADATA_HANDLE hMeta;
2637 : float energyTimesRatioISM;
2638 : float energyTimesRatioMASA[2];
2639 : float total_diff_nrg;
2640 : float eneBand;
2641 : float energyMerged[MAX_PARAM_SPATIAL_SUBFRAMES][MASA_FREQUENCY_BANDS];
2642 14968 : OMASA_ENCODER_ENERGY_HANDLE hOmasaEnergy = hMasa->data.hOmasaData->hOmasaEnergy;
2643 :
2644 14968 : numCodingBands = hMasa->config.numCodingBands;
2645 14968 : numDirections = hMasa->config.numberOfDirections;
2646 14968 : numSf = hMasa->config.joinedSubframes == TRUE ? 1 : MAX_PARAM_SPATIAL_SUBFRAMES;
2647 14968 : hMeta = &( hMasa->masaMetadata );
2648 :
2649 74840 : for ( sf = 0; sf < numSf; sf++ )
2650 : {
2651 1493800 : for ( band = 0; band < numCodingBands; band++ )
2652 : {
2653 : int16_t merge_dest;
2654 : float dir_sum;
2655 : uint8_t band_n_dirs;
2656 1433928 : if ( numDirections == 1 || ( numDirections == 2 && hMasa->data.twoDirBands[band] == 0 ) )
2657 : {
2658 1433928 : band_n_dirs = 1;
2659 : }
2660 : else
2661 : {
2662 0 : band_n_dirs = 2;
2663 : }
2664 :
2665 : /* Compute energies */
2666 1433928 : eneBand = hMasa->data.energy[sf][band];
2667 1433928 : energyMerged[sf][band] = eneBand + hOmasaEnergy->energy_ism[sf][band];
2668 :
2669 : /* Compute weights */
2670 1433928 : energyTimesRatioMASA[0] = eneBand * hMeta->directional_meta[0].energy_ratio[sf][band];
2671 1433928 : if ( band_n_dirs == 2 )
2672 : {
2673 0 : energyTimesRatioMASA[1] = eneBand * hMeta->directional_meta[1].energy_ratio[sf][band];
2674 : }
2675 : else
2676 : {
2677 1433928 : energyTimesRatioMASA[1] = 0.0f;
2678 : }
2679 :
2680 : /* target is original MASA diffuseness */
2681 1433928 : total_diff_nrg = eneBand * hMeta->common_meta.diffuse_to_total_ratio[sf][band];
2682 :
2683 : /* criterion is mean of ISM ratio and new ratio */
2684 1433928 : 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];
2685 :
2686 : /* Determine combined metadata based on the weights */
2687 1433928 : merge_dest = -1;
2688 1433928 : if ( ( band_n_dirs == 1 && energyTimesRatioMASA[0] < energyTimesRatioISM ) ||
2689 0 : ( band_n_dirs == 2 && energyTimesRatioMASA[0] < energyTimesRatioMASA[1] && energyTimesRatioMASA[0] < energyTimesRatioISM ) )
2690 : {
2691 : /* 1dir and ISM the most energetic, or 2dir and ISM the more energetic than MASA1 */
2692 670891 : merge_dest = 0;
2693 : }
2694 763037 : else if ( band_n_dirs == 2 && energyTimesRatioMASA[1] <= energyTimesRatioMASA[0] && energyTimesRatioMASA[1] < energyTimesRatioISM )
2695 : {
2696 : /* 2dir and ISM the most energetic and MASA2 the least energetic */
2697 0 : merge_dest = 1;
2698 : }
2699 :
2700 1433928 : if ( merge_dest >= 0 ) /* replace one MASA with ISM */
2701 : {
2702 670891 : hMeta->directional_meta[merge_dest].azimuth[sf][band] = hOMasaMeta->directional_meta[0].azimuth[sf][band];
2703 670891 : hMeta->directional_meta[merge_dest].elevation[sf][band] = hOMasaMeta->directional_meta[0].elevation[sf][band];
2704 :
2705 : /* limit with the earlier direct-energy ratio */
2706 670891 : dir_sum = 1.0f - total_diff_nrg / ( EPSILON + eneBand + hOmasaEnergy->energy_ism[sf][band] ); /* new dir ratio */
2707 670891 : 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 */
2708 670891 : hMeta->common_meta.diffuse_to_total_ratio[sf][band] = 1.0f - hMeta->directional_meta[merge_dest].energy_ratio[sf][band];
2709 :
2710 670891 : if ( hMasa->config.useCoherence )
2711 : {
2712 0 : hMeta->directional_meta[merge_dest].spread_coherence[sf][band] = hOMasaMeta->directional_meta[0].spread_coherence[sf][band];
2713 0 : hMeta->common_meta.surround_coherence[sf][band] = hOMasaMeta->common_meta.surround_coherence[sf][band];
2714 : }
2715 :
2716 : /* recompute direct energy ratios to match the diffuse ratio */
2717 : float direct_quota, direct_scaler;
2718 670891 : direct_quota = 1.0f - hMeta->common_meta.diffuse_to_total_ratio[sf][band];
2719 670891 : if ( band_n_dirs == 1 )
2720 : {
2721 670891 : hMeta->directional_meta[0].energy_ratio[sf][band] = direct_quota;
2722 : }
2723 : else
2724 : {
2725 0 : dir_sum = hMeta->directional_meta[0].energy_ratio[sf][band] + hMeta->directional_meta[1].energy_ratio[sf][band];
2726 0 : direct_scaler = direct_quota / ( EPSILON + dir_sum );
2727 0 : hMeta->directional_meta[0].energy_ratio[sf][band] *= direct_scaler;
2728 0 : hMeta->directional_meta[1].energy_ratio[sf][band] *= direct_scaler;
2729 : }
2730 : }
2731 : }
2732 : }
2733 :
2734 74840 : for ( sf = 0; sf < numSf; sf++ )
2735 : {
2736 1493800 : for ( band = 0; band < numCodingBands; band++ )
2737 : {
2738 1433928 : hMasa->data.energy[sf][band] = energyMerged[sf][band];
2739 : }
2740 : }
2741 :
2742 14968 : return;
2743 : }
2744 :
2745 :
2746 76167 : static void quantize_ratio_ism_vector(
2747 : const float *ratio_ism,
2748 : int16_t *idx,
2749 : const int16_t nchan_ism,
2750 : const float masa_to_total_energy_ratio,
2751 : const int16_t idx_sep_object )
2752 : {
2753 : int16_t i, j, best_i, best_i2;
2754 : float dist, div, tmp, dist2, best_dist;
2755 : int16_t part_idx_sum, max_sum_idx;
2756 : float ratio_ism_loc[MAX_NUM_OBJECTS];
2757 : int16_t no_ism_loc;
2758 :
2759 76167 : max_sum_idx = ( 1 << PARAM_ISM_POW_RATIO_NBITS ) - 1;
2760 :
2761 76167 : if ( idx_sep_object > -1 )
2762 : {
2763 76167 : if ( ratio_ism[idx_sep_object] < 1.0f / (float) ( max_sum_idx ) )
2764 : {
2765 : /* take it out from quantize function */
2766 62608 : mvr2r( ratio_ism, ratio_ism_loc, idx_sep_object );
2767 62608 : mvr2r( &ratio_ism[idx_sep_object + 1], &ratio_ism_loc[idx_sep_object], nchan_ism - idx_sep_object - 1 );
2768 62608 : no_ism_loc = nchan_ism - 1;
2769 : }
2770 : else
2771 : {
2772 13559 : no_ism_loc = nchan_ism;
2773 13559 : mvr2r( ratio_ism, ratio_ism_loc, nchan_ism );
2774 : }
2775 : }
2776 : else
2777 : {
2778 0 : no_ism_loc = nchan_ism;
2779 0 : mvr2r( ratio_ism, ratio_ism_loc, nchan_ism );
2780 : }
2781 :
2782 76167 : if ( nchan_ism > 1 )
2783 : {
2784 76167 : if ( masa_to_total_energy_ratio >= MASA2TOTAL_THR )
2785 : {
2786 28780 : distribute_evenly_ism( idx, max_sum_idx, nchan_ism );
2787 : }
2788 : else
2789 : {
2790 47387 : if ( no_ism_loc > 1 )
2791 : {
2792 :
2793 44248 : dist = 0.0f;
2794 44248 : div = 1.0f / (float) ( max_sum_idx );
2795 :
2796 44248 : part_idx_sum = 0;
2797 :
2798 167194 : for ( i = 0; i < no_ism_loc; i++ )
2799 : {
2800 122946 : idx[i] = (int16_t) ( ( ratio_ism_loc[i] ) * ( max_sum_idx ) );
2801 122946 : part_idx_sum += idx[i];
2802 :
2803 122946 : tmp = ( ratio_ism_loc[i] - ( idx[i] * div ) );
2804 122946 : dist += ( tmp * tmp );
2805 : }
2806 :
2807 44248 : best_dist = dist;
2808 44248 : best_i2 = -1;
2809 81805 : while ( part_idx_sum < max_sum_idx )
2810 : {
2811 37557 : best_i = -1;
2812 : /* check which index to increase by 1 for a possible improvement */
2813 :
2814 141556 : for ( i = 0; i < no_ism_loc; i++ )
2815 : {
2816 103999 : idx[i]++;
2817 103999 : dist2 = 0.0f;
2818 :
2819 403472 : for ( j = 0; j < no_ism_loc; j++ )
2820 : {
2821 299473 : tmp = ( ratio_ism_loc[i] - ( idx[i] * div ) );
2822 299473 : dist2 += ( tmp * tmp );
2823 : }
2824 :
2825 103999 : if ( dist2 < best_dist )
2826 : {
2827 34059 : best_i2 = best_i;
2828 34059 : best_i = i;
2829 34059 : best_dist = dist2;
2830 : }
2831 103999 : idx[i]--;
2832 : }
2833 37557 : if ( best_i > -1 )
2834 : {
2835 33411 : idx[best_i]++;
2836 33411 : part_idx_sum++;
2837 : }
2838 : else
2839 : {
2840 4146 : if ( best_i2 > -1 )
2841 : {
2842 542 : idx[best_i2]++;
2843 542 : part_idx_sum++;
2844 : }
2845 : else
2846 : {
2847 3604 : idx[no_ism_loc - 1] += max_sum_idx - part_idx_sum;
2848 3604 : part_idx_sum = max_sum_idx;
2849 : }
2850 : }
2851 : }
2852 44248 : assert( sum_s( idx, no_ism_loc ) == max_sum_idx );
2853 : }
2854 : else
2855 : {
2856 3139 : idx[0] = max_sum_idx;
2857 : }
2858 :
2859 47387 : if ( no_ism_loc < nchan_ism )
2860 : {
2861 : /* insert back the ratio of the separated object */
2862 93620 : for ( i = nchan_ism - 1; i > idx_sep_object; i-- )
2863 : {
2864 51719 : idx[i] = idx[i - 1];
2865 : }
2866 41901 : idx[idx_sep_object] = 0;
2867 : }
2868 : }
2869 : }
2870 : else
2871 : {
2872 0 : idx[0] = (int16_t) ( ( ratio_ism[0] ) * ( ( 1 << PARAM_ISM_POW_RATIO_NBITS ) - 1 ) + 0.5f );
2873 : }
2874 :
2875 76167 : return;
2876 : }
2877 :
2878 :
2879 7361 : static int16_t index_slice_enum(
2880 : const int16_t *ratio_ism_idx,
2881 : const int16_t nchan_ism )
2882 : {
2883 : int16_t i;
2884 : int16_t x, index;
2885 : int16_t base;
2886 :
2887 7361 : if ( nchan_ism == 2 )
2888 : {
2889 1217 : index = ratio_ism_idx[0];
2890 : }
2891 : else
2892 : {
2893 6144 : x = ratio_ism_idx[nchan_ism - 2];
2894 6144 : base = 10;
2895 16443 : for ( i = nchan_ism - 3; i >= 0; i-- )
2896 : {
2897 10299 : x += ratio_ism_idx[i] * base;
2898 10299 : base *= 10;
2899 : }
2900 :
2901 6144 : index = 0;
2902 6144 : i = 0;
2903 843846 : while ( i <= x )
2904 : {
2905 837702 : if ( valid_ratio_index( i, 7, nchan_ism - 1 ) )
2906 : {
2907 220004 : index++;
2908 : }
2909 837702 : i++;
2910 : }
2911 6144 : index--;
2912 : }
2913 :
2914 7361 : return index;
2915 : }
2916 :
2917 :
2918 106378 : static void transform_difference_index(
2919 : const int16_t *diff_idx,
2920 : int16_t *idx,
2921 : const int16_t len )
2922 : {
2923 : int16_t i;
2924 336102 : for ( i = 0; i < len; i++ )
2925 : {
2926 229724 : if ( diff_idx[i] <= 0 )
2927 : {
2928 207575 : idx[i] = -2 * diff_idx[i];
2929 : }
2930 : else
2931 : {
2932 22149 : idx[i] = 2 * diff_idx[i] - 1;
2933 : }
2934 : }
2935 :
2936 106378 : return;
2937 : }
2938 :
2939 :
2940 39946 : static void transform_index_and_GR_encode(
2941 : int16_t *diff_idx, /* i : differenc eindex to encode */
2942 : const int16_t len, /* i : input length */
2943 : const int16_t GR_order, /* i : GR order */
2944 : BSTR_ENC_HANDLE hMetaData /* i/o: metadata bitstream handle */
2945 : )
2946 : {
2947 : int16_t i;
2948 : int16_t idx[IVAS_MAX_NUM_OBJECTS];
2949 :
2950 : /* transform difference index into positive */
2951 39946 : transform_difference_index( diff_idx, idx, len );
2952 :
2953 : /* GR encoding */
2954 127459 : for ( i = 0; i < len; i++ )
2955 : {
2956 87513 : ivas_qmetadata_encode_extended_gr( hMetaData, idx[i], 100, GR_order );
2957 : }
2958 :
2959 39946 : return;
2960 : }
2961 :
2962 :
2963 5790 : static int16_t try_differential(
2964 : const int16_t numCodingBands,
2965 : const float *masa_to_total_energy_ratio,
2966 : int16_t ratio_ism_idx[MASA_FREQUENCY_BANDS][MAX_NUM_OBJECTS],
2967 : const int16_t nchan_ism,
2968 : const int16_t bits_index,
2969 : int16_t *p_b_signif )
2970 : {
2971 : int16_t b, i;
2972 : int16_t nbits0;
2973 : int16_t b_signif;
2974 : int16_t ratio_ism_idx_ref[MAX_NUM_OBJECTS];
2975 : int16_t diff_idx[MAX_NUM_OBJECTS];
2976 :
2977 5790 : b_signif = 0;
2978 20207 : while ( ( b_signif < numCodingBands ) && ( masa_to_total_energy_ratio[b_signif] >= MASA2TOTAL_THR ) )
2979 : {
2980 14417 : b_signif++;
2981 : }
2982 :
2983 5790 : nbits0 = 0;
2984 :
2985 5790 : if ( b_signif < numCodingBands )
2986 : {
2987 3875 : nbits0 = bits_index;
2988 3875 : mvs2s( ratio_ism_idx[b_signif], ratio_ism_idx_ref, nchan_ism );
2989 :
2990 27055 : for ( b = b_signif + 1; b < numCodingBands; b++ )
2991 : {
2992 23180 : if ( masa_to_total_energy_ratio[b] < MASA2TOTAL_THR )
2993 : {
2994 20428 : v_sub_s( ratio_ism_idx[b], ratio_ism_idx_ref, diff_idx, nchan_ism );
2995 20428 : mvs2s( ratio_ism_idx[b], ratio_ism_idx_ref, nchan_ism );
2996 :
2997 : /* transform difference index into positive */
2998 20428 : transform_difference_index( diff_idx, diff_idx, nchan_ism - 1 );
2999 :
3000 : /* GR encoding */
3001 70735 : for ( i = 0; i < nchan_ism - 1; i++ )
3002 : {
3003 50307 : nbits0 += ivas_qmetadata_encode_extended_gr_length( diff_idx[i], 100, 0 );
3004 : }
3005 : }
3006 : }
3007 : }
3008 5790 : *p_b_signif = b_signif;
3009 :
3010 5790 : return nbits0;
3011 : }
3012 :
3013 :
3014 3056 : static void differential_coding_first_subframe(
3015 : BSTR_ENC_HANDLE hMetaData,
3016 : const float *masa_to_total_energy_ratio,
3017 : const int16_t b_signif,
3018 : int16_t ratio_ism_idx[MASA_FREQUENCY_BANDS][MAX_NUM_OBJECTS],
3019 : const int16_t nchan_ism,
3020 : const int16_t numCodingBands,
3021 : const int16_t bits_index )
3022 : {
3023 : int16_t index, b;
3024 : int16_t ratio_ism_idx_ref[MAX_NUM_OBJECTS];
3025 : int16_t diff_idx[MAX_NUM_OBJECTS];
3026 :
3027 : /* differential encoding*/
3028 3056 : push_next_indice( hMetaData, 0, 1 );
3029 :
3030 3056 : if ( b_signif < numCodingBands )
3031 : {
3032 3056 : index = index_slice_enum( ratio_ism_idx[b_signif], nchan_ism );
3033 3056 : push_next_indice( hMetaData, index, bits_index );
3034 :
3035 3056 : mvs2s( ratio_ism_idx[b_signif], ratio_ism_idx_ref, nchan_ism );
3036 :
3037 22161 : for ( b = b_signif + 1; b < numCodingBands; b++ )
3038 : {
3039 19105 : if ( masa_to_total_energy_ratio[b] < MASA2TOTAL_THR )
3040 : {
3041 16942 : v_sub_s( ratio_ism_idx[b], ratio_ism_idx_ref, diff_idx, nchan_ism );
3042 16942 : mvs2s( ratio_ism_idx[b], ratio_ism_idx_ref, nchan_ism );
3043 :
3044 : /* transform difference index into positive */
3045 16942 : transform_index_and_GR_encode( diff_idx, nchan_ism - 1, 0, hMetaData );
3046 : }
3047 : }
3048 : }
3049 :
3050 3056 : return;
3051 : }
3052 :
3053 :
3054 819 : static void independent_coding_ratio_ism_idx(
3055 : int16_t ratio_ism_idx[MASA_FREQUENCY_BANDS][MAX_NUM_OBJECTS], /* i : ISM ratios */
3056 : const float *masa_to_total_energy_ratio, /* i : MASA to total ratios */
3057 : const int16_t nchan_ism, /* i : number of objects */
3058 : const int16_t numCodingBands, /* i : number of subbands */
3059 : const int16_t bits_index, /* i : number of bits per index */
3060 : BSTR_ENC_HANDLE hMetaData /* i/o: metadata bitstream handle */
3061 : )
3062 : {
3063 : int16_t b, index;
3064 :
3065 5855 : for ( b = 0; b < numCodingBands; b++ )
3066 : {
3067 5036 : if ( masa_to_total_energy_ratio[b] < MASA2TOTAL_THR )
3068 : {
3069 4305 : index = index_slice_enum( ratio_ism_idx[b], nchan_ism );
3070 4305 : push_next_indice( hMetaData, index, bits_index );
3071 : }
3072 : }
3073 :
3074 819 : return;
3075 : }
3076 :
3077 :
3078 46038 : static void remove_sep_obj(
3079 : int16_t *diff_idx, /* i/o: array of difference of indexes */
3080 : const int16_t nchan_ism, /* i : number of objects */
3081 : const int16_t idx_sep_obj /* i : index of separated object, to be taken out of array */
3082 : )
3083 : {
3084 : int16_t i;
3085 :
3086 133311 : for ( i = idx_sep_obj; i < nchan_ism - 1; i++ )
3087 : {
3088 87273 : diff_idx[i] = diff_idx[i + 1];
3089 : }
3090 :
3091 46038 : return;
3092 : }
3093 :
3094 :
3095 46004 : static void estimate_bits_subband_ism_ratio(
3096 : const int16_t *ratio_ism_idx,
3097 : const int16_t *ratio_ism_idx_ref, /* ( i/o ) */
3098 : const int16_t nchan_ism,
3099 : const int16_t shift_one,
3100 : const int16_t idx_sep_obj,
3101 : int16_t *p_nbits0,
3102 : int16_t *p_nbits1 )
3103 : {
3104 : int16_t diff_idx[MAX_NUM_OBJECTS];
3105 : int16_t nbits0, nbits1;
3106 : int16_t i;
3107 :
3108 46004 : nbits0 = 0;
3109 46004 : nbits1 = 0;
3110 :
3111 : /* take difference with respect to previous subframe */
3112 46004 : v_sub_s( ratio_ism_idx, ratio_ism_idx_ref, diff_idx, nchan_ism );
3113 :
3114 46004 : if ( shift_one )
3115 : {
3116 30692 : remove_sep_obj( diff_idx, nchan_ism, idx_sep_obj );
3117 : }
3118 :
3119 : /* transform difference index into positive */
3120 46004 : transform_difference_index( diff_idx, diff_idx, nchan_ism - 1 - shift_one );
3121 :
3122 : /* GR encoding */
3123 137908 : for ( i = 0; i < nchan_ism - 1 - shift_one; i++ )
3124 : {
3125 91904 : nbits0 += ivas_qmetadata_encode_extended_gr_length( diff_idx[i], 100, 0 );
3126 91904 : nbits1 += ivas_qmetadata_encode_extended_gr_length( diff_idx[i], 100, 1 );
3127 : }
3128 :
3129 46004 : *p_nbits0 = nbits0;
3130 46004 : *p_nbits1 = nbits1;
3131 :
3132 46004 : return;
3133 : }
3134 :
3135 :
3136 12885 : static int16_t encode_ratio_ism_subframe(
3137 : int16_t ratio_ism_idx[MASA_FREQUENCY_BANDS][MAX_NUM_OBJECTS],
3138 : const int16_t nchan_ism,
3139 : const uint8_t numCodingBands,
3140 : const int16_t sf,
3141 : int16_t ratio_ism_idx_prev_sf[MASA_FREQUENCY_BANDS][MAX_NUM_OBJECTS],
3142 : BSTR_ENC_HANDLE hMetaData,
3143 : const float *masa_to_total_energy_ratio,
3144 : const int16_t shift_one,
3145 : const int16_t idx_separated_obj )
3146 : {
3147 : int16_t b, b_signif;
3148 : int16_t diff_idx[MAX_NUM_OBJECTS];
3149 : int16_t nbits, nbits0, nbits1, GR_order, GR_order_sb;
3150 : int16_t differential_subframe;
3151 : int16_t ratio_ism_idx_ref[MAX_NUM_OBJECTS];
3152 : int16_t bits_index;
3153 : int16_t nbits00, nbits11;
3154 : int16_t idx_sep_obj_local;
3155 : #ifdef DEBUGGING
3156 : int16_t bits_pos0;
3157 : #endif
3158 :
3159 12885 : idx_sep_obj_local = idx_separated_obj;
3160 12885 : if ( idx_separated_obj > -1 )
3161 : {
3162 12885 : if ( idx_separated_obj == nchan_ism - 1 )
3163 : {
3164 4397 : idx_sep_obj_local = 0;
3165 : }
3166 : }
3167 12885 : nbits = 0;
3168 12885 : nbits0 = 0;
3169 12885 : nbits1 = 0;
3170 :
3171 : #ifdef DEBUGGING
3172 : bits_pos0 = hMetaData->nb_bits_tot;
3173 : #endif
3174 12885 : differential_subframe = 1; /* the differences are taken with respect to previous subframe */
3175 :
3176 : /* first subframe */
3177 12885 : bits_index = 0;
3178 12885 : if ( sf == 0 )
3179 : {
3180 5790 : bits_index = bits_index_ism_ratio( nchan_ism );
3181 :
3182 5790 : nbits = 0;
3183 47262 : for ( b = 0; b < numCodingBands; b++ )
3184 : {
3185 41472 : if ( masa_to_total_energy_ratio[b] < MASA2TOTAL_THR )
3186 : {
3187 24303 : nbits += bits_index;
3188 : }
3189 : }
3190 :
3191 5790 : nbits0 = try_differential( numCodingBands, masa_to_total_energy_ratio, ratio_ism_idx, nchan_ism, bits_index, &b_signif );
3192 :
3193 5790 : if ( nbits <= nbits0 && nbits > 0 )
3194 : {
3195 : /* independent encoding */
3196 819 : push_next_indice( hMetaData, 1, 1 );
3197 819 : independent_coding_ratio_ism_idx( ratio_ism_idx, masa_to_total_energy_ratio, nchan_ism, numCodingBands, bits_index, hMetaData );
3198 819 : nbits = nbits + 1;
3199 : }
3200 : else
3201 : {
3202 4971 : if ( nbits > 0 )
3203 : {
3204 3056 : differential_coding_first_subframe( hMetaData, masa_to_total_energy_ratio, b_signif, ratio_ism_idx, nchan_ism, numCodingBands, bits_index );
3205 3056 : nbits = nbits0 + 1;
3206 : }
3207 : }
3208 :
3209 : #ifdef DEBUGGING
3210 : assert( nbits == ( hMetaData->nb_bits_tot - bits_pos0 ) );
3211 : #endif
3212 : }
3213 : else
3214 : {
3215 : /* not first subframe */
3216 7095 : if ( shift_one == 1 && nchan_ism == 2 )
3217 : {
3218 81 : nbits = 0;
3219 : }
3220 : else
3221 : {
3222 7014 : nbits0 = 0;
3223 7014 : nbits1 = 0;
3224 :
3225 41628 : for ( b = 0; b < numCodingBands; b++ )
3226 : {
3227 34614 : if ( masa_to_total_energy_ratio[b] < MASA2TOTAL_THR )
3228 : {
3229 23004 : 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 );
3230 23004 : nbits0 += nbits00;
3231 23004 : nbits1 += nbits11;
3232 : }
3233 : }
3234 7014 : if ( nbits0 < nbits1 )
3235 : {
3236 4386 : GR_order = 0;
3237 4386 : nbits = nbits0;
3238 : }
3239 : else
3240 : {
3241 2628 : GR_order = 1;
3242 2628 : nbits = nbits1;
3243 : }
3244 :
3245 7014 : if ( numCodingBands > 1 )
3246 : {
3247 : /* try the difference from subband to subband; first subband is compared to previous subframe first subband*/
3248 : /* take difference with respect to previous subframe only for first subband */
3249 6900 : nbits0 = 0;
3250 6900 : nbits1 = 0;
3251 6900 : b_signif = 0;
3252 16042 : while ( ( b_signif < numCodingBands ) && ( masa_to_total_energy_ratio[b_signif] >= MASA2TOTAL_THR ) )
3253 : {
3254 9142 : b_signif++;
3255 : }
3256 :
3257 6900 : if ( b_signif < numCodingBands )
3258 : {
3259 5261 : 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 );
3260 :
3261 5261 : mvs2s( ratio_ism_idx[b_signif], ratio_ism_idx_ref, nchan_ism );
3262 :
3263 25358 : for ( b = b_signif + 1; b < numCodingBands; b++ )
3264 : {
3265 20097 : if ( masa_to_total_energy_ratio[b] < MASA2TOTAL_THR )
3266 : {
3267 17739 : estimate_bits_subband_ism_ratio( ratio_ism_idx[b], ratio_ism_idx_ref, nchan_ism, shift_one, idx_sep_obj_local, &nbits00, &nbits11 );
3268 17739 : nbits0 += nbits00;
3269 17739 : nbits1 += nbits11;
3270 17739 : mvs2s( ratio_ism_idx[b], ratio_ism_idx_ref, nchan_ism );
3271 : }
3272 : }
3273 :
3274 5261 : if ( nbits0 < nbits1 )
3275 : {
3276 3322 : GR_order_sb = 0;
3277 : }
3278 : else
3279 : {
3280 1939 : GR_order_sb = 1;
3281 1939 : nbits0 = nbits1;
3282 : }
3283 :
3284 5261 : if ( nbits0 < nbits )
3285 : {
3286 836 : differential_subframe = 0;
3287 836 : nbits = nbits0;
3288 836 : GR_order = GR_order_sb;
3289 : }
3290 :
3291 5261 : if ( nbits > 0 )
3292 : {
3293 : /* write prediction type */
3294 5261 : push_next_indice( hMetaData, differential_subframe, 1 );
3295 : /* write GR order */
3296 5261 : push_next_indice( hMetaData, GR_order, 1 );
3297 5261 : nbits++; /* for the prediction type */
3298 5261 : nbits++; /* for GR_order */
3299 :
3300 : /* write data */
3301 5261 : if ( differential_subframe )
3302 : {
3303 26550 : for ( b = 0; b < numCodingBands; b++ )
3304 : {
3305 22125 : if ( masa_to_total_energy_ratio[b] < MASA2TOTAL_THR )
3306 : {
3307 : /* take difference with respect to previous subframe */
3308 19447 : v_sub_s( ratio_ism_idx[b], ratio_ism_idx_prev_sf[b], diff_idx, nchan_ism );
3309 :
3310 19447 : if ( shift_one )
3311 : {
3312 14068 : remove_sep_obj( diff_idx, nchan_ism, idx_sep_obj_local );
3313 : }
3314 :
3315 19447 : transform_index_and_GR_encode( diff_idx, nchan_ism - 1 - shift_one, GR_order, hMetaData );
3316 : }
3317 : }
3318 : }
3319 : else
3320 : {
3321 836 : v_sub_s( ratio_ism_idx[b_signif], ratio_ism_idx_prev_sf[b_signif], diff_idx, nchan_ism );
3322 :
3323 836 : if ( shift_one )
3324 : {
3325 264 : remove_sep_obj( diff_idx, nchan_ism, idx_sep_obj_local );
3326 : }
3327 :
3328 836 : transform_index_and_GR_encode( diff_idx, nchan_ism - 1 - shift_one, GR_order, hMetaData );
3329 :
3330 836 : mvs2s( ratio_ism_idx[b_signif], ratio_ism_idx_ref, nchan_ism - shift_one );
3331 :
3332 4043 : for ( b = b_signif + 1; b < numCodingBands; b++ )
3333 : {
3334 : /* take difference with respect to previous subband */
3335 3207 : if ( masa_to_total_energy_ratio[b] < MASA2TOTAL_THR )
3336 : {
3337 2717 : v_sub_s( ratio_ism_idx[b], ratio_ism_idx_ref, diff_idx, nchan_ism );
3338 :
3339 2717 : if ( shift_one )
3340 : {
3341 1014 : remove_sep_obj( diff_idx, nchan_ism, idx_sep_obj_local );
3342 : }
3343 :
3344 2717 : transform_index_and_GR_encode( diff_idx, nchan_ism - 1 - shift_one, GR_order, hMetaData );
3345 :
3346 2717 : mvs2s( ratio_ism_idx[b], ratio_ism_idx_ref, nchan_ism - shift_one );
3347 : }
3348 : }
3349 : }
3350 : }
3351 : }
3352 : }
3353 : else
3354 : {
3355 : /* only differential wrt previous subframe is possible */
3356 : /* write the differential to subframe case and no bit to signal the difference type */
3357 :
3358 114 : if ( nbits > 0 )
3359 : {
3360 : /* write GR order */
3361 4 : push_next_indice( hMetaData, GR_order, 1 );
3362 4 : nbits++; /* for GR_order */
3363 : /* write data */
3364 : /* only one subband */
3365 4 : if ( masa_to_total_energy_ratio[0] < MASA2TOTAL_THR )
3366 : {
3367 : /* take difference with respect to previous subframe */
3368 4 : v_sub_s( ratio_ism_idx[0], ratio_ism_idx_prev_sf[0], diff_idx, nchan_ism );
3369 :
3370 4 : if ( shift_one )
3371 : {
3372 0 : remove_sep_obj( diff_idx, nchan_ism, idx_sep_obj_local );
3373 : }
3374 :
3375 4 : transform_index_and_GR_encode( diff_idx, nchan_ism - 1 - shift_one, GR_order, hMetaData );
3376 : }
3377 : }
3378 : }
3379 :
3380 : #ifdef DEBUGGING
3381 : assert( nbits == ( hMetaData->nb_bits_tot - bits_pos0 ) );
3382 : #endif
3383 : }
3384 : }
3385 :
3386 12885 : return nbits;
3387 : }
3388 :
3389 :
3390 5790 : static void ivas_encode_masaism_metadata(
3391 : MASA_ENCODER_HANDLE hMasa,
3392 : IVAS_QMETADATA_HANDLE hQMetaData, /* i/o: q_metadata handle */
3393 : BSTR_ENC_HANDLE hMetaData, /* i/o: metadata bitstream handle */
3394 : ISM_METADATA_HANDLE hIsmMeta[], /* i/o: ISM metadata handles */
3395 : const int16_t nchan_ism, /* i : number of ISM channels */
3396 : const int16_t low_bitrate_mode, /* i : is low bitrate more? 1/0 */
3397 : const int16_t omasa_nbands,
3398 : const int16_t omasa_nblocks,
3399 : const int16_t idx_separated_object,
3400 : const int16_t ism_imp )
3401 : {
3402 : int16_t sf, band;
3403 : uint8_t numCodingBands;
3404 : uint8_t numSf;
3405 : int16_t brange[2];
3406 : float eneBand;
3407 : int16_t bin;
3408 : int16_t obj;
3409 : int16_t bits_ism[MAX_NUM_OBJECTS];
3410 : uint16_t idx_sph;
3411 : float theta_q, phi_q;
3412 : uint16_t index_theta, index_phi;
3413 : float ratio_ism[MASA_FREQUENCY_BANDS][MAX_NUM_OBJECTS];
3414 : int16_t ratio_ism_idx[MASA_FREQUENCY_BANDS][MAX_NUM_OBJECTS], ratio_ism_idx_prev_sf[MASA_FREQUENCY_BANDS][MAX_NUM_OBJECTS];
3415 : float step;
3416 : int16_t inv_step;
3417 : float energy_ism, energy_ism_ind[MAX_NUM_OBJECTS];
3418 : int16_t tmp, rotate;
3419 : int16_t n_ism_tmp, i;
3420 5790 : OMASA_ENCODER_DATA_HANDLE hOmasaData = hMasa->data.hOmasaData;
3421 5790 : OMASA_ENCODER_ENERGY_HANDLE hOmasaEnergy = hOmasaData->hOmasaEnergy;
3422 : int16_t nbands_work;
3423 :
3424 : /* use the values from hQMetaData */
3425 5790 : numCodingBands = (uint8_t) hQMetaData->q_direction->cfg.nbands;
3426 5790 : numSf = (int8_t) hQMetaData->q_direction->cfg.nblocks;
3427 5790 : nbands_work = min( numCodingBands, omasa_nbands );
3428 5790 : if ( numCodingBands == 1 )
3429 : {
3430 325 : for ( sf = 0; sf < numSf; sf++ )
3431 : {
3432 260 : if ( sum_f( hOmasaEnergy->energy_ism[sf], omasa_nbands ) == 0.0f )
3433 : {
3434 36 : hOmasaData->masa_to_total_energy_ratio[sf][0] = 1.0f;
3435 : }
3436 : else
3437 : {
3438 224 : brange[0] = hMasa->data.band_mapping[0];
3439 224 : brange[1] = hMasa->data.band_mapping[omasa_nbands];
3440 224 : eneBand = 0.0f;
3441 5600 : for ( bin = brange[0]; bin < brange[1]; bin++ )
3442 : {
3443 5376 : eneBand += hMasa->data.energy[sf][bin];
3444 : }
3445 :
3446 224 : energy_ism = 0.0f;
3447 672 : for ( obj = 0; obj < nchan_ism; obj++ )
3448 : {
3449 448 : energy_ism_ind[obj] = 0.0f;
3450 : }
3451 :
3452 1344 : for ( band = 0; band < omasa_nbands; band++ )
3453 : {
3454 1120 : energy_ism += hOmasaEnergy->energy_ism[sf][band];
3455 3360 : for ( obj = 0; obj < nchan_ism; obj++ )
3456 : {
3457 2240 : energy_ism_ind[obj] += hOmasaEnergy->energy_ism[sf][band] * hOmasaEnergy->energy_ratio_ism[sf][band][obj];
3458 : }
3459 : }
3460 :
3461 672 : for ( obj = 0; obj < nchan_ism; obj++ )
3462 : {
3463 448 : hOmasaEnergy->energy_ratio_ism[sf][0][obj] = energy_ism_ind[obj] / energy_ism;
3464 : }
3465 224 : hOmasaData->masa_to_total_energy_ratio[sf][0] = eneBand / ( eneBand + energy_ism + EPSILON );
3466 : }
3467 : }
3468 : }
3469 5725 : else if ( numSf == 1 )
3470 : {
3471 33332 : for ( band = 0; band < nbands_work; band++ )
3472 : {
3473 29907 : energy_ism = 0.0f; /* ISM energy for current subband */
3474 128553 : for ( obj = 0; obj < nchan_ism; obj++ )
3475 : {
3476 98646 : energy_ism_ind[obj] = 0.0f;
3477 : }
3478 73719 : for ( sf = 0; sf < omasa_nblocks; sf++ )
3479 : {
3480 43812 : energy_ism += hOmasaEnergy->energy_ism[sf][band];
3481 170268 : for ( obj = 0; obj < nchan_ism; obj++ )
3482 : {
3483 126456 : energy_ism_ind[obj] += hOmasaEnergy->energy_ism[sf][band] * hOmasaEnergy->energy_ratio_ism[sf][band][obj];
3484 : }
3485 : }
3486 :
3487 29907 : if ( energy_ism == 0.0f )
3488 : {
3489 2822 : hOmasaData->masa_to_total_energy_ratio[0][band] = 1.0f;
3490 : }
3491 : else
3492 : {
3493 117063 : for ( obj = 0; obj < nchan_ism; obj++ )
3494 : {
3495 89978 : hOmasaEnergy->energy_ratio_ism[0][band][obj] = energy_ism_ind[obj] / energy_ism;
3496 : }
3497 27085 : brange[0] = hMasa->data.band_mapping[band];
3498 27085 : brange[1] = hMasa->data.band_mapping[band + 1];
3499 :
3500 27085 : eneBand = 0.0f;
3501 66005 : for ( sf = 0; sf < omasa_nblocks; sf++ )
3502 : {
3503 169250 : for ( bin = brange[0]; bin < brange[1]; bin++ )
3504 : {
3505 130330 : eneBand += hMasa->data.energy[sf][bin];
3506 : }
3507 : }
3508 27085 : hOmasaData->masa_to_total_energy_ratio[0][band] = eneBand / ( eneBand + energy_ism + EPSILON );
3509 : }
3510 : }
3511 3425 : for ( band = nbands_work; band < numCodingBands; band++ )
3512 : {
3513 0 : hOmasaData->masa_to_total_energy_ratio[0][band] = 1.0f;
3514 :
3515 0 : for ( obj = 0; obj < nchan_ism; obj++ )
3516 : {
3517 0 : hOmasaEnergy->energy_ratio_ism[0][band][obj] = hOmasaEnergy->energy_ratio_ism[0][nbands_work - 1][obj];
3518 : }
3519 : }
3520 : }
3521 : else
3522 : {
3523 11500 : for ( sf = 0; sf < numSf; sf++ )
3524 : {
3525 55200 : for ( band = 0; band < nbands_work; band++ )
3526 : {
3527 46000 : if ( hOmasaEnergy->energy_ism[sf][band] == 0.0f )
3528 : {
3529 4125 : hOmasaData->masa_to_total_energy_ratio[sf][band] = 1.0f;
3530 : }
3531 : else
3532 : {
3533 41875 : brange[0] = hMasa->data.band_mapping[band];
3534 41875 : brange[1] = hMasa->data.band_mapping[band + 1];
3535 :
3536 41875 : eneBand = 0.0f;
3537 241531 : for ( bin = brange[0]; bin < brange[1]; bin++ )
3538 : {
3539 199656 : eneBand += hMasa->data.energy[sf][bin];
3540 : }
3541 41875 : hOmasaData->masa_to_total_energy_ratio[sf][band] = eneBand / ( eneBand + hOmasaEnergy->energy_ism[sf][band] + EPSILON );
3542 : }
3543 : }
3544 9200 : for ( band = nbands_work; band < numCodingBands; band++ )
3545 : {
3546 0 : hOmasaData->masa_to_total_energy_ratio[sf][band] = 1.0f;
3547 :
3548 0 : for ( obj = 0; obj < nchan_ism; obj++ )
3549 : {
3550 0 : hOmasaEnergy->energy_ratio_ism[sf][band][obj] = hOmasaEnergy->energy_ratio_ism[sf][nbands_work - 1][obj];
3551 : }
3552 : }
3553 : }
3554 : }
3555 5790 : ivas_omasa_encode_masa_to_total( hOmasaData->masa_to_total_energy_ratio, hMetaData, low_bitrate_mode, numCodingBands, numSf );
3556 :
3557 : /* quantize ism_ratios */
3558 5790 : if ( nchan_ism > 1 )
3559 : {
3560 5790 : inv_step = ( ( 1 << PARAM_ISM_POW_RATIO_NBITS ) - 1 );
3561 5790 : step = 1.0f / inv_step;
3562 :
3563 5790 : rotate = 0;
3564 5790 : n_ism_tmp = 0;
3565 :
3566 18675 : for ( sf = 0; sf < numSf; sf++ )
3567 : {
3568 89052 : for ( band = 0; band < numCodingBands; band++ )
3569 : {
3570 345173 : for ( obj = 0; obj < nchan_ism; obj++ )
3571 : {
3572 269006 : assert( ( hOmasaEnergy->energy_ratio_ism[sf][band][obj] >= 0 ) && ( hOmasaEnergy->energy_ratio_ism[sf][band][obj] <= 1 ) );
3573 269006 : ratio_ism[band][obj] = hOmasaEnergy->energy_ratio_ism[sf][band][obj];
3574 : }
3575 :
3576 : /* Quantize ISM ratios */
3577 76167 : quantize_ratio_ism_vector( ratio_ism[band], ratio_ism_idx[band], nchan_ism, hOmasaData->masa_to_total_energy_ratio[sf][band], idx_separated_object );
3578 76167 : if ( n_ism_tmp == numCodingBands && ratio_ism_idx[band][idx_separated_object] != 0 && hOmasaData->masa_to_total_energy_ratio[sf][band] < MASA2TOTAL_THR )
3579 : {
3580 54 : i = 0;
3581 363 : while ( ratio_ism_idx[band][idx_separated_object] > 0 )
3582 : {
3583 309 : if ( i != idx_separated_object )
3584 : {
3585 212 : ratio_ism_idx[band][i]++;
3586 212 : ratio_ism_idx[band][idx_separated_object]--;
3587 : }
3588 309 : i++;
3589 309 : if ( i == nchan_ism )
3590 : {
3591 67 : i = 0;
3592 : }
3593 : }
3594 : }
3595 :
3596 : /* reconstructed values */
3597 76167 : reconstruct_ism_ratios( ratio_ism_idx[band], nchan_ism, step, hOmasaEnergy->q_energy_ratio_ism[sf][band] );
3598 : }
3599 :
3600 12885 : if ( ( nchan_ism > 2 ) && ( idx_separated_object == nchan_ism - 1 ) )
3601 : {
3602 : /* rotate components */
3603 3423 : rotate = 1;
3604 23807 : for ( band = 0; band < numCodingBands; band++ )
3605 : {
3606 20384 : if ( hOmasaData->masa_to_total_energy_ratio[sf][band] < MASA2TOTAL_THR )
3607 : {
3608 11572 : tmp = ratio_ism_idx[band][nchan_ism - 1];
3609 11572 : ratio_ism_idx[band][nchan_ism - 1] = ratio_ism_idx[band][0];
3610 11572 : ratio_ism_idx[band][0] = tmp;
3611 11572 : if ( sf == 0 && tmp == 0 )
3612 : {
3613 3981 : n_ism_tmp += 1;
3614 : }
3615 :
3616 11572 : if ( n_ism_tmp == numCodingBands )
3617 : {
3618 4346 : assert( tmp == 0 );
3619 : }
3620 : }
3621 : }
3622 : }
3623 : else
3624 : {
3625 9462 : if ( idx_separated_object > -1 )
3626 : {
3627 65245 : for ( band = 0; band < numCodingBands; band++ )
3628 : {
3629 55783 : if ( hOmasaData->masa_to_total_energy_ratio[sf][band] < MASA2TOTAL_THR )
3630 : {
3631 35815 : if ( ratio_ism_idx[band][idx_separated_object] == 0 && sf == 0 )
3632 : {
3633 16605 : n_ism_tmp++;
3634 : }
3635 : }
3636 : }
3637 : }
3638 : }
3639 :
3640 : /* encode data for current subframe */
3641 12885 : if ( sf > 0 && n_ism_tmp == numCodingBands )
3642 : {
3643 3252 : 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 );
3644 : }
3645 : else
3646 : {
3647 9633 : 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 );
3648 : }
3649 :
3650 : /* calculate quantized ISM ratios */
3651 : /* save previous subframe indexes */
3652 89052 : for ( band = 0; band < numCodingBands; band++ )
3653 : {
3654 76167 : mvs2s( ratio_ism_idx[band], ratio_ism_idx_prev_sf[band], nchan_ism );
3655 : }
3656 :
3657 12885 : if ( rotate )
3658 : {
3659 23807 : for ( band = 0; band < numCodingBands; band++ )
3660 : {
3661 20384 : if ( hOmasaData->masa_to_total_energy_ratio[sf][band] < MASA2TOTAL_THR )
3662 : {
3663 11572 : tmp = ratio_ism_idx[band][nchan_ism - 1];
3664 11572 : ratio_ism_idx[band][nchan_ism - 1] = ratio_ism_idx[band][0];
3665 11572 : ratio_ism_idx[band][0] = tmp;
3666 : }
3667 : }
3668 : }
3669 : }
3670 : }
3671 :
3672 5790 : 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 );
3673 :
3674 : /* quantize directions */
3675 24498 : for ( obj = 0; obj < nchan_ism; obj++ )
3676 : {
3677 18708 : if ( bits_ism[obj] < 8 )
3678 : {
3679 : /* check is same as previous */
3680 8904 : if ( ( fabs( hIsmMeta[obj]->elevation - hIsmMeta[obj]->q_elevation_old ) < 0.01f ) && ( fabs( hIsmMeta[obj]->azimuth - hIsmMeta[obj]->q_azimuth_old ) < 0.01f ) )
3681 : {
3682 1416 : push_next_indice( hMetaData, 1, 1 );
3683 : /* the old stays the same */
3684 : }
3685 : else
3686 : {
3687 7488 : push_next_indice( hMetaData, 0, 1 );
3688 7488 : 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 );
3689 7488 : push_next_indice( hMetaData, idx_sph, bits_ism[obj] );
3690 7488 : hIsmMeta[obj]->q_elevation_old = hIsmMeta[obj]->elevation;
3691 7488 : hIsmMeta[obj]->q_azimuth_old = hIsmMeta[obj]->azimuth;
3692 : }
3693 : }
3694 : else
3695 : {
3696 9804 : 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 );
3697 9804 : push_next_indice( hMetaData, idx_sph, bits_ism[obj] );
3698 9804 : hIsmMeta[obj]->q_elevation_old = hIsmMeta[obj]->elevation;
3699 9804 : hIsmMeta[obj]->q_azimuth_old = hIsmMeta[obj]->azimuth;
3700 : }
3701 : }
3702 :
3703 5790 : return;
3704 : }
3705 :
3706 :
3707 : /*-------------------------------------------------------------------*
3708 : * ivas_merge_masa_transports()
3709 : *
3710 : * Merge MASA transport channels
3711 : *-------------------------------------------------------------------*/
3712 :
3713 20758 : void ivas_merge_masa_transports(
3714 : float data_in_f1[][L_FRAME48k],
3715 : float *data_in_f2[],
3716 : float *data_out_f[],
3717 : const int16_t input_frame,
3718 : const int16_t num_transport_channels )
3719 : {
3720 : int16_t i, j;
3721 :
3722 62274 : for ( i = 0; i < num_transport_channels; i++ )
3723 : {
3724 39369516 : for ( j = 0; j < input_frame; j++ )
3725 : {
3726 39328000 : data_out_f[i][j] = data_in_f1[i][j] + data_in_f2[i][j];
3727 : }
3728 : }
3729 :
3730 20758 : return;
3731 : }
|
