1 /******************************************************************************
2 *
3 * Copyright (C) 2022 The Android Open Source Project
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at:
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 *
17 *****************************************************************************
18 * Originally developed and contributed by Ittiam Systems Pvt. Ltd, Bangalore
19 */
20
21 /**
22 ******************************************************************************
23 * @file
24 * isvce_rc_mem_interface.c
25 *
26 * @brief
27 * This file contains api function definitions for rate control memtabs
28 *
29 * @author
30 * ittiam
31 *
32 * List of Functions
33 * - fill_memtab()
34 * - use_or_fill_base()
35 * - isvce_map_rc_mem_recs_to_itt_api()
36 * - isvce_map_itt_mem_rec_to_rc_mem_rec()
37 * - isvce_get_rate_control_mem_tab()
38 *
39 * @remarks
40 * None
41 *
42 *******************************************************************************
43 */
44
45 /*****************************************************************************/
46 /* File Includes */
47 /*****************************************************************************/
48
49 /* System include files */
50 #include <stdio.h>
51 #include <string.h>
52 #include <stdlib.h>
53 #include <assert.h>
54 #include <stdarg.h>
55 #include <math.h>
56
57 /* User Include Files */
58 #include "ih264e_config.h"
59 #include "ih264_typedefs.h"
60 #include "ih264_size_defs.h"
61 #include "iv2.h"
62 #include "ive2.h"
63 #include "ime_distortion_metrics.h"
64 #include "ime_defs.h"
65 #include "ime_structs.h"
66 #include "isvce.h"
67 #include "ithread.h"
68 #include "isvc_defs.h"
69 #include "ih264_debug.h"
70 #include "isvc_macros.h"
71 #include "ih264_platform_macros.h"
72 #include "ih264_error.h"
73 #include "isvc_structs.h"
74 #include "isvc_trans_quant_itrans_iquant.h"
75 #include "isvc_inter_pred_filters.h"
76 #include "isvc_mem_fns.h"
77 #include "ih264_padding.h"
78 #include "ih264_intra_pred_filters.h"
79 #include "ih264_deblk_edge_filters.h"
80 #include "isvc_common_tables.h"
81 #include "ih264_list.h"
82 #include "isvc_cabac_tables.h"
83 #include "ih264e_error.h"
84 #include "isvce_defs.h"
85 #include "ih264e_bitstream.h"
86 #include "irc_cntrl_param.h"
87 #include "irc_frame_info_collector.h"
88 #include "isvce_rate_control.h"
89 #include "isvce_cabac_structs.h"
90 #include "isvce_structs.h"
91 #include "ih264e_master.h"
92 #include "ih264_buf_mgr.h"
93 #include "ih264_dpb_mgr.h"
94 #include "isvce_utils.h"
95 #include "ih264e_platform_macros.h"
96 #include "ih264_cavlc_tables.h"
97 #include "ih264e_statistics.h"
98 #include "ih264e_trace.h"
99 #include "ih264e_fmt_conv.h"
100 #include "isvce_cavlc.h"
101 #include "ih264e_rc_mem_interface.h"
102 #include "isvce_rc_mem_interface.h"
103 #include "ih264e_time_stamp.h"
104 #include "irc_common.h"
105 #include "irc_rd_model.h"
106 #include "irc_est_sad.h"
107 #include "irc_fixed_point_error_bits.h"
108 #include "irc_vbr_storage_vbv.h"
109 #include "irc_picture_type.h"
110 #include "irc_bit_allocation.h"
111 #include "irc_mb_model_based.h"
112 #include "irc_cbr_buffer_control.h"
113 #include "irc_vbr_str_prms.h"
114 #include "irc_rate_control_api.h"
115 #include "irc_rate_control_api_structs.h"
116 #include "ih264e_modify_frm_rate.h"
117
118 /*****************************************************************************/
119 /* Function Definitions */
120 /*****************************************************************************/
121
122 /**
123 ******************************************************************************
124 *
125 * @brief This function maps rc mem records structure to encoder lib mem records
126 * structure
127 *
128 * @par Description
129 * This function maps rc mem records structure to encoder lib mem records
130 * structure
131 *
132 * @param[in] ps_mem
133 * pointer to encoder lib mem records
134 *
135 * @param[in] rc_memtab
136 * pointer to rc mem records
137 *
138 * @param[in] num_mem_recs
139 * number of memory records
140 *
141 * @return void
142 *
143 ******************************************************************************
144 */
isvce_map_rc_mem_recs_to_itt_api(iv_mem_rec_t * ps_mem,itt_memtab_t * rc_memtab,UWORD32 num_mem_recs)145 static void isvce_map_rc_mem_recs_to_itt_api(iv_mem_rec_t *ps_mem, itt_memtab_t *rc_memtab,
146 UWORD32 num_mem_recs)
147 {
148 UWORD32 j;
149 UWORD32 Size, align;
150
151 for(j = 0; j < num_mem_recs; j++)
152 {
153 Size = rc_memtab->u4_size;
154 align = rc_memtab->i4_alignment;
155
156 /* we always ask for external persistent cacheable memory */
157 FILL_MEMTAB(ps_mem, j, Size, align, IV_EXTERNAL_CACHEABLE_PERSISTENT_MEM);
158
159 rc_memtab++;
160 }
161 }
162
163 /**
164 *******************************************************************************
165 *
166 * @brief This function maps encoder lib mem records structure to RC memory
167 * records structure
168 *
169 * @par Description
170 * This function maps encoder lib mem records structure to RC memory
171 * records structure
172 *
173 * @param[in] ps_mem
174 * pointer to encoder lib mem records
175 *
176 * @param[in] rc_memtab
177 * pointer to rc mem records
178 *
179 * @param[in] num_mem_recs
180 * Number of memory records
181
182 * @returns none
183 *
184 * @remarks
185 *
186 *******************************************************************************
187 */
isvce_map_itt_mem_rec_to_rc_mem_rec(iv_mem_rec_t * ps_mem,itt_memtab_t * rc_memtab,UWORD32 num_mem_recs)188 static void isvce_map_itt_mem_rec_to_rc_mem_rec(iv_mem_rec_t *ps_mem, itt_memtab_t *rc_memtab,
189 UWORD32 num_mem_recs)
190 {
191 UWORD32 i;
192
193 for(i = 0; i < num_mem_recs; i++)
194 {
195 rc_memtab->i4_alignment = ps_mem->u4_mem_alignment;
196 rc_memtab->u4_size = ps_mem->u4_mem_size;
197 rc_memtab->pv_base = ps_mem->pv_base;
198
199 /* only DDR memory is available */
200 rc_memtab->e_mem_region = DDR;
201 rc_memtab->e_usage = PERSISTENT;
202
203 rc_memtab++;
204 ps_mem++;
205 }
206 }
207
208 /**
209 ******************************************************************************
210 *
211 * @brief Get memtabs for rate control
212 *
213 * @par Description
214 * This routine is used to Get/init memtabs for rate control
215 *
216 * @param[in] pv_rate_control
217 * pointer to rate control context (handle)
218 *
219 * @param[in] ps_mem
220 * pointer to encoder lib mem records
221 *
222 * @param[in] e_func_type
223 * enum that dictates fill memory records or Init memory records
224 *
225 * @return total number of mem records
226 *
227 ******************************************************************************
228 */
isvce_get_rate_control_mem_tab(void * pv_rate_control,iv_mem_rec_t * ps_mem,ITT_FUNC_TYPE_E e_func_type)229 WORD32 isvce_get_rate_control_mem_tab(void *pv_rate_control, iv_mem_rec_t *ps_mem,
230 ITT_FUNC_TYPE_E e_func_type)
231 {
232 itt_memtab_t as_itt_memtab[NUM_SVCE_RC_MEMTABS];
233 WORD32 i4_num_memtab = 0, j = 0;
234 void *refptr2[RC_MEM_CNT];
235 void **refptr1[RC_MEM_CNT];
236 isvce_rate_control_ctxt_t *ps_rate_control = pv_rate_control;
237
238 for(j = 0; j < RC_MEM_CNT; j++) refptr1[j] = &(refptr2[j]);
239
240 j = 0;
241
242 if(e_func_type == USE_BASE || e_func_type == FILL_BASE)
243 {
244 refptr1[RC_MEM_FRAME_TIME] = &ps_rate_control->pps_frame_time;
245 refptr1[RC_MEM_TIME_STAMP] = &ps_rate_control->pps_time_stamp;
246 refptr1[RC_MEM_FRAME_RATE] = &ps_rate_control->pps_pd_frm_rate;
247 refptr1[RC_MEM_API_L0] = &ps_rate_control->apps_rate_control_api[0];
248 refptr1[RC_MEM_API_L1] = &ps_rate_control->apps_rate_control_api[1];
249 refptr1[RC_MEM_API_L2] = &ps_rate_control->apps_rate_control_api[2];
250 }
251
252 /* Get the total number of memtabs used by Frame time Module */
253 i4_num_memtab = ih264e_frame_time_get_init_free_memtab(
254 (frame_time_t **) refptr1[RC_MEM_FRAME_TIME], NULL, GET_NUM_MEMTAB);
255 /* Few extra steps during init */
256 isvce_map_itt_mem_rec_to_rc_mem_rec((&ps_mem[j]), as_itt_memtab + j, i4_num_memtab);
257 /* Fill the memtabs used by Frame time Module */
258 i4_num_memtab = ih264e_frame_time_get_init_free_memtab(
259 (frame_time_t **) refptr1[RC_MEM_FRAME_TIME], as_itt_memtab + j, e_func_type);
260 /* Mapping ittiam memtabs to App. memtabs */
261 isvce_map_rc_mem_recs_to_itt_api((&ps_mem[j]), as_itt_memtab + j, i4_num_memtab);
262 j += i4_num_memtab;
263
264 /* Get the total number of memtabs used by Time stamp Module */
265 i4_num_memtab = ih264e_time_stamp_get_init_free_memtab(
266 (time_stamp_t **) refptr1[RC_MEM_TIME_STAMP], NULL, GET_NUM_MEMTAB);
267 /* Few extra steps during init */
268 isvce_map_itt_mem_rec_to_rc_mem_rec((&ps_mem[j]), as_itt_memtab + j, i4_num_memtab);
269 /* Fill the memtabs used by Time Stamp Module */
270 i4_num_memtab = ih264e_time_stamp_get_init_free_memtab(
271 (time_stamp_t **) refptr1[RC_MEM_TIME_STAMP], as_itt_memtab + j, e_func_type);
272 /* Mapping ittiam memtabs to App. memtabs */
273 isvce_map_rc_mem_recs_to_itt_api((&ps_mem[j]), as_itt_memtab + j, i4_num_memtab);
274 j += i4_num_memtab;
275
276 /* Get the total number of memtabs used by Frame rate Module */
277 i4_num_memtab = ih264e_pd_frm_rate_get_init_free_memtab(
278 (pd_frm_rate_t **) refptr1[RC_MEM_FRAME_RATE], NULL, GET_NUM_MEMTAB);
279 /* Few extra steps during init */
280 isvce_map_itt_mem_rec_to_rc_mem_rec((&ps_mem[j]), as_itt_memtab + j, i4_num_memtab);
281 /* Fill the memtabs used by Frame Rate Module */
282 i4_num_memtab = ih264e_pd_frm_rate_get_init_free_memtab(
283 (pd_frm_rate_t **) refptr1[RC_MEM_FRAME_RATE], as_itt_memtab + j, e_func_type);
284 /* Mapping ittiam memtabs to App. memtabs */
285 isvce_map_rc_mem_recs_to_itt_api((&ps_mem[j]), as_itt_memtab + j, i4_num_memtab);
286 j += i4_num_memtab;
287
288 /* Get the total number of memtabs used by Rate Controller */
289 i4_num_memtab = irc_rate_control_num_fill_use_free_memtab(
290 (rate_control_api_t **) refptr1[RC_MEM_API_L0], NULL, GET_NUM_MEMTAB);
291 /* Few extra steps during init */
292 isvce_map_itt_mem_rec_to_rc_mem_rec((&ps_mem[j]), as_itt_memtab + j, i4_num_memtab);
293 /* Fill the memtabs used by Rate Controller */
294 i4_num_memtab = irc_rate_control_num_fill_use_free_memtab(
295 (rate_control_api_t **) refptr1[RC_MEM_API_L0], as_itt_memtab + j, e_func_type);
296 /* Mapping ittiam memtabs to App. memtabs */
297 isvce_map_rc_mem_recs_to_itt_api((&ps_mem[j]), as_itt_memtab + j, i4_num_memtab);
298 j += i4_num_memtab;
299
300 /* Get the total number of memtabs used by Rate Controller */
301 i4_num_memtab = irc_rate_control_num_fill_use_free_memtab(
302 (rate_control_api_t **) refptr1[RC_MEM_API_L1], NULL, GET_NUM_MEMTAB);
303 /* Few extra steps during init */
304 isvce_map_itt_mem_rec_to_rc_mem_rec((&ps_mem[j]), as_itt_memtab + j, i4_num_memtab);
305 /* Fill the memtabs used by Rate Controller */
306 i4_num_memtab = irc_rate_control_num_fill_use_free_memtab(
307 (rate_control_api_t **) refptr1[RC_MEM_API_L1], as_itt_memtab + j, e_func_type);
308 /* Mapping ittiam memtabs to App. memtabs */
309 isvce_map_rc_mem_recs_to_itt_api((&ps_mem[j]), as_itt_memtab + j, i4_num_memtab);
310 j += i4_num_memtab;
311
312 /* Get the total number of memtabs used by Rate Controller */
313 i4_num_memtab = irc_rate_control_num_fill_use_free_memtab(
314 (rate_control_api_t **) refptr1[RC_MEM_API_L2], NULL, GET_NUM_MEMTAB);
315 /* Few extra steps during init */
316 isvce_map_itt_mem_rec_to_rc_mem_rec((&ps_mem[j]), as_itt_memtab + j, i4_num_memtab);
317 /* Fill the memtabs used by Rate Controller */
318 i4_num_memtab = irc_rate_control_num_fill_use_free_memtab(
319 (rate_control_api_t **) refptr1[RC_MEM_API_L2], as_itt_memtab + j, e_func_type);
320 /* Mapping ittiam memtabs to App. memtabs */
321 isvce_map_rc_mem_recs_to_itt_api((&ps_mem[j]), as_itt_memtab + j, i4_num_memtab);
322 j += i4_num_memtab;
323
324 return j; /* Total MemTabs Needed by Rate Control Module */
325 }
326