QPainter 使用注意事项

最新推荐文章于 2025-05-29 13:06:34 发布
原创 最新推荐文章于 2025-05-29 13:06:34 发布 · 4.5k 阅读 · 5 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

本文探讨了QPainter在QWidget中的使用注意事项，强调其仅能在paintEvent内部调用，并介绍了在构造函数中设置属性`setAttribute(Qt::WA_PaintOutsidePaintEvent)`的局限性。重点解释了此设置不适用于所有平台，特别是Windows、MacOSX和EmbeddedLinux。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

QPainter 使用注意事项

最近创建了一个继承 QWidget 的窗口部件，使用 QPainter 绘制需要的内容，一部分在 paintEvent 中使用 QPainter，另一部分在自定义函数中使用 QPainter，发现运行时警告：
QWidget::paintEngine: Should no longer be called kernel……
QPainter::begin: Paint device returned engine == 0, type: 1 painting……

查找 QPainter 文档，发现如下事项：
Warning: When the paintdevice is a widget, QPainter can only be used inside a paintEvent() function or in a function called by paintEvent().

这才明白，QPainter 默认只能在 paintEvent 里面调用，在别处绘制就会遇到警告。另外，在构造函数中设置属性：

this->setAttribute(Qt::WA_PaintOutsidePaintEvent);　

