Instal·lació

Requereix Python 3.7–3.12. Instal·lació amb ‘pip install aspose-3d-foss’.

Aspose.3D FOSS per a Python (aspose-3d-foss) és un programari de codi obert publicat sota la Llicència MIT. Pot utilitzar-lo en productes comercials, projectes de codi obert, eines internes i investigació sense restricció. No es requereix cap clau de llicència, clau d’API, token mesurat o registre.

Requisits previs

1. Install via pip (Recommended)

La manera més senzilla d’instal·lar Aspose.3D FOSS és directament des de PyPI:

pip install aspose-3d-foss

pip descarregarà i instal·larà el paquet i l’enregistrarà al teu entorn. No cal cap configuració postinstal·lació.

Per instal·lar una versió fixa per a construccions reproduïbles:

pip install aspose-3d-foss==26.1.0

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

Utilitzar un entorn virtual manté la biblioteca aïllada d’altres projectes Python i evita conflictes de versions.

Crea i activa un entorn 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

Instal·la la biblioteca dins de l’entorn activat:

pip install aspose-3d-foss

Enregistra les dependències per a la reproduïbilitat:

pip freeze > requirements.txt

Per recrear l’entorn en una altra màquina:

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

3. Verify the Installation

Després d’instal·lar, verifica que la biblioteca s’importi correctament:

from aspose.threed import Scene

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

Producció prevista:

Aspose.3D FOSS installed successfully
Root node name: RootNode

També pots comprovar la versió instal·lada amb pip:

pip show aspose-3d-foss

Això imprimirà la versió, l’autor i la llicència (MIT).

Inici ràpid: Carrega una escena i inspecciona-la

El següent script carrega un fitxer 3D, imprimeix informació sobre cada node de malla i reexporta l’escena al format 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")

Si encara no tens un fitxer OBJ, la biblioteca també pot crear una escena des de 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")

Notes de plataforma

Windows, macOS, Linux: La biblioteca és idèntica a totes les plataformes. No hi ha camins de codi específics de plataforma ni extensions binàries.

Docker / serverless: Com que no hi ha dependències de paquets del sistema, la biblioteca funciona dins d’imatges Docker slim (com ara python:3.12-slim) sense instal·lar cap paquet addicional d’apt o yum.

CI/CD: Afegeix pip install aspose-3d-foss al pas de dependències del teu pipeline CI. No cal cap configuració addicional.

Conda: Si el teu projecte utilitza Conda, instal·la la biblioteca des de PyPI dins d’un entorn Conda:

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

Recursos addicionals

• Pàgina del producte: Visió general, resum de característiques i testimonis
• Guia del desenvolupador: Referència completa de l’API amb exemples de codi
• Característiques i funcionalitats: Suport de formats, graf de escena, materials, utilitats matemàtiques i més