Wie man mit Aspose.3D FOSS für Java beginnt

Aspose.3D FOSS für Java ist eine kostenlose, MIT-Lizenzbibliothek für die Laden, Manipulation und Speicherung von 3D-Filen – keine native binären erforderlich, reine Java von Maven Central.

Schritt für Schritt Guide

Schritt 1: Add the Maven Dependency

Fügen Sie die folgenden Abhängigkeit an Ihre pom.xml (Java 21 oder später erforderlich):

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

Überprüfen Sie die installierte korrekt geladen:

import com.aspose.threed.*;
Scene s = new Scene();
System.out.println("Aspose.3D loaded.");

Schritt 2: Import erforderlichen Klassen

Import der Kernklassen für Szenenladung und Manipulation:

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

Schritt 3: Laden Sie eine 3D-Datei herunter

Gebrauch Scene.fromFile() um alle unterstützten Formate zu laden. Die Bibliothek erkennt das Format automatisch aus der Dateierweiterung:

import com.aspose.threed.Scene;

Scene scene = Scene.fromFile("model.obj");
System.out.println("Loaded scene with root node: " + scene.getRootNode().getName());

Oder verwenden Sie die open() Die Instanzmethode:

Scene scene = new Scene();
scene.open("model.glb");

Schritt 4: Überqueren Sie den Scene Graph

Eine beladenen Szene ist ein Baum von Node Objekte, die in den 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);

Schritt 5: Speichern Sie in ein anderes Format

Gebrauch Scene.save() für den Export in jedes unterstützte Ausgangsformat. Die Bibliothek erkennt die Ausgangsformat aus der Dateierweiterung:

import com.aspose.threed.Scene;

Scene scene = Scene.fromFile("model.obj");
scene.save("output.glb");
System.out.println("Saved as GLB.");

Gemeinsame Probleme und Fixes

FileNotFoundException Wenn Sie rufen Scene.fromFile() Der Weg, den Sie durchlaufen, existiert nicht oder verwendet den falschen Separator. java.nio.file.Paths.get() Um sicherzustellen, dass die Datei-Path korrekt ist.

Unbekannte Formatfehler Sicherstellen, dass die Datei-Erweiterung dem tatsächlichen Format entspricht. Die Bibliothek erkennt das Format durch Erweiterung für open() und fromFile(). Pass eine ausdrückliche Formatparameter zu überriden.

Leere Szenen nach dem Laden Einige binäre Formate können spezifische Ladungsoptionen benötigen. versuchen Sie, eine explicite Überlastung zu verwenden mit Ladungsoptionen, wenn die Standard-Szenen eine leere Szene produzieren.

UnsupportedOperationException Für bestimmte Methoden Einige Methoden (Szenen rendering, watermarking) sind nicht in der FOSS-Edition verfügbar. Überprüfen Sie die Dokumentation der Einschränkungen, bevor Sie fortgeschrittene Funktionen verwenden.

Häufig gestellte Fragen

Braucht Aspose.3D FOSS irgendwelche indigenen DLLs?

Die Bibliothek ist sauber Java mit keine native Abhängigkeiten oder externe Binären erforderlich.

Welche Java-Versionen werden unterstützt?

Die Bibliothek läuft auf Windows, macOS, Linux und Docker-Kontinern.

Ist die Bibliothek für kommerzielle Nutzung frei?

Sie können es für jeden Zweck verwenden, modifizieren und umverteilen, einschließlich kommerzieller Anwendungen.

Welche 3D-Formate kann ich lesen und schreiben?

Die Bibliothek unterstützt OBJ, STL, glTF 2.0 / GLB und FBX für Lesen und Schreiben. Verwenden Sie die Scene.save() API-Entwicklung, die in alle unterstützten Formate exportiert werden kann.

Kann ich eine 3D-Szenen aus Schrauben erstellen?

Konstruktion A Scene ohne Argumente, fügen Sie Kindernoten zu scene.getRootNode(),und auf das gewünschte Format.