Cum să începi cu Aspose.3D FOSS pentru Java

Aspose.3D FOSS pentru Java este o bibliotecă gratuită, licențiată de MIT pentru încărcarea, manipularea și salvarea fișierelor 3D – nu sunt necesare binare native, pură Java din Maven Central.

Ghidul pas cu pas

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

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

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

import com.aspose.threed.Scene;

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

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

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

import com.aspose.threed.Scene;

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

Probleme comune și fixări

FileNotFoundException Când sună Scene.fromFile() Calea pe care o treceți nu există sau foloseste separatorul greșit. java.nio.file.Paths.get() Pentru a se asigura că ruta de fișier este corectă.

Erori de format necunoscute Asigurați-vă că extinderea fișierului se potrivește cu formatul real. biblioteca detectează format prin extinderea pentru open() şi fromFile().• Pass un parametru explicit de format pentru a supraîncărca.

Scena goală după încărcare Unele formate binare pot necesita opțiuni specifice de încărcare. încercați să utilizați o supraîncărcătură explicită cu opțiuni de încărcare dacă standardul produce o scenă goală.

UnsupportedOperationException Pentru anumite metode Unele metode (renderare scenă, marcare de apă) nu sunt disponibile în ediția FOSS. Verificați documentația limitărilor înainte de a utiliza caracteristicile avansate.

Întrebări frecvente

Aspose.3D FOSS necesită orice DLL native?

Nu. Biblioteca este pură Java cu nici dependențe native sau binare externe necesare.

Ce versiuni Java sunt susținute?

Biblioteca funcționează pe containere Windows, macOS, Linux și Docker.

Este biblioteca liberă pentru utilizare comercială?

Este eliberat în temeiul licenței MIT. Puteți să-l utilizați, să modificați și să o redistribuiți pentru orice scop, inclusiv aplicații comerciale.

Ce formate 3D pot citi și scrie?

Biblioteca susține OBJ, STL, glTF 2.0 / GLB și FBX pentru atât citirea cât și scrierea. Foloseste-te de la Scene.save() API bazată pe extensie pentru export la orice format susținut.

Pot crea o scenă 3D din scratch?

Construcţia a Scene fără argumente, adăugați noduri pentru copii la scene.getRootNode(), şi salvare în formatul dorit.

Vezi și

• FAQ — Aspose.3D FOSS pentru Java
• Cum să încărcați modele 3D în Java
• Cum să convertiți modele 3D în Java
• Începeți cu documente
• Referință API