是可以在paintEvent()之外绘制；但不幸的是，该属性只支持X11，对于 Windows、Mac OS X、Embedded Linux 均不予支持。
【QT开发】画笔控件QPainter类详解及实战应用
科技改变人类，技术成就未来
07-03 957
QPainter是Qt提供的一个功能强大且灵活的绘图控件，通过本篇文章的学习，你应该对QPainter有了全面的理解，能够在自己的项目中正确使用它。QPainter在用户界面中帮助你更好地绘制各种图形和文本，有助于创建用户友好和高效的界面。
QOpenGLWidget与QPainter混合渲染
草上爬的博客
03-24 6655
QOpenGLWidget取代了之前的QGLWidget类，用以在Qt中提供OpenGL的编程接口。在QGLWidget类中，我们可以通过方法drawTexture来绘制文本。但是在QOpenGLWidget类的时候，这个方法没有提供了。官方文档给出的建议是混合QPainter使用。本文档就是介绍怎么用QPainter来在OPengl窗口上绘制2D文本、 最近在用webRTC做直播的时候，需要在视频窗口左边下角显示用户名。视频是yuv420p格式，在QOpenGLWidget中用着色器渲染，用户名的话，用Q
Qt-QPainter的使用总结
qq_37464701的博客
07-15 966
QPainter是Qt框架中的一个类，主要用于在各种设备上进行2D图形绘制，如窗口、位图、打印设备等。它提供了一系列绘图函数，可以实现绘制点、线、曲线、形状、文本、图像以及复杂的绘画操作。QPainter 与 QPaintDevice 和 QPaintEngine 类一起构成了Qt绘制系统的基础：使用QPainter进行绘图的基本步骤如下：当你需要在自己定义的界面上面执行各种绘画操作时，使用这个类就行绘制，毕竟QT直接提供的Ui控件里面还是比较少的，如果你想实现自己的控件，可是重写里面的虚函数，进行绘制自己
QPainter的使用
Thinking777的博客
01-25 2763
Qt的绘图系统允许使用相同的API在屏幕和其他打印设备上进行绘制，整个绘图系统基于QPainter、QPaintDevice和QPaintEngine三个类。 **QPainter用来执行绘制操作，QPaintDevice是一个抽象的二维空间，这个抽象的二维空间允许QPainter在上面进行绘制，也就是QPainter的工作空间。QPaintEngine为QPainter提供了在不同设备上进行绘制的接口**。 QPaintEngine类应用于QPainter和QPaintDevice之间，通常对开发
Qt开发技术：Qt绘图系统（二）QPainter详解
木牛的博客
05-29 112
QPainter类在窗口和其他绘制设备上执行低级绘制。QPainter提供高度优化的功能来完成大多数图形用户界面程序所需的工作。它能画出从简单线条到复杂形状如饼图和弦等一切图形。它还可以绘制对齐的文本和像素图。通常，它绘制一个“自然”坐标系，但它也可以进行视图和世界变换。QPainter可以对继承QPaintDevice类的任何对象进行操作。QPainter的常见用法是在窗口的绘制事件中：构造和自定义（例如设置笔或画笔）绘制器。然后画。记住在绘制后销毁QPainer对象。
QT——QPainter的使用
qq_41077484的博客
08-09 5482
Qpainter创建的对象只能在绘画事件paintEvent(QPaintEvent *event)里使用 使用方法如下 QPainter painter(this);     painter.setPen(Qt::red);     painter.drawLine(263, 470, 1200, 470);     painter.drawLine(730, 80, 730, 860);  ...
Qt QPainter使用方法
LoveXming的博客
03-22 1091
Qt 重绘技术 QPainter paintEvent 事件 QEvent QPaintEvent 键盘事件
QPainter实现流光虚线
02-09
### 高级技巧与注意事项 1. **抗锯齿**：为了获得更平滑的线条，可以开启`QPainter`的抗锯齿功能：`painter.setRenderHint(QPainter::Antialiasing);` 2. **事件处理**：如果你是在`QWidget`上绘制，可能需要覆盖`...
QT中QPainter的使用方法与注意事项
在本篇文章中，我们将介绍QT中QPainter的使用方法和注意事项，帮助读者更好地掌握这一绘图工具。 # 2. QPainter的初始化与基本绘图 在使用QT进行绘图时，首先需要创建一个QPainter对象，然后通过该对象进行各种...
qpainter使用drawimage函数使得图像自适应显示
03-29
注意事项** - **空图像处理**：检查图像是否有效（`!image.isNull()`），避免崩溃。 - **性能优化**：频繁缩放大图像时，建议在`resizeEvent`中预缩放，而非每次绘制时实时计算。 - **高DPI支持**：若需适配高分辨...
Qt 使用QPainter类在子控件上画图
05-10
因为事件过滤器的影响 无法直接使用QPainter类在子控件上实现画图操作，需使用eventFilter函数进行修改
利用QPainter绘制各种图形
08-24
QPainter可以绘制几何形状（点、线、矩形、椭圆、弧形、弦形、饼状图、多边形和贝塞尔曲线）
QPainter使用总结
塔塔的日记
11-08 161
void Widget::paintEvent(QPaintEvent* event) { Q_UNUSED(event); //第一种 QPainter painter1(this); painter1.save();//保存绘制状态 painter1.setPen(Qt::blue); painter1.drawLine(QPoint(10, 10), QPoint(20, 20)); painter1.restore();/.
Qt界面篇：QPainter的使用入门——绘制象棋界面
欧特GO
06-28 1086
  原本计划所有的象棋界面都用Qpainter类绘制出来，但后续发现绘制出来的界面没有图片背景好看，因此采用了背景图片棋盘方式，棋子使用绘制类进行绘制。 界面设计较为简单，只用了QWidget和几个标签按钮。2.2 源码..................
Qt的QPainter详细介绍
2401_83283786的博客
04-07 6412
QPainter是Qt框架中的一个类，主要用于在各种设备上进行2D图形绘制，如窗口、位图、打印设备等。它提供了一系列绘图函数，可以实现绘制点、线、曲线、形状、文本、图像以及复杂的绘画操作。使用QPainter创建一个QPainter对象。将QPainter与要绘图的设备（如QPixmapQImage或QWidget）关联起来，通过调用begin()函数。使用QPainter提供的绘图函数进行绘图，如drawLine()drawRect()drawText()等。绘制完毕后，调用end()
Qt5.9中QPainter类用法
qq_37358946的博客
12-12 483
Qt5.9中QPainter类用法 原创 ...
PyQt6 基础操作：绘图 QPainter
AbigailQin 的博客
01-25 2384
PyQt6 QPainter 绘图操作
QPainter：绘制时钟
无人之国
07-05 690
Qt时钟学习QPainter的使用主要代码运行结果 学习QPainter的使用 最近在学习Qt，利用QPaint画一个时钟。 主要代码 在widget.h中声明绘图事件 void paintEvent(QPaintEvent *); 在widget.cpp中实现绘图事件 void Widget::paintEvent(QPaintEvent *) { QPainter p(this); //抗锯齿 p.setRenderHint(QPainter::Antialias
qpainter绘制使用opengl绘制
最新发布
07-18
<think>我们正在讨论在Qt中如何将QPainter与OpenGL结合使用。根据引用，有几种方法可以实现这一点。主要挑战在于QPainter会重置OpenGL状态，导致3D内容消失。以下是几种解决方案： 1. **在OpenGL绘制后使用QPainter绘制**（如引用[3]所示）： - 在`paintGL()`函数中，先完成所有OpenGL渲染（绑定着色器、纹理、绘制物体等），然后解绑所有OpenGL资源（如解绑VAO，释放着色器程序）。 - 接着，创建`QPainter`对象并开始绘制2D内容（如文本、图形）。这样，QPainter不会干扰之前设置的OpenGL状态。 - 注意：必须确保在调用QPainter之前，OpenGL已经完成了所有绘制并且已经解绑了相关资源。 2. **使用帧缓冲对象（FBO）**（引用[3]提到的高性能方法）： - 将文本或2D图形预先渲染到一个纹理（通过FBO），然后在OpenGL场景中将这个纹理贴到一个四边形上。 - 这种方法性能更好，尤其适合动态文本（因为避免了每帧都调用QPainter）。 - 步骤： - 创建一个离屏的FBO和关联的纹理。 - 将FBO绑定为当前渲染目标，使用QPainter将2D内容绘制到这个FBO中。 - 解绑FBO，此时纹理中包含了2D内容。 - 在OpenGL渲染过程中，像使用普通纹理一样使用这个纹理，将其渲染到屏幕上的一个四边形（如矩形）上。 3. **避免开启GL_CULL_FACE**（引用[1]提到）： - 如果在使用QPainter时遇到显示问题（如部分内容不显示），检查是否开启了`glEnable(GL_CULL_FACE)`。在绘制2D内容之前，应该关闭背面剔除（因为QPainter绘制的2D多边形可能没有正确的朝向，导致被剔除）。 4. **使用QOpenGLWidget的overpaint功能**（引用[4]提到）： - Qt提供了Overpainting示例，展示了如何在QGLWidget（或QOpenGLWidget）中使用QPainter在OpenGL场景上绘制。 - 基本思路与第一种方法类似：先绘制OpenGL场景，然后绘制2D覆盖内容。 **具体实现步骤（以第一种方法为例）**： 在`QOpenGLWidget`的子类中，重写`paintGL()`函数： ```cpp void MyGLWidget::paintGL() { // 清除缓冲区 glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); // 1. 绘制OpenGL内容（3D场景） m_program->bind(); // ... 设置uniform，绑定纹理，绑定VAO等 glDrawElements(...); // 解绑 glBindVertexArray(0); m_program->release(); // 2. 绘制2D内容（使用QPainter） QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing); painter.setPen(Qt::yellow); painter.setFont(QFont("Arial", 16)); painter.drawText(10, 30, "Hello, OpenGL!"); painter.end(); // 结束绘制 } ``` **注意事项**： - 在调用QPainter绘制之前，确保OpenGL已经释放了所有绑定的资源（如着色器程序、VAO、VBO、纹理等），否则可能导致冲突。 - 如果同时使用深度测试，注意QPainter绘制的2D内容应该位于最上层，可能需要暂时禁用深度测试。 - 性能：如果2D内容复杂且每帧变化，使用QPainter直接绘制可能会影响性能。此时，考虑使用第二种方法（FBO）或者将静态2D内容缓存为纹理。 **引用说明**： - 引用[1]提醒我们注意OpenGL状态设置（如背面剔除）对QPainter的影响[^1]。 - 引用[2]描述了QPainter与OpenGL共用的场景和问题[^2]。 - 引用[3]提供了两种方法：直接绘制和生成纹理，并给出了代码片段[^3]。 - 引用[4]指向了Qt的Overpainting示例[^4]。 根据这些信息，你可以根据需求选择合适的方法。</think>### QPainter 结合 OpenGL 的绘制方法 在 Qt 中结合使用 QPainter 和 OpenGL 渲染时，主要有两种实现方式，核心挑战在于解决 OpenGL 状态被 QPainter 重置的问题： #### 方法一：顺序绘制法（推荐） **步骤**： 1. **先完成 OpenGL 渲染**： ```cpp void MyGLWidget::paintGL() { // 清除缓冲区 glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); // 绑定OpenGL资源 m_program->bind(); m_texture->bind(0); glBindVertexArray(VAO); // 执行OpenGL绘制 glDrawElements(GL_TRIANGLES, 6, GL_UNSIGNED_INT, 0); // 解绑资源（关键步骤） glBindVertexArray(0); m_program->release(); ``` 2. **再使用 QPainter 绘制 2D 内容**： ```cpp // 开始QPainter绘制 QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing); // 绘制带背景的文字 painter.fillRect(QRect(5, 5, 200, 30), QColor(0,0,0,128)); painter.setPen(Qt::yellow); painter.drawText(10, 25, "FPS: " + QString::number(fps)); painter.end(); // 结束绘制 } ``` **关键点**： - 必须严格解绑所有 OpenGL 资源（VAO/VBO/着色器）后再调用 QPainter[^3] - 避免开启 `glEnable(GL_CULL_FACE)`，否则可能导致 QPainter 内容不显示[^1] - 此方法适合简单叠加场景（如 HUD 信息显示） #### 方法二：纹理合成法（高性能方案） **适用场景**：动态文本或复杂 2D 图形 ```cpp // 1. 创建离屏FBO和纹理 QOpenGLFramebufferObject fbo(width, height); fbo.bind(); // 2. 使用QPainter绘制到纹理 QPainter painter(&fbo); painter.drawText(...); painter.end(); // 3. 将纹理绑定到四边形渲染 glActiveTexture(GL_TEXTURE0); glBindTexture(GL_TEXTURE_2D, fbo.texture()); // ... 渲染四边形 ... ``` **优势**： - 避免每帧调用 QPainter 的性能开销 - 保持 OpenGL 状态稳定 - 支持动态内容更新[^3] #### 常见问题解决 1. **OpenGL 内容消失**： - 原因：QPainter 重置了 OpenGL 状态机 - 方案：确保在 QPainter 绘制前完成所有 OpenGL 渲染并解绑资源[^2] 2. **文字模糊**： ```cpp painter.setRenderHint(QPainter::TextAntialiasing); // 启用抗锯齿 painter.setFont(QFont("Arial", 16, QFont::Bold)); // 使用矢量字体 ``` 3. **深度测试冲突**： ```cpp glDisable(GL_DEPTH_TEST); // 绘制2D前禁用深度测试 // ...QPainter绘制... glEnable(GL_DEPTH_TEST); // 恢复设置 ``` > **最佳实践**：对于静态界面元素（如按钮），建议使用纹理法；对于实时变化的 HUD 信息，采用顺序绘制法更便捷。Qt 官方示例 *Overpainting* 演示了标准实现[^4]。 --- ### 相关问题 1. 如何解决 QPainter 绘制后 OpenGL 3D 模型消失的问题？ 2. 在 QML 应用中如何实现 OpenGL 与 QPainter 的混合渲染？ 3. 使用 FBO 进行离屏渲染时如何进行性能优化？ 4. 如何实现跨平台（Windows/Linux/嵌入式）的 OpenGL + QPainter 方案？ [^1]: 注意在 OpenGL 和 QPainter 结合使用时，如果开启 glEnable(GL_CULL_FACE) 可能会出现 QPainter 显示问题 [^2]: 调用了 QPainter 后 OpenGL 的状态被清空丢失，导致 3D 不显示 [^3]: 在 paintGL() 中先完成 OpenGL 渲染，解绑资源后再绘制文本 [^4]: The Overpainting example 展示如何在 QGLWidget 中使用 QPainter 覆盖 OpenGL 场景
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值