Ako konvertovať 3D modely v TypeScript

Aspose.3D FOSS for TypeScript konvertuje medzi 3D formátmi načítaním do neutrálnej Scene reprezentácie a uložením do cieľového formátu. Tento sprievodca ukazuje najčastejšie konverzie.

Krok za krokom sprievodca

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

Podporovaná konverzná matica

FBX nie je podporovaný prostredníctvom vysokej úrovne open()/save() API — formát nie je zapojený do automatického rozpoznávania. Všetky vyššie uvedené FBX bunky sú ✗.

Bežné problémy a riešenia

Materiály sa stratia po konverzii

Materiály OBJ (usemtl, .mtl súbor) sa načítajú, keď ObjLoadOptions.enableMaterials = true. Pri ukladaní do glTF sa vlastnosti materiálu PBR automaticky mapujú. Zložité materiály (procedurálne, viacvrstvové) sa môžu konvertovať so zníženou vernosťou.

Sieť je nesprávne škálovaná

Rôzne formáty používajú rôzne predvolené jednotky (milimetre pre STL, metre pre glTF). Použite ObjLoadOptions.scale pri načítaní alebo StlSaveOptions.scaleFactor pri ukladaní na normalizáciu jednotiek.

Nesúlad súradnicového systému (model prevrátený alebo otočený)

Niektoré formáty používajú pravý Y-up, iné Z-up. Použite ObjLoadOptions.flipCoordinateSystem = true alebo aplikujte rotáciu na koreňový uzol po načítaní.

Často kladené otázky

Zachová konverzia animácie?

Animácie sa zachovávajú pri konverzii medzi formátmi, ktoré ich podporujú (napr. COLLADA → glTF). STL a OBJ neobsahujú údaje o animácii. FBX nie je podporovaný prostredníctvom scene.open()/scene.save(), takže FBX animácie round-trips nie sú k dispozícii prostredníctvom high-level API.

Sú textúrové dáta zachované?

Textúry odkazované materiálmi OBJ alebo vložené v glTF sa prenášajú do grafu scény. Pri ukladaní do GLB (binaryMode = true) je binárny buffer vložený do jedného súboru. Pre výstup OBJ sa textúry ukladajú ako samostatné súbory vedľa .obj.

Môžem konvertovať viacero súborov paralelne?

scene.open() a scene.save() sú synchronné. Použite Node.js worker_threads na paralelné spracovanie.

Pozri tiež

• Ako načítať 3D modely v TypeScript
• Ako uložiť 3D modely v TypeScript
• Podpora formátov
• Referencie API