Kako započeti sa Aspose.3D FOSS za Java

Aspose.3D FOSS za Java je besplatna, MIT-licencirana biblioteka za učitavanje, manipulaciju i čuvanje 3D datoteka — nije potreban nijedan nativni binarni fajl, čisti Java sa Maven Central.

Vodič korak po korak

Korak 1: Dodajte Maven zavisnost

Dodajte sledeću zavisnost u vaš pom.xml (Java 21 ili noviji je potreban):

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

Proverite da li je instalacija učitana ispravno:

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

Korak 2: Uvezite potrebne klase

Uvezite osnovne klase za učitavanje i manipulaciju scenom:

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

Korak 3: Učitajte 3D fajl

Koristite Scene.fromFile() za učitavanje bilo kog podržanog formata. Biblioteka otkriva format automatski iz ekstenzije fajla:

import com.aspose.threed.Scene;

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

Ili koristite open() metoda instance:

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

Korak 4: Prođite kroz graf scene

Učitana scena je stablo od Node objekata ukorenjenih u 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);

Korak 5: Sačuvajte u drugi format

Koristite Scene.save() za izvoz u bilo koji podržani izlazni format. Biblioteka otkriva izlazni format iz ekstenzije fajla:

import com.aspose.threed.Scene;

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

Uobičajeni problemi i popravke

FileNotFoundException prilikom pozivanja Scene.fromFile() Putanja koju ste naveli ne postoji ili koristi pogrešan separator. Koristite apsolutnu putanju ili java.nio.file.Paths.get() da biste osigurali da je putanja do fajla ispravna.

Greška: nepoznat format Osigurajte da se ekstenzija fajla podudara sa stvarnim formatom. Biblioteka otkriva format po ekstenziji za open() i fromFile(). Proslijedite eksplicitni parametar formata da biste prepisali.

Prazna scena nakon učitavanja Neki binarni formati mogu zahtevati specifične opcije učitavanja. Pokušajte da koristite eksplicitno preopterećenje sa opcijama učitavanja ako podrazumevano proizvede praznu scenu.

UnsupportedOperationException za određene metode Neke metode (renderovanje scene, vodeni žig) nisu dostupne u FOSS izdanju. Proverite dokumentaciju o ograničenjima pre korišćenja naprednih funkcija.

Često postavljana pitanja

Da li Aspose.3D FOSS zahteva bilo koje native DLL‑ove?

Ne. Biblioteka je čista Java bez native zavisnosti ili eksternih binarnih fajlova.

Koje Java verzije su podržane?

Java 21 ili noviji. Biblioteka radi na Windowsu, macOS‑u, Linuxu i Docker kontejnerima.

Da li je biblioteka besplatna za komercijalnu upotrebu?

Da. Objavljena je pod MIT License. Možete je koristiti, menjati i redistribuirati u bilo koju svrhu, uključujući komercijalne aplikacije.

Koje 3D formate mogu da čitam i pišem?

Biblioteka podržava OBJ, STL, glTF 2.0 / GLB i FBX za čitanje i pisanje. Koristite Scene.save() API zasnovan na ekstenzijama za izvoz u bilo koji podržani format.

Mogu li da napravim 3D scenu od nule?

Da. Konstruišite a Scene bez argumenata, dodajte child nodes u scene.getRootNode(), i sačuvajte u željeni format.