blob: 9f46ade344cf32661e8eda1f0cf16358359a6d09 [file] [log] [blame]
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001/*
2 * Copyright (c) 2014 The WebRTC project authors. All Rights Reserved.
3 *
4 * Use of this source code is governed by a BSD-style license
5 * that can be found in the LICENSE file in the root of the source
6 * tree. An additional intellectual property rights grant can be found
7 * in the file PATENTS. All contributing project authors may
8 * be found in the AUTHORS file in the root of the source tree.
9 *
10 */
11
Mirko Bonadei95adedb2018-11-19 09:52:37 +010012#ifdef RTC_ENABLE_VP9
13
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020014#include "modules/video_coding/codecs/vp9/vp9_impl.h"
marpan@webrtc.org5b883172014-11-01 06:10:48 +000015
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +020016#include <algorithm>
Sergey Silkind45b3452018-05-31 16:00:24 +020017#include <limits>
marpan@webrtc.org5b883172014-11-01 06:10:48 +000018#include <vector>
19
Karl Wiberg918f50c2018-07-05 11:40:33 +020020#include "absl/memory/memory.h"
Emircan Uysaler800787f2018-07-16 10:01:49 -070021#include "api/video/color_space.h"
Emircan Uysaler0823eec2018-07-13 17:10:00 -070022#include "api/video/i010_buffer.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020023#include "common_video/include/video_frame_buffer.h"
24#include "common_video/libyuv/include/webrtc_libyuv.h"
Sergey Silkind902d582018-05-18 17:31:19 +020025#include "modules/rtp_rtcp/include/rtp_rtcp_defines.h"
Sergey Silkin86684962018-03-28 19:32:37 +020026#include "modules/video_coding/codecs/vp9/svc_rate_allocator.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020027#include "rtc_base/checks.h"
Erik Språng4b4266f2019-01-23 12:48:13 +010028#include "rtc_base/experiments/rate_control_settings.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020029#include "rtc_base/keep_ref_until_done.h"
30#include "rtc_base/logging.h"
Steve Anton10542f22019-01-11 09:11:00 -080031#include "rtc_base/time_utils.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020032#include "rtc_base/trace_event.h"
Sergey Silkin390f3582018-10-01 17:13:50 +020033#include "system_wrappers/include/field_trial.h"
Jonas Olssona4d87372019-07-05 19:08:33 +020034#include "vpx/vp8cx.h"
35#include "vpx/vp8dx.h"
36#include "vpx/vpx_decoder.h"
37#include "vpx/vpx_encoder.h"
marpan@webrtc.org5b883172014-11-01 06:10:48 +000038
39namespace webrtc {
40
Sergey Silkind902d582018-05-18 17:31:19 +020041namespace {
Sergey Silkin390f3582018-10-01 17:13:50 +020042// Maps from gof_idx to encoder internal reference frame buffer index. These
43// maps work for 1,2 and 3 temporal layers with GOF length of 1,2 and 4 frames.
44uint8_t kRefBufIdx[4] = {0, 0, 0, 1};
45uint8_t kUpdBufIdx[4] = {0, 0, 1, 0};
46
Sergey Silkinb674cd12018-10-09 10:59:06 +020047int kMaxNumTiles4kVideo = 8;
48
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +010049// Maximum allowed PID difference for differnet per-layer frame-rate case.
Ilya Nikolaevskiy3a656d12019-02-14 14:44:22 +010050const int kMaxAllowedPidDIff = 30;
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +010051
Erik Språng7a3fe892019-04-15 12:22:55 +020052constexpr double kLowRateFactor = 1.0;
53constexpr double kHighRateFactor = 2.0;
54
55// These settings correspond to the settings in vpx_codec_enc_cfg.
Erik Språngeb180f82019-05-23 13:55:24 +020056struct Vp9RateSettings {
Erik Språng7a3fe892019-04-15 12:22:55 +020057 uint32_t rc_undershoot_pct;
58 uint32_t rc_overshoot_pct;
59 uint32_t rc_buf_sz;
60 uint32_t rc_buf_optimal_sz;
61 uint32_t rc_dropframe_thresh;
62};
63
Marco6e89b252015-07-07 14:40:38 -070064// Only positive speeds, range for real-time coding currently is: 5 - 8.
65// Lower means slower/better quality, higher means fastest/lower quality.
66int GetCpuSpeed(int width, int height) {
Alex Glaznevfecb7c32016-03-31 14:23:27 -070067#if defined(WEBRTC_ARCH_ARM) || defined(WEBRTC_ARCH_ARM64) || defined(ANDROID)
Marco002f0d02015-12-17 09:49:31 -080068 return 8;
69#else
Marco6e89b252015-07-07 14:40:38 -070070 // For smaller resolutions, use lower speed setting (get some coding gain at
71 // the cost of increased encoding complexity).
72 if (width * height <= 352 * 288)
73 return 5;
74 else
75 return 7;
Marco002f0d02015-12-17 09:49:31 -080076#endif
Marco6e89b252015-07-07 14:40:38 -070077}
Emircan Uysaler715cc232018-07-23 17:50:43 -070078// Helper class for extracting VP9 colorspace.
79ColorSpace ExtractVP9ColorSpace(vpx_color_space_t space_t,
80 vpx_color_range_t range_t,
81 unsigned int bit_depth) {
Johannes Kronb47ccc32018-12-07 11:12:44 +010082 ColorSpace::PrimaryID primaries = ColorSpace::PrimaryID::kUnspecified;
83 ColorSpace::TransferID transfer = ColorSpace::TransferID::kUnspecified;
84 ColorSpace::MatrixID matrix = ColorSpace::MatrixID::kUnspecified;
Emircan Uysaler715cc232018-07-23 17:50:43 -070085 switch (space_t) {
86 case VPX_CS_BT_601:
87 case VPX_CS_SMPTE_170:
88 primaries = ColorSpace::PrimaryID::kSMPTE170M;
89 transfer = ColorSpace::TransferID::kSMPTE170M;
90 matrix = ColorSpace::MatrixID::kSMPTE170M;
91 break;
92 case VPX_CS_SMPTE_240:
93 primaries = ColorSpace::PrimaryID::kSMPTE240M;
94 transfer = ColorSpace::TransferID::kSMPTE240M;
95 matrix = ColorSpace::MatrixID::kSMPTE240M;
96 break;
97 case VPX_CS_BT_709:
98 primaries = ColorSpace::PrimaryID::kBT709;
99 transfer = ColorSpace::TransferID::kBT709;
100 matrix = ColorSpace::MatrixID::kBT709;
101 break;
102 case VPX_CS_BT_2020:
103 primaries = ColorSpace::PrimaryID::kBT2020;
104 switch (bit_depth) {
105 case 8:
106 transfer = ColorSpace::TransferID::kBT709;
107 break;
108 case 10:
109 transfer = ColorSpace::TransferID::kBT2020_10;
110 break;
111 default:
112 RTC_NOTREACHED();
113 break;
114 }
115 matrix = ColorSpace::MatrixID::kBT2020_NCL;
116 break;
117 case VPX_CS_SRGB:
118 primaries = ColorSpace::PrimaryID::kBT709;
119 transfer = ColorSpace::TransferID::kIEC61966_2_1;
120 matrix = ColorSpace::MatrixID::kBT709;
121 break;
122 default:
123 break;
124 }
125
126 ColorSpace::RangeID range = ColorSpace::RangeID::kInvalid;
127 switch (range_t) {
128 case VPX_CR_STUDIO_RANGE:
129 range = ColorSpace::RangeID::kLimited;
130 break;
131 case VPX_CR_FULL_RANGE:
132 range = ColorSpace::RangeID::kFull;
133 break;
134 default:
135 break;
136 }
137 return ColorSpace(primaries, transfer, matrix, range);
138}
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100139
140bool MoreLayersEnabled(const VideoBitrateAllocation& first,
141 const VideoBitrateAllocation& second) {
142 for (size_t sl_idx = 0; sl_idx < kMaxSpatialLayers; ++sl_idx) {
143 if (first.GetSpatialLayerSum(sl_idx) > 0 &&
144 second.GetSpatialLayerSum(sl_idx) == 0) {
145 return true;
146 }
147 }
148 return false;
149}
150
Erik Språng7a3fe892019-04-15 12:22:55 +0200151uint32_t Interpolate(uint32_t low,
152 uint32_t high,
153 double bandwidth_headroom_factor) {
154 RTC_DCHECK_GE(bandwidth_headroom_factor, kLowRateFactor);
155 RTC_DCHECK_LE(bandwidth_headroom_factor, kHighRateFactor);
156
157 // |factor| is between 0.0 and 1.0.
158 const double factor = bandwidth_headroom_factor - kLowRateFactor;
159
160 return static_cast<uint32_t>(((1.0 - factor) * low) + (factor * high) + 0.5);
161}
162
Erik Språngeb180f82019-05-23 13:55:24 +0200163Vp9RateSettings GetRateSettings(double bandwidth_headroom_factor) {
164 static const Vp9RateSettings low_settings{100u, 0u, 100u, 33u, 40u};
165 static const Vp9RateSettings high_settings{50u, 50u, 1000u, 700u, 5u};
Erik Språng7a3fe892019-04-15 12:22:55 +0200166
167 if (bandwidth_headroom_factor <= kLowRateFactor) {
168 return low_settings;
169 } else if (bandwidth_headroom_factor >= kHighRateFactor) {
170 return high_settings;
171 }
172
Erik Språngeb180f82019-05-23 13:55:24 +0200173 Vp9RateSettings settings;
Erik Språng7a3fe892019-04-15 12:22:55 +0200174 settings.rc_undershoot_pct =
175 Interpolate(low_settings.rc_undershoot_pct,
176 high_settings.rc_undershoot_pct, bandwidth_headroom_factor);
177 settings.rc_overshoot_pct =
178 Interpolate(low_settings.rc_overshoot_pct, high_settings.rc_overshoot_pct,
179 bandwidth_headroom_factor);
180 settings.rc_buf_sz =
181 Interpolate(low_settings.rc_buf_sz, high_settings.rc_buf_sz,
182 bandwidth_headroom_factor);
183 settings.rc_buf_optimal_sz =
184 Interpolate(low_settings.rc_buf_optimal_sz,
185 high_settings.rc_buf_optimal_sz, bandwidth_headroom_factor);
186 settings.rc_dropframe_thresh =
187 Interpolate(low_settings.rc_dropframe_thresh,
188 high_settings.rc_dropframe_thresh, bandwidth_headroom_factor);
189 return settings;
190}
191
192void UpdateRateSettings(vpx_codec_enc_cfg_t* config,
Erik Språngeb180f82019-05-23 13:55:24 +0200193 const Vp9RateSettings& new_settings) {
Erik Språng7a3fe892019-04-15 12:22:55 +0200194 config->rc_undershoot_pct = new_settings.rc_undershoot_pct;
195 config->rc_overshoot_pct = new_settings.rc_overshoot_pct;
196 config->rc_buf_sz = new_settings.rc_buf_sz;
197 config->rc_buf_optimal_sz = new_settings.rc_buf_optimal_sz;
198 config->rc_dropframe_thresh = new_settings.rc_dropframe_thresh;
199}
200
Emircan Uysaler715cc232018-07-23 17:50:43 -0700201} // namespace
Marco6e89b252015-07-07 14:40:38 -0700202
asaperssona9455ab2015-07-31 06:10:09 -0700203void VP9EncoderImpl::EncoderOutputCodedPacketCallback(vpx_codec_cx_pkt* pkt,
204 void* user_data) {
philipelcce46fc2015-12-21 03:04:49 -0800205 VP9EncoderImpl* enc = static_cast<VP9EncoderImpl*>(user_data);
asaperssona9455ab2015-07-31 06:10:09 -0700206 enc->GetEncodedLayerFrame(pkt);
207}
208
Emircan Uysaler98badbc2018-06-28 10:59:02 -0700209VP9EncoderImpl::VP9EncoderImpl(const cricket::VideoCodec& codec)
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000210 : encoded_image_(),
sprang3958ed82017-08-17 08:12:10 -0700211 encoded_complete_callback_(nullptr),
Emircan Uysaler98badbc2018-06-28 10:59:02 -0700212 profile_(
213 ParseSdpForVP9Profile(codec.params).value_or(VP9Profile::kProfile0)),
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000214 inited_(false),
215 timestamp_(0),
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000216 cpu_speed_(3),
217 rc_max_intra_target_(0),
sprang3958ed82017-08-17 08:12:10 -0700218 encoder_(nullptr),
219 config_(nullptr),
220 raw_(nullptr),
221 input_image_(nullptr),
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200222 force_key_frame_(true),
Sergey Silkin6a8f30e2018-04-26 11:03:49 +0200223 pics_since_key_(0),
asaperssona9455ab2015-07-31 06:10:09 -0700224 num_temporal_layers_(0),
philipelcfc319b2015-11-10 07:17:23 -0800225 num_spatial_layers_(0),
Sergey Silkin390f3582018-10-01 17:13:50 +0200226 num_active_spatial_layers_(0),
Erik Språngd3438aa2018-11-08 16:56:43 +0100227 layer_deactivation_requires_key_frame_(
228 field_trial::IsEnabled("WebRTC-Vp9IssueKeyFrameOnLayerDeactivation")),
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200229 is_svc_(false),
Sergey Silkin6a8f30e2018-04-26 11:03:49 +0200230 inter_layer_pred_(InterLayerPredMode::kOn),
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100231 external_ref_control_(false), // Set in InitEncode because of tests.
Erik Språng4b4266f2019-01-23 12:48:13 +0100232 trusted_rate_controller_(RateControlSettings::ParseFromFieldTrials()
233 .LibvpxVp9TrustedRateController()),
Erik Språng7a3fe892019-04-15 12:22:55 +0200234 dynamic_rate_settings_(
235 RateControlSettings::ParseFromFieldTrials().Vp9DynamicRateSettings()),
Sergey Silkin88ce4ef2018-11-23 13:59:24 +0100236 full_superframe_drop_(true),
237 first_frame_in_picture_(true),
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100238 ss_info_needed_(false),
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +0100239 is_flexible_mode_(false),
240 variable_framerate_experiment_(ParseVariableFramerateConfig(
241 "WebRTC-VP9VariableFramerateScreenshare")),
242 variable_framerate_controller_(
243 variable_framerate_experiment_.framerate_limit),
244 num_steady_state_frames_(0) {
philipeld1d03592019-03-01 13:53:55 +0100245 codec_ = {};
johannkoenig8225c402017-01-26 13:23:44 -0800246 memset(&svc_params_, 0, sizeof(vpx_svc_extra_cfg_t));
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000247}
248
249VP9EncoderImpl::~VP9EncoderImpl() {
250 Release();
251}
252
Elad Alon8f01c4e2019-06-28 15:19:43 +0200253void VP9EncoderImpl::SetFecControllerOverride(
254 FecControllerOverride* fec_controller_override) {
255 // Ignored.
256}
257
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000258int VP9EncoderImpl::Release() {
Sergey Silkin3e871ea2018-03-02 13:11:04 +0100259 int ret_val = WEBRTC_VIDEO_CODEC_OK;
260
Niels Möllerdd1cc982019-02-07 18:52:50 +0100261 encoded_image_.Allocate(0);
sprang3958ed82017-08-17 08:12:10 -0700262 if (encoder_ != nullptr) {
Sergey Silkin90399692018-03-02 14:44:10 +0100263 if (inited_) {
264 if (vpx_codec_destroy(encoder_)) {
265 ret_val = WEBRTC_VIDEO_CODEC_MEMORY;
266 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000267 }
268 delete encoder_;
sprang3958ed82017-08-17 08:12:10 -0700269 encoder_ = nullptr;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000270 }
sprang3958ed82017-08-17 08:12:10 -0700271 if (config_ != nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000272 delete config_;
sprang3958ed82017-08-17 08:12:10 -0700273 config_ = nullptr;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000274 }
sprang3958ed82017-08-17 08:12:10 -0700275 if (raw_ != nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000276 vpx_img_free(raw_);
sprang3958ed82017-08-17 08:12:10 -0700277 raw_ = nullptr;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000278 }
279 inited_ = false;
Sergey Silkin3e871ea2018-03-02 13:11:04 +0100280 return ret_val;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000281}
282
sprangce4aef12015-11-02 07:23:20 -0800283bool VP9EncoderImpl::ExplicitlyConfiguredSpatialLayers() const {
284 // We check target_bitrate_bps of the 0th layer to see if the spatial layers
285 // (i.e. bitrates) were explicitly configured.
Sergey Silkinbeba1b22018-09-11 11:40:25 +0200286 return codec_.spatialLayers[0].targetBitrate > 0;
sprangce4aef12015-11-02 07:23:20 -0800287}
288
Erik Språng566124a2018-04-23 12:32:22 +0200289bool VP9EncoderImpl::SetSvcRates(
290 const VideoBitrateAllocation& bitrate_allocation) {
Sergey Silkin86684962018-03-28 19:32:37 +0200291 config_->rc_target_bitrate = bitrate_allocation.get_sum_kbps();
Sergey Silkin86684962018-03-28 19:32:37 +0200292
sprangce4aef12015-11-02 07:23:20 -0800293 if (ExplicitlyConfiguredSpatialLayers()) {
Sergey Silkine7ce8882018-10-03 18:04:57 +0200294 const bool layer_activation_requires_key_frame =
295 inter_layer_pred_ == InterLayerPredMode::kOff ||
296 inter_layer_pred_ == InterLayerPredMode::kOnKeyPic;
297
Sergey Silkin86684962018-03-28 19:32:37 +0200298 for (size_t sl_idx = 0; sl_idx < num_spatial_layers_; ++sl_idx) {
Sergey Silkine7ce8882018-10-03 18:04:57 +0200299 const bool was_layer_active = (config_->ss_target_bitrate[sl_idx] > 0);
Sergey Silkin86684962018-03-28 19:32:37 +0200300 config_->ss_target_bitrate[sl_idx] =
301 bitrate_allocation.GetSpatialLayerSum(sl_idx) / 1000;
302
303 for (size_t tl_idx = 0; tl_idx < num_temporal_layers_; ++tl_idx) {
304 config_->layer_target_bitrate[sl_idx * num_temporal_layers_ + tl_idx] =
305 bitrate_allocation.GetTemporalLayerSum(sl_idx, tl_idx) / 1000;
306 }
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200307
Sergey Silkine7ce8882018-10-03 18:04:57 +0200308 const bool is_active_layer = (config_->ss_target_bitrate[sl_idx] > 0);
309 if (!was_layer_active && is_active_layer &&
310 layer_activation_requires_key_frame) {
311 force_key_frame_ = true;
312 } else if (was_layer_active && !is_active_layer &&
313 layer_deactivation_requires_key_frame_) {
314 force_key_frame_ = true;
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200315 }
Sergey Silkin96f2c972018-09-05 21:07:17 +0200316
Sergey Silkine7ce8882018-10-03 18:04:57 +0200317 if (!was_layer_active) {
Sergey Silkin96f2c972018-09-05 21:07:17 +0200318 // Reset frame rate controller if layer is resumed after pause.
319 framerate_controller_[sl_idx].Reset();
320 }
321
322 framerate_controller_[sl_idx].SetTargetRate(
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +0200323 codec_.spatialLayers[sl_idx].maxFramerate);
sprangce4aef12015-11-02 07:23:20 -0800324 }
325 } else {
326 float rate_ratio[VPX_MAX_LAYERS] = {0};
327 float total = 0;
Sergey Silkin908689d2018-08-20 09:28:45 +0200328 for (int i = 0; i < num_spatial_layers_; ++i) {
johannkoenig8225c402017-01-26 13:23:44 -0800329 if (svc_params_.scaling_factor_num[i] <= 0 ||
330 svc_params_.scaling_factor_den[i] <= 0) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100331 RTC_LOG(LS_ERROR) << "Scaling factors not specified!";
sprangce4aef12015-11-02 07:23:20 -0800332 return false;
333 }
Yves Gerey665174f2018-06-19 15:03:05 +0200334 rate_ratio[i] = static_cast<float>(svc_params_.scaling_factor_num[i]) /
335 svc_params_.scaling_factor_den[i];
sprangce4aef12015-11-02 07:23:20 -0800336 total += rate_ratio[i];
337 }
338
Sergey Silkin908689d2018-08-20 09:28:45 +0200339 for (int i = 0; i < num_spatial_layers_; ++i) {
Rasmus Brandt58cd3852018-06-26 13:41:16 +0200340 RTC_CHECK_GT(total, 0);
sprangce4aef12015-11-02 07:23:20 -0800341 config_->ss_target_bitrate[i] = static_cast<unsigned int>(
342 config_->rc_target_bitrate * rate_ratio[i] / total);
343 if (num_temporal_layers_ == 1) {
344 config_->layer_target_bitrate[i] = config_->ss_target_bitrate[i];
345 } else if (num_temporal_layers_ == 2) {
346 config_->layer_target_bitrate[i * num_temporal_layers_] =
347 config_->ss_target_bitrate[i] * 2 / 3;
348 config_->layer_target_bitrate[i * num_temporal_layers_ + 1] =
349 config_->ss_target_bitrate[i];
350 } else if (num_temporal_layers_ == 3) {
351 config_->layer_target_bitrate[i * num_temporal_layers_] =
352 config_->ss_target_bitrate[i] / 2;
353 config_->layer_target_bitrate[i * num_temporal_layers_ + 1] =
354 config_->layer_target_bitrate[i * num_temporal_layers_] +
355 (config_->ss_target_bitrate[i] / 4);
356 config_->layer_target_bitrate[i * num_temporal_layers_ + 2] =
357 config_->ss_target_bitrate[i];
358 } else {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100359 RTC_LOG(LS_ERROR) << "Unsupported number of temporal layers: "
360 << num_temporal_layers_;
sprangce4aef12015-11-02 07:23:20 -0800361 return false;
362 }
Sergey Silkin96f2c972018-09-05 21:07:17 +0200363
364 framerate_controller_[i].SetTargetRate(codec_.maxFramerate);
asaperssona9455ab2015-07-31 06:10:09 -0700365 }
366 }
Sergey Silkin908689d2018-08-20 09:28:45 +0200367
368 num_active_spatial_layers_ = 0;
369 for (int i = 0; i < num_spatial_layers_; ++i) {
370 if (config_->ss_target_bitrate[i] > 0) {
371 ++num_active_spatial_layers_;
372 }
373 }
374 RTC_DCHECK_GT(num_active_spatial_layers_, 0);
375
asaperssona9455ab2015-07-31 06:10:09 -0700376 return true;
377}
378
Erik Språng16cb8f52019-04-12 13:59:09 +0200379void VP9EncoderImpl::SetRates(const RateControlParameters& parameters) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000380 if (!inited_) {
Erik Språng16cb8f52019-04-12 13:59:09 +0200381 RTC_LOG(LS_WARNING) << "SetRates() calll while uninitialzied.";
382 return;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000383 }
384 if (encoder_->err) {
Erik Språng16cb8f52019-04-12 13:59:09 +0200385 RTC_LOG(LS_WARNING) << "Encoder in error state: " << encoder_->err;
386 return;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000387 }
Erik Språng16cb8f52019-04-12 13:59:09 +0200388 if (parameters.framerate_fps < 1.0) {
389 RTC_LOG(LS_WARNING) << "Unsupported framerate: "
390 << parameters.framerate_fps;
391 return;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000392 }
Erik Språng08127a92016-11-16 16:41:30 +0100393
Erik Språng16cb8f52019-04-12 13:59:09 +0200394 codec_.maxFramerate = static_cast<uint32_t>(parameters.framerate_fps + 0.5);
Erik Språng7a3fe892019-04-15 12:22:55 +0200395 requested_rate_settings_ = parameters;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000396}
397
Elad Alon370f93a2019-06-11 14:57:57 +0200398// TODO(eladalon): s/inst/codec_settings/g.
Elad Alon11dfff02019-06-10 19:10:29 +0200399int VP9EncoderImpl::InitEncode(const VideoCodec* inst,
Elad Alon370f93a2019-06-11 14:57:57 +0200400 const Settings& settings) {
sprang3958ed82017-08-17 08:12:10 -0700401 if (inst == nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000402 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
403 }
404 if (inst->maxFramerate < 1) {
405 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
406 }
407 // Allow zero to represent an unspecified maxBitRate
408 if (inst->maxBitrate > 0 && inst->startBitrate > inst->maxBitrate) {
409 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
410 }
411 if (inst->width < 1 || inst->height < 1) {
412 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
413 }
Elad Alon370f93a2019-06-11 14:57:57 +0200414 if (settings.number_of_cores < 1) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000415 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
416 }
hta257dc392016-10-25 09:05:06 -0700417 if (inst->VP9().numberOfTemporalLayers > 3) {
asaperssona9455ab2015-07-31 06:10:09 -0700418 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
419 }
ilnik2a8c2f52017-02-15 02:23:28 -0800420 // libvpx probably does not support more than 3 spatial layers.
421 if (inst->VP9().numberOfSpatialLayers > 3) {
asaperssona9455ab2015-07-31 06:10:09 -0700422 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
423 }
philipelcfc319b2015-11-10 07:17:23 -0800424
asapersson86956de2016-01-26 01:05:20 -0800425 int ret_val = Release();
426 if (ret_val < 0) {
427 return ret_val;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000428 }
sprang3958ed82017-08-17 08:12:10 -0700429 if (encoder_ == nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000430 encoder_ = new vpx_codec_ctx_t;
431 }
sprang3958ed82017-08-17 08:12:10 -0700432 if (config_ == nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000433 config_ = new vpx_codec_enc_cfg_t;
434 }
435 timestamp_ = 0;
436 if (&codec_ != inst) {
437 codec_ = *inst;
438 }
asaperssona9455ab2015-07-31 06:10:09 -0700439
Sergey Silkinb0bd03b2018-09-28 14:56:39 +0200440 force_key_frame_ = true;
441 pics_since_key_ = 0;
442
hta257dc392016-10-25 09:05:06 -0700443 num_spatial_layers_ = inst->VP9().numberOfSpatialLayers;
Niels Möller65fb4042018-04-25 14:46:06 +0200444 RTC_DCHECK_GT(num_spatial_layers_, 0);
hta257dc392016-10-25 09:05:06 -0700445 num_temporal_layers_ = inst->VP9().numberOfTemporalLayers;
Sergey Silkin96f2c972018-09-05 21:07:17 +0200446 if (num_temporal_layers_ == 0) {
asaperssona9455ab2015-07-31 06:10:09 -0700447 num_temporal_layers_ = 1;
Sergey Silkin042661b2018-09-10 10:39:35 +0000448 }
Sergey Silkinae9e1882018-09-05 21:07:17 +0200449
Sergey Silkin96f2c972018-09-05 21:07:17 +0200450 framerate_controller_ = std::vector<FramerateController>(
451 num_spatial_layers_, FramerateController(codec_.maxFramerate));
452
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200453 is_svc_ = (num_spatial_layers_ > 1 || num_temporal_layers_ > 1);
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200454
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000455 encoded_image_._completeFrame = true;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000456 // Populate encoder configuration with default values.
457 if (vpx_codec_enc_config_default(vpx_codec_vp9_cx(), config_, 0)) {
458 return WEBRTC_VIDEO_CODEC_ERROR;
459 }
Emircan Uysaler0823eec2018-07-13 17:10:00 -0700460
461 vpx_img_fmt img_fmt = VPX_IMG_FMT_NONE;
462 unsigned int bits_for_storage = 8;
463 switch (profile_) {
464 case VP9Profile::kProfile0:
465 img_fmt = VPX_IMG_FMT_I420;
466 bits_for_storage = 8;
467 config_->g_bit_depth = VPX_BITS_8;
468 config_->g_profile = 0;
469 config_->g_input_bit_depth = 8;
470 break;
471 case VP9Profile::kProfile2:
472 img_fmt = VPX_IMG_FMT_I42016;
473 bits_for_storage = 16;
474 config_->g_bit_depth = VPX_BITS_10;
475 config_->g_profile = 2;
476 config_->g_input_bit_depth = 10;
477 break;
478 }
479
480 // Creating a wrapper to the image - setting image data to nullptr. Actual
481 // pointer will be set in encode. Setting align to 1, as it is meaningless
482 // (actual memory is not allocated).
483 raw_ =
484 vpx_img_wrap(nullptr, img_fmt, codec_.width, codec_.height, 1, nullptr);
485 raw_->bit_depth = bits_for_storage;
486
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000487 config_->g_w = codec_.width;
488 config_->g_h = codec_.height;
489 config_->rc_target_bitrate = inst->startBitrate; // in kbit/s
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200490 config_->g_error_resilient = is_svc_ ? VPX_ERROR_RESILIENT_DEFAULT : 0;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000491 // Setting the time base of the codec.
492 config_->g_timebase.num = 1;
493 config_->g_timebase.den = 90000;
494 config_->g_lag_in_frames = 0; // 0- no frame lagging
495 config_->g_threads = 1;
496 // Rate control settings.
hta257dc392016-10-25 09:05:06 -0700497 config_->rc_dropframe_thresh = inst->VP9().frameDroppingOn ? 30 : 0;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000498 config_->rc_end_usage = VPX_CBR;
499 config_->g_pass = VPX_RC_ONE_PASS;
Ilya Nikolaevskiy3a656d12019-02-14 14:44:22 +0100500 config_->rc_min_quantizer =
501 codec_.mode == VideoCodecMode::kScreensharing ? 8 : 2;
marpan@webrtc.orgdc8a9da2015-01-27 23:08:24 +0000502 config_->rc_max_quantizer = 52;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000503 config_->rc_undershoot_pct = 50;
504 config_->rc_overshoot_pct = 50;
505 config_->rc_buf_initial_sz = 500;
506 config_->rc_buf_optimal_sz = 600;
507 config_->rc_buf_sz = 1000;
508 // Set the maximum target size of any key-frame.
509 rc_max_intra_target_ = MaxIntraTarget(config_->rc_buf_optimal_sz);
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +0100510 // Key-frame interval is enforced manually by this wrapper.
511 config_->kf_mode = VPX_KF_DISABLED;
512 // TODO(webm:1592): work-around for libvpx issue, as it can still
513 // put some key-frames at will even in VPX_KF_DISABLED kf_mode.
514 config_->kf_max_dist = inst->VP9().keyFrameInterval;
515 config_->kf_min_dist = config_->kf_max_dist;
hta257dc392016-10-25 09:05:06 -0700516 config_->rc_resize_allowed = inst->VP9().automaticResizeOn ? 1 : 0;
marpan@webrtc.org38d11b82015-01-26 15:21:36 +0000517 // Determine number of threads based on the image size and #cores.
philipelcce46fc2015-12-21 03:04:49 -0800518 config_->g_threads =
Elad Alon370f93a2019-06-11 14:57:57 +0200519 NumberOfThreads(config_->g_w, config_->g_h, settings.number_of_cores);
asaperssona9455ab2015-07-31 06:10:09 -0700520
Marco6e89b252015-07-07 14:40:38 -0700521 cpu_speed_ = GetCpuSpeed(config_->g_w, config_->g_h);
asaperssona9455ab2015-07-31 06:10:09 -0700522
hta257dc392016-10-25 09:05:06 -0700523 is_flexible_mode_ = inst->VP9().flexibleMode;
Sergey Silkinbe71a1e2018-05-17 16:46:43 +0200524
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100525 inter_layer_pred_ = inst->VP9().interLayerPred;
526
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +0200527 if (num_spatial_layers_ > 1 &&
528 codec_.mode == VideoCodecMode::kScreensharing && !is_flexible_mode_) {
529 RTC_LOG(LS_ERROR) << "Flexible mode is required for screenshare with "
530 "several spatial layers";
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100531 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
532 }
533
534 // External reference control is required for different frame rate on spatial
535 // layers because libvpx generates rtp incompatible references in this case.
536 external_ref_control_ = field_trial::IsEnabled("WebRTC-Vp9ExternalRefCtrl") ||
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +0200537 (num_spatial_layers_ > 1 &&
538 codec_.mode == VideoCodecMode::kScreensharing) ||
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +0100539 inter_layer_pred_ == InterLayerPredMode::kOn;
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100540
Sergey Silkinbe71a1e2018-05-17 16:46:43 +0200541 if (num_temporal_layers_ == 1) {
asaperssona9455ab2015-07-31 06:10:09 -0700542 gof_.SetGofInfoVP9(kTemporalStructureMode1);
543 config_->temporal_layering_mode = VP9E_TEMPORAL_LAYERING_MODE_NOLAYERING;
544 config_->ts_number_layers = 1;
545 config_->ts_rate_decimator[0] = 1;
546 config_->ts_periodicity = 1;
547 config_->ts_layer_id[0] = 0;
548 } else if (num_temporal_layers_ == 2) {
549 gof_.SetGofInfoVP9(kTemporalStructureMode2);
550 config_->temporal_layering_mode = VP9E_TEMPORAL_LAYERING_MODE_0101;
551 config_->ts_number_layers = 2;
552 config_->ts_rate_decimator[0] = 2;
553 config_->ts_rate_decimator[1] = 1;
554 config_->ts_periodicity = 2;
555 config_->ts_layer_id[0] = 0;
556 config_->ts_layer_id[1] = 1;
557 } else if (num_temporal_layers_ == 3) {
558 gof_.SetGofInfoVP9(kTemporalStructureMode3);
559 config_->temporal_layering_mode = VP9E_TEMPORAL_LAYERING_MODE_0212;
560 config_->ts_number_layers = 3;
561 config_->ts_rate_decimator[0] = 4;
562 config_->ts_rate_decimator[1] = 2;
563 config_->ts_rate_decimator[2] = 1;
564 config_->ts_periodicity = 4;
565 config_->ts_layer_id[0] = 0;
566 config_->ts_layer_id[1] = 2;
567 config_->ts_layer_id[2] = 1;
568 config_->ts_layer_id[3] = 2;
569 } else {
570 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
571 }
572
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100573 if (external_ref_control_) {
574 config_->temporal_layering_mode = VP9E_TEMPORAL_LAYERING_MODE_BYPASS;
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +0200575 if (num_temporal_layers_ > 1 && num_spatial_layers_ > 1 &&
576 codec_.mode == VideoCodecMode::kScreensharing) {
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100577 // External reference control for several temporal layers with different
578 // frame rates on spatial layers is not implemented yet.
579 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
580 }
581 }
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200582 ref_buf_.clear();
583
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000584 return InitAndSetControlSettings(inst);
585}
586
marpan@webrtc.org38d11b82015-01-26 15:21:36 +0000587int VP9EncoderImpl::NumberOfThreads(int width,
588 int height,
589 int number_of_cores) {
590 // Keep the number of encoder threads equal to the possible number of column
591 // tiles, which is (1, 2, 4, 8). See comments below for VP9E_SET_TILE_COLUMNS.
592 if (width * height >= 1280 * 720 && number_of_cores > 4) {
593 return 4;
jianj23173a32017-07-12 16:11:09 -0700594 } else if (width * height >= 640 * 360 && number_of_cores > 2) {
marpan@webrtc.org38d11b82015-01-26 15:21:36 +0000595 return 2;
596 } else {
Yves Gerey665174f2018-06-19 15:03:05 +0200597// Use 2 threads for low res on ARM.
Jerome Jiang831af372017-12-05 10:44:35 -0800598#if defined(WEBRTC_ARCH_ARM) || defined(WEBRTC_ARCH_ARM64) || \
599 defined(WEBRTC_ANDROID)
600 if (width * height >= 320 * 180 && number_of_cores > 2) {
601 return 2;
602 }
603#endif
marpan@webrtc.org38d11b82015-01-26 15:21:36 +0000604 // 1 thread less than VGA.
605 return 1;
606 }
607}
608
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000609int VP9EncoderImpl::InitAndSetControlSettings(const VideoCodec* inst) {
Åsa Perssonff24c042015-12-04 10:58:08 +0100610 // Set QP-min/max per spatial and temporal layer.
611 int tot_num_layers = num_spatial_layers_ * num_temporal_layers_;
612 for (int i = 0; i < tot_num_layers; ++i) {
johannkoenig8225c402017-01-26 13:23:44 -0800613 svc_params_.max_quantizers[i] = config_->rc_max_quantizer;
614 svc_params_.min_quantizers[i] = config_->rc_min_quantizer;
Åsa Perssonff24c042015-12-04 10:58:08 +0100615 }
asaperssona9455ab2015-07-31 06:10:09 -0700616 config_->ss_number_layers = num_spatial_layers_;
sprangce4aef12015-11-02 07:23:20 -0800617 if (ExplicitlyConfiguredSpatialLayers()) {
618 for (int i = 0; i < num_spatial_layers_; ++i) {
619 const auto& layer = codec_.spatialLayers[i];
Rasmus Brandt58cd3852018-06-26 13:41:16 +0200620 RTC_CHECK_GT(layer.width, 0);
Sergey Silkin13e74342018-03-02 12:28:00 +0100621 const int scale_factor = codec_.width / layer.width;
622 RTC_DCHECK_GT(scale_factor, 0);
623
624 // Ensure scaler factor is integer.
625 if (scale_factor * layer.width != codec_.width) {
626 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
627 }
628
629 // Ensure scale factor is the same in both dimensions.
630 if (scale_factor * layer.height != codec_.height) {
631 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
632 }
633
634 // Ensure scale factor is power of two.
635 const bool is_pow_of_two = (scale_factor & (scale_factor - 1)) == 0;
636 if (!is_pow_of_two) {
637 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
638 }
639
640 svc_params_.scaling_factor_num[i] = 1;
641 svc_params_.scaling_factor_den[i] = scale_factor;
Sergey Silkin96f2c972018-09-05 21:07:17 +0200642
643 RTC_DCHECK_GT(codec_.spatialLayers[i].maxFramerate, 0);
644 RTC_DCHECK_LE(codec_.spatialLayers[i].maxFramerate, codec_.maxFramerate);
645 if (i > 0) {
646 // Frame rate of high spatial layer is supposed to be equal or higher
647 // than frame rate of low spatial layer.
648 RTC_DCHECK_GE(codec_.spatialLayers[i].maxFramerate,
649 codec_.spatialLayers[i - 1].maxFramerate);
650 }
sprangce4aef12015-11-02 07:23:20 -0800651 }
652 } else {
653 int scaling_factor_num = 256;
654 for (int i = num_spatial_layers_ - 1; i >= 0; --i) {
sprangce4aef12015-11-02 07:23:20 -0800655 // 1:2 scaling in each dimension.
johannkoenig8225c402017-01-26 13:23:44 -0800656 svc_params_.scaling_factor_num[i] = scaling_factor_num;
657 svc_params_.scaling_factor_den[i] = 256;
sprangce4aef12015-11-02 07:23:20 -0800658 }
asaperssona9455ab2015-07-31 06:10:09 -0700659 }
660
Sergey Silkin86684962018-03-28 19:32:37 +0200661 SvcRateAllocator init_allocator(codec_);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100662 current_bitrate_allocation_ = init_allocator.GetAllocation(
Sergey Silkin86684962018-03-28 19:32:37 +0200663 inst->startBitrate * 1000, inst->maxFramerate);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100664 if (!SetSvcRates(current_bitrate_allocation_)) {
asaperssona9455ab2015-07-31 06:10:09 -0700665 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
666 }
667
Emircan Uysaler0823eec2018-07-13 17:10:00 -0700668 const vpx_codec_err_t rv = vpx_codec_enc_init(
669 encoder_, vpx_codec_vp9_cx(), config_,
670 config_->g_bit_depth == VPX_BITS_8 ? 0 : VPX_CODEC_USE_HIGHBITDEPTH);
671 if (rv != VPX_CODEC_OK) {
672 RTC_LOG(LS_ERROR) << "Init error: " << vpx_codec_err_to_string(rv);
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000673 return WEBRTC_VIDEO_CODEC_UNINITIALIZED;
674 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000675 vpx_codec_control(encoder_, VP8E_SET_CPUUSED, cpu_speed_);
676 vpx_codec_control(encoder_, VP8E_SET_MAX_INTRA_BITRATE_PCT,
677 rc_max_intra_target_);
678 vpx_codec_control(encoder_, VP9E_SET_AQ_MODE,
hta257dc392016-10-25 09:05:06 -0700679 inst->VP9().adaptiveQpMode ? 3 : 0);
asaperssona9455ab2015-07-31 06:10:09 -0700680
jianj822e5932017-07-12 16:09:58 -0700681 vpx_codec_control(encoder_, VP9E_SET_FRAME_PARALLEL_DECODING, 0);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100682 vpx_codec_control(encoder_, VP9E_SET_SVC_GF_TEMPORAL_REF, 0);
Sergey Silkin6a8f30e2018-04-26 11:03:49 +0200683
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200684 if (is_svc_) {
685 vpx_codec_control(encoder_, VP9E_SET_SVC, 1);
686 vpx_codec_control(encoder_, VP9E_SET_SVC_PARAMETERS, &svc_params_);
asaperssona9455ab2015-07-31 06:10:09 -0700687 }
Sergey Silkin6a8f30e2018-04-26 11:03:49 +0200688
689 if (num_spatial_layers_ > 1) {
690 switch (inter_layer_pred_) {
691 case InterLayerPredMode::kOn:
692 vpx_codec_control(encoder_, VP9E_SET_SVC_INTER_LAYER_PRED, 0);
693 break;
694 case InterLayerPredMode::kOff:
695 vpx_codec_control(encoder_, VP9E_SET_SVC_INTER_LAYER_PRED, 1);
696 break;
697 case InterLayerPredMode::kOnKeyPic:
698 vpx_codec_control(encoder_, VP9E_SET_SVC_INTER_LAYER_PRED, 2);
699 break;
700 default:
701 RTC_NOTREACHED();
702 }
Sergey Silkinbe71a1e2018-05-17 16:46:43 +0200703
Ilya Nikolaevskiy039a7142019-05-24 16:50:00 +0200704 memset(&svc_drop_frame_, 0, sizeof(svc_drop_frame_));
705 dropping_only_base_layer_ = inter_layer_pred_ == InterLayerPredMode::kOn &&
706 codec_.mode == VideoCodecMode::kScreensharing &&
707 num_spatial_layers_ > 1;
708 if (dropping_only_base_layer_) {
709 // Screenshare dropping mode: only the base spatial layer
710 // can be dropped and it doesn't affect other spatial layers.
711 // This mode is preferable because base layer has low bitrate targets
712 // and more likely to drop frames. It shouldn't reduce framerate on other
713 // layers.
714 svc_drop_frame_.framedrop_mode = LAYER_DROP;
715 svc_drop_frame_.max_consec_drop = 5;
716 svc_drop_frame_.framedrop_thresh[0] = config_->rc_dropframe_thresh;
717 for (size_t i = 1; i < num_spatial_layers_; ++i) {
718 svc_drop_frame_.framedrop_thresh[i] = 0;
719 }
720 } else {
721 // Configure encoder to drop entire superframe whenever it needs to drop
722 // a layer. This mode is preferred over per-layer dropping which causes
723 // quality flickering and is not compatible with RTP non-flexible mode.
724 svc_drop_frame_.framedrop_mode =
725 full_superframe_drop_ ? FULL_SUPERFRAME_DROP : CONSTRAINED_LAYER_DROP;
726 svc_drop_frame_.max_consec_drop = std::numeric_limits<int>::max();
727 for (size_t i = 0; i < num_spatial_layers_; ++i) {
728 svc_drop_frame_.framedrop_thresh[i] = config_->rc_dropframe_thresh;
729 }
Sergey Silkinbe71a1e2018-05-17 16:46:43 +0200730 }
Ilya Nikolaevskiy039a7142019-05-24 16:50:00 +0200731 vpx_codec_control(encoder_, VP9E_SET_SVC_FRAME_DROP_LAYER,
732 &svc_drop_frame_);
Sergey Silkin6a8f30e2018-04-26 11:03:49 +0200733 }
734
asaperssona9455ab2015-07-31 06:10:09 -0700735 // Register callback for getting each spatial layer.
736 vpx_codec_priv_output_cx_pkt_cb_pair_t cbp = {
philipelcce46fc2015-12-21 03:04:49 -0800737 VP9EncoderImpl::EncoderOutputCodedPacketCallback,
738 reinterpret_cast<void*>(this)};
739 vpx_codec_control(encoder_, VP9E_REGISTER_CX_CALLBACK,
740 reinterpret_cast<void*>(&cbp));
asaperssona9455ab2015-07-31 06:10:09 -0700741
marpan@webrtc.org38d11b82015-01-26 15:21:36 +0000742 // Control function to set the number of column tiles in encoding a frame, in
743 // log2 unit: e.g., 0 = 1 tile column, 1 = 2 tile columns, 2 = 4 tile columns.
744 // The number tile columns will be capped by the encoder based on image size
745 // (minimum width of tile column is 256 pixels, maximum is 4096).
746 vpx_codec_control(encoder_, VP9E_SET_TILE_COLUMNS, (config_->g_threads >> 1));
jianjcb5d1152017-03-28 23:56:08 -0700747
748 // Turn on row-based multithreading.
749 vpx_codec_control(encoder_, VP9E_SET_ROW_MT, 1);
jianj6bf57e32017-06-05 13:43:49 -0700750
Alex Glaznevfecb7c32016-03-31 14:23:27 -0700751#if !defined(WEBRTC_ARCH_ARM) && !defined(WEBRTC_ARCH_ARM64) && \
Yves Gerey665174f2018-06-19 15:03:05 +0200752 !defined(ANDROID)
jianj6bf57e32017-06-05 13:43:49 -0700753 // Do not enable the denoiser on ARM since optimization is pending.
754 // Denoiser is on by default on other platforms.
marpan@webrtc.org16a87b92015-03-05 22:19:00 +0000755 vpx_codec_control(encoder_, VP9E_SET_NOISE_SENSITIVITY,
hta257dc392016-10-25 09:05:06 -0700756 inst->VP9().denoisingOn ? 1 : 0);
marpan@webrtc.org16a87b92015-03-05 22:19:00 +0000757#endif
jianj6bf57e32017-06-05 13:43:49 -0700758
Niels Möllere3cf3d02018-06-13 11:52:16 +0200759 if (codec_.mode == VideoCodecMode::kScreensharing) {
ivica242d6382015-09-04 06:13:23 -0700760 // Adjust internal parameters to screen content.
761 vpx_codec_control(encoder_, VP9E_SET_TUNE_CONTENT, 1);
ivica242d6382015-09-04 06:13:23 -0700762 }
Marco2520e722015-09-16 14:05:00 -0700763 // Enable encoder skip of static/low content blocks.
764 vpx_codec_control(encoder_, VP8E_SET_STATIC_THRESHOLD, 1);
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000765 inited_ = true;
766 return WEBRTC_VIDEO_CODEC_OK;
767}
768
769uint32_t VP9EncoderImpl::MaxIntraTarget(uint32_t optimal_buffer_size) {
770 // Set max to the optimal buffer level (normalized by target BR),
771 // and scaled by a scale_par.
772 // Max target size = scale_par * optimal_buffer_size * targetBR[Kbps].
773 // This value is presented in percentage of perFrameBw:
774 // perFrameBw = targetBR[Kbps] * 1000 / framerate.
775 // The target in % is as follows:
776 float scale_par = 0.5;
777 uint32_t target_pct =
778 optimal_buffer_size * scale_par * codec_.maxFramerate / 10;
779 // Don't go below 3 times the per frame bandwidth.
780 const uint32_t min_intra_size = 300;
philipelcce46fc2015-12-21 03:04:49 -0800781 return (target_pct < min_intra_size) ? min_intra_size : target_pct;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000782}
783
Miguel Casas-Sanchez47650702015-05-29 17:21:40 -0700784int VP9EncoderImpl::Encode(const VideoFrame& input_image,
Niels Möller87e2d782019-03-07 10:18:23 +0100785 const std::vector<VideoFrameType>* frame_types) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000786 if (!inited_) {
787 return WEBRTC_VIDEO_CODEC_UNINITIALIZED;
788 }
sprang3958ed82017-08-17 08:12:10 -0700789 if (encoded_complete_callback_ == nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000790 return WEBRTC_VIDEO_CODEC_UNINITIALIZED;
791 }
Erik Språngbfa5d5d2019-02-04 16:40:19 +0100792 if (num_active_spatial_layers_ == 0) {
793 // All spatial layers are disabled, return without encoding anything.
794 return WEBRTC_VIDEO_CODEC_OK;
795 }
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200796
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000797 // We only support one stream at the moment.
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200798 if (frame_types && !frame_types->empty()) {
Niels Möller8f7ce222019-03-21 15:43:58 +0100799 if ((*frame_types)[0] == VideoFrameType::kVideoFrameKey) {
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200800 force_key_frame_ = true;
801 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000802 }
Sergey Silkind902d582018-05-18 17:31:19 +0200803
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +0100804 if (pics_since_key_ + 1 ==
805 static_cast<size_t>(codec_.VP9()->keyFrameInterval)) {
806 force_key_frame_ = true;
807 }
808
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100809 vpx_svc_layer_id_t layer_id = {0};
810 if (!force_key_frame_) {
Patrik Höglundd4d254f2018-11-29 15:09:31 +0000811 const size_t gof_idx = (pics_since_key_ + 1) % gof_.num_frames_in_gof;
812 layer_id.temporal_layer_id = gof_.temporal_idx[gof_idx];
Sergey Silkin96f2c972018-09-05 21:07:17 +0200813
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100814 if (VideoCodecMode::kScreensharing == codec_.mode) {
815 const uint32_t frame_timestamp_ms =
816 1000 * input_image.timestamp() / kVideoPayloadTypeFrequency;
Sergey Silkin96f2c972018-09-05 21:07:17 +0200817
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +0100818 // To ensure that several rate-limiters with different limits don't
819 // interfere, they must be queried in order of increasing limit.
820
821 bool use_steady_state_limiter =
822 variable_framerate_experiment_.enabled &&
823 input_image.update_rect().IsEmpty() &&
824 num_steady_state_frames_ >=
825 variable_framerate_experiment_.frames_before_steady_state;
826
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100827 for (uint8_t sl_idx = 0; sl_idx < num_active_spatial_layers_; ++sl_idx) {
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +0100828 const float layer_fps =
829 framerate_controller_[layer_id.spatial_layer_id].GetTargetRate();
830 // Use steady state rate-limiter at the correct place.
831 if (use_steady_state_limiter &&
832 layer_fps > variable_framerate_experiment_.framerate_limit - 1e-9) {
833 if (variable_framerate_controller_.DropFrame(frame_timestamp_ms)) {
834 layer_id.spatial_layer_id = num_active_spatial_layers_;
835 }
836 // Break always: if rate limiter triggered frame drop, no need to
837 // continue; otherwise, the rate is less than the next limiters.
838 break;
839 }
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100840 if (framerate_controller_[sl_idx].DropFrame(frame_timestamp_ms)) {
841 ++layer_id.spatial_layer_id;
842 } else {
843 break;
844 }
Sergey Silkin96f2c972018-09-05 21:07:17 +0200845 }
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +0100846
847 if (use_steady_state_limiter &&
848 layer_id.spatial_layer_id < num_active_spatial_layers_) {
849 variable_framerate_controller_.AddFrame(frame_timestamp_ms);
850 }
Sergey Silkin96f2c972018-09-05 21:07:17 +0200851 }
Patrik Höglundd4d254f2018-11-29 15:09:31 +0000852
853 RTC_DCHECK_LE(layer_id.spatial_layer_id, num_active_spatial_layers_);
854 if (layer_id.spatial_layer_id >= num_active_spatial_layers_) {
855 // Drop entire picture.
856 return WEBRTC_VIDEO_CODEC_OK;
857 }
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100858 }
Patrik Höglundd4d254f2018-11-29 15:09:31 +0000859
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100860 for (int sl_idx = 0; sl_idx < num_active_spatial_layers_; ++sl_idx) {
861 layer_id.temporal_layer_id_per_spatial[sl_idx] = layer_id.temporal_layer_id;
862 }
863
864 vpx_codec_control(encoder_, VP9E_SET_SVC_LAYER_ID, &layer_id);
865
Erik Språng7a3fe892019-04-15 12:22:55 +0200866 if (requested_rate_settings_) {
867 if (dynamic_rate_settings_) {
868 // Tweak rate control settings based on available network headroom.
869 UpdateRateSettings(
870 config_,
871 GetRateSettings(
872 requested_rate_settings_->bandwidth_allocation.bps<double>() /
873 requested_rate_settings_->bitrate.get_sum_bps()));
874 }
875
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100876 bool more_layers_requested = MoreLayersEnabled(
Erik Språng7a3fe892019-04-15 12:22:55 +0200877 requested_rate_settings_->bitrate, current_bitrate_allocation_);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100878 bool less_layers_requested = MoreLayersEnabled(
Erik Språng7a3fe892019-04-15 12:22:55 +0200879 current_bitrate_allocation_, requested_rate_settings_->bitrate);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100880 // In SVC can enable new layers only if all lower layers are encoded and at
881 // the base temporal layer.
882 // This will delay rate allocation change until the next frame on the base
883 // spatial layer.
884 // In KSVC or simulcast modes KF will be generated for a new layer, so can
885 // update allocation any time.
886 bool can_upswitch =
887 inter_layer_pred_ != InterLayerPredMode::kOn ||
888 (layer_id.spatial_layer_id == 0 && layer_id.temporal_layer_id == 0);
889 if (!more_layers_requested || can_upswitch) {
Erik Språng7a3fe892019-04-15 12:22:55 +0200890 current_bitrate_allocation_ = requested_rate_settings_->bitrate;
891 requested_rate_settings_ = absl::nullopt;
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100892 if (!SetSvcRates(current_bitrate_allocation_)) {
893 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
894 }
895 if (less_layers_requested || more_layers_requested) {
896 ss_info_needed_ = true;
897 }
Ilya Nikolaevskiy039a7142019-05-24 16:50:00 +0200898 if (more_layers_requested && !force_key_frame_) {
899 // Prohibit drop of all layers for the next frame, so newly enabled
900 // layer would have a valid spatial reference.
901 for (size_t i = 0; i < num_spatial_layers_; ++i) {
902 svc_drop_frame_.framedrop_thresh[i] = 0;
903 }
904 }
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100905 }
906 }
907
Ilya Nikolaevskiy039a7142019-05-24 16:50:00 +0200908 if (num_spatial_layers_ > 1) {
909 // Update frame dropping settings as they may change on per-frame basis.
910 vpx_codec_control(encoder_, VP9E_SET_SVC_FRAME_DROP_LAYER,
911 &svc_drop_frame_);
912 }
913
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100914 if (vpx_codec_enc_config_set(encoder_, config_)) {
915 return WEBRTC_VIDEO_CODEC_ERROR;
Sergey Silkind902d582018-05-18 17:31:19 +0200916 }
917
kwiberg352444f2016-11-28 15:58:53 -0800918 RTC_DCHECK_EQ(input_image.width(), raw_->d_w);
919 RTC_DCHECK_EQ(input_image.height(), raw_->d_h);
asaperssona9455ab2015-07-31 06:10:09 -0700920
921 // Set input image for use in the callback.
922 // This was necessary since you need some information from input_image.
923 // You can save only the necessary information (such as timestamp) instead of
924 // doing this.
925 input_image_ = &input_image;
926
Emircan Uysaler0823eec2018-07-13 17:10:00 -0700927 // Keep reference to buffer until encode completes.
928 rtc::scoped_refptr<I420BufferInterface> i420_buffer;
Ilya Nikolaevskiya8507e32019-05-03 11:39:26 +0200929 const I010BufferInterface* i010_buffer;
930 rtc::scoped_refptr<const I010BufferInterface> i010_copy;
Emircan Uysaler0823eec2018-07-13 17:10:00 -0700931 switch (profile_) {
932 case VP9Profile::kProfile0: {
933 i420_buffer = input_image.video_frame_buffer()->ToI420();
934 // Image in vpx_image_t format.
935 // Input image is const. VPX's raw image is not defined as const.
936 raw_->planes[VPX_PLANE_Y] = const_cast<uint8_t*>(i420_buffer->DataY());
937 raw_->planes[VPX_PLANE_U] = const_cast<uint8_t*>(i420_buffer->DataU());
938 raw_->planes[VPX_PLANE_V] = const_cast<uint8_t*>(i420_buffer->DataV());
939 raw_->stride[VPX_PLANE_Y] = i420_buffer->StrideY();
940 raw_->stride[VPX_PLANE_U] = i420_buffer->StrideU();
941 raw_->stride[VPX_PLANE_V] = i420_buffer->StrideV();
942 break;
943 }
944 case VP9Profile::kProfile2: {
945 // We can inject kI010 frames directly for encode. All other formats
946 // should be converted to it.
947 switch (input_image.video_frame_buffer()->type()) {
948 case VideoFrameBuffer::Type::kI010: {
949 i010_buffer = input_image.video_frame_buffer()->GetI010();
950 break;
951 }
952 default: {
Ilya Nikolaevskiya8507e32019-05-03 11:39:26 +0200953 i010_copy =
Emircan Uysaler0823eec2018-07-13 17:10:00 -0700954 I010Buffer::Copy(*input_image.video_frame_buffer()->ToI420());
Ilya Nikolaevskiya8507e32019-05-03 11:39:26 +0200955 i010_buffer = i010_copy.get();
Emircan Uysaler0823eec2018-07-13 17:10:00 -0700956 }
957 }
958 raw_->planes[VPX_PLANE_Y] = const_cast<uint8_t*>(
959 reinterpret_cast<const uint8_t*>(i010_buffer->DataY()));
960 raw_->planes[VPX_PLANE_U] = const_cast<uint8_t*>(
961 reinterpret_cast<const uint8_t*>(i010_buffer->DataU()));
962 raw_->planes[VPX_PLANE_V] = const_cast<uint8_t*>(
963 reinterpret_cast<const uint8_t*>(i010_buffer->DataV()));
964 raw_->stride[VPX_PLANE_Y] = i010_buffer->StrideY() * 2;
965 raw_->stride[VPX_PLANE_U] = i010_buffer->StrideU() * 2;
966 raw_->stride[VPX_PLANE_V] = i010_buffer->StrideV() * 2;
967 break;
968 }
969 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000970
philipelcfc319b2015-11-10 07:17:23 -0800971 vpx_enc_frame_flags_t flags = 0;
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200972 if (force_key_frame_) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000973 flags = VPX_EFLAG_FORCE_KF;
974 }
philipelcfc319b2015-11-10 07:17:23 -0800975
Sergey Silkin390f3582018-10-01 17:13:50 +0200976 if (external_ref_control_) {
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100977 vpx_svc_ref_frame_config_t ref_config =
978 SetReferences(force_key_frame_, layer_id.spatial_layer_id);
Sergey Silkina85995a2018-10-02 10:28:10 +0200979
980 if (VideoCodecMode::kScreensharing == codec_.mode) {
981 for (uint8_t sl_idx = 0; sl_idx < num_active_spatial_layers_; ++sl_idx) {
982 ref_config.duration[sl_idx] = static_cast<int64_t>(
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +0200983 90000 / (std::min(static_cast<float>(codec_.maxFramerate),
984 framerate_controller_[sl_idx].GetTargetRate())));
Sergey Silkina85995a2018-10-02 10:28:10 +0200985 }
986 }
987
Sergey Silkin390f3582018-10-01 17:13:50 +0200988 vpx_codec_control(encoder_, VP9E_SET_SVC_REF_FRAME_CONFIG, &ref_config);
989 }
990
Sergey Silkin88ce4ef2018-11-23 13:59:24 +0100991 first_frame_in_picture_ = true;
992
Sergey Silkin96f2c972018-09-05 21:07:17 +0200993 // TODO(ssilkin): Frame duration should be specified per spatial layer
994 // since their frame rate can be different. For now calculate frame duration
995 // based on target frame rate of the highest spatial layer, which frame rate
996 // is supposed to be equal or higher than frame rate of low spatial layers.
997 // Also, timestamp should represent actual time passed since previous frame
998 // (not 'expected' time). Then rate controller can drain buffer more
999 // accurately.
1000 RTC_DCHECK_GE(framerate_controller_.size(), num_active_spatial_layers_);
Sergey Silkinf87bb462018-09-17 09:37:37 +02001001 float target_framerate_fps =
1002 (codec_.mode == VideoCodecMode::kScreensharing)
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +02001003 ? std::min(static_cast<float>(codec_.maxFramerate),
1004 framerate_controller_[num_active_spatial_layers_ - 1]
1005 .GetTargetRate())
Sergey Silkinf87bb462018-09-17 09:37:37 +02001006 : codec_.maxFramerate;
1007 uint32_t duration = static_cast<uint32_t>(90000 / target_framerate_fps);
Emircan Uysaler0823eec2018-07-13 17:10:00 -07001008 const vpx_codec_err_t rv = vpx_codec_encode(encoder_, raw_, timestamp_,
1009 duration, flags, VPX_DL_REALTIME);
1010 if (rv != VPX_CODEC_OK) {
1011 RTC_LOG(LS_ERROR) << "Encoding error: " << vpx_codec_err_to_string(rv)
1012 << "\n"
1013 << "Details: " << vpx_codec_error(encoder_) << "\n"
1014 << vpx_codec_error_detail(encoder_);
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001015 return WEBRTC_VIDEO_CODEC_ERROR;
1016 }
1017 timestamp_ += duration;
asaperssona9455ab2015-07-31 06:10:09 -07001018
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001019 if (!full_superframe_drop_) {
1020 const bool end_of_picture = true;
1021 DeliverBufferedFrame(end_of_picture);
1022 }
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001023
asaperssona9455ab2015-07-31 06:10:09 -07001024 return WEBRTC_VIDEO_CODEC_OK;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001025}
1026
1027void VP9EncoderImpl::PopulateCodecSpecific(CodecSpecificInfo* codec_specific,
Niels Möllerd3b8c632018-08-27 15:33:42 +02001028 absl::optional<int>* spatial_idx,
philipelcce46fc2015-12-21 03:04:49 -08001029 const vpx_codec_cx_pkt& pkt,
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001030 uint32_t timestamp) {
sprang3958ed82017-08-17 08:12:10 -07001031 RTC_CHECK(codec_specific != nullptr);
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001032 codec_specific->codecType = kVideoCodecVP9;
philipelcce46fc2015-12-21 03:04:49 -08001033 CodecSpecificInfoVP9* vp9_info = &(codec_specific->codecSpecific.VP9);
Sergey Silkin07f80cc2018-04-09 13:11:59 +02001034
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001035 vp9_info->first_frame_in_picture = first_frame_in_picture_;
Sergey Silkin738b7e92018-08-23 16:37:27 +02001036 vp9_info->flexible_mode = is_flexible_mode_;
asaperssona9455ab2015-07-31 06:10:09 -07001037
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001038 if (pkt.data.frame.flags & VPX_FRAME_IS_KEY) {
1039 pics_since_key_ = 0;
1040 } else if (first_frame_in_picture_) {
1041 ++pics_since_key_;
1042 }
1043
asaperssona9455ab2015-07-31 06:10:09 -07001044 vpx_svc_layer_id_t layer_id = {0};
1045 vpx_codec_control(encoder_, VP9E_GET_SVC_LAYER_ID, &layer_id);
1046
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +01001047 // Can't have keyframe with non-zero temporal layer.
1048 RTC_DCHECK(pics_since_key_ != 0 || layer_id.temporal_layer_id == 0);
1049
sprang3958ed82017-08-17 08:12:10 -07001050 RTC_CHECK_GT(num_temporal_layers_, 0);
“Michael23c5a992018-06-21 11:07:21 -05001051 RTC_CHECK_GT(num_active_spatial_layers_, 0);
asaperssona9455ab2015-07-31 06:10:09 -07001052 if (num_temporal_layers_ == 1) {
sprang3958ed82017-08-17 08:12:10 -07001053 RTC_CHECK_EQ(layer_id.temporal_layer_id, 0);
asaperssona9455ab2015-07-31 06:10:09 -07001054 vp9_info->temporal_idx = kNoTemporalIdx;
1055 } else {
1056 vp9_info->temporal_idx = layer_id.temporal_layer_id;
1057 }
“Michael23c5a992018-06-21 11:07:21 -05001058 if (num_active_spatial_layers_ == 1) {
sprang3958ed82017-08-17 08:12:10 -07001059 RTC_CHECK_EQ(layer_id.spatial_layer_id, 0);
Niels Möllerd3b8c632018-08-27 15:33:42 +02001060 *spatial_idx = absl::nullopt;
asaperssona9455ab2015-07-31 06:10:09 -07001061 } else {
Niels Möllerd3b8c632018-08-27 15:33:42 +02001062 *spatial_idx = layer_id.spatial_layer_id;
asaperssona9455ab2015-07-31 06:10:09 -07001063 }
asaperssona9455ab2015-07-31 06:10:09 -07001064
asaperssona9455ab2015-07-31 06:10:09 -07001065 // TODO(asapersson): this info has to be obtained from the encoder.
asaperssoncb50c962015-11-18 01:58:55 -08001066 vp9_info->temporal_up_switch = false;
asaperssona9455ab2015-07-31 06:10:09 -07001067
Sergey Silkin6a8f30e2018-04-26 11:03:49 +02001068 const bool is_key_pic = (pics_since_key_ == 0);
1069 const bool is_inter_layer_pred_allowed =
1070 (inter_layer_pred_ == InterLayerPredMode::kOn ||
1071 (inter_layer_pred_ == InterLayerPredMode::kOnKeyPic && is_key_pic));
1072
1073 // Always set inter_layer_predicted to true on high layer frame if inter-layer
1074 // prediction (ILP) is allowed even if encoder didn't actually use it.
1075 // Setting inter_layer_predicted to false would allow receiver to decode high
1076 // layer frame without decoding low layer frame. If that would happen (e.g.
1077 // if low layer frame is lost) then receiver won't be able to decode next high
1078 // layer frame which uses ILP.
1079 vp9_info->inter_layer_predicted =
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001080 first_frame_in_picture_ ? false : is_inter_layer_pred_allowed;
Sergey Silkin6a8f30e2018-04-26 11:03:49 +02001081
Sergey Silkinc5f152d2018-09-26 13:28:50 +02001082 // Mark all low spatial layer frames as references (not just frames of
1083 // active low spatial layers) if inter-layer prediction is enabled since
1084 // these frames are indirect references of high spatial layer, which can
1085 // later be enabled without key frame.
Sergey Silkin6a8f30e2018-04-26 11:03:49 +02001086 vp9_info->non_ref_for_inter_layer_pred =
Sergey Silkinc5f152d2018-09-26 13:28:50 +02001087 !is_inter_layer_pred_allowed ||
1088 layer_id.spatial_layer_id + 1 == num_spatial_layers_;
asapersson00ac85e2015-11-11 05:30:48 -08001089
ivica7f6a6fc2015-09-08 02:40:29 -07001090 // Always populate this, so that the packetizer can properly set the marker
1091 // bit.
“Michael23c5a992018-06-21 11:07:21 -05001092 vp9_info->num_spatial_layers = num_active_spatial_layers_;
philipelcfc319b2015-11-10 07:17:23 -08001093
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001094 vp9_info->num_ref_pics = 0;
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +01001095 FillReferenceIndices(pkt, pics_since_key_, vp9_info->inter_layer_predicted,
1096 vp9_info);
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001097 if (vp9_info->flexible_mode) {
1098 vp9_info->gof_idx = kNoGofIdx;
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001099 } else {
1100 vp9_info->gof_idx =
1101 static_cast<uint8_t>(pics_since_key_ % gof_.num_frames_in_gof);
1102 vp9_info->temporal_up_switch = gof_.temporal_up_switch[vp9_info->gof_idx];
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +01001103 RTC_DCHECK(vp9_info->num_ref_pics == gof_.num_ref_pics[vp9_info->gof_idx] ||
1104 vp9_info->num_ref_pics == 0);
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001105 }
1106
1107 vp9_info->inter_pic_predicted = (!is_key_pic && vp9_info->num_ref_pics > 0);
1108
Sergey Silkina323cc02019-04-23 10:09:28 +02001109 // Write SS on key frame of independently coded spatial layers and on base
1110 // temporal/spatial layer frame if number of layers changed without issuing
1111 // of key picture (inter-layer prediction is enabled).
1112 const bool is_key_frame = is_key_pic && !vp9_info->inter_layer_predicted;
1113 if (is_key_frame || (ss_info_needed_ && layer_id.temporal_layer_id == 0 &&
1114 layer_id.spatial_layer_id == 0)) {
1115 vp9_info->ss_data_available = true;
asaperssona9455ab2015-07-31 06:10:09 -07001116 vp9_info->spatial_layer_resolution_present = true;
“Michael23c5a992018-06-21 11:07:21 -05001117 for (size_t i = 0; i < num_active_spatial_layers_; ++i) {
Yves Gerey665174f2018-06-19 15:03:05 +02001118 vp9_info->width[i] = codec_.width * svc_params_.scaling_factor_num[i] /
johannkoenig8225c402017-01-26 13:23:44 -08001119 svc_params_.scaling_factor_den[i];
Yves Gerey665174f2018-06-19 15:03:05 +02001120 vp9_info->height[i] = codec_.height * svc_params_.scaling_factor_num[i] /
johannkoenig8225c402017-01-26 13:23:44 -08001121 svc_params_.scaling_factor_den[i];
asaperssona9455ab2015-07-31 06:10:09 -07001122 }
Sergey Silkin738b7e92018-08-23 16:37:27 +02001123 if (vp9_info->flexible_mode) {
1124 vp9_info->gof.num_frames_in_gof = 0;
1125 } else {
asaperssona9455ab2015-07-31 06:10:09 -07001126 vp9_info->gof.CopyGofInfoVP9(gof_);
1127 }
Sergey Silkina323cc02019-04-23 10:09:28 +02001128
1129 ss_info_needed_ = false;
1130 } else {
1131 vp9_info->ss_data_available = false;
asaperssona9455ab2015-07-31 06:10:09 -07001132 }
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001133
1134 first_frame_in_picture_ = false;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001135}
1136
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001137void VP9EncoderImpl::FillReferenceIndices(const vpx_codec_cx_pkt& pkt,
1138 const size_t pic_num,
1139 const bool inter_layer_predicted,
1140 CodecSpecificInfoVP9* vp9_info) {
1141 vpx_svc_layer_id_t layer_id = {0};
1142 vpx_codec_control(encoder_, VP9E_GET_SVC_LAYER_ID, &layer_id);
1143
Sergey Silkin76be2952018-08-21 12:30:33 +02001144 const bool is_key_frame =
1145 (pkt.data.frame.flags & VPX_FRAME_IS_KEY) ? true : false;
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001146
1147 std::vector<RefFrameBuffer> ref_buf_list;
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001148
Sergey Silkin76be2952018-08-21 12:30:33 +02001149 if (is_svc_) {
1150 vpx_svc_ref_frame_config_t enc_layer_conf = {{0}};
1151 vpx_codec_control(encoder_, VP9E_GET_SVC_REF_FRAME_CONFIG, &enc_layer_conf);
Sergey Silkin38fabff2019-03-21 10:08:40 +01001152 int ref_buf_flags = 0;
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001153
Sergey Silkin76be2952018-08-21 12:30:33 +02001154 if (enc_layer_conf.reference_last[layer_id.spatial_layer_id]) {
1155 const size_t fb_idx =
1156 enc_layer_conf.lst_fb_idx[layer_id.spatial_layer_id];
1157 RTC_DCHECK(ref_buf_.find(fb_idx) != ref_buf_.end());
Sergey Silkin82276592018-08-27 14:54:20 +02001158 if (std::find(ref_buf_list.begin(), ref_buf_list.end(),
1159 ref_buf_.at(fb_idx)) == ref_buf_list.end()) {
1160 ref_buf_list.push_back(ref_buf_.at(fb_idx));
Sergey Silkin38fabff2019-03-21 10:08:40 +01001161 ref_buf_flags |= 1 << fb_idx;
Sergey Silkin82276592018-08-27 14:54:20 +02001162 }
Sergey Silkin76be2952018-08-21 12:30:33 +02001163 }
1164
1165 if (enc_layer_conf.reference_alt_ref[layer_id.spatial_layer_id]) {
1166 const size_t fb_idx =
1167 enc_layer_conf.alt_fb_idx[layer_id.spatial_layer_id];
1168 RTC_DCHECK(ref_buf_.find(fb_idx) != ref_buf_.end());
Sergey Silkin82276592018-08-27 14:54:20 +02001169 if (std::find(ref_buf_list.begin(), ref_buf_list.end(),
1170 ref_buf_.at(fb_idx)) == ref_buf_list.end()) {
1171 ref_buf_list.push_back(ref_buf_.at(fb_idx));
Sergey Silkin38fabff2019-03-21 10:08:40 +01001172 ref_buf_flags |= 1 << fb_idx;
Sergey Silkin82276592018-08-27 14:54:20 +02001173 }
Sergey Silkin76be2952018-08-21 12:30:33 +02001174 }
1175
1176 if (enc_layer_conf.reference_golden[layer_id.spatial_layer_id]) {
1177 const size_t fb_idx =
1178 enc_layer_conf.gld_fb_idx[layer_id.spatial_layer_id];
1179 RTC_DCHECK(ref_buf_.find(fb_idx) != ref_buf_.end());
Sergey Silkin82276592018-08-27 14:54:20 +02001180 if (std::find(ref_buf_list.begin(), ref_buf_list.end(),
1181 ref_buf_.at(fb_idx)) == ref_buf_list.end()) {
1182 ref_buf_list.push_back(ref_buf_.at(fb_idx));
Sergey Silkin38fabff2019-03-21 10:08:40 +01001183 ref_buf_flags |= 1 << fb_idx;
Sergey Silkin82276592018-08-27 14:54:20 +02001184 }
Sergey Silkin76be2952018-08-21 12:30:33 +02001185 }
Sergey Silkin38fabff2019-03-21 10:08:40 +01001186
1187 RTC_LOG(LS_VERBOSE) << "Frame " << pic_num << " sl "
1188 << layer_id.spatial_layer_id << " tl "
1189 << layer_id.temporal_layer_id << " refered buffers "
1190 << (ref_buf_flags & (1 << 0) ? 1 : 0)
1191 << (ref_buf_flags & (1 << 1) ? 1 : 0)
1192 << (ref_buf_flags & (1 << 2) ? 1 : 0)
1193 << (ref_buf_flags & (1 << 3) ? 1 : 0)
1194 << (ref_buf_flags & (1 << 4) ? 1 : 0)
1195 << (ref_buf_flags & (1 << 5) ? 1 : 0)
1196 << (ref_buf_flags & (1 << 6) ? 1 : 0)
1197 << (ref_buf_flags & (1 << 7) ? 1 : 0);
1198
Sergey Silkin76be2952018-08-21 12:30:33 +02001199 } else if (!is_key_frame) {
1200 RTC_DCHECK_EQ(num_spatial_layers_, 1);
1201 RTC_DCHECK_EQ(num_temporal_layers_, 1);
1202 // In non-SVC mode encoder doesn't provide reference list. Assume each frame
1203 // refers previous one, which is stored in buffer 0.
1204 ref_buf_list.push_back(ref_buf_.at(0));
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001205 }
1206
1207 size_t max_ref_temporal_layer_id = 0;
1208
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001209 std::vector<size_t> ref_pid_list;
1210
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001211 vp9_info->num_ref_pics = 0;
1212 for (const RefFrameBuffer& ref_buf : ref_buf_list) {
1213 RTC_DCHECK_LE(ref_buf.pic_num, pic_num);
1214 if (ref_buf.pic_num < pic_num) {
1215 if (inter_layer_pred_ != InterLayerPredMode::kOn) {
1216 // RTP spec limits temporal prediction to the same spatial layer.
1217 // It is safe to ignore this requirement if inter-layer prediction is
1218 // enabled for all frames when all base frames are relayed to receiver.
1219 RTC_DCHECK_EQ(ref_buf.spatial_layer_id, layer_id.spatial_layer_id);
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +02001220 } else {
1221 RTC_DCHECK_LE(ref_buf.spatial_layer_id, layer_id.spatial_layer_id);
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001222 }
1223 RTC_DCHECK_LE(ref_buf.temporal_layer_id, layer_id.temporal_layer_id);
1224
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001225 // Encoder may reference several spatial layers on the same previous
1226 // frame in case if some spatial layers are skipped on the current frame.
1227 // We shouldn't put duplicate references as it may break some old
1228 // clients and isn't RTP compatible.
1229 if (std::find(ref_pid_list.begin(), ref_pid_list.end(),
1230 ref_buf.pic_num) != ref_pid_list.end()) {
1231 continue;
1232 }
1233 ref_pid_list.push_back(ref_buf.pic_num);
1234
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001235 const size_t p_diff = pic_num - ref_buf.pic_num;
1236 RTC_DCHECK_LE(p_diff, 127UL);
1237
1238 vp9_info->p_diff[vp9_info->num_ref_pics] = static_cast<uint8_t>(p_diff);
1239 ++vp9_info->num_ref_pics;
1240
1241 max_ref_temporal_layer_id =
1242 std::max(max_ref_temporal_layer_id, ref_buf.temporal_layer_id);
1243 } else {
1244 RTC_DCHECK(inter_layer_predicted);
1245 // RTP spec only allows to use previous spatial layer for inter-layer
1246 // prediction.
1247 RTC_DCHECK_EQ(ref_buf.spatial_layer_id + 1, layer_id.spatial_layer_id);
1248 }
1249 }
1250
1251 vp9_info->temporal_up_switch =
1252 (max_ref_temporal_layer_id <
1253 static_cast<size_t>(layer_id.temporal_layer_id));
1254}
1255
1256void VP9EncoderImpl::UpdateReferenceBuffers(const vpx_codec_cx_pkt& pkt,
1257 const size_t pic_num) {
1258 vpx_svc_layer_id_t layer_id = {0};
1259 vpx_codec_control(encoder_, VP9E_GET_SVC_LAYER_ID, &layer_id);
1260
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001261 RefFrameBuffer frame_buf(pic_num, layer_id.spatial_layer_id,
1262 layer_id.temporal_layer_id);
1263
Sergey Silkin38fabff2019-03-21 10:08:40 +01001264 if (is_svc_) {
Sergey Silkin76be2952018-08-21 12:30:33 +02001265 vpx_svc_ref_frame_config_t enc_layer_conf = {{0}};
1266 vpx_codec_control(encoder_, VP9E_GET_SVC_REF_FRAME_CONFIG, &enc_layer_conf);
Sergey Silkin38fabff2019-03-21 10:08:40 +01001267 const int update_buffer_slot =
1268 enc_layer_conf.update_buffer_slot[layer_id.spatial_layer_id];
Sergey Silkin76be2952018-08-21 12:30:33 +02001269
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001270 for (size_t i = 0; i < kNumVp9Buffers; ++i) {
Sergey Silkin38fabff2019-03-21 10:08:40 +01001271 if (update_buffer_slot & (1 << i)) {
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001272 ref_buf_[i] = frame_buf;
1273 }
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001274 }
Sergey Silkin38fabff2019-03-21 10:08:40 +01001275
1276 RTC_LOG(LS_VERBOSE) << "Frame " << pic_num << " sl "
1277 << layer_id.spatial_layer_id << " tl "
1278 << layer_id.temporal_layer_id << " updated buffers "
1279 << (update_buffer_slot & (1 << 0) ? 1 : 0)
1280 << (update_buffer_slot & (1 << 1) ? 1 : 0)
1281 << (update_buffer_slot & (1 << 2) ? 1 : 0)
1282 << (update_buffer_slot & (1 << 3) ? 1 : 0)
1283 << (update_buffer_slot & (1 << 4) ? 1 : 0)
1284 << (update_buffer_slot & (1 << 5) ? 1 : 0)
1285 << (update_buffer_slot & (1 << 6) ? 1 : 0)
1286 << (update_buffer_slot & (1 << 7) ? 1 : 0);
Sergey Silkin76be2952018-08-21 12:30:33 +02001287 } else {
1288 RTC_DCHECK_EQ(num_spatial_layers_, 1);
1289 RTC_DCHECK_EQ(num_temporal_layers_, 1);
1290 // In non-svc mode encoder doesn't provide reference list. Assume each frame
1291 // is reference and stored in buffer 0.
1292 ref_buf_[0] = frame_buf;
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001293 }
1294}
1295
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001296vpx_svc_ref_frame_config_t VP9EncoderImpl::SetReferences(
1297 bool is_key_pic,
1298 size_t first_active_spatial_layer_id) {
Sergey Silkin390f3582018-10-01 17:13:50 +02001299 // kRefBufIdx, kUpdBufIdx need to be updated to support longer GOFs.
1300 RTC_DCHECK_LE(gof_.num_frames_in_gof, 4);
1301
1302 vpx_svc_ref_frame_config_t ref_config;
1303 memset(&ref_config, 0, sizeof(ref_config));
1304
1305 const size_t num_temporal_refs = std::max(1, num_temporal_layers_ - 1);
1306 const bool is_inter_layer_pred_allowed =
1307 inter_layer_pred_ == InterLayerPredMode::kOn ||
1308 (inter_layer_pred_ == InterLayerPredMode::kOnKeyPic && is_key_pic);
1309 absl::optional<int> last_updated_buf_idx;
1310
1311 // Put temporal reference to LAST and spatial reference to GOLDEN. Update
1312 // frame buffer (i.e. store encoded frame) if current frame is a temporal
1313 // reference (i.e. it belongs to a low temporal layer) or it is a spatial
1314 // reference. In later case, always store spatial reference in the last
1315 // reference frame buffer.
1316 // For the case of 3 temporal and 3 spatial layers we need 6 frame buffers
1317 // for temporal references plus 1 buffer for spatial reference. 7 buffers
1318 // in total.
1319
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001320 for (size_t sl_idx = first_active_spatial_layer_id;
1321 sl_idx < num_active_spatial_layers_; ++sl_idx) {
1322 const size_t curr_pic_num = is_key_pic ? 0 : pics_since_key_ + 1;
1323 const size_t gof_idx = curr_pic_num % gof_.num_frames_in_gof;
Sergey Silkin390f3582018-10-01 17:13:50 +02001324
1325 if (!is_key_pic) {
1326 // Set up temporal reference.
1327 const int buf_idx = sl_idx * num_temporal_refs + kRefBufIdx[gof_idx];
1328
1329 // Last reference frame buffer is reserved for spatial reference. It is
1330 // not supposed to be used for temporal prediction.
1331 RTC_DCHECK_LT(buf_idx, kNumVp9Buffers - 1);
1332
1333 // Sanity check that reference picture number is smaller than current
1334 // picture number.
Sergey Silkin390f3582018-10-01 17:13:50 +02001335 RTC_DCHECK_LT(ref_buf_[buf_idx].pic_num, curr_pic_num);
1336 const size_t pid_diff = curr_pic_num - ref_buf_[buf_idx].pic_num;
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001337 // Incorrect spatial layer may be in the buffer due to a key-frame.
1338 const bool same_spatial_layer =
1339 ref_buf_[buf_idx].spatial_layer_id == sl_idx;
1340 bool correct_pid = false;
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +02001341 if (is_flexible_mode_) {
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001342 correct_pid = pid_diff < kMaxAllowedPidDIff;
1343 } else {
1344 // Below code assumes single temporal referecence.
1345 RTC_DCHECK_EQ(gof_.num_ref_pics[gof_idx], 1);
1346 correct_pid = pid_diff == gof_.pid_diff[gof_idx][0];
1347 }
Sergey Silkin390f3582018-10-01 17:13:50 +02001348
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001349 if (same_spatial_layer && correct_pid) {
Sergey Silkin390f3582018-10-01 17:13:50 +02001350 ref_config.lst_fb_idx[sl_idx] = buf_idx;
1351 ref_config.reference_last[sl_idx] = 1;
1352 } else {
1353 // This reference doesn't match with one specified by GOF. This can
1354 // only happen if spatial layer is enabled dynamically without key
1355 // frame. Spatial prediction is supposed to be enabled in this case.
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001356 RTC_DCHECK(is_inter_layer_pred_allowed &&
1357 sl_idx > first_active_spatial_layer_id);
Sergey Silkin390f3582018-10-01 17:13:50 +02001358 }
1359 }
1360
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001361 if (is_inter_layer_pred_allowed && sl_idx > first_active_spatial_layer_id) {
Sergey Silkin390f3582018-10-01 17:13:50 +02001362 // Set up spatial reference.
1363 RTC_DCHECK(last_updated_buf_idx);
1364 ref_config.gld_fb_idx[sl_idx] = *last_updated_buf_idx;
1365 ref_config.reference_golden[sl_idx] = 1;
1366 } else {
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001367 RTC_DCHECK(ref_config.reference_last[sl_idx] != 0 ||
1368 sl_idx == first_active_spatial_layer_id ||
Sergey Silkin390f3582018-10-01 17:13:50 +02001369 inter_layer_pred_ == InterLayerPredMode::kOff);
1370 }
1371
1372 last_updated_buf_idx.reset();
1373
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001374 if (gof_.temporal_idx[gof_idx] < num_temporal_layers_ - 1 ||
1375 num_temporal_layers_ == 1) {
Sergey Silkin390f3582018-10-01 17:13:50 +02001376 last_updated_buf_idx = sl_idx * num_temporal_refs + kUpdBufIdx[gof_idx];
1377
1378 // Ensure last frame buffer is not used for temporal prediction (it is
1379 // reserved for spatial reference).
1380 RTC_DCHECK_LT(*last_updated_buf_idx, kNumVp9Buffers - 1);
1381 } else if (is_inter_layer_pred_allowed) {
1382 last_updated_buf_idx = kNumVp9Buffers - 1;
1383 }
1384
1385 if (last_updated_buf_idx) {
1386 ref_config.update_buffer_slot[sl_idx] = 1 << *last_updated_buf_idx;
1387 }
1388 }
1389
1390 return ref_config;
1391}
1392
asaperssona9455ab2015-07-31 06:10:09 -07001393int VP9EncoderImpl::GetEncodedLayerFrame(const vpx_codec_cx_pkt* pkt) {
asapersson86956de2016-01-26 01:05:20 -08001394 RTC_DCHECK_EQ(pkt->kind, VPX_CODEC_CX_FRAME_PKT);
asaperssona9455ab2015-07-31 06:10:09 -07001395
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001396 if (pkt->data.frame.sz == 0) {
1397 // Ignore dropped frame.
1398 return WEBRTC_VIDEO_CODEC_OK;
1399 }
1400
Sergey Silkin07f80cc2018-04-09 13:11:59 +02001401 vpx_svc_layer_id_t layer_id = {0};
1402 vpx_codec_control(encoder_, VP9E_GET_SVC_LAYER_ID, &layer_id);
1403
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001404 if (!full_superframe_drop_) {
1405 // Deliver buffered low spatial layer frame.
1406 const bool end_of_picture = false;
1407 DeliverBufferedFrame(end_of_picture);
1408 }
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001409
Niels Möller4d504c72019-06-18 15:56:56 +02001410 // TODO(nisse): Introduce some buffer cache or buffer pool, to reduce
1411 // allocations and/or copy operations.
1412 encoded_image_.SetEncodedData(EncodedImageBuffer::Create(
1413 static_cast<const uint8_t*>(pkt->data.frame.buf), pkt->data.frame.sz));
asaperssond9f641e2016-01-21 01:11:35 -08001414
Sergey Silkinbd0954e2018-05-03 14:14:09 +02001415 const bool is_key_frame =
1416 (pkt->data.frame.flags & VPX_FRAME_IS_KEY) ? true : false;
1417 // Ensure encoder issued key frame on request.
1418 RTC_DCHECK(is_key_frame || !force_key_frame_);
1419
asaperssona9455ab2015-07-31 06:10:09 -07001420 // Check if encoded frame is a key frame.
Niels Möller8f7ce222019-03-21 15:43:58 +01001421 encoded_image_._frameType = VideoFrameType::kVideoFrameDelta;
Sergey Silkinbd0954e2018-05-03 14:14:09 +02001422 if (is_key_frame) {
Niels Möller8f7ce222019-03-21 15:43:58 +01001423 encoded_image_._frameType = VideoFrameType::kVideoFrameKey;
Sergey Silkinbd0954e2018-05-03 14:14:09 +02001424 force_key_frame_ = false;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001425 }
Niels Möller77536a22019-01-15 08:50:01 +01001426 RTC_DCHECK_LE(encoded_image_.size(), encoded_image_.capacity());
asapersson86956de2016-01-26 01:05:20 -08001427
philipeld1d03592019-03-01 13:53:55 +01001428 codec_specific_ = {};
Niels Möllerd3b8c632018-08-27 15:33:42 +02001429 absl::optional<int> spatial_index;
1430 PopulateCodecSpecific(&codec_specific_, &spatial_index, *pkt,
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001431 input_image_->timestamp());
Niels Möllerd3b8c632018-08-27 15:33:42 +02001432 encoded_image_.SetSpatialIndex(spatial_index);
asaperssona9455ab2015-07-31 06:10:09 -07001433
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +01001434 UpdateReferenceBuffers(*pkt, pics_since_key_);
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001435
Niels Möller77536a22019-01-15 08:50:01 +01001436 TRACE_COUNTER1("webrtc", "EncodedFrameSize", encoded_image_.size());
Niels Möller23775882018-08-16 10:24:12 +02001437 encoded_image_.SetTimestamp(input_image_->timestamp());
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001438 encoded_image_._encodedHeight =
1439 pkt->data.frame.height[layer_id.spatial_layer_id];
1440 encoded_image_._encodedWidth =
1441 pkt->data.frame.width[layer_id.spatial_layer_id];
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001442 int qp = -1;
1443 vpx_codec_control(encoder_, VP8E_GET_LAST_QUANTIZER, &qp);
1444 encoded_image_.qp_ = qp;
ilnik04f4d122017-06-19 07:18:55 -07001445
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001446 if (full_superframe_drop_) {
1447 const bool end_of_picture = encoded_image_.SpatialIndex().value_or(0) + 1 ==
1448 num_active_spatial_layers_;
1449 DeliverBufferedFrame(end_of_picture);
1450 }
1451
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001452 return WEBRTC_VIDEO_CODEC_OK;
1453}
1454
Sergey Silkinbc0f0d32018-04-24 21:29:14 +02001455void VP9EncoderImpl::DeliverBufferedFrame(bool end_of_picture) {
Niels Möller77536a22019-01-15 08:50:01 +01001456 if (encoded_image_.size() > 0) {
Ilya Nikolaevskiy039a7142019-05-24 16:50:00 +02001457 if (num_spatial_layers_ > 1) {
1458 // Restore frame dropping settings, as dropping may be temporary forbidden
1459 // due to dynamically enabled layers.
1460 svc_drop_frame_.framedrop_thresh[0] = config_->rc_dropframe_thresh;
1461 for (size_t i = 1; i < num_spatial_layers_; ++i) {
1462 svc_drop_frame_.framedrop_thresh[i] =
1463 dropping_only_base_layer_ ? 0 : config_->rc_dropframe_thresh;
1464 }
1465 }
1466
Sergey Silkinbc0f0d32018-04-24 21:29:14 +02001467 codec_specific_.codecSpecific.VP9.end_of_picture = end_of_picture;
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001468
1469 // No data partitioning in VP9, so 1 partition only.
1470 int part_idx = 0;
1471 RTPFragmentationHeader frag_info;
1472 frag_info.VerifyAndAllocateFragmentationHeader(1);
1473 frag_info.fragmentationOffset[part_idx] = 0;
Niels Möller77536a22019-01-15 08:50:01 +01001474 frag_info.fragmentationLength[part_idx] = encoded_image_.size();
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001475
1476 encoded_complete_callback_->OnEncodedImage(encoded_image_, &codec_specific_,
1477 &frag_info);
Sergey Silkind902d582018-05-18 17:31:19 +02001478
Sergey Silkin96f2c972018-09-05 21:07:17 +02001479 if (codec_.mode == VideoCodecMode::kScreensharing) {
1480 const uint8_t spatial_idx = encoded_image_.SpatialIndex().value_or(0);
1481 const uint32_t frame_timestamp_ms =
Niels Möller23775882018-08-16 10:24:12 +02001482 1000 * encoded_image_.Timestamp() / kVideoPayloadTypeFrequency;
Sergey Silkin96f2c972018-09-05 21:07:17 +02001483 framerate_controller_[spatial_idx].AddFrame(frame_timestamp_ms);
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +01001484
1485 const size_t steady_state_size = SteadyStateSize(
1486 spatial_idx, codec_specific_.codecSpecific.VP9.temporal_idx);
1487
1488 // Only frames on spatial layers, which may be limited in a steady state
1489 // are considered for steady state detection.
1490 if (framerate_controller_[spatial_idx].GetTargetRate() >
1491 variable_framerate_experiment_.framerate_limit + 1e-9) {
1492 if (encoded_image_.qp_ <=
1493 variable_framerate_experiment_.steady_state_qp &&
1494 encoded_image_.size() <= steady_state_size) {
1495 ++num_steady_state_frames_;
1496 } else {
1497 num_steady_state_frames_ = 0;
1498 }
1499 }
Sergey Silkind902d582018-05-18 17:31:19 +02001500 }
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +01001501 encoded_image_.set_size(0);
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001502 }
1503}
1504
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001505int VP9EncoderImpl::RegisterEncodeCompleteCallback(
1506 EncodedImageCallback* callback) {
1507 encoded_complete_callback_ = callback;
1508 return WEBRTC_VIDEO_CODEC_OK;
1509}
1510
Erik Språng727d1642018-11-07 16:54:15 +01001511VideoEncoder::EncoderInfo VP9EncoderImpl::GetEncoderInfo() const {
1512 EncoderInfo info;
1513 info.supports_native_handle = false;
1514 info.implementation_name = "libvpx";
1515 info.scaling_settings = VideoEncoder::ScalingSettings::kOff;
Erik Språngd3438aa2018-11-08 16:56:43 +01001516 info.has_trusted_rate_controller = trusted_rate_controller_;
Mirta Dvornicic897a9912018-11-30 13:12:21 +01001517 info.is_hardware_accelerated = false;
1518 info.has_internal_source = false;
Erik Språngdbdd8392019-01-17 15:27:50 +01001519 for (size_t si = 0; si < num_spatial_layers_; ++si) {
1520 info.fps_allocation[si].clear();
1521 if (!codec_.spatialLayers[si].active) {
1522 continue;
1523 }
1524 // This spatial layer may already use a fraction of the total frame rate.
1525 const float sl_fps_fraction =
1526 codec_.spatialLayers[si].maxFramerate / codec_.maxFramerate;
1527 for (size_t ti = 0; ti < num_temporal_layers_; ++ti) {
1528 const uint32_t decimator =
1529 num_temporal_layers_ <= 1 ? 1 : config_->ts_rate_decimator[ti];
1530 RTC_DCHECK_GT(decimator, 0);
1531 info.fps_allocation[si].push_back(rtc::saturated_cast<uint8_t>(
1532 EncoderInfo::kMaxFramerateFraction * (sl_fps_fraction / decimator)));
1533 }
1534 }
Erik Språng727d1642018-11-07 16:54:15 +01001535 return info;
Peter Boströmb7d9a972015-12-18 16:01:11 +01001536}
1537
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +01001538size_t VP9EncoderImpl::SteadyStateSize(int sid, int tid) {
1539 const size_t bitrate_bps = current_bitrate_allocation_.GetBitrate(
1540 sid, tid == kNoTemporalIdx ? 0 : tid);
1541 const float fps = (codec_.mode == VideoCodecMode::kScreensharing)
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +02001542 ? std::min(static_cast<float>(codec_.maxFramerate),
1543 framerate_controller_[sid].GetTargetRate())
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +01001544 : codec_.maxFramerate;
1545 return static_cast<size_t>(
1546 bitrate_bps / (8 * fps) *
1547 (100 -
1548 variable_framerate_experiment_.steady_state_undershoot_percentage) /
1549 100 +
1550 0.5);
1551}
1552
1553// static
1554VP9EncoderImpl::VariableFramerateExperiment
1555VP9EncoderImpl::ParseVariableFramerateConfig(std::string group_name) {
1556 FieldTrialFlag enabled = FieldTrialFlag("Enabled");
1557 FieldTrialParameter<double> framerate_limit("min_fps", 5.0);
1558 FieldTrialParameter<int> qp("min_qp", 32);
1559 FieldTrialParameter<int> undershoot_percentage("undershoot", 30);
1560 FieldTrialParameter<int> frames_before_steady_state(
1561 "frames_before_steady_state", 5);
1562 ParseFieldTrial({&enabled, &framerate_limit, &qp, &undershoot_percentage,
1563 &frames_before_steady_state},
1564 field_trial::FindFullName(group_name));
1565 VariableFramerateExperiment config;
1566 config.enabled = enabled.Get();
1567 config.framerate_limit = framerate_limit.Get();
1568 config.steady_state_qp = qp.Get();
1569 config.steady_state_undershoot_percentage = undershoot_percentage.Get();
1570 config.frames_before_steady_state = frames_before_steady_state.Get();
1571
1572 return config;
1573}
1574
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001575VP9DecoderImpl::VP9DecoderImpl()
sprang3958ed82017-08-17 08:12:10 -07001576 : decode_complete_callback_(nullptr),
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001577 inited_(false),
sprang3958ed82017-08-17 08:12:10 -07001578 decoder_(nullptr),
philipel9d7d75b2018-04-04 13:03:01 +02001579 key_frame_required_(true) {}
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001580
1581VP9DecoderImpl::~VP9DecoderImpl() {
1582 inited_ = true; // in order to do the actual release
1583 Release();
Henrik Boström9695d852015-05-06 10:42:15 +02001584 int num_buffers_in_use = frame_buffer_pool_.GetNumBuffersInUse();
1585 if (num_buffers_in_use > 0) {
1586 // The frame buffers are reference counted and frames are exposed after
1587 // decoding. There may be valid usage cases where previous frames are still
1588 // referenced after ~VP9DecoderImpl that is not a leak.
Mirko Bonadei675513b2017-11-09 11:09:25 +01001589 RTC_LOG(LS_INFO) << num_buffers_in_use << " Vp9FrameBuffers are still "
1590 << "referenced during ~VP9DecoderImpl.";
Henrik Boström9695d852015-05-06 10:42:15 +02001591 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001592}
1593
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001594int VP9DecoderImpl::InitDecode(const VideoCodec* inst, int number_of_cores) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001595 int ret_val = Release();
1596 if (ret_val < 0) {
1597 return ret_val;
1598 }
Sergey Silkinb674cd12018-10-09 10:59:06 +02001599
sprang3958ed82017-08-17 08:12:10 -07001600 if (decoder_ == nullptr) {
pbos@webrtc.orge728ee02014-12-17 13:43:55 +00001601 decoder_ = new vpx_codec_ctx_t;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001602 }
philipelcce46fc2015-12-21 03:04:49 -08001603 vpx_codec_dec_cfg_t cfg;
Sergey Silkinb674cd12018-10-09 10:59:06 +02001604 memset(&cfg, 0, sizeof(cfg));
1605
1606 // We want to use multithreading when decoding high resolution videos. But,
1607 // since we don't know resolution of input stream at this stage, we always
1608 // enable it.
1609 cfg.threads = std::min(number_of_cores, kMaxNumTiles4kVideo);
1610
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001611 vpx_codec_flags_t flags = 0;
1612 if (vpx_codec_dec_init(decoder_, vpx_codec_vp9_dx(), &cfg, flags)) {
1613 return WEBRTC_VIDEO_CODEC_MEMORY;
1614 }
Henrik Boström9695d852015-05-06 10:42:15 +02001615
1616 if (!frame_buffer_pool_.InitializeVpxUsePool(decoder_)) {
1617 return WEBRTC_VIDEO_CODEC_MEMORY;
1618 }
1619
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001620 inited_ = true;
1621 // Always start with a complete key frame.
1622 key_frame_required_ = true;
1623 return WEBRTC_VIDEO_CODEC_OK;
1624}
1625
1626int VP9DecoderImpl::Decode(const EncodedImage& input_image,
1627 bool missing_frames,
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001628 int64_t /*render_time_ms*/) {
1629 if (!inited_) {
1630 return WEBRTC_VIDEO_CODEC_UNINITIALIZED;
1631 }
sprang3958ed82017-08-17 08:12:10 -07001632 if (decode_complete_callback_ == nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001633 return WEBRTC_VIDEO_CODEC_UNINITIALIZED;
1634 }
1635 // Always start with a complete key frame.
1636 if (key_frame_required_) {
Niels Möller8f7ce222019-03-21 15:43:58 +01001637 if (input_image._frameType != VideoFrameType::kVideoFrameKey)
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001638 return WEBRTC_VIDEO_CODEC_ERROR;
1639 // We have a key frame - is it complete?
1640 if (input_image._completeFrame) {
1641 key_frame_required_ = false;
1642 } else {
1643 return WEBRTC_VIDEO_CODEC_ERROR;
1644 }
1645 }
sprang3958ed82017-08-17 08:12:10 -07001646 vpx_codec_iter_t iter = nullptr;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001647 vpx_image_t* img;
Niels Möller24871e42019-01-17 11:31:13 +01001648 const uint8_t* buffer = input_image.data();
Niels Möller77536a22019-01-15 08:50:01 +01001649 if (input_image.size() == 0) {
sprang3958ed82017-08-17 08:12:10 -07001650 buffer = nullptr; // Triggers full frame concealment.
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001651 }
Henrik Boström9695d852015-05-06 10:42:15 +02001652 // During decode libvpx may get and release buffers from |frame_buffer_pool_|.
1653 // In practice libvpx keeps a few (~3-4) buffers alive at a time.
philipelcce46fc2015-12-21 03:04:49 -08001654 if (vpx_codec_decode(decoder_, buffer,
Niels Möller77536a22019-01-15 08:50:01 +01001655 static_cast<unsigned int>(input_image.size()), 0,
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001656 VPX_DL_REALTIME)) {
1657 return WEBRTC_VIDEO_CODEC_ERROR;
1658 }
Henrik Boström9695d852015-05-06 10:42:15 +02001659 // |img->fb_priv| contains the image data, a reference counted Vp9FrameBuffer.
1660 // It may be released by libvpx during future vpx_codec_decode or
1661 // vpx_codec_destroy calls.
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001662 img = vpx_codec_get_frame(decoder_, &iter);
sakal7adadb12017-02-23 02:54:57 -08001663 int qp;
1664 vpx_codec_err_t vpx_ret =
1665 vpx_codec_control(decoder_, VPXD_GET_LAST_QUANTIZER, &qp);
1666 RTC_DCHECK_EQ(vpx_ret, VPX_CODEC_OK);
Ilya Nikolaevskiya0e26092019-07-12 11:20:47 +02001667 int ret =
1668 ReturnFrame(img, input_image.Timestamp(), qp, input_image.ColorSpace());
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001669 if (ret != 0) {
1670 return ret;
1671 }
1672 return WEBRTC_VIDEO_CODEC_OK;
1673}
1674
Ilya Nikolaevskiya0e26092019-07-12 11:20:47 +02001675int VP9DecoderImpl::ReturnFrame(
1676 const vpx_image_t* img,
1677 uint32_t timestamp,
1678 int qp,
1679 const webrtc::ColorSpace* explicit_color_space) {
sprang3958ed82017-08-17 08:12:10 -07001680 if (img == nullptr) {
1681 // Decoder OK and nullptr image => No show frame.
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001682 return WEBRTC_VIDEO_CODEC_NO_OUTPUT;
1683 }
Henrik Boström9695d852015-05-06 10:42:15 +02001684
1685 // This buffer contains all of |img|'s image data, a reference counted
perkj14f41442015-11-30 22:15:45 -08001686 // Vp9FrameBuffer. (libvpx is done with the buffers after a few
Henrik Boström9695d852015-05-06 10:42:15 +02001687 // vpx_codec_decode calls or vpx_codec_destroy).
1688 Vp9FrameBufferPool::Vp9FrameBuffer* img_buffer =
1689 static_cast<Vp9FrameBufferPool::Vp9FrameBuffer*>(img->fb_priv);
Emircan Uysaler0823eec2018-07-13 17:10:00 -07001690
Miguel Casas-Sanchez47650702015-05-29 17:21:40 -07001691 // The buffer can be used directly by the VideoFrame (without copy) by
Emircan Uysaler0823eec2018-07-13 17:10:00 -07001692 // using a Wrapped*Buffer.
1693 rtc::scoped_refptr<VideoFrameBuffer> img_wrapped_buffer;
1694 switch (img->bit_depth) {
1695 case 8:
1696 img_wrapped_buffer = WrapI420Buffer(
philipelcce46fc2015-12-21 03:04:49 -08001697 img->d_w, img->d_h, img->planes[VPX_PLANE_Y],
1698 img->stride[VPX_PLANE_Y], img->planes[VPX_PLANE_U],
1699 img->stride[VPX_PLANE_U], img->planes[VPX_PLANE_V],
1700 img->stride[VPX_PLANE_V],
Henrik Boström9695d852015-05-06 10:42:15 +02001701 // WrappedI420Buffer's mechanism for allowing the release of its frame
1702 // buffer is through a callback function. This is where we should
1703 // release |img_buffer|.
Emircan Uysaler0823eec2018-07-13 17:10:00 -07001704 rtc::KeepRefUntilDone(img_buffer));
1705 break;
1706 case 10:
1707 img_wrapped_buffer = WrapI010Buffer(
1708 img->d_w, img->d_h,
1709 reinterpret_cast<const uint16_t*>(img->planes[VPX_PLANE_Y]),
1710 img->stride[VPX_PLANE_Y] / 2,
1711 reinterpret_cast<const uint16_t*>(img->planes[VPX_PLANE_U]),
1712 img->stride[VPX_PLANE_U] / 2,
1713 reinterpret_cast<const uint16_t*>(img->planes[VPX_PLANE_V]),
1714 img->stride[VPX_PLANE_V] / 2, rtc::KeepRefUntilDone(img_buffer));
1715 break;
1716 default:
1717 RTC_NOTREACHED();
1718 return WEBRTC_VIDEO_CODEC_NO_OUTPUT;
1719 }
nisseca6d5d12016-06-17 05:03:04 -07001720
Johannes Kron4749e4e2018-11-21 10:18:18 +01001721 auto builder = VideoFrame::Builder()
1722 .set_video_frame_buffer(img_wrapped_buffer)
Ilya Nikolaevskiya0e26092019-07-12 11:20:47 +02001723 .set_timestamp_rtp(timestamp);
1724 if (explicit_color_space) {
1725 builder.set_color_space(*explicit_color_space);
1726 } else {
1727 builder.set_color_space(
1728 ExtractVP9ColorSpace(img->cs, img->range, img->bit_depth));
1729 }
Johannes Kron4749e4e2018-11-21 10:18:18 +01001730 VideoFrame decoded_image = builder.build();
1731
Danil Chapovalov0040b662018-06-18 10:48:16 +02001732 decode_complete_callback_->Decoded(decoded_image, absl::nullopt, qp);
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001733 return WEBRTC_VIDEO_CODEC_OK;
1734}
1735
1736int VP9DecoderImpl::RegisterDecodeCompleteCallback(
1737 DecodedImageCallback* callback) {
1738 decode_complete_callback_ = callback;
1739 return WEBRTC_VIDEO_CODEC_OK;
1740}
1741
1742int VP9DecoderImpl::Release() {
Sergey Silkin3e871ea2018-03-02 13:11:04 +01001743 int ret_val = WEBRTC_VIDEO_CODEC_OK;
1744
sprang3958ed82017-08-17 08:12:10 -07001745 if (decoder_ != nullptr) {
Sergey Silkin90399692018-03-02 14:44:10 +01001746 if (inited_) {
1747 // When a codec is destroyed libvpx will release any buffers of
1748 // |frame_buffer_pool_| it is currently using.
1749 if (vpx_codec_destroy(decoder_)) {
1750 ret_val = WEBRTC_VIDEO_CODEC_MEMORY;
1751 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001752 }
1753 delete decoder_;
sprang3958ed82017-08-17 08:12:10 -07001754 decoder_ = nullptr;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001755 }
Henrik Boström9695d852015-05-06 10:42:15 +02001756 // Releases buffers from the pool. Any buffers not in use are deleted. Buffers
1757 // still referenced externally are deleted once fully released, not returning
1758 // to the pool.
1759 frame_buffer_pool_.ClearPool();
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001760 inited_ = false;
Sergey Silkin3e871ea2018-03-02 13:11:04 +01001761 return ret_val;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001762}
Peter Boströmb7d9a972015-12-18 16:01:11 +01001763
1764const char* VP9DecoderImpl::ImplementationName() const {
1765 return "libvpx";
1766}
1767
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001768} // namespace webrtc
Mirko Bonadei95adedb2018-11-19 09:52:37 +01001769
1770#endif // RTC_ENABLE_VP9