QuadTextureProvider QML Type

用于通过自定义片段着色器渲染四边形纹理。更多...

• 所有成员的列表，包括继承的成员

属性

• format : enumeration (since 6.12)
• fragmentShader : url (since 6.12)
• fragmentShaderCode : string (since 6.12)
• height : int (since 6.12)
• width : int (since 6.12)

详细说明

此类型用于通过自定义着色器代码渲染四边形纹理，从而提供了一种便捷的方式来获取可编程纹理。通过提供片段着色器和所需属性，系统将创建一个渲染通道，并基于所提供的数据构建着色器管道，将这些属性作为uniform值传递给片段着色器。

提供的内置功能：

自定义属性会被映射到uniform变量上。每当值发生变化时，更新后的值将在着色器中显示出来。您可能已经通过ShaderEffect 了解过这一概念。

QML 属性名称与 GLSL 变量名称必须一致。着色器代码中无需为各个 uniform 进行单独声明，而是可以直接使用 QML 属性名称。

下表列出了类型映射关系：

以下是一个输出简单红色纹理的示例：

Texture {
    textureProvider: QuadTextureProvider {
        width: 128
        height: 128
        fragmentShaderCode: `
            void MAIN() {
                FRAGCOLOR = vec4(1.0, 0.0, 0.0, 1.0);
            }
        `
    }
}

另一个示例是从Texture 属性中采样，并将其与UV颜色混合：

Texture {
    textureProvider: QuadTextureProvider {
        fragmentShaderCode: `
        void MAIN() {
            vec2 uv = INPUT_UV;
            vec4 c = texture(checkers, uv);
            FRAGCOLOR = mix(c, vec4(uv, 1, 1), 0.5);
        }`

        property Texture checkers : Texture {
            source: "../shared/maps/checkers2.png"
        }
    }
}

结果如下：

另请参阅 ShaderEffect 。

属性文档

format : enumeration [default: TexureData.RGBA16F, since 6.12]

该属性指定输出纹理的格式。

该属性在 Qt 6.12 中引入。

fragmentShader : url [since 6.12]

指定包含自定义片段着色器代码片段的文件。

该值是一个 URL，必须是本地文件，或者使用 qrc 方案访问通过 Qt 资源系统嵌入的文件。也接受相对文件路径（不带方案），在这种情况下，该文件将被视为相对于组件（即.qml 文件）的相对路径。

该属性自 Qt 6.12 起引入。

另请参阅 fragmentShaderCode 。

fragmentShaderCode : string [since 6.12]

指定一段自定义片段着色器代码。

用于将着色器代码以内联字符串的形式嵌入，而非提供文件。

该属性在 Qt 6.12 中引入。

另请参阅 fragmentShader 。

height : int [default: 128, since 6.12]

指定输出纹理的高度（以像素为单位）。

该属性自 Qt 6.12 起引入。

另请参阅 width 。

width : int [default: 128, since 6.12]

指定输出纹理的宽度（以像素为单位）。

该属性于 Qt 6.12 版本中引入。

另请参阅 height 。