BlitFramebuffer QML 类型详解-CSDN博客

本文链接：https://blog.csdn.net/qq_43689451/article/details/147619247

BlitFramebuffer QML 类型详解

BlitFramebuffer 是 Qt Quick 的高级渲染组件，属于 Qt Quick Scene Graph 框架的一部分。它主要用于在不同的 framebuffer 之间执行高效的内容复制操作（位块传输）。这个组件在需要执行高级渲染技术、离屏渲染或优化性能时非常有用。

基本概念

Framebuffer（帧缓冲区）是存储图像数据的内存区域，包含完整的帧图像信息。BlitFramebuffer 允许将一个 framebuffer 的内容复制到另一个 framebuffer，同时可以应用各种变换和过滤操作。

在 QML 中导入

import QtQuick 2.15
import QtQuick.SceneGraph 2.15

主要属性

基本属性

source: 源 framebuffer 对象或纹理
destination: 目标 framebuffer 对象
sourceRect: 定义源 framebuffer 中要复制的矩形区域
destinationRect: 定义目标 framebuffer 中要放置内容的矩形区域
enabled: 布尔值，指定是否启用位块传输操作

过滤与变换属性

filtering: 定义内容缩放时使用的过滤方法
- BlitFramebuffer.Nearest: 最近邻过滤（默认）
- BlitFramebuffer.Linear: 线性过滤
rotation: 指定内容复制时应用的旋转（0, 90, 180, 或 270 度）
mirrored: 布尔值，指定是否在复制过程中水平镜像内容

缓冲区选择属性

sourceAttachment: 指定源 framebuffer 中使用的附件
- BlitFramebuffer.Color: 颜色缓冲区（默认）
- BlitFramebuffer.Depth: 深度缓冲区
- BlitFramebuffer.Stencil: 模板缓冲区
destinationAttachment: 指定目标 framebuffer 中使用的附件

使用示例

基本使用

import QtQuick 2.15
import QtQuick.Window 2.15
import QtQuick.Controls 2.15
import QtQuick.SceneGraph 2.15

Window {
    visible: true
    width: 800
    height: 600
    
    // 源内容
    Rectangle {
        id: sourceRect
        width: 400
        height: 300
        color: "blue"
        visible: false // 不直接显示
        
        Text {
            anchors.centerIn: parent
            text: "源内容"
            color: "white"
            font.pixelSize: 24
        }
    }
    
    // 使用 ShaderEffectSource 捕获源内容
    ShaderEffectSource {
        id: shaderSource
        sourceItem: sourceRect
        textureSize: Qt.size(sourceRect.width, sourceRect.height)
        hideSource: true
    }
    
    // 目标区域
    Rectangle {
        id: targetArea
        width: 400
        height: 300
        anchors.centerIn: parent
        color: "transparent"
        border.color: "red"
        border.width: 2
    }
    
    // 使用 BlitFramebuffer 复制内容
    BlitFramebuffer {
        id: blitter
        source: shaderSource
        sourceRect: Qt.rect(0, 0, sourceRect.width, sourceRect.height)
        destinationRect: Qt.rect(targetArea.x, targetArea.y, targetArea.width, targetArea.height)
        filtering: BlitFramebuffer.Linear
    }
    
    // 控制面板
    Column {
        anchors.right: parent.right
        anchors.top: parent.top
        anchors.margins: 10
        spacing: 10
        
        Button {
            text: "旋转 90°"
            onClicked: blitter.rotation = (blitter.rotation + 90) % 360
        }
        
        Button {
            text: "切换镜像"
            onClicked: blitter.mirrored = !blitter.mirrored
        }
        
        Button {
            text: "切换过滤方式"
            onClicked: {
                if (blitter.filtering === BlitFramebuffer.Nearest)
                    blitter.filtering = BlitFramebuffer.Linear
                else
                    blitter.filtering = BlitFramebuffer.Nearest
            }
        }
    }
}

高级应用场景

1. 离屏渲染

