blob: aa7ee2430746c113933d7e3bb892aae84ee40427 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
/*
* Copyright (c) 2014 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.
*/
#ifndef API_VIDEO_CODECS_VIDEO_DECODER_H_
#define API_VIDEO_CODECS_VIDEO_DECODER_H_
#include <memory>
#include <string>
#include <vector>
#include "absl/types/optional.h"
#include "api/video/encoded_image.h"
#include "api/video/render_resolution.h"
#include "api/video/video_codec_type.h"
#include "api/video/video_frame.h"
#include "rtc_base/system/rtc_export.h"
namespace webrtc {
class RTC_EXPORT DecodedImageCallback {
public:
virtual ~DecodedImageCallback() {}
virtual int32_t Decoded(VideoFrame& decodedImage) = 0;
// Provides an alternative interface that allows the decoder to specify the
// decode time excluding waiting time for any previous pending frame to
// return. This is necessary for breaking positive feedback in the delay
// estimation when the decoder has a single output buffer.
virtual int32_t Decoded(VideoFrame& decodedImage, int64_t decode_time_ms);
// TODO(sakal): Remove other implementations when upstream projects have been
// updated.
virtual void Decoded(VideoFrame& decodedImage,
absl::optional<int32_t> decode_time_ms,
absl::optional<uint8_t> qp);
};
class RTC_EXPORT VideoDecoder {
public:
struct DecoderInfo {
// Descriptive name of the decoder implementation.
std::string implementation_name;
// True if the decoder is backed by hardware acceleration.
bool is_hardware_accelerated = false;
std::string ToString() const;
bool operator==(const DecoderInfo& rhs) const;
bool operator!=(const DecoderInfo& rhs) const { return !(*this == rhs); }
};
class Settings {
public:
Settings() = default;
Settings(const Settings&) = default;
Settings& operator=(const Settings&) = default;
~Settings() = default;
// The size of pool which is used to store video frame buffers inside
// decoder. If value isn't present some codec-default value will be used. If
// value is present and decoder doesn't have buffer pool the value will be
// ignored.
absl::optional<int> buffer_pool_size() const;
void set_buffer_pool_size(absl::optional<int> value);
// When valid, user of the VideoDecoder interface shouldn't `Decode`
// encoded images with render resolution larger than width and height
// specified here.
RenderResolution max_render_resolution() const;
void set_max_render_resolution(RenderResolution value);
// Maximum number of cpu cores the decoder is allowed to use in parallel.
// Must be positive.
int number_of_cores() const { return number_of_cores_; }
void set_number_of_cores(int value);
// Codec of encoded images user of the VideoDecoder interface will `Decode`.
VideoCodecType codec_type() const { return codec_type_; }
void set_codec_type(VideoCodecType value) { codec_type_ = value; }
private:
absl::optional<int> buffer_pool_size_;
RenderResolution max_resolution_;
int number_of_cores_ = 1;
VideoCodecType codec_type_ = kVideoCodecGeneric;
};
virtual ~VideoDecoder() = default;
// Prepares decoder to handle incoming encoded frames. Can be called multiple
// times, in such case only latest `settings` are in effect.
virtual bool Configure(const Settings& settings) = 0;
virtual int32_t Decode(const EncodedImage& input_image,
bool missing_frames,
int64_t render_time_ms) = 0;
virtual int32_t RegisterDecodeCompleteCallback(
DecodedImageCallback* callback) = 0;
virtual int32_t Release() = 0;
virtual DecoderInfo GetDecoderInfo() const;
// Deprecated, use GetDecoderInfo().implementation_name instead.
virtual const char* ImplementationName() const;
};
inline absl::optional<int> VideoDecoder::Settings::buffer_pool_size() const {
return buffer_pool_size_;
}
inline void VideoDecoder::Settings::set_buffer_pool_size(
absl::optional<int> value) {
buffer_pool_size_ = value;
}
inline RenderResolution VideoDecoder::Settings::max_render_resolution() const {
return max_resolution_;
}
inline void VideoDecoder::Settings::set_max_render_resolution(
RenderResolution value) {
max_resolution_ = value;
}
} // namespace webrtc
#endif // API_VIDEO_CODECS_VIDEO_DECODER_H_
|
