blob: e8e40ee67bffe4232ba836e9a98984e18c38654e [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.
Erik Språngeb180f82019-05-23 13:55:24 +020057struct Vp9RateSettings {
Erik Språng7a3fe892019-04-15 12:22:55 +020058 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
Erik Språngeb180f82019-05-23 13:55:24 +0200164Vp9RateSettings GetRateSettings(double bandwidth_headroom_factor) {
165 static const Vp9RateSettings low_settings{100u, 0u, 100u, 33u, 40u};
166 static const Vp9RateSettings high_settings{50u, 50u, 1000u, 700u, 5u};
Erik Språng7a3fe892019-04-15 12:22:55 +0200167
168 if (bandwidth_headroom_factor <= kLowRateFactor) {
169 return low_settings;
170 } else if (bandwidth_headroom_factor >= kHighRateFactor) {
171 return high_settings;
172 }
173
Erik Språngeb180f82019-05-23 13:55:24 +0200174 Vp9RateSettings settings;
Erik Språng7a3fe892019-04-15 12:22:55 +0200175 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,
Erik Språngeb180f82019-05-23 13:55:24 +0200194 const Vp9RateSettings& new_settings) {
Erik Språng7a3fe892019-04-15 12:22:55 +0200195 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
Elad Alon8f01c4e2019-06-28 15:19:43 +0200254void VP9EncoderImpl::SetFecControllerOverride(
255 FecControllerOverride* fec_controller_override) {
256 // Ignored.
257}
258
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000259int VP9EncoderImpl::Release() {
Sergey Silkin3e871ea2018-03-02 13:11:04 +0100260 int ret_val = WEBRTC_VIDEO_CODEC_OK;
261
Niels Möllerdd1cc982019-02-07 18:52:50 +0100262 encoded_image_.Allocate(0);
sprang3958ed82017-08-17 08:12:10 -0700263 if (encoder_ != nullptr) {
Sergey Silkin90399692018-03-02 14:44:10 +0100264 if (inited_) {
265 if (vpx_codec_destroy(encoder_)) {
266 ret_val = WEBRTC_VIDEO_CODEC_MEMORY;
267 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000268 }
269 delete encoder_;
sprang3958ed82017-08-17 08:12:10 -0700270 encoder_ = nullptr;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000271 }
sprang3958ed82017-08-17 08:12:10 -0700272 if (config_ != nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000273 delete config_;
sprang3958ed82017-08-17 08:12:10 -0700274 config_ = nullptr;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000275 }
sprang3958ed82017-08-17 08:12:10 -0700276 if (raw_ != nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000277 vpx_img_free(raw_);
sprang3958ed82017-08-17 08:12:10 -0700278 raw_ = nullptr;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000279 }
280 inited_ = false;
Sergey Silkin3e871ea2018-03-02 13:11:04 +0100281 return ret_val;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000282}
283
sprangce4aef12015-11-02 07:23:20 -0800284bool VP9EncoderImpl::ExplicitlyConfiguredSpatialLayers() const {
285 // We check target_bitrate_bps of the 0th layer to see if the spatial layers
286 // (i.e. bitrates) were explicitly configured.
Sergey Silkinbeba1b22018-09-11 11:40:25 +0200287 return codec_.spatialLayers[0].targetBitrate > 0;
sprangce4aef12015-11-02 07:23:20 -0800288}
289
Erik Språng566124a2018-04-23 12:32:22 +0200290bool VP9EncoderImpl::SetSvcRates(
291 const VideoBitrateAllocation& bitrate_allocation) {
Sergey Silkin86684962018-03-28 19:32:37 +0200292 config_->rc_target_bitrate = bitrate_allocation.get_sum_kbps();
Sergey Silkin86684962018-03-28 19:32:37 +0200293
sprangce4aef12015-11-02 07:23:20 -0800294 if (ExplicitlyConfiguredSpatialLayers()) {
Sergey Silkine7ce8882018-10-03 18:04:57 +0200295 const bool layer_activation_requires_key_frame =
296 inter_layer_pred_ == InterLayerPredMode::kOff ||
297 inter_layer_pred_ == InterLayerPredMode::kOnKeyPic;
298
Sergey Silkin86684962018-03-28 19:32:37 +0200299 for (size_t sl_idx = 0; sl_idx < num_spatial_layers_; ++sl_idx) {
Sergey Silkine7ce8882018-10-03 18:04:57 +0200300 const bool was_layer_active = (config_->ss_target_bitrate[sl_idx] > 0);
Sergey Silkin86684962018-03-28 19:32:37 +0200301 config_->ss_target_bitrate[sl_idx] =
302 bitrate_allocation.GetSpatialLayerSum(sl_idx) / 1000;
303
304 for (size_t tl_idx = 0; tl_idx < num_temporal_layers_; ++tl_idx) {
305 config_->layer_target_bitrate[sl_idx * num_temporal_layers_ + tl_idx] =
306 bitrate_allocation.GetTemporalLayerSum(sl_idx, tl_idx) / 1000;
307 }
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200308
Sergey Silkine7ce8882018-10-03 18:04:57 +0200309 const bool is_active_layer = (config_->ss_target_bitrate[sl_idx] > 0);
310 if (!was_layer_active && is_active_layer &&
311 layer_activation_requires_key_frame) {
312 force_key_frame_ = true;
313 } else if (was_layer_active && !is_active_layer &&
314 layer_deactivation_requires_key_frame_) {
315 force_key_frame_ = true;
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200316 }
Sergey Silkin96f2c972018-09-05 21:07:17 +0200317
Sergey Silkine7ce8882018-10-03 18:04:57 +0200318 if (!was_layer_active) {
Sergey Silkin96f2c972018-09-05 21:07:17 +0200319 // Reset frame rate controller if layer is resumed after pause.
320 framerate_controller_[sl_idx].Reset();
321 }
322
323 framerate_controller_[sl_idx].SetTargetRate(
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +0200324 codec_.spatialLayers[sl_idx].maxFramerate);
sprangce4aef12015-11-02 07:23:20 -0800325 }
326 } else {
327 float rate_ratio[VPX_MAX_LAYERS] = {0};
328 float total = 0;
Sergey Silkin908689d2018-08-20 09:28:45 +0200329 for (int i = 0; i < num_spatial_layers_; ++i) {
johannkoenig8225c402017-01-26 13:23:44 -0800330 if (svc_params_.scaling_factor_num[i] <= 0 ||
331 svc_params_.scaling_factor_den[i] <= 0) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100332 RTC_LOG(LS_ERROR) << "Scaling factors not specified!";
sprangce4aef12015-11-02 07:23:20 -0800333 return false;
334 }
Yves Gerey665174f2018-06-19 15:03:05 +0200335 rate_ratio[i] = static_cast<float>(svc_params_.scaling_factor_num[i]) /
336 svc_params_.scaling_factor_den[i];
sprangce4aef12015-11-02 07:23:20 -0800337 total += rate_ratio[i];
338 }
339
Sergey Silkin908689d2018-08-20 09:28:45 +0200340 for (int i = 0; i < num_spatial_layers_; ++i) {
Rasmus Brandt58cd3852018-06-26 13:41:16 +0200341 RTC_CHECK_GT(total, 0);
sprangce4aef12015-11-02 07:23:20 -0800342 config_->ss_target_bitrate[i] = static_cast<unsigned int>(
343 config_->rc_target_bitrate * rate_ratio[i] / total);
344 if (num_temporal_layers_ == 1) {
345 config_->layer_target_bitrate[i] = config_->ss_target_bitrate[i];
346 } else if (num_temporal_layers_ == 2) {
347 config_->layer_target_bitrate[i * num_temporal_layers_] =
348 config_->ss_target_bitrate[i] * 2 / 3;
349 config_->layer_target_bitrate[i * num_temporal_layers_ + 1] =
350 config_->ss_target_bitrate[i];
351 } else if (num_temporal_layers_ == 3) {
352 config_->layer_target_bitrate[i * num_temporal_layers_] =
353 config_->ss_target_bitrate[i] / 2;
354 config_->layer_target_bitrate[i * num_temporal_layers_ + 1] =
355 config_->layer_target_bitrate[i * num_temporal_layers_] +
356 (config_->ss_target_bitrate[i] / 4);
357 config_->layer_target_bitrate[i * num_temporal_layers_ + 2] =
358 config_->ss_target_bitrate[i];
359 } else {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100360 RTC_LOG(LS_ERROR) << "Unsupported number of temporal layers: "
361 << num_temporal_layers_;
sprangce4aef12015-11-02 07:23:20 -0800362 return false;
363 }
Sergey Silkin96f2c972018-09-05 21:07:17 +0200364
365 framerate_controller_[i].SetTargetRate(codec_.maxFramerate);
asaperssona9455ab2015-07-31 06:10:09 -0700366 }
367 }
Sergey Silkin908689d2018-08-20 09:28:45 +0200368
369 num_active_spatial_layers_ = 0;
370 for (int i = 0; i < num_spatial_layers_; ++i) {
371 if (config_->ss_target_bitrate[i] > 0) {
372 ++num_active_spatial_layers_;
373 }
374 }
375 RTC_DCHECK_GT(num_active_spatial_layers_, 0);
376
asaperssona9455ab2015-07-31 06:10:09 -0700377 return true;
378}
379
Erik Språng16cb8f52019-04-12 13:59:09 +0200380void VP9EncoderImpl::SetRates(const RateControlParameters& parameters) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000381 if (!inited_) {
Erik Språng16cb8f52019-04-12 13:59:09 +0200382 RTC_LOG(LS_WARNING) << "SetRates() calll while uninitialzied.";
383 return;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000384 }
385 if (encoder_->err) {
Erik Språng16cb8f52019-04-12 13:59:09 +0200386 RTC_LOG(LS_WARNING) << "Encoder in error state: " << encoder_->err;
387 return;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000388 }
Erik Språng16cb8f52019-04-12 13:59:09 +0200389 if (parameters.framerate_fps < 1.0) {
390 RTC_LOG(LS_WARNING) << "Unsupported framerate: "
391 << parameters.framerate_fps;
392 return;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000393 }
Erik Språng08127a92016-11-16 16:41:30 +0100394
Erik Språng16cb8f52019-04-12 13:59:09 +0200395 codec_.maxFramerate = static_cast<uint32_t>(parameters.framerate_fps + 0.5);
Erik Språng7a3fe892019-04-15 12:22:55 +0200396 requested_rate_settings_ = parameters;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000397}
398
Elad Alon370f93a2019-06-11 14:57:57 +0200399// TODO(eladalon): s/inst/codec_settings/g.
Elad Alon11dfff02019-06-10 19:10:29 +0200400int VP9EncoderImpl::InitEncode(const VideoCodec* inst,
Elad Alon370f93a2019-06-11 14:57:57 +0200401 const Settings& settings) {
sprang3958ed82017-08-17 08:12:10 -0700402 if (inst == nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000403 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
404 }
405 if (inst->maxFramerate < 1) {
406 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
407 }
408 // Allow zero to represent an unspecified maxBitRate
409 if (inst->maxBitrate > 0 && inst->startBitrate > inst->maxBitrate) {
410 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
411 }
412 if (inst->width < 1 || inst->height < 1) {
413 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
414 }
Elad Alon370f93a2019-06-11 14:57:57 +0200415 if (settings.number_of_cores < 1) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000416 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
417 }
hta257dc392016-10-25 09:05:06 -0700418 if (inst->VP9().numberOfTemporalLayers > 3) {
asaperssona9455ab2015-07-31 06:10:09 -0700419 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
420 }
ilnik2a8c2f52017-02-15 02:23:28 -0800421 // libvpx probably does not support more than 3 spatial layers.
422 if (inst->VP9().numberOfSpatialLayers > 3) {
asaperssona9455ab2015-07-31 06:10:09 -0700423 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
424 }
philipelcfc319b2015-11-10 07:17:23 -0800425
asapersson86956de2016-01-26 01:05:20 -0800426 int ret_val = Release();
427 if (ret_val < 0) {
428 return ret_val;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000429 }
sprang3958ed82017-08-17 08:12:10 -0700430 if (encoder_ == nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000431 encoder_ = new vpx_codec_ctx_t;
432 }
sprang3958ed82017-08-17 08:12:10 -0700433 if (config_ == nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000434 config_ = new vpx_codec_enc_cfg_t;
435 }
436 timestamp_ = 0;
437 if (&codec_ != inst) {
438 codec_ = *inst;
439 }
asaperssona9455ab2015-07-31 06:10:09 -0700440
Sergey Silkinb0bd03b2018-09-28 14:56:39 +0200441 force_key_frame_ = true;
442 pics_since_key_ = 0;
443
hta257dc392016-10-25 09:05:06 -0700444 num_spatial_layers_ = inst->VP9().numberOfSpatialLayers;
Niels Möller65fb4042018-04-25 14:46:06 +0200445 RTC_DCHECK_GT(num_spatial_layers_, 0);
hta257dc392016-10-25 09:05:06 -0700446 num_temporal_layers_ = inst->VP9().numberOfTemporalLayers;
Sergey Silkin96f2c972018-09-05 21:07:17 +0200447 if (num_temporal_layers_ == 0) {
asaperssona9455ab2015-07-31 06:10:09 -0700448 num_temporal_layers_ = 1;
Sergey Silkin042661b2018-09-10 10:39:35 +0000449 }
Sergey Silkinae9e1882018-09-05 21:07:17 +0200450
Sergey Silkin96f2c972018-09-05 21:07:17 +0200451 framerate_controller_ = std::vector<FramerateController>(
452 num_spatial_layers_, FramerateController(codec_.maxFramerate));
453
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200454 is_svc_ = (num_spatial_layers_ > 1 || num_temporal_layers_ > 1);
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200455
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000456 encoded_image_._completeFrame = true;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000457 // Populate encoder configuration with default values.
458 if (vpx_codec_enc_config_default(vpx_codec_vp9_cx(), config_, 0)) {
459 return WEBRTC_VIDEO_CODEC_ERROR;
460 }
Emircan Uysaler0823eec2018-07-13 17:10:00 -0700461
462 vpx_img_fmt img_fmt = VPX_IMG_FMT_NONE;
463 unsigned int bits_for_storage = 8;
464 switch (profile_) {
465 case VP9Profile::kProfile0:
466 img_fmt = VPX_IMG_FMT_I420;
467 bits_for_storage = 8;
468 config_->g_bit_depth = VPX_BITS_8;
469 config_->g_profile = 0;
470 config_->g_input_bit_depth = 8;
471 break;
472 case VP9Profile::kProfile2:
473 img_fmt = VPX_IMG_FMT_I42016;
474 bits_for_storage = 16;
475 config_->g_bit_depth = VPX_BITS_10;
476 config_->g_profile = 2;
477 config_->g_input_bit_depth = 10;
478 break;
479 }
480
481 // Creating a wrapper to the image - setting image data to nullptr. Actual
482 // pointer will be set in encode. Setting align to 1, as it is meaningless
483 // (actual memory is not allocated).
484 raw_ =
485 vpx_img_wrap(nullptr, img_fmt, codec_.width, codec_.height, 1, nullptr);
486 raw_->bit_depth = bits_for_storage;
487
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000488 config_->g_w = codec_.width;
489 config_->g_h = codec_.height;
490 config_->rc_target_bitrate = inst->startBitrate; // in kbit/s
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200491 config_->g_error_resilient = is_svc_ ? VPX_ERROR_RESILIENT_DEFAULT : 0;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000492 // Setting the time base of the codec.
493 config_->g_timebase.num = 1;
494 config_->g_timebase.den = 90000;
495 config_->g_lag_in_frames = 0; // 0- no frame lagging
496 config_->g_threads = 1;
497 // Rate control settings.
hta257dc392016-10-25 09:05:06 -0700498 config_->rc_dropframe_thresh = inst->VP9().frameDroppingOn ? 30 : 0;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000499 config_->rc_end_usage = VPX_CBR;
500 config_->g_pass = VPX_RC_ONE_PASS;
Ilya Nikolaevskiy3a656d12019-02-14 14:44:22 +0100501 config_->rc_min_quantizer =
502 codec_.mode == VideoCodecMode::kScreensharing ? 8 : 2;
marpan@webrtc.orgdc8a9da2015-01-27 23:08:24 +0000503 config_->rc_max_quantizer = 52;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000504 config_->rc_undershoot_pct = 50;
505 config_->rc_overshoot_pct = 50;
506 config_->rc_buf_initial_sz = 500;
507 config_->rc_buf_optimal_sz = 600;
508 config_->rc_buf_sz = 1000;
509 // Set the maximum target size of any key-frame.
510 rc_max_intra_target_ = MaxIntraTarget(config_->rc_buf_optimal_sz);
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +0100511 // Key-frame interval is enforced manually by this wrapper.
512 config_->kf_mode = VPX_KF_DISABLED;
513 // TODO(webm:1592): work-around for libvpx issue, as it can still
514 // put some key-frames at will even in VPX_KF_DISABLED kf_mode.
515 config_->kf_max_dist = inst->VP9().keyFrameInterval;
516 config_->kf_min_dist = config_->kf_max_dist;
hta257dc392016-10-25 09:05:06 -0700517 config_->rc_resize_allowed = inst->VP9().automaticResizeOn ? 1 : 0;
marpan@webrtc.org38d11b82015-01-26 15:21:36 +0000518 // Determine number of threads based on the image size and #cores.
philipelcce46fc2015-12-21 03:04:49 -0800519 config_->g_threads =
Elad Alon370f93a2019-06-11 14:57:57 +0200520 NumberOfThreads(config_->g_w, config_->g_h, settings.number_of_cores);
asaperssona9455ab2015-07-31 06:10:09 -0700521
Marco6e89b252015-07-07 14:40:38 -0700522 cpu_speed_ = GetCpuSpeed(config_->g_w, config_->g_h);
asaperssona9455ab2015-07-31 06:10:09 -0700523
hta257dc392016-10-25 09:05:06 -0700524 is_flexible_mode_ = inst->VP9().flexibleMode;
Sergey Silkinbe71a1e2018-05-17 16:46:43 +0200525
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100526 inter_layer_pred_ = inst->VP9().interLayerPred;
527
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +0200528 if (num_spatial_layers_ > 1 &&
529 codec_.mode == VideoCodecMode::kScreensharing && !is_flexible_mode_) {
530 RTC_LOG(LS_ERROR) << "Flexible mode is required for screenshare with "
531 "several spatial layers";
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100532 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
533 }
534
535 // External reference control is required for different frame rate on spatial
536 // layers because libvpx generates rtp incompatible references in this case.
537 external_ref_control_ = field_trial::IsEnabled("WebRTC-Vp9ExternalRefCtrl") ||
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +0200538 (num_spatial_layers_ > 1 &&
539 codec_.mode == VideoCodecMode::kScreensharing) ||
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +0100540 inter_layer_pred_ == InterLayerPredMode::kOn;
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100541
Sergey Silkinbe71a1e2018-05-17 16:46:43 +0200542 if (num_temporal_layers_ == 1) {
asaperssona9455ab2015-07-31 06:10:09 -0700543 gof_.SetGofInfoVP9(kTemporalStructureMode1);
544 config_->temporal_layering_mode = VP9E_TEMPORAL_LAYERING_MODE_NOLAYERING;
545 config_->ts_number_layers = 1;
546 config_->ts_rate_decimator[0] = 1;
547 config_->ts_periodicity = 1;
548 config_->ts_layer_id[0] = 0;
549 } else if (num_temporal_layers_ == 2) {
550 gof_.SetGofInfoVP9(kTemporalStructureMode2);
551 config_->temporal_layering_mode = VP9E_TEMPORAL_LAYERING_MODE_0101;
552 config_->ts_number_layers = 2;
553 config_->ts_rate_decimator[0] = 2;
554 config_->ts_rate_decimator[1] = 1;
555 config_->ts_periodicity = 2;
556 config_->ts_layer_id[0] = 0;
557 config_->ts_layer_id[1] = 1;
558 } else if (num_temporal_layers_ == 3) {
559 gof_.SetGofInfoVP9(kTemporalStructureMode3);
560 config_->temporal_layering_mode = VP9E_TEMPORAL_LAYERING_MODE_0212;
561 config_->ts_number_layers = 3;
562 config_->ts_rate_decimator[0] = 4;
563 config_->ts_rate_decimator[1] = 2;
564 config_->ts_rate_decimator[2] = 1;
565 config_->ts_periodicity = 4;
566 config_->ts_layer_id[0] = 0;
567 config_->ts_layer_id[1] = 2;
568 config_->ts_layer_id[2] = 1;
569 config_->ts_layer_id[3] = 2;
570 } else {
571 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
572 }
573
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100574 if (external_ref_control_) {
575 config_->temporal_layering_mode = VP9E_TEMPORAL_LAYERING_MODE_BYPASS;
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +0200576 if (num_temporal_layers_ > 1 && num_spatial_layers_ > 1 &&
577 codec_.mode == VideoCodecMode::kScreensharing) {
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100578 // External reference control for several temporal layers with different
579 // frame rates on spatial layers is not implemented yet.
580 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
581 }
582 }
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200583 ref_buf_.clear();
584
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000585 return InitAndSetControlSettings(inst);
586}
587
marpan@webrtc.org38d11b82015-01-26 15:21:36 +0000588int VP9EncoderImpl::NumberOfThreads(int width,
589 int height,
590 int number_of_cores) {
591 // Keep the number of encoder threads equal to the possible number of column
592 // tiles, which is (1, 2, 4, 8). See comments below for VP9E_SET_TILE_COLUMNS.
593 if (width * height >= 1280 * 720 && number_of_cores > 4) {
594 return 4;
jianj23173a32017-07-12 16:11:09 -0700595 } else if (width * height >= 640 * 360 && number_of_cores > 2) {
marpan@webrtc.org38d11b82015-01-26 15:21:36 +0000596 return 2;
597 } else {
Yves Gerey665174f2018-06-19 15:03:05 +0200598// Use 2 threads for low res on ARM.
Jerome Jiang831af372017-12-05 10:44:35 -0800599#if defined(WEBRTC_ARCH_ARM) || defined(WEBRTC_ARCH_ARM64) || \
600 defined(WEBRTC_ANDROID)
601 if (width * height >= 320 * 180 && number_of_cores > 2) {
602 return 2;
603 }
604#endif
marpan@webrtc.org38d11b82015-01-26 15:21:36 +0000605 // 1 thread less than VGA.
606 return 1;
607 }
608}
609
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000610int VP9EncoderImpl::InitAndSetControlSettings(const VideoCodec* inst) {
Åsa Perssonff24c042015-12-04 10:58:08 +0100611 // Set QP-min/max per spatial and temporal layer.
612 int tot_num_layers = num_spatial_layers_ * num_temporal_layers_;
613 for (int i = 0; i < tot_num_layers; ++i) {
johannkoenig8225c402017-01-26 13:23:44 -0800614 svc_params_.max_quantizers[i] = config_->rc_max_quantizer;
615 svc_params_.min_quantizers[i] = config_->rc_min_quantizer;
Åsa Perssonff24c042015-12-04 10:58:08 +0100616 }
asaperssona9455ab2015-07-31 06:10:09 -0700617 config_->ss_number_layers = num_spatial_layers_;
sprangce4aef12015-11-02 07:23:20 -0800618 if (ExplicitlyConfiguredSpatialLayers()) {
619 for (int i = 0; i < num_spatial_layers_; ++i) {
620 const auto& layer = codec_.spatialLayers[i];
Rasmus Brandt58cd3852018-06-26 13:41:16 +0200621 RTC_CHECK_GT(layer.width, 0);
Sergey Silkin13e74342018-03-02 12:28:00 +0100622 const int scale_factor = codec_.width / layer.width;
623 RTC_DCHECK_GT(scale_factor, 0);
624
625 // Ensure scaler factor is integer.
626 if (scale_factor * layer.width != codec_.width) {
627 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
628 }
629
630 // Ensure scale factor is the same in both dimensions.
631 if (scale_factor * layer.height != codec_.height) {
632 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
633 }
634
635 // Ensure scale factor is power of two.
636 const bool is_pow_of_two = (scale_factor & (scale_factor - 1)) == 0;
637 if (!is_pow_of_two) {
638 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
639 }
640
641 svc_params_.scaling_factor_num[i] = 1;
642 svc_params_.scaling_factor_den[i] = scale_factor;
Sergey Silkin96f2c972018-09-05 21:07:17 +0200643
644 RTC_DCHECK_GT(codec_.spatialLayers[i].maxFramerate, 0);
645 RTC_DCHECK_LE(codec_.spatialLayers[i].maxFramerate, codec_.maxFramerate);
646 if (i > 0) {
647 // Frame rate of high spatial layer is supposed to be equal or higher
648 // than frame rate of low spatial layer.
649 RTC_DCHECK_GE(codec_.spatialLayers[i].maxFramerate,
650 codec_.spatialLayers[i - 1].maxFramerate);
651 }
sprangce4aef12015-11-02 07:23:20 -0800652 }
653 } else {
654 int scaling_factor_num = 256;
655 for (int i = num_spatial_layers_ - 1; i >= 0; --i) {
sprangce4aef12015-11-02 07:23:20 -0800656 // 1:2 scaling in each dimension.
johannkoenig8225c402017-01-26 13:23:44 -0800657 svc_params_.scaling_factor_num[i] = scaling_factor_num;
658 svc_params_.scaling_factor_den[i] = 256;
sprangce4aef12015-11-02 07:23:20 -0800659 }
asaperssona9455ab2015-07-31 06:10:09 -0700660 }
661
Sergey Silkin86684962018-03-28 19:32:37 +0200662 SvcRateAllocator init_allocator(codec_);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100663 current_bitrate_allocation_ = init_allocator.GetAllocation(
Sergey Silkin86684962018-03-28 19:32:37 +0200664 inst->startBitrate * 1000, inst->maxFramerate);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100665 if (!SetSvcRates(current_bitrate_allocation_)) {
asaperssona9455ab2015-07-31 06:10:09 -0700666 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
667 }
668
Emircan Uysaler0823eec2018-07-13 17:10:00 -0700669 const vpx_codec_err_t rv = vpx_codec_enc_init(
670 encoder_, vpx_codec_vp9_cx(), config_,
671 config_->g_bit_depth == VPX_BITS_8 ? 0 : VPX_CODEC_USE_HIGHBITDEPTH);
672 if (rv != VPX_CODEC_OK) {
673 RTC_LOG(LS_ERROR) << "Init error: " << vpx_codec_err_to_string(rv);
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000674 return WEBRTC_VIDEO_CODEC_UNINITIALIZED;
675 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000676 vpx_codec_control(encoder_, VP8E_SET_CPUUSED, cpu_speed_);
677 vpx_codec_control(encoder_, VP8E_SET_MAX_INTRA_BITRATE_PCT,
678 rc_max_intra_target_);
679 vpx_codec_control(encoder_, VP9E_SET_AQ_MODE,
hta257dc392016-10-25 09:05:06 -0700680 inst->VP9().adaptiveQpMode ? 3 : 0);
asaperssona9455ab2015-07-31 06:10:09 -0700681
jianj822e5932017-07-12 16:09:58 -0700682 vpx_codec_control(encoder_, VP9E_SET_FRAME_PARALLEL_DECODING, 0);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100683 vpx_codec_control(encoder_, VP9E_SET_SVC_GF_TEMPORAL_REF, 0);
Sergey Silkin6a8f30e2018-04-26 11:03:49 +0200684
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +0200685 if (is_svc_) {
686 vpx_codec_control(encoder_, VP9E_SET_SVC, 1);
687 vpx_codec_control(encoder_, VP9E_SET_SVC_PARAMETERS, &svc_params_);
asaperssona9455ab2015-07-31 06:10:09 -0700688 }
Sergey Silkin6a8f30e2018-04-26 11:03:49 +0200689
690 if (num_spatial_layers_ > 1) {
691 switch (inter_layer_pred_) {
692 case InterLayerPredMode::kOn:
693 vpx_codec_control(encoder_, VP9E_SET_SVC_INTER_LAYER_PRED, 0);
694 break;
695 case InterLayerPredMode::kOff:
696 vpx_codec_control(encoder_, VP9E_SET_SVC_INTER_LAYER_PRED, 1);
697 break;
698 case InterLayerPredMode::kOnKeyPic:
699 vpx_codec_control(encoder_, VP9E_SET_SVC_INTER_LAYER_PRED, 2);
700 break;
701 default:
702 RTC_NOTREACHED();
703 }
Sergey Silkinbe71a1e2018-05-17 16:46:43 +0200704
Ilya Nikolaevskiy039a7142019-05-24 16:50:00 +0200705 memset(&svc_drop_frame_, 0, sizeof(svc_drop_frame_));
706 dropping_only_base_layer_ = inter_layer_pred_ == InterLayerPredMode::kOn &&
707 codec_.mode == VideoCodecMode::kScreensharing &&
708 num_spatial_layers_ > 1;
709 if (dropping_only_base_layer_) {
710 // Screenshare dropping mode: only the base spatial layer
711 // can be dropped and it doesn't affect other spatial layers.
712 // This mode is preferable because base layer has low bitrate targets
713 // and more likely to drop frames. It shouldn't reduce framerate on other
714 // layers.
715 svc_drop_frame_.framedrop_mode = LAYER_DROP;
716 svc_drop_frame_.max_consec_drop = 5;
717 svc_drop_frame_.framedrop_thresh[0] = config_->rc_dropframe_thresh;
718 for (size_t i = 1; i < num_spatial_layers_; ++i) {
719 svc_drop_frame_.framedrop_thresh[i] = 0;
720 }
721 } else {
722 // Configure encoder to drop entire superframe whenever it needs to drop
723 // a layer. This mode is preferred over per-layer dropping which causes
724 // quality flickering and is not compatible with RTP non-flexible mode.
725 svc_drop_frame_.framedrop_mode =
726 full_superframe_drop_ ? FULL_SUPERFRAME_DROP : CONSTRAINED_LAYER_DROP;
727 svc_drop_frame_.max_consec_drop = std::numeric_limits<int>::max();
728 for (size_t i = 0; i < num_spatial_layers_; ++i) {
729 svc_drop_frame_.framedrop_thresh[i] = config_->rc_dropframe_thresh;
730 }
Sergey Silkinbe71a1e2018-05-17 16:46:43 +0200731 }
Ilya Nikolaevskiy039a7142019-05-24 16:50:00 +0200732 vpx_codec_control(encoder_, VP9E_SET_SVC_FRAME_DROP_LAYER,
733 &svc_drop_frame_);
Sergey Silkin6a8f30e2018-04-26 11:03:49 +0200734 }
735
asaperssona9455ab2015-07-31 06:10:09 -0700736 // Register callback for getting each spatial layer.
737 vpx_codec_priv_output_cx_pkt_cb_pair_t cbp = {
philipelcce46fc2015-12-21 03:04:49 -0800738 VP9EncoderImpl::EncoderOutputCodedPacketCallback,
739 reinterpret_cast<void*>(this)};
740 vpx_codec_control(encoder_, VP9E_REGISTER_CX_CALLBACK,
741 reinterpret_cast<void*>(&cbp));
asaperssona9455ab2015-07-31 06:10:09 -0700742
marpan@webrtc.org38d11b82015-01-26 15:21:36 +0000743 // Control function to set the number of column tiles in encoding a frame, in
744 // log2 unit: e.g., 0 = 1 tile column, 1 = 2 tile columns, 2 = 4 tile columns.
745 // The number tile columns will be capped by the encoder based on image size
746 // (minimum width of tile column is 256 pixels, maximum is 4096).
747 vpx_codec_control(encoder_, VP9E_SET_TILE_COLUMNS, (config_->g_threads >> 1));
jianjcb5d1152017-03-28 23:56:08 -0700748
749 // Turn on row-based multithreading.
750 vpx_codec_control(encoder_, VP9E_SET_ROW_MT, 1);
jianj6bf57e32017-06-05 13:43:49 -0700751
Alex Glaznevfecb7c32016-03-31 14:23:27 -0700752#if !defined(WEBRTC_ARCH_ARM) && !defined(WEBRTC_ARCH_ARM64) && \
Yves Gerey665174f2018-06-19 15:03:05 +0200753 !defined(ANDROID)
jianj6bf57e32017-06-05 13:43:49 -0700754 // Do not enable the denoiser on ARM since optimization is pending.
755 // Denoiser is on by default on other platforms.
marpan@webrtc.org16a87b92015-03-05 22:19:00 +0000756 vpx_codec_control(encoder_, VP9E_SET_NOISE_SENSITIVITY,
hta257dc392016-10-25 09:05:06 -0700757 inst->VP9().denoisingOn ? 1 : 0);
marpan@webrtc.org16a87b92015-03-05 22:19:00 +0000758#endif
jianj6bf57e32017-06-05 13:43:49 -0700759
Niels Möllere3cf3d02018-06-13 11:52:16 +0200760 if (codec_.mode == VideoCodecMode::kScreensharing) {
ivica242d6382015-09-04 06:13:23 -0700761 // Adjust internal parameters to screen content.
762 vpx_codec_control(encoder_, VP9E_SET_TUNE_CONTENT, 1);
ivica242d6382015-09-04 06:13:23 -0700763 }
Marco2520e722015-09-16 14:05:00 -0700764 // Enable encoder skip of static/low content blocks.
765 vpx_codec_control(encoder_, VP8E_SET_STATIC_THRESHOLD, 1);
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000766 inited_ = true;
767 return WEBRTC_VIDEO_CODEC_OK;
768}
769
770uint32_t VP9EncoderImpl::MaxIntraTarget(uint32_t optimal_buffer_size) {
771 // Set max to the optimal buffer level (normalized by target BR),
772 // and scaled by a scale_par.
773 // Max target size = scale_par * optimal_buffer_size * targetBR[Kbps].
774 // This value is presented in percentage of perFrameBw:
775 // perFrameBw = targetBR[Kbps] * 1000 / framerate.
776 // The target in % is as follows:
777 float scale_par = 0.5;
778 uint32_t target_pct =
779 optimal_buffer_size * scale_par * codec_.maxFramerate / 10;
780 // Don't go below 3 times the per frame bandwidth.
781 const uint32_t min_intra_size = 300;
philipelcce46fc2015-12-21 03:04:49 -0800782 return (target_pct < min_intra_size) ? min_intra_size : target_pct;
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000783}
784
Miguel Casas-Sanchez47650702015-05-29 17:21:40 -0700785int VP9EncoderImpl::Encode(const VideoFrame& input_image,
Niels Möller87e2d782019-03-07 10:18:23 +0100786 const std::vector<VideoFrameType>* frame_types) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000787 if (!inited_) {
788 return WEBRTC_VIDEO_CODEC_UNINITIALIZED;
789 }
sprang3958ed82017-08-17 08:12:10 -0700790 if (encoded_complete_callback_ == nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000791 return WEBRTC_VIDEO_CODEC_UNINITIALIZED;
792 }
Erik Språngbfa5d5d2019-02-04 16:40:19 +0100793 if (num_active_spatial_layers_ == 0) {
794 // All spatial layers are disabled, return without encoding anything.
795 return WEBRTC_VIDEO_CODEC_OK;
796 }
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200797
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000798 // We only support one stream at the moment.
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200799 if (frame_types && !frame_types->empty()) {
Niels Möller8f7ce222019-03-21 15:43:58 +0100800 if ((*frame_types)[0] == VideoFrameType::kVideoFrameKey) {
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200801 force_key_frame_ = true;
802 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000803 }
Sergey Silkind902d582018-05-18 17:31:19 +0200804
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +0100805 if (pics_since_key_ + 1 ==
806 static_cast<size_t>(codec_.VP9()->keyFrameInterval)) {
807 force_key_frame_ = true;
808 }
809
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100810 vpx_svc_layer_id_t layer_id = {0};
811 if (!force_key_frame_) {
Patrik Höglundd4d254f2018-11-29 15:09:31 +0000812 const size_t gof_idx = (pics_since_key_ + 1) % gof_.num_frames_in_gof;
813 layer_id.temporal_layer_id = gof_.temporal_idx[gof_idx];
Sergey Silkin96f2c972018-09-05 21:07:17 +0200814
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100815 if (VideoCodecMode::kScreensharing == codec_.mode) {
816 const uint32_t frame_timestamp_ms =
817 1000 * input_image.timestamp() / kVideoPayloadTypeFrequency;
Sergey Silkin96f2c972018-09-05 21:07:17 +0200818
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +0100819 // To ensure that several rate-limiters with different limits don't
820 // interfere, they must be queried in order of increasing limit.
821
822 bool use_steady_state_limiter =
823 variable_framerate_experiment_.enabled &&
824 input_image.update_rect().IsEmpty() &&
825 num_steady_state_frames_ >=
826 variable_framerate_experiment_.frames_before_steady_state;
827
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100828 for (uint8_t sl_idx = 0; sl_idx < num_active_spatial_layers_; ++sl_idx) {
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +0100829 const float layer_fps =
830 framerate_controller_[layer_id.spatial_layer_id].GetTargetRate();
831 // Use steady state rate-limiter at the correct place.
832 if (use_steady_state_limiter &&
833 layer_fps > variable_framerate_experiment_.framerate_limit - 1e-9) {
834 if (variable_framerate_controller_.DropFrame(frame_timestamp_ms)) {
835 layer_id.spatial_layer_id = num_active_spatial_layers_;
836 }
837 // Break always: if rate limiter triggered frame drop, no need to
838 // continue; otherwise, the rate is less than the next limiters.
839 break;
840 }
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100841 if (framerate_controller_[sl_idx].DropFrame(frame_timestamp_ms)) {
842 ++layer_id.spatial_layer_id;
843 } else {
844 break;
845 }
Sergey Silkin96f2c972018-09-05 21:07:17 +0200846 }
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +0100847
848 if (use_steady_state_limiter &&
849 layer_id.spatial_layer_id < num_active_spatial_layers_) {
850 variable_framerate_controller_.AddFrame(frame_timestamp_ms);
851 }
Sergey Silkin96f2c972018-09-05 21:07:17 +0200852 }
Patrik Höglundd4d254f2018-11-29 15:09:31 +0000853
854 RTC_DCHECK_LE(layer_id.spatial_layer_id, num_active_spatial_layers_);
855 if (layer_id.spatial_layer_id >= num_active_spatial_layers_) {
856 // Drop entire picture.
857 return WEBRTC_VIDEO_CODEC_OK;
858 }
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100859 }
Patrik Höglundd4d254f2018-11-29 15:09:31 +0000860
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100861 for (int sl_idx = 0; sl_idx < num_active_spatial_layers_; ++sl_idx) {
862 layer_id.temporal_layer_id_per_spatial[sl_idx] = layer_id.temporal_layer_id;
863 }
864
865 vpx_codec_control(encoder_, VP9E_SET_SVC_LAYER_ID, &layer_id);
866
Erik Språng7a3fe892019-04-15 12:22:55 +0200867 if (requested_rate_settings_) {
868 if (dynamic_rate_settings_) {
869 // Tweak rate control settings based on available network headroom.
870 UpdateRateSettings(
871 config_,
872 GetRateSettings(
873 requested_rate_settings_->bandwidth_allocation.bps<double>() /
874 requested_rate_settings_->bitrate.get_sum_bps()));
875 }
876
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100877 bool more_layers_requested = MoreLayersEnabled(
Erik Språng7a3fe892019-04-15 12:22:55 +0200878 requested_rate_settings_->bitrate, current_bitrate_allocation_);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100879 bool less_layers_requested = MoreLayersEnabled(
Erik Språng7a3fe892019-04-15 12:22:55 +0200880 current_bitrate_allocation_, requested_rate_settings_->bitrate);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100881 // In SVC can enable new layers only if all lower layers are encoded and at
882 // the base temporal layer.
883 // This will delay rate allocation change until the next frame on the base
884 // spatial layer.
885 // In KSVC or simulcast modes KF will be generated for a new layer, so can
886 // update allocation any time.
887 bool can_upswitch =
888 inter_layer_pred_ != InterLayerPredMode::kOn ||
889 (layer_id.spatial_layer_id == 0 && layer_id.temporal_layer_id == 0);
890 if (!more_layers_requested || can_upswitch) {
Erik Språng7a3fe892019-04-15 12:22:55 +0200891 current_bitrate_allocation_ = requested_rate_settings_->bitrate;
892 requested_rate_settings_ = absl::nullopt;
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100893 if (!SetSvcRates(current_bitrate_allocation_)) {
894 return WEBRTC_VIDEO_CODEC_ERR_PARAMETER;
895 }
896 if (less_layers_requested || more_layers_requested) {
897 ss_info_needed_ = true;
898 }
Ilya Nikolaevskiy039a7142019-05-24 16:50:00 +0200899 if (more_layers_requested && !force_key_frame_) {
900 // Prohibit drop of all layers for the next frame, so newly enabled
901 // layer would have a valid spatial reference.
902 for (size_t i = 0; i < num_spatial_layers_; ++i) {
903 svc_drop_frame_.framedrop_thresh[i] = 0;
904 }
905 }
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100906 }
907 }
908
Ilya Nikolaevskiy039a7142019-05-24 16:50:00 +0200909 if (num_spatial_layers_ > 1) {
910 // Update frame dropping settings as they may change on per-frame basis.
911 vpx_codec_control(encoder_, VP9E_SET_SVC_FRAME_DROP_LAYER,
912 &svc_drop_frame_);
913 }
914
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100915 if (vpx_codec_enc_config_set(encoder_, config_)) {
916 return WEBRTC_VIDEO_CODEC_ERROR;
Sergey Silkind902d582018-05-18 17:31:19 +0200917 }
918
kwiberg352444f2016-11-28 15:58:53 -0800919 RTC_DCHECK_EQ(input_image.width(), raw_->d_w);
920 RTC_DCHECK_EQ(input_image.height(), raw_->d_h);
asaperssona9455ab2015-07-31 06:10:09 -0700921
922 // Set input image for use in the callback.
923 // This was necessary since you need some information from input_image.
924 // You can save only the necessary information (such as timestamp) instead of
925 // doing this.
926 input_image_ = &input_image;
927
Emircan Uysaler0823eec2018-07-13 17:10:00 -0700928 // Keep reference to buffer until encode completes.
929 rtc::scoped_refptr<I420BufferInterface> i420_buffer;
Ilya Nikolaevskiya8507e32019-05-03 11:39:26 +0200930 const I010BufferInterface* i010_buffer;
931 rtc::scoped_refptr<const I010BufferInterface> i010_copy;
Emircan Uysaler0823eec2018-07-13 17:10:00 -0700932 switch (profile_) {
933 case VP9Profile::kProfile0: {
934 i420_buffer = input_image.video_frame_buffer()->ToI420();
935 // Image in vpx_image_t format.
936 // Input image is const. VPX's raw image is not defined as const.
937 raw_->planes[VPX_PLANE_Y] = const_cast<uint8_t*>(i420_buffer->DataY());
938 raw_->planes[VPX_PLANE_U] = const_cast<uint8_t*>(i420_buffer->DataU());
939 raw_->planes[VPX_PLANE_V] = const_cast<uint8_t*>(i420_buffer->DataV());
940 raw_->stride[VPX_PLANE_Y] = i420_buffer->StrideY();
941 raw_->stride[VPX_PLANE_U] = i420_buffer->StrideU();
942 raw_->stride[VPX_PLANE_V] = i420_buffer->StrideV();
943 break;
944 }
945 case VP9Profile::kProfile2: {
946 // We can inject kI010 frames directly for encode. All other formats
947 // should be converted to it.
948 switch (input_image.video_frame_buffer()->type()) {
949 case VideoFrameBuffer::Type::kI010: {
950 i010_buffer = input_image.video_frame_buffer()->GetI010();
951 break;
952 }
953 default: {
Ilya Nikolaevskiya8507e32019-05-03 11:39:26 +0200954 i010_copy =
Emircan Uysaler0823eec2018-07-13 17:10:00 -0700955 I010Buffer::Copy(*input_image.video_frame_buffer()->ToI420());
Ilya Nikolaevskiya8507e32019-05-03 11:39:26 +0200956 i010_buffer = i010_copy.get();
Emircan Uysaler0823eec2018-07-13 17:10:00 -0700957 }
958 }
959 raw_->planes[VPX_PLANE_Y] = const_cast<uint8_t*>(
960 reinterpret_cast<const uint8_t*>(i010_buffer->DataY()));
961 raw_->planes[VPX_PLANE_U] = const_cast<uint8_t*>(
962 reinterpret_cast<const uint8_t*>(i010_buffer->DataU()));
963 raw_->planes[VPX_PLANE_V] = const_cast<uint8_t*>(
964 reinterpret_cast<const uint8_t*>(i010_buffer->DataV()));
965 raw_->stride[VPX_PLANE_Y] = i010_buffer->StrideY() * 2;
966 raw_->stride[VPX_PLANE_U] = i010_buffer->StrideU() * 2;
967 raw_->stride[VPX_PLANE_V] = i010_buffer->StrideV() * 2;
968 break;
969 }
970 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000971
philipelcfc319b2015-11-10 07:17:23 -0800972 vpx_enc_frame_flags_t flags = 0;
Sergey Silkinbd0954e2018-05-03 14:14:09 +0200973 if (force_key_frame_) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +0000974 flags = VPX_EFLAG_FORCE_KF;
975 }
philipelcfc319b2015-11-10 07:17:23 -0800976
Sergey Silkin390f3582018-10-01 17:13:50 +0200977 if (external_ref_control_) {
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100978 vpx_svc_ref_frame_config_t ref_config =
979 SetReferences(force_key_frame_, layer_id.spatial_layer_id);
Sergey Silkina85995a2018-10-02 10:28:10 +0200980
981 if (VideoCodecMode::kScreensharing == codec_.mode) {
982 for (uint8_t sl_idx = 0; sl_idx < num_active_spatial_layers_; ++sl_idx) {
983 ref_config.duration[sl_idx] = static_cast<int64_t>(
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +0200984 90000 / (std::min(static_cast<float>(codec_.maxFramerate),
985 framerate_controller_[sl_idx].GetTargetRate())));
Sergey Silkina85995a2018-10-02 10:28:10 +0200986 }
987 }
988
Sergey Silkin390f3582018-10-01 17:13:50 +0200989 vpx_codec_control(encoder_, VP9E_SET_SVC_REF_FRAME_CONFIG, &ref_config);
990 }
991
Sergey Silkin88ce4ef2018-11-23 13:59:24 +0100992 first_frame_in_picture_ = true;
993
Sergey Silkin96f2c972018-09-05 21:07:17 +0200994 // TODO(ssilkin): Frame duration should be specified per spatial layer
995 // since their frame rate can be different. For now calculate frame duration
996 // based on target frame rate of the highest spatial layer, which frame rate
997 // is supposed to be equal or higher than frame rate of low spatial layers.
998 // Also, timestamp should represent actual time passed since previous frame
999 // (not 'expected' time). Then rate controller can drain buffer more
1000 // accurately.
1001 RTC_DCHECK_GE(framerate_controller_.size(), num_active_spatial_layers_);
Sergey Silkinf87bb462018-09-17 09:37:37 +02001002 float target_framerate_fps =
1003 (codec_.mode == VideoCodecMode::kScreensharing)
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +02001004 ? std::min(static_cast<float>(codec_.maxFramerate),
1005 framerate_controller_[num_active_spatial_layers_ - 1]
1006 .GetTargetRate())
Sergey Silkinf87bb462018-09-17 09:37:37 +02001007 : codec_.maxFramerate;
1008 uint32_t duration = static_cast<uint32_t>(90000 / target_framerate_fps);
Emircan Uysaler0823eec2018-07-13 17:10:00 -07001009 const vpx_codec_err_t rv = vpx_codec_encode(encoder_, raw_, timestamp_,
1010 duration, flags, VPX_DL_REALTIME);
1011 if (rv != VPX_CODEC_OK) {
1012 RTC_LOG(LS_ERROR) << "Encoding error: " << vpx_codec_err_to_string(rv)
1013 << "\n"
1014 << "Details: " << vpx_codec_error(encoder_) << "\n"
1015 << vpx_codec_error_detail(encoder_);
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001016 return WEBRTC_VIDEO_CODEC_ERROR;
1017 }
1018 timestamp_ += duration;
asaperssona9455ab2015-07-31 06:10:09 -07001019
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001020 if (!full_superframe_drop_) {
1021 const bool end_of_picture = true;
1022 DeliverBufferedFrame(end_of_picture);
1023 }
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001024
asaperssona9455ab2015-07-31 06:10:09 -07001025 return WEBRTC_VIDEO_CODEC_OK;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001026}
1027
1028void VP9EncoderImpl::PopulateCodecSpecific(CodecSpecificInfo* codec_specific,
Niels Möllerd3b8c632018-08-27 15:33:42 +02001029 absl::optional<int>* spatial_idx,
philipelcce46fc2015-12-21 03:04:49 -08001030 const vpx_codec_cx_pkt& pkt,
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001031 uint32_t timestamp) {
sprang3958ed82017-08-17 08:12:10 -07001032 RTC_CHECK(codec_specific != nullptr);
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001033 codec_specific->codecType = kVideoCodecVP9;
philipelcce46fc2015-12-21 03:04:49 -08001034 CodecSpecificInfoVP9* vp9_info = &(codec_specific->codecSpecific.VP9);
Sergey Silkin07f80cc2018-04-09 13:11:59 +02001035
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001036 vp9_info->first_frame_in_picture = first_frame_in_picture_;
Sergey Silkin738b7e92018-08-23 16:37:27 +02001037 vp9_info->flexible_mode = is_flexible_mode_;
asaperssona9455ab2015-07-31 06:10:09 -07001038
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001039 if (pkt.data.frame.flags & VPX_FRAME_IS_KEY) {
1040 pics_since_key_ = 0;
1041 } else if (first_frame_in_picture_) {
1042 ++pics_since_key_;
1043 }
1044
asaperssona9455ab2015-07-31 06:10:09 -07001045 vpx_svc_layer_id_t layer_id = {0};
1046 vpx_codec_control(encoder_, VP9E_GET_SVC_LAYER_ID, &layer_id);
1047
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +01001048 // Can't have keyframe with non-zero temporal layer.
1049 RTC_DCHECK(pics_since_key_ != 0 || layer_id.temporal_layer_id == 0);
1050
sprang3958ed82017-08-17 08:12:10 -07001051 RTC_CHECK_GT(num_temporal_layers_, 0);
“Michael23c5a992018-06-21 11:07:21 -05001052 RTC_CHECK_GT(num_active_spatial_layers_, 0);
asaperssona9455ab2015-07-31 06:10:09 -07001053 if (num_temporal_layers_ == 1) {
sprang3958ed82017-08-17 08:12:10 -07001054 RTC_CHECK_EQ(layer_id.temporal_layer_id, 0);
asaperssona9455ab2015-07-31 06:10:09 -07001055 vp9_info->temporal_idx = kNoTemporalIdx;
1056 } else {
1057 vp9_info->temporal_idx = layer_id.temporal_layer_id;
1058 }
“Michael23c5a992018-06-21 11:07:21 -05001059 if (num_active_spatial_layers_ == 1) {
sprang3958ed82017-08-17 08:12:10 -07001060 RTC_CHECK_EQ(layer_id.spatial_layer_id, 0);
Niels Möllerd3b8c632018-08-27 15:33:42 +02001061 *spatial_idx = absl::nullopt;
asaperssona9455ab2015-07-31 06:10:09 -07001062 } else {
Niels Möllerd3b8c632018-08-27 15:33:42 +02001063 *spatial_idx = layer_id.spatial_layer_id;
asaperssona9455ab2015-07-31 06:10:09 -07001064 }
asaperssona9455ab2015-07-31 06:10:09 -07001065
asaperssona9455ab2015-07-31 06:10:09 -07001066 // TODO(asapersson): this info has to be obtained from the encoder.
asaperssoncb50c962015-11-18 01:58:55 -08001067 vp9_info->temporal_up_switch = false;
asaperssona9455ab2015-07-31 06:10:09 -07001068
Sergey Silkin6a8f30e2018-04-26 11:03:49 +02001069 const bool is_key_pic = (pics_since_key_ == 0);
1070 const bool is_inter_layer_pred_allowed =
1071 (inter_layer_pred_ == InterLayerPredMode::kOn ||
1072 (inter_layer_pred_ == InterLayerPredMode::kOnKeyPic && is_key_pic));
1073
1074 // Always set inter_layer_predicted to true on high layer frame if inter-layer
1075 // prediction (ILP) is allowed even if encoder didn't actually use it.
1076 // Setting inter_layer_predicted to false would allow receiver to decode high
1077 // layer frame without decoding low layer frame. If that would happen (e.g.
1078 // if low layer frame is lost) then receiver won't be able to decode next high
1079 // layer frame which uses ILP.
1080 vp9_info->inter_layer_predicted =
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001081 first_frame_in_picture_ ? false : is_inter_layer_pred_allowed;
Sergey Silkin6a8f30e2018-04-26 11:03:49 +02001082
Sergey Silkinc5f152d2018-09-26 13:28:50 +02001083 // Mark all low spatial layer frames as references (not just frames of
1084 // active low spatial layers) if inter-layer prediction is enabled since
1085 // these frames are indirect references of high spatial layer, which can
1086 // later be enabled without key frame.
Sergey Silkin6a8f30e2018-04-26 11:03:49 +02001087 vp9_info->non_ref_for_inter_layer_pred =
Sergey Silkinc5f152d2018-09-26 13:28:50 +02001088 !is_inter_layer_pred_allowed ||
1089 layer_id.spatial_layer_id + 1 == num_spatial_layers_;
asapersson00ac85e2015-11-11 05:30:48 -08001090
ivica7f6a6fc2015-09-08 02:40:29 -07001091 // Always populate this, so that the packetizer can properly set the marker
1092 // bit.
“Michael23c5a992018-06-21 11:07:21 -05001093 vp9_info->num_spatial_layers = num_active_spatial_layers_;
philipelcfc319b2015-11-10 07:17:23 -08001094
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001095 vp9_info->num_ref_pics = 0;
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +01001096 FillReferenceIndices(pkt, pics_since_key_, vp9_info->inter_layer_predicted,
1097 vp9_info);
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001098 if (vp9_info->flexible_mode) {
1099 vp9_info->gof_idx = kNoGofIdx;
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001100 } else {
1101 vp9_info->gof_idx =
1102 static_cast<uint8_t>(pics_since_key_ % gof_.num_frames_in_gof);
1103 vp9_info->temporal_up_switch = gof_.temporal_up_switch[vp9_info->gof_idx];
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +01001104 RTC_DCHECK(vp9_info->num_ref_pics == gof_.num_ref_pics[vp9_info->gof_idx] ||
1105 vp9_info->num_ref_pics == 0);
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001106 }
1107
1108 vp9_info->inter_pic_predicted = (!is_key_pic && vp9_info->num_ref_pics > 0);
1109
Sergey Silkina323cc02019-04-23 10:09:28 +02001110 // Write SS on key frame of independently coded spatial layers and on base
1111 // temporal/spatial layer frame if number of layers changed without issuing
1112 // of key picture (inter-layer prediction is enabled).
1113 const bool is_key_frame = is_key_pic && !vp9_info->inter_layer_predicted;
1114 if (is_key_frame || (ss_info_needed_ && layer_id.temporal_layer_id == 0 &&
1115 layer_id.spatial_layer_id == 0)) {
1116 vp9_info->ss_data_available = true;
asaperssona9455ab2015-07-31 06:10:09 -07001117 vp9_info->spatial_layer_resolution_present = true;
“Michael23c5a992018-06-21 11:07:21 -05001118 for (size_t i = 0; i < num_active_spatial_layers_; ++i) {
Yves Gerey665174f2018-06-19 15:03:05 +02001119 vp9_info->width[i] = codec_.width * svc_params_.scaling_factor_num[i] /
johannkoenig8225c402017-01-26 13:23:44 -08001120 svc_params_.scaling_factor_den[i];
Yves Gerey665174f2018-06-19 15:03:05 +02001121 vp9_info->height[i] = codec_.height * svc_params_.scaling_factor_num[i] /
johannkoenig8225c402017-01-26 13:23:44 -08001122 svc_params_.scaling_factor_den[i];
asaperssona9455ab2015-07-31 06:10:09 -07001123 }
Sergey Silkin738b7e92018-08-23 16:37:27 +02001124 if (vp9_info->flexible_mode) {
1125 vp9_info->gof.num_frames_in_gof = 0;
1126 } else {
asaperssona9455ab2015-07-31 06:10:09 -07001127 vp9_info->gof.CopyGofInfoVP9(gof_);
1128 }
Sergey Silkina323cc02019-04-23 10:09:28 +02001129
1130 ss_info_needed_ = false;
1131 } else {
1132 vp9_info->ss_data_available = false;
asaperssona9455ab2015-07-31 06:10:09 -07001133 }
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001134
1135 first_frame_in_picture_ = false;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001136}
1137
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001138void VP9EncoderImpl::FillReferenceIndices(const vpx_codec_cx_pkt& pkt,
1139 const size_t pic_num,
1140 const bool inter_layer_predicted,
1141 CodecSpecificInfoVP9* vp9_info) {
1142 vpx_svc_layer_id_t layer_id = {0};
1143 vpx_codec_control(encoder_, VP9E_GET_SVC_LAYER_ID, &layer_id);
1144
Sergey Silkin76be2952018-08-21 12:30:33 +02001145 const bool is_key_frame =
1146 (pkt.data.frame.flags & VPX_FRAME_IS_KEY) ? true : false;
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001147
1148 std::vector<RefFrameBuffer> ref_buf_list;
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001149
Sergey Silkin76be2952018-08-21 12:30:33 +02001150 if (is_svc_) {
1151 vpx_svc_ref_frame_config_t enc_layer_conf = {{0}};
1152 vpx_codec_control(encoder_, VP9E_GET_SVC_REF_FRAME_CONFIG, &enc_layer_conf);
Sergey Silkin38fabff2019-03-21 10:08:40 +01001153 int ref_buf_flags = 0;
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001154
Sergey Silkin76be2952018-08-21 12:30:33 +02001155 if (enc_layer_conf.reference_last[layer_id.spatial_layer_id]) {
1156 const size_t fb_idx =
1157 enc_layer_conf.lst_fb_idx[layer_id.spatial_layer_id];
1158 RTC_DCHECK(ref_buf_.find(fb_idx) != ref_buf_.end());
Sergey Silkin82276592018-08-27 14:54:20 +02001159 if (std::find(ref_buf_list.begin(), ref_buf_list.end(),
1160 ref_buf_.at(fb_idx)) == ref_buf_list.end()) {
1161 ref_buf_list.push_back(ref_buf_.at(fb_idx));
Sergey Silkin38fabff2019-03-21 10:08:40 +01001162 ref_buf_flags |= 1 << fb_idx;
Sergey Silkin82276592018-08-27 14:54:20 +02001163 }
Sergey Silkin76be2952018-08-21 12:30:33 +02001164 }
1165
1166 if (enc_layer_conf.reference_alt_ref[layer_id.spatial_layer_id]) {
1167 const size_t fb_idx =
1168 enc_layer_conf.alt_fb_idx[layer_id.spatial_layer_id];
1169 RTC_DCHECK(ref_buf_.find(fb_idx) != ref_buf_.end());
Sergey Silkin82276592018-08-27 14:54:20 +02001170 if (std::find(ref_buf_list.begin(), ref_buf_list.end(),
1171 ref_buf_.at(fb_idx)) == ref_buf_list.end()) {
1172 ref_buf_list.push_back(ref_buf_.at(fb_idx));
Sergey Silkin38fabff2019-03-21 10:08:40 +01001173 ref_buf_flags |= 1 << fb_idx;
Sergey Silkin82276592018-08-27 14:54:20 +02001174 }
Sergey Silkin76be2952018-08-21 12:30:33 +02001175 }
1176
1177 if (enc_layer_conf.reference_golden[layer_id.spatial_layer_id]) {
1178 const size_t fb_idx =
1179 enc_layer_conf.gld_fb_idx[layer_id.spatial_layer_id];
1180 RTC_DCHECK(ref_buf_.find(fb_idx) != ref_buf_.end());
Sergey Silkin82276592018-08-27 14:54:20 +02001181 if (std::find(ref_buf_list.begin(), ref_buf_list.end(),
1182 ref_buf_.at(fb_idx)) == ref_buf_list.end()) {
1183 ref_buf_list.push_back(ref_buf_.at(fb_idx));
Sergey Silkin38fabff2019-03-21 10:08:40 +01001184 ref_buf_flags |= 1 << fb_idx;
Sergey Silkin82276592018-08-27 14:54:20 +02001185 }
Sergey Silkin76be2952018-08-21 12:30:33 +02001186 }
Sergey Silkin38fabff2019-03-21 10:08:40 +01001187
1188 RTC_LOG(LS_VERBOSE) << "Frame " << pic_num << " sl "
1189 << layer_id.spatial_layer_id << " tl "
1190 << layer_id.temporal_layer_id << " refered buffers "
1191 << (ref_buf_flags & (1 << 0) ? 1 : 0)
1192 << (ref_buf_flags & (1 << 1) ? 1 : 0)
1193 << (ref_buf_flags & (1 << 2) ? 1 : 0)
1194 << (ref_buf_flags & (1 << 3) ? 1 : 0)
1195 << (ref_buf_flags & (1 << 4) ? 1 : 0)
1196 << (ref_buf_flags & (1 << 5) ? 1 : 0)
1197 << (ref_buf_flags & (1 << 6) ? 1 : 0)
1198 << (ref_buf_flags & (1 << 7) ? 1 : 0);
1199
Sergey Silkin76be2952018-08-21 12:30:33 +02001200 } else if (!is_key_frame) {
1201 RTC_DCHECK_EQ(num_spatial_layers_, 1);
1202 RTC_DCHECK_EQ(num_temporal_layers_, 1);
1203 // In non-SVC mode encoder doesn't provide reference list. Assume each frame
1204 // refers previous one, which is stored in buffer 0.
1205 ref_buf_list.push_back(ref_buf_.at(0));
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001206 }
1207
1208 size_t max_ref_temporal_layer_id = 0;
1209
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001210 std::vector<size_t> ref_pid_list;
1211
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001212 vp9_info->num_ref_pics = 0;
1213 for (const RefFrameBuffer& ref_buf : ref_buf_list) {
1214 RTC_DCHECK_LE(ref_buf.pic_num, pic_num);
1215 if (ref_buf.pic_num < pic_num) {
1216 if (inter_layer_pred_ != InterLayerPredMode::kOn) {
1217 // RTP spec limits temporal prediction to the same spatial layer.
1218 // It is safe to ignore this requirement if inter-layer prediction is
1219 // enabled for all frames when all base frames are relayed to receiver.
1220 RTC_DCHECK_EQ(ref_buf.spatial_layer_id, layer_id.spatial_layer_id);
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +02001221 } else {
1222 RTC_DCHECK_LE(ref_buf.spatial_layer_id, layer_id.spatial_layer_id);
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001223 }
1224 RTC_DCHECK_LE(ref_buf.temporal_layer_id, layer_id.temporal_layer_id);
1225
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001226 // Encoder may reference several spatial layers on the same previous
1227 // frame in case if some spatial layers are skipped on the current frame.
1228 // We shouldn't put duplicate references as it may break some old
1229 // clients and isn't RTP compatible.
1230 if (std::find(ref_pid_list.begin(), ref_pid_list.end(),
1231 ref_buf.pic_num) != ref_pid_list.end()) {
1232 continue;
1233 }
1234 ref_pid_list.push_back(ref_buf.pic_num);
1235
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001236 const size_t p_diff = pic_num - ref_buf.pic_num;
1237 RTC_DCHECK_LE(p_diff, 127UL);
1238
1239 vp9_info->p_diff[vp9_info->num_ref_pics] = static_cast<uint8_t>(p_diff);
1240 ++vp9_info->num_ref_pics;
1241
1242 max_ref_temporal_layer_id =
1243 std::max(max_ref_temporal_layer_id, ref_buf.temporal_layer_id);
1244 } else {
1245 RTC_DCHECK(inter_layer_predicted);
1246 // RTP spec only allows to use previous spatial layer for inter-layer
1247 // prediction.
1248 RTC_DCHECK_EQ(ref_buf.spatial_layer_id + 1, layer_id.spatial_layer_id);
1249 }
1250 }
1251
1252 vp9_info->temporal_up_switch =
1253 (max_ref_temporal_layer_id <
1254 static_cast<size_t>(layer_id.temporal_layer_id));
1255}
1256
1257void VP9EncoderImpl::UpdateReferenceBuffers(const vpx_codec_cx_pkt& pkt,
1258 const size_t pic_num) {
1259 vpx_svc_layer_id_t layer_id = {0};
1260 vpx_codec_control(encoder_, VP9E_GET_SVC_LAYER_ID, &layer_id);
1261
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001262 RefFrameBuffer frame_buf(pic_num, layer_id.spatial_layer_id,
1263 layer_id.temporal_layer_id);
1264
Sergey Silkin38fabff2019-03-21 10:08:40 +01001265 if (is_svc_) {
Sergey Silkin76be2952018-08-21 12:30:33 +02001266 vpx_svc_ref_frame_config_t enc_layer_conf = {{0}};
1267 vpx_codec_control(encoder_, VP9E_GET_SVC_REF_FRAME_CONFIG, &enc_layer_conf);
Sergey Silkin38fabff2019-03-21 10:08:40 +01001268 const int update_buffer_slot =
1269 enc_layer_conf.update_buffer_slot[layer_id.spatial_layer_id];
Sergey Silkin76be2952018-08-21 12:30:33 +02001270
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001271 for (size_t i = 0; i < kNumVp9Buffers; ++i) {
Sergey Silkin38fabff2019-03-21 10:08:40 +01001272 if (update_buffer_slot & (1 << i)) {
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001273 ref_buf_[i] = frame_buf;
1274 }
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001275 }
Sergey Silkin38fabff2019-03-21 10:08:40 +01001276
1277 RTC_LOG(LS_VERBOSE) << "Frame " << pic_num << " sl "
1278 << layer_id.spatial_layer_id << " tl "
1279 << layer_id.temporal_layer_id << " updated buffers "
1280 << (update_buffer_slot & (1 << 0) ? 1 : 0)
1281 << (update_buffer_slot & (1 << 1) ? 1 : 0)
1282 << (update_buffer_slot & (1 << 2) ? 1 : 0)
1283 << (update_buffer_slot & (1 << 3) ? 1 : 0)
1284 << (update_buffer_slot & (1 << 4) ? 1 : 0)
1285 << (update_buffer_slot & (1 << 5) ? 1 : 0)
1286 << (update_buffer_slot & (1 << 6) ? 1 : 0)
1287 << (update_buffer_slot & (1 << 7) ? 1 : 0);
Sergey Silkin76be2952018-08-21 12:30:33 +02001288 } else {
1289 RTC_DCHECK_EQ(num_spatial_layers_, 1);
1290 RTC_DCHECK_EQ(num_temporal_layers_, 1);
1291 // In non-svc mode encoder doesn't provide reference list. Assume each frame
1292 // is reference and stored in buffer 0.
1293 ref_buf_[0] = frame_buf;
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001294 }
1295}
1296
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001297vpx_svc_ref_frame_config_t VP9EncoderImpl::SetReferences(
1298 bool is_key_pic,
1299 size_t first_active_spatial_layer_id) {
Sergey Silkin390f3582018-10-01 17:13:50 +02001300 // kRefBufIdx, kUpdBufIdx need to be updated to support longer GOFs.
1301 RTC_DCHECK_LE(gof_.num_frames_in_gof, 4);
1302
1303 vpx_svc_ref_frame_config_t ref_config;
1304 memset(&ref_config, 0, sizeof(ref_config));
1305
1306 const size_t num_temporal_refs = std::max(1, num_temporal_layers_ - 1);
1307 const bool is_inter_layer_pred_allowed =
1308 inter_layer_pred_ == InterLayerPredMode::kOn ||
1309 (inter_layer_pred_ == InterLayerPredMode::kOnKeyPic && is_key_pic);
1310 absl::optional<int> last_updated_buf_idx;
1311
1312 // Put temporal reference to LAST and spatial reference to GOLDEN. Update
1313 // frame buffer (i.e. store encoded frame) if current frame is a temporal
1314 // reference (i.e. it belongs to a low temporal layer) or it is a spatial
1315 // reference. In later case, always store spatial reference in the last
1316 // reference frame buffer.
1317 // For the case of 3 temporal and 3 spatial layers we need 6 frame buffers
1318 // for temporal references plus 1 buffer for spatial reference. 7 buffers
1319 // in total.
1320
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001321 for (size_t sl_idx = first_active_spatial_layer_id;
1322 sl_idx < num_active_spatial_layers_; ++sl_idx) {
1323 const size_t curr_pic_num = is_key_pic ? 0 : pics_since_key_ + 1;
1324 const size_t gof_idx = curr_pic_num % gof_.num_frames_in_gof;
Sergey Silkin390f3582018-10-01 17:13:50 +02001325
1326 if (!is_key_pic) {
1327 // Set up temporal reference.
1328 const int buf_idx = sl_idx * num_temporal_refs + kRefBufIdx[gof_idx];
1329
1330 // Last reference frame buffer is reserved for spatial reference. It is
1331 // not supposed to be used for temporal prediction.
1332 RTC_DCHECK_LT(buf_idx, kNumVp9Buffers - 1);
1333
1334 // Sanity check that reference picture number is smaller than current
1335 // picture number.
Sergey Silkin390f3582018-10-01 17:13:50 +02001336 RTC_DCHECK_LT(ref_buf_[buf_idx].pic_num, curr_pic_num);
1337 const size_t pid_diff = curr_pic_num - ref_buf_[buf_idx].pic_num;
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001338 // Incorrect spatial layer may be in the buffer due to a key-frame.
1339 const bool same_spatial_layer =
1340 ref_buf_[buf_idx].spatial_layer_id == sl_idx;
1341 bool correct_pid = false;
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +02001342 if (is_flexible_mode_) {
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001343 correct_pid = pid_diff < kMaxAllowedPidDIff;
1344 } else {
1345 // Below code assumes single temporal referecence.
1346 RTC_DCHECK_EQ(gof_.num_ref_pics[gof_idx], 1);
1347 correct_pid = pid_diff == gof_.pid_diff[gof_idx][0];
1348 }
Sergey Silkin390f3582018-10-01 17:13:50 +02001349
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001350 if (same_spatial_layer && correct_pid) {
Sergey Silkin390f3582018-10-01 17:13:50 +02001351 ref_config.lst_fb_idx[sl_idx] = buf_idx;
1352 ref_config.reference_last[sl_idx] = 1;
1353 } else {
1354 // This reference doesn't match with one specified by GOF. This can
1355 // only happen if spatial layer is enabled dynamically without key
1356 // frame. Spatial prediction is supposed to be enabled in this case.
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001357 RTC_DCHECK(is_inter_layer_pred_allowed &&
1358 sl_idx > first_active_spatial_layer_id);
Sergey Silkin390f3582018-10-01 17:13:50 +02001359 }
1360 }
1361
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001362 if (is_inter_layer_pred_allowed && sl_idx > first_active_spatial_layer_id) {
Sergey Silkin390f3582018-10-01 17:13:50 +02001363 // Set up spatial reference.
1364 RTC_DCHECK(last_updated_buf_idx);
1365 ref_config.gld_fb_idx[sl_idx] = *last_updated_buf_idx;
1366 ref_config.reference_golden[sl_idx] = 1;
1367 } else {
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001368 RTC_DCHECK(ref_config.reference_last[sl_idx] != 0 ||
1369 sl_idx == first_active_spatial_layer_id ||
Sergey Silkin390f3582018-10-01 17:13:50 +02001370 inter_layer_pred_ == InterLayerPredMode::kOff);
1371 }
1372
1373 last_updated_buf_idx.reset();
1374
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +01001375 if (gof_.temporal_idx[gof_idx] < num_temporal_layers_ - 1 ||
1376 num_temporal_layers_ == 1) {
Sergey Silkin390f3582018-10-01 17:13:50 +02001377 last_updated_buf_idx = sl_idx * num_temporal_refs + kUpdBufIdx[gof_idx];
1378
1379 // Ensure last frame buffer is not used for temporal prediction (it is
1380 // reserved for spatial reference).
1381 RTC_DCHECK_LT(*last_updated_buf_idx, kNumVp9Buffers - 1);
1382 } else if (is_inter_layer_pred_allowed) {
1383 last_updated_buf_idx = kNumVp9Buffers - 1;
1384 }
1385
1386 if (last_updated_buf_idx) {
1387 ref_config.update_buffer_slot[sl_idx] = 1 << *last_updated_buf_idx;
1388 }
1389 }
1390
1391 return ref_config;
1392}
1393
asaperssona9455ab2015-07-31 06:10:09 -07001394int VP9EncoderImpl::GetEncodedLayerFrame(const vpx_codec_cx_pkt* pkt) {
asapersson86956de2016-01-26 01:05:20 -08001395 RTC_DCHECK_EQ(pkt->kind, VPX_CODEC_CX_FRAME_PKT);
asaperssona9455ab2015-07-31 06:10:09 -07001396
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001397 if (pkt->data.frame.sz == 0) {
1398 // Ignore dropped frame.
1399 return WEBRTC_VIDEO_CODEC_OK;
1400 }
1401
Sergey Silkin07f80cc2018-04-09 13:11:59 +02001402 vpx_svc_layer_id_t layer_id = {0};
1403 vpx_codec_control(encoder_, VP9E_GET_SVC_LAYER_ID, &layer_id);
1404
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001405 if (!full_superframe_drop_) {
1406 // Deliver buffered low spatial layer frame.
1407 const bool end_of_picture = false;
1408 DeliverBufferedFrame(end_of_picture);
1409 }
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001410
Niels Möller4d504c72019-06-18 15:56:56 +02001411 // TODO(nisse): Introduce some buffer cache or buffer pool, to reduce
1412 // allocations and/or copy operations.
1413 encoded_image_.SetEncodedData(EncodedImageBuffer::Create(
1414 static_cast<const uint8_t*>(pkt->data.frame.buf), pkt->data.frame.sz));
asaperssond9f641e2016-01-21 01:11:35 -08001415
Sergey Silkinbd0954e2018-05-03 14:14:09 +02001416 const bool is_key_frame =
1417 (pkt->data.frame.flags & VPX_FRAME_IS_KEY) ? true : false;
1418 // Ensure encoder issued key frame on request.
1419 RTC_DCHECK(is_key_frame || !force_key_frame_);
1420
asaperssona9455ab2015-07-31 06:10:09 -07001421 // Check if encoded frame is a key frame.
Niels Möller8f7ce222019-03-21 15:43:58 +01001422 encoded_image_._frameType = VideoFrameType::kVideoFrameDelta;
Sergey Silkinbd0954e2018-05-03 14:14:09 +02001423 if (is_key_frame) {
Niels Möller8f7ce222019-03-21 15:43:58 +01001424 encoded_image_._frameType = VideoFrameType::kVideoFrameKey;
Sergey Silkinbd0954e2018-05-03 14:14:09 +02001425 force_key_frame_ = false;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001426 }
Niels Möller77536a22019-01-15 08:50:01 +01001427 RTC_DCHECK_LE(encoded_image_.size(), encoded_image_.capacity());
asapersson86956de2016-01-26 01:05:20 -08001428
philipeld1d03592019-03-01 13:53:55 +01001429 codec_specific_ = {};
Niels Möllerd3b8c632018-08-27 15:33:42 +02001430 absl::optional<int> spatial_index;
1431 PopulateCodecSpecific(&codec_specific_, &spatial_index, *pkt,
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001432 input_image_->timestamp());
Niels Möllerd3b8c632018-08-27 15:33:42 +02001433 encoded_image_.SetSpatialIndex(spatial_index);
asaperssona9455ab2015-07-31 06:10:09 -07001434
Ilya Nikolaevskiy2ec0c652019-01-18 11:56:48 +01001435 UpdateReferenceBuffers(*pkt, pics_since_key_);
Sergey Silkin4e6cd5e2018-05-28 12:26:36 +02001436
Niels Möller77536a22019-01-15 08:50:01 +01001437 TRACE_COUNTER1("webrtc", "EncodedFrameSize", encoded_image_.size());
Niels Möller23775882018-08-16 10:24:12 +02001438 encoded_image_.SetTimestamp(input_image_->timestamp());
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001439 encoded_image_._encodedHeight =
1440 pkt->data.frame.height[layer_id.spatial_layer_id];
1441 encoded_image_._encodedWidth =
1442 pkt->data.frame.width[layer_id.spatial_layer_id];
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001443 int qp = -1;
1444 vpx_codec_control(encoder_, VP8E_GET_LAST_QUANTIZER, &qp);
1445 encoded_image_.qp_ = qp;
ilnik04f4d122017-06-19 07:18:55 -07001446
Sergey Silkin88ce4ef2018-11-23 13:59:24 +01001447 if (full_superframe_drop_) {
1448 const bool end_of_picture = encoded_image_.SpatialIndex().value_or(0) + 1 ==
1449 num_active_spatial_layers_;
1450 DeliverBufferedFrame(end_of_picture);
1451 }
1452
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001453 return WEBRTC_VIDEO_CODEC_OK;
1454}
1455
Sergey Silkinbc0f0d32018-04-24 21:29:14 +02001456void VP9EncoderImpl::DeliverBufferedFrame(bool end_of_picture) {
Niels Möller77536a22019-01-15 08:50:01 +01001457 if (encoded_image_.size() > 0) {
Ilya Nikolaevskiy039a7142019-05-24 16:50:00 +02001458 if (num_spatial_layers_ > 1) {
1459 // Restore frame dropping settings, as dropping may be temporary forbidden
1460 // due to dynamically enabled layers.
1461 svc_drop_frame_.framedrop_thresh[0] = config_->rc_dropframe_thresh;
1462 for (size_t i = 1; i < num_spatial_layers_; ++i) {
1463 svc_drop_frame_.framedrop_thresh[i] =
1464 dropping_only_base_layer_ ? 0 : config_->rc_dropframe_thresh;
1465 }
1466 }
1467
Sergey Silkinbc0f0d32018-04-24 21:29:14 +02001468 codec_specific_.codecSpecific.VP9.end_of_picture = end_of_picture;
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001469
1470 // No data partitioning in VP9, so 1 partition only.
1471 int part_idx = 0;
1472 RTPFragmentationHeader frag_info;
1473 frag_info.VerifyAndAllocateFragmentationHeader(1);
1474 frag_info.fragmentationOffset[part_idx] = 0;
Niels Möller77536a22019-01-15 08:50:01 +01001475 frag_info.fragmentationLength[part_idx] = encoded_image_.size();
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001476
1477 encoded_complete_callback_->OnEncodedImage(encoded_image_, &codec_specific_,
1478 &frag_info);
Sergey Silkind902d582018-05-18 17:31:19 +02001479
Sergey Silkin96f2c972018-09-05 21:07:17 +02001480 if (codec_.mode == VideoCodecMode::kScreensharing) {
1481 const uint8_t spatial_idx = encoded_image_.SpatialIndex().value_or(0);
1482 const uint32_t frame_timestamp_ms =
Niels Möller23775882018-08-16 10:24:12 +02001483 1000 * encoded_image_.Timestamp() / kVideoPayloadTypeFrequency;
Sergey Silkin96f2c972018-09-05 21:07:17 +02001484 framerate_controller_[spatial_idx].AddFrame(frame_timestamp_ms);
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +01001485
1486 const size_t steady_state_size = SteadyStateSize(
1487 spatial_idx, codec_specific_.codecSpecific.VP9.temporal_idx);
1488
1489 // Only frames on spatial layers, which may be limited in a steady state
1490 // are considered for steady state detection.
1491 if (framerate_controller_[spatial_idx].GetTargetRate() >
1492 variable_framerate_experiment_.framerate_limit + 1e-9) {
1493 if (encoded_image_.qp_ <=
1494 variable_framerate_experiment_.steady_state_qp &&
1495 encoded_image_.size() <= steady_state_size) {
1496 ++num_steady_state_frames_;
1497 } else {
1498 num_steady_state_frames_ = 0;
1499 }
1500 }
Sergey Silkind902d582018-05-18 17:31:19 +02001501 }
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +01001502 encoded_image_.set_size(0);
Sergey Silkin2a1f1832018-04-04 11:45:41 +02001503 }
1504}
1505
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001506int VP9EncoderImpl::RegisterEncodeCompleteCallback(
1507 EncodedImageCallback* callback) {
1508 encoded_complete_callback_ = callback;
1509 return WEBRTC_VIDEO_CODEC_OK;
1510}
1511
Erik Språng727d1642018-11-07 16:54:15 +01001512VideoEncoder::EncoderInfo VP9EncoderImpl::GetEncoderInfo() const {
1513 EncoderInfo info;
1514 info.supports_native_handle = false;
1515 info.implementation_name = "libvpx";
1516 info.scaling_settings = VideoEncoder::ScalingSettings::kOff;
Erik Språngd3438aa2018-11-08 16:56:43 +01001517 info.has_trusted_rate_controller = trusted_rate_controller_;
Mirta Dvornicic897a9912018-11-30 13:12:21 +01001518 info.is_hardware_accelerated = false;
1519 info.has_internal_source = false;
Erik Språngdbdd8392019-01-17 15:27:50 +01001520 for (size_t si = 0; si < num_spatial_layers_; ++si) {
1521 info.fps_allocation[si].clear();
1522 if (!codec_.spatialLayers[si].active) {
1523 continue;
1524 }
1525 // This spatial layer may already use a fraction of the total frame rate.
1526 const float sl_fps_fraction =
1527 codec_.spatialLayers[si].maxFramerate / codec_.maxFramerate;
1528 for (size_t ti = 0; ti < num_temporal_layers_; ++ti) {
1529 const uint32_t decimator =
1530 num_temporal_layers_ <= 1 ? 1 : config_->ts_rate_decimator[ti];
1531 RTC_DCHECK_GT(decimator, 0);
1532 info.fps_allocation[si].push_back(rtc::saturated_cast<uint8_t>(
1533 EncoderInfo::kMaxFramerateFraction * (sl_fps_fraction / decimator)));
1534 }
1535 }
Erik Språng727d1642018-11-07 16:54:15 +01001536 return info;
Peter Boströmb7d9a972015-12-18 16:01:11 +01001537}
1538
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +01001539size_t VP9EncoderImpl::SteadyStateSize(int sid, int tid) {
1540 const size_t bitrate_bps = current_bitrate_allocation_.GetBitrate(
1541 sid, tid == kNoTemporalIdx ? 0 : tid);
1542 const float fps = (codec_.mode == VideoCodecMode::kScreensharing)
Ilya Nikolaevskiy5c18a5f2019-05-24 11:51:31 +02001543 ? std::min(static_cast<float>(codec_.maxFramerate),
1544 framerate_controller_[sid].GetTargetRate())
Ilya Nikolaevskiy61170682019-03-06 16:04:32 +01001545 : codec_.maxFramerate;
1546 return static_cast<size_t>(
1547 bitrate_bps / (8 * fps) *
1548 (100 -
1549 variable_framerate_experiment_.steady_state_undershoot_percentage) /
1550 100 +
1551 0.5);
1552}
1553
1554// static
1555VP9EncoderImpl::VariableFramerateExperiment
1556VP9EncoderImpl::ParseVariableFramerateConfig(std::string group_name) {
1557 FieldTrialFlag enabled = FieldTrialFlag("Enabled");
1558 FieldTrialParameter<double> framerate_limit("min_fps", 5.0);
1559 FieldTrialParameter<int> qp("min_qp", 32);
1560 FieldTrialParameter<int> undershoot_percentage("undershoot", 30);
1561 FieldTrialParameter<int> frames_before_steady_state(
1562 "frames_before_steady_state", 5);
1563 ParseFieldTrial({&enabled, &framerate_limit, &qp, &undershoot_percentage,
1564 &frames_before_steady_state},
1565 field_trial::FindFullName(group_name));
1566 VariableFramerateExperiment config;
1567 config.enabled = enabled.Get();
1568 config.framerate_limit = framerate_limit.Get();
1569 config.steady_state_qp = qp.Get();
1570 config.steady_state_undershoot_percentage = undershoot_percentage.Get();
1571 config.frames_before_steady_state = frames_before_steady_state.Get();
1572
1573 return config;
1574}
1575
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001576VP9DecoderImpl::VP9DecoderImpl()
sprang3958ed82017-08-17 08:12:10 -07001577 : decode_complete_callback_(nullptr),
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001578 inited_(false),
sprang3958ed82017-08-17 08:12:10 -07001579 decoder_(nullptr),
philipel9d7d75b2018-04-04 13:03:01 +02001580 key_frame_required_(true) {}
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001581
1582VP9DecoderImpl::~VP9DecoderImpl() {
1583 inited_ = true; // in order to do the actual release
1584 Release();
Henrik Boström9695d852015-05-06 10:42:15 +02001585 int num_buffers_in_use = frame_buffer_pool_.GetNumBuffersInUse();
1586 if (num_buffers_in_use > 0) {
1587 // The frame buffers are reference counted and frames are exposed after
1588 // decoding. There may be valid usage cases where previous frames are still
1589 // referenced after ~VP9DecoderImpl that is not a leak.
Mirko Bonadei675513b2017-11-09 11:09:25 +01001590 RTC_LOG(LS_INFO) << num_buffers_in_use << " Vp9FrameBuffers are still "
1591 << "referenced during ~VP9DecoderImpl.";
Henrik Boström9695d852015-05-06 10:42:15 +02001592 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001593}
1594
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001595int VP9DecoderImpl::InitDecode(const VideoCodec* inst, int number_of_cores) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001596 int ret_val = Release();
1597 if (ret_val < 0) {
1598 return ret_val;
1599 }
Sergey Silkinb674cd12018-10-09 10:59:06 +02001600
sprang3958ed82017-08-17 08:12:10 -07001601 if (decoder_ == nullptr) {
pbos@webrtc.orge728ee02014-12-17 13:43:55 +00001602 decoder_ = new vpx_codec_ctx_t;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001603 }
philipelcce46fc2015-12-21 03:04:49 -08001604 vpx_codec_dec_cfg_t cfg;
Sergey Silkinb674cd12018-10-09 10:59:06 +02001605 memset(&cfg, 0, sizeof(cfg));
1606
1607 // We want to use multithreading when decoding high resolution videos. But,
1608 // since we don't know resolution of input stream at this stage, we always
1609 // enable it.
1610 cfg.threads = std::min(number_of_cores, kMaxNumTiles4kVideo);
1611
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001612 vpx_codec_flags_t flags = 0;
1613 if (vpx_codec_dec_init(decoder_, vpx_codec_vp9_dx(), &cfg, flags)) {
1614 return WEBRTC_VIDEO_CODEC_MEMORY;
1615 }
Henrik Boström9695d852015-05-06 10:42:15 +02001616
1617 if (!frame_buffer_pool_.InitializeVpxUsePool(decoder_)) {
1618 return WEBRTC_VIDEO_CODEC_MEMORY;
1619 }
1620
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001621 inited_ = true;
1622 // Always start with a complete key frame.
1623 key_frame_required_ = true;
1624 return WEBRTC_VIDEO_CODEC_OK;
1625}
1626
1627int VP9DecoderImpl::Decode(const EncodedImage& input_image,
1628 bool missing_frames,
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001629 int64_t /*render_time_ms*/) {
1630 if (!inited_) {
1631 return WEBRTC_VIDEO_CODEC_UNINITIALIZED;
1632 }
sprang3958ed82017-08-17 08:12:10 -07001633 if (decode_complete_callback_ == nullptr) {
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001634 return WEBRTC_VIDEO_CODEC_UNINITIALIZED;
1635 }
1636 // Always start with a complete key frame.
1637 if (key_frame_required_) {
Niels Möller8f7ce222019-03-21 15:43:58 +01001638 if (input_image._frameType != VideoFrameType::kVideoFrameKey)
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001639 return WEBRTC_VIDEO_CODEC_ERROR;
1640 // We have a key frame - is it complete?
1641 if (input_image._completeFrame) {
1642 key_frame_required_ = false;
1643 } else {
1644 return WEBRTC_VIDEO_CODEC_ERROR;
1645 }
1646 }
sprang3958ed82017-08-17 08:12:10 -07001647 vpx_codec_iter_t iter = nullptr;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001648 vpx_image_t* img;
Niels Möller24871e42019-01-17 11:31:13 +01001649 const uint8_t* buffer = input_image.data();
Niels Möller77536a22019-01-15 08:50:01 +01001650 if (input_image.size() == 0) {
sprang3958ed82017-08-17 08:12:10 -07001651 buffer = nullptr; // Triggers full frame concealment.
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001652 }
Henrik Boström9695d852015-05-06 10:42:15 +02001653 // During decode libvpx may get and release buffers from |frame_buffer_pool_|.
1654 // In practice libvpx keeps a few (~3-4) buffers alive at a time.
philipelcce46fc2015-12-21 03:04:49 -08001655 if (vpx_codec_decode(decoder_, buffer,
Niels Möller77536a22019-01-15 08:50:01 +01001656 static_cast<unsigned int>(input_image.size()), 0,
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001657 VPX_DL_REALTIME)) {
1658 return WEBRTC_VIDEO_CODEC_ERROR;
1659 }
Henrik Boström9695d852015-05-06 10:42:15 +02001660 // |img->fb_priv| contains the image data, a reference counted Vp9FrameBuffer.
1661 // It may be released by libvpx during future vpx_codec_decode or
1662 // vpx_codec_destroy calls.
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001663 img = vpx_codec_get_frame(decoder_, &iter);
sakal7adadb12017-02-23 02:54:57 -08001664 int qp;
1665 vpx_codec_err_t vpx_ret =
1666 vpx_codec_control(decoder_, VPXD_GET_LAST_QUANTIZER, &qp);
1667 RTC_DCHECK_EQ(vpx_ret, VPX_CODEC_OK);
Ilya Nikolaevskiyab62b2e2019-06-05 15:55:51 +02001668 int ret = ReturnFrame(img, input_image.Timestamp(), qp);
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 Nikolaevskiyab62b2e2019-06-05 15:55:51 +02001675int VP9DecoderImpl::ReturnFrame(const vpx_image_t* img,
1676 uint32_t timestamp,
1677 int qp) {
sprang3958ed82017-08-17 08:12:10 -07001678 if (img == nullptr) {
1679 // Decoder OK and nullptr image => No show frame.
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001680 return WEBRTC_VIDEO_CODEC_NO_OUTPUT;
1681 }
Henrik Boström9695d852015-05-06 10:42:15 +02001682
1683 // This buffer contains all of |img|'s image data, a reference counted
perkj14f41442015-11-30 22:15:45 -08001684 // Vp9FrameBuffer. (libvpx is done with the buffers after a few
Henrik Boström9695d852015-05-06 10:42:15 +02001685 // vpx_codec_decode calls or vpx_codec_destroy).
1686 Vp9FrameBufferPool::Vp9FrameBuffer* img_buffer =
1687 static_cast<Vp9FrameBufferPool::Vp9FrameBuffer*>(img->fb_priv);
Emircan Uysaler0823eec2018-07-13 17:10:00 -07001688
Miguel Casas-Sanchez47650702015-05-29 17:21:40 -07001689 // The buffer can be used directly by the VideoFrame (without copy) by
Emircan Uysaler0823eec2018-07-13 17:10:00 -07001690 // using a Wrapped*Buffer.
1691 rtc::scoped_refptr<VideoFrameBuffer> img_wrapped_buffer;
1692 switch (img->bit_depth) {
1693 case 8:
1694 img_wrapped_buffer = WrapI420Buffer(
philipelcce46fc2015-12-21 03:04:49 -08001695 img->d_w, img->d_h, img->planes[VPX_PLANE_Y],
1696 img->stride[VPX_PLANE_Y], img->planes[VPX_PLANE_U],
1697 img->stride[VPX_PLANE_U], img->planes[VPX_PLANE_V],
1698 img->stride[VPX_PLANE_V],
Henrik Boström9695d852015-05-06 10:42:15 +02001699 // WrappedI420Buffer's mechanism for allowing the release of its frame
1700 // buffer is through a callback function. This is where we should
1701 // release |img_buffer|.
Emircan Uysaler0823eec2018-07-13 17:10:00 -07001702 rtc::KeepRefUntilDone(img_buffer));
1703 break;
1704 case 10:
1705 img_wrapped_buffer = WrapI010Buffer(
1706 img->d_w, img->d_h,
1707 reinterpret_cast<const uint16_t*>(img->planes[VPX_PLANE_Y]),
1708 img->stride[VPX_PLANE_Y] / 2,
1709 reinterpret_cast<const uint16_t*>(img->planes[VPX_PLANE_U]),
1710 img->stride[VPX_PLANE_U] / 2,
1711 reinterpret_cast<const uint16_t*>(img->planes[VPX_PLANE_V]),
1712 img->stride[VPX_PLANE_V] / 2, rtc::KeepRefUntilDone(img_buffer));
1713 break;
1714 default:
1715 RTC_NOTREACHED();
1716 return WEBRTC_VIDEO_CODEC_NO_OUTPUT;
1717 }
nisseca6d5d12016-06-17 05:03:04 -07001718
Johannes Kron4749e4e2018-11-21 10:18:18 +01001719 auto builder = VideoFrame::Builder()
1720 .set_video_frame_buffer(img_wrapped_buffer)
Johannes Kron4749e4e2018-11-21 10:18:18 +01001721 .set_timestamp_rtp(timestamp)
Ilya Nikolaevskiyab62b2e2019-06-05 15:55:51 +02001722 .set_color_space(ExtractVP9ColorSpace(img->cs, img->range,
1723 img->bit_depth));
Johannes Kron4749e4e2018-11-21 10:18:18 +01001724
1725 VideoFrame decoded_image = builder.build();
1726
Danil Chapovalov0040b662018-06-18 10:48:16 +02001727 decode_complete_callback_->Decoded(decoded_image, absl::nullopt, qp);
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001728 return WEBRTC_VIDEO_CODEC_OK;
1729}
1730
1731int VP9DecoderImpl::RegisterDecodeCompleteCallback(
1732 DecodedImageCallback* callback) {
1733 decode_complete_callback_ = callback;
1734 return WEBRTC_VIDEO_CODEC_OK;
1735}
1736
1737int VP9DecoderImpl::Release() {
Sergey Silkin3e871ea2018-03-02 13:11:04 +01001738 int ret_val = WEBRTC_VIDEO_CODEC_OK;
1739
sprang3958ed82017-08-17 08:12:10 -07001740 if (decoder_ != nullptr) {
Sergey Silkin90399692018-03-02 14:44:10 +01001741 if (inited_) {
1742 // When a codec is destroyed libvpx will release any buffers of
1743 // |frame_buffer_pool_| it is currently using.
1744 if (vpx_codec_destroy(decoder_)) {
1745 ret_val = WEBRTC_VIDEO_CODEC_MEMORY;
1746 }
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001747 }
1748 delete decoder_;
sprang3958ed82017-08-17 08:12:10 -07001749 decoder_ = nullptr;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001750 }
Henrik Boström9695d852015-05-06 10:42:15 +02001751 // Releases buffers from the pool. Any buffers not in use are deleted. Buffers
1752 // still referenced externally are deleted once fully released, not returning
1753 // to the pool.
1754 frame_buffer_pool_.ClearPool();
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001755 inited_ = false;
Sergey Silkin3e871ea2018-03-02 13:11:04 +01001756 return ret_val;
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001757}
Peter Boströmb7d9a972015-12-18 16:01:11 +01001758
1759const char* VP9DecoderImpl::ImplementationName() const {
1760 return "libvpx";
1761}
1762
marpan@webrtc.org5b883172014-11-01 06:10:48 +00001763} // namespace webrtc
Mirko Bonadei95adedb2018-11-19 09:52:37 +01001764
1765#endif // RTC_ENABLE_VP9