| OLD | NEW |
| 1 /* | 1 /* |
| 2 * Copyright (c) 2014 The WebRTC project authors. All Rights Reserved. | 2 * Copyright (c) 2016 The WebRTC project authors. All Rights Reserved. |
| 3 * | 3 * |
| 4 * Use of this source code is governed by a BSD-style license | 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 | 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 | 6 * tree. An additional intellectual property rights grant can be found |
| 7 * in the file PATENTS. All contributing project authors may | 7 * in the file PATENTS. All contributing project authors may |
| 8 * be found in the AUTHORS file in the root of the source tree. | 8 * be found in the AUTHORS file in the root of the source tree. |
| 9 */ | 9 */ |
| 10 | 10 |
| 11 #ifndef WEBRTC_VIDEO_DECODER_H_ | 11 #ifndef WEBRTC_MEDIA_ENGINE_VIDEODECODERSOFTWAREFALLBACKWRAPPER_H_ |
| 12 #define WEBRTC_VIDEO_DECODER_H_ | 12 #define WEBRTC_MEDIA_ENGINE_VIDEODECODERSOFTWAREFALLBACKWRAPPER_H_ |
| 13 | 13 |
| 14 #include <memory> | 14 #include <memory> |
| 15 #include <string> | 15 #include <string> |
| 16 #include <vector> | |
| 17 | 16 |
| 18 #include "webrtc/common_types.h" | 17 #include "webrtc/video_decoder.h" |
| 19 #include "webrtc/typedefs.h" | |
| 20 #include "webrtc/video_frame.h" | |
| 21 | 18 |
| 22 namespace webrtc { | 19 namespace webrtc { |
| 23 | 20 |
| 24 class RTPFragmentationHeader; | |
| 25 // TODO(pbos): Expose these through a public (root) header or change these APIs. | |
| 26 struct CodecSpecificInfo; | |
| 27 class VideoCodec; | |
| 28 | |
| 29 class DecodedImageCallback { | |
| 30 public: | |
| 31 virtual ~DecodedImageCallback() {} | |
| 32 | |
| 33 virtual int32_t Decoded(VideoFrame& decodedImage) = 0; | |
| 34 // Provides an alternative interface that allows the decoder to specify the | |
| 35 // decode time excluding waiting time for any previous pending frame to | |
| 36 // return. This is necessary for breaking positive feedback in the delay | |
| 37 // estimation when the decoder has a single output buffer. | |
| 38 // TODO(perkj): Remove default implementation when chromium has been updated. | |
| 39 virtual int32_t Decoded(VideoFrame& decodedImage, int64_t decode_time_ms) { | |
| 40 // The default implementation ignores custom decode time value. | |
| 41 return Decoded(decodedImage); | |
| 42 } | |
| 43 | |
| 44 virtual int32_t ReceivedDecodedReferenceFrame(const uint64_t pictureId) { | |
| 45 return -1; | |
| 46 } | |
| 47 | |
| 48 virtual int32_t ReceivedDecodedFrame(const uint64_t pictureId) { return -1; } | |
| 49 }; | |
| 50 | |
| 51 class VideoDecoder { | |
| 52 public: | |
| 53 enum DecoderType { | |
| 54 kH264, | |
| 55 kVp8, | |
| 56 kVp9, | |
| 57 kUnsupportedCodec, | |
| 58 }; | |
| 59 | |
| 60 static VideoDecoder* Create(DecoderType codec_type); | |
| 61 | |
| 62 virtual ~VideoDecoder() {} | |
| 63 | |
| 64 virtual int32_t InitDecode(const VideoCodec* codec_settings, | |
| 65 int32_t number_of_cores) = 0; | |
| 66 | |
| 67 virtual int32_t Decode(const EncodedImage& input_image, | |
| 68 bool missing_frames, | |
| 69 const RTPFragmentationHeader* fragmentation, | |
| 70 const CodecSpecificInfo* codec_specific_info = NULL, | |
| 71 int64_t render_time_ms = -1) = 0; | |
| 72 | |
| 73 virtual int32_t RegisterDecodeCompleteCallback( | |
| 74 DecodedImageCallback* callback) = 0; | |
| 75 | |
| 76 virtual int32_t Release() = 0; | |
| 77 | |
| 78 // Returns true if the decoder prefer to decode frames late. | |
| 79 // That is, it can not decode infinite number of frames before the decoded | |
| 80 // frame is consumed. | |
| 81 virtual bool PrefersLateDecoding() const { return true; } | |
| 82 | |
| 83 virtual const char* ImplementationName() const { return "unknown"; } | |
| 84 }; | |
| 85 | |
| 86 // Class used to wrap external VideoDecoders to provide a fallback option on | 21 // Class used to wrap external VideoDecoders to provide a fallback option on |
| 87 // software decoding when a hardware decoder fails to decode a stream due to | 22 // software decoding when a hardware decoder fails to decode a stream due to |
| 88 // hardware restrictions, such as max resolution. | 23 // hardware restrictions, such as max resolution. |
| 89 class VideoDecoderSoftwareFallbackWrapper : public webrtc::VideoDecoder { | 24 class VideoDecoderSoftwareFallbackWrapper : public webrtc::VideoDecoder { |
| 90 public: | 25 public: |
| 91 VideoDecoderSoftwareFallbackWrapper(VideoCodecType codec_type, | 26 VideoDecoderSoftwareFallbackWrapper(VideoCodecType codec_type, |
| 92 VideoDecoder* decoder); | 27 VideoDecoder* decoder); |
| 93 | 28 |
| 94 int32_t InitDecode(const VideoCodec* codec_settings, | 29 int32_t InitDecode(const VideoCodec* codec_settings, |
| 95 int32_t number_of_cores) override; | 30 int32_t number_of_cores) override; |
| (...skipping 18 matching lines...) Expand all Loading... |
| 114 const DecoderType decoder_type_; | 49 const DecoderType decoder_type_; |
| 115 VideoDecoder* const decoder_; | 50 VideoDecoder* const decoder_; |
| 116 | 51 |
| 117 VideoCodec codec_settings_; | 52 VideoCodec codec_settings_; |
| 118 int32_t number_of_cores_; | 53 int32_t number_of_cores_; |
| 119 std::string fallback_implementation_name_; | 54 std::string fallback_implementation_name_; |
| 120 std::unique_ptr<VideoDecoder> fallback_decoder_; | 55 std::unique_ptr<VideoDecoder> fallback_decoder_; |
| 121 DecodedImageCallback* callback_; | 56 DecodedImageCallback* callback_; |
| 122 }; | 57 }; |
| 123 | 58 |
| 124 // Video decoder class to be used for unknown codecs. Doesn't support decoding | |
| 125 // but logs messages to LS_ERROR. | |
| 126 class NullVideoDecoder : public VideoDecoder { | |
| 127 public: | |
| 128 NullVideoDecoder(); | |
| 129 | |
| 130 int32_t InitDecode(const VideoCodec* codec_settings, | |
| 131 int32_t number_of_cores) override; | |
| 132 | |
| 133 int32_t Decode(const EncodedImage& input_image, | |
| 134 bool missing_frames, | |
| 135 const RTPFragmentationHeader* fragmentation, | |
| 136 const CodecSpecificInfo* codec_specific_info, | |
| 137 int64_t render_time_ms) override; | |
| 138 | |
| 139 int32_t RegisterDecodeCompleteCallback( | |
| 140 DecodedImageCallback* callback) override; | |
| 141 | |
| 142 int32_t Release() override; | |
| 143 | |
| 144 const char* ImplementationName() const override; | |
| 145 }; | |
| 146 | |
| 147 } // namespace webrtc | 59 } // namespace webrtc |
| 148 | 60 |
| 149 #endif // WEBRTC_VIDEO_DECODER_H_ | 61 #endif // WEBRTC_MEDIA_ENGINE_VIDEODECODERSOFTWAREFALLBACKWRAPPER_H_ |
| OLD | NEW |