Kako popraviti pogreške 3D modela u TypeScriptu

Korak 1: Provjerite instalaciju i verzije

Provjerite jeste li na podržanoj verziji Node.js-a (18, 20 ili 22) i da je paket instaliran:

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

Ako paket nije pronađen, ponovno ga instalirajte:

npm install @aspose/3d

Korak 2: Popravite pogreške razrješavanja modula

Greška: Cannot find module '@aspose/3d/formats/obj'

Uvozi pod‑putanja zahtijevaju izvoz paketa Node.js 12.7+. U TypeScriptu postavite ispravno razrješavanje modula:

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

Za ESM projekte, koristite "module": "ES2022" i "moduleResolution": "bundler".

Korak 3: Otklonite praznu scenu nakon učitavanja

Ako scene.rootNode.childNodes je prazno nakon 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}`);

Uobičajeni uzroci:

1. Pogrešne opcije formata: za OBJ, uvijek proslijedite new ObjLoadOptions(). Korištenje generičkih opcija može spriječiti otkrivanje formata.
2. Putanja do datoteke je pogrešna: biblioteka tiho učitava praznu scenu ako datoteka nije pronađena:

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 datoteka koristi nestandardne završetke redaka: otvorite u tekstualnom editoru i provjerite je li datoteka valjana.

Korak 4: Ispravi probleme koordinatnog sustava

Modeli se mogu činiti rotiranim, zrcaljenim ili nepravilno skaliranim zbog razlika u koordinatnim sustavima između formata.

Desna ruka vs lijeva ruka, Y-gore vs Z-gore:

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

Problemi sa skaliranjem (npr. STL u milimetrima vs glTF u metrima):

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

Korak 5: Rješavanje problema s memorijom kod velikih datoteka

Za datoteke veće od 100 MB, povećajte veličinu Node.js hrpe:

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

Ili postavite to u package.json:

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

Obradjujte velike datoteke jednu po jednu, umjesto paralelno, kako biste izbjegli probleme s vršnom memorijom.