Scene2D QML Type

Dieser Typ ermöglicht das Rendern von QML in eine Textur, die anschließend als Teil einer 3D-Szene verwendet werden kann. Mehr...

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Ausführliche Beschreibung

Dieses Objekt verwendet RenderControl, um das angegebene Element auf einer Offscreen-Oberfläche zu rendern, die mit einer vom Benutzer bereitgestellten Textur verknüpft ist. Dadurch kann die Komponente direkt in die Textur rendern, ohne dass eine Zwischenkopie erforderlich ist, und der Benutzer kann frei festlegen, wie die Textur in der 3D-Szene verwendet wird.

Die Entitäten, die Scene2D verwenden, können diesem Typ zugeordnet werden, um eine Interaktion mit dem Element zu ermöglichen; verfügt eine Entität über eine „ ObjectPicker “-Komponente, werden die Auswahlereignisse dieses Pickers an Scene2D gesendet, in Mausereignisse umgewandelt und schließlich an das Element weitergeleitet.

Verwendung:

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

Dokumentation zu den Eigenschaften

entities : list<Entity>

Enthält die Liste der Entitäten, die mit dem Objekt „ Scene2D “ verknüpft sind. Wenn die Entitäten über einen „ObjectPicker“ verfügen, werden die Auswahlereignisse dieser Entität an „ Scene2D “ gesendet und in Mausereignisse umgewandelt.

item : Item

Enthält das Element, das von „ Scene2D “ in die Textur gerendert wird.

mouseEnabled : bool

Gibt an, ob Mausereignisse für das gerenderte Element aktiviert sind. Die Mausereignisse werden aus den Objekt-Auswahlereignissen der Entitäten generiert, die dem „ Scene2D “ hinzugefügt wurden. Die Mausfunktion ist standardmäßig aktiviert.

output : RenderTargetOutput

Enthält das „RenderTargetOutput“, das angibt, wohin das „ Scene2D “ rendert.

renderPolicy : enumeration

Enthält die Render-Richtlinie dieses Scene2D.

• „Continuous“: Die „ Scene2D “ wird kontinuierlich gerendert. Dies ist die Standard-Render-Richtlinie.
• SingleShot: Der „ Scene2D “ rendert nur einmal in die Textur; danach werden die für das Rendern zugewiesenen Ressourcen freigegeben.