objParser.h

Go to the documentation of this file.

// SPDX-License-Identifier: Apache-2.0
// Copyright 2025-2026 Arnis Lektauers
//
// OBJ + MTL file parser for VisuTwin Canvas.
//
// Loads Wavefront OBJ geometry and companion MTL materials using tinyobjloader,
// producing a GlbContainerResource that plugs into the existing asset pipeline
// (same instantiateRenderEntity() path as the GLB parser).
//
// Custom OBJ loader (not derived from upstream).
// This is a VisuTwin-specific addition for robot visualization.
//
#pragma once
 
#include <memory>
#include <string>
 
#include "framework/parsers/glbContainerResource.h"
 
namespace visutwin::canvas
{
    class GraphicsDevice;

    struct ObjParserConfig
    {
        float uniformScale = 1.0f;

        bool flipYZ = false;

        bool flipWinding = false;

        bool generateNormals = true;

        bool generateTangents = true;

        std::string mtlSearchPath;
    };
 
    class ObjParser
    {
    public:
        static std::unique_ptr<GlbContainerResource> parse(
            const std::string& path,
            const std::shared_ptr<GraphicsDevice>& device,
            const ObjParserConfig& config = ObjParserConfig{});
    };
}