webrtc/rtc_base/frequency_tracker.h
Florent Castelli 8037fc6ffa Migrate absl::optional to std::optional
Bug: webrtc:342905193
No-Try: True
Change-Id: Icc968be43b8830038ea9a1f5f604307220457807
Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/361021
Auto-Submit: Florent Castelli <orphis@webrtc.org>
Reviewed-by: Harald Alvestrand <hta@webrtc.org>
Commit-Queue: Florent Castelli <orphis@webrtc.org>
Cr-Commit-Position: refs/heads/main@{#42911}
2024-09-02 12:16:47 +00:00

57 lines
1.8 KiB
C++

/*
* Copyright (c) 2023 The WebRTC project authors. All Rights Reserved.
*
* Use of this source code is governed by a BSD-style license
* that can be found in the LICENSE file in the root of the source
* tree. An additional intellectual property rights grant can be found
* in the file PATENTS. All contributing project authors may
* be found in the AUTHORS file in the root of the source tree.
*/
#ifndef RTC_BASE_FREQUENCY_TRACKER_H_
#define RTC_BASE_FREQUENCY_TRACKER_H_
#include <stddef.h>
#include <stdint.h>
#include <optional>
#include "api/units/frequency.h"
#include "api/units/time_delta.h"
#include "api/units/timestamp.h"
#include "rtc_base/rate_statistics.h"
#include "rtc_base/system/rtc_export.h"
namespace webrtc {
// Class to estimate frequency (e.g. frame rate) over running window.
// Timestamps used in Update() and Rate() must never decrease for two
// consecutive calls.
// This class is thread unsafe.
class RTC_EXPORT FrequencyTracker {
public:
explicit FrequencyTracker(TimeDelta window_size);
FrequencyTracker(const FrequencyTracker&) = default;
FrequencyTracker(FrequencyTracker&&) = default;
FrequencyTracker& operator=(const FrequencyTracker&) = delete;
FrequencyTracker& operator=(FrequencyTracker&&) = delete;
~FrequencyTracker() = default;
// Reset instance to original state.
void Reset() { impl_.Reset(); }
// Update rate with a new data point, moving averaging window as needed.
void Update(int64_t count, Timestamp now);
void Update(Timestamp now) { Update(1, now); }
// Returns rate, moving averaging window as needed.
// Returns nullopt when rate can't be measured.
std::optional<Frequency> Rate(Timestamp now) const;
private:
RateStatistics impl_;
};
} // namespace webrtc
#endif // RTC_BASE_FREQUENCY_TRACKER_H_