QSSGRenderHelpers Class
Classe contenant des fonctions d'aide pour la configuration et le rendu de QtQuick3D. Plus...
| Header: | #include <QSSGRenderHelpers> |
| Since: | Qt 6.7 |
Types publics
| enum class | CreateFlag { None, Recurse, Steal } |
| flags | CreateFlags |
Membres publics statiques
| QSSGPrepResultId | commit(const QSSGFrameData &frameData, QSSGPrepContextId prepId, QSSGRenderablesId renderablesId, float lodThreshold = 1.0f) |
| QSSGRenderablesId | createRenderables(const QSSGFrameData &frameData, QSSGPrepContextId prepId, const QSSGNodeIdList &nodes, QSSGRenderHelpers::CreateFlags flags = CreateFlag::None) |
| QSSGPrepContextId | prepareForRender(const QSSGFrameData &frameData, const QSSGRenderExtension &ext, QSSGCameraId cameraId, quint32 slot = 0) |
| void | prepareRenderables(const QSSGFrameData &frameData, QSSGPrepResultId prepId, QRhiRenderPassDescriptor *renderPassDescriptor, QSSGRhiGraphicsPipelineState &ps, QSSGRenderablesFilters filter = QSSGRenderablesFilter::All) |
| void | renderRenderables(const QSSGFrameData &frameData, QSSGPrepResultId prepId) |
Documentation des types de membres
enum class QSSGRenderHelpers::CreateFlag
flags QSSGRenderHelpers::CreateFlags
| Constante | Valeur | Description de la constante |
|---|---|---|
QSSGRenderHelpers::CreateFlag::None | 0 | La valeur par défaut. Les rendus sont créés uniquement pour les nœuds spécifiés. |
QSSGRenderHelpers::CreateFlag::Recurse | 0x1 | Les rendus sont créés pour chaque nœud et leurs enfants. |
QSSGRenderHelpers::CreateFlag::Steal | 0x2 | Les rendus sont pris dans le moteur et ne seront pas rendus par QtQuick3D. |
Remarque : L'appel à QSSGRenderHelpers::createRenderables() sans l'indicateur {QSSGRenderHelpers::CreateFlag::Steal}{Steal} signifie que les noeuds sont dupliqués et que QtQuick3D effectuera le rendu de sa copie des noeuds comme d'habitude.
Le type CreateFlags est un typedef pour QFlags<CreateFlag>. Il stocke une combinaison OU de valeurs CreateFlag.
Documentation des fonctions membres
[static] QSSGPrepResultId QSSGRenderHelpers::commit(const QSSGFrameData &frameData, QSSGPrepContextId prepId, QSSGRenderablesId renderablesId, float lodThreshold = 1.0f)
Une fois que les modifications nécessaires ont été apportées aux objets à rendre, les données peuvent être marquées comme étant prêtes pour le moteur de rendu.
Renvoie un identifiant au résultat de la préparation.
frameDataVOIR AUSSI : prepId, renderablesId, lodThreshold
Voir aussi prepareRenderables() et renderRenderables().
[static] QSSGRenderablesId QSSGRenderHelpers::createRenderables(const QSSGFrameData &frameData, QSSGPrepContextId prepId, const QSSGNodeIdList &nodes, QSSGRenderHelpers::CreateFlags flags = CreateFlag::None)
Prend une liste d'identifiants de nœuds et crée des objets à rendre qui peuvent être traités par le moteur de rendu. S'il n'y a pas de nœuds, ou pas de nœuds pouvant être rendus dans la liste, l'identifiant retourné sera invalide.
Par défaut, la fonction n'effectue pas de récursivité vers le bas et inclut les enfants de nodes dans la liste. Il est possible d'activer la récursivité en passant le drapeau Recurse dans l'argument flags.
Renvoie un identifiant pour les objets à rendre créés.
frameData, prepId
Voir aussi CreateFlags et prepareForRender().
[static] QSSGPrepContextId QSSGRenderHelpers::prepareForRender(const QSSGFrameData &frameData, const QSSGRenderExtension &ext, QSSGCameraId cameraId, quint32 slot = 0)
prepareForRender() crée un contexte pour collecter et stocker des informations sur les données de rendu associées à cette extension de rendu.
Si les mêmes nœuds doivent être rendus plus d'une fois mais avec des propriétés différentes, par exemple un matériau ou une caméra différents, un nouveau contexte sera nécessaire. Pour créer plusieurs contextes pour une même extension, l'argument slot peut être utilisé. Le contexte par défaut est créé dans le slot 0.
Renvoie un identifiant au contexte de préparation.
frameDataIL S'AGIT DE L'ARGUMENT SUIVANT : ext, cameraId
Voir aussi commit().
[static] void QSSGRenderHelpers::prepareRenderables(const QSSGFrameData &frameData, QSSGPrepResultId prepId, QRhiRenderPassDescriptor *renderPassDescriptor, QSSGRhiGraphicsPipelineState &ps, QSSGRenderablesFilters filter = QSSGRenderablesFilter::All)
Prépare les données d'appel au dessin nécessaires pour les objets à rendre avant d'appeler renderRenderables.
Renvoie un identifiant au résultat de la préparation.
frameDataIL EST ÉGALEMENT POSSIBLE D'UTILISER LES FONCTIONS SUIVANTES : renderPassDescriptor, ps, prepId, filter
Voir aussi renderRenderables().
[static] void QSSGRenderHelpers::renderRenderables(const QSSGFrameData &frameData, QSSGPrepResultId prepId)
Effectuer le rendu des objets à rendre.
frameData, prepId
Voir aussi prepareRenderables().
© 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.
