Auf dieser Seite

Parameter QML Type

Bietet Speicherplatz für ein Name-Wert-Paar. Dies entspricht einer Shader-Uniform. Mehr...

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

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

Eigenschaften

Ausführliche Beschreibung

Ein Parameter kann von einem „ RenderPass “, einer „Technique“, einem „Effect“, einem „Material“, einem „ TechniqueFilter “ oder einem „ RenderPassFilter “ referenziert werden. Zur Laufzeit wird der in einem Parameter enthaltene Wert – je nachdem, welcher Shader für einen bestimmten Schritt des Renderings ausgewählt wurde – konvertiert und hochgeladen, sofern der Shader ein „Uniform“ enthält, dessen Name mit dem des Parameters übereinstimmt.

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;

Hinweis: Es istdarauf zu achten, dass der von einem Parameter umschlossene Wert tatsächlich in das Format konvertiert werden kann, das das eigentliche Uniform erwartet. Die Übergabe eines als `int` gespeicherten Werts, wenn das eigentliche Shader-Uniform vom Typ `float` ist, kann zu undefiniertem Verhalten führen.

Hinweis: Wenn es sich bei der Ziel-Uniform um ein Array handelt, sollte der Name dem Namen der Uniform mit dem Anhang [0] entsprechen.

Hinweis: DerParameter -Knoten kann nicht deaktiviert werden.

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];

Was die Texturunterstützung betrifft, sollte der Parameterwert auf die entsprechende Unterklasse von „ texture “ gesetzt werden, die dem Sampler-Typ des Shader-Uniforms entspricht.

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

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

Siehe auch „ Qt3DRender::QAbstractTexture “.

Dokumentation zu den Eigenschaften

name : string

Gibt den Namen des Parameters an

value : QVariant

Gibt den Wert des Parameters an

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