En esta página

Qt3DCore::QAspectEngine Class

class Qt3DCore::QAspectEngine

Se encarga de gestionar todas las subclases de ` QAbstractAspect ` que se hayan registrado en la escena. Más información...

Encabezado: #include <Qt3DCore/QAspectEngine>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3DCore)
target_link_libraries(mytarget PRIVATE Qt6::3DCore)
qmake: QT += 3dcore
Heredado de: QObject
Estado: Obsoleta

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Funciones públicas

QAspectEngine(QObject *parent = nullptr)
virtual ~QAspectEngine()
Qt3DCore::QAbstractAspect *aspect(const QString &name) const
QList<Qt3DCore::QAbstractAspect *> aspects() const
QVariant executeCommand(const QString &command)
void processFrame()
void registerAspect(Qt3DCore::QAbstractAspect *aspect)
void registerAspect(const QString &name)
Qt3DCore::QEntityPtr rootEntity() const
void setRootEntity(Qt3DCore::QEntityPtr root)
void unregisterAspect(Qt3DCore::QAbstractAspect *aspect)
void unregisterAspect(const QString &name)

Descripción detallada

El bucle de ejecución de Qt3D está controlado por Qt3DRender::QAspectEngine.

Qt3DCore::QAbstractAspect Las subclases pueden registrarse llamando a Qt3DCore::QAspectEngine::registerAspect(), que se encargará de registrar el aspecto y, a su vez, llamará a Qt3DCore::QAbstractAspect::onRegistered();

El bucle de simulación se inicia tan pronto como se establece una entidad raíz ( Qt3DCore::QEntity ) en el bucle de simulación ( Qt3DCore::QAspectEngine). A continuación, se llama a onEngineStartup() en cada aspecto para que puedan iniciar su trabajo de simulación.

El bucle de simulación se detiene cuando la entidad raíz se establece en Qt3DCore::QEntityPtr(). Esto llama a onEngineShutdown() en cada aspecto para que puedan dejar de realizar su trabajo de simulación.

Al establecer una nueva entidad raíz válida, el bucle de simulación se reiniciaría de nuevo.

Documentación de las funciones miembro

[explicit] QAspectEngine::QAspectEngine(QObject *parent = nullptr)

Crea un nuevo objeto `QAspectEngine` con ` parent`.

[virtual noexcept] QAspectEngine::~QAspectEngine()

Destruye el motor.

Qt3DCore::QAbstractAspect *QAspectEngine::aspect(const QString &name) const

Devuelve el aspecto que coincide con el name

Nota: Es necesario que el aspecto se haya registrado por su nombre.

QList<Qt3DCore::QAbstractAspect *> QAspectEngine::aspects() const

Devuelve los aspectos que gestiona el motor de aspectos.

QVariant QAspectEngine::executeCommand(const QString &command)

Ejecuta el comando « command » especificado en el motor de aspectos. Los comandos válidos son:

  • «list aspects»

Devuelve la respuesta al comando.

void QAspectEngine::processFrame()

Si se utiliza el modo de ejecución manual, esta función ejecuta los trabajos para cada aspecto. Es una función bloqueante y no devolverá ningún resultado hasta que se hayan completado todos los trabajos.

Si utilizas QRenderAspect,

void QAspectEngine::registerAspect(Qt3DCore::QAbstractAspect *aspect)

Registra un nuevo « aspect » en el «AspectManager». El « QAspectEngine » asume la responsabilidad del aspecto y lo eliminará cuando se dé de baja.

void QAspectEngine::registerAspect(const QString &name)

Registra un nuevo aspecto en el AspectManager basándose en su « name ». Utiliza la fábrica de aspectos actualmente configurada para crear la instancia del aspecto.

Qt3DCore::QEntityPtr QAspectEngine::rootEntity() const

Devuelve la entidad raíz del motor de aspectos.

Véase también setRootEntity().

void QAspectEngine::setRootEntity(Qt3DCore::QEntityPtr root)

Establece la entidad « root » para el motor de aspectos.

Véase también rootEntity().

void QAspectEngine::unregisterAspect(Qt3DCore::QAbstractAspect *aspect)

Da de baja y elimina el aspect indicado.

void QAspectEngine::unregisterAspect(const QString &name)

Da de baja y elimina el aspecto con el « name » indicado.

No miembros relacionados

QEntityPtr

Un puntero compartido para QEntity.

© 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.