Sur cette page

Material QML Type

Base abstraite non créable pour les matériaux. En savoir plus…

Ce type est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Description détaillée

Un « Material » permet de spécifier le rendu d'une « entity ». N'importe quel aspect peut définir son propre sous-type de « Material », de sorte qu'un « Material » puisse être utilisé pour décrire un élément visuel ; par exemple, la façon dont le son doit se répercuter sur un élément, la température d'une surface, etc.

En soi, un « Material » ne fait rien. Ce n’est que lorsqu’il fait référence à un nœud « Effect » qu’un « Material » devient utile.

En pratique, il arrive souvent qu’un même « Effect » soit référencé par plusieurs composants « Material ». Cela permet de ne créer l’effet, les techniques, les passes et les shaders qu’une seule fois, tout en permettant de spécifier le « Material » en ajoutant des instances de « Parameter ».

Un paramètre défini sur un « Matériau » remplace le paramètre (du même nom) défini dans un « Effet », une « Technique » et une « RenderPass », mais il est lui-même remplacé par les paramètres de RenderPassFilter et TechniqueFilter.

Effect {
    id: effect

    techniques: [
        Technique {
            id: gl3Technique
            graphicsApiFilter {
                api: GraphicsApiFilter.OpenGL
                profile: GraphicsApiFilter.CoreProfile
                majorVersion: 3
                minorVersion: 1
            }
            renderPasses: [
                RenderPass {
                    id: gl3Pass
                    shaderProgram: ShaderProgram {
                        ...
                    }
                }
            ]
        }
    ]
}

Material {
    id: material1
    parameters: [
        Parameter { name: "color"; value: "green" }
    ]
}

Material {
    id: material2
    parameters: [
        Parameter { name: "color"; value: "white" }
    ]
}

Voir également Effect, Technique et Parameter.

Documentation sur les propriétés

effect : Effect

Définit l'effet à appliquer au matériau.

parameters : list<Parameter>

Contient la liste des paramètres utilisés par le matériau.

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