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
|
/******************************************************************************
*
* Copyright (C) 2018 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
*/
/*!
******************************************************************************
* \file cbr_buffer_control.h
*
* \brief
* This file contains all the necessary declarations for
* cbr_buffer_control functions
*
* \date
* 06/05/2008
*
* \author
* ittiam
*
******************************************************************************
*/
#ifndef CBR_BUFFER_CONTROL_H
#define CBR_BUFFER_CONTROL_H
/*****************************************************************************/
/* Macros */
/*****************************************************************************/
/* Macro for clipping a number between to extremes */
#define CLIP(Number, Max, Min) \
if((Number) > (Max)) \
(Number) = (Max); \
else if((Number) < (Min)) \
(Number) = (Min);
/*****************************************************************************/
/* Structure */
/*****************************************************************************/
typedef struct cbr_buffer_t *cbr_buffer_handle;
/*****************************************************************************/
/* Function Declarations */
/*****************************************************************************/
WORD32 cbr_buffer_num_fill_use_free_memtab(
cbr_buffer_handle *pps_cbr_buffer, itt_memtab_t *ps_memtab, ITT_FUNC_TYPE_E e_func_type);
/* Initialize the cbr Buffer*/
void init_cbr_buffer(
cbr_buffer_handle ps_cbr_buffer,
WORD32 i4_buffer_delay,
WORD32 i4_tgt_frm_rate,
UWORD32 u4_bit_rate,
UWORD32 *u4_num_pics_in_delay_prd,
UWORD32 u4_vbv_buf_size,
UWORD32 u4_intra_frm_int,
rc_type_e u4_rc_type,
UWORD32 u4_peak_bit_rate,
UWORD32 u4_num_frames_in_delay,
float f_max_peak_rate_dur,
LWORD64 i8_num_frames_to_encode,
WORD32 i4_inter_frm_int,
WORD32 i4_cbr_rc_pass,
WORD32 i4_capped_vbr_flag);
/* Check for tgt bits with in CBR buffer*/
WORD32 cbr_buffer_constraint_check(
cbr_buffer_handle ps_cbr_buffer,
WORD32 i4_tgt_bits,
picture_type_e e_pic_type,
WORD32 *pi4_max_tgt_bits,
WORD32 *pi4_min_tgt_bits);
/* Get the buffer status with the current consumed bits*/
vbv_buf_status_e get_cbr_buffer_status(
cbr_buffer_handle ps_cbr_buffer,
WORD32 i4_tot_consumed_bits,
WORD32 *pi4_num_bits_to_prevent_overflow,
picture_type_e e_pic_type,
rc_type_e e_rc_type);
/* Update the CBR buffer at the end of the VOP*/
void update_cbr_buffer(
cbr_buffer_handle ps_cbr_buffer, WORD32 i4_tot_consumed_bits, picture_type_e e_pic_type);
/*Get the bits needed to stuff in case of Underflow*/
WORD32 get_cbr_bits_to_stuff(
cbr_buffer_handle ps_cbr_buffer, WORD32 i4_tot_consumed_bits, picture_type_e e_pic_type);
WORD32 get_cbr_buffer_delay(cbr_buffer_handle ps_cbr_buffer);
WORD32 get_cbr_buffer_size(cbr_buffer_handle ps_cbr_buffer);
WORD32 get_cbr_ebf(cbr_buffer_handle ps_cbr_buffer);
WORD32 get_cbr_max_ebf(cbr_buffer_handle ps_cbr_buffer);
void update_cbr_buf_mismatch_bit(cbr_buffer_handle ps_cbr_buffer, WORD32 i4_error_bits);
WORD32 get_error_bits_for_desired_buf(
cbr_buffer_handle ps_cbr_buffer, WORD32 i4_lap_complexity_q7, WORD32 i4_bit_alloc_period);
WORD32 get_buf_max_drain_rate(cbr_buffer_handle ps_cbr_buffer);
WORD32 vbr_stream_buffer_constraint_check(
cbr_buffer_handle ps_cbr_buffer,
WORD32 i4_tgt_bits,
picture_type_e e_pic_type,
WORD32 *pi4_max_tgt_bits,
WORD32 *pi4_min_tgt_bits);
void change_cbr_vbv_bit_rate(
cbr_buffer_handle ps_cbr_buffer, WORD32 *i4_bit_rate, WORD32 i4_peak_bitrate);
void change_cbr_vbv_tgt_frame_rate(cbr_buffer_handle ps_cbr_buffer, WORD32 i4_tgt_frm_rate);
void change_cbr_vbv_num_pics_in_delay_period(
cbr_buffer_handle ps_cbr_buffer, UWORD32 *u4_num_pics_in_delay_prd);
void change_cbr_buffer_delay(cbr_buffer_handle ps_cbr_buffer, WORD32 i4_buffer_delay);
void set_cbr_ebf(cbr_buffer_handle ps_cbr_buffer, WORD32 i32_init_ebf);
LWORD64 get_num_frms_encoded(cbr_buffer_handle ps_cbr_buffer);
LWORD64 get_num_frms_to_encode(cbr_buffer_handle ps_cbr_buffer);
WORD32 get_vbv_buffer_based_excess(
cbr_buffer_handle ps_cbr_buffer,
float f_complexity_peak_rate,
float f_cur_bits_complexity,
WORD32 bit_alloc_period,
WORD32 i4_num_gops_for_excess);
rc_type_e get_rc_type(cbr_buffer_handle ps_cbr_buffer);
void cbr_modify_ebf_estimate(cbr_buffer_handle ps_cbr_buffer, WORD32 i4_bit_error);
UWORD32 cbr_get_delay_frames(cbr_buffer_handle ps_cbr_buffer);
#endif /* CBR_BUFFER_CONTROL_H */
|