使用 BlitFramebuffer 将内容渲染到离屏 framebuffer，然后再复制到屏幕上，可以实现一些复杂的效果或避免重复渲染。

2. 多重采样抗锯齿 (MSAA)

可以将内容渲染到多重采样 framebuffer，然后使用 BlitFramebuffer 将结果解析到常规 framebuffer。

BlitFramebuffer {
    source: msaaFramebuffer
    destination: regularFramebuffer
    sourceRect: Qt.rect(0, 0, width, height)
    destinationRect: Qt.rect(0, 0, width, height)
}

3. 深度/模板缓冲区操作

可以单独复制深度或模板缓冲区：

BlitFramebuffer {
    source: sourceFramebuffer
    destination: targetFramebuffer
    sourceRect: Qt.rect(0, 0, width, height)
    destinationRect: Qt.rect(0, 0, width, height)
    sourceAttachment: BlitFramebuffer.Depth
    destinationAttachment: BlitFramebuffer.Depth
}

性能考虑

BlitFramebuffer 通常比使用着色器效果更高效，因为它直接使用 GPU 硬件加速的 blit 操作
对于大型纹理或需要频繁更新的内容，它可以显著提高性能
在移动设备上，使用 BlitFramebuffer 可以减少 GPU 功耗

限制与注意事项

源和目标 framebuffer 的格式必须兼容
不是所有的 GPU 都支持所有的 blit 操作（例如旋转或过滤）
当使用深度或模板缓冲区时，可能存在格式和大小限制
在一些低端设备上，可能不支持某些高级功能

与其他渲染组件的集成

BlitFramebuffer 可以与其他 Qt Quick 渲染组件结合使用：

ShaderEffectSource: 捕获 QML 项的内容作为纹理
Layer: 提供项及其子项的离屏缓冲区
Item: 可以将任何 QML 项渲染到纹理，然后用作 BlitFramebuffer 的源

通过组合这些工具，可以实现丰富的视觉效果，同时保持良好的性能。

BlitFramebuffer 是 Qt Quick 渲染框架中的一个非可视化元素，它的核心功能是在两个 帧缓冲对象 (Framebuffer Objects - FBOs) 之间快速复制像素数据（颜色、深度、模板）。“Blit” 这个词来源于计算机图形学，通常指一种优化的、通常由硬件加速的块数据传输操作。

核心用途:

BlitFramebuffer 主要用于高级或自定义渲染场景，例如：

后处理效果 (Post-processing): 将主场景渲染到一个 FBO，然后使用 BlitFramebuffer（可能结合 ShaderEffect）将数据复制并处理到另一个 FBO 或最终屏幕，以实现模糊、辉光 (bloom)、颜色校正等效果。
渲染到纹理 (Render-to-Texture): 将场景的一部分或中间结果渲染到一个 RenderTarget (它内部管理 FBO)，然后可能需要将这个结果复制到另一个 RenderTarget 或最终显示出来。
多重渲染目标 (Multiple Render Targets - MRT) 的组合: 如果你将场景的不同部分（如颜色、法线、深度）渲染到不同的纹理附件中，BlitFramebuffer 可以用来将这些附件的部分或全部内容复制到其他地方。
优化: 在某些情况下，如果渲染结果可以复用，可以先渲染到一个 FBO，然后通过 BlitFramebuffer 多次快速地将结果绘制到屏幕的不同位置，避免重复渲染。
降采样/升采样: 通过设置不同的源和目标矩形，可以实现图像的快速缩放，常用于为某些效果（如辉光）创建低分辨率版本。

关键属性:

