Instalação

Instalação de Aspose.3D FOSS para Python

Aspose.3D FOSS para Python é distribuído como um pacote pure-Python no PyPI. Não há extensões nativas para compilar, nem bibliotecas de sistema para instalar, e nenhum Microsoft Office ou outro runtime de terceiros é necessário.

Pré‑requisitos

1. Install via pip (Recommended)

A maneira mais simples de instalar Aspose.3D FOSS é diretamente do PyPI:

pip install aspose-3d-foss

O pip baixará e instalará o pacote e o registrará em seu ambiente. Nenhuma configuração pós-instalação é necessária.

Para instalar uma versão fixa para builds reproduzíveis:

pip install aspose-3d-foss==26.1.0

2. Set Up a Virtual Environment (Recommended for Projects)

Usar um ambiente virtual mantém a biblioteca isolada de outros projetos Python e evita conflitos de versão.

Crie e ative um ambiente virtual:

##Create the environment
python -m venv .venv

##Activate on Linux / macOS
source .venv/bin/activate

##Activate on Windows (Command Prompt)
.venv\Scripts\activate.bat

##Activate on Windows (PowerShell)
.venv\Scripts\Activate.ps1

Instale a biblioteca dentro do ambiente ativado:

pip install aspose-3d-foss

Registre as dependências para reproducibilidade:

pip freeze > requirements.txt

Para recriar o ambiente em outra máquina:

python -m venv .venv
source .venv/bin/activate   # or the Windows equivalent
pip install -r requirements.txt

3. Verify the Installation

Após a instalação, verifique se a biblioteca é importada corretamente:

from aspose.threed import Scene

scene = Scene()
print("Aspose.3D FOSS installed successfully")
print(f"Root node name: {scene.root_node.name}")

Saída esperada:

Aspose.3D FOSS installed successfully
Root node name:

Nota: O nó raiz não tem nome padrão — scene.root_node.name retorna uma string vazia.

Você também pode verificar a versão instalada com o pip:

pip show aspose-3d-foss

Isso imprimirá a versão, o autor e a licença (MIT).

Início Rápido: Carregue uma Cena e Inspecione-a

O script a seguir carrega um arquivo 3D, imprime informações sobre cada nó de malha e reexporta a cena para o formato GLB:

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

##Load an OBJ file with material support
options = ObjLoadOptions()
options.enable_materials = True
options.flip_coordinate_system = False

scene = Scene()
scene.open("model.obj", options)

##Print the scene hierarchy
print(f"Top-level nodes: {len(scene.root_node.child_nodes)}")

for node in scene.root_node.child_nodes:
    if node.entity is None:
        continue
    mesh = node.entity
    print(f"  Node: {node.name}")
    print(f"    Vertices: {len(mesh.control_points)}")
    print(f"    Polygons: {len(mesh.polygons)}")
    if node.material:
        print(f"    Material: {type(node.material).__name__}")

##Re-export to GLB (binary glTF)
scene.save("output.glb")
print("Saved output.glb")

Se ainda não possui um arquivo OBJ, a biblioteca também pode criar uma cena do zero:

from aspose.threed import Scene

##Create an empty scene and save it as glTF
scene = Scene()
scene.save("empty.gltf")
print("Created empty.gltf")

Observações sobre a Plataforma

Windows, macOS, Linux: A biblioteca é idêntica em todas as plataformas. Não há caminhos de código específicos de plataforma ou extensões binárias.

Docker / serverless: Como não há dependências de pacotes do sistema, a biblioteca funciona dentro de imagens Docker slim (como python:3.12-slim) sem instalar pacotes adicionais de apt ou yum.

CI/CD: Adicione pip install aspose-3d-foss ao passo de dependência do seu pipeline CI. Nenhuma configuração adicional é necessária.

Conda: Se o seu projeto usa Conda, instale a biblioteca a partir do PyPI dentro de um ambiente Conda:

conda create -n my-env python=3.12
conda activate my-env
pip install aspose-3d-foss

Recursos Adicionais

• Página do Produto: Visão geral, resumo de recursos e depoimentos
• Guia do Desenvolvedor: Referência completa da API com exemplos de código
• Recursos e Funcionalidades: Suporte a formatos, grafo de cena, materiais, utilitários matemáticos e muito mais