| /* |
| * Copyright (c) 2021 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 VIDEO_FRAME_CADENCE_ADAPTER_H_ |
| #define VIDEO_FRAME_CADENCE_ADAPTER_H_ |
| |
| #include <memory> |
| |
| #include "api/task_queue/task_queue_base.h" |
| #include "api/video/video_frame.h" |
| #include "api/video/video_sink_interface.h" |
| #include "rtc_base/synchronization/mutex.h" |
| #include "rtc_base/thread_annotations.h" |
| #include "system_wrappers/include/clock.h" |
| |
| namespace webrtc { |
| |
| // A sink adapter implementing mutations to the received frame cadence. |
| // With the exception of the constructor and the methods overridden in |
| // VideoSinkInterface, the rest of the interface to this class (including dtor) |
| // needs to happen on the queue passed in Create. |
| class FrameCadenceAdapterInterface |
| : public rtc::VideoSinkInterface<VideoFrame> { |
| public: |
| // Callback interface used to inform instance owners. |
| class Callback { |
| public: |
| virtual ~Callback() = default; |
| |
| // Called when a frame arrives on the |queue| specified in Create. |
| // |
| // The |post_time| parameter indicates the current time sampled when |
| // FrameCadenceAdapterInterface::OnFrame was called. |
| // |
| // |frames_scheduled_for_processing| indicates how many frames that have |
| // been scheduled for processing. During sequential conditions where |
| // FrameCadenceAdapterInterface::OnFrame is invoked and subsequently ending |
| // up in this callback, this value will read 1. Otherwise if the |
| // |queue| gets stalled for some reason, the value will increase |
| // beyond 1. |
| virtual void OnFrame(Timestamp post_time, |
| int frames_scheduled_for_processing, |
| const VideoFrame& frame) = 0; |
| |
| // Called when the source has discarded a frame. |
| virtual void OnDiscardedFrame() = 0; |
| }; |
| |
| // Factory function creating a production instance. Deletion of the returned |
| // instance needs to happen on the same sequence that Create() was called on. |
| // Frames arriving in FrameCadenceAdapterInterface::OnFrame are posted to |
| // Callback::OnFrame on the |queue|. |
| static std::unique_ptr<FrameCadenceAdapterInterface> Create( |
| Clock* clock, |
| TaskQueueBase* queue); |
| |
| // Call before using the rest of the API. |
| virtual void Initialize(Callback* callback) = 0; |
| |
| // Pass true in |enabled| as a prerequisite to enable zero-hertz operation. |
| virtual void SetZeroHertzModeEnabled(bool enabled) = 0; |
| }; |
| |
| } // namespace webrtc |
| |
| #endif // VIDEO_FRAME_CADENCE_ADAPTER_H_ |