【纯白嫖】QGraphicsView Qt 画图工具:完整指南与快速上手教程
【纯白嫖】QGraphicsView Qt 画图工具:完整指南与快速上手教程
这是一个用 C++ 和 Qt 的 QGraphicsView 组件写成的轻量级 Qt 画图软件(项目内名为 qdraw)。它把画直线、矩形、椭圆、圆角矩形、不规则多边形、曲线这些常见绘图需求做成了开箱即用的工具,画完还能移动、缩放、删除。适合想学 Qt 图形界面、想在自有项目里嵌入画图功能、或者只是需要一个快速画图工具的人。
它适合谁
- Qt 初学者:QGraphicsView 的场景-视图-图元三层结构在这里有完整落地,读一遍源码就理解坐标、选择、交互是怎么串起来的。
- 需要嵌入画图功能的项目:绘图逻辑被封装在独立模块里,可以整体搬进自己的工程再做扩展。
- 日常快速画图:直接编译运行即可,画框、标注、画示意图不需要额外安装重型软件。
能画什么、能改什么
| 能力 | 具体效果 | 适用场景 |
|---|---|---|
| 画直线 | 两点之间拉出直线段 | 标注、连线 |
| 画矩形 / 圆角矩形 | 拖拽生成直角或圆角边框 | 画框、容器示意 |
| 画椭圆 | 自由框选生成椭圆 | 近似圆形元素 |
| 画不规则多边形 | 逐点指定顶点封闭成面 | 任意轮廓 |
| 画曲线 | 绘制平滑曲线 | 手绘感线条 |
| 移动图形 | 选中后拖到目标位置 | 布局调整 |
| 缩放图形 | 通过控制手柄调整尺寸 | 改变图形大小 |
| 删除图形 | 选中后移除 | 清理错误绘制 |
三步跑起来
- 准备环境:安装 Qt 开发环境(含对应 C++ 编译器,MinGW 或 MSVC 均可),确认 Qt Creator 或你的 IDE 能识别该工具链。
- 获取源码并编译:执行
git clone https://gitcode.com/open-source-toolkit/809b8,解压qdraw-master.zip后用 Qt Creator 打开工程文件(qdraw-master/qdraw.pro),编译运行。看到窗口中出现绘图工具栏、能画出第一根直线,即算成功。 - 上手探索:先用各工具画一遍六类图形,再试试选中、拖动、缩放、删除;然后读一遍
app/下各模块的源码,按自己的需求裁剪或二次开发。
代码怎么组织
整套交互界面建立在 Qt 的两个核心类上:QGraphicsScene 负责容纳和管理所有图形对象,QGraphicsView 提供窗口展示与视口交互;C++ 承担全部逻辑处理与对象管理。
封装按"视图 / 场景 / 图元 / 工具"分层,均在 qdraw-master/app/ 下:
drawview.cpp:QGraphicsView 子类,处理视口交互;drawscene.cpp:QGraphicsScene 子类,管理场景内图元;drawobj.cpp:具体图形对象(直线、矩形、曲线等);drawtool.cpp:各绘制工具的实现;document.cpp、mainwindow.cpp:文档结构与主窗口,命令撤销等入口在commands.cpp。
模块之间职责清晰,想只取绘图部分,把 draw 相关文件连同资源文件(app.qrc)拷走即可。
贡献与许可
遇到 bug、想加功能或觉得文档可改进,直接向仓库提交 issue 或 pull request 即可,三种形式都欢迎。项目采用 MIT 许可证(见 LICENSE),商业与非商业用途均可自由使用、修改、分发,遵守许可证条款即可。
🌟 源码、构建工程、许可文件都在同一仓库里,按上面的步骤走一遍,你的第一个 Qt 图形编辑器就跑起来了。
登录后查看全文