Elements#

Links under GStreamer element name (first column of the table) contain description of element properties, in the format generated by gst-inspect-1.0 utility

Inference plugins#

Auxiliary plugins#

Element

Description

gvaattachroi

Adds user-defined regions of interest to perform inference on, instead of full frame. Example: monitoring traffic on a road in a city camera feed, or when split large image to smaller pieces and inference each piece (healthcare cell analytics).

[eg syntax] gst-launch-1.0 … ! decodebin3 ! gvaattachroi roi=xtl,ytl,xbr,ybr gvadetect inference-region=1 ! … OUT

gvafpscounter

Measures frames per second across multiple video streams in a single GStreamer process.

[eg syntax] gst-launch-1.0 … ! decodebin3 ! gvadetect … ! gvafpscounter ! … OUT

gvametaaggregate

Aggregates inference results from multiple pipeline branches.

gvametaconvert

Converts the metadata structure to JSON or raw text formats, can write output to a file.

gvametapublish

Publishes the JSON metadata to MQTT or Kafka message brokers or files.

[eg syntax] gst-launch-1.0 … ! decodebin3 ! gvadetect model=$mDetect device=GPU … ! gvametaconvert format=json … ! gvametapublish … ! … OUT

gvapython

Provides a callback to execute user-defined Python functions on every frame, used to augment DLStreamer with user-defined algorithms (e.g. metadata conversion, inference post-processing).

[eg syntax] gst-launch-1.0 … ! gvaclassify ! gvapython module={gvapython.callback_module.classAge_pp} ! … OUT

gvawatermark

Overlays the metadata on the video frame to visualize the inference results.

[eg syntax] gst-launch-1.0 … ! decodebin3 ! gvadetect … ! gvawatermark ! … OUT