Revision control
Copy as Markdown
// Copyright (C) 2021 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
// Qt-Security score:significant reason:default
#ifndef QQUICK3DRUNTIMELOADER_H
#define QQUICK3DRUNTIMELOADER_H
//
// W A R N I N G
// -------------
//
// This file is not part of the Qt API. It exists purely as an
// implementation detail. This header file may change from version to
// version without notice, or even be removed.
//
// We mean it.
//
#include <QtQuick3D/private/qquick3dmodel_p.h>
#include <QtQuick3D/private/qquick3dinstancing_p.h>
#include "qtquick3dassetutilsglobal_p.h"
#include <QtCore/qpointer.h>
#include <QtCore/qlist.h>
#if QT_CONFIG(mimetype)
#include <QtCore/qmimetype.h>
#endif
#include <QtCore/qhash.h>
QT_BEGIN_NAMESPACE
class Q_QUICK3DASSETUTILS_EXPORT QQuick3DRuntimeLoader : public QQuick3DNode
{
Q_OBJECT
QML_NAMED_ELEMENT(RuntimeLoader)
QML_ADDED_IN_VERSION(6, 2)
Q_PROPERTY(QUrl source READ source WRITE setSource NOTIFY sourceChanged)
Q_PROPERTY(Status status READ status NOTIFY statusChanged)
Q_PROPERTY(QString errorString READ errorString NOTIFY errorStringChanged)
Q_PROPERTY(QQuick3DBounds3 bounds READ bounds NOTIFY boundsChanged)
Q_PROPERTY(QQuick3DInstancing *instancing READ instancing WRITE setInstancing NOTIFY instancingChanged)
Q_PROPERTY(QStringList supportedExtensions READ supportedExtensions CONSTANT REVISION(6, 7))
Q_PROPERTY(QStringList materialVariants READ materialVariants NOTIFY materialVariantsChanged REVISION(6, 13))
Q_PROPERTY(QString materialVariant READ materialVariant WRITE setMaterialVariant NOTIFY materialVariantChanged
REVISION(6, 13))
#if QT_CONFIG(mimetype)
Q_PROPERTY(QList<QMimeType> supportedMimeTypes READ supportedMimeTypes CONSTANT REVISION(6, 7))
#endif
public:
explicit QQuick3DRuntimeLoader(QQuick3DNode *parent = nullptr);
enum class QueryFilter
{
Textures,
Materials,
Nodes,
Cameras,
Lights,
Models,
};
Q_ENUM(QueryFilter)
QUrl source() const;
void setSource(const QUrl &newSource);
void componentComplete() override;
Q_REVISION(6, 7) static QStringList supportedExtensions();
#if QT_CONFIG(mimetype)
Q_REVISION(6, 7) static QList<QMimeType> supportedMimeTypes();
#endif
enum class Status { Empty, Success, Error };
Q_ENUM(Status)
Status status() const;
QString errorString() const;
const QQuick3DBounds3 &bounds() const;
QQuick3DInstancing *instancing() const;
void setInstancing(QQuick3DInstancing *newInstancing);
Q_REVISION(6, 13) QStringList materialVariants() const;
Q_REVISION(6, 13) QString materialVariant() const;
Q_REVISION(6, 13) void setMaterialVariant(const QString &variant);
Q_REVISION(6, 12) Q_INVOKABLE QQuick3DObject *query(const QString &name) const;
Q_REVISION(6, 12) Q_INVOKABLE QList<QQuick3DObject *> queryAll(QueryFilter filter) const;
Q_SIGNALS:
void sourceChanged();
void statusChanged();
void errorStringChanged();
void boundsChanged();
void instancingChanged();
Q_REVISION(6, 13) void materialVariantsChanged();
Q_REVISION(6, 13) void materialVariantChanged();
protected:
QSSGRenderGraphObject *updateSpatialNode(QSSGRenderGraphObject *node) override;
private:
void calculateBounds();
void loadSource();
void updateModels();
QSSGRuntimeObjectNameMap m_objects;
QSSGRuntimeObjectTypeMap m_objectsByType;
QPointer<QQuick3DNode> m_root;
QPointer<QQuick3DNode> m_imported;
QString m_assetId; // Used to release runtime assets in the buffer manager.
QUrl m_source;
Status m_status = Status::Empty;
QString m_errorString;
bool m_boundsDirty = false;
QQuick3DBounds3 m_bounds;
QQuick3DInstancing *m_instancing = nullptr;
bool m_instancingChanged = false;
void applyMaterialVariant();
struct ModelVariantMaterials
{
QPointer<QQuick3DModel> model;
QList<QList<QQuick3DMaterial *>> perVariant;
QList<QQuick3DMaterial *> defaults;
};
QList<ModelVariantMaterials> m_variantModels;
QStringList m_materialVariants;
QString m_materialVariant;
};
QT_END_NAMESPACE
#endif // QQUICK3DRUNTIMELOADER_H