gltfsceneconverter.h

Enable keyboard shortcuts

// Copyright (C) 2026 The Qt Company Ltd.

// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only

// Qt-Security score:significant reason:default

#pragma once

#include <QtQuick3DAssetUtils/private/qssgscenedesc_p.h>

#include <QtQuick3DGltf/private/qssggltfdocument_p.h>

#include <QtQuick3DUtils/private/qssgmesh_p.h>

#include <QtCore/qfileinfo.h>

#include <QtCore/qhash.h>

#include <QtCore/qjsonobject.h>

QT_BEGIN_NAMESPACE

struct GltfMorphTargetInfo

    int count = 0;

    bool hasPositions = false;

    bool hasNormals = false;

    bool hasTangents = false;

};

// Converts a QSSGGltfDocument into a QSSGSceneDesc::Scene

class GltfSceneConverter

public:

    struct Options

        bool designStudioWorkarounds = false;

        bool joinIdenticalVertices = true;

        bool useFloatJointIndices = false;

        bool generateSmoothNormals = false;

        bool forceTangentGeneration = false;

        bool generateMipMaps = false;

        bool generateMeshLODs = false;

        float lodNormalMergeAngle = 60.0f;

        float lodNormalSplitAngle = 25.0f;

        float globalScaleValue = 1.0f;

        float animationSampleRate = 30.0f;

        QString materialVariant; // KHR_materials_variants variant name to import

        int materialVariantIndex = -1; // resolved from materialVariant per document

};

    // Returns an empty string on success, the error message otherwise.

    QString convert(const QSSGGltfDocument &document, const QJsonObject &optionsObject,

                    const QFileInfo &sourceFile, QSSGSceneDesc::Scene &targetScene);

private:

    void processNode(int nodeIndex, QSSGSceneDesc::Node &parent);

    QSSGSceneDesc::Node *createSceneNode(const QSSGGltf::Node &node);

    void setNodeProperties(QSSGSceneDesc::Node &target, const QSSGGltf::Node &source);

    void setCameraProperties(QSSGSceneDesc::Camera &target, const QSSGGltf::Camera &source);

    void setLightProperties(QSSGSceneDesc::Light &target, const QSSGGltf::Light &source);

    void convertAnimations();

    void convertSkins();

    QSSGSceneDesc::Instancing *convertInstancing(const QSSGGltf::Node &source, QSSGSceneDesc::Node &owner);

    void setModelProperties(QSSGSceneDesc::Model &target, const QSSGGltf::Node &source, int nodeIndex);

    void setMaterialProperties(QSSGSceneDesc::Material &target, const QSSGGltf::Material &source);

    void setSpecularGlossyProperties(QSSGSceneDesc::Material &target, const QSSGGltf::Material &source);

    QSSGSceneDesc::Material *ensureMaterial(int materialIndex, QSSGSceneDesc::Node &owner);

    QSSGSceneDesc::Texture *ensureTexture(const QSSGGltf::TextureInfo &textureInfo, QSSGSceneDesc::Node &owner);

    static Options parseOptions(const QJsonObject &optionsObject);

    const QSSGGltfDocument *m_document = nullptr;

    QSSGSceneDesc::Scene *m_scene = nullptr;

    Options m_options;

    QHash<int, QSSGSceneDesc::Node *> m_nodeMap; // glTF node index -> scene node

    QHash<int, QSSGSceneDesc::Mesh *> m_meshMap; // glTF mesh index -> mesh resource

    QHash<int, QList<int>> m_meshUsedPrimitives; // glTF mesh index -> primitives that became subsets

    QHash<int, GltfMorphTargetInfo> m_meshMorphInfo; // glTF mesh index -> morph target info

    struct BuiltMesh {

        QSSGMesh::Mesh mesh;

        QList<int> usedPrimitives;

        GltfMorphTargetInfo morphInfo;

};

    QHash<int, BuiltMesh> m_builtMeshes; // glTF mesh index -> pre-built mesh data

    QHash<int, QList<QSSGSceneDesc::MorphTarget *>> m_morphTargetMap; // glTF node index -> morph target nodes

    QHash<int, QSSGSceneDesc::Material *> m_materialMap; // glTF material index -> material (-1 = default)

    QHash<QByteArray, QSSGSceneDesc::Texture *> m_textureMap; // dedup key -> texture

    QHash<int, QSSGSceneDesc::TextureData *> m_textureDataMap; // glTF image index -> embedded data

    QHash<int, QSSGSceneDesc::Skin *> m_skinMap; // glTF skin index -> skin resource

};

QT_END_NAMESPACE