Hur man åtgärdar 3D-modellfel i TypeScript

Steg 1: Verifiera installation och versioner

Se till att du använder en stödjande Node.js-version (18, 20 eller 22) och att paketet är installerat:

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

Om paketet inte hittas, installera om:

npm install @aspose/3d

Steg 2: Åtgärda modulupplösningsfel

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

Undermappimport kräver Node.js 12.7+ paketexport. I TypeScript, ange rätt modulupplösning:

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

För ESM‑projekt, använd "module": "ES2022" och "moduleResolution": "bundler".

Steg 3: Felsök en tom scen efter laddning

Om scene.rootNode.childNodes är tom efter 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}`);

Vanliga orsaker:

1. Fel formatalternativ: för OBJ, skicka alltid new ObjLoadOptions(). Att använda generiska alternativ kan förhindra formatdetektering.

2. Filvägen är fel: biblioteket laddar tyst en tom scen om filen inte hittas:

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 använder icke‑standard radslut: öppna i en textredigerare och säkerställ att filen är giltig.

Steg 4: Åtgärda problem med koordinatsystemet

Modeller kan visas roterade, spegelvända eller felaktigt skalade på grund av skillnader i koordinatsystem mellan format.

Högerhand vs vänsterhand, Y-up vs Z-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);

Skalproblem (t.ex. STL i millimeter vs glTF i meter):

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

Steg 5: Hantera minnesproblem med stora filer

För filer som är större än 100 MB, öka Node.js heap‑storleken:

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

Eller ställ in det i package.json:

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

Bearbeta stora filer en i taget snarare än parallellt för att undvika toppminnesproblem.