qtioverlay

The QTI's qtioverlay GStreamer element has the capability of drawing and blitting RGB or YUV contents to YUV frames. it is in-place GStreamer element and supports only one source and sink pad. It supports bliting - static image, bounding boxes, custom user text and date/time overlays ontop of YUV frames, these YUV frames can be from Camera or from Video decode element. this element can be configured by machine learning metadata (MLMeta) and/or GST properties. The supported MLMeta types are detection, segmentation, classification, and posenet. One metadata entry corresponds to one overlay item. Multiple items of the same or/and different types are supported simultaneously. The detection type is drawn as a bounding box with a label. There is no limitation for the number of detection metadata entries/bounding boxes. However, increasing the number of bounding boxes can impact performance. The supported overlay image format is RGBA, the input overlay image does not need to match stream dimensions, it is upscaled to output stream dimensions automatically. The classification type is presented as a text overlay. The date/time and user text overlay can only be enabled by GST properties, the date/time is generated automatically by plugin using system APIs. and usertext should be provided by the user via GST property.

Pad templates

sink (input)

video/x-raw
format: { (string)NV12, (string)NV21 }
width: [ 1, 32767 ]
height: [ 1, 32767 ]
framerate: [ 0/1, 2147483647/1 ]
video/x-raw(ANY)
format: { (string)NV12, (string)NV21 }
width: [ 1, 32767 ]
height: [ 1, 32767 ]
framerate: [ 0/1, 2147483647/1 ]

Presencealways

Directionsink

source (output)

video/x-raw
format: { (string)NV12, (string)NV21 }
width: [ 1, 32767 ]
height: [ 1, 32767 ]
framerate: [ 0/1, 2147483647/1 ]
video/x-raw(ANY)
format: { (string)NV12, (string)NV21 }
width: [ 1, 32767 ]
height: [ 1, 32767 ]
framerate: [ 0/1, 2147483647/1 ]

Presencealways

Directionsrc

Properties

name

The name of the object.

type: String
access: read/write
default: "qtioverlay0"

qos

Handle Quality-of-Service events.

type: Boolean
access: read/write
default: false

overlay-text

User text overlay. If this property is set user text is enabled and user text value from property is displayed.

type: String
access: read/write
default: None

overlay-date

Bounding box overlay color. Color format is RGBA.

type: Boolean
access: read/write
default: false

bbox-color

Bounding box overlay color. Color format is RGBA.

type: Unsigned Integer
access: read/write
default: 0xCCFF

date-color

Date overlay color. Color format is RGBA.

type: Unsigned Integer
access: read/write
default: 0xFF0000FF

text-color

Text overlay color. Color format is RGBA

type: Unsigned Integer
access: read/write
default: 0xFFFF00FF

pose-color

Pose overlay color. Color format is RGBA.

type: Unsigned Integer
access: read/write
default: 0x33CC00FF