1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
|
/******************************************************************************
*
* Copyright (C) 2015 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at:
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*****************************************************************************
* Originally developed and contributed by Ittiam Systems Pvt. Ltd, Bangalore
*/
#ifndef _RATE_CONTROL_API_H_
#define _RATE_CONTROL_API_H_
#define RC_OK 0
#define RC_FAIL -1
#define RC_BENIGN_ERR -2
/* This file should only contain RC API function declarations */
typedef struct rate_control_api_t *rate_control_handle;
WORD32 irc_rate_control_num_fill_use_free_memtab(rate_control_handle *pps_rate_control_api,
itt_memtab_t *ps_memtab,
ITT_FUNC_TYPE_E e_func_type);
void irc_initialise_rate_control(rate_control_handle ps_rate_control_api,
rc_type_e e_rate_control_type,
UWORD8 u1_is_mb_level_rc_on,
UWORD32 u4_avg_bit_rate,
UWORD32 *pu4_peak_bit_rate,
UWORD32 u4_min_bit_rate,
UWORD32 u4_frame_rate,
UWORD32 u4_max_delay,
UWORD32 u4_intra_frame_interval,
WORD32 i4_inter_frm_int,
UWORD8 *pu1_init_qp,
UWORD32 u4_max_vbv_buff_size,
WORD32 i4_max_inter_frm_int,
WORD32 i4_is_gop_closed,
UWORD8 *pu1_min_max_qp,
WORD32 i4_use_est_intra_sad,
UWORD32 u4_src_ticks,
UWORD32 u4_tgt_ticks);
/*****************************************************************************
Process level API fuctions (FRAME LEVEL)
*****************************************************************************/
void irc_flush_buf_frames(rate_control_handle ps_rate_control_api);
void irc_post_encode_frame_skip(rate_control_handle ps_rate_control_api,
picture_type_e e_pic_type);
void irc_add_picture_to_stack(rate_control_handle rate_control_api,
WORD32 i4_enc_pic_id);
void irc_add_picture_to_stack_re_enc(rate_control_handle rate_control_api,
WORD32 i4_enc_pic_id,
picture_type_e e_pic_type);
void irc_get_picture_details(rate_control_handle rate_control_api,
WORD32 *pi4_pic_id,
WORD32 *pi4_pic_disp_order_no,
picture_type_e *pe_pic_type);
/* Gets the frame level Qp */
UWORD8 irc_get_frame_level_qp(rate_control_handle rate_control_api,
picture_type_e pic_type,
WORD32 i4_max_frm_bits);
vbv_buf_status_e irc_get_buffer_status(rate_control_handle rate_control_api,
WORD32 i4_total_frame_bits,
picture_type_e e_pic_type,
WORD32 *pi4_num_bits_to_prevent_vbv_underflow);
WORD32 irc_get_prev_frm_est_bits(rate_control_handle ps_rate_control_api);
void irc_update_pic_handling_state(rate_control_handle ps_rate_control_api,
picture_type_e e_pic_type);
void irc_update_frame_level_info(rate_control_handle ps_rate_control_api,
picture_type_e e_pic_type,
WORD32 *pi4_mb_type_sad,
WORD32 i4_total_frame_bits,
WORD32 i4_model_updation_hdr_bits,
WORD32 *pi4_mb_type_tex_bits,
WORD32 *pi4_tot_mb_type_qp,
WORD32 *pi4_tot_mb_in_type,
WORD32 i4_avg_activity,
UWORD8 u1_is_scd,
WORD32 i4_is_it_a_skip,
WORD32 i4_intra_frm_cost,
WORD32 i4_is_pic_handling_done);
/*****************************************************************************
MB LEVEL API (just wrapper fucntions)
*****************************************************************************/
void irc_init_mb_rc_frame_level(rate_control_handle ps_rate_control_api,
UWORD8 u1_frame_qp);/* Current frame qp*/
void irc_get_mb_level_qp(rate_control_handle ps_rate_control_api,
WORD32 i4_cur_mb_activity,
WORD32 *pi4_mb_qp,
picture_type_e e_pic_type);
WORD32 irc_get_bits_to_stuff(rate_control_handle ps_rate_control_api,
WORD32 i4_tot_consumed_bits,
picture_type_e e_pic_type);
/******************************************************************************
Control Level API functions
Logic: The control call sets the state structure of the rate control api
accordingly such that the next process call would implement the same.
******************************************************************************/
void irc_change_inter_frm_int_call(rate_control_handle ps_rate_control_api,
WORD32 i4_inter_frm_int);
void irc_change_intra_frm_int_call(rate_control_handle ps_rate_control_api,
WORD32 i4_intra_frm_int);
void irc_change_avg_bit_rate(rate_control_handle ps_rate_control_api,
UWORD32 u4_average_bit_rate);
void irc_change_frame_rate(rate_control_handle ps_rate_control_api,
UWORD32 u4_frame_rate,
UWORD32 u4_src_ticks,
UWORD32 u4_target_ticks);
void irc_change_frm_rate_for_bit_alloc(rate_control_handle ps_rate_control_api,
UWORD32 u4_frame_rate);
void irc_change_init_qp(rate_control_handle ps_rate_control_api,
UWORD8 *init_qp);
WORD32 irc_change_peak_bit_rate(rate_control_handle ps_rate_control_api,
UWORD32 *u4_peak_bit_rate);
void irc_change_buffer_delay(rate_control_handle ps_rate_control_api,
UWORD32 u4_buffer_delay);
void irc_force_I_frame(rate_control_handle ps_rate_control_api);
void irc_change_min_max_qp(rate_control_handle ps_rate_control_api,
UWORD8 *u1_min_max_qp);
/********************************************************************************
Getter functions
For getting the current state of the rate control structures
********************************************************************************/
UWORD32 irc_get_frame_rate(rate_control_handle ps_rate_control_api);
UWORD32 irc_get_bit_rate(rate_control_handle ps_rate_control_api);
UWORD32 irc_get_intra_frame_interval(rate_control_handle ps_rate_control_api);
UWORD32 irc_get_inter_frame_interval(rate_control_handle ps_rate_control_api);
rc_type_e irc_get_rc_type(rate_control_handle ps_rate_control_api);
WORD32 irc_get_bits_per_frame(rate_control_handle ps_rate_control_api);
UWORD32 irc_get_peak_bit_rate(rate_control_handle ps_rate_control_api,
WORD32 i4_index);
UWORD32 irc_get_max_delay(rate_control_handle ps_rate_control_api);
UWORD32 irc_get_seq_no(rate_control_handle ps_rate_control_api);
WORD32 irc_get_rem_bits_in_period(rate_control_handle ps_rate_control_api);
WORD32 irc_get_vbv_buf_fullness(rate_control_handle ps_rate_control_api);
WORD32 irc_get_vbv_buf_size(rate_control_handle ps_rate_control_api);
WORD32 irc_get_vbv_fulness_with_cur_bits(rate_control_handle ps_rate_control_api,
UWORD32 u4_bits);
#endif
|
