1/* Copyright (c) 2011 The WebRTC project authors. All Rights Reserved. 2* 3* Use of this source code is governed by a BSD-style license 4* that can be found in the LICENSE file in the root of the source 5* tree. An additional intellectual property rights grant can be found 6* in the file PATENTS. All contributing project authors may 7* be found in the AUTHORS file in the root of the source tree. 8*/ 9/* 10* This file defines the interface for doing temporal layers with VP8. 11*/ 12#ifndef WEBRTC_MODULES_VIDEO_CODING_CODECS_VP8_TEMPORAL_LAYERS_H_ 13#define WEBRTC_MODULES_VIDEO_CODING_CODECS_VP8_TEMPORAL_LAYERS_H_ 14 15#include "vpx/vpx_encoder.h" 16 17#include "webrtc/common.h" 18#include "webrtc/common_video/include/video_image.h" 19#include "webrtc/typedefs.h" 20 21namespace webrtc { 22 23struct CodecSpecificInfoVP8; 24 25class TemporalLayers { 26 public: 27 // Factory for TemporalLayer strategy. Default behaviour is a fixed pattern 28 // of temporal layers. See default_temporal_layers.cc 29 struct Factory { 30 Factory() {} 31 virtual ~Factory() {} 32 virtual TemporalLayers* Create(int temporal_layers, 33 uint8_t initial_tl0_pic_idx) const; 34 static const ConfigOptionID identifier = 35 ConfigOptionID::kTemporalLayersFactory; 36 }; 37 38 virtual ~TemporalLayers() {} 39 40 // Returns the recommended VP8 encode flags needed. May refresh the decoder 41 // and/or update the reference buffers. 42 virtual int EncodeFlags(uint32_t timestamp) = 0; 43 44 virtual bool ConfigureBitrates(int bitrate_kbit, 45 int max_bitrate_kbit, 46 int framerate, 47 vpx_codec_enc_cfg_t* cfg) = 0; 48 49 virtual void PopulateCodecSpecific(bool base_layer_sync, 50 CodecSpecificInfoVP8* vp8_info, 51 uint32_t timestamp) = 0; 52 53 virtual void FrameEncoded(unsigned int size, uint32_t timestamp, int qp) = 0; 54 55 virtual int CurrentLayerId() const = 0; 56 57 virtual bool UpdateConfiguration(vpx_codec_enc_cfg_t* cfg) = 0; 58}; 59 60// Factory for a temporal layers strategy that adaptively changes the number of 61// layers based on input framerate so that the base layer has an acceptable 62// framerate. See realtime_temporal_layers.cc 63struct RealTimeTemporalLayersFactory : TemporalLayers::Factory { 64 virtual ~RealTimeTemporalLayersFactory() {} 65 virtual TemporalLayers* Create(int num_temporal_layers, 66 uint8_t initial_tl0_pic_idx) const; 67}; 68 69} // namespace webrtc 70#endif // WEBRTC_MODULES_VIDEO_CODING_CODECS_VP8_TEMPORAL_LAYERS_H_ 71