|  | /* | 
|  | *  Copyright (c) 2016 The WebRTC project authors. All Rights Reserved. | 
|  | * | 
|  | *  Use of this source code is governed by a BSD-style license | 
|  | *  that can be found in the LICENSE file in the root of the source | 
|  | *  tree. An additional intellectual property rights grant can be found | 
|  | *  in the file PATENTS.  All contributing project authors may | 
|  | *  be found in the AUTHORS file in the root of the source tree. | 
|  | */ | 
|  |  | 
|  | #include "modules/video_coding/include/video_codec_initializer.h" | 
|  |  | 
|  | #include <stdint.h> | 
|  | #include <string.h> | 
|  | #include <algorithm> | 
|  |  | 
|  | #include "absl/types/optional.h" | 
|  | #include "api/scoped_refptr.h" | 
|  | #include "api/video/video_bitrate_allocation.h" | 
|  | #include "api/video_codecs/video_encoder.h" | 
|  | #include "common_types.h"  // NOLINT(build/include) | 
|  | #include "modules/video_coding/codecs/vp9/svc_config.h" | 
|  | #include "modules/video_coding/include/video_coding_defines.h" | 
|  | #include "rtc_base/checks.h" | 
|  | #include "rtc_base/logging.h" | 
|  |  | 
|  | namespace webrtc { | 
|  |  | 
|  | bool VideoCodecInitializer::SetupCodec(const VideoEncoderConfig& config, | 
|  | const std::vector<VideoStream>& streams, | 
|  | VideoCodec* codec) { | 
|  | if (config.codec_type == kVideoCodecMultiplex) { | 
|  | VideoEncoderConfig associated_config = config.Copy(); | 
|  | associated_config.codec_type = kVideoCodecVP9; | 
|  | if (!SetupCodec(associated_config, streams, codec)) { | 
|  | RTC_LOG(LS_ERROR) << "Failed to create stereo encoder configuration."; | 
|  | return false; | 
|  | } | 
|  | codec->codecType = kVideoCodecMultiplex; | 
|  | return true; | 
|  | } | 
|  |  | 
|  | *codec = VideoEncoderConfigToVideoCodec(config, streams); | 
|  | return true; | 
|  | } | 
|  |  | 
|  | // TODO(sprang): Split this up and separate the codec specific parts. | 
|  | VideoCodec VideoCodecInitializer::VideoEncoderConfigToVideoCodec( | 
|  | const VideoEncoderConfig& config, | 
|  | const std::vector<VideoStream>& streams) { | 
|  | static const int kEncoderMinBitrateKbps = 30; | 
|  | RTC_DCHECK(!streams.empty()); | 
|  | RTC_DCHECK_GE(config.min_transmit_bitrate_bps, 0); | 
|  |  | 
|  | VideoCodec video_codec; | 
|  | memset(&video_codec, 0, sizeof(video_codec)); | 
|  | video_codec.codecType = config.codec_type; | 
|  |  | 
|  | switch (config.content_type) { | 
|  | case VideoEncoderConfig::ContentType::kRealtimeVideo: | 
|  | video_codec.mode = VideoCodecMode::kRealtimeVideo; | 
|  | break; | 
|  | case VideoEncoderConfig::ContentType::kScreen: | 
|  | video_codec.mode = VideoCodecMode::kScreensharing; | 
|  | break; | 
|  | } | 
|  |  | 
|  | // TODO(nisse): The plType field should be deleted. Luckily, our | 
|  | // callers don't need it. | 
|  | video_codec.plType = 0; | 
|  | video_codec.numberOfSimulcastStreams = | 
|  | static_cast<unsigned char>(streams.size()); | 
|  | video_codec.minBitrate = streams[0].min_bitrate_bps / 1000; | 
|  | bool codec_active = false; | 
|  | for (const VideoStream& stream : streams) { | 
|  | if (stream.active) { | 
|  | codec_active = true; | 
|  | break; | 
|  | } | 
|  | } | 
|  | // Set active for the entire video codec for the non simulcast case. | 
|  | video_codec.active = codec_active; | 
|  | if (video_codec.minBitrate < kEncoderMinBitrateKbps) | 
|  | video_codec.minBitrate = kEncoderMinBitrateKbps; | 
|  | video_codec.timing_frame_thresholds = {kDefaultTimingFramesDelayMs, | 
|  | kDefaultOutlierFrameSizePercent}; | 
|  | RTC_DCHECK_LE(streams.size(), kMaxSimulcastStreams); | 
|  |  | 
|  | for (size_t i = 0; i < streams.size(); ++i) { | 
|  | SimulcastStream* sim_stream = &video_codec.simulcastStream[i]; | 
|  | RTC_DCHECK_GT(streams[i].width, 0); | 
|  | RTC_DCHECK_GT(streams[i].height, 0); | 
|  | RTC_DCHECK_GT(streams[i].max_framerate, 0); | 
|  | // Different framerates not supported per stream at the moment, unless it's | 
|  | // screenshare where there is an exception and a simulcast encoder adapter, | 
|  | // which supports different framerates, is used instead. | 
|  | if (config.content_type != VideoEncoderConfig::ContentType::kScreen) { | 
|  | RTC_DCHECK_EQ(streams[i].max_framerate, streams[0].max_framerate); | 
|  | } | 
|  | RTC_DCHECK_GE(streams[i].min_bitrate_bps, 0); | 
|  | RTC_DCHECK_GE(streams[i].target_bitrate_bps, streams[i].min_bitrate_bps); | 
|  | RTC_DCHECK_GE(streams[i].max_bitrate_bps, streams[i].target_bitrate_bps); | 
|  | RTC_DCHECK_GE(streams[i].max_qp, 0); | 
|  |  | 
|  | sim_stream->width = static_cast<uint16_t>(streams[i].width); | 
|  | sim_stream->height = static_cast<uint16_t>(streams[i].height); | 
|  | sim_stream->maxFramerate = streams[i].max_framerate; | 
|  | sim_stream->minBitrate = streams[i].min_bitrate_bps / 1000; | 
|  | sim_stream->targetBitrate = streams[i].target_bitrate_bps / 1000; | 
|  | sim_stream->maxBitrate = streams[i].max_bitrate_bps / 1000; | 
|  | sim_stream->qpMax = streams[i].max_qp; | 
|  | sim_stream->numberOfTemporalLayers = | 
|  | static_cast<unsigned char>(streams[i].num_temporal_layers.value_or(1)); | 
|  | sim_stream->active = streams[i].active; | 
|  |  | 
|  | video_codec.width = | 
|  | std::max(video_codec.width, static_cast<uint16_t>(streams[i].width)); | 
|  | video_codec.height = | 
|  | std::max(video_codec.height, static_cast<uint16_t>(streams[i].height)); | 
|  | video_codec.minBitrate = | 
|  | std::min(static_cast<uint16_t>(video_codec.minBitrate), | 
|  | static_cast<uint16_t>(streams[i].min_bitrate_bps / 1000)); | 
|  | video_codec.maxBitrate += streams[i].max_bitrate_bps / 1000; | 
|  | video_codec.qpMax = std::max(video_codec.qpMax, | 
|  | static_cast<unsigned int>(streams[i].max_qp)); | 
|  | } | 
|  |  | 
|  | if (video_codec.maxBitrate == 0) { | 
|  | // Unset max bitrate -> cap to one bit per pixel. | 
|  | video_codec.maxBitrate = | 
|  | (video_codec.width * video_codec.height * video_codec.maxFramerate) / | 
|  | 1000; | 
|  | } | 
|  | if (video_codec.maxBitrate < kEncoderMinBitrateKbps) | 
|  | video_codec.maxBitrate = kEncoderMinBitrateKbps; | 
|  |  | 
|  | RTC_DCHECK_GT(streams[0].max_framerate, 0); | 
|  | video_codec.maxFramerate = streams[0].max_framerate; | 
|  |  | 
|  | // Set codec specific options | 
|  | if (config.encoder_specific_settings) | 
|  | config.encoder_specific_settings->FillEncoderSpecificSettings(&video_codec); | 
|  |  | 
|  | switch (video_codec.codecType) { | 
|  | case kVideoCodecVP8: { | 
|  | if (!config.encoder_specific_settings) { | 
|  | *video_codec.VP8() = VideoEncoder::GetDefaultVp8Settings(); | 
|  | } | 
|  |  | 
|  | video_codec.VP8()->numberOfTemporalLayers = static_cast<unsigned char>( | 
|  | streams.back().num_temporal_layers.value_or( | 
|  | video_codec.VP8()->numberOfTemporalLayers)); | 
|  | RTC_DCHECK_GE(video_codec.VP8()->numberOfTemporalLayers, 1); | 
|  | RTC_DCHECK_LE(video_codec.VP8()->numberOfTemporalLayers, | 
|  | kMaxTemporalStreams); | 
|  |  | 
|  | break; | 
|  | } | 
|  | case kVideoCodecVP9: { | 
|  | if (!config.encoder_specific_settings) { | 
|  | *video_codec.VP9() = VideoEncoder::GetDefaultVp9Settings(); | 
|  | } | 
|  |  | 
|  | video_codec.VP9()->numberOfTemporalLayers = static_cast<unsigned char>( | 
|  | streams.back().num_temporal_layers.value_or( | 
|  | video_codec.VP9()->numberOfTemporalLayers)); | 
|  | RTC_DCHECK_GE(video_codec.VP9()->numberOfTemporalLayers, 1); | 
|  | RTC_DCHECK_LE(video_codec.VP9()->numberOfTemporalLayers, | 
|  | kMaxTemporalStreams); | 
|  |  | 
|  | RTC_DCHECK(config.spatial_layers.empty() || | 
|  | config.spatial_layers.size() == | 
|  | video_codec.VP9()->numberOfSpatialLayers); | 
|  |  | 
|  | std::vector<SpatialLayer> spatial_layers; | 
|  | if (!config.spatial_layers.empty()) { | 
|  | // Layering is set explicitly. | 
|  | spatial_layers = config.spatial_layers; | 
|  | } else { | 
|  | spatial_layers = GetSvcConfig( | 
|  | video_codec.width, video_codec.height, video_codec.maxFramerate, | 
|  | video_codec.VP9()->numberOfSpatialLayers, | 
|  | video_codec.VP9()->numberOfTemporalLayers, | 
|  | video_codec.mode == VideoCodecMode::kScreensharing); | 
|  |  | 
|  | // If there was no request for spatial layering, don't limit bitrate | 
|  | // of single spatial layer. | 
|  | const bool no_spatial_layering = | 
|  | video_codec.VP9()->numberOfSpatialLayers <= 1; | 
|  | if (no_spatial_layering) { | 
|  | // Use codec's bitrate limits. | 
|  | spatial_layers.back().minBitrate = video_codec.minBitrate; | 
|  | spatial_layers.back().maxBitrate = video_codec.maxBitrate; | 
|  | } | 
|  |  | 
|  | for (size_t spatial_idx = 0; | 
|  | spatial_idx < config.simulcast_layers.size() && | 
|  | spatial_idx < spatial_layers.size(); | 
|  | ++spatial_idx) { | 
|  | spatial_layers[spatial_layers.size() - spatial_idx - 1].active = | 
|  | config.simulcast_layers[spatial_idx].active; | 
|  | } | 
|  | } | 
|  |  | 
|  | RTC_DCHECK(!spatial_layers.empty()); | 
|  | for (size_t i = 0; i < spatial_layers.size(); ++i) { | 
|  | video_codec.spatialLayers[i] = spatial_layers[i]; | 
|  | } | 
|  |  | 
|  | // Update layering settings. | 
|  | video_codec.VP9()->numberOfSpatialLayers = | 
|  | static_cast<unsigned char>(spatial_layers.size()); | 
|  | RTC_DCHECK_GE(video_codec.VP9()->numberOfSpatialLayers, 1); | 
|  | RTC_DCHECK_LE(video_codec.VP9()->numberOfSpatialLayers, | 
|  | kMaxSpatialLayers); | 
|  |  | 
|  | video_codec.VP9()->numberOfTemporalLayers = static_cast<unsigned char>( | 
|  | spatial_layers.back().numberOfTemporalLayers); | 
|  | RTC_DCHECK_GE(video_codec.VP9()->numberOfTemporalLayers, 1); | 
|  | RTC_DCHECK_LE(video_codec.VP9()->numberOfTemporalLayers, | 
|  | kMaxTemporalStreams); | 
|  |  | 
|  | break; | 
|  | } | 
|  | case kVideoCodecH264: { | 
|  | if (!config.encoder_specific_settings) | 
|  | *video_codec.H264() = VideoEncoder::GetDefaultH264Settings(); | 
|  | break; | 
|  | } | 
|  | default: | 
|  | // TODO(pbos): Support encoder_settings codec-agnostically. | 
|  | RTC_DCHECK(!config.encoder_specific_settings) | 
|  | << "Encoder-specific settings for codec type not wired up."; | 
|  | break; | 
|  | } | 
|  |  | 
|  | return video_codec; | 
|  | } | 
|  |  | 
|  | }  // namespace webrtc |