Scene2D QML Type
Este tipo permite renderizar qml en una textura, que luego puede utilizarse como parte de una escena 3D. Más...
| Import Statement: | import QtQuick.Scene2D 2.11 |
| In C++: | QScene2D |
| Status: | Deprecated |
Propiedades
- entities : list<Entity>
- item : Item
- mouseEnabled : bool
- output : RenderTargetOutput
- renderPolicy : enumeration
Descripción Detallada
Este objeto utiliza RenderControl para renderizar el Item dado en una superficie fuera de la pantalla, que está unida a una textura proporcionada por el usuario. Esto permite al componente renderizar directamente en la textura sin copia intermedia y al usuario especificar libremente cómo se utiliza la textura en la escena 3D.
Las entidades que utilizan la Scene2D pueden asociarse con el tipo para permitir la interacción con el elemento; si una entidad tiene un componente ObjectPicker, los eventos de selección de ese selector se envían a la Scene2D y se convierten en eventos de ratón y finalmente se envían al elemento.
Nota: Sólo se admiten eventos de ratón. El ítem no soporta entrada de teclado.
Utilización:
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
}
...Documentación de Propiedades
entities : list<Entity>
Contiene la lista de entidades asociadas al objeto Scene2D. Si las entidades tienen ObjectPicker, los eventos de selección de esa entidad se envían a Scene2D y se convierten en eventos de ratón.
item : Item
Contiene el elemento, que se renderiza mediante Scene2D a la textura.
mouseEnabled : bool
Indica si los eventos de ratón están habilitados para el elemento renderizado. Los eventos de ratón se generan a partir de los eventos de recogida de objetos de las entidades añadidas a Scene2D. El ratón está activado por defecto.
Nota: Los eventos enviados a los elementos se retrasan un fotograma debido a la recogida de objetos que tiene lugar en el backend.
output : RenderTargetOutput
Contiene la dirección RenderTargetOutput, que especifica hacia dónde se renderiza Scene2D.
renderPolicy : enumeration
Mantiene la política de renderizado de este Scene2D.
© 2026 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.