Iniziare

Aspose.3D FOSS per Python

Benvenuto a Aspose.3D FOSS per Python, una libreria gratuita, con licenza MIT, per caricare, costruire ed esportare scene 3D da Python. Questa guida ti porterà da un ambiente nuovo a una scena funzionante in pochi minuti.

Prerequisiti

Prima dell’installazione, assicurati che il tuo ambiente soddisfi questi requisiti:

Versione Python

  • Python 3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
  • CPython è l’interprete di riferimento; tutte e sei le versioni sono testate su ogni rilascio

Gestore di pacchetti

  • pip (incluso in tutte le installazioni moderne di Python)
  • Non sono richiesti altri strumenti di compilazione, compilatori o pacchetti di sistema

Sistema operativo

  • Windows, macOS e Linux sono tutti supportati
  • La libreria è pure Python: nessuna estensione nativa specifica della piattaforma da compilare

Installazione

Installa da PyPI usando pip:

pip install aspose-3d-foss

Vedi la Guida all’installazione per la configurazione dell’ambiente virtuale, i passaggi di verifica e un esempio di codice rapido.

Aspose.3D FOSS per Python

Una volta installato puoi subito:

  • Carica file OBJ (con supporto materiale .mtl), STL, glTF 2.0, GLB, COLLADA e 3MF
  • Ispeziona gerarchie della scena: attraversa i nodi, leggi le mesh, accedi alle normali dei vertici e alle UV
  • Trasforma scene: applica posizioni, rotazioni (tramite Quaternion), e scale usando Transform
  • Applica materiali: lavorare con LambertMaterial e PhongMaterial sui nodi della scena
  • Esporta in qualsiasi formato supportato con opzioni di salvataggio per formato
  • Calcola geometria: interroga le bounding box, accumula le trasformazioni nello spazio globale con GlobalTransform
  • Leggi animazione: accedi AnimationClip e KeyframeSequence dati da file glTF e COLLADA caricati

Avvio rapido

Il codice seguente carica un file di scena, stampa i figli del nodo radice e salva nuovamente la scena in formato GLB:

from aspose.threed import Scene

scene = Scene.from_file("input.obj")

print(f"Root node children: {len(scene.root_node.child_nodes)}")
for node in scene.root_node.child_nodes:
    entity_type = type(node.entity).__name__ if node.entity else "no entity"
    print(f"  {node.name} [{entity_type}]")

scene.save("output.glb")
print("Saved output.glb")

Prossimi passi

 Italiano