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

Aspose.3D FOSS for TypeScript

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

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

Documentação GitHub

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

Aspose.3D FOSS para 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 um API de grafo de cena totalmente tipado construído 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, round‑trip 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 materiais.

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 ofereç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 ao formato 3D e API de gráficos tipados para cenas

  • ** OBJ / MTL:** Carregar os ficheiros de Obj Wavefront com as definições dos materiais que lhes acompanham.
  • glTF 2.0 / GLB: Carregamento de material PBR e saída binária do GDB através da GltfSaveOptions.
  • STL: Ler e escrever STL binário e ASCII com verificação completa de ida e volta.
  • COLLADA, 3MF, FBX: Suporte adicional de formatos com classes opcionais por formato.
  • ** Tipos de TypeScript completos:** Cada classe, método e opção são fortemente digitados com noImplicitAny e strictNullChecks.

Onde Aspose.3D FOSS pode ser usado

  • ** Pipelines de ativos Node.js:** Importa arquivos OBJ, valida e reorienta geometria e exporta como GLB em CI.
  • ** Ferramentas de jogo:** Melas 3D processadas em lotes sem um motor ou renderização nativo.
  • ** Fluxos de trabalho de impressão 3D:** Ler, validar e reexportar arquivos STL e 3MF.
  • ** Backends sem servidor:** Execute os pontos finais de conversão 3D em Lambda ou Cloud Functions.
  • Migração de conteúdo: Converte entre famílias de formatos em escala a partir de um único script.

Opções de formato e controlo das coordenadas

  • ** Orientação do sistema de coordenadas:** Alterna os eixos e ajusta a escala por formato com classes opcionais.
  • Normalização normal: Normaliza automaticamente os valores normais do vértice quando carregado ou salvo.
  • Portação binária vs. JSON: Selecione GLB compacto ou glTF legível via GltfSaveOptions.
  • ** Controle de carregamento do material:** Ativar ou desativar o carrega­mento MTL/texturas para uma análise mais rápida.
  • Fidelidade de ida e volta: Os nós gráficos desconhecidos da cena são preservados literalmente na re-save.

Experiência de desenvolvedor

Aspose.3D FOSS para TypeScript instala com um único comando npm install @aspose/3d. Não há adições nativas para compilar. A biblioteca é pura Type Script / JavaScript com uma dependência auto-instalada (xmldom).

A API fortemente digitada fornece autocompletamento IDE completo para cada classe e opção de formato do gráfico da cena. A biblioteca tem como alvo o Node.js 1822+ e TypeScript 5.0+, funciona idênticamente em corredores CI Linux e estações de trabalho de desenvolvedor, e é licenciado pelo MIT com um rastreador de problemas aberto no GitHub .

Carregar uma cena OBJ e Exportar como glTF

Instalar com npm, em seguida, usar scene.open() com ObjLoadOptions para carregar a malha junto com seu arquivo de material MTL. Ambos open() e save() são sincrônicos não há await ou é necessário encadeamento Promise . Chamando scene.save() uma extensão .gltf escreve padrão glTF 2.0 JSON ?? o formato é inferido automaticamente da extensor do arquivos.

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");

Converte STL em GLB binário

Para produzir um GLB binário compacto em vez do JSON glTF padrão, passe GltfSaveOptions com binaryMode = true. Ambos open() e 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, com licença do MIT TypeScript/Node.js para carregar, manipular e salvar cenas 3D sem instalar nenhum addon nativo ou SDK externo.

Que 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 tipadas dedicada.

Requer adições nativas do Node.js?

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

Como é que o instalo?

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

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

Node.js 18, 20 e 22+. TypeScript 5.0+. A biblioteca compila para CommonJS e trabalha com configurações de Type Script estritas.

Ele fornece definições de tipos TypeScript?

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

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

Sim. Classes de opções por formato, como ObjLoadOptions e GltfSaveOptions permitem que você volte os eixos, ajuste o escalonamento e normalize as normas sem código de análise personalizado.

Onde posso encontrar o código-fonte?

A biblioteca é licenciada pelo MIT e hospedada no GitHub. Os relatórios de bugs e solicitações de extração são bem-vindos.

  

Recursos de Suporte e Aprendizado

 Português