blob: e259a44555e8e8bb22f2dc8b05fd9bb6af157b0b [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
marpan@webrtc.org5b883172014-11-01 06:10:48 +000020#include "vpx/vp8cx.h"
21#include "vpx/vp8dx.h"
Yves Gerey665174f2018-06-19 15:03:05 +020022#include "vpx/vpx_decoder.h"
23#include "vpx/vpx_encoder.h"
marpan@webrtc.org5b883172014-11-01 06:10:48 +000024
Karl Wiberg918f50c2018-07-05 11:40:33 +020025#include "absl/memory/memory.h"
Emircan Uysaler800787f2018-07-16 10:01:49 -070026#include "api/video/color_space.h"
Emircan Uysaler0823eec2018-07-13 17:10:00 -070027#include "api/video/i010_buffer.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020028#include "common_video/include/video_frame_buffer.h"
29#include "common_video/libyuv/include/webrtc_libyuv.h"
Sergey Silkind902d582018-05-18 17:31:19 +020030#include "modules/rtp_rtcp/include/rtp_rtcp_defines.h"
Sergey Silkin86684962018-03-28 19:32:37 +020031#include "modules/video_coding/codecs/vp9/svc_rate_allocator.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020032#include "rtc_base/checks.h"
Erik Språng4b4266f2019-01-23 12:48:13 +010033#include "rtc_base/experiments/rate_control_settings.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020034#include "rtc_base/keep_ref_until_done.h"
35#include "rtc_base/logging.h"
Steve Anton10542f22019-01-11 09:11:00 -080036#include "rtc_base/time_utils.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020037#include "rtc_base/trace_event.h"
Sergey Silkin390f3582018-10-01 17:13:50 +020038#include "system_wrappers/include/field_trial.h"
marpan@webrtc.org5b883172014-11-01 06:10:48 +000039
40namespace webrtc {
41
Sergey Silkind902d582018-05-18 17:31:19 +020042namespace {
Sergey Silkin390f3582018-10-01 17:13:50 +020043// Maps from gof_idx to encoder internal reference frame buffer index. These
44// maps work for 1,2 and 3 temporal layers with GOF length of 1,2 and 4 frames.
45uint8_t kRefBufIdx[4] = {0, 0, 0, 1};
46uint8_t kUpdBufIdx[4] = {0, 0, 1, 0};
47
Sergey Silkinb674cd12018-10-09 10:59:06 +020048int kMaxNumTiles4kVideo = 8;
49
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +010050// Maximum allowed PID difference for differnet per-layer frame-rate case.
Ilya Nikolaevskiy3a656d12019-02-14 14:44:22 +010051const int kMaxAllowedPidDIff = 30;
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +010052
Erik Språng7a3fe892019-04-15 12:22:55 +020053constexpr double kLowRateFactor = 1.0;
54constexpr double kHighRateFactor = 2.0;
55
56// These settings correspond to the settings in vpx_codec_enc_cfg.
57struct Vp8RateSettings {
58 uint32_t rc_undershoot_pct;
59 uint32_t rc_overshoot_pct;
60 uint32_t rc_buf_sz;
61 uint32_t rc_buf_optimal_sz;
62 uint32_t rc_dropframe_thresh;
63};
64
Marco6e89b252015-07-07 14:40:38 -070065// Only positive speeds, range for real-time coding currently is: 5 - 8.
66// Lower means slower/better quality, higher means fastest/lower quality.
67int GetCpuSpeed(int width, int height) {
Alex Glaznevfecb7c32016-03-31 14:23:27 -070068#if defined(WEBRTC_ARCH_ARM) || defined(WEBRTC_ARCH_ARM64) || defined(ANDROID)
Marco002f0d02015-12-17 09:49:31 -080069 return 8;
70#else
Marco6e89b252015-07-07 14:40:38 -070071 // For smaller resolutions, use lower speed setting (get some coding gain at
72 // the cost of increased encoding complexity).
73 if (width * height <= 352 * 288)
74 return 5;
75 else
76 return 7;
Marco002f0d02015-12-17 09:49:31 -080077#endif
Marco6e89b252015-07-07 14:40:38 -070078}
Emircan Uysaler715cc232018-07-23 17:50:43 -070079// Helper class for extracting VP9 colorspace.
80ColorSpace ExtractVP9ColorSpace(vpx_color_space_t space_t,
81 vpx_color_range_t range_t,
82 unsigned int bit_depth) {
Johannes Kronb47ccc32018-12-07 11:12:44 +010083 ColorSpace::PrimaryID primaries = ColorSpace::PrimaryID::kUnspecified;
84 ColorSpace::TransferID transfer = ColorSpace::TransferID::kUnspecified;
85 ColorSpace::MatrixID matrix = ColorSpace::MatrixID::kUnspecified;
Emircan Uysaler715cc232018-07-23 17:50:43 -070086 switch (space_t) {
87 case VPX_CS_BT_601:
88 case VPX_CS_SMPTE_170:
89 primaries = ColorSpace::PrimaryID::kSMPTE170M;
90 transfer = ColorSpace::TransferID::kSMPTE170M;
91 matrix = ColorSpace::MatrixID::kSMPTE170M;
92 break;
93 case VPX_CS_SMPTE_240:
94 primaries = ColorSpace::PrimaryID::kSMPTE240M;
95 transfer = ColorSpace::TransferID::kSMPTE240M;
96 matrix = ColorSpace::MatrixID::kSMPTE240M;
97 break;
98 case VPX_CS_BT_709:
99 primaries = ColorSpace::PrimaryID::kBT709;
100 transfer = ColorSpace::TransferID::kBT709;
101 matrix = ColorSpace::MatrixID::kBT709;
102 break;
103 case VPX_CS_BT_2020:
104 primaries = ColorSpace::PrimaryID::kBT2020;
105 switch (bit_depth) {
106 case 8:
107 transfer = ColorSpace::TransferID::kBT709;
108 break;
109 case 10:
110 transfer = ColorSpace::TransferID::kBT2020_10;
111 break;
112 default:
113 RTC_NOTREACHED();
114 break;
115 }
116 matrix = ColorSpace::MatrixID::kBT2020_NCL;
117 break;
118 case VPX_CS_SRGB:
119 primaries = ColorSpace::PrimaryID::kBT709;
120 transfer = ColorSpace::TransferID::kIEC61966_2_1;
121 matrix = ColorSpace::MatrixID::kBT709;
122 break;
123 default:
124 break;
125 }
126
127 ColorSpace::RangeID range = ColorSpace::RangeID::kInvalid;
128 switch (range_t) {
129 case VPX_CR_STUDIO_RANGE:
130 range = ColorSpace::RangeID::kLimited;
131 break;
132 case VPX_CR_FULL_RANGE:
133 range = ColorSpace::RangeID::kFull;
134 break;
135 default:
136 break;
137 }
138 return ColorSpace(primaries, transfer, matrix, range);
139}
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100140
141bool MoreLayersEnabled(const VideoBitrateAllocation& first,
142 const VideoBitrateAllocation& second) {
143 for (size_t sl_idx = 0; sl_idx < kMaxSpatialLayers; ++sl_idx) {
144 if (first.GetSpatialLayerSum(sl_idx) > 0 &&
145 second.GetSpatialLayerSum(sl_idx) == 0) {
146 return true;
147 }
148 }
149 return false;
150}
151
Erik Språng7a3fe892019-04-15 12:22:55 +0200152uint32_t Interpolate(uint32_t low,
153 uint32_t high,
154 double bandwidth_headroom_factor) {
155 RTC_DCHECK_GE(bandwidth_headroom_factor, kLowRateFactor);
156 RTC_DCHECK_LE(bandwidth_headroom_factor, kHighRateFactor);
157
158 // |factor| is between 0.0 and 1.0.
159 const double factor = bandwidth_headroom_factor - kLowRateFactor;
160
161 return static_cast<uint32_t>(((1.0 - factor) * low) + (factor * high) + 0.5);
162}
163
164Vp8RateSettings GetRateSettings(double bandwidth_headroom_factor) {
165 static const Vp8RateSettings low_settings{1000u, 0u, 100u, 30u, 40u};
166 static const Vp8RateSettings high_settings{100u, 15u, 1000u, 600u, 5u};
167
168 if (bandwidth_headroom_factor <= kLowRateFactor) {
169 return low_settings;
170 } else if (bandwidth_headroom_factor >= kHighRateFactor) {
171 return high_settings;
172 }
173
174 Vp8RateSettings settings;
175 settings.rc_undershoot_pct =
176 Interpolate(low_settings.rc_undershoot_pct,
177 high_settings.rc_undershoot_pct, bandwidth_headroom_factor);
178 settings.rc_overshoot_pct =
179 Interpolate(low_settings.rc_overshoot_pct, high_settings.rc_overshoot_pct,
180 bandwidth_headroom_factor);
181 settings.rc_buf_sz =
182 Interpolate(low_settings.rc_buf_sz, high_settings.rc_buf_sz,
183 bandwidth_headroom_factor);
184 settings.rc_buf_optimal_sz =
185 Interpolate(low_settings.rc_buf_optimal_sz,
186 high_settings.rc_buf_optimal_sz, bandwidth_headroom_factor);
187 settings.rc_dropframe_thresh =
188 Interpolate(low_settings.rc_dropframe_thresh,
189 high_settings.rc_dropframe_thresh, bandwidth_headroom_factor);
190 return settings;
191}
192
193void UpdateRateSettings(vpx_codec_enc_cfg_t* config,
194 const Vp8RateSettings& new_settings) {
195 config->rc_undershoot_pct = new_settings.rc_undershoot_pct;
196 config->rc_overshoot_pct = new_settings.rc_overshoot_pct;
197 config->rc_buf_sz = new_settings.rc_buf_sz;
198 config->rc_buf_optimal_sz = new_settings.rc_buf_optimal_sz;
199 config->rc_dropframe_thresh = new_settings.rc_dropframe_thresh;
200}
201
Emircan Uysaler715cc232018-07-23 17:50:43 -0700202} // namespace
Marco6e89b252015-07-07 14:40:38 -0700203
asaperssona9455ab2015-07-31 06:10:09 -0700204void VP9EncoderImpl::EncoderOutputCodedPacketCallback(vpx_codec_cx_pkt* pkt,
205 void* user_data) {
philipelcce46fc2015-12-21 03:04:49 -0800206 VP9EncoderImpl* enc = static_cast<VP9EncoderImpl*>(user_data);
asaperssona9455ab2015-07-31 06:10:09 -0700207 enc->GetEncodedLayerFrame(pkt);
208}
209
Emircan Uysaler98badbc2018-06-28 10:59:02 -0700210VP9EncoderImpl::VP9EncoderImpl(const cricket::VideoCodec& codec)
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000211 : encoded_image_(),
sprang3958ed82017-08-17 08:12:10 -0700212 encoded_complete_callback_(nullptr),
Emircan Uysaler98badbc2018-06-28 10:59:02 -0700213 profile_(
214 ParseSdpForVP9Profile(codec.params).value_or(VP9Profile::kProfile0)),
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000215 inited_(false),
216 timestamp_(0),
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000217 cpu_speed_(3),
218 rc_max_intra_target_(0),
sprang3958ed82017-08-17 08:12:10 -0700219 encoder_(nullptr),
220 config_(nullptr),
221 raw_(nullptr),
222 input_image_(nullptr),
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200223 force_key_frame_(true),
Sergey Silkin6a8f30e2018-04-26 11:03:49 +0200224 pics_since_key_(0),
asaperssona9455ab2015-07-31 06:10:09 -0700225 num_temporal_layers_(0),
philipelcfc319b2015-11-10 07:17:23 -0800226 num_spatial_layers_(0),
Sergey Silkin390f3582018-10-01 17:13:50 +0200227 num_active_spatial_layers_(0),
Erik Språngd3438aa2018-11-08 16:56:43 +0100228 layer_deactivation_requires_key_frame_(
229 field_trial::IsEnabled("WebRTC-Vp9IssueKeyFrameOnLayerDeactivation")),
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200230 is_svc_(false),
Sergey Silkin6a8f30e2018-04-26 11:03:49 +0200231 inter_layer_pred_(InterLayerPredMode::kOn),
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100232 external_ref_control_(false), // Set in InitEncode because of tests.
Erik Språng4b4266f2019-01-23 12:48:13 +0100233 trusted_rate_controller_(RateControlSettings::ParseFromFieldTrials()
234 .LibvpxVp9TrustedRateController()),
Erik Språng7a3fe892019-04-15 12:22:55 +0200235 dynamic_rate_settings_(
236 RateControlSettings::ParseFromFieldTrials().Vp9DynamicRateSettings()),
Sergey Silkin88ce4ef2018-11-23 13:59:24 +0100237 full_superframe_drop_(true),
238 first_frame_in_picture_(true),
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100239 ss_info_needed_(false),
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +0100240 is_flexible_mode_(false),
241 variable_framerate_experiment_(ParseVariableFramerateConfig(
242 "WebRTC-VP9VariableFramerateScreenshare")),
243 variable_framerate_controller_(
244 variable_framerate_experiment_.framerate_limit),
245 num_steady_state_frames_(0) {
philipeld1d03592019-03-01 13:53:55 +0100246 codec_ = {};
johannkoenig8225c402017-01-26 13:23:44 -0800247 memset(&svc_params_, 0, sizeof(vpx_svc_extra_cfg_t));
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000248}
249
250VP9EncoderImpl::~VP9EncoderImpl() {
251 Release();
252}
253
254int VP9EncoderImpl::Release() {
Sergey Silkin3e871ea2018-03-02 13:11:04 +0100255 int ret_val = WEBRTC_VIDEO_CODEC_OK;
256
Niels Möllerdd1cc982019-02-07 18:52:50 +0100257 encoded_image_.Allocate(0);
sprang3958ed82017-08-17 08:12:10 -0700258 if (encoder_ != nullptr) {
Sergey Silkin90399692018-03-02 14:44:10 +0100259 if (inited_) {
260 if (vpx_codec_destroy(encoder_)) {
261 ret_val = WEBRTC_VIDEO_CODEC_MEMORY;
262 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000263 }
264 delete encoder_;
sprang3958ed82017-08-17 08:12:10 -0700265 encoder_ = nullptr;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000266 }
sprang3958ed82017-08-17 08:12:10 -0700267 if (config_ != nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000268 delete config_;
sprang3958ed82017-08-17 08:12:10 -0700269 config_ = nullptr;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000270 }
sprang3958ed82017-08-17 08:12:10 -0700271 if (raw_ != nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000272 vpx_img_free(raw_);
sprang3958ed82017-08-17 08:12:10 -0700273 raw_ = nullptr;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000274 }
275 inited_ = false;
Sergey Silkin3e871ea2018-03-02 13:11:04 +0100276 return ret_val;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000277}
278
sprangce4aef12015-11-02 07:23:20 -0800279bool VP9EncoderImpl::ExplicitlyConfiguredSpatialLayers() const {
280 // We check target_bitrate_bps of the 0th layer to see if the spatial layers
281 // (i.e. bitrates) were explicitly configured.
Sergey Silkinbeba1b22018-09-11 11:40:25 +0200282 return codec_.spatialLayers[0].targetBitrate > 0;
sprangce4aef12015-11-02 07:23:20 -0800283}
284
Erik Språng566124a2018-04-23 12:32:22 +0200285bool VP9EncoderImpl::SetSvcRates(
286 const VideoBitrateAllocation& bitrate_allocation) {
Sergey Silkin86684962018-03-28 19:32:37 +0200287 config_->rc_target_bitrate = bitrate_allocation.get_sum_kbps();
Sergey Silkin86684962018-03-28 19:32:37 +0200288
sprangce4aef12015-11-02 07:23:20 -0800289 if (ExplicitlyConfiguredSpatialLayers()) {
Sergey Silkine7ce8882018-10-03 18:04:57 +0200290 const bool layer_activation_requires_key_frame =
291 inter_layer_pred_ == InterLayerPredMode::kOff ||
292 inter_layer_pred_ == InterLayerPredMode::kOnKeyPic;
293
Sergey Silkin86684962018-03-28 19:32:37 +0200294 for (size_t sl_idx = 0; sl_idx < num_spatial_layers_; ++sl_idx) {
Sergey Silkine7ce8882018-10-03 18:04:57 +0200295 const bool was_layer_active = (config_->ss_target_bitrate[sl_idx] > 0);
Sergey Silkin86684962018-03-28 19:32:37 +0200296 config_->ss_target_bitrate[sl_idx] =
297 bitrate_allocation.GetSpatialLayerSum(sl_idx) / 1000;
298
299 for (size_t tl_idx = 0; tl_idx < num_temporal_layers_; ++tl_idx) {
300 config_->layer_target_bitrate[sl_idx * num_temporal_layers_ + tl_idx] =
301 bitrate_allocation.GetTemporalLayerSum(sl_idx, tl_idx) / 1000;
302 }
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200303
Sergey Silkine7ce8882018-10-03 18:04:57 +0200304 const bool is_active_layer = (config_->ss_target_bitrate[sl_idx] > 0);
305 if (!was_layer_active && is_active_layer &&
306 layer_activation_requires_key_frame) {
307 force_key_frame_ = true;
308 } else if (was_layer_active && !is_active_layer &&
309 layer_deactivation_requires_key_frame_) {
310 force_key_frame_ = true;
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200311 }
Sergey Silkin96f2c972018-09-05 21:07:17 +0200312
Sergey Silkine7ce8882018-10-03 18:04:57 +0200313 if (!was_layer_active) {
Sergey Silkin96f2c972018-09-05 21:07:17 +0200314 // Reset frame rate controller if layer is resumed after pause.
315 framerate_controller_[sl_idx].Reset();
316 }
317
318 framerate_controller_[sl_idx].SetTargetRate(
Sergey Silkinbeba1b22018-09-11 11:40:25 +0200319 std::min(static_cast<float>(codec_.maxFramerate),
320 codec_.spatialLayers[sl_idx].maxFramerate));
sprangce4aef12015-11-02 07:23:20 -0800321 }
322 } else {
323 float rate_ratio[VPX_MAX_LAYERS] = {0};
324 float total = 0;
Sergey Silkin908689d2018-08-20 09:28:45 +0200325 for (int i = 0; i < num_spatial_layers_; ++i) {
johannkoenig8225c402017-01-26 13:23:44 -0800326 if (svc_params_.scaling_factor_num[i] <= 0 ||
327 svc_params_.scaling_factor_den[i] <= 0) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100328 RTC_LOG(LS_ERROR) << "Scaling factors not specified!";
sprangce4aef12015-11-02 07:23:20 -0800329 return false;
330 }
Yves Gerey665174f2018-06-19 15:03:05 +0200331 rate_ratio[i] = static_cast<float>(svc_params_.scaling_factor_num[i]) /
332 svc_params_.scaling_factor_den[i];
sprangce4aef12015-11-02 07:23:20 -0800333 total += rate_ratio[i];
334 }
335
Sergey Silkin908689d2018-08-20 09:28:45 +0200336 for (int i = 0; i < num_spatial_layers_; ++i) {
Rasmus Brandt58cd3852018-06-26 13:41:16 +0200337 RTC_CHECK_GT(total, 0);
sprangce4aef12015-11-02 07:23:20 -0800338 config_->ss_target_bitrate[i] = static_cast<unsigned int>(
339 config_->rc_target_bitrate * rate_ratio[i] / total);
340 if (num_temporal_layers_ == 1) {
341 config_->layer_target_bitrate[i] = config_->ss_target_bitrate[i];
342 } else if (num_temporal_layers_ == 2) {
343 config_->layer_target_bitrate[i * num_temporal_layers_] =
344 config_->ss_target_bitrate[i] * 2 / 3;
345 config_->layer_target_bitrate[i * num_temporal_layers_ + 1] =
346 config_->ss_target_bitrate[i];
347 } else if (num_temporal_layers_ == 3) {
348 config_->layer_target_bitrate[i * num_temporal_layers_] =
349 config_->ss_target_bitrate[i] / 2;
350 config_->layer_target_bitrate[i * num_temporal_layers_ + 1] =
351 config_->layer_target_bitrate[i * num_temporal_layers_] +
352 (config_->ss_target_bitrate[i] / 4);
353 config_->layer_target_bitrate[i * num_temporal_layers_ + 2] =
354 config_->ss_target_bitrate[i];
355 } else {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100356 RTC_LOG(LS_ERROR) << "Unsupported number of temporal layers: "
357 << num_temporal_layers_;
sprangce4aef12015-11-02 07:23:20 -0800358 return false;
359 }
Sergey Silkin96f2c972018-09-05 21:07:17 +0200360
361 framerate_controller_[i].SetTargetRate(codec_.maxFramerate);
asaperssona9455ab2015-07-31 06:10:09 -0700362 }
363 }
Sergey Silkin908689d2018-08-20 09:28:45 +0200364
365 num_active_spatial_layers_ = 0;
366 for (int i = 0; i < num_spatial_layers_; ++i) {
367 if (config_->ss_target_bitrate[i] > 0) {
368 ++num_active_spatial_layers_;
369 }
370 }
371 RTC_DCHECK_GT(num_active_spatial_layers_, 0);
372
asaperssona9455ab2015-07-31 06:10:09 -0700373 return true;
374}
375
Erik Språng16cb8f52019-04-12 13:59:09 +0200376void VP9EncoderImpl::SetRates(const RateControlParameters& parameters) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000377 if (!inited_) {
Erik Språng16cb8f52019-04-12 13:59:09 +0200378 RTC_LOG(LS_WARNING) << "SetRates() calll while uninitialzied.";
379 return;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000380 }
381 if (encoder_->err) {
Erik Språng16cb8f52019-04-12 13:59:09 +0200382 RTC_LOG(LS_WARNING) << "Encoder in error state: " << encoder_->err;
383 return;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000384 }
Erik Språng16cb8f52019-04-12 13:59:09 +0200385 if (parameters.framerate_fps < 1.0) {
386 RTC_LOG(LS_WARNING) << "Unsupported framerate: "
387 << parameters.framerate_fps;
388 return;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000389 }
390 // Update bit rate
Erik Språng08127a92016-11-16 16:41:30 +0100391 if (codec_.maxBitrate > 0 &&
Erik Språng16cb8f52019-04-12 13:59:09 +0200392 parameters.bitrate.get_sum_kbps() > codec_.maxBitrate) {
393 RTC_LOG(LS_WARNING) << "Target bitrate exceeds maximum: "
394 << parameters.bitrate.get_sum_kbps() << " vs "
395 << codec_.maxBitrate;
396 return;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000397 }
Erik Språng08127a92016-11-16 16:41:30 +0100398
Erik Språng16cb8f52019-04-12 13:59:09 +0200399 codec_.maxFramerate = static_cast<uint32_t>(parameters.framerate_fps + 0.5);
Erik Språng7a3fe892019-04-15 12:22:55 +0200400 requested_rate_settings_ = parameters;
asaperssona9455ab2015-07-31 06:10:09 -0700401
Erik Språng16cb8f52019-04-12 13:59:09 +0200402 return;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000403}
404
405int VP9EncoderImpl::InitEncode(const VideoCodec* inst,
406 int number_of_cores,
pkasting@chromium.org4591fbd2014-11-20 22:28:14 +0000407 size_t /*max_payload_size*/) {
sprang3958ed82017-08-17 08:12:10 -0700408 if (inst == nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000409 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
410 }
411 if (inst->maxFramerate < 1) {
412 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
413 }
414 // Allow zero to represent an unspecified maxBitRate
415 if (inst->maxBitrate > 0 && inst->startBitrate > inst->maxBitrate) {
416 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
417 }
418 if (inst->width < 1 || inst->height < 1) {
419 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
420 }
421 if (number_of_cores < 1) {
422 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
423 }
hta257dc392016-10-25 09:05:06 -0700424 if (inst->VP9().numberOfTemporalLayers > 3) {
asaperssona9455ab2015-07-31 06:10:09 -0700425 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
426 }
ilnik2a8c2f52017-02-15 02:23:28 -0800427 // libvpx probably does not support more than 3 spatial layers.
428 if (inst->VP9().numberOfSpatialLayers > 3) {
asaperssona9455ab2015-07-31 06:10:09 -0700429 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
430 }
philipelcfc319b2015-11-10 07:17:23 -0800431
asapersson86956de2016-01-26 01:05:20 -0800432 int ret_val = Release();
433 if (ret_val < 0) {
434 return ret_val;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000435 }
sprang3958ed82017-08-17 08:12:10 -0700436 if (encoder_ == nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000437 encoder_ = new vpx_codec_ctx_t;
438 }
sprang3958ed82017-08-17 08:12:10 -0700439 if (config_ == nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000440 config_ = new vpx_codec_enc_cfg_t;
441 }
442 timestamp_ = 0;
443 if (&codec_ != inst) {
444 codec_ = *inst;
445 }
asaperssona9455ab2015-07-31 06:10:09 -0700446
Sergey Silkinb0bd03b2018-09-28 14:56:39 +0200447 force_key_frame_ = true;
448 pics_since_key_ = 0;
449
hta257dc392016-10-25 09:05:06 -0700450 num_spatial_layers_ = inst->VP9().numberOfSpatialLayers;
Niels Möller65fb4042018-04-25 14:46:06 +0200451 RTC_DCHECK_GT(num_spatial_layers_, 0);
hta257dc392016-10-25 09:05:06 -0700452 num_temporal_layers_ = inst->VP9().numberOfTemporalLayers;
Sergey Silkin96f2c972018-09-05 21:07:17 +0200453 if (num_temporal_layers_ == 0) {
asaperssona9455ab2015-07-31 06:10:09 -0700454 num_temporal_layers_ = 1;
Sergey Silkin042661b2018-09-10 10:39:35 +0000455 }
Sergey Silkinae9e1882018-09-05 21:07:17 +0200456
Sergey Silkin96f2c972018-09-05 21:07:17 +0200457 framerate_controller_ = std::vector<FramerateController>(
458 num_spatial_layers_, FramerateController(codec_.maxFramerate));
459
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200460 is_svc_ = (num_spatial_layers_ > 1 || num_temporal_layers_ > 1);
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200461
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000462 // Allocate memory for encoded image
Niels Möller48a79462018-12-07 16:21:18 +0100463 size_t frame_capacity =
nisseeb44b392017-04-28 07:18:05 -0700464 CalcBufferSize(VideoType::kI420, codec_.width, codec_.height);
Niels Möllerdd1cc982019-02-07 18:52:50 +0100465 encoded_image_.Allocate(frame_capacity);
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000466 encoded_image_._completeFrame = true;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000467 // Populate encoder configuration with default values.
468 if (vpx_codec_enc_config_default(vpx_codec_vp9_cx(), config_, 0)) {
469 return WEBRTC_VIDEO_CODEC_ERROR;
470 }
Emircan Uysaler0823eec2018-07-13 17:10:00 -0700471
472 vpx_img_fmt img_fmt = VPX_IMG_FMT_NONE;
473 unsigned int bits_for_storage = 8;
474 switch (profile_) {
475 case VP9Profile::kProfile0:
476 img_fmt = VPX_IMG_FMT_I420;
477 bits_for_storage = 8;
478 config_->g_bit_depth = VPX_BITS_8;
479 config_->g_profile = 0;
480 config_->g_input_bit_depth = 8;
481 break;
482 case VP9Profile::kProfile2:
483 img_fmt = VPX_IMG_FMT_I42016;
484 bits_for_storage = 16;
485 config_->g_bit_depth = VPX_BITS_10;
486 config_->g_profile = 2;
487 config_->g_input_bit_depth = 10;
488 break;
489 }
490
491 // Creating a wrapper to the image - setting image data to nullptr. Actual
492 // pointer will be set in encode. Setting align to 1, as it is meaningless
493 // (actual memory is not allocated).
494 raw_ =
495 vpx_img_wrap(nullptr, img_fmt, codec_.width, codec_.height, 1, nullptr);
496 raw_->bit_depth = bits_for_storage;
497
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000498 config_->g_w = codec_.width;
499 config_->g_h = codec_.height;
500 config_->rc_target_bitrate = inst->startBitrate; // in kbit/s
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200501 config_->g_error_resilient = is_svc_ ? VPX_ERROR_RESILIENT_DEFAULT : 0;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000502 // Setting the time base of the codec.
503 config_->g_timebase.num = 1;
504 config_->g_timebase.den = 90000;
505 config_->g_lag_in_frames = 0; // 0- no frame lagging
506 config_->g_threads = 1;
507 // Rate control settings.
hta257dc392016-10-25 09:05:06 -0700508 config_->rc_dropframe_thresh = inst->VP9().frameDroppingOn ? 30 : 0;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000509 config_->rc_end_usage = VPX_CBR;
510 config_->g_pass = VPX_RC_ONE_PASS;
Ilya Nikolaevskiy3a656d12019-02-14 14:44:22 +0100511 config_->rc_min_quantizer =
512 codec_.mode == VideoCodecMode::kScreensharing ? 8 : 2;
marpan@webrtc.orgdc8a9da2015-01-27 23:08:24 +0000513 config_->rc_max_quantizer = 52;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000514 config_->rc_undershoot_pct = 50;
515 config_->rc_overshoot_pct = 50;
516 config_->rc_buf_initial_sz = 500;
517 config_->rc_buf_optimal_sz = 600;
518 config_->rc_buf_sz = 1000;
519 // Set the maximum target size of any key-frame.
520 rc_max_intra_target_ = MaxIntraTarget(config_->rc_buf_optimal_sz);
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +0100521 // Key-frame interval is enforced manually by this wrapper.
522 config_->kf_mode = VPX_KF_DISABLED;
523 // TODO(webm:1592): work-around for libvpx issue, as it can still
524 // put some key-frames at will even in VPX_KF_DISABLED kf_mode.
525 config_->kf_max_dist = inst->VP9().keyFrameInterval;
526 config_->kf_min_dist = config_->kf_max_dist;
hta257dc392016-10-25 09:05:06 -0700527 config_->rc_resize_allowed = inst->VP9().automaticResizeOn ? 1 : 0;
marpan@webrtc.org38d11b82015-01-26 15:21:36 +0000528 // Determine number of threads based on the image size and #cores.
philipelcce46fc2015-12-21 03:04:49 -0800529 config_->g_threads =
530 NumberOfThreads(config_->g_w, config_->g_h, number_of_cores);
asaperssona9455ab2015-07-31 06:10:09 -0700531
Marco6e89b252015-07-07 14:40:38 -0700532 cpu_speed_ = GetCpuSpeed(config_->g_w, config_->g_h);
asaperssona9455ab2015-07-31 06:10:09 -0700533
hta257dc392016-10-25 09:05:06 -0700534 is_flexible_mode_ = inst->VP9().flexibleMode;
Sergey Silkinbe71a1e2018-05-17 16:46:43 +0200535
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100536 inter_layer_pred_ = inst->VP9().interLayerPred;
537
538 different_framerates_used_ = false;
539 for (size_t sl_idx = 1; sl_idx < num_spatial_layers_; ++sl_idx) {
540 if (std::abs(codec_.spatialLayers[sl_idx].maxFramerate -
541 codec_.spatialLayers[0].maxFramerate) > 1e-9) {
542 different_framerates_used_ = true;
543 }
544 }
545
546 if (different_framerates_used_ && !is_flexible_mode_) {
547 RTC_LOG(LS_ERROR) << "Flexible mode required for different framerates on "
548 "different spatial layers";
549 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
550 }
551
552 // External reference control is required for different frame rate on spatial
553 // layers because libvpx generates rtp incompatible references in this case.
554 external_ref_control_ = field_trial::IsEnabled("WebRTC-Vp9ExternalRefCtrl") ||
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +0100555 different_framerates_used_ ||
556 inter_layer_pred_ == InterLayerPredMode::kOn;
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100557
Sergey Silkinbe71a1e2018-05-17 16:46:43 +0200558 if (num_temporal_layers_ == 1) {
asaperssona9455ab2015-07-31 06:10:09 -0700559 gof_.SetGofInfoVP9(kTemporalStructureMode1);
560 config_->temporal_layering_mode = VP9E_TEMPORAL_LAYERING_MODE_NOLAYERING;
561 config_->ts_number_layers = 1;
562 config_->ts_rate_decimator[0] = 1;
563 config_->ts_periodicity = 1;
564 config_->ts_layer_id[0] = 0;
565 } else if (num_temporal_layers_ == 2) {
566 gof_.SetGofInfoVP9(kTemporalStructureMode2);
567 config_->temporal_layering_mode = VP9E_TEMPORAL_LAYERING_MODE_0101;
568 config_->ts_number_layers = 2;
569 config_->ts_rate_decimator[0] = 2;
570 config_->ts_rate_decimator[1] = 1;
571 config_->ts_periodicity = 2;
572 config_->ts_layer_id[0] = 0;
573 config_->ts_layer_id[1] = 1;
574 } else if (num_temporal_layers_ == 3) {
575 gof_.SetGofInfoVP9(kTemporalStructureMode3);
576 config_->temporal_layering_mode = VP9E_TEMPORAL_LAYERING_MODE_0212;
577 config_->ts_number_layers = 3;
578 config_->ts_rate_decimator[0] = 4;
579 config_->ts_rate_decimator[1] = 2;
580 config_->ts_rate_decimator[2] = 1;
581 config_->ts_periodicity = 4;
582 config_->ts_layer_id[0] = 0;
583 config_->ts_layer_id[1] = 2;
584 config_->ts_layer_id[2] = 1;
585 config_->ts_layer_id[3] = 2;
586 } else {
587 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
588 }
589
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100590 if (external_ref_control_) {
591 config_->temporal_layering_mode = VP9E_TEMPORAL_LAYERING_MODE_BYPASS;
592 if (num_temporal_layers_ > 1 && different_framerates_used_) {
593 // External reference control for several temporal layers with different
594 // frame rates on spatial layers is not implemented yet.
595 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
596 }
597 }
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200598 ref_buf_.clear();
599
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000600 return InitAndSetControlSettings(inst);
601}
602
marpan@webrtc.org38d11b82015-01-26 15:21:36 +0000603int VP9EncoderImpl::NumberOfThreads(int width,
604 int height,
605 int number_of_cores) {
606 // Keep the number of encoder threads equal to the possible number of column
607 // tiles, which is (1, 2, 4, 8). See comments below for VP9E_SET_TILE_COLUMNS.
608 if (width * height >= 1280 * 720 && number_of_cores > 4) {
609 return 4;
jianj23173a32017-07-12 16:11:09 -0700610 } else if (width * height >= 640 * 360 && number_of_cores > 2) {
marpan@webrtc.org38d11b82015-01-26 15:21:36 +0000611 return 2;
612 } else {
Yves Gerey665174f2018-06-19 15:03:05 +0200613// Use 2 threads for low res on ARM.
Jerome Jiang831af372017-12-05 10:44:35 -0800614#if defined(WEBRTC_ARCH_ARM) || defined(WEBRTC_ARCH_ARM64) || \
615 defined(WEBRTC_ANDROID)
616 if (width * height >= 320 * 180 && number_of_cores > 2) {
617 return 2;
618 }
619#endif
marpan@webrtc.org38d11b82015-01-26 15:21:36 +0000620 // 1 thread less than VGA.
621 return 1;
622 }
623}
624
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000625int VP9EncoderImpl::InitAndSetControlSettings(const VideoCodec* inst) {
Åsa Perssonff24c042015-12-04 10:58:08 +0100626 // Set QP-min/max per spatial and temporal layer.
627 int tot_num_layers = num_spatial_layers_ * num_temporal_layers_;
628 for (int i = 0; i < tot_num_layers; ++i) {
johannkoenig8225c402017-01-26 13:23:44 -0800629 svc_params_.max_quantizers[i] = config_->rc_max_quantizer;
630 svc_params_.min_quantizers[i] = config_->rc_min_quantizer;
Åsa Perssonff24c042015-12-04 10:58:08 +0100631 }
asaperssona9455ab2015-07-31 06:10:09 -0700632 config_->ss_number_layers = num_spatial_layers_;
sprangce4aef12015-11-02 07:23:20 -0800633 if (ExplicitlyConfiguredSpatialLayers()) {
634 for (int i = 0; i < num_spatial_layers_; ++i) {
635 const auto& layer = codec_.spatialLayers[i];
Rasmus Brandt58cd3852018-06-26 13:41:16 +0200636 RTC_CHECK_GT(layer.width, 0);
Sergey Silkin13e74342018-03-02 12:28:00 +0100637 const int scale_factor = codec_.width / layer.width;
638 RTC_DCHECK_GT(scale_factor, 0);
639
640 // Ensure scaler factor is integer.
641 if (scale_factor * layer.width != codec_.width) {
642 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
643 }
644
645 // Ensure scale factor is the same in both dimensions.
646 if (scale_factor * layer.height != codec_.height) {
647 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
648 }
649
650 // Ensure scale factor is power of two.
651 const bool is_pow_of_two = (scale_factor & (scale_factor - 1)) == 0;
652 if (!is_pow_of_two) {
653 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
654 }
655
656 svc_params_.scaling_factor_num[i] = 1;
657 svc_params_.scaling_factor_den[i] = scale_factor;
Sergey Silkin96f2c972018-09-05 21:07:17 +0200658
659 RTC_DCHECK_GT(codec_.spatialLayers[i].maxFramerate, 0);
660 RTC_DCHECK_LE(codec_.spatialLayers[i].maxFramerate, codec_.maxFramerate);
661 if (i > 0) {
662 // Frame rate of high spatial layer is supposed to be equal or higher
663 // than frame rate of low spatial layer.
664 RTC_DCHECK_GE(codec_.spatialLayers[i].maxFramerate,
665 codec_.spatialLayers[i - 1].maxFramerate);
666 }
sprangce4aef12015-11-02 07:23:20 -0800667 }
668 } else {
669 int scaling_factor_num = 256;
670 for (int i = num_spatial_layers_ - 1; i >= 0; --i) {
sprangce4aef12015-11-02 07:23:20 -0800671 // 1:2 scaling in each dimension.
johannkoenig8225c402017-01-26 13:23:44 -0800672 svc_params_.scaling_factor_num[i] = scaling_factor_num;
673 svc_params_.scaling_factor_den[i] = 256;
sprangce4aef12015-11-02 07:23:20 -0800674 }
asaperssona9455ab2015-07-31 06:10:09 -0700675 }
676
Sergey Silkin86684962018-03-28 19:32:37 +0200677 SvcRateAllocator init_allocator(codec_);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100678 current_bitrate_allocation_ = init_allocator.GetAllocation(
Sergey Silkin86684962018-03-28 19:32:37 +0200679 inst->startBitrate * 1000, inst->maxFramerate);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100680 if (!SetSvcRates(current_bitrate_allocation_)) {
asaperssona9455ab2015-07-31 06:10:09 -0700681 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
682 }
683
Emircan Uysaler0823eec2018-07-13 17:10:00 -0700684 const vpx_codec_err_t rv = vpx_codec_enc_init(
685 encoder_, vpx_codec_vp9_cx(), config_,
686 config_->g_bit_depth == VPX_BITS_8 ? 0 : VPX_CODEC_USE_HIGHBITDEPTH);
687 if (rv != VPX_CODEC_OK) {
688 RTC_LOG(LS_ERROR) << "Init error: " << vpx_codec_err_to_string(rv);
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000689 return WEBRTC_VIDEO_CODEC_UNINITIALIZED;
690 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000691 vpx_codec_control(encoder_, VP8E_SET_CPUUSED, cpu_speed_);
692 vpx_codec_control(encoder_, VP8E_SET_MAX_INTRA_BITRATE_PCT,
693 rc_max_intra_target_);
694 vpx_codec_control(encoder_, VP9E_SET_AQ_MODE,
hta257dc392016-10-25 09:05:06 -0700695 inst->VP9().adaptiveQpMode ? 3 : 0);
asaperssona9455ab2015-07-31 06:10:09 -0700696
jianj822e5932017-07-12 16:09:58 -0700697 vpx_codec_control(encoder_, VP9E_SET_FRAME_PARALLEL_DECODING, 0);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100698 vpx_codec_control(encoder_, VP9E_SET_SVC_GF_TEMPORAL_REF, 0);
Sergey Silkin6a8f30e2018-04-26 11:03:49 +0200699
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200700 if (is_svc_) {
701 vpx_codec_control(encoder_, VP9E_SET_SVC, 1);
702 vpx_codec_control(encoder_, VP9E_SET_SVC_PARAMETERS, &svc_params_);
asaperssona9455ab2015-07-31 06:10:09 -0700703 }
Sergey Silkin6a8f30e2018-04-26 11:03:49 +0200704
705 if (num_spatial_layers_ > 1) {
706 switch (inter_layer_pred_) {
707 case InterLayerPredMode::kOn:
708 vpx_codec_control(encoder_, VP9E_SET_SVC_INTER_LAYER_PRED, 0);
709 break;
710 case InterLayerPredMode::kOff:
711 vpx_codec_control(encoder_, VP9E_SET_SVC_INTER_LAYER_PRED, 1);
712 break;
713 case InterLayerPredMode::kOnKeyPic:
714 vpx_codec_control(encoder_, VP9E_SET_SVC_INTER_LAYER_PRED, 2);
715 break;
716 default:
717 RTC_NOTREACHED();
718 }
Sergey Silkinbe71a1e2018-05-17 16:46:43 +0200719
Sergey Silkinee203362018-05-30 11:34:08 +0200720 // Configure encoder to drop entire superframe whenever it needs to drop
721 // a layer. This mode is prefered over per-layer dropping which causes
722 // quality flickering and is not compatible with RTP non-flexible mode.
723 vpx_svc_frame_drop_t svc_drop_frame;
724 memset(&svc_drop_frame, 0, sizeof(svc_drop_frame));
Sergey Silkin88ce4ef2018-11-23 13:59:24 +0100725 svc_drop_frame.framedrop_mode =
726 full_superframe_drop_ ? FULL_SUPERFRAME_DROP : CONSTRAINED_LAYER_DROP;
Sergey Silkind45b3452018-05-31 16:00:24 +0200727 svc_drop_frame.max_consec_drop = std::numeric_limits<int>::max();
Sergey Silkinee203362018-05-30 11:34:08 +0200728 for (size_t i = 0; i < num_spatial_layers_; ++i) {
729 svc_drop_frame.framedrop_thresh[i] = config_->rc_dropframe_thresh;
Sergey Silkinbe71a1e2018-05-17 16:46:43 +0200730 }
Sergey Silkinee203362018-05-30 11:34:08 +0200731 vpx_codec_control(encoder_, VP9E_SET_SVC_FRAME_DROP_LAYER, &svc_drop_frame);
Sergey Silkin6a8f30e2018-04-26 11:03:49 +0200732 }
733
asaperssona9455ab2015-07-31 06:10:09 -0700734 // Register callback for getting each spatial layer.
735 vpx_codec_priv_output_cx_pkt_cb_pair_t cbp = {
philipelcce46fc2015-12-21 03:04:49 -0800736 VP9EncoderImpl::EncoderOutputCodedPacketCallback,
737 reinterpret_cast<void*>(this)};
738 vpx_codec_control(encoder_, VP9E_REGISTER_CX_CALLBACK,
739 reinterpret_cast<void*>(&cbp));
asaperssona9455ab2015-07-31 06:10:09 -0700740
marpan@webrtc.org38d11b82015-01-26 15:21:36 +0000741 // Control function to set the number of column tiles in encoding a frame, in
742 // log2 unit: e.g., 0 = 1 tile column, 1 = 2 tile columns, 2 = 4 tile columns.
743 // The number tile columns will be capped by the encoder based on image size
744 // (minimum width of tile column is 256 pixels, maximum is 4096).
745 vpx_codec_control(encoder_, VP9E_SET_TILE_COLUMNS, (config_->g_threads >> 1));
jianjcb5d1152017-03-28 23:56:08 -0700746
747 // Turn on row-based multithreading.
748 vpx_codec_control(encoder_, VP9E_SET_ROW_MT, 1);
jianj6bf57e32017-06-05 13:43:49 -0700749
Alex Glaznevfecb7c32016-03-31 14:23:27 -0700750#if !defined(WEBRTC_ARCH_ARM) && !defined(WEBRTC_ARCH_ARM64) && \
Yves Gerey665174f2018-06-19 15:03:05 +0200751 !defined(ANDROID)
jianj6bf57e32017-06-05 13:43:49 -0700752 // Do not enable the denoiser on ARM since optimization is pending.
753 // Denoiser is on by default on other platforms.
marpan@webrtc.org16a87b92015-03-05 22:19:00 +0000754 vpx_codec_control(encoder_, VP9E_SET_NOISE_SENSITIVITY,
hta257dc392016-10-25 09:05:06 -0700755 inst->VP9().denoisingOn ? 1 : 0);
marpan@webrtc.org16a87b92015-03-05 22:19:00 +0000756#endif
jianj6bf57e32017-06-05 13:43:49 -0700757
Niels Möllere3cf3d02018-06-13 11:52:16 +0200758 if (codec_.mode == VideoCodecMode::kScreensharing) {
ivica242d6382015-09-04 06:13:23 -0700759 // Adjust internal parameters to screen content.
760 vpx_codec_control(encoder_, VP9E_SET_TUNE_CONTENT, 1);
ivica242d6382015-09-04 06:13:23 -0700761 }
Marco2520e722015-09-16 14:05:00 -0700762 // Enable encoder skip of static/low content blocks.
763 vpx_codec_control(encoder_, VP8E_SET_STATIC_THRESHOLD, 1);
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000764 inited_ = true;
765 return WEBRTC_VIDEO_CODEC_OK;
766}
767
768uint32_t VP9EncoderImpl::MaxIntraTarget(uint32_t optimal_buffer_size) {
769 // Set max to the optimal buffer level (normalized by target BR),
770 // and scaled by a scale_par.
771 // Max target size = scale_par * optimal_buffer_size * targetBR[Kbps].
772 // This value is presented in percentage of perFrameBw:
773 // perFrameBw = targetBR[Kbps] * 1000 / framerate.
774 // The target in % is as follows:
775 float scale_par = 0.5;
776 uint32_t target_pct =
777 optimal_buffer_size * scale_par * codec_.maxFramerate / 10;
778 // Don't go below 3 times the per frame bandwidth.
779 const uint32_t min_intra_size = 300;
philipelcce46fc2015-12-21 03:04:49 -0800780 return (target_pct < min_intra_size) ? min_intra_size : target_pct;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000781}
782
Miguel Casas-Sanchez47650702015-05-29 17:21:40 -0700783int VP9EncoderImpl::Encode(const VideoFrame& input_image,
Niels Möller87e2d782019-03-07 10:18:23 +0100784 const std::vector<VideoFrameType>* frame_types) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000785 if (!inited_) {
786 return WEBRTC_VIDEO_CODEC_UNINITIALIZED;
787 }
sprang3958ed82017-08-17 08:12:10 -0700788 if (encoded_complete_callback_ == nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000789 return WEBRTC_VIDEO_CODEC_UNINITIALIZED;
790 }
Erik Språngbfa5d5d2019-02-04 16:40:19 +0100791 if (num_active_spatial_layers_ == 0) {
792 // All spatial layers are disabled, return without encoding anything.
793 return WEBRTC_VIDEO_CODEC_OK;
794 }
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200795
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000796 // We only support one stream at the moment.
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200797 if (frame_types && !frame_types->empty()) {
Niels Möller8f7ce222019-03-21 15:43:58 +0100798 if ((*frame_types)[0] == VideoFrameType::kVideoFrameKey) {
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200799 force_key_frame_ = true;
800 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000801 }
Sergey Silkind902d582018-05-18 17:31:19 +0200802
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +0100803 if (pics_since_key_ + 1 ==
804 static_cast<size_t>(codec_.VP9()->keyFrameInterval)) {
805 force_key_frame_ = true;
806 }
807
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100808 vpx_svc_layer_id_t layer_id = {0};
809 if (!force_key_frame_) {
Patrik Höglundd4d254f2018-11-29 15:09:31 +0000810 const size_t gof_idx = (pics_since_key_ + 1) % gof_.num_frames_in_gof;
811 layer_id.temporal_layer_id = gof_.temporal_idx[gof_idx];
Sergey Silkin96f2c972018-09-05 21:07:17 +0200812
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100813 if (VideoCodecMode::kScreensharing == codec_.mode) {
814 const uint32_t frame_timestamp_ms =
815 1000 * input_image.timestamp() / kVideoPayloadTypeFrequency;
Sergey Silkin96f2c972018-09-05 21:07:17 +0200816
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +0100817 // To ensure that several rate-limiters with different limits don't
818 // interfere, they must be queried in order of increasing limit.
819
820 bool use_steady_state_limiter =
821 variable_framerate_experiment_.enabled &&
822 input_image.update_rect().IsEmpty() &&
823 num_steady_state_frames_ >=
824 variable_framerate_experiment_.frames_before_steady_state;
825
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100826 for (uint8_t sl_idx = 0; sl_idx < num_active_spatial_layers_; ++sl_idx) {
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +0100827 const float layer_fps =
828 framerate_controller_[layer_id.spatial_layer_id].GetTargetRate();
829 // Use steady state rate-limiter at the correct place.
830 if (use_steady_state_limiter &&
831 layer_fps > variable_framerate_experiment_.framerate_limit - 1e-9) {
832 if (variable_framerate_controller_.DropFrame(frame_timestamp_ms)) {
833 layer_id.spatial_layer_id = num_active_spatial_layers_;
834 }
835 // Break always: if rate limiter triggered frame drop, no need to
836 // continue; otherwise, the rate is less than the next limiters.
837 break;
838 }
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100839 if (framerate_controller_[sl_idx].DropFrame(frame_timestamp_ms)) {
840 ++layer_id.spatial_layer_id;
841 } else {
842 break;
843 }
Sergey Silkin96f2c972018-09-05 21:07:17 +0200844 }
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +0100845
846 if (use_steady_state_limiter &&
847 layer_id.spatial_layer_id < num_active_spatial_layers_) {
848 variable_framerate_controller_.AddFrame(frame_timestamp_ms);
849 }
Sergey Silkin96f2c972018-09-05 21:07:17 +0200850 }
Patrik Höglundd4d254f2018-11-29 15:09:31 +0000851
852 RTC_DCHECK_LE(layer_id.spatial_layer_id, num_active_spatial_layers_);
853 if (layer_id.spatial_layer_id >= num_active_spatial_layers_) {
854 // Drop entire picture.
855 return WEBRTC_VIDEO_CODEC_OK;
856 }
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100857 }
Patrik Höglundd4d254f2018-11-29 15:09:31 +0000858
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100859 for (int sl_idx = 0; sl_idx < num_active_spatial_layers_; ++sl_idx) {
860 layer_id.temporal_layer_id_per_spatial[sl_idx] = layer_id.temporal_layer_id;
861 }
862
863 vpx_codec_control(encoder_, VP9E_SET_SVC_LAYER_ID, &layer_id);
864
Erik Språng7a3fe892019-04-15 12:22:55 +0200865 if (requested_rate_settings_) {
866 if (dynamic_rate_settings_) {
867 // Tweak rate control settings based on available network headroom.
868 UpdateRateSettings(
869 config_,
870 GetRateSettings(
871 requested_rate_settings_->bandwidth_allocation.bps<double>() /
872 requested_rate_settings_->bitrate.get_sum_bps()));
873 }
874
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100875 bool more_layers_requested = MoreLayersEnabled(
Erik Språng7a3fe892019-04-15 12:22:55 +0200876 requested_rate_settings_->bitrate, current_bitrate_allocation_);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100877 bool less_layers_requested = MoreLayersEnabled(
Erik Språng7a3fe892019-04-15 12:22:55 +0200878 current_bitrate_allocation_, requested_rate_settings_->bitrate);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100879 // In SVC can enable new layers only if all lower layers are encoded and at
880 // the base temporal layer.
881 // This will delay rate allocation change until the next frame on the base
882 // spatial layer.
883 // In KSVC or simulcast modes KF will be generated for a new layer, so can
884 // update allocation any time.
885 bool can_upswitch =
886 inter_layer_pred_ != InterLayerPredMode::kOn ||
887 (layer_id.spatial_layer_id == 0 && layer_id.temporal_layer_id == 0);
888 if (!more_layers_requested || can_upswitch) {
Erik Språng7a3fe892019-04-15 12:22:55 +0200889 current_bitrate_allocation_ = requested_rate_settings_->bitrate;
890 requested_rate_settings_ = absl::nullopt;
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100891 if (!SetSvcRates(current_bitrate_allocation_)) {
892 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
893 }
894 if (less_layers_requested || more_layers_requested) {
895 ss_info_needed_ = true;
896 }
897 }
898 }
899
900 if (vpx_codec_enc_config_set(encoder_, config_)) {
901 return WEBRTC_VIDEO_CODEC_ERROR;
Sergey Silkind902d582018-05-18 17:31:19 +0200902 }
903
kwiberg352444f2016-11-28 15:58:53 -0800904 RTC_DCHECK_EQ(input_image.width(), raw_->d_w);
905 RTC_DCHECK_EQ(input_image.height(), raw_->d_h);
asaperssona9455ab2015-07-31 06:10:09 -0700906
907 // Set input image for use in the callback.
908 // This was necessary since you need some information from input_image.
909 // You can save only the necessary information (such as timestamp) instead of
910 // doing this.
911 input_image_ = &input_image;
912
Emircan Uysaler0823eec2018-07-13 17:10:00 -0700913 // Keep reference to buffer until encode completes.
914 rtc::scoped_refptr<I420BufferInterface> i420_buffer;
915 rtc::scoped_refptr<I010BufferInterface> i010_buffer;
916 switch (profile_) {
917 case VP9Profile::kProfile0: {
918 i420_buffer = input_image.video_frame_buffer()->ToI420();
919 // Image in vpx_image_t format.
920 // Input image is const. VPX's raw image is not defined as const.
921 raw_->planes[VPX_PLANE_Y] = const_cast<uint8_t*>(i420_buffer->DataY());
922 raw_->planes[VPX_PLANE_U] = const_cast<uint8_t*>(i420_buffer->DataU());
923 raw_->planes[VPX_PLANE_V] = const_cast<uint8_t*>(i420_buffer->DataV());
924 raw_->stride[VPX_PLANE_Y] = i420_buffer->StrideY();
925 raw_->stride[VPX_PLANE_U] = i420_buffer->StrideU();
926 raw_->stride[VPX_PLANE_V] = i420_buffer->StrideV();
927 break;
928 }
929 case VP9Profile::kProfile2: {
930 // We can inject kI010 frames directly for encode. All other formats
931 // should be converted to it.
932 switch (input_image.video_frame_buffer()->type()) {
933 case VideoFrameBuffer::Type::kI010: {
934 i010_buffer = input_image.video_frame_buffer()->GetI010();
935 break;
936 }
937 default: {
938 i010_buffer =
939 I010Buffer::Copy(*input_image.video_frame_buffer()->ToI420());
940 }
941 }
942 raw_->planes[VPX_PLANE_Y] = const_cast<uint8_t*>(
943 reinterpret_cast<const uint8_t*>(i010_buffer->DataY()));
944 raw_->planes[VPX_PLANE_U] = const_cast<uint8_t*>(
945 reinterpret_cast<const uint8_t*>(i010_buffer->DataU()));
946 raw_->planes[VPX_PLANE_V] = const_cast<uint8_t*>(
947 reinterpret_cast<const uint8_t*>(i010_buffer->DataV()));
948 raw_->stride[VPX_PLANE_Y] = i010_buffer->StrideY() * 2;
949 raw_->stride[VPX_PLANE_U] = i010_buffer->StrideU() * 2;
950 raw_->stride[VPX_PLANE_V] = i010_buffer->StrideV() * 2;
951 break;
952 }
953 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000954
philipelcfc319b2015-11-10 07:17:23 -0800955 vpx_enc_frame_flags_t flags = 0;
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200956 if (force_key_frame_) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000957 flags = VPX_EFLAG_FORCE_KF;
958 }
philipelcfc319b2015-11-10 07:17:23 -0800959
Sergey Silkin390f3582018-10-01 17:13:50 +0200960 if (external_ref_control_) {
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100961 vpx_svc_ref_frame_config_t ref_config =
962 SetReferences(force_key_frame_, layer_id.spatial_layer_id);
Sergey Silkina85995a2018-10-02 10:28:10 +0200963
964 if (VideoCodecMode::kScreensharing == codec_.mode) {
965 for (uint8_t sl_idx = 0; sl_idx < num_active_spatial_layers_; ++sl_idx) {
966 ref_config.duration[sl_idx] = static_cast<int64_t>(
967 90000 / framerate_controller_[sl_idx].GetTargetRate());
968 }
969 }
970
Sergey Silkin390f3582018-10-01 17:13:50 +0200971 vpx_codec_control(encoder_, VP9E_SET_SVC_REF_FRAME_CONFIG, &ref_config);
972 }
973
Sergey Silkin88ce4ef2018-11-23 13:59:24 +0100974 first_frame_in_picture_ = true;
975
Sergey Silkin96f2c972018-09-05 21:07:17 +0200976 // TODO(ssilkin): Frame duration should be specified per spatial layer
977 // since their frame rate can be different. For now calculate frame duration
978 // based on target frame rate of the highest spatial layer, which frame rate
979 // is supposed to be equal or higher than frame rate of low spatial layers.
980 // Also, timestamp should represent actual time passed since previous frame
981 // (not 'expected' time). Then rate controller can drain buffer more
982 // accurately.
983 RTC_DCHECK_GE(framerate_controller_.size(), num_active_spatial_layers_);
Sergey Silkinf87bb462018-09-17 09:37:37 +0200984 float target_framerate_fps =
985 (codec_.mode == VideoCodecMode::kScreensharing)
986 ? framerate_controller_[num_active_spatial_layers_ - 1]
987 .GetTargetRate()
988 : codec_.maxFramerate;
989 uint32_t duration = static_cast<uint32_t>(90000 / target_framerate_fps);
Emircan Uysaler0823eec2018-07-13 17:10:00 -0700990 const vpx_codec_err_t rv = vpx_codec_encode(encoder_, raw_, timestamp_,
991 duration, flags, VPX_DL_REALTIME);
992 if (rv != VPX_CODEC_OK) {
993 RTC_LOG(LS_ERROR) << "Encoding error: " << vpx_codec_err_to_string(rv)
994 << "\n"
995 << "Details: " << vpx_codec_error(encoder_) << "\n"
996 << vpx_codec_error_detail(encoder_);
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000997 return WEBRTC_VIDEO_CODEC_ERROR;
998 }
999 timestamp_ += duration;
asaperssona9455ab2015-07-31 06:10:09 -07001000
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001001 if (!full_superframe_drop_) {
1002 const bool end_of_picture = true;
1003 DeliverBufferedFrame(end_of_picture);
1004 }
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001005
asaperssona9455ab2015-07-31 06:10:09 -07001006 return WEBRTC_VIDEO_CODEC_OK;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001007}
1008
1009void VP9EncoderImpl::PopulateCodecSpecific(CodecSpecificInfo* codec_specific,
Niels Möllerd3b8c632018-08-27 15:33:42 +02001010 absl::optional<int>* spatial_idx,
philipelcce46fc2015-12-21 03:04:49 -08001011 const vpx_codec_cx_pkt& pkt,
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001012 uint32_t timestamp) {
sprang3958ed82017-08-17 08:12:10 -07001013 RTC_CHECK(codec_specific != nullptr);
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001014 codec_specific->codecType = kVideoCodecVP9;
philipelcce46fc2015-12-21 03:04:49 -08001015 CodecSpecificInfoVP9* vp9_info = &(codec_specific->codecSpecific.VP9);
Sergey Silkin07f80cc2018-04-09 13:11:59 +02001016
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001017 vp9_info->first_frame_in_picture = first_frame_in_picture_;
Sergey Silkin738b7e92018-08-23 16:37:27 +02001018 vp9_info->flexible_mode = is_flexible_mode_;
asaperssona9455ab2015-07-31 06:10:09 -07001019
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001020 if (pkt.data.frame.flags & VPX_FRAME_IS_KEY) {
1021 pics_since_key_ = 0;
1022 } else if (first_frame_in_picture_) {
1023 ++pics_since_key_;
1024 }
1025
asaperssona9455ab2015-07-31 06:10:09 -07001026 vpx_svc_layer_id_t layer_id = {0};
1027 vpx_codec_control(encoder_, VP9E_GET_SVC_LAYER_ID, &layer_id);
1028
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +01001029 // Can't have keyframe with non-zero temporal layer.
1030 RTC_DCHECK(pics_since_key_ != 0 || layer_id.temporal_layer_id == 0);
1031
sprang3958ed82017-08-17 08:12:10 -07001032 RTC_CHECK_GT(num_temporal_layers_, 0);
“Michael23c5a992018-06-21 11:07:21 -05001033 RTC_CHECK_GT(num_active_spatial_layers_, 0);
asaperssona9455ab2015-07-31 06:10:09 -07001034 if (num_temporal_layers_ == 1) {
sprang3958ed82017-08-17 08:12:10 -07001035 RTC_CHECK_EQ(layer_id.temporal_layer_id, 0);
asaperssona9455ab2015-07-31 06:10:09 -07001036 vp9_info->temporal_idx = kNoTemporalIdx;
1037 } else {
1038 vp9_info->temporal_idx = layer_id.temporal_layer_id;
1039 }
“Michael23c5a992018-06-21 11:07:21 -05001040 if (num_active_spatial_layers_ == 1) {
sprang3958ed82017-08-17 08:12:10 -07001041 RTC_CHECK_EQ(layer_id.spatial_layer_id, 0);
Niels Möllerd3b8c632018-08-27 15:33:42 +02001042 *spatial_idx = absl::nullopt;
asaperssona9455ab2015-07-31 06:10:09 -07001043 } else {
Niels Möllerd3b8c632018-08-27 15:33:42 +02001044 *spatial_idx = layer_id.spatial_layer_id;
asaperssona9455ab2015-07-31 06:10:09 -07001045 }
asaperssona9455ab2015-07-31 06:10:09 -07001046
asaperssona9455ab2015-07-31 06:10:09 -07001047 // TODO(asapersson): this info has to be obtained from the encoder.
asaperssoncb50c962015-11-18 01:58:55 -08001048 vp9_info->temporal_up_switch = false;
asaperssona9455ab2015-07-31 06:10:09 -07001049
Sergey Silkin6a8f30e2018-04-26 11:03:49 +02001050 const bool is_key_pic = (pics_since_key_ == 0);
1051 const bool is_inter_layer_pred_allowed =
1052 (inter_layer_pred_ == InterLayerPredMode::kOn ||
1053 (inter_layer_pred_ == InterLayerPredMode::kOnKeyPic && is_key_pic));
1054
1055 // Always set inter_layer_predicted to true on high layer frame if inter-layer
1056 // prediction (ILP) is allowed even if encoder didn't actually use it.
1057 // Setting inter_layer_predicted to false would allow receiver to decode high
1058 // layer frame without decoding low layer frame. If that would happen (e.g.
1059 // if low layer frame is lost) then receiver won't be able to decode next high
1060 // layer frame which uses ILP.
1061 vp9_info->inter_layer_predicted =
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001062 first_frame_in_picture_ ? false : is_inter_layer_pred_allowed;
Sergey Silkin6a8f30e2018-04-26 11:03:49 +02001063
Sergey Silkinc5f152d2018-09-26 13:28:50 +02001064 // Mark all low spatial layer frames as references (not just frames of
1065 // active low spatial layers) if inter-layer prediction is enabled since
1066 // these frames are indirect references of high spatial layer, which can
1067 // later be enabled without key frame.
Sergey Silkin6a8f30e2018-04-26 11:03:49 +02001068 vp9_info->non_ref_for_inter_layer_pred =
Sergey Silkinc5f152d2018-09-26 13:28:50 +02001069 !is_inter_layer_pred_allowed ||
1070 layer_id.spatial_layer_id + 1 == num_spatial_layers_;
asapersson00ac85e2015-11-11 05:30:48 -08001071
ivica7f6a6fc2015-09-08 02:40:29 -07001072 // Always populate this, so that the packetizer can properly set the marker
1073 // bit.
“Michael23c5a992018-06-21 11:07:21 -05001074 vp9_info->num_spatial_layers = num_active_spatial_layers_;
philipelcfc319b2015-11-10 07:17:23 -08001075
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001076 vp9_info->num_ref_pics = 0;
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +01001077 FillReferenceIndices(pkt, pics_since_key_, vp9_info->inter_layer_predicted,
1078 vp9_info);
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001079 if (vp9_info->flexible_mode) {
1080 vp9_info->gof_idx = kNoGofIdx;
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001081 } else {
1082 vp9_info->gof_idx =
1083 static_cast<uint8_t>(pics_since_key_ % gof_.num_frames_in_gof);
1084 vp9_info->temporal_up_switch = gof_.temporal_up_switch[vp9_info->gof_idx];
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +01001085 RTC_DCHECK(vp9_info->num_ref_pics == gof_.num_ref_pics[vp9_info->gof_idx] ||
1086 vp9_info->num_ref_pics == 0);
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001087 }
1088
1089 vp9_info->inter_pic_predicted = (!is_key_pic && vp9_info->num_ref_pics > 0);
1090
Sergey Silkina323cc02019-04-23 10:09:28 +02001091 // Write SS on key frame of independently coded spatial layers and on base
1092 // temporal/spatial layer frame if number of layers changed without issuing
1093 // of key picture (inter-layer prediction is enabled).
1094 const bool is_key_frame = is_key_pic && !vp9_info->inter_layer_predicted;
1095 if (is_key_frame || (ss_info_needed_ && layer_id.temporal_layer_id == 0 &&
1096 layer_id.spatial_layer_id == 0)) {
1097 vp9_info->ss_data_available = true;
asaperssona9455ab2015-07-31 06:10:09 -07001098 vp9_info->spatial_layer_resolution_present = true;
“Michael23c5a992018-06-21 11:07:21 -05001099 for (size_t i = 0; i < num_active_spatial_layers_; ++i) {
Yves Gerey665174f2018-06-19 15:03:05 +02001100 vp9_info->width[i] = codec_.width * svc_params_.scaling_factor_num[i] /
johannkoenig8225c402017-01-26 13:23:44 -08001101 svc_params_.scaling_factor_den[i];
Yves Gerey665174f2018-06-19 15:03:05 +02001102 vp9_info->height[i] = codec_.height * svc_params_.scaling_factor_num[i] /
johannkoenig8225c402017-01-26 13:23:44 -08001103 svc_params_.scaling_factor_den[i];
asaperssona9455ab2015-07-31 06:10:09 -07001104 }
Sergey Silkin738b7e92018-08-23 16:37:27 +02001105 if (vp9_info->flexible_mode) {
1106 vp9_info->gof.num_frames_in_gof = 0;
1107 } else {
asaperssona9455ab2015-07-31 06:10:09 -07001108 vp9_info->gof.CopyGofInfoVP9(gof_);
1109 }
Sergey Silkina323cc02019-04-23 10:09:28 +02001110
1111 ss_info_needed_ = false;
1112 } else {
1113 vp9_info->ss_data_available = false;
asaperssona9455ab2015-07-31 06:10:09 -07001114 }
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001115
1116 first_frame_in_picture_ = false;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001117}
1118
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001119void VP9EncoderImpl::FillReferenceIndices(const vpx_codec_cx_pkt& pkt,
1120 const size_t pic_num,
1121 const bool inter_layer_predicted,
1122 CodecSpecificInfoVP9* vp9_info) {
1123 vpx_svc_layer_id_t layer_id = {0};
1124 vpx_codec_control(encoder_, VP9E_GET_SVC_LAYER_ID, &layer_id);
1125
Sergey Silkin76be2952018-08-21 12:30:33 +02001126 const bool is_key_frame =
1127 (pkt.data.frame.flags & VPX_FRAME_IS_KEY) ? true : false;
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001128
1129 std::vector<RefFrameBuffer> ref_buf_list;
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001130
Sergey Silkin76be2952018-08-21 12:30:33 +02001131 if (is_svc_) {
1132 vpx_svc_ref_frame_config_t enc_layer_conf = {{0}};
1133 vpx_codec_control(encoder_, VP9E_GET_SVC_REF_FRAME_CONFIG, &enc_layer_conf);
Sergey Silkin38fabff2019-03-21 10:08:40 +01001134 int ref_buf_flags = 0;
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001135
Sergey Silkin76be2952018-08-21 12:30:33 +02001136 if (enc_layer_conf.reference_last[layer_id.spatial_layer_id]) {
1137 const size_t fb_idx =
1138 enc_layer_conf.lst_fb_idx[layer_id.spatial_layer_id];
1139 RTC_DCHECK(ref_buf_.find(fb_idx) != ref_buf_.end());
Sergey Silkin82276592018-08-27 14:54:20 +02001140 if (std::find(ref_buf_list.begin(), ref_buf_list.end(),
1141 ref_buf_.at(fb_idx)) == ref_buf_list.end()) {
1142 ref_buf_list.push_back(ref_buf_.at(fb_idx));
Sergey Silkin38fabff2019-03-21 10:08:40 +01001143 ref_buf_flags |= 1 << fb_idx;
Sergey Silkin82276592018-08-27 14:54:20 +02001144 }
Sergey Silkin76be2952018-08-21 12:30:33 +02001145 }
1146
1147 if (enc_layer_conf.reference_alt_ref[layer_id.spatial_layer_id]) {
1148 const size_t fb_idx =
1149 enc_layer_conf.alt_fb_idx[layer_id.spatial_layer_id];
1150 RTC_DCHECK(ref_buf_.find(fb_idx) != ref_buf_.end());
Sergey Silkin82276592018-08-27 14:54:20 +02001151 if (std::find(ref_buf_list.begin(), ref_buf_list.end(),
1152 ref_buf_.at(fb_idx)) == ref_buf_list.end()) {
1153 ref_buf_list.push_back(ref_buf_.at(fb_idx));
Sergey Silkin38fabff2019-03-21 10:08:40 +01001154 ref_buf_flags |= 1 << fb_idx;
Sergey Silkin82276592018-08-27 14:54:20 +02001155 }
Sergey Silkin76be2952018-08-21 12:30:33 +02001156 }
1157
1158 if (enc_layer_conf.reference_golden[layer_id.spatial_layer_id]) {
1159 const size_t fb_idx =
1160 enc_layer_conf.gld_fb_idx[layer_id.spatial_layer_id];
1161 RTC_DCHECK(ref_buf_.find(fb_idx) != ref_buf_.end());
Sergey Silkin82276592018-08-27 14:54:20 +02001162 if (std::find(ref_buf_list.begin(), ref_buf_list.end(),
1163 ref_buf_.at(fb_idx)) == ref_buf_list.end()) {
1164 ref_buf_list.push_back(ref_buf_.at(fb_idx));
Sergey Silkin38fabff2019-03-21 10:08:40 +01001165 ref_buf_flags |= 1 << fb_idx;
Sergey Silkin82276592018-08-27 14:54:20 +02001166 }
Sergey Silkin76be2952018-08-21 12:30:33 +02001167 }
Sergey Silkin38fabff2019-03-21 10:08:40 +01001168
1169 RTC_LOG(LS_VERBOSE) << "Frame " << pic_num << " sl "
1170 << layer_id.spatial_layer_id << " tl "
1171 << layer_id.temporal_layer_id << " refered buffers "
1172 << (ref_buf_flags & (1 << 0) ? 1 : 0)
1173 << (ref_buf_flags & (1 << 1) ? 1 : 0)
1174 << (ref_buf_flags & (1 << 2) ? 1 : 0)
1175 << (ref_buf_flags & (1 << 3) ? 1 : 0)
1176 << (ref_buf_flags & (1 << 4) ? 1 : 0)
1177 << (ref_buf_flags & (1 << 5) ? 1 : 0)
1178 << (ref_buf_flags & (1 << 6) ? 1 : 0)
1179 << (ref_buf_flags & (1 << 7) ? 1 : 0);
1180
Sergey Silkin76be2952018-08-21 12:30:33 +02001181 } else if (!is_key_frame) {
1182 RTC_DCHECK_EQ(num_spatial_layers_, 1);
1183 RTC_DCHECK_EQ(num_temporal_layers_, 1);
1184 // In non-SVC mode encoder doesn't provide reference list. Assume each frame
1185 // refers previous one, which is stored in buffer 0.
1186 ref_buf_list.push_back(ref_buf_.at(0));
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001187 }
1188
1189 size_t max_ref_temporal_layer_id = 0;
1190
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001191 std::vector<size_t> ref_pid_list;
1192
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001193 vp9_info->num_ref_pics = 0;
1194 for (const RefFrameBuffer& ref_buf : ref_buf_list) {
1195 RTC_DCHECK_LE(ref_buf.pic_num, pic_num);
1196 if (ref_buf.pic_num < pic_num) {
1197 if (inter_layer_pred_ != InterLayerPredMode::kOn) {
1198 // RTP spec limits temporal prediction to the same spatial layer.
1199 // It is safe to ignore this requirement if inter-layer prediction is
1200 // enabled for all frames when all base frames are relayed to receiver.
1201 RTC_DCHECK_EQ(ref_buf.spatial_layer_id, layer_id.spatial_layer_id);
1202 }
1203 RTC_DCHECK_LE(ref_buf.temporal_layer_id, layer_id.temporal_layer_id);
1204
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001205 // Encoder may reference several spatial layers on the same previous
1206 // frame in case if some spatial layers are skipped on the current frame.
1207 // We shouldn't put duplicate references as it may break some old
1208 // clients and isn't RTP compatible.
1209 if (std::find(ref_pid_list.begin(), ref_pid_list.end(),
1210 ref_buf.pic_num) != ref_pid_list.end()) {
1211 continue;
1212 }
1213 ref_pid_list.push_back(ref_buf.pic_num);
1214
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001215 const size_t p_diff = pic_num - ref_buf.pic_num;
1216 RTC_DCHECK_LE(p_diff, 127UL);
1217
1218 vp9_info->p_diff[vp9_info->num_ref_pics] = static_cast<uint8_t>(p_diff);
1219 ++vp9_info->num_ref_pics;
1220
1221 max_ref_temporal_layer_id =
1222 std::max(max_ref_temporal_layer_id, ref_buf.temporal_layer_id);
1223 } else {
1224 RTC_DCHECK(inter_layer_predicted);
1225 // RTP spec only allows to use previous spatial layer for inter-layer
1226 // prediction.
1227 RTC_DCHECK_EQ(ref_buf.spatial_layer_id + 1, layer_id.spatial_layer_id);
1228 }
1229 }
1230
1231 vp9_info->temporal_up_switch =
1232 (max_ref_temporal_layer_id <
1233 static_cast<size_t>(layer_id.temporal_layer_id));
1234}
1235
1236void VP9EncoderImpl::UpdateReferenceBuffers(const vpx_codec_cx_pkt& pkt,
1237 const size_t pic_num) {
1238 vpx_svc_layer_id_t layer_id = {0};
1239 vpx_codec_control(encoder_, VP9E_GET_SVC_LAYER_ID, &layer_id);
1240
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001241 RefFrameBuffer frame_buf(pic_num, layer_id.spatial_layer_id,
1242 layer_id.temporal_layer_id);
1243
Sergey Silkin38fabff2019-03-21 10:08:40 +01001244 if (is_svc_) {
Sergey Silkin76be2952018-08-21 12:30:33 +02001245 vpx_svc_ref_frame_config_t enc_layer_conf = {{0}};
1246 vpx_codec_control(encoder_, VP9E_GET_SVC_REF_FRAME_CONFIG, &enc_layer_conf);
Sergey Silkin38fabff2019-03-21 10:08:40 +01001247 const int update_buffer_slot =
1248 enc_layer_conf.update_buffer_slot[layer_id.spatial_layer_id];
Sergey Silkin76be2952018-08-21 12:30:33 +02001249
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001250 for (size_t i = 0; i < kNumVp9Buffers; ++i) {
Sergey Silkin38fabff2019-03-21 10:08:40 +01001251 if (update_buffer_slot & (1 << i)) {
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001252 ref_buf_[i] = frame_buf;
1253 }
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001254 }
Sergey Silkin38fabff2019-03-21 10:08:40 +01001255
1256 RTC_LOG(LS_VERBOSE) << "Frame " << pic_num << " sl "
1257 << layer_id.spatial_layer_id << " tl "
1258 << layer_id.temporal_layer_id << " updated buffers "
1259 << (update_buffer_slot & (1 << 0) ? 1 : 0)
1260 << (update_buffer_slot & (1 << 1) ? 1 : 0)
1261 << (update_buffer_slot & (1 << 2) ? 1 : 0)
1262 << (update_buffer_slot & (1 << 3) ? 1 : 0)
1263 << (update_buffer_slot & (1 << 4) ? 1 : 0)
1264 << (update_buffer_slot & (1 << 5) ? 1 : 0)
1265 << (update_buffer_slot & (1 << 6) ? 1 : 0)
1266 << (update_buffer_slot & (1 << 7) ? 1 : 0);
Sergey Silkin76be2952018-08-21 12:30:33 +02001267 } else {
1268 RTC_DCHECK_EQ(num_spatial_layers_, 1);
1269 RTC_DCHECK_EQ(num_temporal_layers_, 1);
1270 // In non-svc mode encoder doesn't provide reference list. Assume each frame
1271 // is reference and stored in buffer 0.
1272 ref_buf_[0] = frame_buf;
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001273 }
1274}
1275
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001276vpx_svc_ref_frame_config_t VP9EncoderImpl::SetReferences(
1277 bool is_key_pic,
1278 size_t first_active_spatial_layer_id) {
Sergey Silkin390f3582018-10-01 17:13:50 +02001279 // kRefBufIdx, kUpdBufIdx need to be updated to support longer GOFs.
1280 RTC_DCHECK_LE(gof_.num_frames_in_gof, 4);
1281
1282 vpx_svc_ref_frame_config_t ref_config;
1283 memset(&ref_config, 0, sizeof(ref_config));
1284
1285 const size_t num_temporal_refs = std::max(1, num_temporal_layers_ - 1);
1286 const bool is_inter_layer_pred_allowed =
1287 inter_layer_pred_ == InterLayerPredMode::kOn ||
1288 (inter_layer_pred_ == InterLayerPredMode::kOnKeyPic && is_key_pic);
1289 absl::optional<int> last_updated_buf_idx;
1290
1291 // Put temporal reference to LAST and spatial reference to GOLDEN. Update
1292 // frame buffer (i.e. store encoded frame) if current frame is a temporal
1293 // reference (i.e. it belongs to a low temporal layer) or it is a spatial
1294 // reference. In later case, always store spatial reference in the last
1295 // reference frame buffer.
1296 // For the case of 3 temporal and 3 spatial layers we need 6 frame buffers
1297 // for temporal references plus 1 buffer for spatial reference. 7 buffers
1298 // in total.
1299
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001300 for (size_t sl_idx = first_active_spatial_layer_id;
1301 sl_idx < num_active_spatial_layers_; ++sl_idx) {
1302 const size_t curr_pic_num = is_key_pic ? 0 : pics_since_key_ + 1;
1303 const size_t gof_idx = curr_pic_num % gof_.num_frames_in_gof;
Sergey Silkin390f3582018-10-01 17:13:50 +02001304
1305 if (!is_key_pic) {
1306 // Set up temporal reference.
1307 const int buf_idx = sl_idx * num_temporal_refs + kRefBufIdx[gof_idx];
1308
1309 // Last reference frame buffer is reserved for spatial reference. It is
1310 // not supposed to be used for temporal prediction.
1311 RTC_DCHECK_LT(buf_idx, kNumVp9Buffers - 1);
1312
1313 // Sanity check that reference picture number is smaller than current
1314 // picture number.
Sergey Silkin390f3582018-10-01 17:13:50 +02001315 RTC_DCHECK_LT(ref_buf_[buf_idx].pic_num, curr_pic_num);
1316 const size_t pid_diff = curr_pic_num - ref_buf_[buf_idx].pic_num;
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001317 // Incorrect spatial layer may be in the buffer due to a key-frame.
1318 const bool same_spatial_layer =
1319 ref_buf_[buf_idx].spatial_layer_id == sl_idx;
1320 bool correct_pid = false;
1321 if (different_framerates_used_) {
1322 correct_pid = pid_diff < kMaxAllowedPidDIff;
1323 } else {
1324 // Below code assumes single temporal referecence.
1325 RTC_DCHECK_EQ(gof_.num_ref_pics[gof_idx], 1);
1326 correct_pid = pid_diff == gof_.pid_diff[gof_idx][0];
1327 }
Sergey Silkin390f3582018-10-01 17:13:50 +02001328
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001329 if (same_spatial_layer && correct_pid) {
Sergey Silkin390f3582018-10-01 17:13:50 +02001330 ref_config.lst_fb_idx[sl_idx] = buf_idx;
1331 ref_config.reference_last[sl_idx] = 1;
1332 } else {
1333 // This reference doesn't match with one specified by GOF. This can
1334 // only happen if spatial layer is enabled dynamically without key
1335 // frame. Spatial prediction is supposed to be enabled in this case.
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001336 RTC_DCHECK(is_inter_layer_pred_allowed &&
1337 sl_idx > first_active_spatial_layer_id);
Sergey Silkin390f3582018-10-01 17:13:50 +02001338 }
1339 }
1340
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001341 if (is_inter_layer_pred_allowed && sl_idx > first_active_spatial_layer_id) {
Sergey Silkin390f3582018-10-01 17:13:50 +02001342 // Set up spatial reference.
1343 RTC_DCHECK(last_updated_buf_idx);
1344 ref_config.gld_fb_idx[sl_idx] = *last_updated_buf_idx;
1345 ref_config.reference_golden[sl_idx] = 1;
1346 } else {
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001347 RTC_DCHECK(ref_config.reference_last[sl_idx] != 0 ||
1348 sl_idx == first_active_spatial_layer_id ||
Sergey Silkin390f3582018-10-01 17:13:50 +02001349 inter_layer_pred_ == InterLayerPredMode::kOff);
1350 }
1351
1352 last_updated_buf_idx.reset();
1353
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001354 if (gof_.temporal_idx[gof_idx] < num_temporal_layers_ - 1 ||
1355 num_temporal_layers_ == 1) {
Sergey Silkin390f3582018-10-01 17:13:50 +02001356 last_updated_buf_idx = sl_idx * num_temporal_refs + kUpdBufIdx[gof_idx];
1357
1358 // Ensure last frame buffer is not used for temporal prediction (it is
1359 // reserved for spatial reference).
1360 RTC_DCHECK_LT(*last_updated_buf_idx, kNumVp9Buffers - 1);
1361 } else if (is_inter_layer_pred_allowed) {
1362 last_updated_buf_idx = kNumVp9Buffers - 1;
1363 }
1364
1365 if (last_updated_buf_idx) {
1366 ref_config.update_buffer_slot[sl_idx] = 1 << *last_updated_buf_idx;
1367 }
1368 }
1369
1370 return ref_config;
1371}
1372
asaperssona9455ab2015-07-31 06:10:09 -07001373int VP9EncoderImpl::GetEncodedLayerFrame(const vpx_codec_cx_pkt* pkt) {
asapersson86956de2016-01-26 01:05:20 -08001374 RTC_DCHECK_EQ(pkt->kind, VPX_CODEC_CX_FRAME_PKT);
asaperssona9455ab2015-07-31 06:10:09 -07001375
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001376 if (pkt->data.frame.sz == 0) {
1377 // Ignore dropped frame.
1378 return WEBRTC_VIDEO_CODEC_OK;
1379 }
1380
Sergey Silkin07f80cc2018-04-09 13:11:59 +02001381 vpx_svc_layer_id_t layer_id = {0};
1382 vpx_codec_control(encoder_, VP9E_GET_SVC_LAYER_ID, &layer_id);
1383
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001384 if (!full_superframe_drop_) {
1385 // Deliver buffered low spatial layer frame.
1386 const bool end_of_picture = false;
1387 DeliverBufferedFrame(end_of_picture);
1388 }
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001389
Niels Möller48a79462018-12-07 16:21:18 +01001390 if (pkt->data.frame.sz > encoded_image_.capacity()) {
Niels Möllerdd1cc982019-02-07 18:52:50 +01001391 encoded_image_.Allocate(pkt->data.frame.sz);
asaperssond9f641e2016-01-21 01:11:35 -08001392 }
Niels Möller24871e42019-01-17 11:31:13 +01001393 memcpy(encoded_image_.data(), pkt->data.frame.buf, pkt->data.frame.sz);
Niels Möller77536a22019-01-15 08:50:01 +01001394 encoded_image_.set_size(pkt->data.frame.sz);
asaperssond9f641e2016-01-21 01:11:35 -08001395
Sergey Silkinbd0954e2018-05-03 14:14:09 +02001396 const bool is_key_frame =
1397 (pkt->data.frame.flags & VPX_FRAME_IS_KEY) ? true : false;
1398 // Ensure encoder issued key frame on request.
1399 RTC_DCHECK(is_key_frame || !force_key_frame_);
1400
asaperssona9455ab2015-07-31 06:10:09 -07001401 // Check if encoded frame is a key frame.
Niels Möller8f7ce222019-03-21 15:43:58 +01001402 encoded_image_._frameType = VideoFrameType::kVideoFrameDelta;
Sergey Silkinbd0954e2018-05-03 14:14:09 +02001403 if (is_key_frame) {
Niels Möller8f7ce222019-03-21 15:43:58 +01001404 encoded_image_._frameType = VideoFrameType::kVideoFrameKey;
Sergey Silkinbd0954e2018-05-03 14:14:09 +02001405 force_key_frame_ = false;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001406 }
Niels Möller77536a22019-01-15 08:50:01 +01001407 RTC_DCHECK_LE(encoded_image_.size(), encoded_image_.capacity());
asapersson86956de2016-01-26 01:05:20 -08001408
philipeld1d03592019-03-01 13:53:55 +01001409 codec_specific_ = {};
Niels Möllerd3b8c632018-08-27 15:33:42 +02001410 absl::optional<int> spatial_index;
1411 PopulateCodecSpecific(&codec_specific_, &spatial_index, *pkt,
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001412 input_image_->timestamp());
Niels Möllerd3b8c632018-08-27 15:33:42 +02001413 encoded_image_.SetSpatialIndex(spatial_index);
asaperssona9455ab2015-07-31 06:10:09 -07001414
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +01001415 UpdateReferenceBuffers(*pkt, pics_since_key_);
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001416
Niels Möller77536a22019-01-15 08:50:01 +01001417 TRACE_COUNTER1("webrtc", "EncodedFrameSize", encoded_image_.size());
Niels Möller23775882018-08-16 10:24:12 +02001418 encoded_image_.SetTimestamp(input_image_->timestamp());
Ilya Nikolaevskiy00d0a0a2019-04-23 14:55:33 +02001419
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001420 encoded_image_._encodedHeight =
1421 pkt->data.frame.height[layer_id.spatial_layer_id];
1422 encoded_image_._encodedWidth =
1423 pkt->data.frame.width[layer_id.spatial_layer_id];
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001424 int qp = -1;
1425 vpx_codec_control(encoder_, VP8E_GET_LAST_QUANTIZER, &qp);
1426 encoded_image_.qp_ = qp;
ilnik04f4d122017-06-19 07:18:55 -07001427
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001428 if (full_superframe_drop_) {
1429 const bool end_of_picture = encoded_image_.SpatialIndex().value_or(0) + 1 ==
1430 num_active_spatial_layers_;
1431 DeliverBufferedFrame(end_of_picture);
1432 }
1433
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001434 return WEBRTC_VIDEO_CODEC_OK;
1435}
1436
Sergey Silkinbc0f0d32018-04-24 21:29:14 +02001437void VP9EncoderImpl::DeliverBufferedFrame(bool end_of_picture) {
Niels Möller77536a22019-01-15 08:50:01 +01001438 if (encoded_image_.size() > 0) {
Sergey Silkinbc0f0d32018-04-24 21:29:14 +02001439 codec_specific_.codecSpecific.VP9.end_of_picture = end_of_picture;
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001440
1441 // No data partitioning in VP9, so 1 partition only.
1442 int part_idx = 0;
1443 RTPFragmentationHeader frag_info;
1444 frag_info.VerifyAndAllocateFragmentationHeader(1);
1445 frag_info.fragmentationOffset[part_idx] = 0;
Niels Möller77536a22019-01-15 08:50:01 +01001446 frag_info.fragmentationLength[part_idx] = encoded_image_.size();
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001447 frag_info.fragmentationPlType[part_idx] = 0;
1448 frag_info.fragmentationTimeDiff[part_idx] = 0;
1449
1450 encoded_complete_callback_->OnEncodedImage(encoded_image_, &codec_specific_,
1451 &frag_info);
Sergey Silkind902d582018-05-18 17:31:19 +02001452
Sergey Silkin96f2c972018-09-05 21:07:17 +02001453 if (codec_.mode == VideoCodecMode::kScreensharing) {
1454 const uint8_t spatial_idx = encoded_image_.SpatialIndex().value_or(0);
1455 const uint32_t frame_timestamp_ms =
Niels Möller23775882018-08-16 10:24:12 +02001456 1000 * encoded_image_.Timestamp() / kVideoPayloadTypeFrequency;
Sergey Silkin96f2c972018-09-05 21:07:17 +02001457 framerate_controller_[spatial_idx].AddFrame(frame_timestamp_ms);
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +01001458
1459 const size_t steady_state_size = SteadyStateSize(
1460 spatial_idx, codec_specific_.codecSpecific.VP9.temporal_idx);
1461
1462 // Only frames on spatial layers, which may be limited in a steady state
1463 // are considered for steady state detection.
1464 if (framerate_controller_[spatial_idx].GetTargetRate() >
1465 variable_framerate_experiment_.framerate_limit + 1e-9) {
1466 if (encoded_image_.qp_ <=
1467 variable_framerate_experiment_.steady_state_qp &&
1468 encoded_image_.size() <= steady_state_size) {
1469 ++num_steady_state_frames_;
1470 } else {
1471 num_steady_state_frames_ = 0;
1472 }
1473 }
Sergey Silkind902d582018-05-18 17:31:19 +02001474 }
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +01001475 encoded_image_.set_size(0);
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001476 }
1477}
1478
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001479int VP9EncoderImpl::RegisterEncodeCompleteCallback(
1480 EncodedImageCallback* callback) {
1481 encoded_complete_callback_ = callback;
1482 return WEBRTC_VIDEO_CODEC_OK;
1483}
1484
Erik Språng727d1642018-11-07 16:54:15 +01001485VideoEncoder::EncoderInfo VP9EncoderImpl::GetEncoderInfo() const {
1486 EncoderInfo info;
1487 info.supports_native_handle = false;
1488 info.implementation_name = "libvpx";
1489 info.scaling_settings = VideoEncoder::ScalingSettings::kOff;
Erik Språngd3438aa2018-11-08 16:56:43 +01001490 info.has_trusted_rate_controller = trusted_rate_controller_;
Mirta Dvornicic897a9912018-11-30 13:12:21 +01001491 info.is_hardware_accelerated = false;
1492 info.has_internal_source = false;
Erik Språngdbdd8392019-01-17 15:27:50 +01001493 for (size_t si = 0; si < num_spatial_layers_; ++si) {
1494 info.fps_allocation[si].clear();
1495 if (!codec_.spatialLayers[si].active) {
1496 continue;
1497 }
1498 // This spatial layer may already use a fraction of the total frame rate.
1499 const float sl_fps_fraction =
1500 codec_.spatialLayers[si].maxFramerate / codec_.maxFramerate;
1501 for (size_t ti = 0; ti < num_temporal_layers_; ++ti) {
1502 const uint32_t decimator =
1503 num_temporal_layers_ <= 1 ? 1 : config_->ts_rate_decimator[ti];
1504 RTC_DCHECK_GT(decimator, 0);
1505 info.fps_allocation[si].push_back(rtc::saturated_cast<uint8_t>(
1506 EncoderInfo::kMaxFramerateFraction * (sl_fps_fraction / decimator)));
1507 }
1508 }
Erik Språng727d1642018-11-07 16:54:15 +01001509 return info;
Peter Boströmb7d9a972015-12-18 16:01:11 +01001510}
1511
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +01001512size_t VP9EncoderImpl::SteadyStateSize(int sid, int tid) {
1513 const size_t bitrate_bps = current_bitrate_allocation_.GetBitrate(
1514 sid, tid == kNoTemporalIdx ? 0 : tid);
1515 const float fps = (codec_.mode == VideoCodecMode::kScreensharing)
1516 ? framerate_controller_[sid].GetTargetRate()
1517 : codec_.maxFramerate;
1518 return static_cast<size_t>(
1519 bitrate_bps / (8 * fps) *
1520 (100 -
1521 variable_framerate_experiment_.steady_state_undershoot_percentage) /
1522 100 +
1523 0.5);
1524}
1525
1526// static
1527VP9EncoderImpl::VariableFramerateExperiment
1528VP9EncoderImpl::ParseVariableFramerateConfig(std::string group_name) {
1529 FieldTrialFlag enabled = FieldTrialFlag("Enabled");
1530 FieldTrialParameter<double> framerate_limit("min_fps", 5.0);
1531 FieldTrialParameter<int> qp("min_qp", 32);
1532 FieldTrialParameter<int> undershoot_percentage("undershoot", 30);
1533 FieldTrialParameter<int> frames_before_steady_state(
1534 "frames_before_steady_state", 5);
1535 ParseFieldTrial({&enabled, &framerate_limit, &qp, &undershoot_percentage,
1536 &frames_before_steady_state},
1537 field_trial::FindFullName(group_name));
1538 VariableFramerateExperiment config;
1539 config.enabled = enabled.Get();
1540 config.framerate_limit = framerate_limit.Get();
1541 config.steady_state_qp = qp.Get();
1542 config.steady_state_undershoot_percentage = undershoot_percentage.Get();
1543 config.frames_before_steady_state = frames_before_steady_state.Get();
1544
1545 return config;
1546}
1547
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001548VP9DecoderImpl::VP9DecoderImpl()
sprang3958ed82017-08-17 08:12:10 -07001549 : decode_complete_callback_(nullptr),
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001550 inited_(false),
sprang3958ed82017-08-17 08:12:10 -07001551 decoder_(nullptr),
philipel9d7d75b2018-04-04 13:03:01 +02001552 key_frame_required_(true) {}
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001553
1554VP9DecoderImpl::~VP9DecoderImpl() {
1555 inited_ = true; // in order to do the actual release
1556 Release();
Henrik Boström9695d852015-05-06 10:42:15 +02001557 int num_buffers_in_use = frame_buffer_pool_.GetNumBuffersInUse();
1558 if (num_buffers_in_use > 0) {
1559 // The frame buffers are reference counted and frames are exposed after
1560 // decoding. There may be valid usage cases where previous frames are still
1561 // referenced after ~VP9DecoderImpl that is not a leak.
Mirko Bonadei675513b2017-11-09 11:09:25 +01001562 RTC_LOG(LS_INFO) << num_buffers_in_use << " Vp9FrameBuffers are still "
1563 << "referenced during ~VP9DecoderImpl.";
Henrik Boström9695d852015-05-06 10:42:15 +02001564 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001565}
1566
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001567int VP9DecoderImpl::InitDecode(const VideoCodec* inst, int number_of_cores) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001568 int ret_val = Release();
1569 if (ret_val < 0) {
1570 return ret_val;
1571 }
Sergey Silkinb674cd12018-10-09 10:59:06 +02001572
sprang3958ed82017-08-17 08:12:10 -07001573 if (decoder_ == nullptr) {
pbos@webrtc.orge728ee02014-12-17 13:43:55 +00001574 decoder_ = new vpx_codec_ctx_t;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001575 }
philipelcce46fc2015-12-21 03:04:49 -08001576 vpx_codec_dec_cfg_t cfg;
Sergey Silkinb674cd12018-10-09 10:59:06 +02001577 memset(&cfg, 0, sizeof(cfg));
1578
1579 // We want to use multithreading when decoding high resolution videos. But,
1580 // since we don't know resolution of input stream at this stage, we always
1581 // enable it.
1582 cfg.threads = std::min(number_of_cores, kMaxNumTiles4kVideo);
1583
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001584 vpx_codec_flags_t flags = 0;
1585 if (vpx_codec_dec_init(decoder_, vpx_codec_vp9_dx(), &cfg, flags)) {
1586 return WEBRTC_VIDEO_CODEC_MEMORY;
1587 }
Henrik Boström9695d852015-05-06 10:42:15 +02001588
1589 if (!frame_buffer_pool_.InitializeVpxUsePool(decoder_)) {
1590 return WEBRTC_VIDEO_CODEC_MEMORY;
1591 }
1592
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001593 inited_ = true;
1594 // Always start with a complete key frame.
1595 key_frame_required_ = true;
1596 return WEBRTC_VIDEO_CODEC_OK;
1597}
1598
1599int VP9DecoderImpl::Decode(const EncodedImage& input_image,
1600 bool missing_frames,
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001601 int64_t /*render_time_ms*/) {
1602 if (!inited_) {
1603 return WEBRTC_VIDEO_CODEC_UNINITIALIZED;
1604 }
sprang3958ed82017-08-17 08:12:10 -07001605 if (decode_complete_callback_ == nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001606 return WEBRTC_VIDEO_CODEC_UNINITIALIZED;
1607 }
1608 // Always start with a complete key frame.
1609 if (key_frame_required_) {
Niels Möller8f7ce222019-03-21 15:43:58 +01001610 if (input_image._frameType != VideoFrameType::kVideoFrameKey)
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001611 return WEBRTC_VIDEO_CODEC_ERROR;
1612 // We have a key frame - is it complete?
1613 if (input_image._completeFrame) {
1614 key_frame_required_ = false;
1615 } else {
1616 return WEBRTC_VIDEO_CODEC_ERROR;
1617 }
1618 }
sprang3958ed82017-08-17 08:12:10 -07001619 vpx_codec_iter_t iter = nullptr;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001620 vpx_image_t* img;
Niels Möller24871e42019-01-17 11:31:13 +01001621 const uint8_t* buffer = input_image.data();
Niels Möller77536a22019-01-15 08:50:01 +01001622 if (input_image.size() == 0) {
sprang3958ed82017-08-17 08:12:10 -07001623 buffer = nullptr; // Triggers full frame concealment.
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001624 }
Henrik Boström9695d852015-05-06 10:42:15 +02001625 // During decode libvpx may get and release buffers from |frame_buffer_pool_|.
1626 // In practice libvpx keeps a few (~3-4) buffers alive at a time.
philipelcce46fc2015-12-21 03:04:49 -08001627 if (vpx_codec_decode(decoder_, buffer,
Niels Möller77536a22019-01-15 08:50:01 +01001628 static_cast<unsigned int>(input_image.size()), 0,
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001629 VPX_DL_REALTIME)) {
1630 return WEBRTC_VIDEO_CODEC_ERROR;
1631 }
Henrik Boström9695d852015-05-06 10:42:15 +02001632 // |img->fb_priv| contains the image data, a reference counted Vp9FrameBuffer.
1633 // It may be released by libvpx during future vpx_codec_decode or
1634 // vpx_codec_destroy calls.
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001635 img = vpx_codec_get_frame(decoder_, &iter);
sakal7adadb12017-02-23 02:54:57 -08001636 int qp;
1637 vpx_codec_err_t vpx_ret =
1638 vpx_codec_control(decoder_, VPXD_GET_LAST_QUANTIZER, &qp);
1639 RTC_DCHECK_EQ(vpx_ret, VPX_CODEC_OK);
Ilya Nikolaevskiy00d0a0a2019-04-23 14:55:33 +02001640 int ret = ReturnFrame(img, input_image.Timestamp(), qp);
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001641 if (ret != 0) {
1642 return ret;
1643 }
1644 return WEBRTC_VIDEO_CODEC_OK;
1645}
1646
Ilya Nikolaevskiy00d0a0a2019-04-23 14:55:33 +02001647int VP9DecoderImpl::ReturnFrame(const vpx_image_t* img,
1648 uint32_t timestamp,
1649 int qp) {
sprang3958ed82017-08-17 08:12:10 -07001650 if (img == nullptr) {
1651 // Decoder OK and nullptr image => No show frame.
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001652 return WEBRTC_VIDEO_CODEC_NO_OUTPUT;
1653 }
Henrik Boström9695d852015-05-06 10:42:15 +02001654
1655 // This buffer contains all of |img|'s image data, a reference counted
perkj14f41442015-11-30 22:15:45 -08001656 // Vp9FrameBuffer. (libvpx is done with the buffers after a few
Henrik Boström9695d852015-05-06 10:42:15 +02001657 // vpx_codec_decode calls or vpx_codec_destroy).
1658 Vp9FrameBufferPool::Vp9FrameBuffer* img_buffer =
1659 static_cast<Vp9FrameBufferPool::Vp9FrameBuffer*>(img->fb_priv);
Emircan Uysaler0823eec2018-07-13 17:10:00 -07001660
Miguel Casas-Sanchez47650702015-05-29 17:21:40 -07001661 // The buffer can be used directly by the VideoFrame (without copy) by
Emircan Uysaler0823eec2018-07-13 17:10:00 -07001662 // using a Wrapped*Buffer.
1663 rtc::scoped_refptr<VideoFrameBuffer> img_wrapped_buffer;
1664 switch (img->bit_depth) {
1665 case 8:
1666 img_wrapped_buffer = WrapI420Buffer(
philipelcce46fc2015-12-21 03:04:49 -08001667 img->d_w, img->d_h, img->planes[VPX_PLANE_Y],
1668 img->stride[VPX_PLANE_Y], img->planes[VPX_PLANE_U],
1669 img->stride[VPX_PLANE_U], img->planes[VPX_PLANE_V],
1670 img->stride[VPX_PLANE_V],
Henrik Boström9695d852015-05-06 10:42:15 +02001671 // WrappedI420Buffer's mechanism for allowing the release of its frame
1672 // buffer is through a callback function. This is where we should
1673 // release |img_buffer|.
Emircan Uysaler0823eec2018-07-13 17:10:00 -07001674 rtc::KeepRefUntilDone(img_buffer));
1675 break;
1676 case 10:
1677 img_wrapped_buffer = WrapI010Buffer(
1678 img->d_w, img->d_h,
1679 reinterpret_cast<const uint16_t*>(img->planes[VPX_PLANE_Y]),
1680 img->stride[VPX_PLANE_Y] / 2,
1681 reinterpret_cast<const uint16_t*>(img->planes[VPX_PLANE_U]),
1682 img->stride[VPX_PLANE_U] / 2,
1683 reinterpret_cast<const uint16_t*>(img->planes[VPX_PLANE_V]),
1684 img->stride[VPX_PLANE_V] / 2, rtc::KeepRefUntilDone(img_buffer));
1685 break;
1686 default:
1687 RTC_NOTREACHED();
1688 return WEBRTC_VIDEO_CODEC_NO_OUTPUT;
1689 }
nisseca6d5d12016-06-17 05:03:04 -07001690
Johannes Kron4749e4e2018-11-21 10:18:18 +01001691 auto builder = VideoFrame::Builder()
1692 .set_video_frame_buffer(img_wrapped_buffer)
Johannes Kron4749e4e2018-11-21 10:18:18 +01001693 .set_timestamp_rtp(timestamp)
Ilya Nikolaevskiy00d0a0a2019-04-23 14:55:33 +02001694 .set_color_space(ExtractVP9ColorSpace(img->cs, img->range,
1695 img->bit_depth));
Johannes Kron4749e4e2018-11-21 10:18:18 +01001696
1697 VideoFrame decoded_image = builder.build();
1698
Danil Chapovalov0040b662018-06-18 10:48:16 +02001699 decode_complete_callback_->Decoded(decoded_image, absl::nullopt, qp);
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001700 return WEBRTC_VIDEO_CODEC_OK;
1701}
1702
1703int VP9DecoderImpl::RegisterDecodeCompleteCallback(
1704 DecodedImageCallback* callback) {
1705 decode_complete_callback_ = callback;
1706 return WEBRTC_VIDEO_CODEC_OK;
1707}
1708
1709int VP9DecoderImpl::Release() {
Sergey Silkin3e871ea2018-03-02 13:11:04 +01001710 int ret_val = WEBRTC_VIDEO_CODEC_OK;
1711
sprang3958ed82017-08-17 08:12:10 -07001712 if (decoder_ != nullptr) {
Sergey Silkin90399692018-03-02 14:44:10 +01001713 if (inited_) {
1714 // When a codec is destroyed libvpx will release any buffers of
1715 // |frame_buffer_pool_| it is currently using.
1716 if (vpx_codec_destroy(decoder_)) {
1717 ret_val = WEBRTC_VIDEO_CODEC_MEMORY;
1718 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001719 }
1720 delete decoder_;
sprang3958ed82017-08-17 08:12:10 -07001721 decoder_ = nullptr;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001722 }
Henrik Boström9695d852015-05-06 10:42:15 +02001723 // Releases buffers from the pool. Any buffers not in use are deleted. Buffers
1724 // still referenced externally are deleted once fully released, not returning
1725 // to the pool.
1726 frame_buffer_pool_.ClearPool();
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001727 inited_ = false;
Sergey Silkin3e871ea2018-03-02 13:11:04 +01001728 return ret_val;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001729}
Peter Boströmb7d9a972015-12-18 16:01:11 +01001730
1731const char* VP9DecoderImpl::ImplementationName() const {
1732 return "libvpx";
1733}
1734
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001735} // namespace webrtc
Mirko Bonadei95adedb2018-11-19 09:52:37 +01001736
1737#endif // RTC_ENABLE_VP9