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

Aspose.3D FOSS for Java

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

Aspose.3D FOSS for Java Aspose.3D FOSS
for Java

Documenti GitHub

Libreria Open-Source Java per l'elaborazione di file 3D

Aspose.3D FOSS per Java è una libreria con licenza MIT, pure-Java, per lavorare con formati di file 3D. Aggiungi una singola dipendenza Maven 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 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 (materiali PBR), GLB (glTF binario) e FBX (solo importazione). 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 richiede Java 21 o successivo e funziona identicamente su Windows, macOS e Linux CI runners, container Docker e ambienti serverless. Non c’è alcuna estensione nativa da compilare né pacchetto di sistema da installare.

Supporto ai formati 3D e API del grafo della scena

  • OBJ / MTL: Carica file Wavefront OBJ con le definizioni dei materiali corrispondenti.
  • STL: Leggi e scrivi STL sia binari che ASCII con verifica completa del roundtrip.
  • glTF 2.0 / GLB: Caricamento di materiali PBR ed esportazione tramite GltfSaveOptions. Usa setContentType(FileContentType.BINARY) per l’output GLB.
  • FBX: Supporto di importazione per caricare file FBX (esportazione non disponibile).
  • API scene-graph: Scene, Node, Mesh, Camera, Transform.

Dove Aspose.3D FOSS può essere utilizzato

  • 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 e STL senza un motore nativo.
  • Flussi di lavoro per la stampa 3D: Leggi, valida e ri-esporta file STL.
  • 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: Inverti 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 formattato: Scegli JSON glTF compatto o leggibile dall’uomo tramite opzioni.
  • Fedeltà round-trip: I nodi sconosciuti del grafo della scena sono preservati alla lettera al ri-salvataggio.

Esperienza dello sviluppatore

Aspose.3D FOSS per Java installazioni con una singola dipendenza Maven (com.aspose:aspose-3d-foss:26.1.0). La libreria è puramente Java, 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 chi conosce il modello dati di Three.js o di Blender. La libreria è rilasciata con licenza MIT, open-source, e accoglie segnalazioni di bug e contributi su GitHub.

Carica una scena OBJ ed esporta come glTF

Aggiungi la dipendenza Maven, poi chiama Scene.fromFile("model.obj") 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.

<dependency>
  <groupId>com.aspose</groupId>
  <artifactId>aspose-3d-foss</artifactId>
  <version>26.1.0</version>
</dependency>

import com.aspose.threed.*;

// Carica un file OBJ (con materiali .mtl)
Scene scene = Scene.fromFile("model.obj");

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

Converti STL in glTF con GltfSaveOptions

Per generare un file glTF con aggiustamenti del sistema di coordinate, passa un’istanza di GltfSaveOptions con setFlipCoordinateSystem(true). Lo stesso schema si applica a tutte le opzioni per formato — sostituisci la classe delle opzioni con quella del formato di destinazione.

import com.aspose.threed.*;

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

// Salva come glTF con opzioni
GltfSaveOptions opts = new GltfSaveOptions();
opts.setFlipCoordinateSystem(true);
opts.setPrettyPrint(true);
scene.save("mesh.gltf", opts);

Domande Frequenti

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

È una libreria gratuita, MIT-licensed, pure-Java 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, GLB (glTF binario) e FBX (solo importazione). Ogni formato ha una classe dedicata alle opzioni di caricamento/salvataggio.

Richiede dipendenze native?

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

Come lo installo?

Aggiungi la dipendenza Maven com.aspose:aspose-3d-foss:26.1.0 al tuo progetto. 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 Java sono supportate?

Java 21 e versioni successive sono supportati. La libreria funziona identicamente su tutti i principali sistemi operativi.

Il codice sorgente è disponibile?

Sì. La libreria è con licenza MIT ed è ospitata su GitHub. Segnalazioni di bug e pull requests sono benvenute.

  

Risorse di Supporto e Apprendimento

 Italiano