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
- entities : list<Entity>
- item : Item
- mouseEnabled : bool
- output : RenderTargetOutput
- renderPolicy : enumeration
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
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.
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.
output : RenderTargetOutput |
Enthält die RenderTargetOutput, die angibt, wohin die Scene2D gerendert wird.
renderPolicy : enumeration |
© 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.