Qt3DRender::Quick::QScene2D Class
class Qt3DRender::Quick::QScene2DCette classe permet de convertir du code QML en texture, qui peut ensuite être intégrée à une scène 3D. En savoir plus...
| En-tête : | #include <Qt3DQuickScene2D/QScene2D> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS 3dquickscene2d) target_link_libraries(mytarget PRIVATE Qt6::3dquickscene2d) |
| qmake : | QT += 3dquickscene2d |
| En QML : | Scene2D |
| Hérite de : | Qt3DCore::QNode |
| Statut : | Obsolète |
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Types publics
| enum | RenderPolicy { Continuous, SingleShot } |
Propriétés
- item : QQuickItem*
- mouseEnabled : bool
- output : Qt3DRender::QRenderTargetOutput*
- renderPolicy : RenderPolicy
Fonctions publiques
| QScene2D(Qt3DCore::QNode *parent = nullptr) | |
| void | addEntity(Qt3DCore::QEntity *entity) |
| QList<Qt3DCore::QEntity *> | entities() const |
| bool | isMouseEnabled() const |
| QQuickItem * | item() const |
| Qt3DRender::QRenderTargetOutput * | output() const |
| void | removeEntity(Qt3DCore::QEntity *entity) |
| Qt3DRender::Quick::QScene2D::RenderPolicy | renderPolicy() const |
Emplacements publics
| void | setItem(QQuickItem *item) |
| void | setMouseEnabled(bool enabled) |
| void | setOutput(Qt3DRender::QRenderTargetOutput *output) |
| void | setRenderPolicy(Qt3DRender::Quick::QScene2D::RenderPolicy policy) |
Signaux
| void | itemChanged(QQuickItem *item) |
| void | mouseEnabledChanged(bool enabled) |
| void | outputChanged(Qt3DRender::QRenderTargetOutput *output) |
| void | renderPolicyChanged(Qt3DRender::Quick::QScene2D::RenderPolicy policy) |
Description détaillée
Cette classe utilise QQuickRenderControl pour rendre l'QQuickItem on donnée sur une surface hors écran, qui est associée à une texture fournie par l'utilisateur. Cela permet au composant de rendre directement dans la texture sans copie intermédiaire et à l'utilisateur de spécifier librement comment la texture est utilisée dans la scène 3D.
Les entités utilisant QScene2D peuvent être associées à la classe pour permettre l’interaction avec l’élément ; si une entité dispose d’un composant « QObjectPicker », les événements de sélection provenant de ce sélecteur sont envoyés à QScene2D, convertis en événements de souris, puis finalement transmis à l’élément.
Remarque : seuls les événements de souris sont pris en charge. L’élément ne prend pas en charge les entrées clavier.
Documentation sur les types de membres
enum QScene2D::RenderPolicy
Ce type d'énumération décrit les différents types de politiques de rendu disponibles.
| Constante | Valeur | Description |
|---|---|---|
Qt3DRender::Quick::QScene2D::Continuous | 0 | La scène 2D est rendue en continu. Il s'agit de la politique de rendu par défaut. |
Qt3DRender::Quick::QScene2D::SingleShot | 1 | La Scene2D effectue le rendu sur la texture une seule fois, après quoi les ressources allouées au rendu sont libérées. |
Documentation de la propriété
item : QQuickItem*
Contient l'QQuickItem, qui est rendu par QScene2D sur la texture.
Fonctions d’accès :
| QQuickItem * | item() const |
| void | setItem(QQuickItem *item) |
Signal de notification :
| void | itemChanged(QQuickItem *item) |
mouseEnabled : bool
Indique si les événements de souris sont activés pour l'élément affiché. Les événements de souris sont générés à partir des événements de sélection d'objets des entités ajoutées à l'QScene2D. La souris est activée par défaut.
Remarque : les événements sont décalés d’une image, car la sélection des objets s’effectue en arrière-plan.
Fonctions d'accès :
| bool | isMouseEnabled() const |
| void | setMouseEnabled(bool enabled) |
Signal de notification :
| void | mouseEnabledChanged(bool enabled) |
output : Qt3DRender::QRenderTargetOutput*
Contient l'objet `QRenderTargetOutput`, qui spécifie la destination vers laquelle l'QScene2D effectue le rendu.
Fonctions d’accès :
| Qt3DRender::QRenderTargetOutput * | output() const |
| void | setOutput(Qt3DRender::QRenderTargetOutput *output) |
Signal de notification :
| void | outputChanged(Qt3DRender::QRenderTargetOutput *output) |
renderPolicy : RenderPolicy
Contient la politique de rendu de cette Scene2D.
Fonctions d'accès :
| Qt3DRender::Quick::QScene2D::RenderPolicy | renderPolicy() const |
| void | setRenderPolicy(Qt3DRender::Quick::QScene2D::RenderPolicy policy) |
Signal de notification :
| void | renderPolicyChanged(Qt3DRender::Quick::QScene2D::RenderPolicy policy) |
Documentation des fonctions membres
[explicit] QScene2D::QScene2D(Qt3DCore::QNode *parent = nullptr)
Le constructeur crée une nouvelle instance de QScene2D avec l'parent spécifiée.
void QScene2D::addEntity(Qt3DCore::QEntity *entity)
Ajoute un ` entity ` à l'objet ` QScene2D `. Si les entités disposent d'un `QObjectPicker`, les événements de sélection provenant de cette entité sont envoyés à ` QScene2D ` et convertis en événements de souris.
QList<Qt3DCore::QEntity *> QScene2D::entities() const
Récupérer les entités associées à l'QScene2D.
void QScene2D::removeEntity(Qt3DCore::QEntity *entity)
Supprime une instance de ` entity ` de l'objet ` QScene2D `.
© 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.
