本页内容

Buffer QML Type

创建或引用一个颜色缓冲区,用于效果的某个处理阶段。更多...

Import Statement: import QtQuick3D
Inherits:

QtObject

属性

详细说明

缓冲区(Buffer)可用于创建中间缓冲区,以便在Effect 中,不同渲染通道(render passes )之间共享数据。

注意:如果 缓冲区的name 属性为空,则它将引用渲染通道的默认输出纹理。

属性文档

bufferFlags : enumeration

指定缓冲区分配标志。默认值为 Buffer.None。

常量描述
Buffer.None无特殊行为。
Buffer.SceneLifetime该缓冲区将在整个场景生命周期内被分配。

format : enumeration

指定纹理格式。默认值为 Buffer.RGBA8。

常量值
Buffer.RGBA8
Buffer.RGBA16F
Buffer.RGBA32F
Buffer.R8
Buffer.R16
Buffer.R16F
Buffer.R32F

name : string

指定缓冲区的名称。

注意:当 此属性为空时 ,Buffer 将引用render pass 的默认输出纹理,而非分配一个缓冲区。这有助于覆盖输出的某些设置(例如纹理格式),而无需引入新的、独立的中间纹理。

sizeMultiplier : real

指定缓冲区的大小倍数。例如,值为1.0 时,将创建一个与效果输入纹理大小相同的缓冲区;而0.5 时,将创建一个宽度和高度均为输入纹理一半大小的缓冲区。默认值为1.0。

textureCoordOperation : enumeration

指定在采样超出 [0, 1] 范围时,纹理坐标的行为。默认值为 Buffer.ClampToEdge。

常量描述
Buffer.ClampToEdge将坐标限制在边界上。
Buffer.Repeat在边缘处折返坐标以平铺纹理。
Buffer.MirroredRepeat在边缘处对坐标进行循环,但在平铺纹理时对纹理进行镜像处理。

textureFilterOperation : enumeration

指定采样缓冲区内容时的纹理过滤模式。默认值为 Buffer.Linear。

常量描述
Buffer.Nearest使用最近邻过滤。
Buffer.Linear使用线性过滤。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.