Wie man 3D-Modelle in TypeScript lädt

Der @aspose/3d Das Paket bietet TypeScript- und Node.js-Anwendungen eine unkomplizierte API zum Öffnen von 3D‑Szenendateien. Scene ist das Wurzelobjekt: Aufruf scene.open() mit einem Dateipfad und optionalen formatabhängigen Ladeoptionen, dann traversieren scene.rootNode um auf Geometrie, Materialien und Transformationen zuzugreifen.

Schritt-für-Schritt-Anleitung

npm install @aspose/3d

##tsconfig.json: minimum required settings
{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "strict": true
  }
}

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

import { GltfLoadOptions } from '@aspose/3d/formats/gltf';
import { FbxLoadOptions } from '@aspose/3d/formats/fbx';
import { StlLoadOptions } from '@aspose/3d/formats/stl';

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const scene = new Scene();
const options = new ObjLoadOptions();
options.enableMaterials = true;

scene.open('model.obj', options);
console.log('Scene loaded successfully');

import * as fs from 'fs';
import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const buffer = fs.readFileSync('model.obj');
const scene = new Scene();
scene.openFromBuffer(buffer, new ObjLoadOptions());

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());

function visitNode(node: any, depth: number = 0): void {
    const indent = '  '.repeat(depth);
    console.log(`${indent}Node: ${node.name}`);
    if (node.entity) {
        console.log(`${indent}  Entity type: ${node.entity.constructor.name}`);
    }
    for (const child of node.childNodes) {
        visitNode(child, depth + 1);
    }
}

visitNode(scene.rootNode);

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());

for (const node of scene.rootNode.childNodes) {
    if (!node.entity) continue;
    const entity = node.entity;
    // Check if the entity is a Mesh by duck-typing controlPoints
    if ('controlPoints' in entity) {
        const mesh = entity as any;
        console.log(`Mesh "${node.name}": ${mesh.controlPoints.length} vertices`);
        // Print first three vertices
        for (let i = 0; i < Math.min(3, mesh.controlPoints.length); i++) {
            const v = mesh.controlPoints[i];
            console.log(`  v[${i}]: x=${v.x.toFixed(4)}, y=${v.y.toFixed(4)}, z=${v.z.toFixed(4)}`);
        }
    }
}

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const options = new ObjLoadOptions();
options.enableMaterials = true;   // parse .mtl file if present

const scene = new Scene();
scene.open('model.obj', options);

// Inspect materials attached to nodes
for (const node of scene.rootNode.childNodes) {
    if (node.material) {
        console.log(`Material on "${node.name}": ${node.material.constructor.name}`);
    }
}

Häufige Probleme und Lösungen

Fehler: Modul ‘@aspose/3d/formats/obj’ nicht gefunden Die Format-Unterpfade erfordern Node.js‑12.7+ Paket‑Exports. Stellen Sie sicher, dass Sie Node.js 18 oder neuer verwenden. Wenn Sie TypeScript benutzen, setzen Sie "moduleResolution": "node16" oder "bundler" in tsconfig.json.

scene.rootNode.childNodes ist nach open() leer Einige OBJ‑Dateien verwenden nicht standardmäßige Zeilenenden oder haben keinen abschließenden Zeilenumbruch. Überprüfen Sie, ob die Datei ein gültiges OBJ ist, indem Sie sie in einem Texteditor öffnen. Stellen Sie außerdem sicher, dass Sie übergeben haben ObjLoadOptions und nicht ein generisches LoadOptions: die format‑spezifischen Optionen sind für die korrekte Weiterleitung erforderlich.

controlPoints‑Array hat Länge 0 Das Mesh wurde möglicherweise geladen, enthält aber keine Geometrie (z. B. eine leere Gruppe im OBJ). Verwenden Sie mesh.polygonCount um vor dem Durchlaufen der Vertices zu prüfen.

Der Speicherverbrauch ist bei großen Dateien hoch Laden‑von‑Puffer mit scene.openFromBuffer() reduziert den Spitzenverbrauch nicht: Die gesamte Datei muss geparst werden. Bei großen Dateien (> 100 MB) stellen Sie sicher, dass Ihr Node.js‑Prozess über genügend Heap verfügt: node --max-old-space-size=4096 yourScript.js.

Typfehler: ’entity’ ist vom Typ ‘unknown’ Der entity Eigenschaft ist breit typisiert. Cast zu any oder zu einer spezifischen Klasse (Mesh, Camera, usw.) abhängig davon, was Sie in Ihrer Szene erwarten.

Häufig gestellte Fragen (FAQ)

Welche Formate können mit scene.open() geladen werden? OBJ, glTF 2.0 (.gltf + .bin), GLB, STL, 3MF, FBX und COLLADA (.dae) werden alle für den Import unterstützt. Übergeben Sie die entsprechende *LoadOptions Klasse für jedes Format.

Kann ich eine Datei laden, ohne Optionen anzugeben? Ja. scene.open('model.glb') funktioniert ohne Optionen für Formate, die keine spezielle Konfiguration benötigen. Das Übergeben von Optionen wird für OBJ empfohlen, da die Materialauflösung davon abhängt enableMaterials.

Wird das Laden asynchron ausgeführt? Nein. scene.open() und scene.openFromBuffer() sind synchron. Wickeln Sie sie in einen Worker-Thread ein oder setImmediate wenn Sie die Ereignisschleife reaktionsfähig halten müssen.

Wird der OBJ-Export unterstützt? Ja. OBJ-Export wird unterstützt über scene.save('output.obj'). Der .mtl Materialdatei wird automatisch neben der .obj Datei.

Wo wird die .mtl-Datei beim Laden von OBJ erwartet? Standardmäßig sucht der Parser nach der .mtl Datei, die im OBJ (mtllib Direktive) relativ zum Verzeichnis der OBJ-Datei. Stellen Sie sicher, dass beide Dateien im selben Ordner liegen.

Siehe auch

• Wie exportiere ich 3D‑Szenen nach glTF/GLB in TypeScript
• API‑Referenz: Scene
• API‑Referenz: ObjLoadOptions
• npm: @aspose/3d