DeepStream9.0 nvdsosd 新特性：Mask Blur 与 OBB 旋转框绘制

山西茄子

308人浏览 · 2026-05-20 22:04:45

山西茄子 · 2026-05-20 22:04:45 发布

DeepStream 9.0 的 nvdsosd 增强了两个很实用的显示能力：

基于 mask 的局部模糊
OBB（Oriented Bounding Box）旋转框绘制

这两个功能分别解决两个问题：一个用于隐私保护，一个用于更准确地显示旋转目标检测结果。

1. blur-mask：从模糊矩形框到模糊实例区域

过去如果要做隐私保护，例如模糊人脸、车牌或某类目标，常见做法是模糊整个 bounding box。但 bbox 往往包含大量背景区域，效果不够精细。

DeepStream 9.0 在 nvdsosd 中扩展了 blur-bbox 属性：

  g_object_class_install_property (gobject_class, PROP_BLUR_BBOX,
      g_param_spec_uint ("blur-bbox", "Blur Bbox",
          "Blur mode, (0):Disable, (1)blur the entire bbox area of object,\n"
          "\t\t\t(2)Blur the mask area of object if there is a mask, swith to Blur_Bbox if no mask.",
          0, 2, 0,
          (GParamFlags) (G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS |
              GST_PARAM_MUTABLE_READY)));

含义是：

blur-bbox=0：不模糊

blur-bbox=1：模糊整个 bbox 区域

blur-bbox=2：如果对象有 mask，则只模糊 mask 区域；如果没有 mask，则退回到 bbox 模糊

这对实例分割模型特别有用。例如模型输出 person mask，nvdsosd 就可以只模糊人的真实轮廓区域，而不是模糊整块矩形背景。

源码中，插件会从 object_meta 里取出 bbox 和 mask：

    if (nvdsosd->blur_bbox) {
      if(nvdsosd->blur_gie_class_list != NULL) {
        for(GList *it = nvdsosd->blur_gie_class_list; it; it = it->next) {
          gint gie_id = g_array_index((GArray *)(it->data), gint, 0);
          gint class_id = g_array_index((GArray *)(it->data), gint, 1);
          GST_LOG_OBJECT (nvdsosd,"blur gie %d class %d \n", gie_id, class_id);
          if(object_meta->unique_component_id == gie_id && object_meta->class_id == class_id) {
            nvdsosd->blur_rect_params[blur_cnt] = object_meta->rect_params;
            nvdsosd->mask_params[blur_cnt] = object_meta->mask_params;

最终传给底层 OSD blur 函数：

  if (blur_cnt != 0 && nvdsosd->blur_bbox) {
    nvdsosd->frame_blur_params->num_rects = blur_cnt;
    nvdsosd->frame_blur_params->rect_params_list = nvdsosd->blur_rect_params;
    if(nvdsosd->blur_bbox == Blur_Mask)
      nvdsosd->frame_blur_params->mask_params_list = nvdsosd->mask_params;

底层 nvll_osd 中，blur 只支持 GPU mode：

int nvll_osd_blur_rectangles(NvOSDCtxHandle nvosd_ctx, NvOSD_FrameRectParams *frame_rect_params)
{
    int ret = 0;
    if(frame_rect_params->mode == MODE_GPU)
    {
        ret = nvll_osd_blur_rectangles_gpu(nvosd_ctx, frame_rect_params);
    } else {
        NVOSD_PRINT_E("Blur is only supported on GPU mode, please set the process-mode=1!");

所以使用这个功能时要注意：

nvdsosd process-mode 必须是 GPU mode，也就是 process-mode=1

典型使用场景：

实例分割模型 → object mask → nvdsosd blur-bbox=2 → 只模糊目标轮廓区域

这对于隐私保护很有价值，例如只模糊人脸、人体、车牌、敏感物体区域。

如下图，跟左边的图比起来，右边的mask被模糊了。

2. OBB：支持带角度的旋转矩形框

第二个新功能是 OBB，也就是 Oriented Bounding Box。

传统 bbox 是水平矩形：

left, top, width, height

但很多目标并不是水平放置的，例如：

倾斜车辆
船只
航拍图像中的建筑
旋转文本
YOLO OBB 模型输出的旋转目标

如果仍然用水平 bbox，会包含大量背景，显示不准确。OBB 则多了一个角度信息：

left, top, width, height, rotation_angle

yolov11-obb 就属于这种模型：模型不仅输出框的位置和尺寸，还输出旋转角度。

在 nvll_osd 的 CPU 绘制路径中，如果 rotation_angle 非零，会以矩形中心为旋转中心绘制：

    if (fabsf(rect_params->rotation_angle) > 0.001f)
    {
        width = rect_params->width;
        height = rect_params->height;
        // Calculate center point for rotation
        double center_x = x + width / 2.0;
        double center_y = y + height / 2.0;

        // Save current transformation matrix
        cairo_save(cr);

        // Move to center and rotate
        cairo_translate(cr, center_x, center_y);
        cairo_rotate(cr, rect_params->rotation_angle * G_PI / 180.0);

在 GPU 绘制路径中，nvdsosd 会走 cuosd_draw_rotationbox：

        if (fabsf(rotation_angle) > 0.001f)
        {
            // OBB path - use cuosd_draw_rotationbox
            float center_x = (x1 + x2) / 2.0f;
            float center_y = (y1 + y2) / 2.0f;
            int width = x2 - x1;
            int height = y2 - y1;
            float yaw_rad = rotation_angle * M_PI / 180.0f;

            cuosd_draw_rotationbox(ctx->cuosd_context,

cuosd_draw_rotationbox 会根据中心点、宽高和旋转角计算四个角点：

void cuosd_draw_rotationbox(
    cuOSDContext_t _context, int cx, int cy, int width, int height, float yaw, int thickness, cuOSDColor border_color, bool interpolation, cuOSDColor bg_color
) {
    cuOSDContextImpl* context = (cuOSDContextImpl*)_context;
    if (border_color.a == 0) return;

    // a   d
    //   o
    // b   c

    float pax = -width / 2.0f;

这意味着应用不再需要把 OBB 近似成水平框，只要 metadata 中的 rect_params.rotation_angle 被正确设置，nvdsosd 就能画出旋转框。