外观
文本变量
在界面上显示可变字符串（状态提示、名称、报文等）。MCU 通过 0x82 向变量地址写入编码后的文本即可刷新。
用途
文本变量用于显示一段可更新的文字。字库、编码、字长度与排版在组态时设定；运行时只需更新变量存储器中的文本内容。
典型用法
- 拖入「文本变量」并划定显示区域
- 设置 变量存储地址、字长度、FONT0/FONT1 与 FONT1 编码方式
- （可选）设置初始文本；需屏参启用「变量初值由配置文件决定」
- 下载后，MCU 用 0x82 按选定编码写入文本，并以
0xFFFF作为结束符（见注意）
关键属性
| 属性 | 说明 |
|---|---|
| 变量存储地址(0x) | 文本所在字地址；0x82 刷新用 |
| 初始值 | 上电初始文本（受屏参初值策略影响） |
| 字长度 | 汉字计 1、ASCII 计 0.5，范围约 1–1024；遇结束符或框尾停止显示 |
| FONT0 ID | 字母数字用 ASCII 字库 |
| FONT1 ID | 中文等用 GB2312/GBK 等字库 |
| FONT1编码方式 | GB2312 / GBK / BIG5 / SJIS / UNICODE / UTF8 等 |
| Y方向点阵数 | FONT0 与 FONT1 的 Y 点阵须相同且为偶数 |
| 字符间距 / 行间距 | 水平与垂直间距 |
| 字符宽度自动调整 | 去掉点阵空白列（点阵字库） |
完整属性以 VGUS Next 属性面板为准。
注意事项
注意
- ⚠️ 若字长度大于实际内容，0x82 写入时必须在文本末尾写
0xFFFF，否则可能显示垃圾字符 - 💡 TTF/ATTF 矢量字库通常限制为 UNICODE/UTF8
- ⚠️ FONT0 与 FONT1 的 Y 方向点阵数必须一致
- ⚠️ 初始值写入工程时会按 FONT1 编码方式转码
交互示例
下面是浏览器里的示意：MCU 用 0x82 写入文本并以 0xFFFF 结束。外观与实机不完全一致，完整行为以下载后屏端为准。帧格式见 串口指令。