NVIDIA Tegra
NVIDIA DeepStream Plugin Manual

Application Note
4.0.1 Release

 
Gst-nvvideoconvert
 
Inputs and Outputs
Features
Gst Properties
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, 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, BGRx, RGBA (NVMM/RAW)
Features
This plugin supports batched scaling and conversion in single call for NVMM to NVMM, RAW to NVMM, and NVMM to RAW buffer types. It does not support RAW to RAW 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