Sådan løser du 3D‑modelfejl i TypeScript

Trin 1: Bekræft installation og versioner

Sørg for, at du bruger en understøttet Node.js-version (18, 20 eller 22), og at pakken er installeret:

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

Hvis pakken ikke findes, geninstaller:

npm install @aspose/3d

Trin 2: Ret modulopløsningsfejl

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

Sub‑sti‑importer kræver Node.js 12.7+ pakkeeksporter. I TypeScript skal du indstille den korrekte modulopløsning:

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

For ESM‑projekter skal du bruge "module": "ES2022" og "moduleResolution": "bundler".

Trin 3: Fejlfind en tom scene efter indlæsning

Hvis scene.rootNode.childNodes er 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}`);

Almindelige årsager:

1. Forkerte formatindstillinger: for OBJ, skal du altid videregive new ObjLoadOptions(). Brug af generiske indstillinger kan forhindre formatgenkendelse.

2. Filstien er forkert: biblioteket indlæser tavst en tom scene, hvis filen ikke findes:

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 bruger ikke‑standard linjeafslutninger: åbn i en teksteditor og sørg for, at filen er gyldig.

Trin 4: Løs koordinatsystemproblemer

Modeller kan fremstå roteret, spejlvendt eller skaleret forkert på grund af forskelle i koordinatsystemet mellem formater.

Højrehånd vs venstrehånd, Y-op vs Z-op:

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

Skaleringsproblemer (f.eks. 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);

Trin 5: Håndter hukommelsesproblemer med store filer

For filer, der er større end 100 MB, skal du øge Node.js‑heapstørrelsen:

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

Eller sæt den i package.json:

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

Behandl store filer én ad gangen i stedet for parallelt for at undgå toppe i hukommelsesforbruget.