OLD | NEW |
1 /* | 1 /* |
2 * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved. | 2 * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved. |
3 * | 3 * |
4 * Use of this source code is governed by a BSD-style license | 4 * Use of this source code is governed by a BSD-style license |
5 * that can be found in the LICENSE file in the root of the source | 5 * that can be found in the LICENSE file in the root of the source |
6 * tree. An additional intellectual property rights grant can be found | 6 * tree. An additional intellectual property rights grant can be found |
7 * in the file PATENTS. All contributing project authors may | 7 * in the file PATENTS. All contributing project authors may |
8 * be found in the AUTHORS file in the root of the source tree. | 8 * be found in the AUTHORS file in the root of the source tree. |
9 */ | 9 */ |
10 | 10 |
11 #ifndef WEBRTC_MODULES_AUDIO_CODING_NETEQ_PACKET_BUFFER_H_ | 11 #ifndef WEBRTC_MODULES_AUDIO_CODING_NETEQ_PACKET_BUFFER_H_ |
12 #define WEBRTC_MODULES_AUDIO_CODING_NETEQ_PACKET_BUFFER_H_ | 12 #define WEBRTC_MODULES_AUDIO_CODING_NETEQ_PACKET_BUFFER_H_ |
13 | 13 |
14 #include "webrtc/base/constructormagic.h" | 14 #include "webrtc/base/constructormagic.h" |
15 #include "webrtc/modules/audio_coding/neteq/packet.h" | 15 #include "webrtc/modules/audio_coding/neteq/packet.h" |
16 #include "webrtc/typedefs.h" | 16 #include "webrtc/typedefs.h" |
17 | 17 |
18 namespace webrtc { | 18 namespace webrtc { |
19 | 19 |
20 // Forward declaration. | 20 // Forward declarations. |
21 class DecoderDatabase; | 21 class DecoderDatabase; |
| 22 class TickTimer; |
22 | 23 |
23 // This is the actual buffer holding the packets before decoding. | 24 // This is the actual buffer holding the packets before decoding. |
24 class PacketBuffer { | 25 class PacketBuffer { |
25 public: | 26 public: |
26 enum BufferReturnCodes { | 27 enum BufferReturnCodes { |
27 kOK = 0, | 28 kOK = 0, |
28 kFlushed, | 29 kFlushed, |
29 kNotFound, | 30 kNotFound, |
30 kBufferEmpty, | 31 kBufferEmpty, |
31 kInvalidPacket, | 32 kInvalidPacket, |
32 kInvalidPointer | 33 kInvalidPointer |
33 }; | 34 }; |
34 | 35 |
35 // Constructor creates a buffer which can hold a maximum of | 36 // Constructor creates a buffer which can hold a maximum of |
36 // |max_number_of_packets| packets. | 37 // |max_number_of_packets| packets. |
37 PacketBuffer(size_t max_number_of_packets); | 38 PacketBuffer(size_t max_number_of_packets, const TickTimer& tick_timer); |
38 | 39 |
39 // Deletes all packets in the buffer before destroying the buffer. | 40 // Deletes all packets in the buffer before destroying the buffer. |
40 virtual ~PacketBuffer(); | 41 virtual ~PacketBuffer(); |
41 | 42 |
42 // Flushes the buffer and deletes all packets in it. | 43 // Flushes the buffer and deletes all packets in it. |
43 virtual void Flush(); | 44 virtual void Flush(); |
44 | 45 |
45 // Returns true for an empty buffer. | 46 // Returns true for an empty buffer. |
46 virtual bool Empty() const; | 47 virtual bool Empty() const; |
47 | 48 |
(...skipping 61 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
109 | 110 |
110 // Returns the number of packets in the buffer, including duplicates and | 111 // Returns the number of packets in the buffer, including duplicates and |
111 // redundant packets. | 112 // redundant packets. |
112 virtual size_t NumPacketsInBuffer() const; | 113 virtual size_t NumPacketsInBuffer() const; |
113 | 114 |
114 // Returns the number of samples in the buffer, including samples carried in | 115 // Returns the number of samples in the buffer, including samples carried in |
115 // duplicate and redundant packets. | 116 // duplicate and redundant packets. |
116 virtual size_t NumSamplesInBuffer(DecoderDatabase* decoder_database, | 117 virtual size_t NumSamplesInBuffer(DecoderDatabase* decoder_database, |
117 size_t last_decoded_length) const; | 118 size_t last_decoded_length) const; |
118 | 119 |
119 // Increase the waiting time counter for every packet in the buffer by |inc|. | |
120 // The default value for |inc| is 1. | |
121 virtual void IncrementWaitingTimes(int inc = 1); | |
122 | |
123 virtual void BufferStat(int* num_packets, int* max_num_packets) const; | 120 virtual void BufferStat(int* num_packets, int* max_num_packets) const; |
124 | 121 |
125 // Static method that properly deletes the first packet, and its payload | 122 // Static method that properly deletes the first packet, and its payload |
126 // array, in |packet_list|. Returns false if |packet_list| already was empty, | 123 // array, in |packet_list|. Returns false if |packet_list| already was empty, |
127 // otherwise true. | 124 // otherwise true. |
128 static bool DeleteFirstPacket(PacketList* packet_list); | 125 static bool DeleteFirstPacket(PacketList* packet_list); |
129 | 126 |
130 // Static method that properly deletes all packets, and their payload arrays, | 127 // Static method that properly deletes all packets, and their payload arrays, |
131 // in |packet_list|. | 128 // in |packet_list|. |
132 static void DeleteAllPackets(PacketList* packet_list); | 129 static void DeleteAllPackets(PacketList* packet_list); |
133 | 130 |
134 // Static method returning true if |timestamp| is older than |timestamp_limit| | 131 // Static method returning true if |timestamp| is older than |timestamp_limit| |
135 // but less than |horizon_samples| behind |timestamp_limit|. For instance, | 132 // but less than |horizon_samples| behind |timestamp_limit|. For instance, |
136 // with timestamp_limit = 100 and horizon_samples = 10, a timestamp in the | 133 // with timestamp_limit = 100 and horizon_samples = 10, a timestamp in the |
137 // range (90, 100) is considered obsolete, and will yield true. | 134 // range (90, 100) is considered obsolete, and will yield true. |
138 // Setting |horizon_samples| to 0 is the same as setting it to 2^31, i.e., | 135 // Setting |horizon_samples| to 0 is the same as setting it to 2^31, i.e., |
139 // half the 32-bit timestamp range. | 136 // half the 32-bit timestamp range. |
140 static bool IsObsoleteTimestamp(uint32_t timestamp, | 137 static bool IsObsoleteTimestamp(uint32_t timestamp, |
141 uint32_t timestamp_limit, | 138 uint32_t timestamp_limit, |
142 uint32_t horizon_samples) { | 139 uint32_t horizon_samples) { |
143 return IsNewerTimestamp(timestamp_limit, timestamp) && | 140 return IsNewerTimestamp(timestamp_limit, timestamp) && |
144 (horizon_samples == 0 || | 141 (horizon_samples == 0 || |
145 IsNewerTimestamp(timestamp, timestamp_limit - horizon_samples)); | 142 IsNewerTimestamp(timestamp, timestamp_limit - horizon_samples)); |
146 } | 143 } |
147 | 144 |
148 private: | 145 private: |
149 size_t max_number_of_packets_; | 146 size_t max_number_of_packets_; |
150 PacketList buffer_; | 147 PacketList buffer_; |
| 148 const TickTimer& tick_timer_; |
151 RTC_DISALLOW_COPY_AND_ASSIGN(PacketBuffer); | 149 RTC_DISALLOW_COPY_AND_ASSIGN(PacketBuffer); |
152 }; | 150 }; |
153 | 151 |
154 } // namespace webrtc | 152 } // namespace webrtc |
155 #endif // WEBRTC_MODULES_AUDIO_CODING_NETEQ_PACKET_BUFFER_H_ | 153 #endif // WEBRTC_MODULES_AUDIO_CODING_NETEQ_PACKET_BUFFER_H_ |
OLD | NEW |