Häufig gestellte Fragen

Lizenzierung & Open Source

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

Aspose.3D FOSS für Java wird unter der MIT-Lizenz veröffentlicht. Sie können es in persönlichen, kommerziellen und offenen Projekten ohne Einschränkung verwenden. Keine Lisenzschlüssel oder Aktivierung erforderlich ist. Der Quellcode ist auf GitHub verfügbar.

Kann ich Aspose.3D FOSS für Java in einem kommerziellen Produkt verwenden?

Die MIT-Lizenz erlaubt unbegrenzte Verwendung in kommerziellen Produkten. Keine Realitätszahlung, Lizenzserver oder Internetverbindung ist zur Arbeit erforderlich.

Installation & Anforderungen

Wie kann ich Aspose.3D FOSS für Java installieren?

Maven-Abhängigkeit an Ihre pom.xml:

<dependency>
  <groupId>org.aspose</groupId>
  <artifactId>aspose-3d-foss</artifactId>
  <version>26.5.0</version>
</dependency>

Dann importieren Sie das Paket in Ihre Quelldateien:

import com.aspose.threed.*;

Welche Java-Version ist erforderlich?

Aspose.3D FOSS für Java erfordert JDK 21 oder später. Es ist vollständig selbstverhalten mit keine indigenen Abhängigkeiten und keine Plattformspezifischen Binären.

Format Unterstützung

Welche 3D-Fileformate können Aspose.3D FOSS für Java lesen und schreiben?

Die aktuelle Release unterstützt folgende Formate:

Wie kann ich das Format eines Dateien automatisch erkennen?

Gebrauch FileFormat.getFormatByExtension(filePath) Um das Format durch Dateierweiterung zu sehen:

FileFormat fmt = FileFormat.getFormatByExtension("model.gltf");
System.out.println(fmt.getCanImport()); // true
System.out.println(fmt.getCanExport()); // true

Wie kann ich Optionen für ein bestimmtes Format verwenden oder speichern?

Pass ein Format-spezifische Optionen Objekt zu Scene.open() oder Scene.save().Zum Beispiel, um die Koordinatsysteme beim Laden von GlTF zu ermöglichen:

GltfLoadOptions opts = new GltfLoadOptions();
opts.setFlipCoordinateSystem(true);

Scene scene = new Scene();
scene.open("input.gltf", opts);

Für GlTF Export mit gut gedruckten JSON:

GltfSaveOptions saveOpts = new GltfSaveOptions();
saveOpts.setPrettyPrint(true);
scene.save("output.gltf", saveOpts);

Ebenso wie, FbxLoadOptions ist für die FBX Import-Konfiguration verfügbar.

Feuerverwendung

Wie kann ich ein 3D-Modell aus einem Datei laden?

Verwenden Sie die statische Fabrik Scene.fromFile(filePath) für eine einstehende Ladung oder Konstruktion eines Scene und rufen scene.open(filePath):

// Option 1 — static factory (recommended)
Scene scene = Scene.fromFile("model.obj");

// Option 2 — instance method
Scene scene2 = new Scene();
scene2.open("model.fbx");

Wie kann ich eine neue leere Szenen erstellen und sie speichern?

Konstruktion A Scene, Noten hinzufügen, wie nötig, dann rufen Sie scene.save(filePath):

Scene scene = new Scene();
Node child = scene.getRootNode().createChildNode("Box");
scene.save("output.glb");

Wie kann ich das Scene Graph durchlaufen?

Zugang zum Root Node über scene.getRootNode() und seine Kinder iterieren:

Scene scene = Scene.fromFile("model.gltf");
Node root = scene.getRootNode();

for (Node child : root.getChildNodes()) {
    System.out.println(child.getName());
}

Wie kann ich eine Szenen in einem bestimmten Format speichern?

Pass die Ausgangsphase mit der Zielerweiterung — Aspose.3D erkennt das Format aus dem Ausweitung automatisch. Für eine ausdrückliche Kontrolle, pass a FileFormat oder Save-Options Objekt:

// Auto-detect output format from extension
scene.save("output.stl");

// Explicit format (using options object)
GltfSaveOptions opts = new GltfSaveOptions();
opts.setBufferFilePrefix("buffer_");
scene.save("output.gltf", opts);

Bekannte Einschränkungen

Ist 3D-Rendering in dieser Release verfügbar?

No. Die Scene.render() Methoden der Schießen UnsupportedOperationException In der aktuellen FOSS-Ausgabe. Rendering ist noch nicht implementiert. Verwenden Sie diese Bibliothek für die Import, Verarbeitung, und exportieren nur 3D-Szenendaten.

Sind alle FBX-Funktionen unterstützt?

FBX Import wird für Geometrie und Scene-Grafikdaten unterstützt. implementiert — rufen Sie mit FBX-Format zu speichern ExportException.Komplex FBX Importierende Funktionen wie eingebettete Animationen, Beschränkungen und proprietäre FBX Die Erweiterungen können nicht vollständig erhalten werden.