87ab80a18ddae5cc6135140340b26812693b035a
[WebKit-https.git] / Source / WebCore / platform / mediastream / RealtimeVideoSource.h
1 /*
2  * Copyright (C) 2018 Apple Inc. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
17  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24  */
25
26 #pragma once
27
28 #if ENABLE(MEDIA_STREAM)
29
30 #include "FontCascade.h"
31 #include "ImageBuffer.h"
32 #include "MediaSample.h"
33 #include "RealtimeMediaSource.h"
34 #include "VideoPreset.h"
35 #include <wtf/Lock.h>
36 #include <wtf/RunLoop.h>
37
38 namespace WebCore {
39
40 class RealtimeVideoSource : public RealtimeMediaSource {
41 public:
42     virtual ~RealtimeVideoSource();
43
44 protected:
45     RealtimeVideoSource(const String& id, const String& name);
46
47     void prepareToProduceData();
48     bool supportsSizeAndFrameRate(std::optional<int> width, std::optional<int> height, std::optional<double>) override;
49     void setSizeAndFrameRate(std::optional<int> width, std::optional<int> height, std::optional<double>) override;
50
51     virtual void generatePresets() = 0;
52     virtual bool prefersPreset(VideoPreset&) { return true; }
53     virtual void setSizeAndFrameRateWithPreset(IntSize, double, RefPtr<VideoPreset>) { };
54     virtual bool canResizeVideoFrames() const { return false; }
55     bool shouldUsePreset(VideoPreset& current, VideoPreset& candidate);
56
57     void setSupportedPresets(const Vector<Ref<VideoPreset>>&);
58     void setSupportedPresets(Vector<VideoPresetData>&&);
59     const Vector<Ref<VideoPreset>>& presets();
60
61     bool frameRateRangeIncludesRate(const FrameRateRange&, double);
62
63     void updateCapabilities(RealtimeMediaSourceCapabilities&);
64
65     void setDefaultSize(const IntSize& size) { m_defaultSize = size; }
66
67     double observedFrameRate() const { return m_observedFrameRate; }
68
69     void dispatchMediaSampleToObservers(MediaSample&);
70
71 private:
72     struct CaptureSizeAndFrameRate {
73         RefPtr<VideoPreset> encodingPreset;
74         IntSize requestedSize;
75         double requestedFrameRate { 0 };
76     };
77     bool supportsCaptureSize(std::optional<int>, std::optional<int>, const Function<bool(const IntSize&)>&&);
78     std::optional<CaptureSizeAndFrameRate> bestSupportedSizeAndFrameRate(std::optional<int> width, std::optional<int> height, std::optional<double>);
79     bool presetSupportsFrameRate(RefPtr<VideoPreset>, double);
80
81     Vector<Ref<VideoPreset>> m_presets;
82     Deque<double> m_observedFrameTimeStamps;
83     double m_observedFrameRate { 0 };
84     IntSize m_defaultSize;
85 };
86
87 } // namespace WebCore
88
89 #endif // ENABLE(MEDIA_STREAM)
90