Skip to navigation
DeepStream Plugin GuidePlugins

Gst-nvblender

View as Markdown

The Gst-nvblender plugin is a GPU accelerated video compositor. It accepts multiple input streams on its request sink pads and blends them into a single output stream, with per-pad control over position, size, alpha and crossfade ratio. Sink pads are composited in the order they are linked, so a pad linked later is drawn on top of (obscures) pads linked earlier.

Inputs and Outputs

  • Inputs

    • Multiple GStreamer buffers containing NV12/RGBA frame(s), one per request sink pad

  • Control parameters

    • gpu-id, selects the GPU ID used for compositing
    • Per-pad xpos, ypos, width, height, alpha, crossfade-ratio

  • Output

    • Single GStreamer buffer containing the composited NV12/RGBA frame

Features

The following table summarizes the features of the plugin.

Gst-nvblender plugin features

FeatureDescriptionRelease
GPU-accelerated multi-stream blendingComposites multiple input streams into a single output stream on the GPUDS 9.2
Per-pad position and size controlSets X/Y position and width/height independently for each input padDS 9.2
Per-pad alpha and crossfade controlSets per-pad alpha blending and crossfade ratioDS 9.2

Gst Properties

The following table describes the Gst properties of the Gst-nvblender plugin.

Gst-nvblender plugin gst properties

PropertyMeaningType and RangeExample Notes
gpu-idDevice ID of the GPU used for compositing (dGPU only)Integer,
0 to 256		gpu-id=0
backgroundBackground type used to fill areas not covered by any input padEnumbackground=1
batched-backgroundWhether the background is batchedBooleanbatched-background=1
xpos (per-pad)X position of the pad’s picture in the composited outputIntegerxpos=0
ypos (per-pad)Y position of the pad’s picture in the composited outputIntegerypos=0
width (per-pad)Width of the pad’s picture in the composited outputIntegerwidth=1280
height (per-pad)Height of the pad’s picture in the composited outputIntegerheight=720
alpha (per-pad)Alpha blending value of the pad’s pictureDouble,
0.0 to 1.0		alpha=1.0
crossfade-ratio (per-pad)Crossfade ratio to use while crossfading with the following pad; a value below 0 means no crossfadingDouble,
-1.0 to 1.0		crossfade-ratio=-1.0