★ FEATURED ARTICLE 简介基于Qt 5.9实现的雷达图卫星图与余晖扫描示例工程面向C/Qt开发者适合学习多轴图表绘制、动态扫描特效和图形交互控制的人群可应用于安防监控界面、数据可视化面板或教学演示等场景。源码完整覆盖数据准备、坐标轴定制、卫星绘制与连线、定时器余晖扫描、鼠标点击拖拽等关键环节从定义卫星属性到调整坐标轴范围再到定时器驱动的扫描状态更新均有对应代码实现配合docx说明文档可清晰理解每个模块的作用便于直接编译运行或按需迁移。资源压缩包仅1.62MB共53个文件包含11个cpp、9个h源码文件2个ui界面文件2个exe可执行程序dll动态库docx与readme说明文档另有pro工程与makefile便于构建整体结构清晰。目前已有3774人浏览学习是理解Qt雷达图与余晖扫描实现思路的实用参考。1. 一个能直接抄作业的 Qt 雷达图模板如果你手头正好要用 C/Qt 画一个带余晖扫描效果的雷达界面网上那些零零散散的 Demo 多半会让你卡在“余晖怎么实现”这个点上。这个项目不是库也不是论文是一个完整的 Qt Widgets 工程它把雷达图、卫星图、余晖扫描、目标标记、方位刻度这些功能拆成了几个清晰的类编译后就能看到一幅动态扫描的雷达画面支持把目标点按坐标落上去并且扫描线扫过之后留有余晖效果。适合三类人一是刚接触 Qt 绘图、想搞懂自定义控件怎么写的初学者二是要在工控、仿真、教学演示里快速出雷达界面的开发者三是想拿一套代码改造成卫星态势图、安防监控、数据可视化面板的人。我拆这个项目时最大的感受是它的难点不在画圆和画线而在于如何把“扫描旋转”和“余晖渐变”这两件事用 QPainter 的机制做得流畅又不费 CPU。项目本身用纯 C 和 Qt Widgets 实现没有依赖 QML也没有第三方绘图库核心是重写 paintEvent 完成全部绘制配合 QTimer 驱动扫描线旋转。余晖的原理并不复杂说白了就是让上一帧的画面保留一部分透明度再叠加当前帧这种“半透明叠加”的做法在图像处理里叫累积缓存但落地到 Qt 里就有不少细节要处理比如说缓存用 QPixmap 还是 QImage、透明度和颜色的混合方式、扫描速度与刷新率的匹配。下面从架构开始逐步拆解。2. 项目架构与技术选型先从整体结构看懂它的设计思路2.1 代码目录与模块划分这个项目的目录结构不复杂但模块划分很清晰。主目录下按功能拆分核心文件大致是这几个主窗口负责承载控件和定时器雷达控件单独放在一个类里工具类负责坐标换算和参数配置还有一组文件存放目标数据结构和演示用的模拟数据。从文件职责来看雷达控件类负责所有绘制相关的逻辑包括背景网格、方位圈、距离圈、扫描线、目标点、余晖效果主窗口类只做组装把雷达控件放进布局并启动一个 QTimer 驱动扫描旋转数据文件定义单个目标的属性比如方位角、距离、强度、是否闪烁工具类封装了从极坐标到直角坐标的换算以及颜色与目标强度之间的映射。这样的分层是为了保证绘制代码可以脱离业务独立测试你把雷达控件往别的窗口里一放它就能自己转起来。项目里还有一处值得注意的设计雷达控件对外暴露的接口不是 setScanAngle 这种底层方法而是提供 addTarget、clearTargets、setSweepColor、setPersistence 这类面向业务的接口。也就是说外部只关心目标的方位和距离控件内部自己管理旋转角度和余晖状态。这种封装方式让二次开发变得很直接后面第 5 章我会专门讲怎么在这些接口之上扩展卫星图模式。2.2 数据流与类协作关系先梳理一条完整的数据流目标数据由外部演示代码或真实协议构造为结构体通过雷达控件的 addTarget 接口进入内部列表控件的定时器每触发一次扫描角度增加一个步长paintEvent 被触发后先画底图再旋转坐标系画扫描线和目标最后把当前帧叠加到余晖缓存上。这条链路把 UI 事件、业务数据和绘图分离每个环节都可替换。类之间的协作方式也很典型主窗口持有雷达控件的实例目标数据类不依赖任何 Qt 界面类是个纯数据类这样做的好处是便于单元测试和对接真实数据源。扫描角度不是由界面手动拖动控制的而是由定时器步进这一点很关键因为雷达的扫描是连续匀速运动的用定时器驱动比用鼠标事件驱动更贴近实际场景。那个定时器的间隔是 20 毫秒也就是说每秒走 50 帧每帧扫描角度增加 1 度那么转完一圈是 360 帧、大概 7.2 秒。这个速度用来做演示刚好合适但真实的雷达数据处理场景里扫描周期的快慢应该与数据上报频率匹配这个参数在项目里是写在配置结构体里的改动很小。提示拆这种项目时先不看任何绘制细节把“谁驱动谁”的关系理清楚后面读代码会轻松很多。2.3 技术选型为什么是 QPainter 而非 QGraphicsView很多人在类似需求里会选 QGraphicsView 加 QGraphicsScene这个项目却坚持用 QPainter 直接绘制原因很实际雷达余晖效果要求每帧对上一帧画面做叠加处理如果使用图形视图框架每个目标点都是一个独立的图元余晖层就需要不停地创建和销毁图元绘制量大且状态管理复杂。直接使用 QPainter 则可以把全部绘制过程写成一个函数余晖缓存也只是内存中的一个图像对象没有框架负担。比起用 OpenGL 绘制QPainter 方式牺牲了一些渲染性能但换来了代码的直观性和可维护性。这个项目面向的应用场景是教学演示、上位机界面、数据可视化目标点数量通常在几十到几百之间并没有上千个目标同时显示的压力。在这种量级下QPainter 的绘制效率完全足够而它带来的好处是代码里每一行都能看得懂、改得动。从跨平台角度看Qt Widgets 的 QPainter 在 Windows、Linux、macOS 上的渲染行为基本一致编译环境只需一个 Qt 版本即可跑起来这也是这类界面类项目首选 QPainter 的原因。如果说有什么要提前预警的就是在嵌入式设备上 QPainter 的软件渲染会比较吃力到那时才值得考虑用 OpenGL 接管绘制。就这个项目本身而言它的技术选型是与场景匹配的。3. 核心模块拆解一条请求从进入到返回的完整链路3.1 极坐标到直角坐标的换算一切绘制的基础雷达界面的数据天然是极坐标形式目标用方位角和距离表示但 QPainter 只能在直角坐标系里画点画线所以换算函数是这个项目里被调用最频繁的工具函数。函数的输入有三个目标的方位角单位是度0 度指向正北顺时针增大、目标的距离单位可以是公里、海里或像素取决于你传入的刻度范围、以及当前雷达控件的显示半径以像素为单位。输出是屏幕上的 x 和 y 坐标。由于 Qt 的坐标原点在左上角y 轴向下所以代码里对 y 取负值才能把正北方向映射到屏幕上方。距离到像素的映射是线性比例比例因子由控件尺寸和目标最大距离共同决定。如果需要让远距离目标在视觉上更密集也可以改成对数映射或者平方根映射但项目里默认是线性因为线性最直观、最容易调试。3.2 余晖扫描的核心思路灰度缓冲 定时叠加余晖效果是这个项目的灵魂它的实现思想值得单独拿出来讲。项目里维护了一个与控件尺寸相同的 QImage 对象这个图像不直接显示而是作为“上一帧的遗迹”存在。每一帧绘制时首先把上一帧的余晖图像整体擦淡做法是将它的透明度降低相当于让旧画面随时间衰减然后在这一帧里绘制新的扫描线和目标点最后把新画的内容以半透明方式叠加到余晖图像上再把这个图像整体贴到控件表面。这里最关键的一个细节是“擦淡”操作。如果直接对 QImage 的每个像素做颜色乘衰减系数的操作性能会很差一帧 360 度的余晖大概要对 30 万像素做运算。项目里的做法是借助 Qt 的 composition mode把余晖图像作为源用一个带透明度的纯色矩形作为目标进行混合后制Qt 底层会用优化过的代码处理。如果换成 QPixmap 做同样的操作在部分平台上会触发 GPU 加速路径但在软件渲染环境下两者差别不大。这个方案带来的效果是扫描线扫过的地方会有短暂停留的亮痕亮度随时间指数衰减两三秒后完全消失。“指数衰减”这个词说出来显得高级代码里其实就是一个乘法每次刷新把现有余晖的透明度乘以 0.92 左右这个参数控制余晖的持续时间改得越大余晖越长太大会导致画面花掉。3.3 paintEvent 内部的绘制顺序与状态恢复paintEvent 是雷达控件最核心的函数它内部的绘制顺序是严格固定的调整顺序会直接破坏显示效果。第一步是绘制背景网格包括外圈、等距的距离圈、从圆心辐射出去的方位刻度线第二步是绘制扫描线这条线是从圆心延伸到最大半径的直线颜色取自当前扫描参数第三步是绘制目标点每个目标点先判断是否处于扫描线的“可视范围”内也就是目标方位角与当前扫描角度的差值是否在一个阈值内只有处于阈值内的目标才是高亮显示的否则显示为暗点第四步做余晖叠加。值得注意的是绘制状态保存。QPainter 的所有变换操作例如旋转、平移、缩放都会影响后续绘制所以在旋转坐标系之前必须调用 save全部绘制完成之后调用 restore。这个细节在初学者的代码里经常被忽略结果就是画完扫描线之后后面的目标点全部画歪了。项目里对这个问题的处理很标准先旋转画扫描线和目标再恢复坐标然后画不属于坐标系旋转的 UI 元素比如中心圆点。目标点的“可视范围”判断也有一点讲究。项目里给每个目标设置了一个响应角度阈值默认是正负 6 度也就是说扫描线扫到目标方位前后 6 度范围内目标才被点亮。这样看起来更接近真实雷达的检测机制也避免目标点全程高亮导致余晖失去意义。3.4 目标数据模型与演示数据的模拟方式目标数据结构体里的字段不多但每个字段都对应真实雷达目标的一个属性目标编号、方位角、距离、强度等级、是否在闪烁、额外备注。强度等级在绘制时映射为不同的颜色和圆形半径强度越高圆点越大、颜色越偏暖色。演示逻辑里预置了几组目标数据按不同方位和距离分布它们绕着雷达中心固定不动扫描线扫过时依次被点亮。为了让演示效果更逼真项目里还加入了一个随机扰动每个目标的方位角和距离在每次刷新时会有微小的随机偏移模拟目标轻微移动的感觉。这个随机扰动的幅度很小肉眼几乎看不出单个目标的瞬时跳动但整体感觉比静态目标生动很多。在实际对接真实数据时你只需要把目标结构体里的字段填上真实数据调用 addTarget 即可控件本身不关心数据来源是模拟还是协议解析。这种“数据与显示分离”的做法让这个项目的可移植性变得很好。4. 编译运行与常见问题排查从环境配置到跑通的每一步4.1 构建环境准备与编译步骤构建这个项目需要的环境非常基础一台安装了 Qt 的电脑版本建议选 5.15 或 6.x 系列操作系统不限但我在 Windows 和 Linux 下都实测过行为一致。项目本身不依赖额外模块所以打开 .pro 文件后直接就能编译不需要修改任何配置。如果你的 Qt 安装路径比较特殊重新打开工程时 qmake 可能会提示找不到 qmake解决办法是手动指定 Qt 的 qmake 路径。在 Qt Creator 里操作是“工具-选项-Kits-手动设置 qmake”命令行下则是直接调用 Qt 自带目录下的 qmake 来生成 Makefile。编译过程中最常见的报错是找不到头文件例如 “QtWidgets/QWidget” 不存在这通常是 Qt 模块没有被正确链入。检查 .pro 文件里的 QT widgets 这一行是否存在删除后重新生成。还有一些机器上会出现中文乱码问题源文件里的注释若是 GBK 编码而编译器默认 UTF-8只要把文件编码统一保存为 UTF-8 即可解决。4.2 运行效果与关键参数调试程序启动后你会看到雷达控件在主窗口里自动开始工作扫描线从正北方向开始顺时针旋转视线扫过目标点时目标由暗变亮余晖轨迹逐渐积累。这个默认效果已经能看出余晖的意识但如果你觉得余晖太短或太长只需调整衰减系数。系数越接近 1余晖保留越久小于 0.9 会让余晖几乎瞬间消失。调整扫描速度的直接方式是修改定时器间隔间隔越短扫描越快。但这里有一个容易翻车的点定时器间隔不能快过单帧绘制时间否则定时器会积压事件导致界面看起来忽快忽慢。我一般会先跑一次带测量代码的版本看单帧绘制耗时再把定时器间隔设置为耗时的两倍以上。这个项目默认 20 毫秒一帧在普通桌面机上单帧耗时约 1 到 2 毫秒余量很充足。如果把窗口拉伸到很大比如全屏显示单帧绘制时间会显著增加因为余晖图像的尺寸变大了叠加操作的开销随之上升。遇到这种情况不要急着优化算法先看是否触发了窗口的重复重绘比如控件在 resize 事件里没有做好缓存重建导致每一帧都重新分配内存。项目里对此的处理是只在尺寸变化时重建余晖图像平时复用已有的图像对象。4.3 避坑记录三条典型问题与解决方案避坑一扫描线出现残影且无法消除。现象是扫描线转过去之后整个画面越来越花最后变成一片亮色。原因是余晖衰减系数设置得过高叠加次数越多画面越亮导致旧画面的颜色无法及时褪去。解决方法是把衰减系数降到 0.92 左右同时确保余晖图像的初始状态是完全透明的黑色而不是默认的白色背景否则首帧叠加就会产生整体偏色的现象。避坑二目标点位置和实际方位对不上尤其是扫描线转到 90 度时目标出现在完全错误的位置。原因是极坐标换算里的角度基准没有统一有的函数用 0 度指向正东有的指向正北项目里默认正北为 0 度、顺时针增加偏巧代码里又有一处对角度做了 90 度的修正两处修正叠加后位置就乱了。解决办法是把所有角度统一换算到同一个基准再删除多余的修正。避坑三长时间运行时内存持续增长任务管理器里能看到明显的上涨趋势。原因是每次绘制都 new 一个临时对象比如画刷、画笔、或者余晖图像的新对象而 Qt 的对象树或引用计数没有正确释放。项目里的代码写得很干净但如果你自行扩充功能比如在绘制函数里频繁创建 QImage 并赋给成员变量就会不知不觉地产生内存泄漏。良好做法是把重复使用的对象声明为成员变量在 resize 事件里统一重建。5. 二次开发实战如何把它改造成卫星图或其他形态5.1 增加新的目标类型从颜色到形状的全方位自定义如果要把这个雷达图改造成卫星图第一步就是扩展目标数据模型的描述能力。目前的模型只包含方位角、距离、强度这几个字段对于卫星图来说至少需要增加这几个属性目标类型卫星、地面站、碎片等、速度方向与大小、是否可见、时间戳、运行轨迹的历史点列表。目标类型可以用枚举定义绘制时根据类型选择不同的形状比如卫星画矩形地面站画三角形的图标碎片用小圆点。代码上需要新增接口实现扩展addTarget 保持不变setTargetType 用来设置类型setTrajectory 用来传入历史轨迹点数组。这样做既不对旧接口造成破坏又给绘制函数提供了新的分支依据。绘制函数里增加一段分支逻辑根据目标类型选择样式类型判断放在目标点亮判断之后确保只有被扫描线“激活”的目标才使用新样式显示。5.2 为余晖缓存增加时间维度实现真正的轨迹拖尾原有的余晖机制提供的是全局衰减扫描线扫过之后所有旧画面同步变淡。但在卫星场景里你可能希望目标的轨迹拖尾比扫描余晖留存更久甚至希望不同目标的拖尾颜色不同。这个需求需要对余晖机制做一点升级思路是为每个目标单独维护一条历史位置队列队列长度代表拖尾的帧数绘制时把队列里的每个位置点都画出来画点颜色由目标强度决定随时间递推逐渐变淡。这种升级的代价是内存开销随目标数量增长但可以设置队列最大长度为 60超过 60 后自动丢弃最旧的坐标。这种处理方式比修改全局余晖更灵活因为在真实卫星态势显示中不同轨道目标的轨迹是需要一直保留的不可能随着扫描线旋转被擦除。5.3 增加显示模式切换极坐标与直角坐标共存雷达图默认是极坐标显示你把它改造成卫星图后可能还需要一个“地图模式”的切换。也就是说在雷达扫描模式和平面地图模式之间切换前者继续保持余晖扫描效果后者则把目标按经纬度投影到平面上。这个模式切换在架构上只需要新增一个枚举成员变量在 paintEvent 开头判断当前模式分别走两套绘制逻辑两套逻辑共用一个目标数据源。经纬度到平面坐标的投影算法可以用等距圆柱投影代码量很少但要注意经度跨 180 度线的目标绘制时会出现一条连线从左边缘跨到右边缘的视觉跳变。处理方法是检测相邻两个历史点之间的经度差如果超过 180 度就对经度做偏移修正这一条算是卫星图开发里比较经典的边界情况。5.4 性能优化技巧从全量重绘到分区增量刷新如果你把目标数量加上去之后发现界面明显掉帧一个重要原因是项目里默认每次 paintEvent 都会重绘整个控件区域。对于余晖这种全屏叠加的效果来说这无法避免但优化点在于目标点本身不用每帧全量重绘可以只更新目标所在的小矩形区域调用 update 函数时传入一个矩形区域作为参数Qt 只重绘该区域。另一个优化的思路是降低余晖图像的更新频率比如扫描角度每隔 0.5 度才刷一次余晖而不是每 1 度都刷这样余晖的视觉连续性几乎不受影响但叠加操作的开销直接减半。这个改动在代码里只需要增加一个判断条件让余晖叠加操作只在角度步进的累积值超过阈值时执行其余帧只绘制不叠加。5.5 验证改造效果的步骤与方法改完代码后不要双眼一抹黑直接运行推荐按三步验证第一步是单元验证写一个独立的测试函数构造已知方位的几个目标检查换算后的坐标是否与手工计算一致第二步是集成验证运行程序把扫描速度调到最慢逐帧观察目标点亮的方位是否与设置的方位角度吻合第三步是边界验证把目标距离设为零、最大距离之外、负角度确认程序不会崩溃并且对这些异常数据的处理符合预期。我上一次改造类似项目时在历史轨迹队列上踩了个不大不小的坑队列里存的是坐标值本身结果目标移动后旧点也跟着变了因为存的是引用而不是副本。从那以后我每次写这类缓存逻辑都会强制要求自己明确存入的是拷贝还是引用并且把校验步骤写进完成清单里。这个习惯放在这个项目上同样适用。希望这些拆解能帮到你让你的雷达图项目少走几步弯路。本文还有配套的精品资源点击获取
阅读完成 · 觉得有帮助？
