Skip to content

Commit

Permalink
Revert "Move class VideoCodec from common_types.h to its own api head…
Browse files Browse the repository at this point in the history
…er file."

This reverts commit efc71e5.

Reason for revert: probably breaks downstream test

Original change's description:
> Move class VideoCodec from common_types.h to its own api header file.
> 
> Bug: webrtc:7660
> Change-Id: I91f19bfc2565461328f30081f8383e136419aefb
> Reviewed-on: https://webrtc-review.googlesource.com/79881
> Commit-Queue: Niels Moller <[email protected]>
> Reviewed-by: Rasmus Brandt <[email protected]>
> Reviewed-by: Danil Chapovalov <[email protected]>
> Reviewed-by: Karl Wiberg <[email protected]>
> Cr-Commit-Position: refs/heads/master@{#23544}

[email protected],[email protected],[email protected],[email protected]

Change-Id: Id8bd37c79c2f8d09a4d88368765230103f1db2c8
No-Presubmit: true
No-Tree-Checks: true
No-Try: true
Bug: webrtc:7660
Reviewed-on: https://webrtc-review.googlesource.com/82101
Reviewed-by: Danil Chapovalov <[email protected]>
Commit-Queue: Danil Chapovalov <[email protected]>
Cr-Commit-Position: refs/heads/master@{#23547}
  • Loading branch information
DanilChapovalov authored and Commit Bot committed Jun 8, 2018
1 parent 7252053 commit 350531e
Show file tree
Hide file tree
Showing 23 changed files with 182 additions and 185 deletions.
3 changes: 2 additions & 1 deletion BUILD.gn
Original file line number Diff line number Diff line change
Expand Up @@ -383,8 +383,9 @@ rtc_source_set("typedefs") {
]
}

rtc_source_set("webrtc_common") {
rtc_static_library("webrtc_common") {
sources = [
"common_types.cc",
"common_types.h",
]
deps = [
Expand Down
1 change: 0 additions & 1 deletion api/video_codecs/BUILD.gn
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,6 @@ rtc_source_set("video_codecs_api") {
sources = [
"sdp_video_format.cc",
"sdp_video_format.h",
"video_codec.cc",
"video_codec.h",
"video_decoder.cc",
"video_decoder.h",
Expand Down
150 changes: 4 additions & 146 deletions api/video_codecs/video_codec.h
Original file line number Diff line number Diff line change
Expand Up @@ -11,155 +11,13 @@
#ifndef API_VIDEO_CODECS_VIDEO_CODEC_H_
#define API_VIDEO_CODECS_VIDEO_CODEC_H_

#include <string>
// TODO(bugs.webrtc.org/7660): This is an initial place holder file. Downstream
// users of VideoCodec must be updated to include this file, before contents can
// be moved out of common_types.h.

#include "common_types.h" // NOLINT(build/include)

namespace webrtc {

// The VideoCodec class represents an old defacto-apis, which we're migrating
// The VideoCodec class represents an old defacto-api, which we're migrating
// away from slowly.

// Video codec
enum VideoCodecComplexity {
kComplexityNormal = 0,
kComplexityHigh = 1,
kComplexityHigher = 2,
kComplexityMax = 3
};

// VP8 specific
struct VideoCodecVP8 {
bool operator==(const VideoCodecVP8& other) const;
bool operator!=(const VideoCodecVP8& other) const {
return !(*this == other);
}
VideoCodecComplexity complexity;
unsigned char numberOfTemporalLayers;
bool denoisingOn;
bool automaticResizeOn;
bool frameDroppingOn;
int keyFrameInterval;
};

enum class InterLayerPredMode {
kOn, // Allow inter-layer prediction for all frames.
// Frame of low spatial layer can be used for
// prediction of next spatial layer frame.
kOff, // Encoder produces independent spatial layers.
kOnKeyPic // Allow inter-layer prediction only for frames
// within key picture.
};

// VP9 specific.
struct VideoCodecVP9 {
bool operator==(const VideoCodecVP9& other) const;
bool operator!=(const VideoCodecVP9& other) const {
return !(*this == other);
}
VideoCodecComplexity complexity;
unsigned char numberOfTemporalLayers;
bool denoisingOn;
bool frameDroppingOn;
int keyFrameInterval;
bool adaptiveQpMode;
bool automaticResizeOn;
unsigned char numberOfSpatialLayers;
bool flexibleMode;
InterLayerPredMode interLayerPred;
};

// H264 specific.
struct VideoCodecH264 {
bool operator==(const VideoCodecH264& other) const;
bool operator!=(const VideoCodecH264& other) const {
return !(*this == other);
}
bool frameDroppingOn;
int keyFrameInterval;
// These are NULL/0 if not externally negotiated.
const uint8_t* spsData;
size_t spsLen;
const uint8_t* ppsData;
size_t ppsLen;
H264::Profile profile;
};

// Translates from name of codec to codec type and vice versa.
const char* CodecTypeToPayloadString(VideoCodecType type);
VideoCodecType PayloadStringToCodecType(const std::string& name);

union VideoCodecUnion {
VideoCodecVP8 VP8;
VideoCodecVP9 VP9;
VideoCodecH264 H264;
};

enum VideoCodecMode { kRealtimeVideo, kScreensharing };

// Common video codec properties
class VideoCodec {
public:
VideoCodec();

// Public variables. TODO(hta): Make them private with accessors.
VideoCodecType codecType;
unsigned char plType;

int width;
int height;

unsigned int startBitrate; // kilobits/sec.
unsigned int maxBitrate; // kilobits/sec.
unsigned int minBitrate; // kilobits/sec.
unsigned int targetBitrate; // kilobits/sec.

uint32_t maxFramerate;

// This enables/disables encoding and sending when there aren't multiple
// simulcast streams,by allocating 0 bitrate if inactive.
bool active;

unsigned int qpMax;
unsigned char numberOfSimulcastStreams;
SimulcastStream simulcastStream[kMaxSimulcastStreams];
SpatialLayer spatialLayers[kMaxSpatialLayers];

VideoCodecMode mode;
bool expect_encode_from_texture;

// Timing frames configuration. There is delay of delay_ms between two
// consequent timing frames, excluding outliers. Frame is always made a
// timing frame if it's at least outlier_ratio in percent of "ideal" average
// frame given bitrate and framerate, i.e. if it's bigger than
// |outlier_ratio / 100.0 * bitrate_bps / fps| in bits. This way, timing
// frames will not be sent too often usually. Yet large frames will always
// have timing information for debug purposes because they are more likely to
// cause extra delays.
struct TimingFrameTriggerThresholds {
int64_t delay_ms;
uint16_t outlier_ratio_percent;
} timing_frame_thresholds;

bool operator==(const VideoCodec& other) const = delete;
bool operator!=(const VideoCodec& other) const = delete;

// Accessors for codec specific information.
// There is a const version of each that returns a reference,
// and a non-const version that returns a pointer, in order
// to allow modification of the parameters.
VideoCodecVP8* VP8();
const VideoCodecVP8& VP8() const;
VideoCodecVP9* VP9();
const VideoCodecVP9& VP9() const;
VideoCodecH264* H264();
const VideoCodecH264& H264() const;

private:
// TODO(hta): Consider replacing the union with a pointer type.
// This will allow removing the VideoCodec* types from this file.
VideoCodecUnion codec_specific_;
};

} // namespace webrtc
#endif // API_VIDEO_CODECS_VIDEO_CODEC_H_
1 change: 1 addition & 0 deletions api/video_codecs/video_encoder.h
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@ namespace webrtc {
class RTPFragmentationHeader;
// TODO(pbos): Expose these through a public (root) header or change these APIs.
struct CodecSpecificInfo;
class VideoCodec;

class EncodedImageCallback {
public:
Expand Down
6 changes: 3 additions & 3 deletions api/video_codecs/video_encoder_config.h
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,8 @@
#include <vector>

#include "api/optional.h"
#include "api/video_codecs/video_codec.h"
#include "api/video_codecs/sdp_video_format.h"
#include "common_types.h" // NOLINT(build/include)
#include "rtc_base/refcount.h"
#include "rtc_base/scoped_ref_ptr.h"

Expand All @@ -28,8 +28,8 @@ struct VideoStream {
VideoStream(const VideoStream& other);
std::string ToString() const;

int width;
int height;
size_t width;
size_t height;
int max_framerate;

int min_bitrate_bps;
Expand Down
3 changes: 1 addition & 2 deletions api/video_codecs/video_codec.cc → common_types.cc
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,11 @@
* be found in the AUTHORS file in the root of the source tree.
*/

#include "api/video_codecs/video_codec.h"
#include "common_types.h" // NOLINT(build/include)

#include <string.h>
#include <algorithm>
#include <limits>
#include <string>
#include <type_traits>

#include "rtc_base/checks.h"
Expand Down
137 changes: 137 additions & 0 deletions common_types.h
Original file line number Diff line number Diff line change
Expand Up @@ -325,6 +325,55 @@ enum class VideoType {
kBGRA,
};

// Video codec
enum VideoCodecComplexity {
kComplexityNormal = 0,
kComplexityHigh = 1,
kComplexityHigher = 2,
kComplexityMax = 3
};

// VP8 specific
struct VideoCodecVP8 {
bool operator==(const VideoCodecVP8& other) const;
bool operator!=(const VideoCodecVP8& other) const {
return !(*this == other);
}
VideoCodecComplexity complexity;
unsigned char numberOfTemporalLayers;
bool denoisingOn;
bool automaticResizeOn;
bool frameDroppingOn;
int keyFrameInterval;
};

enum class InterLayerPredMode {
kOn, // Allow inter-layer prediction for all frames.
// Frame of low spatial layer can be used for
// prediction of next spatial layer frame.
kOff, // Encoder produces independent spatial layers.
kOnKeyPic // Allow inter-layer prediction only for frames
// within key picture.
};

// VP9 specific.
struct VideoCodecVP9 {
bool operator==(const VideoCodecVP9& other) const;
bool operator!=(const VideoCodecVP9& other) const {
return !(*this == other);
}
VideoCodecComplexity complexity;
unsigned char numberOfTemporalLayers;
bool denoisingOn;
bool frameDroppingOn;
int keyFrameInterval;
bool adaptiveQpMode;
bool automaticResizeOn;
unsigned char numberOfSpatialLayers;
bool flexibleMode;
InterLayerPredMode interLayerPred;
};

// TODO(magjed): Move this and other H264 related classes out to their own file.
namespace H264 {

Expand All @@ -338,6 +387,22 @@ enum Profile {

} // namespace H264

// H264 specific.
struct VideoCodecH264 {
bool operator==(const VideoCodecH264& other) const;
bool operator!=(const VideoCodecH264& other) const {
return !(*this == other);
}
bool frameDroppingOn;
int keyFrameInterval;
// These are NULL/0 if not externally negotiated.
const uint8_t* spsData;
size_t spsLen;
const uint8_t* ppsData;
size_t ppsLen;
H264::Profile profile;
};

// Video codec types
enum VideoCodecType {
// There are various memset(..., 0, ...) calls in the code that rely on
Expand All @@ -362,6 +427,12 @@ enum VideoCodecType {
const char* CodecTypeToPayloadString(VideoCodecType type);
VideoCodecType PayloadStringToCodecType(const std::string& name);

union VideoCodecUnion {
VideoCodecVP8 VP8;
VideoCodecVP9 VP9;
VideoCodecH264 H264;
};

struct SpatialLayer {
bool operator==(const SpatialLayer& other) const;
bool operator!=(const SpatialLayer& other) const { return !(*this == other); }
Expand All @@ -380,6 +451,72 @@ struct SpatialLayer {
// settings such as resolution.
typedef SpatialLayer SimulcastStream;

enum VideoCodecMode { kRealtimeVideo, kScreensharing };

// Common video codec properties
class VideoCodec {
public:
VideoCodec();

// Public variables. TODO(hta): Make them private with accessors.
VideoCodecType codecType;
unsigned char plType;

unsigned short width;
unsigned short height;

unsigned int startBitrate; // kilobits/sec.
unsigned int maxBitrate; // kilobits/sec.
unsigned int minBitrate; // kilobits/sec.
unsigned int targetBitrate; // kilobits/sec.

uint32_t maxFramerate;

// This enables/disables encoding and sending when there aren't multiple
// simulcast streams,by allocating 0 bitrate if inactive.
bool active;

unsigned int qpMax;
unsigned char numberOfSimulcastStreams;
SimulcastStream simulcastStream[kMaxSimulcastStreams];
SpatialLayer spatialLayers[kMaxSpatialLayers];

VideoCodecMode mode;
bool expect_encode_from_texture;

// Timing frames configuration. There is delay of delay_ms between two
// consequent timing frames, excluding outliers. Frame is always made a
// timing frame if it's at least outlier_ratio in percent of "ideal" average
// frame given bitrate and framerate, i.e. if it's bigger than
// |outlier_ratio / 100.0 * bitrate_bps / fps| in bits. This way, timing
// frames will not be sent too often usually. Yet large frames will always
// have timing information for debug purposes because they are more likely to
// cause extra delays.
struct TimingFrameTriggerThresholds {
int64_t delay_ms;
uint16_t outlier_ratio_percent;
} timing_frame_thresholds;

bool operator==(const VideoCodec& other) const = delete;
bool operator!=(const VideoCodec& other) const = delete;

// Accessors for codec specific information.
// There is a const version of each that returns a reference,
// and a non-const version that returns a pointer, in order
// to allow modification of the parameters.
VideoCodecVP8* VP8();
const VideoCodecVP8& VP8() const;
VideoCodecVP9* VP9();
const VideoCodecVP9& VP9() const;
VideoCodecH264* H264();
const VideoCodecH264& H264() const;

private:
// TODO(hta): Consider replacing the union with a pointer type.
// This will allow removing the VideoCodec* types from this file.
VideoCodecUnion codec_specific_;
};

// TODO(sprang): Remove this when downstream projects have been updated.
using BitrateAllocation = VideoBitrateAllocation;

Expand Down
Loading

0 comments on commit 350531e

Please sign in to comment.