qt QOffscreenSurface详解

news2025/4/21 13:22:16

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);
}