1. Produtos
  2.   Aspose.3D
  3.   Aspose.3D FOSS for TypeScript

Aspose.3D FOSS para TypeScript

Carregue, construa, transforme e exporte cenas 3D a partir do Node.js — totalmente tipada, de código aberto e pronta para produção com uma única instalação via npm.

Aspose.3D FOSS for TypeScript Aspose.3D FOSS
for TypeScript

Documentação GitHub

Biblioteca TypeScript de código aberto para processamento de arquivos 3D

Aspose.3D FOSS for TypeScript é uma biblioteca licenciada sob MIT para trabalhar com formatos de arquivos 3D em aplicações Node.js. Instale-a com um único comando npm install @aspose/3d e comece a ler, construir e gravar cenas 3D em TypeScript imediatamente, sem addons nativos para compilar, sem SDKs externos para instalar e sem necessidade de renderizador.

A biblioteca expõe uma API de grafo de cena totalmente tipada construída em torno de Scene, Node, Entity, Mesh, Camera, Light e Transform, o mesmo modelo conceitual usado por ferramentas 3D profissionais. O suporte a formatos inclui OBJ (Wavefront, com carregamento de material .mtl), glTF 2.0 e GLB binário (materiais PBR), STL (binário e ASCII, roundtrip completo), COLLADA (DAE), 3MF e FBX. Classes de opções por formato, como ObjLoadOptions e GltfSaveOptions, dão controle preciso sobre a orientação do sistema de coordenadas, escala, normalização de normais, saída binária vs. JSON, e carregamento de material.

Aspose.3D FOSS tem como alvo Node.js 18, 20 e 22+ com TypeScript 5.0+ e compila para CommonJS. A biblioteca é distribuída com configurações estritas do compilador TypeScript (noImplicitAny, strictNullChecks) para que sua IDE forneça autocomplete completo e segurança em tempo de compilação. Sua única dependência em tempo de execução, xmldom, é instalada automaticamente. Para a família de produtos empresariais, veja Aspose.3D — Enterprise Product Family.

Suporte a formatos 3D e API de grafo de cena tipada

  • OBJ / MTL: Carregue arquivos Wavefront OBJ com definições de material acompanhantes.
  • glTF 2.0 / GLB: Carregamento de material PBR e saída binária GLB via GltfSaveOptions.
  • STL: Leia e escreva tanto STL binário quanto ASCII com verificação completa de ida e volta.
  • COLLADA, 3MF, FBX: Suporte adicional a formatos com classes de opções por formato.
  • Tipos completos de TypeScript: Cada classe, método e opção são fortemente tipados com noImplicitAny e strictNullChecks.

Onde Aspose.3D FOSS pode ser usado

  • Node.js asset pipelines: Importar arquivos OBJ, validar e reorientar a geometria, e exportar como GLB no CI.
  • Game tooling: Processamento em lote de malhas 3D sem um motor ou renderizador nativo.
  • Fluxos de trabalho de impressão 3D: Leia, valide e reexporte arquivos STL e 3MF.
  • Backends sem servidor: Execute endpoints de conversão 3D no Lambda ou Cloud Functions.
  • Migração de conteúdo: Converta entre famílias de formatos em escala a partir de um único script.

Opções por formato e controle de coordenadas

  • Orientação do sistema de coordenadas: Inverter eixos e ajustar escala por formato com classes de opções.
  • Normalização de normais: Normalizar automaticamente as normais dos vértices ao carregar ou salvar.
  • Binário vs. saída JSON: Selecione GLB compacto ou glTF legível via GltfSaveOptions.
  • Controle de carregamento de material: Ative ou desative o carregamento de MTL/texture para análise mais rápida.
  • Fidelidade de ida e volta: Nós desconhecidos do grafo de cena são preservados literalmente ao regravar.

Experiência do desenvolvedor

Aspose.3D FOSS para TypeScript instala com um único comando npm install @aspose/3d. Não há addons nativos para compilar. A biblioteca é pura TypeScript/JavaScript com uma dependência auto‑instalada (xmldom).

A API fortemente tipada fornece preenchimento automático completo no IDE para cada classe de grafo de cena e opção de formato. A biblioteca tem como alvo Node.js 18–22+ e TypeScript 5.0+, funciona de forma idêntica em runners de CI Linux e estações de trabalho de desenvolvedores, e é MIT-licensed com um rastreador de issues aberto no GitHub.

Carregue uma cena OBJ e exporte como glTF

Instale com npm, então use scene.open() com ObjLoadOptions para carregar a malha junto com seu arquivo de material MTL. Tanto open() quanto save() são síncronos — não é necessário await ou encadeamento de Promise. Chamar scene.save() com uma extensão .gltf grava o padrão glTF 2.0 JSON — o formato é inferido automaticamente a partir da extensão do arquivo.

npm install @aspose/3d

import { Scene } from "@aspose/3d";
import { ObjLoadOptions } from "@aspose/3d/formats/obj";
const scene = new Scene();
scene.open("model.obj", new ObjLoadOptions());
// Export as glTF 2.0 JSON
scene.save("model.gltf");

Converter STL para GLB binário

Para produzir um GLB binário compacto em vez do padrão JSON glTF, passe GltfSaveOptions com binaryMode = true. Tanto open() quanto save() são síncronos — não é necessário await.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";
const scene = new Scene();
scene.open("mesh.stl");
// Save as compact binary GLB
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Perguntas Frequentes

O que é Aspose.3D FOSS para TypeScript?

É uma biblioteca gratuita, licenciada sob MIT, de TypeScript/Node.js para carregar, manipular e salvar cenas 3D sem instalar nenhum addon nativo ou SDK externo.

Quais formatos 3D são suportados?

OBJ (com .mtl), glTF 2.0 e GLB, STL (binário e ASCII), COLLADA (DAE), 3MF e FBX. Cada formato tem uma classe de opções tipada dedicada.

Ele requer addons nativos do Node.js?

Não. Aspose.3D FOSS para TypeScript é puro JavaScript/TypeScript. Não requer etapa de compilação e tem uma única dependência em tempo de execução (xmldom) instalada automaticamente pelo npm.

Como instalá-lo?

Execute npm install @aspose/3d. Nenhum pacote de sistema adicional ou addons nativos são necessários.

Quais versões do Node.js e do TypeScript são suportadas?

Node.js 18, 20 e 22+. TypeScript 5.0+. A biblioteca compila para CommonJS e funciona com configurações estritas do TypeScript.

Ele vem com definições de tipo do TypeScript?

Sim. Todas as classes, métodos, enums e tipos de opções são totalmente tipados com noImplicitAny e strictNullChecks habilitados.

Posso controlar a orientação do sistema de coordenadas?

Sim. Classes de opções por formato, como ObjLoadOptions e GltfSaveOptions, permitem inverter eixos, ajustar escala e normalizar normais sem código de análise personalizado.

Onde posso encontrar o código-fonte?

A biblioteca tem licença MIT e está hospedada no GitHub. Relatórios de bugs e pull requests são bem‑vindos.

  

Recursos de Suporte e Aprendizado

 Português