source : RenderTarget / Texture
- 指定要从中复制数据的源。这通常是一个 RenderTarget QML 类型，也可以是一个 Texture 对象（例如 Image 的纹理或 TextureProvider 提供的纹理）。
destination : RenderTarget
- 指定要将数据复制到的目标 RenderTarget。如果省略，它通常会尝试 blit 到当前正在渲染的目标（但这不太常用，通常你会明确指定目标 FBO）。
sourceRectangle : rect
- 定义从 source FBO 中复制的矩形区域 (x, y, width, height)。如果省略，则复制整个源。
destinationRectangle : rect
- 定义要将数据复制到 destination FBO 的矩形区域 (x, y, width, height)。如果省略，则使用与 sourceRectangle 相同的尺寸和位置（相对于目标 FBO）。如果尺寸不同，会发生缩放。
components : enum
- 指定要复制的缓冲区组件。可以是以下值的组合 (使用位或 | 操作符):
  - BlitFramebuffer.ColorBuffer: 复制颜色缓冲区。
  - BlitFramebuffer.DepthBuffer: 复制深度缓冲区。
  - BlitFramebuffer.StencilBuffer: 复制模板缓冲区。
- 默认是 ColorBuffer。注意：复制深度/模板缓冲区可能需要源和目标 FBO 具有兼容的深度/模板附件格式。
filter : enum
- 指定当 sourceRectangle 和 destinationRectangle 尺寸不同时使用的纹理过滤（插值）方法：
  - BlitFramebuffer.Nearest: 最近邻插值（速度快，可能产生像素化）。
  - BlitFramebuffer.Linear: 线性插值（效果平滑，开销稍高）。
- 默认是 Nearest。
enabled : bool
- 控制此 Blit 操作是否执行。默认为 true。

如何使用:

BlitFramebuffer 本身不是一个可视化的 QML Item，它是一个在 QML 场景图渲染过程中执行的操作。它通常放置在以下位置：

作为 RenderTarget 的子项: 当你想要在渲染到某个 RenderTarget 后立即对其内容进行 blit 操作时。

import QtQuick 2.15
import QtQuick.Window 2.15

Window {
    width: 800
    height: 600
    visible: true

    RenderTarget {
        id: sourceFbo
        // ... 配置 RenderTarget ...

        // 在渲染到 sourceFbo 后，将其内容 blit 到 destinationFbo
        BlitFramebuffer {
            destination: destinationFbo
            // source: sourceFbo // 可以省略，因为是父项
            // sourceRectangle, destinationRectangle, components, filter 按需设置
        }
    }

    RenderTarget {
        id: destinationFbo
        // ... 配置 RenderTarget ...
    }

    // 可能还需要一个 ShaderEffect 或其他方式来显示 destinationFbo 的内容
    ShaderEffect {
        anchors.fill: parent
        property var textureSource: destinationFbo
        // ... Shader code to sample textureSource ...
    }
}

在 Item 的 beforeRendering 或 afterRendering 信号处理器中: 用于在特定 Item 渲染之前或之后执行 blit 操作。这比较少见，通常 FBO 操作封装在 RenderTarget 中更清晰。
在自定义 QSGNode 中 (C++): 对于非常底层的控制，可以在 C++ 中创建自定义场景图节点，并在其 preprocess() 或更新逻辑中使用 QSGBlitFramebufferNode。

重要注意事项:

性能: Blit 操作通常比重新渲染整个场景要快得多，尤其是当它由图形硬件加速时。但是，频繁或大规模的 Blit 操作仍然会有性能开销。
依赖: BlitFramebuffer 依赖于底层的图形 API（OpenGL, Vulkan, Metal, Direct3D）对 Blit 操作的支持。大多数现代硬件都支持。
FBO 状态: Blit 操作发生时，源和目标 FBO 必须是有效的并且已正确设置（例如，具有兼容的格式）。RenderTarget QML 类型通常会为你处理这些细节。
复杂性: BlitFramebuffer 是一个相对底层的渲染工具，主要用于需要精细控制渲染流程的场景。对于简单的 UI 布局和显示，通常不需要直接使用它。

总结:

BlitFramebuffer 是 QML 中一个强大的、用于在帧缓冲对象之间高效复制像素数据的非可视化元素。它是实现高级渲染技术（如后处理、渲染到纹理、优化）的关键构件，允许开发者更灵活地控制渲染管线。然而，它的使用通常涉及对渲染流程和 FBO 有一定的理解。