海思Hi3559AV100 VGS画线实战：从API调用到矩形框绘制的完整代码解析

海思Hi3559AV100 VGS画线实战：从API调用到矩形框绘制的完整代码解析

在视频分析领域，目标检测后的可视化呈现是算法验证的重要环节。海思Hi3559AV100芯片的VGS（Video Graphics Subsystem）模块提供了高效的图形绘制能力，尤其适合在视频流上实时叠加分析结果。本文将深入解析如何利用VGS模块实现精确的矩形框绘制，涵盖从API调用到多路视频处理的完整技术细节。

1. VGS模块基础环境配置

在开始绘制前，需要确保开发环境已正确配置。Hi3559AV100的SDK提供了完整的VGS开发支持，但需要注意几个关键配置项：

# 内核配置需开启VGS驱动支持 CONFIG_HI_VGS=y CONFIG_HI_VGS_MEM_SIZE=32M # 根据实际需求调整内存大小

硬件连接上，建议使用Hi3559AV100的VPSS（Video Process Sub-System）与VGS协同工作。典型的视频处理流水线配置如下：

Camera → VI → VPSS → VGS → VO/编码

开发环境验证可通过以下基础代码测试VGS功能是否正常：

HI_S32 s32Ret = HI_SUCCESS; s32Ret = HI_MPI_VGS_Init(); if (s32Ret != HI_SUCCESS) { printf("VGS init failed: 0x%x\n", s32Ret); return -1; }

2. VGS核心API深度解析

2.1 任务创建与管理

HI_MPI_VGS_BeginJob是VGS绘制的起点，其函数原型如下：

HI_S32 HI_MPI_VGS_BeginJob(VGS_HANDLE *phHandle);

关键参数说明：

• phHandle: 输出参数，返回任务句柄，后续所有操作都基于此句柄

典型错误处理模式应包含重试机制：

VGS_HANDLE hHandle; int retry = 0; while (retry++ < 3) { s32Ret = HI_MPI_VGS_BeginJob(&hHandle); if (s32Ret == HI_SUCCESS) break; usleep(100000); // 100ms延迟后重试 }

2.2 画线任务参数配置

HI_MPI_VGS_AddDrawLineTaskArray是矩形框绘制的核心API，其参数结构体需要特别注意：

typedef struct { HI_U32 u32LineWidth; HI_U32 u32Color; HI_U32 u32LineNum; VGS_LINE_S *pastLine; } VGS_DRAW_LINE_S;

参数优化建议：

• 对于4K视频，u32LineWidth建议设置为3-5像素
• 颜色值采用ARGB格式，0xFF0000表示纯红色
• 预分配pastLine内存时考虑最大检测目标数

3. 矩形框绘制实战代码

完整的矩形框绘制函数实现如下，包含详细的错误处理和资源管理：

HI_S32 PLATFORM_VGS_RectLine(VGS_HANDLE hHandle, HI_U32 u32X, HI_U32 u32Y, HI_U32 u32Width, HI_U32 u32Height, HI_U32 u32Color, HI_U32 u32LineWidth) { VGS_LINE_S astLines[4] = {0}; VGS_DRAW_LINE_S stDrawLine = {0}; // 定义矩形四条边 astLines[0].u32StartX = u32X; // 上边 astLines[0].u32StartY = u32Y; astLines[0].u32EndX = u32X + u32Width; astLines[0].u32EndY = u32Y; astLines[1].u32StartX = u32X + u32Width; // 右边 astLines[1].u32StartY = u32Y; astLines[1].u32EndX = u32X + u32Width; astLines[1].u32EndY = u32Y + u32Height; astLines[2].u32StartX = u32X; // 下边 astLines[2].u32StartY = u32Y + u32Height; astLines[2].u32EndX = u32X + u32Width; astLines[2].u32EndY = u32Y + u32Height; astLines[3].u32StartX = u32X; // 左边 astLines[3].u32StartY = u32Y; astLines[3].u32EndX = u32X; astLines[3].u32EndY = u32Y + u32Height; stDrawLine.u32LineNum = 4; stDrawLine.pastLine = astLines; stDrawLine.u32Color = u32Color; stDrawLine.u32LineWidth = u32LineWidth; return HI_MPI_VGS_AddDrawLineTaskArray(hHandle, &stDrawLine); }

4. 多路视频处理实战技巧

当处理多路视频（如可见光+红外）时，需要特别注意以下要点：

1. 资源分配策略

   • 为每路视频创建独立的VGS任务
   • 根据视频分辨率动态调整线宽
   • 建立颜色编码规范（如红色表示红外检测结果）

2. 性能优化表格

3. 同步处理示例代码

// 可见光通道处理 HI_MPI_VGS_BeginJob(&hHandleVisible); PLATFORM_VGS_RectLine(hHandleVisible, x1, y1, w1, h1, 0xFF0000, 3); HI_MPI_VGS_EndJob(hHandleVisible); // 红外通道处理（延迟1帧避免资源冲突） usleep(16666); // 60fps对应的帧间隔 HI_MPI_VGS_BeginJob(&hHandleIR); PLATFORM_VGS_RectLine(hHandleIR, x2, y2, w2, h2, 0x00FF00, 3); HI_MPI_VGS_EndJob(hHandleIR);

5. 高级调试技巧与性能分析

在实际项目中，我们经常会遇到绘制异常的情况。以下是一些实用的调试方法：

• 内存越界检查：使用HI_MPI_VGS_GetJobStatus获取任务状态

• 性能分析工具：

  # 查看VGS模块CPU占用 top -H -p `pidof sample_vgs` # 监控内存使用 cat /proc/vgs-mem

• 常见错误代码速查表

在长时间运行的系统中，建议添加以下健壮性处理：

// 定期重置VGS模块 if (frameCount % 1000 == 0) { HI_MPI_VGS_Exit(); HI_MPI_VGS_Init(); }