Cara Membetulkan Ralat Model 3D dalam TypeScript

Langkah 1: Sahkan Pemasangan dan Versi

Pastikan anda berada pada versi Node.js yang disokong (18, 20, atau 22) dan pakej telah dipasang:

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

Jika pakej tidak ditemui, pasang semula:

npm install @aspose/3d

Langkah 2: Betulkan Ralat Penyelesaian Modul

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

Import sub‑laluan memerlukan eksport pakej Node.js 12.7+. Dalam TypeScript, tetapkan resolusi modul yang betul:

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

Untuk projek ESM, gunakan "module": "ES2022" dan "moduleResolution": "bundler".

Langkah 3: Debug Adegan Kosong Selepas Memuat

Jika scene.rootNode.childNodes kosong selepas 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}`);

Punca umum:

1. Pilihan format yang salah: untuk OBJ, sentiasa hantar new ObjLoadOptions(). Menggunakan pilihan generik boleh menghalang pengesanan format.

2. Laluan fail salah: perpustakaan memuatkan adegan kosong secara senyap jika fail tidak ditemui:

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. Fail OBJ menggunakan penghujung baris bukan piawai: buka dalam penyunting teks dan pastikan fail tersebut sah.

Langkah 4: Betulkan Isu Sistem Koordinat

Model-model mungkin kelihatan berpusing, terpantul, atau berskala tidak betul disebabkan perbezaan sistem koordinat antara format.

Tangan kanan vs tangan kiri, Y-atas vs Z-atas:

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

Masalah skala (contohnya, STL dalam milimeter vs glTF dalam 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);

Langkah 5: Tangani Isu Memori dengan Fail Besar

Untuk fail yang lebih besar daripada 100 MB, tingkatkan saiz heap Node.js:

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

Atau tetapkan ia dalam package.json:

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

Proses fail besar satu demi satu dan bukannya secara selari untuk mengelakkan masalah memori puncak.