Ako opraviť chyby 3D modelov v TypeScripte

Krok 1: Overenie inštalácie a verzií

Uistite sa, že používate podporovanú verziu Node.js (18, 20 alebo 22) a balík je nainštalovaný:

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

Ak balík nie je nájdený, preinštalujte:

npm install @aspose/3d

Krok 2: Opraviť chyby riešenia modulov

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

Importy podcesty vyžadujú exporty balíka Node.js 12.7+. V TypeScripte nastavte správne riešenie modulov:

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

Pre projekty ESM použite "module": "ES2022" a "moduleResolution": "bundler".

Krok 3: Ladenie prázdnej scény po načítaní

Ak je scene.rootNode.childNodes prázdny po 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}`);

Bežné príčiny:

1. Nesprávne možnosti formátu: pre OBJ vždy použite new ObjLoadOptions(). Používanie generických možností môže zabrániť detekcii formátu.

2. Cesta k súboru je nesprávna: knižnica ticho načíta prázdnu scénu, ak súbor nie je nájdený:

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 súbor používa neštandardné konce riadkov: otvorte ho v textovom editore a uistite sa, že je súbor platný.

Krok 4: Opraviť problémy so súradnicovým systémom

Modely sa môžu zobraziť otočené, zrkadlovo prevrátené alebo nesprávne škálované kvôli rozdielom v súradnicových systémoch medzi formátmi.

Pravá ruka vs ľavá ruka, Y-nahor vs Z-nahor:

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

Problémy so mierkou (napr. STL v milimetroch vs glTF v metroch):

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

Krok 5: Riešenie problémov s pamäťou pri veľkých súboroch

Pre súbory väčšie ako 100 MB zväčšite veľkosť haldy Node.js:

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

Alebo nastavte to v package.json:

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

Spracúvajte veľké súbory po jednom namiesto paralelne, aby ste predišli problémom s maximálnou spotrebou pamäte.