Gst-nvdsosd

此插件绘制边界框、文本、箭头、线条、圆形和感兴趣区域 (RoI) 多边形。（多边形表示为一组线条。）当 CPU 进程模式时，该插件接受来自上游组件的带有附加元数据的 RGBA 缓冲区。当 GPU 进程模式时，它可以接受 RGBA/NV12 PL/NV12 BL 缓冲区。它绘制边界框，这些边界框可以根据给定边界框的配置（例如，宽度、颜色和不透明度）进行着色。它还在帧中的指定位置绘制文本和 RoI 多边形。文本和多边形参数可通过元数据配置。

输入和输出

• 输入

  • 用于 CPU 进程模式的 RGBA 缓冲区。用于 GPU 进程模式的 RGBA/NV12 PL/NV12 BL 缓冲区。

  • NvDsBatchMeta（包含由边界框、文本参数和线条参数组成的 NvDsFrameMeta）

  • NvDsLineMeta (RoI 多边形)

• 控制参数

  • gpu-id (仅限 dGPU)

  • display-clock

  • display-text

  • clock-font

  • clock-font-size

  • x-clock-offset

  • y-clock-offset

  • clock-color

  • process-mode

  • display-bbox

  • display-mask

  • blur-bbox

  • blur-on-gie-class-ids

• 输出

  • 已就地修改的 RGBA/NV12 PL/NV12 BL 缓冲区，以覆盖元数据中表示的边界框、文本和多边形

特性

下表总结了插件的特性。

Gst-nvsosd 特性

特性	描述	发布版本
支持模糊检测到的对象	可以根据配置的参数模糊对象。	DS 8.0
支持在 GPU 模式下绘制箭头、线条、圆形、文本	填写元数据，如下行所述，以绘制不同的形状。(Alpha)	DS 6.2
支持绘制箭头	可以通过在元数据中的 NvOSD_ArrowParams 中指定值来绘制箭头。	DS 5.0
支持绘制圆形	可以通过在元数据中的 NvOSD_CircleParams 中指定值来绘制圆形。	DS 5.0
支持混合边界框	可以通过在元数据中的 NvOSD_RectParams 中指定 bg_color 值来绘制混合框。	DS 4.0
支持绘制多边形线	可以通过在元数据中的 NvOSD_LineParams 中指定值来绘制线条。	DS 3.0
支持使用 Pango 和 Cairo 库绘制文本	可以通过在元数据中的 NvOSD_TextParams 中指定值来绘制文本。	DS 2.0
CPU 模式和 GPU 支持绘制边界框。在 GPU 模式下不支持设置边界框边框的不透明度。	可以通过在元数据中的 NvOSD_RectParams 中指定值来绘制边界框。	DS 2.0

Gst 属性

下表描述了 Gst-nvdsosd 插件的 Gst 属性。

Gst-nvsosd gst 属性

属性	含义	类型和范围	示例注释
gpu-id	用于操作的 GPU 的设备 ID（仅限 dGPU）	整数，0 到 4,294,967,295	gpu-id=0
display-clock	指示是否显示系统时钟	布尔值	display-clock=0
display-text	指示是否显示文本	布尔值	display-text=0
clock-font	用于 CPU 进程模式的时钟的 Pango 字体名称，用于 GPU 进程模式的时钟和其他文本的 TrueType 字体名称	字符串	clock-font=Arial
clock-font-size	用于时钟的字体大小	整数，0-60	clock-font-size=2
x-clock-offset	时钟的 X 偏移量	整数，0 到 4,294,967,295	x-clock-offset=100
y-clock-offset	时钟的 Y 偏移量	整数，0 到 4,294,967,295	y-clock-offset=50
clock-color	显示时要设置的时钟颜色，顺序为 0xRGBA	整数，0 到 4,294,967,295	clock-color=0xff0000ff (时钟为红色，alpha=1)
process-mode	指示用于绘制对象的模式 默认模式：CPU 模式 0：CPU 模式 1：GPU 模式	整数，0 到 2	process-mode=0
display-bbox	控制边界框绘制	布尔值	display-bbox=1
display-mask	控制实例掩码绘制	布尔值	display-mask=1
blur-bbox	控制对象模糊（仅限 GPU 模式）	布尔值	blur-bbox=1
blur-on-gie-class-ids	选择要模糊的对象（仅限 GPU 模式，且 blur-bbox 必须为 1）	分号和逗号分隔的值	blur-on-gie-class-ids=0,1;1,0;2,1 格式：<gie_id,class_id;gie_id,class_id…>