VisualHMI 图库详解：图标索引/多帧动画/批量导入与帧编辑

图库是 VisualHMI 里所有控件图片的总仓库。位状态灯、多状态指示灯、动画控件、按钮这些要换图标，都在图库里管。这篇把图库管理和"多帧图标"的概念讲清楚——多帧是 HMI 和普通组态软件最大的不同点之一。

1. 图库是什么

VisualHMI 所有控件使用的图片都在菜单【工程】→【图库】中管理，分两类：

• 工程图库：用户自定义的图片，随工程保存
• 系统图库：系统自带的常用按钮、switch、progress bar、键盘等图片

图库支持 bmp、svg、png、jpg 四种格式。

图库界面分四个区域：

• 区域1：添加、删除图标索引
• 区域2：图标索引列表（每个索引可以含多帧）
• 区域3：预览选中索引的每一帧
• 区域4：编辑帧——插入、Delete、export、修改（替换）、복사、移动

目前支持添加图库的控件共 15 种，具体图片属性在控件属性栏查看。

2. 关键概念：图标索引 与 帧

图标索引是一个"图标的容器"，一个索引里可以装多帧Image。多帧图标常用于：

• 多状态指示灯：不同状态显示不同帧（如运行=绿色、Stop=灰色、故障=红色）
• 动画控件：按顺序循环播放帧，形成动画

显示格式如"1-帧数(8)"：1 是索引号，8 是该索引下 8 帧。

3. 创建图标

3.1 添加多帧图标

点【+】生成一个"0-帧数(0)"的图标索引 → 点【添加帧】→ 选择图片文件。如添加 8 张图，索引 0 就有 8 帧。

3.2 批量添加（单帧图标）

点【批量添加】→ 选择多个 UI 图片文件 → 每个文件生成一个独立索引（1~8）。适合一批按钮图标一次性导入。

4. 帧的编辑操作

• 添加帧：选中索引 → 新增帧数 → 选图，新帧追加在末尾
• 插入帧：选中某一帧 → 新增帧数，新帧插在该帧后面
• 修改/替换帧：选中帧 → 修改 → 选新文件，原位替换
• 删除帧：删除单帧，或全部删除
• 复制帧：选中帧 → 복사 → 粘贴，生成相同帧
• 移动帧：选中帧 → 上移/下移，调整顺序（影响动画/多状态的显示顺序）
• 导出帧：选中帧 → export，保存为图片文件

5. 多帧图标的调试提示

• 多状态指示灯的状态数和帧数要对上：3 个状态就准备 3 帧，帧不够状态会显示空白
• 动画控件的播放顺序 = 帧顺序，想倒放就把帧顺序倒过来
• 替换帧后如果画面没刷新，重新编译一次

整理自 广州大彩科技 VisualHMI 开发文档（hmi-doc.gz-dc.com）Resource Introduction「图库」，版权归大彩科技所有。