feat: support loading multiple model formats (.stl, .obj, .3mf) and update UI accordingly

This commit is contained in:
CNCKitchen
2026-03-28 16:30:41 +01:00
parent a41b500bf2
commit 76eb1c7998
5 changed files with 315 additions and 25 deletions
+283 -2
View File
@@ -1,7 +1,10 @@
import { STLLoader } from 'three/addons/loaders/STLLoader.js';
import { OBJLoader } from 'three/addons/loaders/OBJLoader.js';
import { unzipSync } from 'fflate';
import * as THREE from 'three';
const loader = new STLLoader();
const stlLoader = new STLLoader();
const objLoader = new OBJLoader();
/**
* Load an STL from a File object.
@@ -13,7 +16,7 @@ export function loadSTLFile(file) {
const reader = new FileReader();
reader.onload = (e) => {
try {
const geometry = loader.parse(e.target.result);
const geometry = stlLoader.parse(e.target.result);
setupGeometry(geometry);
const bounds = computeBounds(geometry);
resolve({ geometry, bounds });
@@ -64,3 +67,281 @@ export function getTriangleCount(geometry) {
? geometry.index.count / 3
: pos.count / 3;
}
/**
* Load an OBJ from a File object.
* Returns { geometry, bounds }.
*/
export function loadOBJFile(file) {
return new Promise((resolve, reject) => {
const reader = new FileReader();
reader.onload = (e) => {
try {
const group = objLoader.parse(e.target.result);
const geometry = mergeGroupGeometries(group);
setupGeometry(geometry);
const bounds = computeBounds(geometry);
resolve({ geometry, bounds });
} catch (err) {
reject(err);
}
};
reader.onerror = () => reject(new Error('Could not read file'));
reader.readAsText(file);
});
}
/**
* Load a 3MF from a File object.
* Custom parser that handles Bambu Studio / PrusaSlicer multi-file 3MF
* where meshes live in 3D/Objects/ subfiles referenced via the production
* extension (p:path on <component> elements).
* Returns { geometry, bounds }.
*/
export function load3MFFile(file) {
return new Promise((resolve, reject) => {
const reader = new FileReader();
reader.onload = (e) => {
try {
const geometry = parse3MF(new Uint8Array(e.target.result));
setupGeometry(geometry);
const bounds = computeBounds(geometry);
resolve({ geometry, bounds });
} catch (err) {
reject(err);
}
};
reader.onerror = () => reject(new Error('Could not read file'));
reader.readAsArrayBuffer(file);
});
}
// ── Custom 3MF parser ────────────────────────────────────────────────────────
function parse3MF(data) {
const files = unzipSync(data);
const decoder = new TextDecoder();
const parser = new DOMParser();
// Helper: read a file from the zip (keys may have or lack leading slash)
function readXML(path) {
const clean = path.replace(/^\//, '');
const bytes = files[clean] || files['/' + clean];
if (!bytes) return null;
return parser.parseFromString(decoder.decode(bytes), 'application/xml');
}
// Namespace-aware element queries
const NS_CORE = 'http://schemas.microsoft.com/3dmanufacturing/core/2015/02';
const NS_PROD = 'http://schemas.microsoft.com/3dmanufacturing/production/2015/06';
function getAttr(el, ns, name) {
return el.getAttributeNS(ns, name) || el.getAttribute(ns.split('/').pop() + ':' + name);
}
// Parse all model files and collect objects by (filePath, id)
// objectMap: "path#id" → { vertices: Float32Array, triangles: Uint32Array }
const objectMap = new Map();
// Find all .model files in the zip
const modelPaths = Object.keys(files).filter(f => f.endsWith('.model'));
for (const path of modelPaths) {
const doc = readXML(path);
if (!doc) continue;
const objects = doc.getElementsByTagNameNS(NS_CORE, 'object');
for (const obj of objects) {
const id = obj.getAttribute('id');
const meshEl = obj.getElementsByTagNameNS(NS_CORE, 'mesh')[0];
if (!meshEl) continue; // component-only object, no inline mesh
const vertEls = meshEl.getElementsByTagNameNS(NS_CORE, 'vertex');
const triEls = meshEl.getElementsByTagNameNS(NS_CORE, 'triangle');
const vertices = new Float32Array(vertEls.length * 3);
for (let i = 0; i < vertEls.length; i++) {
vertices[i * 3] = parseFloat(vertEls[i].getAttribute('x'));
vertices[i * 3 + 1] = parseFloat(vertEls[i].getAttribute('y'));
vertices[i * 3 + 2] = parseFloat(vertEls[i].getAttribute('z'));
}
const triangles = new Uint32Array(triEls.length * 3);
for (let i = 0; i < triEls.length; i++) {
triangles[i * 3] = parseInt(triEls[i].getAttribute('v1'), 10);
triangles[i * 3 + 1] = parseInt(triEls[i].getAttribute('v2'), 10);
triangles[i * 3 + 2] = parseInt(triEls[i].getAttribute('v3'), 10);
}
// Normalise path for lookup (strip leading slash, use forward slashes)
const normPath = path.replace(/^\//, '').replace(/\\/g, '/');
objectMap.set(normPath + '#' + id, { vertices, triangles });
}
}
if (objectMap.size === 0) throw new Error('No mesh data found in 3MF file');
// Resolve the root model's build items → collect (objectRef, transform) pairs
// Then recursively expand components to get final (meshRef, worldTransform) list.
const rootPath = modelPaths.find(p => /^3D\/3dmodel\.model$/i.test(p.replace(/^\//, '')))
|| modelPaths[0];
const rootDoc = readXML(rootPath);
const rootNorm = rootPath.replace(/^\//, '').replace(/\\/g, '/');
// Collect final mesh instances: { meshKey, matrix }
const instances = [];
function parseTransform(str) {
if (!str) return new THREE.Matrix4();
const v = str.trim().split(/\s+/).map(Number);
if (v.length === 12) {
// 3MF row-major 3×4: m00 m01 m02 m10 m11 m12 m20 m21 m22 tx ty tz
return new THREE.Matrix4().set(
v[0], v[3], v[6], v[9],
v[1], v[4], v[7], v[10],
v[2], v[5], v[8], v[11],
0, 0, 0, 1,
);
}
return new THREE.Matrix4();
}
function resolveObject(filePath, objectId, parentMatrix) {
const normFile = filePath.replace(/^\//, '').replace(/\\/g, '/');
const key = normFile + '#' + objectId;
// If this object has a mesh, emit an instance
if (objectMap.has(key)) {
instances.push({ meshKey: key, matrix: parentMatrix.clone() });
}
// Also check for components (the object may have both mesh + components,
// or only components referencing other objects)
const doc = readXML(filePath);
if (!doc) return;
const objects = doc.getElementsByTagNameNS(NS_CORE, 'object');
for (const obj of objects) {
if (obj.getAttribute('id') !== objectId) continue;
const components = obj.getElementsByTagNameNS(NS_CORE, 'component');
for (const comp of components) {
const compObjId = comp.getAttribute('objectid');
// p:path attribute tells us which file the referenced object lives in
let compPath = comp.getAttributeNS(NS_PROD, 'path')
|| comp.getAttribute('p:path')
|| filePath;
if (!compPath.startsWith('/') && !compPath.startsWith('3D')) {
compPath = '/' + compPath;
}
const compTransform = parseTransform(comp.getAttribute('transform'));
const combined = parentMatrix.clone().multiply(compTransform);
resolveObject(compPath, compObjId, combined);
}
}
}
// Start from <build> items in root model
const buildItems = rootDoc.getElementsByTagNameNS(NS_CORE, 'item');
if (buildItems.length > 0) {
for (const item of buildItems) {
const objId = item.getAttribute('objectid');
const itemTransform = parseTransform(item.getAttribute('transform'));
resolveObject(rootPath, objId, itemTransform);
}
} else {
// No build section — just use all meshes directly
for (const [key] of objectMap) {
instances.push({ meshKey: key, matrix: new THREE.Matrix4() });
}
}
if (instances.length === 0) {
// Fallback: use all parsed meshes
for (const [key] of objectMap) {
instances.push({ meshKey: key, matrix: new THREE.Matrix4() });
}
}
// Build non-indexed BufferGeometry from all instances
let totalTris = 0;
for (const inst of instances) {
const mesh = objectMap.get(inst.meshKey);
if (mesh) totalTris += mesh.triangles.length / 3;
}
const positions = new Float32Array(totalTris * 9);
let writeOffset = 0;
const tmpV = new THREE.Vector3();
for (const inst of instances) {
const mesh = objectMap.get(inst.meshKey);
if (!mesh) continue;
const { vertices, triangles } = mesh;
for (let t = 0; t < triangles.length; t += 3) {
for (let v = 0; v < 3; v++) {
const vi = triangles[t + v];
tmpV.set(vertices[vi * 3], vertices[vi * 3 + 1], vertices[vi * 3 + 2]);
tmpV.applyMatrix4(inst.matrix);
positions[writeOffset++] = tmpV.x;
positions[writeOffset++] = tmpV.y;
positions[writeOffset++] = tmpV.z;
}
}
}
const geometry = new THREE.BufferGeometry();
geometry.setAttribute('position', new THREE.BufferAttribute(positions, 3));
return geometry;
}
/**
* Unified loader: dispatches to the right parser based on file extension.
*/
export function loadModelFile(file) {
const ext = file.name.split('.').pop().toLowerCase();
if (ext === 'obj') return loadOBJFile(file);
if (ext === '3mf') return load3MFFile(file);
return loadSTLFile(file);
}
/**
* Extract and merge all mesh geometries from a Group (OBJ/3MF) into a single
* non-indexed BufferGeometry suitable for the texturizer pipeline.
*/
function mergeGroupGeometries(group) {
const geometries = [];
group.traverse((child) => {
if (child.isMesh && child.geometry) {
// Apply the mesh's world transform to the geometry
const geo = child.geometry.clone();
child.updateWorldMatrix(true, false);
geo.applyMatrix4(child.matrixWorld);
// Convert indexed → non-indexed so vertex layout matches our pipeline
if (geo.index) {
geometries.push(geo.toNonIndexed());
geo.dispose();
} else {
geometries.push(geo);
}
}
});
if (geometries.length === 0) throw new Error('No mesh data found in file');
if (geometries.length === 1) return geometries[0];
// Merge multiple geometries into one
const totalVerts = geometries.reduce((sum, g) => sum + g.attributes.position.count, 0);
const mergedPos = new Float32Array(totalVerts * 3);
let mergedNrm = null;
const hasNormals = geometries.every(g => g.attributes.normal);
if (hasNormals) mergedNrm = new Float32Array(totalVerts * 3);
let offset = 0;
for (const g of geometries) {
const posArr = g.attributes.position.array;
mergedPos.set(posArr, offset * 3);
if (hasNormals && mergedNrm) {
mergedNrm.set(g.attributes.normal.array, offset * 3);
}
offset += g.attributes.position.count;
g.dispose();
}
const merged = new THREE.BufferGeometry();
merged.setAttribute('position', new THREE.BufferAttribute(mergedPos, 3));
if (mergedNrm) merged.setAttribute('normal', new THREE.BufferAttribute(mergedNrm, 3));
return merged;
}