Kā novērst 3D modeļa kļūdas TypeScript

1. solis: Pārbaudiet instalāciju un versijas

Pārliecinieties, ka izmantojat atbalstītu Node.js versiju (18, 20 vai 22) un pakotne ir instalēta:

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

Ja pakotne nav atrasta, pārinstalējiet:

npm install @aspose/3d

2. solis: Novērst moduļa izšķiršanas kļūdas

Kļūda: Cannot find module '@aspose/3d/formats/obj'

Apakšceļu importēšanai ir nepieciešami Node.js 12.7+ pakotnes eksporti. TypeScript valodā iestatiet pareizo moduļa izšķiršanu:

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

ESM projektiem izmantojiet "module": "ES2022" un "moduleResolution": "bundler".

Solis 3: Atkļūdot tukšu ainu pēc ielādes

Ja scene.rootNode.childNodes ir tukšs pēc 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}`);

Biežākie cēloņi:

1. Kļūdainas formāta iespējas: OBJ gadījumā vienmēr nododiet new ObjLoadOptions(). Vispārīgu iespēju lietošana var novērst formāta noteikšanu.

2. Faila ceļš ir nepareizs: bibliotēka klusi ielādē tukšu ainu, ja fails nav atrasts:

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 fails izmanto nestandarta rindu beigas: atveriet to teksta redaktorā un pārliecinieties, ka fails ir derīgs.

4. solis: Novērst koordinātu sistēmas problēmas

Modeļi var parādīties pagrieztas, spoguļattēlotas vai nepareizi mērogotas koordinātu sistēmu atšķirību dēļ starp formātiem.

Labā roka pret kreiso roku, Y‑augšup pret Z‑augš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);

Mēroga problēmas (piemēram, STL milimetros pret glTF metros):

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. solis: Risināt atmiņas problēmas ar lieliem failiem

Failiem, kas lielāki par 100 MB, palieliniet Node.js kaudzes lielumu:

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

Vai iestatīt to package.json:

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

Apstrādājiet lielus failus vienu pēc viena, nevis paralēli, lai izvairītos no maksimālās atmiņas problēmām.