Cum să convertești modele 3D în TypeScript

Aspose.3D FOSS for TypeScript convertește între formatele 3D prin încărcarea într-o reprezentare neutră Scene și salvarea în formatul țintă. Acest ghid prezintă cele mai comune conversii.

Ghid pas cu pas

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

Matrice de conversie acceptată

FBX nu este suportat prin API‑ul de nivel înalt open()/save() — formatul nu este integrat în detectarea automată. Toate celulele FBX de mai sus sunt ✗.

Probleme comune și soluții

Materialele se pierd după conversie

Materialele OBJ (usemtl, .mtl fișier) sunt încărcate când ObjLoadOptions.enableMaterials = true. La salvarea în glTF, proprietățile materialului PBR sunt mapate automat. Materialele complexe (procedurale, multi‑strat) pot fi convertite cu fidelitate redusă.

Mesh apare scalat incorect

Formatele diferite utilizează unități implicite diferite (milimetri pentru STL, metri pentru glTF). Utilizați ObjLoadOptions.scale la încărcare sau StlSaveOptions.scaleFactor la salvare pentru a normaliza unitățile.

Neconcordanță a sistemului de coordonate (model întors sau rotit)

Unele formate folosesc Y‑up cu mâna dreaptă, altele Z‑up. Folosiți ObjLoadOptions.flipCoordinateSystem = true sau aplicați o rotație nodului rădăcină după încărcare.

Întrebări frecvente

Conversia păstrează animațiile?

Datele de animație sunt păstrate la conversia între formatele care le suportă (de exemplu, COLLADA → glTF). STL și OBJ nu conțin date de animație. FBX nu este suportat prin scene.open()/scene.save(), astfel încât rotunjirile de animație FBX nu sunt disponibile prin API-ul de nivel înalt.

Este păstrat datele de textură?

Texturile la care se face referire în materialele OBJ sau încorporate în glTF sunt transmise graficii scenei. Când se salvează în GLB (binaryMode = true), bufferul binar este încorporat într-un singur fișier. Pentru ieșirea OBJ, texturile sunt salvate ca fișiere separate alături de .obj.

Pot să convertesc multe fișiere în paralel?

scene.open() și scene.save() sunt sincrone. Folosiți Node.js worker_threads pentru procesare paralelă.

Vezi și

• Cum să încărcați modele 3D în TypeScript
• Cum să salvați modele 3D în TypeScript
• Suport pentru formate
• Referință API