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 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 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, 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.

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 STL binário e ASCII com verificação de round‑trip completa.
  • COLLADA, 3MF, FBX: Suporte adicional a formatos com classes de opções por formato.
  • Full TypeScript types: Cada classe, método e opção são fortemente tipados com noImplicitAny e strictNullChecks.

Onde Aspose.3D FOSS pode ser usado

  • Pipelines de ativos Node.js: Importe arquivos OBJ, valide e reoriente a geometria, e exporte como GLB na CI.
  • Ferramentas de jogo: 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.
  • Back‑ends 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: Inverta eixos e ajuste a escala por formato com classes de opções.
  • Normalização de normais: Normaliza automaticamente as normais dos vértices ao carregar ou salvar.
  • Saída binária vs. JSON: Selecione GLB compacto ou glTF legível via GltfSaveOptions.
  • Controle de carregamento de material: Ative ou desative o carregamento de MTL/textura 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 é puro TypeScript/JavaScript com uma dependência auto‑instalada (xmldom).

A API fortemente tipada fornece autocomplete 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 identicamente em runners de CI Linux e estações de trabalho de desenvolvedores, e é licenciada sob MIT com um rastreador de issues aberto no GitHub.

Carregue uma cena OBJ e exporte como glTF

Instale com npm, então use o método síncrono scene.open() com ObjLoadOptions para carregar a malha junto com seu arquivo de material MTL. Chamar scene.save() com a extensão .gltf grava JSON padrão glTF 2.0; 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());

// Exportar como JSON glTF 2.0
scene.save("model.gltf");

Converter STL para GLB binário

Para gerar um GLB binário compacto em vez do glTF JSON padrão, passe GltfSaveOptions com binaryMode = true.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";

const scene = new Scene();
scene.open("mesh.stl");

// Salvar como GLB binário compacto
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 possui uma classe de opções tipada dedicada.

Ele requer addons nativos do Node.js?

Não. Aspose.3D FOSS for 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 tipos 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 a 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