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

Aspose.3D FOSS para Python

Carregue, crie, transforme e exporte cenas 3D a partir de Python — gratuito e de código aberto.

Aspose.3D FOSS for Python Aspose.3D FOSS
for Python

Documentação GitHub

Biblioteca Python de Código Aberto para Processamento de Arquivos 3D

Aspose.3D FOSS para Python é uma biblioteca licenciada sob MIT, pure-Python, para trabalhar com formatos de arquivos 3D. Instale-a com um único comando pip e comece imediatamente a ler, construir e gravar cenas 3D sem instalar nenhum runtime nativo, SDK externo ou renderizador de terceiros.

A biblioteca expõe uma API limpa de grafo de cena construída em torno de Scene, Node, Mesh, Camera, Light e Transform, o mesmo modelo conceitual usado por ferramentas 3D profissionais. O suporte a formatos inclui OBJ (com carregamento de material .mtl), STL (binário e ASCII, verificado em ida e volta), glTF 2.0 / GLB (materiais PBR), COLLADA (DAE), 3MF e FBX. Opções de carregamento e salvamento por formato permitem controlar a inversão de coordenadas, escala, normalização de normais e carregamento de material sem escrever nenhum código de análise específico ao formato.

Aspose.3D FOSS suporta Python 3.7 até 3.12 e executa de forma idêntica no Windows, macOS e Linux CI runners, contêineres Docker e ambientes serverless. Para recursos e suporte corporativos, veja Aspose.3D for Python — Enterprise Product.

Suporte a Formatos 3D e API de Grafo de Cena

  • OBJ / MTL: Carregar arquivos Wavefront OBJ com definições de material acompanhantes.
  • STL: Leia e escreva STL tanto binário quanto ASCII com verificação completa de ida e volta.
  • glTF 2.0 / GLB: Carregamento de material PBR e saída binária GLB via GltfSaveOptions.
  • COLLADA, 3MF, FBX: Suporte adicional a formatos com classes de opções por formato.
  • API de grafo de cena: Scene, Node, Mesh, Camera, Light, Transform.

Onde Aspose.3D FOSS pode ser usado

  • Pipelines de validação de ativos: Verificar, reorientar e reexportar ativos 3D no CI.
  • Ferramentas de desenvolvimento de jogos: Processamento em lote de malhas OBJ/GLB sem um motor nativo.
  • Fluxos de trabalho de impressão 3D: Leia, valide e reexporte arquivos STL e 3MF.
  • Web backends: Sirva endpoints de conversão 3D em Docker ou funções serverless.
  • Migração de conteúdo: Converta entre famílias de formato em escala.

Opções por Formato e Controle de Coordenadas

  • Orientação do sistema de coordenadas: Inverter eixos e ajustar escala por formato sem código personalizado.
  • Normal normalization: Normalizar automaticamente as normais dos vértices ao carregar ou salvar.
  • Controle de carregamento de material: Ative ou desative o carregamento de MTL/textura para análise mais rápida.
  • Saída binária vs. JSON: Escolha GLB compacto ou glTF legível por humanos via opções.
  • Fidelidade de ida e volta: A estrutura do grafo de cena é mantida entre ciclos de carregamento e gravação (a fidelidade de preservação de nós depende do formato e não foi verificada independentemente para todos os formatos).

Experiência do desenvolvedor

Aspose.3D FOSS para Python instala com um único comando pip install aspose-3d-foss. A biblioteca é pura Python, sem extensões nativas para compilar e sem pacotes de sistema para instalar.

A scene-graph API reflete o modelo conceitual das ferramentas 3D profissionais, portanto a curva de aprendizado é curta para quem está familiarizado com o modelo de dados do Three.js ou do Blender. A biblioteca é MIT-licensed, open-source, e aceita relatórios de bugs e contribuições no GitHub.

Carregue uma cena OBJ e exporte como glTF

Instale com pip, então chame Scene.open() com ObjLoadOptions para carregar o arquivo OBJ junto com suas definições de material MTL. Uma única chamada scene.save() com uma extensão .gltf grava um arquivo glTF 2.0 JSON — não é necessário registro de formato ou objeto conversor.

pip install aspose-3d-foss

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions
# Load an OBJ file (with .mtl materials)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())
# Export as glTF 2.0
scene.save("model.gltf")

Converter STL para Binary GLB com inversão de coordenadas

Para produzir um GLB binário compacto em vez do padrão JSON glTF, passe uma instância GltfSaveOptions com binary_mode = True. O mesmo padrão se aplica a ajustes de sistema de coordenadas — troque a classe de opções pelo formato que você está direcionando.

from aspose.threed import Scene
from aspose.threed.formats import GltfSaveOptions
scene = Scene()
scene.open("mesh.stl")
# Save as binary GLB
opts = GltfSaveOptions()
opts.binary_mode = True
scene.save("mesh.glb", opts)

Perguntas Frequentes

O que é Aspose.3D FOSS para Python?

É uma biblioteca gratuita, licenciada sob MIT, pure-Python para carregar, manipular e salvar cenas 3D sem instalar nenhum runtime nativo ou SDK externo.

Quais formatos 3D são suportados?

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

Requer alguma dependência nativa?

Não. Aspose.3D FOSS para Python é puro Python sem extensões nativas. Executa-se no Windows, macOS e Linux sem nenhuma etapa de compilação.

Como instalá-lo?

Execute pip install aspose-3d-foss. Nenhum pacote de sistema adicional ou extensões nativas são necessários.

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

Sim. Classes de opções por formato permitem que você inverta eixos, ajuste a escala e normalize as normais sem escrever nenhum código de análise específico de formato.

Quais versões do Python são suportadas?

Python 3.7 a 3.12 são suportados. A biblioteca funciona identicamente em todos os principais sistemas operacionais.

O código-fonte está disponível?

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