Sur cette page

Parameter QML Type

Permet de stocker une paire nom-valeur. Cela correspond à un uniforme de shader. En savoir plus…

Import Statement: import Qt3D.Render 2.12
In C++: QParameter
Status: Deprecated

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

Propriétés

Description détaillée

Un paramètre peut être référencé par un « RenderPass », une «Technique», un «Effect», un «Material», un « TechniqueFilter » ou un « RenderPassFilter ». Lors de l'exécution, en fonction du shader sélectionné pour une étape donnée du rendu, la valeur contenue dans un paramètre sera convertie et chargée si le shader contient un uniforme dont le nom correspond à celui du paramètre.

Parameter {
    name: "diffuseColor"
    value: "blue"
}

// Works with the following GLSL uniform shader declarations
// uniform vec4 diffuseColor;
// uniform vec3 diffuseColor;
// uniform vec2 diffuseColor;
// uniform float diffuseColor;

Remarque : il convient de veiller à ce que la valeur encapsulée par un paramètre puisse effectivement être convertie en ce qu’attend réellement l’uniform. Attribuer une valeur stockée sous forme d’entier (int) alors que l’uniform du shader est de type flottant (float) pourrait entraîner des comportements indéfini.

Remarque : lorsque l’uniforme cible est un tableau, le nom doit être celui de l’uniforme suivi de [0].

Remarque : le nœud «Parameter » ne peut pas être désactivé.

Parameter {
    name: "diffuseValues[0]"
    value: [0.0, 1.0. 2.0, 3.0, 4.0, 883.0, 1340.0, 1584.0]
}

// Matching GLSL shader uniform  declaration
// uniform float diffuseValues[8];

En ce qui concerne la prise en charge des textures, la valeur du paramètre doit être définie sur la sous-classe appropriée de ` texture ` correspondant au type d’échantillonneur de l’uniform du shader.

Parameter {
    name: "diffuseTexture"
    value: Texture2D { ... }
}

// Works with the following GLSL uniform shader declaration
// uniform sampler2D diffuseTexture

Voir également Qt3DRender::QAbstractTexture.

Documentation des propriétés

name : string

Indique le nom du paramètre

value : QVariant

Spécifie la valeur du paramètre

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