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

Aspose.3D FOSS für Java

Laden, erstellen, transformieren und exportieren Sie 3D‑Szenen aus Java — kostenlos und Open-Source.

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

Dokumentation GitHub

Open-Source Java-Bibliothek für 3D-Dateiverarbeitung

Aspose.3D FOSS für Java ist eine MIT-lizenzierte, pure-Java Bibliothek zum Arbeiten mit 3D-Dateiformaten. Fügen Sie eine einzige Maven-Abhängigkeit hinzu und beginnen Sie sofort mit dem Lesen, Erstellen und Schreiben von 3D‑Szenen, ohne eine native Laufzeit, ein externes SDK oder einen Drittanbieter‑Renderer zu installieren.

Die Bibliothek stellt eine saubere Scene‑Graph‑API bereit, die um Scene, Node, Mesh, Camera und Transform herum aufgebaut ist, dem gleichen konzeptuellen Modell, das von professionellen 3D‑Werkzeugen verwendet wird. Unterstützte Formate umfassen OBJ (mit .mtl‑Materialladen), STL (binär und ASCII, Rundreise‑verifiziert), glTF 2.0 (PBR‑Materialien), GLB (binäres glTF) und FBX (nur Import). Pro‑Format‑Lade‑ und Speicheroptionen ermöglichen die Steuerung von Koordinaten‑Flip, Skalierung, Normalen‑Normalisierung und Materialladen, ohne format­spezifischen Parsing‑Code zu schreiben.

Aspose.3D FOSS erfordert Java 21 oder höher und läuft identisch auf Windows-, macOS- und Linux‑CI‑Runnern, Docker‑Containern und serverlosen Umgebungen. Es gibt keine native Erweiterung zum Kompilieren und kein Systempaket zu installieren.

Unterstützung für 3D-Formate und Scene-Graph-API

  • OBJ / MTL: Laden Sie Wavefront‑OBJ‑Dateien mit zugehörigen Materialdefinitionen.
  • STL: Lesen und schreiben Sie sowohl binäre als auch ASCII‑STL mit vollständiger Rundreise‑Verifizierung.
  • glTF 2.0 / GLB: PBR‑Materialladen und -Export über GltfSaveOptions. Verwenden Sie setContentType(FileContentType.BINARY) für GLB‑Ausgabe.
  • FBX: Importunterstützung zum Laden von FBX‑Dateien (Export nicht verfügbar).
  • Scene‑Graph‑API: Scene, Node, Mesh, Camera, Transform.

Wo Aspose.3D FOSS verwendet werden kann

  • Asset-Validierungspipelines: 3D-Assets in CI überprüfen, neu ausrichten und erneut exportieren.
  • Game-Development-Tools: OBJ- und STL-Meshes stapelweise verarbeiten, ohne eine native Engine.
  • 3D-Druck-Workflows: STL-Dateien lesen, validieren und erneut exportieren.
  • Web-Backends: Stellen Sie 3D-Konvertierungsendpunkte in Docker oder serverlosen Funktionen bereit.
  • Content-Migration: Konvertieren Sie zwischen Formatfamilien in großem Umfang.

Optionen pro Format und Koordinatensteuerung

  • Koordinatensystemorientierung: Achsen umkehren und Skalierung pro Format anpassen, ohne benutzerdefinierten Code.
  • Normalen-Normalisierung: Vertex-Normalen beim Laden oder Speichern automatisch normalisieren.
  • Material-Ladekontrolle: MTL/Texture-Laden aktivieren oder deaktivieren für schnelleres Parsen.
  • Pretty-Print-Ausgabe: Wählen Sie kompakte oder menschenlesbare glTF JSON über Optionen.
  • Round-Trip-Treue: Unbekannte Szenengraph-Knoten werden beim erneuten Speichern unverändert beibehalten.

Entwicklererfahrung

