Iniziare

Iniziare con Aspose.3D FOSS per Java

Benvenuto in aspose-3d-foss, una libreria Java gratuita e open-source per il caricamento, la costruzione e l’esportazione di scene 3D. Questa guida ti porta da un progetto nuovo a una scena funzionante in pochi minuti.

Prerequisiti

Installazione

Aggiungi la dipendenza Maven al tuo pom.xml:

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

Verifica:

import com.aspose.threed.Scene;

public class Main {
    public static void main(String[] args) {
        Scene scene = new Scene();
        System.out.println("aspose-3d-foss loaded successfully.");
    }
}

Vedi il Guida all’installazione per la configurazione di Gradle e i passaggi di verifica.

Cosa Puoi Fare

Una volta installato puoi subito:

• Carica File OBJ, STL, glTF 2.0 / GLB e FBX tramite scene.open()
• Ispeziona gerarchie della scena: attraversa Node alberi, leggi Mesh geometria, accedi alle normali dei vertici e alle UV
• Trasforma nodi: imposta traslazione, rotazione e scala tramite il Transform classe
• Applica materiali: assegna Material o PbrMaterial ai nodi
• Esporta in qualsiasi formato supportato con scene.save()
• Crea geometria: crea Mesh oggetti programmaticamente con punti di controllo e poligoni

Avvio Rapido

Carica un file 3D, stampa la gerarchia della scena e salva nuovamente in formato GLB:

import com.aspose.threed.Scene;
import com.aspose.threed.Node;

public class QuickStart {
    public static void main(String[] args) throws Exception {
        Scene scene = new Scene();
        scene.open("input.obj");

        System.out.println("Root children: " + scene.getRootNode().getChildNodes().size());
        for (Node node : scene.getRootNode().getChildNodes()) {
            String entityType = node.getEntity() != null
                ? node.getEntity().getClass().getSimpleName()
                : "no entity";
            System.out.println("  " + node.getName() + " [" + entityType + "]");
        }

        scene.save("output.glb");
        System.out.println("Saved output.glb");
    }
}

Passi successivi

• Guida all’installazione: configurazione e verifica Maven/Gradle
• Guida per sviluppatori: supporto dei formati, operazioni su mesh, materiali e trasformazioni
• Caratteristiche e funzionalità: Analisi approfondita di ogni area funzionale con esempi Java