Com corregir errors de models 3D a TypeScript

Pas 1: Verificar la instal·lació i les versions

Assegureu-vos que esteu en una versió compatible de Node.js (18, 20 o 22) i que el paquet estigui instal·lat:

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

Si el paquet no es troba, reinstal·la:

npm install @aspose/3d

Pas 2: Solucionar errors de resolució de mòduls

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

Les importacions de subcamins requereixen exportacions de paquets de Node.js 12.7+. En TypeScript, establiu la resolució de mòduls correcta:

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

Per als projectes ESM, utilitzeu "module": "ES2022" i "moduleResolution": "bundler".

Pas 3: Depura una escena buida després de carregar

Si scene.rootNode.childNodes està buit després de 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}`);

Causes comuns:

1. Opcions de format incorrectes: per a OBJ, sempre passa new ObjLoadOptions(). L’ús d’opcions genèriques pot impedir la detecció del format.

2. El camí del fitxer és incorrecte: la biblioteca carrega silenciosament una escena buida si no es troba el fitxer:

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());

3. El fitxer OBJ utilitza terminacions de línia no estàndard: obre’l en un editor de text i assegura’t que el fitxer sigui vàlid.

Pas 4: Corregir problemes del sistema de coordenades

Els models poden aparèixer girats, reflectits o escalats incorrectament a causa de diferències en el sistema de coordenades entre formats.

Dreta vs esquerra, 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);

Problemes d’escala (p. ex., STL en mil·límetres vs glTF en metres):

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);

Pas 5: Gestiona els problemes de memòria amb fitxers grans

Per a fitxers de més de 100 MB, augmenta la mida del heap de Node.js:

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

O establiu‑ho a package.json:

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

Processa fitxers grans un a un en lloc d’en paral·lel per evitar problemes de memòria màxima.