Kuinka korjata 3D-mallin virheet TypeScriptissä

Vaihe 1: Vahvista asennus ja versiot

Varmista, että käytössäsi on tuettu Node.js -versio (18, 20 tai 22) ja että paketti on asennettu:

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

Jos pakettia ei löydy, asenna se uudelleen:

npm install @aspose/3d

Vaihe 2: Korjaa moduulien resoluutiovirheet

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

Alipolkujen tuonnit vaativat Node.js 12.7+ pakettiviennit. TypeScriptissä aseta oikea moduuliresoluutio:

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

ESM-projekteissa, käytä "module": "ES2022" ja "moduleResolution": "bundler".

Vaihe 3: Vianmääritys tyhjälle kohtaukselle latauksen jälkeen

Jos scene.rootNode.childNodes on tyhjä sen jälkeen 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}`);

Yleisiä syitä:

1. Väärät formaattivalinnat: OBJ:lle, lähetä aina new ObjLoadOptions(). Käyttämällä geneerisiä asetuksia voidaan estää formaatin tunnistus.
2. Tiedostopolku on väärä: kirjasto lataa hiljaisesti tyhjän kohtauksen, jos tiedostoa ei löydy:

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-tiedosto käyttää epästandardeja rivinvaihtoja: avaa tekstieditorissa ja varmista, että tiedosto on kelvollinen.

Vaihe 4: Korjaa koordinaatistojärjestelmän ongelmat

Mallit saattavat näyttää kiertyneiltä, peilatuilta tai väärin skaalatuilta koordinaatistojärjestelmän erojen vuoksi formaattien välillä.

Oikeakätinen vs vasenkätinen, Y-ylös vs Z-ylös:

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

Skaalausongelmat (esim. STL millimetreinä vs glTF metreinä):

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

Vaihe 5: Käsittele muistiin liittyvät ongelmat suurten tiedostojen kanssa

Tiedostoille, jotka ovat suurempia kuin 100 MB, kasvata Node.js:n heap-kokoa:

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

Tai aseta se kohteessa package.json:

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

Käsittele suuria tiedostoja yksi kerrallaan sen sijaan, että tekisit sen rinnakkain, jotta vältetään huippumuistiongelmat.