Cách Khắc Phục Lỗi Mô Hình 3D trong TypeScript

Bước 1: Xác Minh Cài Đặt và Phiên Bản

Đảm bảo bạn đang sử dụng phiên bản Node.js được hỗ trợ (18, 20 hoặc 22) và gói đã được cài đặt:

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

Nếu không tìm thấy gói, hãy cài đặt lại:

npm install @aspose/3d

Bước 2: Sửa Lỗi Giải Quyết Module

Lỗi: Cannot find module '@aspose/3d/formats/obj'

Các import theo sub‑path yêu cầu Node.js 12.7+ và xuất khẩu gói. Trong TypeScript, hãy thiết lập giải quyết module đúng:

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

Đối với các dự án ESM, sử dụng "module": "ES2022" và "moduleResolution": "bundler".

Bước 3: Gỡ Lỗi Cảnh Trống Sau Khi Tải

Nếu scene.rootNode.childNodes trống sau khi 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}`);

Nguyên nhân thường gặp:

1. Tùy chọn định dạng sai: đối với OBJ, luôn truyền new ObjLoadOptions(). Việc sử dụng các tùy chọn chung có thể ngăn việc phát hiện định dạng.
2. Đường dẫn tệp sai: thư viện sẽ im lặng tải một cảnh trống nếu không tìm thấy tệp:

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. Tệp OBJ sử dụng ký tự xuống dòng không chuẩn: mở trong trình soạn thảo văn bản và đảm bảo tệp hợp lệ.

Bước 4: Sửa các vấn đề về hệ tọa độ

Mô hình có thể xuất hiện bị xoay, phản chiếu hoặc tỷ lệ không đúng do sự khác biệt về hệ tọa độ giữa các định dạng.

Hệ thống tay phải vs tay trái, 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);

Vấn đề tỷ lệ (ví dụ: STL tính bằng milimét so với glTF tính bằng mét):

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

Bước 5: Xử lý các vấn đề bộ nhớ với tệp lớn

Đối với các tệp lớn hơn 100 MB, tăng kích thước heap của Node.js:

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

Hoặc đặt nó trong package.json:

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

Xử lý các tệp lớn từng cái một thay vì song song để tránh các vấn đề về bộ nhớ đỉnh.