Как исправить ошибки 3D‑моделей в TypeScript

Шаг 1: Проверьте установку и версии

Убедитесь, что вы используете поддерживаемую версию Node.js (18, 20 или 22) и пакет установлен:

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

Если пакет не найден, переустановите:

npm install @aspose/3d

Шаг 2: Исправление ошибок разрешения модулей

Ошибка: Cannot find module '@aspose/3d/formats/obj'

Импорт подпутей требует экспорта пакетов Node.js 12.7+. В TypeScript установите правильное разрешение модулей:

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

Для ESM‑проектов используйте "module": "ES2022" и "moduleResolution": "bundler".

Шаг 3: Отладка пустой сцены после загрузки

Если scene.rootNode.childNodes пуст после 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}`);

Общие причины:

1. Неправильные параметры формата: для OBJ всегда передавайте new ObjLoadOptions(). Использование общих параметров может помешать обнаружению формата.

2. File path is wrong: библиотека молча загружает пустую сцену, если файл не найден:

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 использует нестандартные окончания строк: откройте его в текстовом редакторе и убедитесь, что файл корректен.

Шаг 4: Исправление проблем с системой координат

Модели могут отображаться повернутыми, зеркально отражёнными или масштабированными неправильно из‑за различий в системах координат между форматами.

Правосторонняя vs левосторонняя, 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);

Проблемы масштаба (например, STL в миллиметрах vs glTF в метрах):

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

Шаг 5: Обработка проблем с памятью при работе с большими файлами

Для файлов размером более 100 МБ увеличьте размер кучи Node.js:

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

Или установите его в package.json:

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

Обрабатывайте большие файлы по одному, а не параллельно, чтобы избежать проблем с пиковым потреблением памяти.