/**************************************************************************** ** ** Copyright (C) 2014 Klaralvdalens Datakonsult AB (KDAB). ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the Qt3D module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or (at your option) the GNU General ** Public license version 3 or any later version approved by the KDE Free ** Qt Foundation. The licenses are as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-2.0.html and ** https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #include "qqmlaspectengine_p.h" #include #include #include #include QT_BEGIN_NAMESPACE namespace Qt3DCore { namespace Quick { /*! \namespace Qt3DCore::Quick \inmodule Qt3DCore \brief Contains classes used for implementing QML functionality into Qt3D applications. */ QQmlAspectEnginePrivate::QQmlAspectEnginePrivate() : QObjectPrivate() , m_qmlEngine(new QQmlEngine()) , m_aspectEngine(new QAspectEngine()) , m_component(nullptr) { } /*! * \class Qt3DCore::Quick::QQmlAspectEngine * \inheaderfile Qt3DQuick/QQmlAspectEngine * \inmodule Qt3DCore * * \brief The QQmlAspectEngine provides an environment for the QAspectEngine and * a method for instantiating QML components. */ /*! * \enum Qt3DCore::Quick::QQmlAspectEngine::Status * * The status of the engine. * * \value Null * \value Ready * \value Loading * \value Error */ /*! * \fn void Qt3DCore::Quick::QQmlAspectEngine::statusChanged(Status status) * * This signal is emitted with \a status when the status of the engine changes. */ /*! * \fn void Qt3DCore::Quick::QQmlAspectEngine::sceneCreated(QObject* rootObject) * * This signal is emitted with \a rootObject when the scene has been instantiated. This provides a * chance to manipulate the scene before passing it over to the aspect engine. Useful for * convenience window classes to set up cameras and surfaces on the framegraph and event sources * for the input aspect etc. */ /*! * Constructs a new QQmlAspectEngine with \a parent. */ QQmlAspectEngine::QQmlAspectEngine(QObject *parent) : QObject(*new QQmlAspectEnginePrivate, parent) { } /*! \internal */ QQmlAspectEngine::~QQmlAspectEngine() { } /*! * \return the status. */ QQmlAspectEngine::Status QQmlAspectEngine::status() const { Q_D(const QQmlAspectEngine); if (!d->m_component) return Null; return Status(d->m_component->status()); } /*! * Sets \a source as a source for the QML component to be created. */ void QQmlAspectEngine::setSource(const QUrl &source) { Q_D(QQmlAspectEngine); if (d->m_component) { d->m_aspectEngine->setRootEntity(QEntityPtr()); d->m_component = nullptr; } if (!source.isEmpty()) { d->m_component = new QQmlComponent(d->m_qmlEngine.data(), source); if (!d->m_component->isLoading()) { d->_q_continueExecute(); } else { QObject::connect(d->m_component, SIGNAL(statusChanged(QQmlComponent::Status)), this, SLOT(_q_continueExecute())); } } } /*! * \return the engine. */ QQmlEngine *QQmlAspectEngine::qmlEngine() const { Q_D(const QQmlAspectEngine); return d->m_qmlEngine.data(); } /*! * \return the aspectEngine. */ QAspectEngine *QQmlAspectEngine::aspectEngine() const { Q_D(const QQmlAspectEngine); return d->m_aspectEngine.data(); } void QQmlAspectEnginePrivate::_q_continueExecute() { Q_Q(QQmlAspectEngine); QObject::disconnect(m_component, SIGNAL(statusChanged(QQmlComponent::Status)), q, SLOT(_q_continueExecute())); if (m_component->isError()) { const auto errors = m_component->errors(); for (const QQmlError &error : errors) { QMessageLogger(error.url().toString().toLatin1().constData(), error.line(), 0).warning() << error; } emit q->statusChanged(q->status()); return; } QObject* obj = m_component->create(); if (m_component->isError()) { const auto errors = m_component->errors(); for (const QQmlError &error : errors) { QMessageLogger(error.url().toString().toLatin1().constData(), error.line(), 0).warning() << error; } emit q->statusChanged(q->status()); return; } // Let users know we have loaded the QML file, and the scene has been instantiated. // This gives a chance to manipulate the scene before passing it over to the // aspect engine. Useful for convenience window classes to set up cameras and surfaces // on the framegraph and event sources for the input aspect etc. emit q->sceneCreated(obj); m_aspectEngine->setRootEntity(QEntityPtr(qobject_cast(obj))); emit q->statusChanged(q->status()); } } // namespace Quick } // namespace Qt3DCore QT_END_NAMESPACE #include "moc_qqmlaspectengine.cpp"