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

Aspose.3D FOSS per Python

Carica, crea, trasforma ed esporta scene 3D da Python — gratuito e open source.

Aspose.3D FOSS for Python Aspose.3D FOSS
for Python

Documenti GitHub

Libreria Python open source per l'elaborazione di file 3D

Aspose.3D FOSS per Python è una libreria con licenza MIT, pure-Python, per lavorare con formati di file 3D. Installala con un unico comando pip e inizia subito a leggere, costruire e scrivere scene 3D senza installare alcun runtime nativo, SDK esterno o renderer di terze parti.

La libreria espone un’API di scene-graph pulita costruita attorno a Scene, Node, Mesh, Camera, Light e Transform, lo stesso modello concettuale usato dagli strumenti 3D professionali. Il supporto dei formati include OBJ (con caricamento dei materiali .mtl), STL (binario e ASCII, verifica roundtrip), glTF 2.0 / GLB (materiali PBR), COLLADA (DAE), 3MF e FBX. Le opzioni di caricamento e salvataggio per formato ti permettono di controllare il ribaltamento delle coordinate, la scala, la normalizzazione delle normali e il caricamento dei materiali senza scrivere codice di parsing specifico per il formato.

Aspose.3D FOSS supporta Python 3.7 fino a 3.12 e funziona identicamente su Windows, macOS e Linux CI runners, container Docker e ambienti serverless. Non c’è alcuna estensione nativa da compilare né pacchetti di sistema da installare.

Supporto ai formati 3D e API di grafo della scena

  • OBJ / MTL: Carica file Wavefront OBJ con le relative definizioni di materiale.
  • STL: Leggi e scrivi STL sia binari che ASCII con verifica completa del roundtrip.
  • glTF 2.0 / GLB: Caricamento di materiali PBR e output binario GLB tramite GltfSaveOptions.
  • COLLADA, 3MF, FBX: Supporto aggiuntivo per formati con classi di opzioni per ciascun formato.
  • API scene-graph: Scene, Node, Mesh, Camera, Light, Transform.

Dove Aspose.3D FOSS può essere usato

  • Pipeline di validazione degli asset: Verifica, ri-orienta e ri-esporta gli asset 3D nella CI.
  • Strumenti per lo sviluppo di giochi: Elabora in batch mesh OBJ/GLB senza un motore nativo.
  • Flussi di lavoro per la stampa 3D: Leggi, valida e ri-esporta file STL e 3MF.
  • Web backends: Fornisci endpoint di conversione 3D in Docker o funzioni serverless.
  • Content migration: Converti tra famiglie di formati su larga scala.

Opzioni per formato e controllo delle coordinate

  • Orientamento del sistema di coordinate: Capovolgi gli assi e regola la scala per formato senza codice personalizzato.
  • Normalizzazione delle normali: Normalizza automaticamente le normali dei vertici al caricamento o al salvataggio.
  • Controllo del caricamento dei materiali: Abilita o disabilita il caricamento di MTL/texture per una parsing più veloce.
  • Output binario vs. JSON: Scegli GLB compatto o glTF leggibile dall’uomo tramite opzioni.
  • Fedeltà round‑trip: La struttura del grafo della scena viene mantenuta durante i cicli di caricamento e salvataggio (la fedeltà di conservazione dei nodi dipende dal formato e non è verificata in modo indipendente per tutti i formati).

Esperienza dello sviluppatore

Aspose.3D FOSS per installazioni Python con un unico comando pip install aspose-3d-foss. La libreria è pura Python, senza estensioni native da compilare e senza pacchetti di sistema da installare.

L’API del grafo della scena rispecchia il modello concettuale degli strumenti 3D professionali, quindi la curva di apprendimento è breve per chiunque conosca il modello di dati di Three.js o di Blender. La libreria è rilasciata sotto licenza MIT, open-source, e accoglie segnalazioni di bug e contributi su GitHub.

Carica una scena OBJ ed esporta come glTF

Installa con pip, poi chiama Scene.open() con ObjLoadOptions per caricare il file OBJ insieme alle sue definizioni di materiale MTL. Una singola chiamata scene.save() con estensione .gltf scrive un file JSON glTF 2.0, senza necessità di un registro dei formati o di un oggetto convertitore.

pip install aspose-3d-foss

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

# Carica un file OBJ (con materiali .mtl)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())

# Esporta come glTF 2.0
scene.save("model.gltf")

Converti STL in GLB binario con inversione delle coordinate

Per produrre un GLB binario compatto invece del glTF JSON predefinito, passa un’istanza di GltfSaveOptions con binary_mode = True. Lo stesso schema si applica alle regolazioni del sistema di coordinate — sostituisci la classe delle opzioni con il formato a cui stai puntando.

from aspose.threed import Scene
from aspose.threed.formats import GltfSaveOptions

scene = Scene()
scene.open("mesh.stl")

# Salva come GLB binario
opts = GltfSaveOptions()
opts.binary_mode = True
scene.save("mesh.glb", opts)

Domande Frequenti

Che cos’è Aspose.3D FOSS per Python?

È una libreria gratuita, con licenza MIT, pure-Python per caricare, manipolare e salvare scene 3D senza installare alcun runtime nativo o SDK esterno.

Quali formati 3D sono supportati?

OBJ (con .mtl), STL (binario e ASCII), glTF 2.0 e GLB, COLLADA (DAE), 3MF e FBX. Ogni formato ha una classe dedicata alle opzioni di caricamento/salvataggio.

Richiede dipendenze native?

No. Aspose.3D FOSS per Python è pure Python senza estensioni native. Funziona su Windows, macOS e Linux senza alcun passaggio di compilazione.

Come lo installo?

Esegui pip install aspose-3d-foss. Non sono richiesti pacchetti di sistema aggiuntivi né estensioni native.

Posso controllare l’orientamento del sistema di coordinate?

Sì. Le classi di opzioni per formato ti consentono di invertire gli assi, regolare la scala e normalizzare le normali senza scrivere alcun codice di parsing specifico per il formato.

Quali versioni di Python sono supportate?

Python 3.7 a 3.12 sono supportati. La libreria funziona identicamente su tutti i principali sistemi operativi.

Il codice sorgente è disponibile?

Sì. La libreria è MIT-licensed e ospitata su GitHub. Segnalazioni di bug e pull request sono benvenute.

  

Risorse di Supporto e Apprendimento

 Italiano