Cara Memperbaiki Kesalahan Model 3D di TypeScript

Langkah 1: Verifikasi Instalasi dan Versi

Pastikan Anda menggunakan versi Node.js yang didukung (18, 20, atau 22) dan paket sudah terpasang:

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

Jika paket tidak ditemukan, instal ulang:

npm install @aspose/3d

Langkah 2: Perbaiki Kesalahan Resolusi Modul

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

Impor sub‑path memerlukan ekspor paket Node.js 12.7+. Di TypeScript, atur resolusi modul yang benar:

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

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

Langkah 3: Debug Adegan Kosong Setelah Memuat

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

Penyebab umum:

1. Opsi format yang salah: untuk OBJ, selalu berikan new ObjLoadOptions(). Menggunakan opsi generik dapat mencegah deteksi format.

2. Jalur file salah: perpustakaan secara diam-diam memuat adegan kosong jika file tidak ditemukan:

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. File OBJ menggunakan akhir baris non-standar: buka di editor teks dan pastikan file tersebut valid.

Langkah 4: Perbaiki Masalah Sistem Koordinat

Model dapat muncul terputar, terbalik, atau berskala tidak tepat karena perbedaan sistem koordinat antara format.

Tangan kanan vs tangan kiri, 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);

Masalah skala (mis., 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 Masalah Memori dengan File Besar

Untuk file yang lebih besar dari 100 MB, tingkatkan ukuran heap Node.js:

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

Atau atur di package.json:

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

Proses file besar satu per satu daripada secara paralel untuk menghindari masalah memori puncak.