Qt3DRender::Quick::QScene2D Class
class Qt3DRender::Quick::QScene2DEsta clase permite renderizar QML en una textura, que luego se puede utilizar como parte de una escena 3D. Más información...
| Encabezado: | #include <Qt3DQuickScene2D/QScene2D> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3dquickscene2d) target_link_libraries(mytarget PRIVATE Qt6::3dquickscene2d) |
| qmake: | QT += 3dquickscene2d |
| En QML: | Scene2D |
| Heredado de: | Qt3DCore::QNode |
| Estado: | Obsoleto |
Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.
Tipos públicos
| enum | RenderPolicy { Continuous, SingleShot } |
Propiedades
- item : QQuickItem*
- mouseEnabled : bool
- output : Qt3DRender::QRenderTargetOutput*
- renderPolicy : RenderPolicy
Funciones públicas
| QScene2D(Qt3DCore::QNode *parent = nullptr) | |
| void | addEntity(Qt3DCore::QEntity *entity) |
| QList<Qt3DCore::QEntity *> | entities() const |
| bool | isMouseEnabled() const |
| QQuickItem * | item() const |
| Qt3DRender::QRenderTargetOutput * | output() const |
| void | removeEntity(Qt3DCore::QEntity *entity) |
| Qt3DRender::Quick::QScene2D::RenderPolicy | renderPolicy() const |
Ranuras públicas
| void | setItem(QQuickItem *item) |
| void | setMouseEnabled(bool enabled) |
| void | setOutput(Qt3DRender::QRenderTargetOutput *output) |
| void | setRenderPolicy(Qt3DRender::Quick::QScene2D::RenderPolicy policy) |
Señales
| void | itemChanged(QQuickItem *item) |
| void | mouseEnabledChanged(bool enabled) |
| void | outputChanged(Qt3DRender::QRenderTargetOutput *output) |
| void | renderPolicyChanged(Qt3DRender::Quick::QScene2D::RenderPolicy policy) |
Descripción detallada
Esta clase utiliza « QQuickRenderControl » para renderizar el « QQuickItem » dado en una superficie fuera de pantalla, que se vincula 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 QScene2D pueden asociarse a la clase para permitir la interacción con el elemento; si una entidad tiene un componente « QObjectPicker », los eventos de selección de ese selector se envían a QScene2D, 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.
Documentación sobre los tipos de miembros
enum QScene2D::RenderPolicy
Este tipo de enumeración describe los tipos de políticas de representación disponibles.
| Constante | Valor | Descripción |
|---|---|---|
Qt3DRender::Quick::QScene2D::Continuous | 0 | Scene2D se renderiza de forma continua. Esta es la política de renderizado predeterminada. |
Qt3DRender::Quick::QScene2D::SingleShot | 1 | La Scene2D se renderiza en la textura una sola vez, tras lo cual se liberan los recursos asignados para el renderizado. |
Documentación de la propiedad
item : QQuickItem*
Contiene el objeto « QQuickItem », que « QScene2D » aplica a la textura.
Funciones de acceso:
| QQuickItem * | item() const |
| void | setItem(QQuickItem *item) |
Señal de notificación:
| void | itemChanged(QQuickItem *item) |
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 QScene2D. El ratón está habilitado por defecto.
Nota: Los eventos se retrasan un fotograma debido a que la selección de objetos se realiza en el backend.
Funciones de acceso:
| bool | isMouseEnabled() const |
| void | setMouseEnabled(bool enabled) |
Señal del notificador:
| void | mouseEnabledChanged(bool enabled) |
output : Qt3DRender::QRenderTargetOutput*
Contiene el objeto `QRenderTargetOutput`, que especifica dónde realiza el renderizado el ` QScene2D `.
Funciones de acceso:
| Qt3DRender::QRenderTargetOutput * | output() const |
| void | setOutput(Qt3DRender::QRenderTargetOutput *output) |
Señal del notificador:
| void | outputChanged(Qt3DRender::QRenderTargetOutput *output) |
renderPolicy : RenderPolicy
Contiene la política de renderizado de esta Scene2D.
Funciones de acceso:
| Qt3DRender::Quick::QScene2D::RenderPolicy | renderPolicy() const |
| void | setRenderPolicy(Qt3DRender::Quick::QScene2D::RenderPolicy policy) |
Señal del notificador:
| void | renderPolicyChanged(Qt3DRender::Quick::QScene2D::RenderPolicy policy) |
Documentación de las funciones de miembro
[explicit] QScene2D::QScene2D(Qt3DCore::QNode *parent = nullptr)
El constructor crea una nueva instancia de QScene2D con el ` parent` especificado.
void QScene2D::addEntity(Qt3DCore::QEntity *entity)
Añade un objeto « entity » al objeto « QScene2D ». Si las entidades disponen de «QObjectPicker», los eventos de selección de dicha entidad se envían a « QScene2D » y se convierten en eventos del ratón.
QList<Qt3DCore::QEntity *> QScene2D::entities() const
Recuperar las entidades asociadas a QScene2D.
void QScene2D::removeEntity(Qt3DCore::QEntity *entity)
Elimina un objeto « entity » del objeto « QScene2D ».
© 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.