So beheben Sie 3D-Modellfehler in TypeScript

Schritt 1: Installation und Versionen überprüfen

Stellen Sie sicher, dass Sie eine unterstützte Node.js-Version (18, 20 oder 22) verwenden und das Paket installiert ist:

node --version          # Must be v18 or later
npm list @aspose/3d     # Should show the installed version

Falls das Paket nicht gefunden wird, neu installieren:

npm install @aspose/3d

Schritt 2: Fehler bei der Modulauflösung beheben

Fehler: Cannot find module '@aspose/3d/formats/obj'

Sub‑Path‑Imports erfordern Paket‑Exports ab Node.js 12.7+. In TypeScript setzen Sie die korrekte Modulauflösung:

// tsconfig.json
{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "moduleResolution": "node16",
    "strict": true
  }
}

Für ESM-Projekte verwenden Sie "module": "ES2022" und "moduleResolution": "bundler".

Schritt 3: Debuggen einer leeren Szene nach dem Laden

Wenn scene.rootNode.childNodes ist leer nach scene.open():

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

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

console.log(`Child nodes: ${scene.rootNode.childNodes.length}`);

Häufige Ursachen:

1. Falsche Formatoptionen: für OBJ, immer übergeben new ObjLoadOptions(). Die Verwendung generischer Optionen kann die Format‑Erkennung verhindern.
2. Dateipfad ist falsch:Die Bibliothek lädt stillschweigend eine leere Szene, wenn die Datei nicht gefunden wird:

import * as fs from 'fs';

const filePath = 'model.obj';
if (!fs.existsSync(filePath)) {
    throw new Error(`File not found: ${filePath}`);
}
const scene = new Scene();
scene.open(filePath, new ObjLoadOptions());

1. OBJ-Datei verwendet nicht standardmäßige Zeilenenden: Öffnen Sie die Datei in einem Texteditor und stellen Sie sicher, dass sie gültig ist.

Schritt 4: Koordinatensystemprobleme beheben

Modelle können aufgrund von Unterschieden im Koordinatensystem zwischen Formaten gedreht, gespiegelt oder falsch skaliert erscheinen.

Rechte-Hand vs linke Hand, Y-up vs Z-up:

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

const options = new ObjLoadOptions();
options.flipCoordinateSystem = true;  // Swap Y and Z axes

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

Skalierungsprobleme (z. B. STL in Millimetern vs glTF in Metern):

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

const options = new ObjLoadOptions();
options.scale = 0.001;  // Convert millimeters to meters

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

Schritt 5: Speicherprobleme bei großen Dateien behandeln

Für Dateien größer als 100 MB die Node.js-Heap-Größe erhöhen:

node --max-old-space-size=4096 convert.js

Oder setzen Sie es in package.json:

{
  "scripts": {
    "convert": "node --max-old-space-size=4096 dist/convert.js"
  }
}

Verarbeite große Dateien einzeln statt parallel, um Spitzen im Speicherverbrauch zu vermeiden.