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

Aspose.3D FOSS for 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 de grafo de cena limpa 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 roundtrip), glTF 2.0 / GLB (materiais PBR), COLLADA (DAE), 3MF e FBX. Opções de carregamento e gravação por formato permitem controlar a inversão de coordenadas, escala, normalização de normais e carregamento de material sem escrever código de análise específico de formato.

Aspose.3D FOSS suporta Python 3.7 até 3.12 e funciona de forma idêntica em runners CI Windows, macOS e Linux, contêineres Docker e ambientes serverless. Não há extensão nativa para compilar nem pacote de sistema para instalar.

Suporte a Formatos 3D e API de Grafo de Cena

  • OBJ / MTL: Carregue arquivos Wavefront OBJ com definições de material acompanhantes.
  • STL: Leia e escreva STL binário e ASCII com verificação completa de roundtrip.
  • 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: Verifique, reoriente e reexporte ativos 3D na 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.
  • Content migration: Converta entre famílias de formatos em escala.

Opções por Formato e Controle de Coordenadas

  • Orientação do sistema de coordenadas: Inverta eixos e ajuste a escala por formato sem código personalizado.
  • Normalização de normais: Normaliza 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 ao longo dos ciclos de carregamento e salvamento (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 instalações Python 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 API de scene-graph 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 tem licença MIT, é 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 a extensão .gltf grava um arquivo JSON glTF 2.0, sem necessidade de registro de formato ou objeto conversor.

pip install aspose-3d-foss

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions

# Carregar um arquivo OBJ (com materiais .mtl)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())

# Exportar como glTF 2.0
scene.save("model.gltf")

Converter STL para GLB binário com inversão de coordenadas

Para gerar um GLB binário compacto em vez do glTF JSON padrão, passe uma instância de 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")

# Salvar como GLB binário
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.

Ele requer alguma dependência nativa?

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

Como faço para 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 inverter eixos, ajustar a escala e normalizar normais sem escrever código de análise específico de cada 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