Aspose.3D FOSS für Java Installationen mit einer einzigen Maven-Abhängigkeit (com.aspose:aspose-3d-foss:26.1.0). Die Bibliothek ist reines Java, ohne native Erweiterungen zum Kompilieren und ohne Systempakete zu installieren.

Die Scene-Graph-API spiegelt das konzeptionelle Modell professioneller 3D‑Werkzeuge wider, sodass die Lernkurve für alle, die mit Three.js oder dem Datenmodell von Blender vertraut sind, kurz ist. Die Bibliothek ist unter der MIT-Lizenz, Open‑Source, und begrüßt Fehlermeldungen sowie Beiträge auf GitHub.

Lade eine OBJ‑Szene und exportiere sie als glTF

Fügen Sie die Maven-Abhängigkeit hinzu und rufen Sie dann Scene.fromFile("model.obj") auf, um die OBJ‑Datei zusammen mit ihren MTL‑Materialdefinitionen zu laden. Ein einzelner Aufruf von scene.save() mit der Erweiterung .gltf schreibt eine glTF 2.0‑JSON‑Datei, ohne dass ein Format‑Register oder ein Konverter‑Objekt benötigt wird.

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

import com.aspose.threed.*;

// Laden Sie eine OBJ-Datei (mit .mtl-Materialien)
Scene scene = Scene.fromFile("model.obj");

// Exportieren als glTF 2.0
scene.save("model.gltf");

Konvertiere STL in glTF mit GltfSaveOptions

Um eine glTF-Datei mit Koordinatensystem-Anpassungen zu erzeugen, übergeben Sie eine GltfSaveOptions-Instanz mit setFlipCoordinateSystem(true). Das gleiche Muster gilt für alle formatbezogenen Optionen — tauschen Sie die Optionsklasse gegen diejenige aus, die dem Ziel‑Format entspricht.

import com.aspose.threed.*;

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

// Als glTF mit Optionen speichern
GltfSaveOptions opts = new GltfSaveOptions();
opts.setFlipCoordinateSystem(true);
opts.setPrettyPrint(true);
scene.save("mesh.gltf", opts);

Häufig gestellte Fragen

Was ist Aspose.3D FOSS für Java?

Es ist eine kostenlose, MIT-lizenzierte pure-Java-Bibliothek zum Laden, Manipulieren und Speichern von 3D‑Szenen, ohne dass ein natives Laufzeitumfeld oder ein externes SDK installiert werden muss.

Welche 3D‑Formate werden unterstützt?

OBJ (mit .mtl), STL (binär und ASCII), glTF 2.0, GLB (binäres glTF) und FBX (nur Import). Jedes Format hat eine dedizierte Lade-/Speicher-Optionen‑Klasse.

Erfordert es native Abhängigkeiten?

Nein. Aspose.3D FOSS für Java ist reines Java ohne native Erweiterungen. Es läuft unter Windows, macOS und Linux ohne einen Kompilierungsschritt.

Wie installiere ich es?

Fügen Sie die Maven-Abhängigkeit com.aspose:aspose-3d-foss:26.1.0 zu Ihrem Projekt hinzu. Es werden keine zusätzlichen Systempakete oder nativen Erweiterungen benötigt.

Kann ich die Orientierung des Koordinatensystems steuern?

Ja. Pro-Format-Optionen‑Klassen ermöglichen das Vertauschen von Achsen, Anpassen der Skalierung und Normalisieren von Normalen, ohne format-spezifischen Parsing‑Code schreiben zu müssen.

Welche Java-Versionen werden unterstützt?

Java 21 und später werden unterstützt. Die Bibliothek läuft identisch auf allen gängigen Betriebssystemen.

Ist der Quellcode verfügbar?

Ja. Die Bibliothek ist MIT-lizenziert und wird auf GitHub gehostet. Fehlermeldungen und Pull‑Requests sind willkommen.

  

Support und Lernressourcen

 Deutsch