Qt3DRender::QSetFence Class
class Qt3DRender::QSetFenceFrameGraphNode utilisé pour insérer une clôture dans le flux de commandes graphiques. En savoir plus...
| En-tête : | #include <qsetfence.h> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake : | QT += 3drender |
| Hérite de : | Qt3DRender::QFrameGraphNode |
| Statut : | Obsolète |
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Propriétés
- handle : QVariant
- handleType : HandleType
Fonctions publiques
| QVariant | handle() const |
| Qt3DRender::QSetFence::HandleType | handleType() const |
Signaux
| void | handleChanged(QVariant handle) |
| void | handleTypeChanged(Qt3DRender::QSetFence::HandleType handleType) |
Description détaillée
Les barrières permettent de synchroniser les charges de travail du GPU et du CPU. Les commandes GPU sont généralement non bloquantes. Une fois émises, elles sont insérées dans des tampons de commandes qui seront lus ultérieurement par le GPU. Dans certains cas, vous souhaitez poursuivre le traitement ou émettre une commande spécifique uniquement lorsque vous êtes certain qu'une commande a bien été exécutée par le matériel. Les barrières (fences) permettent d'y parvenir. Cela est particulièrement important lors de l'utilisation de moteurs tiers avec Qt3D : Qt3D ne doit accéder aux ressources partagées que lorsque l'on sait que les commandes de l'autre moteur ont fini de modifier la ressource.
QSetFence est un nœud FrameGraph qui insère une barrière dans le flux de commandes. Il peut ensuite être utilisé conjointement avec QWaitFence ou en extrayant le descripteur sous-jacent.
La propriété `handle` sera mise à jour une fois que le moteur de rendu aura créé la ressource de barrière sous-jacente. Le descripteur restera valide tant qu’il se trouvera à l’état « unsignaled ». Une fois qu’il aura atteint l’état « signaled », il sera détruit et un nouveau descripteur sera créé. Cela signifie que, selon le temps nécessaire pour que la barrière soit signalée, le même descripteur pourrait être utilisé sur plusieurs images.
Documentation de la propriété
[read-only] handle : QVariant
Contient le descripteur de la barrière sous-jacente encapsulé dans un objet de type ` QVariant`.
Fonctions d'accès :
| QVariant | handle() const |
Signal de notification :
| void | handleChanged(QVariant handle) |
[read-only] handleType : HandleType
Spécifie le type de descripteur utilisé. Actuellement, seuls les identifiants Fence OpenGL sont pris en charge.
Fonctions d'accès :
| Qt3DRender::QSetFence::HandleType | handleType() const |
Signal de notification :
| void | handleTypeChanged(Qt3DRender::QSetFence::HandleType handleType) |
© 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.