NVidia® Products with the Kepler, Maxwell and Pascal generation GPUs contain a dedicated accelerator for video encoding, called NVENC, on the GPU die.
NVENCODE API enables software developers to configure this dedicated hardware video encoder. This dedicated accelerator encodes video at higher speeds and power efficiency than CUDA-based or CPU-based encoders at equivalent quality. NVENCODE API allows the programmer to control various settings of the encoder to set the desired tradeoff between quality and performance.
If you haven't yet installed Nimble Streamer transcoder,
use this page to find proper setup instruction.
The transcoding scenarios are created using our excellent web UI. You can
check this YouTube playlist to see how various use cases are defined. Takes just couple of minutes to complete.
|
Scenarios setup page |
|
Part of ABR scenario setup example |
To set up NVENC settings you need to open encoder settings dialog and choose "nvenc" as the Encoder.
After that you can add various parameters and set up specific values to tune up your encoding process. Please find full list of available encoding parameters below.
preset
Specifies H.264 preset.
- hp - high performance
- default - tradeoff between performance and quality
- hq - high quality
- llhp - low latency high performance
- ll - default low latency preset and the quality and speed is midway of the two other presets
- llhq - low latency high quality
- lossless - default lossless preset
- losslesshp - lossless high performance
- bd - blueray disk? NV_ENC_PRESET_BD_GUID
profile
Specifies H.264 profile.
- baseline
- main
- high
- high444
level
Specifies H.264 profile level.
- 1
- 1.0
- 1b
- 1.1
- 1.2
- 1.3
- 2
- 2.1
- 2.2
- 3
- 3.1
- 3.2
- 4
- 4.0
- 4.1
- 4.2
- 5
- 5.1
gpu
Selects which NVENC capable GPU to use. First GPU is 0, second is 1, and so on.
If you set it to
"auto" then transcoder will choose the least busy GPU.
keyint
Number of pictures within the current GOP (Group of Pictures).
- 0 - NVENC_INFINITE_GOPLENGTH
- 1 - only I-frames are used
bframes
Specifies maximum number of B frames between non-B-frames.
- 0 - no B-frames
- 1 - IBP
- 2 - IBBP
refs
Specifies the DPB size used for encoding.
Setting it to 0 will let driver use the default dpb size. The low latency application which wants to invalidate reference frame as an error resilience tool is recommended to use a large DPB size so that the encoder can keep old reference frames which can be used if recent frames are invalidated.
fps_n, fps_d
Set output FPS numerator and denominator. It only affects num_units_in_tick and time_scale fields in SPS.
If fps_n=30 and fps_d=1 then it's 30 FPS
If fps_n=60000 and fps_d=2002 then it's 29.97 FPS
Source stream FPS or filter FPS is used if fps_n and fps_d are not set.
Please also check
Handling fuzzy FPS to get proper bitrate output article.
rate_control
Sets bitrate type.
- cqp - Constant QP mode
- vbr - Variable bitrate mode
- cbr - Constant bitrate mode
- vbr_minqp - ariable bitrate mode with MinQP
- ll_2pass_quality - Multi pass encoding optimized for image quality and works only with low latency mode
- ll_2pass_size - Multi pass encoding optimized for maintaining frame size and works only with low latency mode
- vbr_2pass - Multi pass VBR
bitrate
Sets bitrate in Kbps.
max_bitrate
Sets max bitrate in Kbps.
init_bufsize
Specifies the VBV(HRD) initial delay in Kbits.
- 0 - use the default VBV initial delay
bufsize
Specifies the VBV(HRD) buffer size in Kbits.
- 0 - use the default VBV buffer size
qpi, qpp, qpb
Specifies the initial QP to be used for encoding, these values would be used for all frames if in CQP mode.
qmin
Specifies the minimum QP used for rate control
qmax
Specifies the maximum QP used for rate control
initialRCQP
Specifies the initial QP used for rate control
quality
Target Constant Quality level for VBR mode (range 0-51 with 0-automatic);
lossless
Enable lossless encode as following: sets QP to 0 and RC_mode to NV_ENC_PARAMS_RC_CONSTQP and profile to HIGH_444_PREDICTIVE_PROFILE.
keep_sar
If your input stream is anamorphic you might need to save its SAR parameter in the output as well, especially if you’re using a 'scale' filter in your Transcoder pipeline while DAR = SAR x Width / Height. Nimble supports keeping input SAR using keep-sar parameter set to true for encoder in its ‘Video output’ section. SAR/DAR/PAR correlation is described
in this article.
monoChromeEncoding
frameFieldMode
Specifies the frame/field mode.
- frame - NV_ENC_PARAMS_FRAME_FIELD_MODE_FRAME
- filed - NV_ENC_PARAMS_FRAME_FIELD_MODE_FIELD
- mbaff - NV_ENC_PARAMS_FRAME_FIELD_MODE_MBAFF
mvPrecision
Specifies the desired motion vector prediction precision.
- default - NV_ENC_MV_PRECISION_DEFAULT
- full_pell - NV_ENC_MV_PRECISION_FULL_PEL
- half_pell - NV_ENC_MV_PRECISION_HALF_PEL
- quarter_pel - NV_ENC_MV_PRECISION_QUARTER_PEL
enableAQ
Enable Spatial adaptive quantization
aqStrength
Specifies AQ strength.
AQ strength scale is from 1 (low) - 15 (aggressive).
enableTemporalAQ
Specifies Temporal adaptive quantization
strictGOPTarget
Set to enable to minimize GOP-to-GOP rate fluctuations
enableLookahead
Enable lookahead with depth <lookaheadDepth>;
lookaheadDepth
Maximum depth of lookahead with range 0-32 (only used if enableLookahead=1)
disableIadapt
Disable adaptive I-frame insertion at scene cuts (only has an effect when lookahead is enabled).
- 0 - none
- 1 - disable adaptive I-frame insertion
disableBadapt
Disable adaptive B-frame decision (only has an effect when lookahead is enabled)
- 0 - none
- 1 - Disable adaptive B-frame decision
enableIntraRefresh
Enable intra refresh. If the GOP structure uses B frames this will be ignored
intraRefreshPeriod
Interval between successive intra refresh.
intraRefreshCnt
Length of intra refresh in number of frames for periodic intra refresh. This value should be smaller than intraRefreshPeriod.
enableConstrainedEncoding
Set this to 1 to enable constrainedFrame encoding where each slice in the constarined picture is independent of other slices
useConstrainedIntraPred
Set 1 to enable constrained intra prediction.
separateColourPlaneFlag
Set to 1 to enable 4:4:4 separate colour planes
deblockingFilterMode
Specifies the deblocking filter mode. Permissible value range : [0, 2]
adaptiveTransform
Specifies the AdaptiveTransform Mode
- auto - Adaptive Transform 8x8 mode is auto selected by the encoder driver
- disable - Adaptive Transform 8x8 mode disabled
- enable - ptive Transform 8x8 mode should be used
fmo
Specified the FMO Mode
- auto - FMO usage is auto selected by the encoder driver
- enable - Enable FMO
- disable -Disble FMO
bdirect
Specifies the BDirect mode
- auto - BDirect mode is auto selected by the encoder driver
- disable - Disable BDirect mode
- temporal - Temporal BDirect mode
- spatial - Spatial BDirect mode
entropyCoding
Specifies the entropy coding mode
- auto - Entropy coding mode is auto selected by the encoder driver
- cabac - Entropy coding mode is CABAC
- cavlc - Entropy coding mode is CAVLC
sliceMode
Specifies the way in which the picture is divided into slices.
- 0 - MB based slices,
- 1 - Byte based slices,
- 2 - MB row based slices,
- 3 - numSlices in Picture
When sliceMode == 0 and sliceModeData == 0 whole picture will be coded with one slice
sliceModeData
Specifies the sliceMode parameter.
- sliceMode=0, sliceModeData specifies # of MBs in each slice(except last slice)
- sliceMode=1, sliceModeData specifies maximum # of bytes in each slice(except last slice)
- sliceMode=2, sliceModeData specifies # of MB rows in each slice(except last slice)
- sliceMode=3, sliceModeData specifies number of slices in the picture. Driver will divide picture into slices optimally;
These are the parameters which you can use already in order to control NVidia video encoding hardware acceleration. Live Transcoder also
supports NVidia hardware decoding.
To improve your NVENC transcoding experience, please also take a look at
Transcoder troubleshooting covering most frequent questions.
Zabbix monitoring of Nimble Streamer allows tracking server status, SRT streams and NVidia GPU status.
We keep improving our transcoder feature set,
contact us for any questions.
Related documentation
NVIDIA, the NVIDIA logo and CUDA are trademarks and/or registered trademarks of NVIDIA Corporation in the U.S. and/or other countries.