QQuick3DTextureProviderExtension Class
Classe abstraite pour la mise en œuvre d'extensions de fournisseurs de textures côté utilisateur. Plus d'informations...
| Header: | #include <QQuick3DTextureProviderExtension> |
| Since: | Qt 6.11 |
| In QML: | TextureProviderExtension |
| Inherits: | QQuick3DRenderExtension |
Propriétés
(since 6.11)samplerHint : SamplerHint
Fonctions publiques
| QQuick3DTextureProviderExtension::SamplerHint | samplerHint() const |
| void | setSamplerHint(QQuick3DTextureProviderExtension::SamplerHint newSamplerHint) |
Signaux
| void | samplerHintChanged() |
Fonctions protégées 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 fournisseur de texture. Le côté back-end est implémenté dans QSSGRenderExtension. La QQuick3DTextureProviderExtension est une spécialisation de la classe QQuick3DRenderExtension qui est utilisée pour créer une extension de fournisseur de texture personnalisée qui peut à la fois fournir des métadonnées supplémentaires sur le type de texture qui sera fourni et enregistrer automatiquement l'extension avec le graphe de scène QtQuick3D. Cela signifie qu'il n'est pas nécessaire d'ajouter manuellement l'extension à la liste des extensions à utiliser avec View3D, et qu'il suffit d'utiliser la propriété textureProvider du composant Texture pour déclencher l'exécution du code de l'extension lorsque cela est nécessaire.
La classe QQuick3DTextureProviderExtension 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 QSSGRenderExtension contenant le code à exécuter.
Voir également QSSGRenderExtension.
Documentation sur les propriétés
[since 6.11] samplerHint : SamplerHint
Cette propriété contient un indice sur le type de texture qui sera fourni par l'extension. Ceci est nécessaire car les données de texture ne seront fournies qu'en cas de besoin, mais les matériaux qui utilisent le composant Texture doivent savoir quel type d'échantillonneur fournir.
La valeur par défaut est QQuick3DTextureProviderExtension::Sampler2D.
Remarque : cette propriété n'est utilisée que lors de l'utilisation de CustomMaterials.
Cette propriété a été introduite dans Qt 6.11.
Fonctions d'accès :
| QQuick3DTextureProviderExtension::SamplerHint | samplerHint() const |
| void | setSamplerHint(QQuick3DTextureProviderExtension::SamplerHint newSamplerHint) |
Notifier signal :
| void | samplerHintChanged() |
Voir aussi SamplerHint.
Documentation des fonctions membres
[override virtual protected] QSSGRenderGraphObject *QQuick3DTextureProviderExtension::updateSpatialNode(QSSGRenderGraphObject *node)
Réimplémente : 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 QSSGRenderTextureProviderExtension 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 QSSGRenderTextureProviderExtension 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 QSSGRenderTextureProviderExtension 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 QSSGRenderTextureProviderExtension.
© 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.
