Erste Schritte

Erste Schritte mit Aspose.3D FOSS für Java

Willkommen bei aspose-3d-foss, eine kostenlose, Open-Source Java Bibliothek zum Laden, Erstellen und Exportieren von 3D‑Szenen. Dieses Handbuch führt Sie von einem frischen Projekt zu einer funktionierenden Szene in wenigen Minuten.

Voraussetzungen

AnforderungDetail
JavaJDK 21 oder neuer
Build-ToolMaven oder Gradle
OSWindows, macOS oder Linux

Installation

Fügen Sie die Maven-Abhängigkeit zu Ihrem pom.xml:

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

Überprüfen:

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.");
    }
}

Siehe die Installationsanleitung für die Gradle-Einrichtung und Verifizierungsschritte.

Was Sie tun können

Nach der Installation können Sie sofort:

  • Laden OBJ-, STL-, glTF 2.0 / GLB- und FBX-Dateien über scene.open()
  • Untersuchen Szenenhierarchien: durchlaufen Node Bäume, lesen Mesh Geometrie, Zugriff auf Vertex-Normalen und UVs
  • Transformieren Knoten: Translation, Rotation und Skalierung über die Transform Klasse
  • Materialien anwenden: zuweisen Material oder PbrMaterial auf Knoten
  • Exportieren in jedes unterstützte Format mit scene.save()
  • Geometrie erstellen: erstellen Mesh Objekte programmgesteuert mit Kontrollpunkten und Polygonen

Schnellstart

Lade eine 3D-Datei, gib die Szenenhierarchie aus und speichere sie erneut im GLB-Format:

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");
    }
}

Nächste Schritte

 Deutsch