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

• Liste de tous les membres, y compris les membres hérités

Propriétés

• entities : list<Entity>
• item : Item
• mouseEnabled : bool
• output : RenderTargetOutput
• renderPolicy : enumeration

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.

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
        }
        ...

Documentation sur les propriétés

entities : list<Entity>

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

item : Item

Contient l'élément, qui est rendu par Scene2D à la texture.

mouseEnabled : bool

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

output : RenderTargetOutput

Contient l'adresse RenderTargetOutput, qui spécifie le lieu de rendu de l'adresse Scene2D.

renderPolicy : enumeration

Détient la politique de rendu de cette Scene2D.

• Continu Le site Scene2D effectue un rendu 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.