Scene2D QML Type

Ce type permet de convertir du code QML en texture, qui peut ensuite être intégrée à une scène 3D. En savoir plus…

Ce type est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

• 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 rendre l'élément donné 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 Scene2D peuvent être associées à ce type afin de permettre l’interaction avec l’élément ; si une entité dispose d’un composant « ObjectPicker », les événements de sélection provenant de ce sélecteur sont envoyés à Scene2D, convertis en événements de souris, puis finalement transmis à 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 des propriétés

entities : list<Entity>

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

item : Item

Contient l'élément, qui est rendu par la fonction « Scene2D » sur la texture.

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'Scene2D. La souris est activée par défaut.

output : RenderTargetOutput

Contient le RenderTargetOutput, qui spécifie l'emplacement où l'Scene2D effectue le rendu.

renderPolicy : enumeration

Contient la politique de rendu de cette Scene2D.

• Continu : l'Scene2D effectue un rendu en continu. Il s'agit de la politique de rendu par défaut.
• SingleShot : l'Scene2D effectue le rendu sur la texture une seule fois, après quoi les ressources allouées au rendu sont libérées.