Hogyan javítsuk ki a 3D modell hibákat TypeScript-ben

Lépés 1: Telepítés és verziók ellenőrzése

Győződjön meg arról, hogy támogatott Node.js verziót (18, 20 vagy 22) használ, és a csomag telepítve van:

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

Ha a csomag nem található, telepítse újra:

npm install @aspose/3d

2. lépés: A modul feloldási hibák javítása

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

Az alútvonal importokhoz a Node.js 12.7+ csomagexportok szükségesek.
TypeScript‑ben állítsa be a megfelelő modulfeloldást:

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

ESM projektekhez használja a "module": "ES2022" és "moduleResolution": "bundler"-t.

3. lépés: Üres jelenet hibakeresése betöltés után

Ha scene.rootNode.childNodes üres a scene.open() után:

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

Gyakori okok:

1. Hibás formátum beállítások: OBJ esetén mindig adja meg new ObjLoadOptions(). Általános beállítások használata megakadályozhatja a formátum felismerését.

2. A fájl útvonala hibás: a könyvtár csendben betölt egy üres jelenetet, ha a fájl nem található:

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. OBJ file nem szabványos sorvégeket használ: nyissa meg egy szövegszerkesztőben, és ellenőrizze, hogy a fájl érvényes‑e.

4. lépés: Koordináta‑rendszer problémák javítása

A modellek elfordítva, tükrözve vagy helytelenül méretezve jelenhetnek meg a formátumok közötti koordináta‑rendszerbeli különbségek miatt.

Jobbkezes vs balkezes, Y-felfelé vs Z-felfelé:

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

Méretezési problémák (pl. STL milliméterben vs glTF méterben):

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

5. lépés: Memória problémák kezelése nagy fájlok esetén

100 MB‑nál nagyobb fájlok esetén növelje a Node.js heap méretét:

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

Vagy állítsa be a package.json‑ben:

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

Nagy fájlokat egyenként dolgozzon fel, ne párhuzamosan, hogy elkerülje a csúcs memóriahasználati problémákat.