xref: /aosp_15_r20/external/libxaac/encoder/ixheaace_mps_spatial_bitstream.h (revision 15dc779a375ca8b5125643b829a8aa4b70d7f451)
1*15dc779aSAndroid Build Coastguard Worker /******************************************************************************
2*15dc779aSAndroid Build Coastguard Worker  *                                                                            *
3*15dc779aSAndroid Build Coastguard Worker  * Copyright (C) 2023 The Android Open Source Project
4*15dc779aSAndroid Build Coastguard Worker  *
5*15dc779aSAndroid Build Coastguard Worker  * Licensed under the Apache License, Version 2.0 (the "License");
6*15dc779aSAndroid Build Coastguard Worker  * you may not use this file except in compliance with the License.
7*15dc779aSAndroid Build Coastguard Worker  * You may obtain a copy of the License at:
8*15dc779aSAndroid Build Coastguard Worker  *
9*15dc779aSAndroid Build Coastguard Worker  * http://www.apache.org/licenses/LICENSE-2.0
10*15dc779aSAndroid Build Coastguard Worker  *
11*15dc779aSAndroid Build Coastguard Worker  * Unless required by applicable law or agreed to in writing, software
12*15dc779aSAndroid Build Coastguard Worker  * distributed under the License is distributed on an "AS IS" BASIS,
13*15dc779aSAndroid Build Coastguard Worker  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14*15dc779aSAndroid Build Coastguard Worker  * See the License for the specific language governing permissions and
15*15dc779aSAndroid Build Coastguard Worker  * limitations under the License.
16*15dc779aSAndroid Build Coastguard Worker  *
17*15dc779aSAndroid Build Coastguard Worker  *****************************************************************************
18*15dc779aSAndroid Build Coastguard Worker  * Originally developed and contributed by Ittiam Systems Pvt. Ltd, Bangalore
19*15dc779aSAndroid Build Coastguard Worker  */
20*15dc779aSAndroid Build Coastguard Worker 
21*15dc779aSAndroid Build Coastguard Worker #pragma once
22*15dc779aSAndroid Build Coastguard Worker typedef struct {
23*15dc779aSAndroid Build Coastguard Worker   WORD32 num_ott_boxes;
24*15dc779aSAndroid Build Coastguard Worker   WORD32 ott_mode_lfe[MAX_NUM_BOXES];
25*15dc779aSAndroid Build Coastguard Worker   WORD32 num_ttt_boxes;
26*15dc779aSAndroid Build Coastguard Worker   WORD32 num_in_chan;
27*15dc779aSAndroid Build Coastguard Worker   WORD32 num_out_chan;
28*15dc779aSAndroid Build Coastguard Worker   WORD32 arbitrary_tree;
29*15dc779aSAndroid Build Coastguard Worker } ixheaace_mps_sac_tree_description;
30*15dc779aSAndroid Build Coastguard Worker 
31*15dc779aSAndroid Build Coastguard Worker typedef struct {
32*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_ott_bands;
33*15dc779aSAndroid Build Coastguard Worker } ixheaace_mps_sac_ott_config;
34*15dc779aSAndroid Build Coastguard Worker 
35*15dc779aSAndroid Build Coastguard Worker typedef struct {
36*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_ttt_dual_mode;
37*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_ttt_mode_low;
38*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_ttt_mode_high;
39*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_ttt_bands_low;
40*15dc779aSAndroid Build Coastguard Worker } ixheaace_mps_sac_ttt_config;
41*15dc779aSAndroid Build Coastguard Worker 
42*15dc779aSAndroid Build Coastguard Worker typedef struct {
43*15dc779aSAndroid Build Coastguard Worker   UWORD32 bs_sampling_frequency;
44*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_smooth_config;
45*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_tree_config;
46*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_tree_description tree_description;
47*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_frame_length;
48*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_freq_res;
49*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_quant_mode;
50*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_fixed_gain_sur;
51*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_fixed_gain_lfe;
52*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_fixed_gain_dmx;
53*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_matrix_mode;
54*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_temp_shape_config;
55*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_decorr_config;
56*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_3d_audio_mode;
57*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_one_icc;
58*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_arbitrary_downmix;
59*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_residual_coding;
60*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_ott_config ott_config[MAX_NUM_BOXES];
61*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_ttt_config ttt_config[MAX_NUM_BOXES];
62*15dc779aSAndroid Build Coastguard Worker   WORD32 aac_residual_fs;
63*15dc779aSAndroid Build Coastguard Worker   WORD32 aac_residual_frames_per_spatial_frame;
64*15dc779aSAndroid Build Coastguard Worker   WORD32 aac_residual_use_tns;
65*15dc779aSAndroid Build Coastguard Worker   FLOAT32 aac_residual_bwhz[MAX_NUM_BOXES];
66*15dc779aSAndroid Build Coastguard Worker   WORD32 aac_residual_bit_rate[MAX_NUM_BOXES];
67*15dc779aSAndroid Build Coastguard Worker } ixheaace_mps_sac_specific_config;
68*15dc779aSAndroid Build Coastguard Worker 
69*15dc779aSAndroid Build Coastguard Worker typedef struct {
70*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_framing_type;
71*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_num_param_sets;
72*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_param_slots[MAX_NUM_PARAMS];
73*15dc779aSAndroid Build Coastguard Worker } ixheaace_mps_sac_framing_info;
74*15dc779aSAndroid Build Coastguard Worker 
75*15dc779aSAndroid Build Coastguard Worker typedef struct {
76*15dc779aSAndroid Build Coastguard Worker   WORD32 cld[MAX_NUM_BOXES][MAX_NUM_PARAMS][MAX_NUM_BINS];
77*15dc779aSAndroid Build Coastguard Worker   WORD32 icc[MAX_NUM_BOXES][MAX_NUM_PARAMS][MAX_NUM_BINS];
78*15dc779aSAndroid Build Coastguard Worker   WORD32 cld_old[MAX_NUM_BOXES][MAX_NUM_BINS];
79*15dc779aSAndroid Build Coastguard Worker   WORD32 icc_old[MAX_NUM_BOXES][MAX_NUM_BINS];
80*15dc779aSAndroid Build Coastguard Worker } ixheaace_mps_sac_ott_data;
81*15dc779aSAndroid Build Coastguard Worker 
82*15dc779aSAndroid Build Coastguard Worker typedef struct {
83*15dc779aSAndroid Build Coastguard Worker   WORD32 cpc_cld1[MAX_NUM_BOXES][MAX_NUM_PARAMS][MAX_NUM_BINS];
84*15dc779aSAndroid Build Coastguard Worker   WORD32 cpc_cld2[MAX_NUM_BOXES][MAX_NUM_PARAMS][MAX_NUM_BINS];
85*15dc779aSAndroid Build Coastguard Worker   WORD32 icc[MAX_NUM_BOXES][MAX_NUM_PARAMS][MAX_NUM_BINS];
86*15dc779aSAndroid Build Coastguard Worker   WORD32 cpc_cld1_old[MAX_NUM_BOXES][MAX_NUM_BINS];
87*15dc779aSAndroid Build Coastguard Worker   WORD32 cpc_cld2_old[MAX_NUM_BOXES][MAX_NUM_BINS];
88*15dc779aSAndroid Build Coastguard Worker   WORD32 icc_old[MAX_NUM_BOXES][MAX_NUM_BINS];
89*15dc779aSAndroid Build Coastguard Worker } ixheaace_mps_sac_ttt_data;
90*15dc779aSAndroid Build Coastguard Worker 
91*15dc779aSAndroid Build Coastguard Worker typedef struct {
92*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_smooth_control;
93*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_smooth_mode[MAX_NUM_PARAMS];
94*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_smooth_time[MAX_NUM_PARAMS];
95*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_freq_res_stride[MAX_NUM_PARAMS];
96*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_smg_data[MAX_NUM_PARAMS][MAX_NUM_BINS];
97*15dc779aSAndroid Build Coastguard Worker } ixheaace_mps_sac_smg_data;
98*15dc779aSAndroid Build Coastguard Worker 
99*15dc779aSAndroid Build Coastguard Worker typedef struct {
100*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_temp_shape_enable;
101*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_temp_shape_enable_channel[MAX_NUM_OUTPUTCHANNELS];
102*15dc779aSAndroid Build Coastguard Worker } ixheaace_mps_sac_temp_shape_data;
103*15dc779aSAndroid Build Coastguard Worker 
104*15dc779aSAndroid Build Coastguard Worker typedef struct {
105*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_xxx_data_mode[MAX_NUM_BOXES][MAX_NUM_PARAMS];
106*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_data_pair[MAX_NUM_BOXES][MAX_NUM_PARAMS];
107*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_quant_coarse_xxx[MAX_NUM_BOXES][MAX_NUM_PARAMS];
108*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_freq_res_stride_xxx[MAX_NUM_BOXES][MAX_NUM_PARAMS];
109*15dc779aSAndroid Build Coastguard Worker } ixheaace_mps_sac_lossless_data;
110*15dc779aSAndroid Build Coastguard Worker 
111*15dc779aSAndroid Build Coastguard Worker typedef struct {
112*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_framing_info framing_info;
113*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_independency_flag;
114*15dc779aSAndroid Build Coastguard Worker   WORD32 bs_independency_flag_count;
115*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_ott_data ott_data;
116*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_ttt_data ttt_data;
117*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_smg_data smg_data;
118*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_temp_shape_data temp_shape_data;
119*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_lossless_data cld_lossless_data;
120*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_lossless_data icc_lossless_data;
121*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_lossless_data cpc_lossless_data;
122*15dc779aSAndroid Build Coastguard Worker   WORD32 aac_window_grouping[MAX_AAC_FRAMES][MAX_AAC_SHORTWINDOWGROUPS];
123*15dc779aSAndroid Build Coastguard Worker   WORD32 aac_window_sequence;
124*15dc779aSAndroid Build Coastguard Worker } ixheaace_mps_sac_spatial_frame;
125*15dc779aSAndroid Build Coastguard Worker 
126*15dc779aSAndroid Build Coastguard Worker typedef struct {
127*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_specific_config spatial_specific_config;
128*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_spatial_frame current_frame;
129*15dc779aSAndroid Build Coastguard Worker 
130*15dc779aSAndroid Build Coastguard Worker   WORD32 num_bins;
131*15dc779aSAndroid Build Coastguard Worker   WORD32 total_bits;
132*15dc779aSAndroid Build Coastguard Worker } ixheaace_mps_sac_bsf_instance;
133*15dc779aSAndroid Build Coastguard Worker 
134*15dc779aSAndroid Build Coastguard Worker typedef struct {
135*15dc779aSAndroid Build Coastguard Worker   WORD32 tree_config;
136*15dc779aSAndroid Build Coastguard Worker   WORD32 output_channels;
137*15dc779aSAndroid Build Coastguard Worker   WORD32 time_slots;
138*15dc779aSAndroid Build Coastguard Worker   WORD32 frame_size;
139*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_sbr_encoder_ana_filter_bank filterbank[6];
140*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_hyb_filter_state hyb_state[6];
141*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_bsf_instance *bitstream_formatter;
142*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_qmf_ana_filter_bank qmf_fltbank;
143*15dc779aSAndroid Build Coastguard Worker   ixheaace_mps_sac_qmf_synth_filter_bank qmf_synth_fltbank;
144*15dc779aSAndroid Build Coastguard Worker   FLOAT32 in1[MAX_INPUT_CHANNELS][MAX_BUFFER_SIZE + DELAY_COMPENSATION];
145*15dc779aSAndroid Build Coastguard Worker   FLOAT32 sbr_qmf_states_synthesis[2 * QMF_FILTER_STATE_SYN_SIZE];
146*15dc779aSAndroid Build Coastguard Worker } ixheaace_mps_sac_enc, *ixheaace_mps_sac_pstr_enc;
147*15dc779aSAndroid Build Coastguard Worker 
148*15dc779aSAndroid Build Coastguard Worker WORD32 ixheaace_mps_515_icc_quant(FLOAT32 val);
149*15dc779aSAndroid Build Coastguard Worker 
150*15dc779aSAndroid Build Coastguard Worker WORD32 ixheaace_mps_515_cld_quant(FLOAT32 val);
151*15dc779aSAndroid Build Coastguard Worker 
152*15dc779aSAndroid Build Coastguard Worker VOID ixheaace_mps_515_ttt_box(WORD32 slots, FLOAT32 *ptr_real1, FLOAT32 *ptr_imag1,
153*15dc779aSAndroid Build Coastguard Worker                               FLOAT32 *ptr_real2, FLOAT32 *ptr_imag2, FLOAT32 *ptr_real3,
154*15dc779aSAndroid Build Coastguard Worker                               FLOAT32 *ptr_imag3, WORD32 *ptr_qclds1, WORD32 *ptr_qclds2);
155*15dc779aSAndroid Build Coastguard Worker 
156*15dc779aSAndroid Build Coastguard Worker VOID ixheaace_mps_515_ott_box(WORD32 slots, FLOAT32 *ptr_real1, FLOAT32 *ptr_imag1,
157*15dc779aSAndroid Build Coastguard Worker                               FLOAT32 *ptr_real2, FLOAT32 *ptr_imag2, WORD32 *ptr_p_qclds,
158*15dc779aSAndroid Build Coastguard Worker                               WORD32 *ptr_qiccs);
159*15dc779aSAndroid Build Coastguard Worker 
160*15dc779aSAndroid Build Coastguard Worker IA_ERRORCODE
161*15dc779aSAndroid Build Coastguard Worker ixheaace_mps_515_write_spatial_specific_config(ixheaace_bit_buf_handle pstr_bit_buf,
162*15dc779aSAndroid Build Coastguard Worker                                                ixheaace_mps_sac_bsf_instance *pstr_bsf_instance);
163*15dc779aSAndroid Build Coastguard Worker 
164*15dc779aSAndroid Build Coastguard Worker IA_ERRORCODE
165*15dc779aSAndroid Build Coastguard Worker ixheaace_mps_515_write_spatial_frame(ixheaace_bit_buf_handle pstr_bit_buf,
166*15dc779aSAndroid Build Coastguard Worker                                      ixheaace_mps_sac_bsf_instance *pstr_bsf_instance);
167