Scene2D QML Type

Ce type permet de rendre qml dans une texture, qui peut ensuite être utilisée comme élément d'une scène 3D. Plus d'informations...

Import Statement: import QtQuick.Scene2D 2.10
In C++: QScene2D
Status: Deprecated

Propriétés

Description détaillée

Cet objet utilise RenderControl pour effectuer le rendu de l'élément donné dans une surface hors écran, qui est attachée à une texture fournie par l'utilisateur. Cela permet au composant d'effectuer un rendu direct dans la texture sans copie intermédiaire et à l'utilisateur de spécifier librement la manière dont la texture est utilisée dans la scène 3D.

Les entités utilisant la Scene2D peuvent être associées au type pour permettre l'interaction avec l'élément ; si une entité possède un composant ObjectPicker, les événements de sélection de ce sélecteur sont envoyés à la Scene2D et convertis en événements de souris, puis envoyés à l'élément.

Remarque : seuls les événements de souris sont pris en charge. L'élément ne prend pas en charge la saisie au clavier.

Utilisation :

Entity {
    id: sceneRoot

    // specify Scene2D inside the entity hierarchy
    Scene2D {
        // specify output
        output: RenderTargetOutput {
            attachmentPoint: RenderTargetOutput.Color0
            texture: Texture2D {
                id: textureId
                width: 1024
                height: 1024
                format: Texture.RGBA8_UNorm
            }
        }
        // specify entities
        entities: [entityId]

        // specify rendered content
        Rectangle {
            color: "red"
        }
    }

    Entity {
        id: entityId

        property Material material: TextureMaterial {
            texture: textureId
        }
        property ObjectPicker picker: ObjectPicker {
            hoverEnabled: true
            dragEnabled: true
        }
        ...

Propriété Documentation

entities : list<Entity>

Contient la liste des entités associées à l'objet Scene2D. Si les entités sont associées à ObjectPicker, les événements de sélection de cette entité sont envoyés à Scene2D et convertis en événements de souris.


item : Item

Détient l'élément qui est rendu par Scene2D dans la texture.


mouseEnabled : bool

Indique si les événements souris sont activés pour l'objet rendu. Les événements souris sont générés à partir des événements de sélection d'objets des entités ajoutées à Scene2D. La souris est activée par défaut.

Remarque : les événements envoyés aux éléments sont retardés d'une image en raison de la sélection des objets dans le backend.


Contient l'adresse RenderTargetOutput, qui spécifie l'endroit où le rendu de Scene2D est effectué.


renderPolicy : enumeration

Contient la politique de rendu de cette Scene2D.

  • Continu Le rendu de Scene2D est continu. Il s'agit de la politique de rendu par défaut.
  • SingleShot Le site Scene2D n'effectue le rendu de la texture qu'une seule fois, après quoi les ressources allouées au rendu sont libérées.

© 2025 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.