Sunshine master
Self-hosted game stream host for Moonlight.
nvenc_base.h
Go to the documentation of this file.
1
5#pragma once
6
7// lib includes
8#include <ffnvcodec/nvEncodeAPI.h>
9
10// local includes
11#include "nvenc_colorspace.h"
12#include "nvenc_config.h"
13#include "nvenc_encoded_frame.h"
14#include "src/logging.h"
15#include "src/video.h"
16
20namespace nvenc {
21
26 class nvenc_base {
27 public:
31 explicit nvenc_base(NV_ENC_DEVICE_TYPE device_type);
32 virtual ~nvenc_base();
33
34 nvenc_base(const nvenc_base &) = delete;
35 nvenc_base &operator=(const nvenc_base &) = delete;
36
45 bool create_encoder(const nvenc_config &config, const video::config_t &client_config, const nvenc_colorspace_t &colorspace, NV_ENC_BUFFER_FORMAT buffer_format);
46
51 void destroy_encoder();
52
61 nvenc_encoded_frame encode_frame(uint64_t frame_index, bool force_idr);
62
70 bool invalidate_ref_frames(uint64_t first_frame, uint64_t last_frame);
71
72 protected:
78 virtual bool init_library() = 0;
79
87
93 virtual bool synchronize_input_buffer() {
94 return true;
95 }
96
103 virtual bool wait_for_async_event(uint32_t timeout_ms) {
104 return false;
105 }
106
107 bool nvenc_failed(NVENCSTATUS status);
108
109 const NV_ENC_DEVICE_TYPE device_type;
110
111 void *encoder = nullptr;
112
113 struct {
114 uint32_t width = 0;
115 uint32_t height = 0;
116 NV_ENC_BUFFER_FORMAT buffer_format = NV_ENC_BUFFER_FORMAT_UNDEFINED;
117 uint32_t ref_frames_in_dpb = 0;
118 bool rfi = false;
119 } encoder_params;
120
121 std::string last_nvenc_error_string;
122
123 // Derived classes set these variables
124 void *device = nullptr;
126 std::shared_ptr<NV_ENCODE_API_FUNCTION_LIST> nvenc;
128 NV_ENC_REGISTERED_PTR registered_input_buffer = nullptr;
130 void *async_event_handle = nullptr;
132
133 private:
134 NV_ENC_OUTPUT_PTR output_bitstream = nullptr;
135
136 struct {
137 uint64_t last_encoded_frame_index = 0;
138 bool rfi_needs_confirmation = false;
139 std::pair<uint64_t, uint64_t> last_rfi_range;
140 logging::min_max_avg_periodic_logger<double> frame_size_logger = {debug, "NvEnc: encoded frame sizes in kB", ""};
141 } encoder_state;
142 };
143
144} // namespace nvenc
A helper class for tracking and logging numerical values across a period of time.
Definition logging.h:102
Abstract platform-agnostic base of standalone NVENC encoder. Derived classes perform platform-specifi...
Definition nvenc_base.h:26
bool invalidate_ref_frames(uint64_t first_frame, uint64_t last_frame)
Perform reference frame invalidation (RFI) procedure.
Definition nvenc_base.cpp:622
nvenc_encoded_frame encode_frame(uint64_t frame_index, bool force_idr)
Encode the next frame using platform-specific input surface.
Definition nvenc_base.cpp:538
NV_ENC_REGISTERED_PTR registered_input_buffer
Definition nvenc_base.h:128
bool create_encoder(const nvenc_config &config, const video::config_t &client_config, const nvenc_colorspace_t &colorspace, NV_ENC_BUFFER_FORMAT buffer_format)
Create the encoder.
Definition nvenc_base.cpp:100
virtual bool create_and_register_input_buffer()=0
Required. Used for creating outside-facing input surface, registering this surface with nvenc->nvEncR...
std::shared_ptr< NV_ENCODE_API_FUNCTION_LIST > nvenc
Definition nvenc_base.h:126
virtual bool wait_for_async_event(uint32_t timeout_ms)
Optional. Override if you want to create encoder in async mode. In this case must also set async_even...
Definition nvenc_base.h:103
void * async_event_handle
Definition nvenc_base.h:130
void destroy_encoder()
Destroy the encoder. Derived classes classes call it in the destructor.
Definition nvenc_base.cpp:507
void * device
Definition nvenc_base.h:124
virtual bool init_library()=0
Required. Used for loading NvEnc library and setting nvenc variable with NvEncodeAPICreateInstance()....
nvenc_base(NV_ENC_DEVICE_TYPE device_type)
Definition nvenc_base.cpp:92
virtual bool synchronize_input_buffer()
Optional. Override if you must perform additional operations on the registered input surface in the b...
Definition nvenc_base.h:93
Declarations for logging related functions.
Standalone NVENC encoder.
Definition nvenc_base.cpp:90
Declarations for NVENC YUV colorspace.
Declarations for NVENC encoder configuration.
Declarations for NVENC encoded frame.
YUV colorspace and color range.
Definition nvenc_colorspace.h:15
NVENC encoder configuration.
Definition nvenc_config.h:24
Encoded frame.
Definition nvenc_encoded_frame.h:16
Definition video.h:23
Declarations for video.