Sur cette page

Technique QML Type

Encapsule une technique. Plus d'informations...

Import Statement: import Qt3D.Render 2.11
In C++: QTechnique
Inherits:

Node

Status: Deprecated

Propriétés

Description détaillée

Une technique spécifie un ensemble d'objets RenderPass, d'objets FilterKey, d'objets Parameter et d'un objet GraphicsApiFilter qui, ensemble, définissent une technique de rendu que l'API graphique donnée peut effectuer. Les clés de filtrage sont utilisées par TechniqueFilter pour sélectionner des techniques spécifiques dans des parties spécifiques du FrameGraph. Un paramètre défini sur une technique remplace les paramètres (du même nom) définis dans RenderPass, mais qui sont remplacés par des paramètres dans RenderPassFilter, TechniqueFilter, Material et Effect.

Lors de la création d'un effet ciblant plusieurs versions d'une API graphique, il est utile de créer plusieurs nœuds Technique, chacun ayant un graphicsApiFilter défini pour correspondre à l'une des versions ciblées. Au moment de l'exécution, le moteur de rendu Qt3D sélectionnera la Technique la plus appropriée en fonction des versions de l'API graphique prises en charge et (si spécifié) des nœuds FilterKey qui satisfont une TechniqueFilter donnée dans le FrameGraph.

Note : Lors de l'utilisation d'OpenGL comme API graphique pour le rendu, Qt3D s'appuie sur QSurfaceFormat retourné par QSurfaceFormat::defaultFormat() à l'exécution pour décider quelle est la version GL disponible la plus appropriée. Si vous avez besoin de personnaliser le QSurfaceFormat, n'oubliez pas de l'appliquer avec QSurfaceFormat::setDefaultFormat(). Définir QSurfaceFormat sur la vue n'aura probablement aucun effet sur le rendu lié à Qt3D.

Remarque : le nœud technique ne peut pas être désactivé.

Technique {
    id: gl3Technique
    parameters: [
        Parameter { name: "color"; value: "orange" }
    ]
    filterKeys: [
        FilterKey { name: "renderingStyle"; value: "forward" }
    ]
    graphicsApiFilter: {
        api: GraphicsApiFilter.OpenGL
        profile: GraphicsApiFilter.CoreProfile
        majorVersion: 3
        minorVersion: 1
    }
    renderPasses: [
        RenderPass {
            id: firstPass
            shaderProgram: ShaderProgram {
                // ...
            }
        },
        RenderPass {
            id: secondPass
            shaderProgram: ShaderProgram {
                // ...
            }
        }
    ]
}

Voir également Effect, RenderPass, et TechniqueFilter.

Documentation sur les propriétés

filterKeys : list<FilterKey>

Spécifie la liste des clés de filtrage permettant cette technique

graphicsApiFilter : GraphicsApiFilter [read-only]

Spécifie le filtre de l'API graphique utilisé

parameters : list<Parameter>

Spécifie les paramètres utilisés par la technique

renderPasses : list<RenderPass>

Spécifie les passes de rendu utilisées par la technique

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