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
|
/******************************************************************************
*
* 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
*/
/**
*******************************************************************************
* @file
* ih264e_time_stamp.h
*
* @brief
* This file contains function declarations used for managing input and output
* frame time stamps
*
* @author
* ittiam
*
* @remarks
* none
*
*******************************************************************************
*/
#ifndef _IH264E_TIME_STAMP_H_
#define _IH264E_TIME_STAMP_H_
/*****************************************************************************/
/* Structures */
/*****************************************************************************/
/**
* Parameters for Src/Tgt frames that are encoded
*/
typedef struct frame_time_t
{
/* common time base(=LCM) between source and target frame rate (in ticks)*/
WORD32 common_time_base;
/* number of ticks between two source frames */
UWORD32 u4_src_frm_time_incr;
/* number of ticks between two target frames */
UWORD32 u4_tgt_frm_time_incr;
/* Source frame time - measured as modulo of common time base
and incremented by src_frm_time_incr */
UWORD32 u4_src_frm_time;
/* Target frame time - measured as modulo of common time base
and incremented by tgt_frm_time_incr */
UWORD32 u4_tgt_frm_time;
/* Number of frames not to be skipped while maintaining
tgt_frm_rate due to delta_time_stamp */
UWORD32 u4_num_frms_dont_skip;
}frame_time_t;
typedef struct frame_time_t *frame_time_handle;
/**
* Parameters that go in the bitstream based on tgt_frm_rate
* 1) Initialize the vop_time_incr_res with the max_frame_rate (in frames per 1000 bits)
* - To represent all kinds of frame rates
* 2) Decide the vop_time_incr based on the source frame rate
* - The decoder would like to know which source frame is encoded i.e. the source time
* id of the target frame encoded and there by adjusting its time of delay
* 3) vop_time increments every source frame and whenever a frame is encoded (target frame),
* the encoder queries the vop time of the source frame and sends it in the bit stream.
* 4) Since the Source frame skip logic is taken care by the frame_time module, whenever the
* encoder queries the time stamp module (which gets updated outside the encoder) the
* time stamp module would have the source time
*/
typedef struct time_stamp_t
{
/*vop_time_incr_res is a integer that indicates
the number of evenly spaced subintervals, called ticks,
within one modulo time. */
UWORD32 u4_vop_time_incr_res;
/* number of bits to represent vop_time_incr_res */
UWORD32 u4_vop_time_incr_range;
/* The number of ticks elapsed between two source vops */
UWORD32 u4_vop_time_incr;
/* incremented by vop_time_incr for every source frame.
Represents the time offset after a modulo_time_base = 1 is sent
in bit stream*/
UWORD32 u4_vop_time;
/* A temporary buffer to copy of vop time and modulo time base
is stored since update is called before query (get time stamp) and
so these extra variables cur_tgt_vop_time, */
UWORD32 u4_cur_tgt_vop_time;
UWORD32 u4_prev_tgt_vop_time;
/* This variable is set to 1 if we scale max frame rate by a factor of 2.
For mpeg4 standard, we just have 16bits and we can't accommodate more than 60000 as frame rate.
So we scale it and work with it */
WORD32 is_max_frame_rate_scaled;
} time_stamp_t;
typedef struct time_stamp_t *time_stamp_handle;
/*****************************************************************************/
/* Function declarations */
/*****************************************************************************/
void ih264e_init_frame_time(frame_time_t *ps_frame_time,
UWORD32 u4_src_frm_rate,
UWORD32 u4_tgt_frm_rate);
UWORD8 ih264e_should_src_be_skipped(frame_time_t *ps_frame_time,
UWORD32 u4_delta_time_stamp,
UWORD32 *pu4_frm_not_skipped_for_dts);
void ih264e_init_time_stamp(time_stamp_handle time_stamp,
UWORD32 max_frm_rate,
UWORD32 src_frm_rate);
void ih264e_update_time_stamp(time_stamp_handle time_stamp);
WORD32 ih264e_frame_time_get_init_free_memtab(frame_time_handle *pps_frame_time,
itt_memtab_t *ps_memtab,
ITT_FUNC_TYPE_E e_func_type);
WORD32 ih264e_time_stamp_get_init_free_memtab(time_stamp_handle *pps_time_stamp,
itt_memtab_t *ps_memtab,
ITT_FUNC_TYPE_E e_func_type);
WORD32 ih264e_frame_time_get_src_frame_rate(frame_time_t *ps_frame_time);
WORD32 ih264e_frame_time_get_tgt_frame_rate(frame_time_t *ps_frame_time);
WORD32 ih264e_frame_time_get_src_ticks(frame_time_t *ps_frame_time);
WORD32 ih264e_frame_time_get_tgt_ticks(frame_time_t *ps_frame_time);
WORD32 ih264e_frame_time_get_src_time(frame_time_t *frame_time);
WORD32 ih264e_frame_time_get_tgt_time(frame_time_t *frame_time);
void ih264e_frame_time_update_src_frame_rate(frame_time_t *ps_frame_time,
WORD32 src_frm_rate);
void ih264e_frame_time_update_tgt_frame_rate(frame_time_t *ps_frame_time,
WORD32 tgt_frm_rate);
void ih264_time_stamp_update_frame_rate(time_stamp_t *ps_time_stamp,
UWORD32 src_frm_rate);
#endif /*_IH264E_TIME_STAMP_H_ */
|
