assimpParser.h

Go to the documentation of this file.

// SPDX-License-Identifier: Apache-2.0
// Copyright 2025-2026 Arnis Lektauers
//
// Assimp-based multi-format 3D model parser for VisuTwin Canvas.
//
// Loads Collada (.dae), FBX (.fbx), 3DS, PLY, and other Assimp-supported
// formats, producing a GlbContainerResource that plugs into the existing
// asset pipeline (same instantiateRenderEntity() path as the GLB parser).
//
// Collada files with Phong/Lambert materials are automatically converted
// to PBR via shininess-to-roughness and specular-to-metalness heuristics.
//
// Custom Assimp loader (not derived from upstream).
// This is a VisuTwin-specific addition for robot/CAD visualization.
//
#pragma once
 
#include <memory>
#include <string>
 
#include "framework/parsers/glbContainerResource.h"
 
namespace visutwin::canvas
{
    class GraphicsDevice;

    struct AssimpParserConfig
    {
        float uniformScale = 1.0f;

        bool flipYZ = false;

        bool flipWinding = false;

        float smoothingAngle = 80.0f;

        bool generateTangents = true;

        bool optimizeMeshes = true;
    };
 
    class AssimpParser
    {
    public:
        static std::unique_ptr<GlbContainerResource> parse(
            const std::string& path,
            const std::shared_ptr<GraphicsDevice>& device,
            const AssimpParserConfig& config = AssimpParserConfig{});
    };
}