3.15 ApusTAI 仪表指针控件

仪表指针按读取地址的数值旋转。表盘是另放的图片控件，不属于仪表指针本身。示例表盘和指针采用统一素材；下图是历史版 ApusTAI 模拟器运行时的 0 值画面。

添加与设置

先放置表盘图片，再叠放“仪表指针”控件。指针图片应朝向 3 点钟方向，并让图片的旋转中心与表盘圆心重合。

1. 读取地址与数据类型：示例使用 LW0352、UINT16；应与实际变量类型一致。
2. 数值范围：示例开始值为 0、结束值为 100，对应表盘的最小和最大刻度。
3. 指针与角度：选择朝右的指针图片，并设置开始角度、占用角度及旋转方向。示例为 225°、270°、顺时针。表盘刻度和这些设置应保持一致。
4. 旋转中心：以指针图片自身左上角为原点填写 X/Y。示例指针图片为 72×18 像素，旋转中心 X=9、Y=9；更换图片后须重新按图片几何尺寸核对。

当前示例已编译并在模拟器中检查 0 值画面。用于实际工程时，还应分别输入最小值、中间值和最大值，检查指针方向、转轴位置及刻度对应关系；目标设备显示需另行核对。

属性图与练习工程对照

上方带编号的属性图用于说明设置项，图中示例为 LW0352；下方可下载练习工程位于第 16 页，使用 LW0312。两套设置不能混用，复现时以下载工程的实际属性为准。

练习工程关键设置：表盘是独立图片，指针读取 LW0312；UINT16、区间 0～100、起始角 225°、占用角 270°。指针图为 72×18，旋转中心 (9,9)；按钮写入 25 和 75。

逐步复现与排查

1. 进入第 16 页，观察指针初始位置。
2. 点击“75”再点“25”，确认指针沿表盘刻度转动且转轴位置不漂移。
3. 在 IDE 中分别选中表盘图片和指针控件，确认两者是两个对象，核对地址及旋转中心。

结果异常时：指针绕偏心点转动时，检查图片尺寸、旋转中心和控件在表盘上的位置；更换图片后须重新量取中心。

 

可下载练习案例

下载 DocControlsTest.apustai，使用 ApusTAI 的“打开范例工程”导入。工程型号 E043C4827，画面 480×272，协议 DCBUS；导入后先编译，再运行“虚拟屏调试”。本例地址仅供练习，连接实际控制器时按现场协议重新分配。

打开第 16 页，点击“25”“75”向 LW0312 写入 25、75，核对指针相对表盘旋转；初始值为 25。

图片是本机模拟器的页面运行画面。工程已通过页面和控件回读、0 错误 0 警告编译以及编译产物校验。本页 0→75 的模拟器指针变化已实测。