Как конвертировать 3D модели в TypeScript

Aspose.3D FOSS for TypeScript преобразует между 3D‑форматами, загружая их в нейтральное Scene представление и сохраняя в целевой формат. Это руководство показывает наиболее распространённые преобразования.

Пошаговое руководство

npm install @aspose/3d

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const scene = new Scene();
const opts = new ObjLoadOptions();
opts.enableMaterials = true;
scene.open('model.obj', opts);

// OBJ → glTF binary (GLB)
scene.save('output.glb');

// OBJ → STL
scene.save('output.stl');

// OBJ → COLLADA
scene.save('output.dae');

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());
scene.save('model.glb');
console.log('Converted OBJ → GLB');

import { Scene } from '@aspose/3d';

const scene = new Scene();
scene.open('model.glb');
scene.save('model.stl');
console.log('Converted GLB → STL');

import { Scene } from '@aspose/3d';

const scene = new Scene();
scene.open('model.dae');
scene.save('model.3mf');
console.log('Converted COLLADA → 3MF');

import * as fs from 'fs';
import * as path from 'path';
import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const inputDir = './input';
const outputDir = './output';

fs.mkdirSync(outputDir, { recursive: true });

const objFiles = fs.readdirSync(inputDir).filter(f => f.endsWith('.obj'));

for (const file of objFiles) {
    const inputPath = path.join(inputDir, file);
    const outputFile = file.replace('.obj', '.glb');
    const outputPath = path.join(outputDir, outputFile);

    const scene = new Scene();
    scene.open(inputPath, new ObjLoadOptions());
    scene.save(outputPath);

    console.log(`Converted ${file} → ${outputFile}`);
}

Поддерживаемая матрица преобразования

FBX не поддерживается через высокоуровневый open()/save() API — формат не подключён к автоматическому определению. Все ячейки FBX выше отмечены ✗.

Распространённые проблемы и решения

Материалы теряются после конвертации

Материалы OBJ (usemtl, .mtl файл) загружаются, когда ObjLoadOptions.enableMaterials = true. При сохранении в glTF свойства материалов PBR автоматически сопоставляются. Сложные материалы (процедурные, многослойные) могут конвертироваться с пониженной точностью.

Сетка отображается с неправильным масштабом

Разные форматы используют разные единицы измерения по умолчанию (миллиметры для STL, метры для glTF). Используйте ObjLoadOptions.scale при загрузке или StlSaveOptions.scaleFactor при сохранении для нормализации единиц.

Несоответствие системы координат (модель перевёрнута или повернута)

Некоторые форматы используют правостороннюю систему координат Y‑up, другие — Z‑up. Используйте ObjLoadOptions.flipCoordinateSystem = true или примените вращение к корневому узлу после загрузки.

Часто задаваемые вопросы

Сохраняет ли преобразование анимацию?

Данные анимации сохраняются при конвертации между форматами, которые их поддерживают (например, COLLADA → glTF). STL и OBJ не содержат данные анимации. FBX не поддерживается через scene.open()/scene.save(), поэтому обратные преобразования анимации FBX недоступны через высокоуровневый API.

Сохраняются ли данные текстуры?

Текстуры, на которые ссылаются материалы OBJ или встроенные в glTF, переносятся в граф сцены. При сохранении в GLB (binaryMode = true) бинарный буфер встраивается в один файл. При выводе OBJ текстуры сохраняются как отдельные файлы рядом с .obj.

Могу ли я конвертировать несколько файлов параллельно?

scene.open() и scene.save() являются синхронными. Используйте Node.js worker_threads для параллельной обработки.

См. также

• Как загрузить 3D‑модели в TypeScript
• Как сохранить 3D‑модели в TypeScript
• Поддержка форматов
• Справочник API