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

Aspose.3D FOSS za Java je besplatna, MIT-licencijska knjižnica za preuzimanje, manipulaciju i spašavanje 3D datoteka – nema potrebnih domaćih binara, čista Java iz Maven Central.

Kratak korak vodič

Korak 1: Dodajte Maven ovisnost

Dodajte sljedeću ovisnost na vašem pom.xml (Java 21 ili kasnije zahtijeva):

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

Provjerite instaliranje ispravno:

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

2. korak: Uvoz potrebnih razreda

Uvoz ključnih razreda za snimanje i manipulaciju:

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

Korak 3: Preuzmite 3D datoteku

korištenje Scene.fromFile() za preuzimanje bilo kojeg podržanog formata. knjižnica otkriva format automatski iz proširenja datoteke:

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 primjene:

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

Korak 4: Pređite kroz grafikon scene

Uspješna scena je drvo od Node Objekt koji je usmjeren na 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 različitim formatima

korištenje Scene.save() u bilo kojem formatu podupiranog izlaska. knjižnica otkriva Izlazni format iz proširenja datoteke:

import com.aspose.threed.Scene;

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

Zajednički problemi i korekcije

FileNotFoundException Kada se poziva Scene.fromFile() Put koji ste prošli ne postoji ili koristi pogrešan separator. java.nio.file.Paths.get() osigurati da je dosjeni put ispravan.

Nepoznata pogreška u formatu U svakom slučaju, neka se dosje prilagođava stvarnom formatu.Knjižnica otkriva format po Proširenje za open() i fromFile().Preuzmite izričito parametar formata za prevrati.

Prolazna scena nakon punjenja Neki binarni formati mogu zahtijevati određene opcije tereta. pokušajte koristiti izričito preopterećenje sa opcijama za punjenje ako podrazumevano stvara praznu scenu.

UnsupportedOperationException Za određene metode Neke metode (scenijska rendering, vodena oznaka) nisu dostupne u izdanju FOSS-a. Provjerite dokumentaciju ograničenja prije korištenja naprednih značajki.

Često postavljana pitanja

Trebaju li Aspose.3D FOSS neke native DLL?

Knjižnica je čista Java s ne-native ovisnosti ili vanjske binare potrebne.

Koje Java verzije podržavaju?

Knjižnica radi na Windows, macOS, Linux i Docker kontejnerima.

Je li knjižnica slobodna za komercijalnu upotrebu?

Da, izdan je pod MIT licencom. možete ga koristiti, izmijeniti i redistribuirati za bilo koji svrhu, uključujući komercijalne aplikacije.

Koje 3D formate mogu čitati i pisati?

Knjižnica podržava OBJ, STL, glTF 2.0 / GLB i FBX za čitanje i pisanje. Koristite ga Scene.save() API-ja na temelju proširenja za izvoz u bilo koji podržani format.

Mogu li napraviti 3D scenu iz skraćenja?

I. Izgradnja A Scene bez argumenata, dodajte dječje čvorove na scene.getRootNode(),i Uključite u željeni format.