qt QOffscreenSurface详解

1、概述

QOffscreenSurface 是 Qt 中用于离屏渲染的一个类。它允许在不直接与屏幕交互的情况下进行 OpenGL 渲染操作，常用于生成纹理、预渲染场景等。通过 QOffscreenSurface，可以在后台创建一个渲染表面，进行绘制操作，并将结果捕获为 QImage 或其他格式。

2. 重要方法

构造函数

QOffscreenSurface::QOffscreenSurface(QScreen *targetScreen = nullptr);
QOffscreenSurface::QOffscreenSurface(QScreen *targetScreen, QObject *parent);

创建一个离屏表面对象，可指定目标屏幕和父对象。

析构函数
```
virtual QOffscreenSurface::~QOffscreenSurface();
```
- 销毁离屏表面对象，释放相关资源。

创建和销毁
```
void QOffscreenSurface::create();
void QOffscreenSurface::destroy();
```
- create()：创建离屏表面。
- destroy()：销毁离屏表面，释放相关资源。
有效性检查
```
bool QOffscreenSurface::isValid() const;
```
- 检查离屏表面是否有效。

原生句柄操作

void *QOffscreenSurface::nativeHandle() const;
void QOffscreenSurface::setNativeHandle(void *handle);

获取和设置离屏表面的原生句柄。

格式操作

QSurfaceFormat QOffscreenSurface::requestedFormat() const;
void QOffscreenSurface::setFormat(const QSurfaceFormat &format);
virtual QSurfaceFormat QOffscreenSurface::format() const override;

获取和设置离屏表面的请求格式。
format()：获取当前表面的实际格式。

屏幕操作

QScreen *QOffscreenSurface::screen() const;
void QOffscreenSurface::setScreen(QScreen *newScreen);

获取和设置离屏表面的目标屏幕。

尺寸获取

virtual QSize QOffscreenSurface::size() const override;

获取离屏表面的尺寸。

表面类型获取

virtual QSurface::SurfaceType QOffscreenSurface::surfaceType() const override;

获取离屏表面的表面类型。

3. 信号

屏幕更改信号
```
void screenChanged(QScreen *screen);
```
- 当离屏表面的目标屏幕发生变化时发出此信号，screen 参数表示新的目标屏幕。

4. 常用枚举

QOffscreenSurface 本身没有定义枚举，但它使用了 QSurfaceFormat 类中的枚举，例如：

QSurfaceFormat::FormatOptions
- AlphaBuffer：启用 alpha 缓冲区。
- DepthBuffer：启用深度缓冲区。
- StencilBuffer：启用模板缓冲区。
- Samples：多重采样抗锯齿的样本数。

#include "renderthread.h"#include <QDebug>
#include <QOpenGLContext>
#include <memory>RenderThread::RenderThread(QOpenGLContext *mainContext, QObject *parent): QThread(parent), m_mainContext(mainContext)
{m_surface = new QOffscreenSurface();m_surface->setFormat(mainContext->format());m_surface->create();m_renderContext = new QOpenGLContext;m_renderContext->setFormat(m_mainContext->format());m_renderContext->setShareContext(m_mainContext);m_renderContext->create();m_renderContext->moveToThread(this);
}RenderThread::~RenderThread()
{wait();
}void RenderThread::setNewSize(int width, int height)
{QMutexLocker lock(&m_mutex);m_width = width;m_height = height;
}void RenderThread::runTask()
{//qDebug() << "run:" << QThread::currentThreadId();m_renderContext->makeCurrent(m_surface);if(renderer == nullptr){renderer = new Renderer();renderer->moveToThread(this);}int width = 0;int height = 0;{QMutexLocker lock(&m_mutex);width = m_width;height = m_height;}renderer->render(width, height);FpsCounter::instance()->frame(FpsCounter::Render);m_renderContext->doneCurrent();emit imageReady(renderer->front_fbo.texture);
}