Как да конвертирате 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‑нагоре, други Z‑нагоре. Използвайте 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 справка