源码开源/Qt实现可动画的链条传动仿真控件

在工业上位机开发中，经常需要做设备运行状态动画展示，比如输送机、链条传动机构，用动画直观告诉用户设备是运行、停止、正转还是反转。普通Qt自带控件没有链条传动的组件，这就需要自己绘制自定义Widget。本文就来拆解一个完整的链条传动自定义控件，聊聊它的功能、设计思路以及核心实现逻辑。

控件效果：一大一小两个链轮，带真实滚动的滚子链条；支持调速、切换启停、切换转向；窗口拉伸自动适配大小；运行时有彩色效果，停止整体变灰色。

源码开源，有需要的朋友，关注本公众号后，在文章后面评论我要源码字样，麻烦顺带点赞转发下，加微信feiyangqingyun截图评论索取。

一、控件具备哪些功能

这个ChainDriveWidget链条传动控件，把工业链条传动的视觉效果做了完整封装，对外提供属性接口，可以直接在代码里调用设置，也支持Qt属性系统，Qt Designer也能识别属性：

1. 1. 转速控制rpm：设置链轮每分钟转速，范围0‑3000，转速越高链轮转得越快；大小链轮自动按照半径反比变速，模拟真实传动比。
2. 2. 链条移动速度chainSpeed：单独控制链条滚子跑动快慢，可以和链轮转速做解耦调试。
3. 3. 启停状态running：true为运行，false停止。停止之后链轮角度、链条偏移归零，全部变成灰色，直观显示设备停机。
4. 4. 转向clockwise：true顺时针、false逆时针，一键切换链轮和链条转动方向。
5. 5. 全套颜色自定义：大链轮、小链轮、链条滚子、链板、中心轮毂、停机灰色都可以自定义颜色，适配不同项目UI主题。
6. 6. 自适应窗口大小：控件拉伸缩放，链轮大小、链条长度、链节数量会自动跟着窗口尺寸重新计算，不会画超出控件边界。
7. 7. 真实离散链条效果：链条不是一条简单实线，而是由一个个滚子+链板拼接而成，链节沿着链轮和切线闭环路径滚动，不是简单的贴图移动。
8. 8. 内置动画定时器：控件内部自带QTimer，不需要外部再开定时器，实例化出来就自动播放动画。
9. 9. 设置推荐默认尺寸500×300，最小120×60，防止窗口缩得太小画面错乱。

二、整体架构设计思路

整个控件继承QWidget，Qt自定义绘图标准套路：

• • 构造函数：初始化全部成员变量、颜色、初始转速，启动内部动画定时器。
• • paintEvent：所有绘图都在这里，每次update()触发重绘。
• • 两个核心绘制函数：drawSprocket画链轮；drawChain绘制闭环滚子链条。
• • 定时器槽函数onAnimationTimer：每一帧更新旋转角度、链条偏移量，调用update触发重绘。
• • 一堆set/get接口 + Q_PROPERTY属性，对外暴露参数。

绘图顺序很重要：先画链条，再画链轮。这样链条会绘制在链轮下层，视觉上链条是“搭在链轮齿上”，而不是浮在链轮上面。

1. 1. 国内开源：https://gitee.com/feiyangqingyun
2. 2. 国际开源：https://github.com/feiyangqingyun
3. 3. 项目大全：https://qtchina.blog.csdn.net/article/details/97565652
4. 4. 联系方式：微信 feiyangqingyun
5. 5. 官方店：https://shop114595942.taobao.com/