En esta página

QuadTextureProvider QML Type

Se utiliza para renderizar una textura de cuadrilátero mediante un sombreador de fragmentos personalizado. Más información...

Import Statement: import QtQuick3D.Helpers
Since: Qt 6.12
Inherits:

TextureProviderExtension

Propiedades

Descripción detallada

Este tipo se utiliza para renderizar texturas de cuádrupos mediante código de sombreador personalizado, lo que ofrece una forma cómoda de obtener texturas programables. Al proporcionar un sombreador de fragmentos y las propiedades deseadas, se crea una pasada y se construye un canal de sombreador basado en los datos proporcionados, pasando las propiedades como valores uniformes al sombreador de fragmentos.

Funciones integradas disponibles:

Palabra claveTipoDescripción
MAINvoid MAIN() es el punto de entrada. Esta función debe estar siempre presente en el sombreador de fragmentos proporcionado.
INPUT_UVvec2Coordenadas UV del fragmento actual. Arriba a la derecha: [1, 1] y abajo a la izquierda: [0, 0].
OUTPUT_SIZEvec2Tamaño de la textura de salida.

Las propiedades personalizadas se asignan a uniformes. Cada vez que cambien los valores, el valor actualizado se hará visible en el shader. Es posible que ya estés familiarizado con este concepto gracias a ShaderEffect.

El nombre de la propiedad QML y el de la variable GLSL deben coincidir. No hay una declaración separada en el código del shader para cada uniforme individual. En su lugar, el nombre de la propiedad QML se puede utilizar tal cual.

La siguiente tabla muestra cómo se asignan los tipos:

Tipo QMLTipo de sombreadorNotas
real, int, boolfloat, int, bool
colorvec4La conversión de sRGB a lineal se realiza de forma implícita
vector2dvec2
vector3dvec3
vector4dvec4
matriz4x4mat4
cuaterniónvec4valor escalar es w
rectvec4
punto, tamañovec2
TextureInputsampler2D

Un ejemplo de cómo generar una textura roja sencilla podría hacerse de la siguiente manera:

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

Otro ejemplo de muestreo a partir de una propiedad « Texture » y mezcla con colores 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"
        }
    }
}

El resultado es el siguiente:

Cuadrícula de 2x2 con casillas rellenas con un degradado en verde azulado, blanco, azul y magenta

Nota: No se admiteel uso de un sombreador de vértices, solo un sombreador de fragmentos.

Nota: Si se proporcionan propiedades de « Texture », no se renderizará hasta que las texturas dependientes estén disponibles.

Nota: Actualmente nose admite añadir ni eliminar propiedades en tiempo de ejecución, solo modificar las originales.

Véase también ShaderEffect.

Documentación de propiedades

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

Esta propiedad define el formato de la textura de salida.

ConstanteDescripción
TexureData.RGBA8El formato de color se considera un entero de 8 bits en los canales R, G, B y alfa.
TexureData.RGBA16FEl formato de color se considera como un número flotante de 16 bits en los canales R, G, B y alfa.
TexureData.RGBA32FEl formato de color se considera un número de 32 bits en formato flotante en los canales R, G, B y alfa.
TexureData.RGBE8El formato de color se considera una mantisa de 8 bits en los canales R, G y B, y un exponente compartido de 8 bits.
TexureData.R8El formato de color se considera un entero de 8 bits en el canal R.
TexureData.R16El formato de color se considera un entero de 16 bits en el canal R.
TexureData.R16FEl formato de color se considera un número flotante de 16 bits en el canal R.
TexureData.R32FEl formato de color se considera un número de coma flotante de 32 bits en el canal R.

Nota: A excepción de TexureData.RGBA8, no todos los formatos son compatibles en tiempo de ejecución, ya que esto depende tanto del backend como del hardware que se utilice.

Esta propiedad se introdujo en Qt 6.12.

fragmentShader : url [since 6.12]

Especifica el archivo que contiene el fragmento de código personalizado del sombreador de fragmentos.

El valor es una URL y debe ser un archivo local o utilizar el esquema qrc para acceder a archivos incrustados a través del sistema de recursos de Qt. También se aceptan rutas de archivo relativas (sin esquema); en ese caso, el archivo se considera relativo al componente (el archivo .qml ).

Advertencia: Se da por hecho que los fragmentosde sombreador son contenido de confianza. Se recomienda a los desarrolladores de aplicaciones que sopesen cuidadosamente las posibles implicaciones antes de permitir la carga de contenido proporcionado por el usuario que no forme parte de la aplicación.

Nota: Si se establece, fragmentShaderCode tendrá prioridad sobre fragmentShader.

Esta propiedad se introdujo en Qt 6.12.

Véase también ` fragmentShaderCode`.

fragmentShaderCode : string [since 6.12]

Especifica un fragmento de código de shader de fragmentos personalizado.

Se utiliza para incluir código de sombreador como cadena en lugar de proporcionar un archivo.

Nota: Si se establece, esta propiedad tendrá prioridad sobre ` fragmentShader`.

Esta propiedad se introdujo en Qt 6.12.

Véase también « fragmentShader ».

height : int [default: 128, since 6.12]

Especifica la altura, en píxeles, de la textura de salida.

Esta propiedad se introdujo en Qt 6.12.

Véase también width.

width : int [default: 128, since 6.12]

Especifica el ancho, en píxeles, de la textura de salida.

Esta propiedad se introdujo en Qt 6.12.

Véase también height.

© 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.