Guia do Desenvolvedor

Aspose.3D FOSS for TypeScript é uma biblioteca de código aberto, licenciada sob MIT, que permite a desenvolvedores Node.js carregar, construir, transformar e exportar cenas 3D com total segurança de tipos TypeScript. Seja você construindo um pipeline de ativos, um serviço de conversão de formatos, uma ferramenta de validação de geometria ou um script de autoria de conteúdo 3D, esta biblioteca fornece uma API limpa e consistente, sustentada por um modelo de scene-graph que reflete os conceitos 3D padrão da indústria.

Este Guia do Desenvolvedor cobre tudo o que você precisa para ir além da instalação rápida e escrever código de processamento 3D de qualidade de produção.

O que você encontrará nesta seção

Recursos e Funcionalidades

O Recursos a página é a referência principal para trabalhar com Aspose.3D FOSS para TypeScript. Ela cobre:

  • Suporte a formatos: OBJ (com materiais .mtl), glTF 2.0 / GLB binário, STL (binário e ASCII), COLLADA (DAE), 3MF e FBX, com classes de opções de carregamento e salvamento por formato incluindo ObjLoadOptions e GltfSaveOptions.
  • Grafo de cena: Como Scene, Node, Entity, Transform, e SceneObject compõem uma hierarquia completa de cena, incluindo padrões de travessia de nós filhos.
  • API de geometria e malha:Trablhando com Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, e ReferenceMode para processamento de geometria.
  • Sistema de material: Aplicando LambertMaterial, PhongMaterial, e PbrMaterial (PBR para glTF) aos nós da cena, e lendo propriedades de material carregadas de arquivos .mtl.
  • Utilitários de matemática: Usando Vector3, Vector4, Matrix4, Quaternion, e BoundingBox para transformações, consultas de caixa delimitadora e cálculos geométricos.
  • Animação: Construindo e lendo AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, e Extrapolation dados.
  • Suporte a stream e buffer: Carregando cenas 3D da memória Buffer objetos via scene.openFromBuffer() para casos de uso serverless e streaming.
  • Exemplos completos de uso: Scripts TypeScript de ponta a ponta para carregar OBJ, exportar GLB, fazer round‑trip de STL e percorrer grafos de cena.
  • Dicas, problemas comuns e FAQ: Orientação prática para evitar armadilhas comuns no uso em produção.
  • Resumo da referência da API: Lista de referência rápida de todas as classes principais e seus métodos principais.

Conceitos‑chave

Grafo de cena: Todo o conteúdo 3D em Aspose.3D FOSS é representado como uma árvore de Node objetos enraizados em scene.rootNode. Cada nó pode carregar um Entity (como um Mesh, Camera, ou Light) e um Transform que o posiciona na hierarquia.

API agnóstica a formatos: Você abre qualquer formato suportado através de scene.open() ou scene.openFromBuffer() e salva para qualquer formato suportado através de scene.save(). Os mesmos objetos de grafo de cena são usados independentemente do formato de origem ou destino.

Tipagem forte TypeScript: A biblioteca vem com configurações estritas do compilador (noImplicitAny, strictNullChecks) e definições de tipo completas. Cada classe, método e propriedade de opção é totalmente tipada, proporcionando autocompletar no IDE e segurança em tempo de compilação ao longo do seu código de processamento 3D.

Dependência única: A única dependência em tempo de execução é xmldom, que é instalado automaticamente pelo npm. Não há addons nativos para compilar e nem pacotes de sistema para instalar.

Começando

Se ainda não instalou a biblioteca, veja a Começando seção e o Instalação guia antes de continuar a leitura.

Tópicos Disponíveis

 Português