VGUS Next

外观

基本图形 ​

基本图形

由变量驱动在屏上绘制点、线、矩形等基础图形，适合动态标注、简易示意图等进阶场景。

用途 ​

MCU 使用 0x82 向控件的 变量存储地址 写入绘图指令流，屏端在控件区域内刷新图形。相对常规显示控件更偏底层：命令字、坐标与颜色须按协议打包。简单进度或指针示意优先用 进度条、旋转图标 等现成控件。

典型用法 ​

  1. 在页面拖入「基本图形」并划定绘图区域
  2. 设置 变量存储地址，预留足够连续变量空间存放指令与数据
  3. 由 MCU 按命令格式写入点、线、矩形等绘图数据
  4. 下载后通过 0x82 更新变量区以刷新图形（也可用 0x83 读回核对）

基本图形属性设置面板

关键属性 ​

属性说明
变量存储地址(0x)图形数据起始字地址；0x82 写入后刷新。单元大小为一字 = 2 字节
描述指针(0x)默认 FFFF 关闭。启用后可改显示区域、虚线格式等，偏移见 描述指针 — 显示控件
名称控件标识，便于工程内查找
X / Y绘图区域左上角坐标
宽度 / 高度可绘制区域尺寸，越界部分通常不可见
锁定防止误拖动位置与尺寸

完整属性以 VGUS Next 属性面板为准。

绘图命令要点 ​

  • 指令流写在变量存储区，由 MCU 用 0x82 下发；区域裁剪对 0x0001–0x0005、0x0009、0x000A、0x000B 有效
  • 线段类指令（0x02、0x03、0x09、0x0A）可通过描述指针改为虚线或点划线
  • 当前不支持： 封闭区域填充（0x0008）、矩形区域 XOR（0x000D）、区域放大粘贴（0x0010）
  • 命令字与参数打包细节以开发指南图形命令章节为准；控件页只列组态侧必配项

注意事项 ​

注意

  • ⚠️ 属进阶控件：格式错误会导致图形不显示或只显示一部分
  • ⚠️ 变量区占用连续，勿与其它控件地址或描述指针区重叠
  • 💡 描述指针 默认 FFFF；多数应用无需启用

交互示例 ​

下面是浏览器里的示意：右侧 MCU 按钮用 0x82 写入不同绘图指令（点 / 线 / 矩形 / 圆）。命令打包以开发指南为准，本例只演示「写指令流 → 屏上出图」。外观与实机不完全一致。帧格式见 串口指令。

相关内容 ​