stlParser.h

Go to the documentation of this file.

// SPDX-License-Identifier: Apache-2.0
// Copyright 2025-2026 Arnis Lektauers
//
// STL (Stereolithography) file parser for VisuTwin Canvas.
//
// Loads binary and ASCII STL geometry, producing a GlbContainerResource that
// plugs into the existing asset pipeline (same instantiateRenderEntity() path
// as the GLB and OBJ parsers).
//
// STL files have no materials, no UVs, no hierarchy, and only face normals.
// The parser provides optional crease-angle smooth normal generation and
// configurable default PBR material properties.
//
// Custom STL 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 StlParserConfig
    {
        float uniformScale = 1.0f;

        bool flipYZ = false;

        bool flipWinding = false;

        bool generateSmoothNormals = false;

        float creaseAngle = 40.0f;

        bool generateTangents = true;

        float diffuseR = 0.8f;
        float diffuseG = 0.8f;
        float diffuseB = 0.8f;

        float metalness = 0.0f;

        float roughness = 0.5f;
    };
 
    class StlParser
    {
    public:
        static std::unique_ptr<GlbContainerResource> parse(
            const std::string& path,
            const std::shared_ptr<GraphicsDevice>& device,
            const StlParserConfig& config = StlParserConfig{});
    };
}