首页
/ LVGL项目中NEMA图形库更新导致的条形控件绘制异常分析

LVGL项目中NEMA图形库更新导致的条形控件绘制异常分析

2025-05-11 04:13:44作者:翟江哲Frasier

问题背景

在LVGL图形库的最新版本(v9.3)中,开发团队发现了一个与NEMA图形库相关的绘制异常问题。该问题出现在STM32U5开发板上,当使用NEMA图形加速并启用矢量图形(VG)功能时,条形控件(bar)的右端会出现异常的深蓝色三角形区域。

问题现象

从开发者提供的截图可以清晰地看到,一个蓝色条形控件的右端出现了不应该存在的深蓝色三角形区域。这种视觉异常破坏了控件的整体美观性和功能性。值得注意的是,这个问题是在NEMA图形库更新后突然出现的,而在之前的版本中(commit 539d729)绘制效果是完全正常的。

技术分析

经过开发团队的深入调查,发现问题可能出在NEMA图形库的nema_fill_rounded_rect_aa函数上。这个函数负责绘制带有圆角的矩形区域,并支持抗锯齿效果。

关键发现包括:

  1. 当绘制条形控件的背景时,系统只执行了两个绘制任务:一个是屏幕背景填充,另一个是条形背景填充
  2. 条形背景由于设置了非零半径,所以调用了nema_fill_rounded_rect_aa函数
  3. 传入的参数看起来是合理的:控件高度为384像素,圆角半径为192像素
  4. 问题不仅出现在最大半径设置的情况下,也出现在普通半径设置中

复现方法

开发团队提供了一个简化的复现代码,可以不依赖LVGL框架直接重现问题:

nema_init();
nema_vg_init(800, 480);
nema_cmdlist_t cl = nema_cl_create();
nema_cl_bind_circular(&cl);
memset((void *) 0x20000000, 0xff, 800 * 480 * 2);
nema_set_clip(0, 0, 800, 480);
nema_bind_dst_tex((uintptr_t)NEMA_VIRT2PHYS((void *)0x20000000), 800,
                  480, NEMA_RGB565, 1600);
uint32_t bg_color = nema_rgba(255, 0, 0, 127);
nema_set_blend_fill(NEMA_BL_SRC_OVER);
bg_color = nema_premultiply_rgba(bg_color);
nema_fill_rounded_rect_aa(0, 0, 799, 479, 200, bg_color);
nema_cl_submit(&cl);
nema_cl_wait(&cl);

这段代码清晰地展示了问题出现的条件,有助于进一步分析和修复问题。

影响范围

虽然这个问题最初是在NEMA图形库中发现的,但有开发者指出类似的绘制问题可能也会出现在其他图形后端中。这表明这可能是一个更普遍的圆角矩形绘制问题,值得在更广泛的上下文中进行考察。

解决方案与进展

目前开发团队已经与相关硬件供应商取得联系,共同研究解决方案。对于遇到类似问题的开发者,建议:

  1. 暂时回退到已知工作正常的NEMA图形库版本
  2. 关注官方的问题修复进展
  3. 如果必须使用当前版本,可以考虑暂时禁用圆角效果作为临时解决方案

这个问题的重要性被标记为高优先级,开发团队正在积极寻求解决方案。对于嵌入式GUI开发者来说,理解这类图形绘制问题的成因和解决方法,对于开发稳定可靠的用户界面至关重要。

登录后查看全文
热门项目推荐