Qt3DCore::QAspectEngine Class
class Qt3DCore::QAspectEngineSe 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) |
Elementos no miembros relacionados
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.
© 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.