Installazione

Installazione di Aspose.3D FOSS per Python

Aspose.3D FOSS per Python è distribuito come pacchetto pure-Python su PyPI. Non ci sono estensioni native da compilare, nessuna libreria di sistema da installare e non è necessario Microsoft Office o altri runtime di terze parti.

Prerequisiti

1. Install via pip (Recommended)

Il modo più semplice per installare Aspose.3D FOSS è direttamente da PyPI:

pip install aspose-3d-foss

pip scaricherà e installerà il pacchetto e lo registrerà nel tuo ambiente. Non è necessaria alcuna configurazione post‑installazione.

Per installare una versione fissata per build riproducibili:

pip install aspose-3d-foss==26.1.0

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

Utilizzare un ambiente virtuale mantiene la libreria isolata dagli altri progetti Python ed evita conflitti di versione.

Crea e attiva un ambiente virtuale:

##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

Installa la libreria all’interno dell’ambiente attivato:

pip install aspose-3d-foss

Registra le dipendenze per la riproducibilità:

pip freeze > requirements.txt

Per ricreare l’ambiente su un’altra macchina:

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

3. Verify the Installation

Dopo l’installazione, verifica che la libreria venga importata correttamente:

from aspose.threed import Scene

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

Output previsto:

Aspose.3D FOSS installed successfully
Root node name:

Nota: Il nodo radice non ha un nome predefinito — scene.root_node.name restituisce una stringa vuota.

Puoi anche verificare la versione installata con pip:

pip show aspose-3d-foss

Questo stamperà la versione, l’autore e la licenza (MIT).

Guida rapida: carica una scena e ispezionala

Il seguente script carica un file 3D, stampa le informazioni su ogni nodo mesh e riesporta la scena in 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 non hai ancora un file OBJ, la libreria può anche creare una scena da 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")

Note sulla piattaforma

Windows, macOS, Linux: La libreria è identica su tutte le piattaforme. Non ci sono percorsi di codice specifici per piattaforma o estensioni binarie.

Docker / serverless: Poiché non ci sono dipendenze da pacchetti di sistema, la libreria funziona all’interno di immagini Docker leggere (come python:3.12-slim) senza installare alcun pacchetto aggiuntivo apt o yum.

CI/CD: Aggiungi pip install aspose-3d-foss al passaggio di dipendenza del tuo pipeline CI. Non è necessaria alcuna configurazione aggiuntiva.

Conda: Se il tuo progetto utilizza Conda, installa la libreria da PyPI all’interno di un ambiente Conda:

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

Risorse aggiuntive

• Pagina del prodotto: Panoramica, riepilogo delle funzionalità e testimonianze
• Guida per sviluppatori: Riferimento API completo con esempi di codice
• Caratteristiche e funzionalità: Supporto dei formati, grafo della scena, materiali, utilità matematiche e altro