Scene2D QML Type
Este tipo permite renderizar QML en una textura, que luego puede utilizarse como parte de una escena 3D. Más información...
| Import Statement: | import QtQuick.Scene2D 2.12 |
| In C++: | QScene2D |
| Status: | Deprecated |
Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.
Propiedades
- entities : list<Entity>
- item : Item
- mouseEnabled : bool
- output : RenderTargetOutput
- renderPolicy : enumeration
Descripción detallada
Este objeto utiliza RenderControl para renderizar el elemento dado en una superficie fuera de pantalla, que está vinculada a una textura proporcionada por el usuario. Esto permite que el componente renderice directamente en la textura sin necesidad de copias intermedias y que el usuario especifique libremente cómo se utiliza la textura en la escena 3D.
Las entidades que utilizan Scene2D pueden asociarse a este 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 Scene2D, se convierten en eventos de ratón y, finalmente, se envían al elemento.
Nota: Solo se admiten eventos de ratón. El elemento no admite entradas de teclado.
Uso:
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 disponen de `ObjectPicker`, los eventos de selección de dicha entidad se envían a ` Scene2D ` y se convierten en eventos del ratón.
item : Item
Contiene el elemento que « Scene2D » aplica a la textura.
mouseEnabled : bool
Indica si los eventos del ratón están habilitados para el elemento renderizado. Los eventos del ratón se generan a partir de los eventos de selección de objetos de las entidades añadidas a Scene2D. El ratón está habilitado por defecto.
Nota: Los eventos enviados a los elementos se retrasan un fotograma debido a que la selección de objetos se realiza en el backend.
output : RenderTargetOutput
Contiene el objeto `RenderTargetOutput`, que especifica dónde se realiza el renderizado del objeto ` Scene2D `.
renderPolicy : enumeration
Contiene 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.