Guida per sviluppatori

Aspose.3D FOSS per Python è una libreria open-source con licenza MIT che consente agli sviluppatori Python di caricare, costruire, trasformare ed esportare scene 3D senza dipendenze runtime esterne. Che tu stia costruendo una pipeline di asset, uno strumento di validazione, uno script di elaborazione geometrica o un servizio di conversione di formati, questa libreria fornisce un’API pulita e coerente supportata da un modello di grafo di scena che rispecchia i concetti 3D standard del settore.

Questa Guida per sviluppatori copre tutto ciò di cui hai bisogno per andare oltre l’installazione rapida e scrivere codice di elaborazione 3D di qualità produzione.

Cosa troverai in questa sezione

Caratteristiche e funzionalità

Il Caratteristiche la pagina è il riferimento principale per lavorare con Aspose.3D FOSS per Python. Copre:

  • Supporto dei formati: OBJ (con materiali .mtl), STL (binario e ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF, e il tokenizer FBX in fase di sviluppo, con classi di opzioni di caricamento e salvataggio per ogni formato.
  • Grafico della scena: Come Scene, Node, Entity, Transform, e GlobalTransform comporre in una gerarchia completa della scena, includendo i pattern di attraversamento dei nodi figlio.
  • Mesh API: Lavorare con control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, e VertexElementSmoothingGroup per l’elaborazione della geometria.
  • Sistema di materiali: Applicare LambertMaterial e PhongMaterial ai nodi della scena, e alla lettura delle proprietà dei materiali caricate dai file .mtl.
  • Utility matematiche: Utilizzando Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, e BoundingBox per trasformazioni, query di bounding-box e calcoli geometrici.
  • Animazione: Costruzione e lettura AnimationClip, AnimationNode, KeyFrame, e KeyframeSequence dati.
  • Opzioni di caricamento e salvataggio: Classi di opzioni per formato come ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Esempi di utilizzo completi:Script Python end-to-end per il caricamento di OBJ, l’esportazione di STL, il round-tripping di glTF e l’attraversamento dei grafi della scena.
  • Suggerimenti, problemi comuni e FAQ: Indicazioni pratiche per evitare le insidie comuni nell’uso in produzione.
  • Riepilogo della documentazione API: Elenco di riferimento rapido di tutte le classi chiave.

Concetti chiave

Grafo della scena: Tutti i contenuti 3D in Aspose.3D FOSS sono rappresentati come un albero di Node oggetti radicati in scene.root_node. Ogni nodo può trasportare un Entity (come un Mesh, Camera, o Light) e un Transform che lo posiziona nella gerarchia.

API indipendente dal formato: Si apre qualsiasi formato supportato tramite Scene.open() oppure Scene.from_file() e si salva in qualsiasi formato supportato tramite Scene.save(). Gli stessi oggetti del grafo della scena vengono utilizzati indipendentemente dal formato di origine o di destinazione.

Zero dipendenze: La libreria è pura Python. Non c’è alcuna estensione nativa da compilare, nessun pacchetto di sistema da installare e nessuna libreria di terze parti da gestire.

Per iniziare

Se non hai ancora installato la libreria, consulta il Per iniziare sezione e il Installazione guida prima di continuare a leggere.

Argomenti disponibili

 Italiano