OLD | NEW |
1 /* Copyright (c) 2011 The WebRTC project authors. All Rights Reserved. | 1 /* Copyright (c) 2011 The WebRTC project authors. All Rights Reserved. |
2 * | 2 * |
3 * Use of this source code is governed by a BSD-style license | 3 * Use of this source code is governed by a BSD-style license |
4 * that can be found in the LICENSE file in the root of the source | 4 * that can be found in the LICENSE file in the root of the source |
5 * tree. An additional intellectual property rights grant can be found | 5 * tree. An additional intellectual property rights grant can be found |
6 * in the file PATENTS. All contributing project authors may | 6 * in the file PATENTS. All contributing project authors may |
7 * be found in the AUTHORS file in the root of the source tree. | 7 * be found in the AUTHORS file in the root of the source tree. |
8 */ | 8 */ |
9 /* | 9 /* |
10 * This file defines the interface for doing temporal layers with VP8. | 10 * This file defines the interface for doing temporal layers with VP8. |
11 */ | 11 */ |
12 #ifndef WEBRTC_MODULES_VIDEO_CODING_CODECS_VP8_TEMPORAL_LAYERS_H_ | 12 #ifndef WEBRTC_MODULES_VIDEO_CODING_CODECS_VP8_TEMPORAL_LAYERS_H_ |
13 #define WEBRTC_MODULES_VIDEO_CODING_CODECS_VP8_TEMPORAL_LAYERS_H_ | 13 #define WEBRTC_MODULES_VIDEO_CODING_CODECS_VP8_TEMPORAL_LAYERS_H_ |
14 | 14 |
15 #include <vector> | 15 #include "vpx/vpx_encoder.h" |
16 | 16 |
17 #include "webrtc/common_video/include/video_image.h" | 17 #include "webrtc/common_video/include/video_image.h" |
18 #include "webrtc/typedefs.h" | 18 #include "webrtc/typedefs.h" |
19 | 19 |
20 struct vpx_codec_enc_cfg; | |
21 typedef struct vpx_codec_enc_cfg vpx_codec_enc_cfg_t; | |
22 | |
23 namespace webrtc { | 20 namespace webrtc { |
24 | 21 |
25 struct CodecSpecificInfoVP8; | 22 struct CodecSpecificInfoVP8; |
26 | 23 |
27 class TemporalLayers { | 24 class TemporalLayers { |
28 public: | 25 public: |
29 // Factory for TemporalLayer strategy. Default behavior is a fixed pattern | 26 // Factory for TemporalLayer strategy. Default behaviour is a fixed pattern |
30 // of temporal layers. See default_temporal_layers.cc | 27 // of temporal layers. See default_temporal_layers.cc |
31 virtual ~TemporalLayers() {} | 28 virtual ~TemporalLayers() {} |
32 | 29 |
33 // Returns the recommended VP8 encode flags needed. May refresh the decoder | 30 // Returns the recommended VP8 encode flags needed. May refresh the decoder |
34 // and/or update the reference buffers. | 31 // and/or update the reference buffers. |
35 virtual int EncodeFlags(uint32_t timestamp) = 0; | 32 virtual int EncodeFlags(uint32_t timestamp) = 0; |
36 | 33 |
37 // Update state based on new bitrate target and incoming framerate. | 34 virtual bool ConfigureBitrates(int bitrate_kbit, |
38 // Returns the bitrate allocation for the active temporal layers. | 35 int max_bitrate_kbit, |
39 virtual std::vector<uint32_t> OnRatesUpdated(int bitrate_kbps, | 36 int framerate, |
40 int max_bitrate_kbps, | 37 vpx_codec_enc_cfg_t* cfg) = 0; |
41 int framerate) = 0; | |
42 | |
43 // Update the encoder configuration with target bitrates or other parameters. | |
44 // Returns true iff the configuration was actually modified. | |
45 virtual bool UpdateConfiguration(vpx_codec_enc_cfg_t* cfg) = 0; | |
46 | 38 |
47 virtual void PopulateCodecSpecific(bool base_layer_sync, | 39 virtual void PopulateCodecSpecific(bool base_layer_sync, |
48 CodecSpecificInfoVP8* vp8_info, | 40 CodecSpecificInfoVP8* vp8_info, |
49 uint32_t timestamp) = 0; | 41 uint32_t timestamp) = 0; |
50 | 42 |
51 virtual void FrameEncoded(unsigned int size, uint32_t timestamp, int qp) = 0; | 43 virtual void FrameEncoded(unsigned int size, uint32_t timestamp, int qp) = 0; |
52 | 44 |
53 virtual int CurrentLayerId() const = 0; | 45 virtual int CurrentLayerId() const = 0; |
| 46 |
| 47 virtual bool UpdateConfiguration(vpx_codec_enc_cfg_t* cfg) = 0; |
54 }; | 48 }; |
55 | 49 |
56 class TemporalLayersListener; | |
57 class TemporalLayersFactory { | 50 class TemporalLayersFactory { |
58 public: | 51 public: |
59 TemporalLayersFactory() : listener_(nullptr) {} | |
60 virtual ~TemporalLayersFactory() {} | 52 virtual ~TemporalLayersFactory() {} |
61 virtual TemporalLayers* Create(int simulcast_id, | 53 virtual TemporalLayers* Create(int temporal_layers, |
62 int temporal_layers, | |
63 uint8_t initial_tl0_pic_idx) const; | 54 uint8_t initial_tl0_pic_idx) const; |
64 void SetListener(TemporalLayersListener* listener); | |
65 | |
66 protected: | |
67 TemporalLayersListener* listener_; | |
68 }; | 55 }; |
69 | 56 |
70 // Factory for a temporal layers strategy that adaptively changes the number of | 57 // Factory for a temporal layers strategy that adaptively changes the number of |
71 // layers based on input frame rate so that the base layer has an acceptable | 58 // layers based on input framerate so that the base layer has an acceptable |
72 // frame rate. See realtime_temporal_layers.cc | 59 // framerate. See realtime_temporal_layers.cc |
73 class RealTimeTemporalLayersFactory : public TemporalLayersFactory { | 60 class RealTimeTemporalLayersFactory : public TemporalLayersFactory { |
74 public: | 61 public: |
75 RealTimeTemporalLayersFactory() {} | |
76 ~RealTimeTemporalLayersFactory() override {} | 62 ~RealTimeTemporalLayersFactory() override {} |
77 TemporalLayers* Create(int simulcast_id, | 63 TemporalLayers* Create(int num_temporal_layers, |
78 int num_temporal_layers, | |
79 uint8_t initial_tl0_pic_idx) const override; | 64 uint8_t initial_tl0_pic_idx) const override; |
80 }; | 65 }; |
81 | 66 |
82 class TemporalLayersListener { | |
83 public: | |
84 TemporalLayersListener() {} | |
85 virtual ~TemporalLayersListener() {} | |
86 | |
87 virtual void OnTemporalLayersCreated(int simulcast_id, | |
88 TemporalLayers* layers) = 0; | |
89 }; | |
90 | |
91 } // namespace webrtc | 67 } // namespace webrtc |
92 #endif // WEBRTC_MODULES_VIDEO_CODING_CODECS_VP8_TEMPORAL_LAYERS_H_ | 68 #endif // WEBRTC_MODULES_VIDEO_CODING_CODECS_VP8_TEMPORAL_LAYERS_H_ |
OLD | NEW |