Scene2D QML Type

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

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

Eigenschaften

Detaillierte Beschreibung

Dieses Objekt verwendet RenderControl, um das angegebene Element in eine Offscreen-Oberfläche zu rendern, die mit einer vom Benutzer bereitgestellten Textur verbunden ist. Dadurch kann die Komponente direkt in die Textur gerendert werden, ohne eine Zwischenkopie zu erstellen, und der Benutzer kann frei bestimmen, wie die Textur in der 3D-Szene verwendet wird.

Die Entitäten, die Scene2D verwenden, können mit dem Typ verbunden werden, um die Interaktion mit dem Element zu ermöglichen; wenn eine Entität eine ObjectPicker Komponente hat, werden die Pick-Ereignisse von diesem Picker an Scene2D gesendet und in Mausereignisse umgewandelt und schließlich an das Element gesendet.

Hinweis: Es werden nur Mausereignisse unterstützt. Das Element unterstützt keine Tastatureingaben.

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

Eigenschaft Dokumentation

entities : list<Entity>

Enthält die Liste der Entitäten, die mit dem Scene2D Objekt verbunden sind. Wenn die Entitäten ObjectPicker haben, werden die Pick-Ereignisse von dieser Entität an Scene2D gesendet und in Mausereignisse umgewandelt.


item : Item

Enthält das Item, das von Scene2D auf die Textur gerendert wird.


mouseEnabled : bool

Zeigt an, ob Mausereignisse für das gerenderte Objekt aktiviert sind. Die Mausereignisse werden aus den Objektauswahlereignissen der zu Scene2D hinzugefügten Entitäten generiert. Standardmäßig ist die Maus aktiviert.

Hinweis: Ereignisse, die an Elemente gesendet werden, werden um einen Frame verzögert, da die Objektauswahl im Backend stattfindet.


Enthält die RenderTargetOutput, die angibt, wohin die Scene2D gerendert wird.


renderPolicy : enumeration

Enthält die Rendering-Richtlinie dieses Scene2D.

  • Kontinuierlich Die Scene2D wird kontinuierlich gerendert. Dies ist die Standard-Rendering-Policy.
  • SingleShot Die Scene2D rendert nur einmal auf die Textur, danach werden die für das Rendering zugewiesenen Ressourcen freigegeben.

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