Come iniziare con Aspose.3D FOSS per Java
Aspose.3D FOSS per Java è una biblioteca gratuita, con licenza MIT per il caricamento, la manipolazione e lo salvataggio di file 3D – nessun binario nativo richiesto, pura Java da Maven Central.
Guida passo dopo passo
Passo 1: Aggiungi la dipendenza Maven
Aggiungi la seguente dipendenza al tuo pom.xml (Java 21 o successiva richiesto):
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-3d-foss</artifactId>
<version>26.1.0</version>
</dependency>Verificare l’installazione caricata correttamente:
import com.aspose.threed.*;
Scene s = new Scene();
System.out.println("Aspose.3D loaded.");Passo 2: Importazioni di classi richieste
Importare le classi chiave per la carica e la manipolazione della scena:
import com.aspose.threed.Scene;
import com.aspose.threed.Node;Passo 3: Caricare un file 3D
Utilizzo Scene.fromFile() per caricare qualsiasi formato supportato. la biblioteca rileva il formato automaticamente dalla estensione del file:
import com.aspose.threed.Scene;
Scene scene = Scene.fromFile("model.obj");
System.out.println("Loaded scene with root node: " + scene.getRootNode().getName());o usare il open() Metodo di instanza:
Scene scene = new Scene();
scene.open("model.glb");Passo 4: attraversare il grafico della scena
Una scena caricata è un albero di Node oggetti radicati in scene.getRootNode():
import com.aspose.threed.Node;
import com.aspose.threed.Scene;
void walk(Node node, int depth) {
String indent = " ".repeat(depth * 2);
System.out.println(indent + "Node: " + node.getName());
for (Node child : node.getChildNodes()) {
walk(child, depth + 1);
}
}
Scene scene = Scene.fromFile("model.obj");
walk(scene.getRootNode(), 0);Passo 5: Salva in un formato diverso
Utilizzo Scene.save() per esportare in qualsiasi formato di uscita supportato. la biblioteca rileva il Il formato di uscita dalla estensione del file:
import com.aspose.threed.Scene;
Scene scene = Scene.fromFile("model.obj");
scene.save("output.glb");
System.out.println("Saved as GLB.");Problemi e fissazioni comuni
FileNotFoundException Quando chiamare Scene.fromFile() Il percorso che hai attraversato non esiste o utilizza il separatore sbagliato. java.nio.file.Paths.get() Per assicurarsi che il file path sia corretto.
errore di formato sconosciuto Assicurarsi che l’estensione del file corrisponda al formato reale. la biblioteca rileva il formato da estensione per open() e fromFile().Passare un parametro esplicito di formato per superare.
Scena vuota dopo il carico Alcuni formati binari potrebbero richiedere opzioni di carico specifiche. provare ad utilizzare un’eccezionale sovraccarica con opzioni di carico se la scena predefinita produce una scena vuota.
UnsupportedOperationException Per alcuni metodi Alcuni metodi (rendering di scena, watermarking) non sono disponibili nella versione FOSS. Verificare la documentazione delle limitazioni prima di utilizzare le funzionalità avanzate.
Domande frequenti
Aspose.3D FOSS richiede DLL nativi?
La biblioteca è pura Java senza dipendenze native o binari esterni richiesti.
Quali versioni Java sono supportate?
La biblioteca funziona su Windows, macOS, Linux e Docker.
La biblioteca è gratuita per uso commerciale?
È rilasciato sotto la licenza MIT. Puoi utilizzarla, modificarla e redistribuirla per qualsiasi scopo, comprese le applicazioni commerciali.
Quali formati 3D posso leggere e scrivere?
La biblioteca supporta OBJ, STL, glTF 2.0 / GLB e FBX per la lettura e l’insegnamento. Utilizzare il Scene.save() API basato sull’estensione per esportare in qualsiasi formato supportato.
Posso creare una scena 3D da scratch?
Sì, costruire una Scene senza argomenti, aggiungere i nodi per bambini a scene.getRootNode(),e salvo nel formato desiderato.