QuadTextureProvider QML Type

Permet de rendre une texture quadrangulaire à l'aide d'un shader de fragment personnalisé. En savoir plus...

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

Liste de tous les membres, y compris les membres hérités

Propriétés

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)

Description détaillée

Ce type est utilisé pour rendre des textures quadri-dimensions à l'aide d'un code de shader personnalisé, ce qui offre un moyen pratique d'obtenir des textures programmables. En fournissant un shader de fragment et les propriétés souhaitées, un passage est créé et un pipeline de shader est construit à partir des données fournies, en transmettant les propriétés sous forme de valeurs uniformes au shader de fragment.

Fonctions intégrées fournies :

Mot-clé	Type	Description
MAIN		La fonction void MAIN() est le point d'entrée. Cette fonction doit toujours être présente dans le shader de fragment fourni.
INPUT_UV	vec2	Coordonnées UV du fragment actuel. En haut à droite : [1, 1] et en bas à gauche : [0, 0].
OUTPUT_SIZE	vec2	Taille de la texture de sortie.

Les propriétés personnalisées sont mappées à des uniformes. Chaque fois que les valeurs changent, la valeur mise à jour devient visible dans le shader. Ce concept vous est peut-être déjà familier grâce à ShaderEffect.

Le nom de la propriété QML et celui de la variable GLSL doivent correspondre. Il n’y a pas de déclaration distincte dans le code du shader pour les uniformes individuels. Le nom de la propriété QML peut plutôt être utilisé tel quel.

Le tableau suivant répertorie les correspondances entre les types :

Type QML	Type de shader	Remarques
real, int, bool	float, int, bool
couleur	vec4	La conversion sRGB vers linéaire est effectuée implicitement
vector2d	vec2
vecteur3d	vec3
vector4d	vec4
matrice4x4	mat4
quaternion	vec4	la valeur scalaire est `w`
rect	vec4
point, taille	vec2
TextureInput	sampler2D

Voici un exemple illustrant comment générer une texture rouge simple :

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

Autre exemple d'échantillonnage à partir d'une propriété « Texture » et de mélange avec des couleurs 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"
        }
    }
}

Le résultat est le suivant :

Grille 2x2 composée de cellules remplies d'un dégradé de couleurs : bleu sarcelle, blanc, bleu et magenta

Remarque : la fourniture d'un shader de sommets n'est pas prise en charge, seul un shader de fragments est autorisé.

Remarque : si des propriétés « Texture » sont fournies, le rendu n’aura lieu que lorsque les textures dépendantes seront disponibles.

Remarque : il n’est actuellement pas possible d’ajouter ou de supprimer des propriétés à l’exécution ; seules les propriétés d’origine peuvent être modifiées.

Voir également ShaderEffect.