Como Converter Modelos 3D em TypeScript

Aspose.3D FOSS for TypeScript converte entre formatos 3D carregando em uma representação neutra Scene e salvando no formato de destino. Este guia mostra as conversões mais comuns.

Guia passo a passo

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

Matriz de Conversão Suportada

FBX não é suportado via a API de alto nível open()/save() — o formato não está integrado à detecção automática. Todas as células FBX acima são ✗.

Problemas Comuns e Soluções

Materiais são perdidos após a conversão

Materiais OBJ (usemtl, .mtl arquivo) são carregados quando ObjLoadOptions.enableMaterials = true. Ao salvar para glTF, as propriedades de material PBR são mapeadas automaticamente. Materiais complexos (procedurais, multi‑camada) podem ser convertidos com fidelidade reduzida.

A malha aparece dimensionada incorretamente

Formatos diferentes usam unidades padrão diferentes (milímetros para STL, metros para glTF). Use ObjLoadOptions.scale ao carregar ou StlSaveOptions.scaleFactor ao salvar para normalizar as unidades.

Incompatibilidade de sistema de coordenadas (modelo invertido ou rotacionado)

Alguns formatos usam Y‑up à direita, outros Z‑up. Use ObjLoadOptions.flipCoordinateSystem = true ou aplique uma rotação ao nó raiz após o carregamento.

Perguntas Frequentes

A conversão preserva animações?

Os dados de animação são preservados ao converter entre formatos que os suportam (por exemplo, COLLADA → glTF). STL e OBJ não carregam dados de animação. FBX não é suportado via scene.open()/scene.save(), portanto as conversões de ida e volta de animação FBX não estão disponíveis através da API de alto nível.

Os dados de textura são preservados?

Texturas referenciadas por materiais OBJ ou incorporadas no glTF são mantidas no grafo de cena. Ao salvar para GLB (binaryMode = true), o buffer binário é incorporado em um único arquivo. Para saída OBJ, as texturas são salvas como arquivos separados ao lado do .obj.

Posso converter vários arquivos em paralelo?

scene.open() e scene.save() são síncronos. Use Node.js worker_threads para processamento paralelo.

Veja Também

• Como Carregar Modelos 3D em TypeScript
• Como Salvar Modelos 3D em TypeScript
• Suporte a Formatos
• Referência da API