OLD | NEW |
1 // Copyright (c) 2015 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2015 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef MEDIA_CAPTURE_SMOOTH_EVENT_SAMPLER_H_ | 5 #ifndef MEDIA_CAPTURE_SMOOTH_EVENT_SAMPLER_H_ |
6 #define MEDIA_CAPTURE_SMOOTH_EVENT_SAMPLER_H_ | 6 #define MEDIA_CAPTURE_SMOOTH_EVENT_SAMPLER_H_ |
7 | 7 |
8 #include "base/macros.h" | 8 #include "base/macros.h" |
9 #include "base/time/time.h" | 9 #include "base/time/time.h" |
10 #include "media/base/media_export.h" | 10 #include "media/base/media_export.h" |
11 | 11 |
12 namespace media { | 12 namespace media { |
13 | 13 |
14 // Filters a sequence of events to achieve a target frequency. | 14 // Filters a sequence of events to achieve a target frequency. |
15 class MEDIA_EXPORT SmoothEventSampler { | 15 class MEDIA_EXPORT SmoothEventSampler { |
16 public: | 16 public: |
17 explicit SmoothEventSampler(base::TimeDelta min_capture_period); | 17 enum { |
| 18 // The maximum amount of time that can elapse before considering unchanged |
| 19 // content as dirty for the purposes of timer-based overdue sampling. This |
| 20 // is the same value found in cc::FrameRateCounter. |
| 21 OVERDUE_DIRTY_THRESHOLD_MILLIS = 250 // 4 FPS |
| 22 }; |
| 23 |
| 24 SmoothEventSampler(base::TimeDelta min_capture_period, |
| 25 int redundant_capture_goal); |
18 | 26 |
19 // Get/Set minimum capture period. When setting a new value, the state of the | 27 // Get/Set minimum capture period. When setting a new value, the state of the |
20 // sampler is retained so that sampling will continue smoothly. | 28 // sampler is retained so that sampling will continue smoothly. |
21 base::TimeDelta min_capture_period() const { return min_capture_period_; } | 29 base::TimeDelta min_capture_period() const { return min_capture_period_; } |
22 void SetMinCapturePeriod(base::TimeDelta p); | 30 void SetMinCapturePeriod(base::TimeDelta p); |
23 | 31 |
24 // Add a new event to the event history, and consider whether it ought to be | 32 // Add a new event to the event history, and consider whether it ought to be |
25 // sampled. The event is not recorded as a sample until RecordSample() is | 33 // sampled. The event is not recorded as a sample until RecordSample() is |
26 // called. | 34 // called. |
27 void ConsiderPresentationEvent(base::TimeTicks event_time); | 35 void ConsiderPresentationEvent(base::TimeTicks event_time); |
28 | 36 |
29 // Returns true if the last event considered should be sampled. | 37 // Returns true if the last event considered should be sampled. |
30 bool ShouldSample() const; | 38 bool ShouldSample() const; |
31 | 39 |
32 // Operates on the last event added by ConsiderPresentationEvent(), marking | 40 // Operates on the last event added by ConsiderPresentationEvent(), marking |
33 // it as sampled. After this point we are current in the stream of events, as | 41 // it as sampled. After this point we are current in the stream of events, as |
34 // we have sampled the most recent event. | 42 // we have sampled the most recent event. |
35 void RecordSample(); | 43 void RecordSample(); |
36 | 44 |
| 45 // Returns true if, at time |event_time|, sampling should occur because too |
| 46 // much time will have passed relative to the last event and/or sample. |
| 47 bool IsOverdueForSamplingAt(base::TimeTicks event_time) const; |
| 48 |
37 // Returns true if ConsiderPresentationEvent() has been called since the last | 49 // Returns true if ConsiderPresentationEvent() has been called since the last |
38 // call to RecordSample(). | 50 // call to RecordSample(). |
39 bool HasUnrecordedEvent() const; | 51 bool HasUnrecordedEvent() const; |
40 | 52 |
41 private: | 53 private: |
42 base::TimeDelta min_capture_period_; | 54 base::TimeDelta min_capture_period_; |
| 55 const int redundant_capture_goal_; |
43 base::TimeDelta token_bucket_capacity_; | 56 base::TimeDelta token_bucket_capacity_; |
44 | 57 |
45 base::TimeTicks current_event_; | 58 base::TimeTicks current_event_; |
46 base::TimeTicks last_sample_; | 59 base::TimeTicks last_sample_; |
| 60 int overdue_sample_count_; |
47 base::TimeDelta token_bucket_; | 61 base::TimeDelta token_bucket_; |
48 | 62 |
49 DISALLOW_COPY_AND_ASSIGN(SmoothEventSampler); | 63 DISALLOW_COPY_AND_ASSIGN(SmoothEventSampler); |
50 }; | 64 }; |
51 | 65 |
52 } // namespace media | 66 } // namespace media |
53 | 67 |
54 #endif // MEDIA_CAPTURE_SMOOTH_EVENT_SAMPLER_H_ | 68 #endif // MEDIA_CAPTURE_SMOOTH_EVENT_SAMPLER_H_ |
OLD | NEW |