QQuick3DRenderExtension Class
Classe abstraite permettant de mettre en œuvre des extensions de rendu côté utilisateur. En savoir plus…
| Header: | #include <QQuick3DRenderExtension> |
| Since: | Qt 6.7 |
| In QML: | RenderExtension |
| Inherits: | QQuick3DObject |
| Inherited By: |
Fonctions publiques réimplémentées
| virtual QSSGRenderGraphObject * | updateSpatialNode(QSSGRenderGraphObject *node) override |
Description détaillée
Il s'agit de la partie frontale d'une extension de rendu. La partie back-end est implémentée dans ` QSSGRenderExtension`. La classe `QQuick3DRenderExtension` sert à créer une extension de rendu personnalisée pouvant être utilisée dans le graphe de scène d’ QtQuick3D, en l’ajoutant à la liste des extensions à utiliser avec un ` View3D`. Le code de l’extension sera alors exécuté dans le cadre de l’exécution du pipeline de rendu de ` QtQuick3D`.
La classe QQuick3DRenderExtension est une classe abstraite qui doit être sous-classée et exposée à QML. La sous-classe doit implémenter la fonction QQuick3DRenderExtension::updateSpatialNode() et renvoyer une instance de QSSGRenderExtension contenant le code à exécuter.
Voir également QSSGRenderExtension.
Documentation des fonctions membres
[override virtual] QSSGRenderGraphObject *QQuick3DRenderExtension::updateSpatialNode(QSSGRenderGraphObject *node)
Cette fonction est appelée lors de la synchronisation du graphe de scène d’ QtQuick3D, lorsqu’un élément est créé ou lorsqu’une mise à jour est demandée, généralement à la suite d’une modification des propriétés de l’élément. La fonction doit renvoyer une instance QSSGRenderExtension contenant le code à exécuter pendant l’exécution du pipeline de rendu d’ QtQuick3D.
Le paramètre ` node ` correspond à l’instance ` QSSGRenderExtension ` précédente renvoyée par cette fonction, ou à `null` s’il s’agit du premier appel de la fonction. La fonction peut renvoyer la même instance, une instance différente ou `null`. Si la fonction renvoie `null`, l’extension sera supprimée du pipeline de rendu.
Remarque : l’instance ` QSSGRenderExtension ` est un objet ressource et appartiendra au graphe de scène ` QtQuick3D `. Si une instance différente, ou `null`, est renvoyée, l’instance précédente sera mise en file d’attente pour être supprimée par le moteur de rendu.
Voir également QSSGRenderExtension.
© 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.
