En esta página

Qt3DRender::Quick::QScene2D Class

class Qt3DRender::Quick::QScene2D

Esta 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

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.

ConstanteValorDescripción
Qt3DRender::Quick::QScene2D::Continuous0Scene2D se renderiza de forma continua. Esta es la política de renderizado predeterminada.
Qt3DRender::Quick::QScene2D::SingleShot1La 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.