Guia do Desenvolvedor

O Aspose.3D FOSS para Python é uma biblioteca de código aberto, licenciada sob MIT, que permite a desenvolvedores Python carregar, construir, transformar e exportar cenas 3D sem dependências externas de tempo de execução. Seja você quem está construindo um pipeline de ativos, uma ferramenta de validação, um script de processamento de geometria ou um serviço de conversão de formatos, esta biblioteca oferece uma API limpa e consistente, sustentada por um modelo de grafo de cena 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 página é a referência principal para trabalhar com Aspose.3D FOSS para Python. Ela cobre:

  • Suporte a formatos: OBJ (com materiais .mtl), STL (binário e ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF, e o tokenizador FBX em desenvolvimento, com classes de opção de carregamento e salvamento por formato.
  • Grafo de cena: Como Scene, Node, Entity, Transform, e GlobalTransform compose em uma hierarquia completa de cena, incluindo padrões de travessia de nós filhos.
  • Mesh API: Trabalhando com control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, e VertexElementSmoothingGroup para processamento de geometria.
  • Sistema de material: Aplicando LambertMaterial e PhongMaterial aos nós da cena, e lendo propriedades de material carregadas de arquivos .mtl.
  • Utilitários de matemática: Usando Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, e BoundingBox para transformações, consultas de caixa delimitadora e cálculos geométricos.
  • Animação: Construindo e lendo AnimationClip, AnimationNode, KeyFrame, e KeyframeSequence dados.
  • Carregar e salvar opções: Classes de opções por formato, como ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Exemplos completos de uso: Scripts Python de ponta a ponta para carregar OBJ, exportar STL, fazer round‑tripping de glTF 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.

Conceitos Principais

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

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

Zero dependências: A biblioteca é pura Python. Não há extensão nativa para compilar, nenhum pacote do sistema para instalar e nenhuma biblioteca de terceiros para gerenciar.

Começando

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

Tópicos Disponíveis

 Português