Gst-nvvideoconvert

This plugin performs video color format conversion. It accepts NVMM memory as well as RAW (memory allocated using calloc() or malloc() ), and provides NVMM or RAW memory at the output.
A screenshot of a cell phone Description automatically generated

Inputs and Outputs

Inputs
Gst Buffer batched buffer
NvDsBatchMeta
Format: NV12, I420, P010_10LE, BGRx, RGBA (NVMM/RAW)
Control parameters
gpu-id (dGPU only)
nvbuf-memory-type
src-crop
dst-crop
interpolation-method
compute-hw
Output
Gst Buffer
NvDsBatchMeta
Format: NV12, I420, P010_10LE, BGRx, RGBA (NVMM/RAW)

Features

This plugin supports scaling and conversion for NVMM to NVMM, RAW to NVMM, and NVMM to RAW and RAW to RAW buffer type conversion. The plugin supports cropping of the input and output frames.

Gst Properties

The following table describes the Gst properties of the Gst-nvvideoconvert plugin.
Gst-nvvideoconvert plugin, Gst Properties
Property
Meaning
Type and Range
Example
Notes
nvbuf-memory-type
Type of memory to be allocated.
For dGPU:
0 (nvbuf-mem-default): Default memory, cuda-device
1 (nvbuf-mem-cuda-pinned): Pinned/Host CUDA memory
2 (nvbuf-mem-cuda-device) Device CUDA memory
3 (nvbuf-mem-cuda-unified): Unified CUDA memory
For Jetson:
0 (nvbuf-mem-default): Default memory, surface array
4 (nvbuf-mem-surface-array): Surface array memory
enum GstNvVidConvBufMemoryType
 
src-crop
Pixel location: left:top:width:height
String
20; 40; 150; 100
dst-crop
Pixel location: left:top:width:height
String
20; 40; 150; 100
interpolation-method
Interpolation method.
0: Nearest
1: Bilinear
2: Algo-1 (GPU—Cubic, VIC—5 Tap)
3: Algo-2 (GPU—Super, VIC—10 Tap)
4: Algo-3 (GPU—LanzoS, VIC—Smart)
5: Algo-4 (GPU—Ignored, VIC—Nicest)
6: Default (GPU—Nearest, VIC—Nearest)
enum GstInterpolationMethod
interpolation-method=1
Default value is 6.
compute-hw
Type of computing hardware
0: Default (GPU for gDPU, VIC for Jetson)
1: GPU
2: VIC
enum GstComputeHW
compute-hw=0
Default value is 0.
gpu-id
Device ID of GPU to use for format conversion
Integer,
0 to 4,294,967,295
gpu-id=0
output-buffers
Number of Output Buffers for the buffer pool
Unsigned integer,
1 to 4,294,967,295
output-buffers=4