Sur cette page

QQuick3DRenderExtension Class

Classe abstraite pour la mise en œuvre d'extensions de rendu côté utilisateur. Plus d'informations...

Header: #include <QQuick3DRenderExtension>
Since: Qt 6.7
In QML: RenderExtension
Inherits: QQuick3DObject
Inherited By:

QQuick3DTextureProviderExtension

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. Le côté back-end est implémenté dans QSSGRenderExtension. La classe QQuick3DRenderExtension est utilisée pour créer une extension de rendu personnalisée qui peut être utilisée dans le graphe de scène QtQuick3D en l'ajoutant à la liste des extensions à utiliser avec View3D. Le code de l'extension sera ensuite 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 mettre en œuvre la fonction QQuick3DRenderExtension::updateSpatialNode() et renvoyer une instance QSSGRenderExtension contenant le code à exécuter.

Voir également QSSGRenderExtension.

Documentation sur les fonctions membres

[override virtual] QSSGRenderGraphObject *QQuick3DRenderExtension::updateSpatialNode(QSSGRenderGraphObject *node)

Cette fonction est appelée pendant la synchronisation du graphe de scène 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 qui contient le code à exécuter pendant l'exécution du pipeline de rendu de QtQuick3D.

Le paramètre node est la précédente instance QSSGRenderExtension renvoyée par cette fonction, ou null s'il s'agit de la première fois que la fonction est appelée. 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 appartient 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.