Miten aloittaa Aspose.3D FOSS Java

Aspose.3D FOSS for Java on MIT: n lisensoitu vapaa kirjastosto 3D-tiedostojen lataamiseen, manipulointiin ja säästämiseen – ei alkuperäisiä binareja tarvitaan, puhdas Java Maven Centralista.

Vaihe-to-vaihe opas

Vaihe 1: Lisää Maven riippuvuus

Lisää seuraava riippuvuus omalle pom.xml (Java 21 tai sitä myöhemmin vaaditaan):

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

Tarkista asennuksen oikein:

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

Vaihe 2: Tarvittavat luokitukset tuonnissa

Tuoda keskeiset luokat kohtauksen lataamiseen ja manipulointiin:

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

Vaihe 3: Lataa 3D-tiedosto

Käytä Scene.fromFile() - tallentaa kaikki tukemat muodot. kirjasto havaitsee muodon automaattisesti tiedoston laajennuksesta:

import com.aspose.threed.Scene;

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

Tai käytä sitä open() tapausmenetelmä :

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

Vaihe 4: Kiertää näytön grafiikka

Kuorma on puu, jonka Node esineitä, jotka ovat juuret 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);

Vaihe 5: Tallenna eri muotoon

Käytä Scene.save() - jokaiseen tuettuun tulostusmuotoon. kirjasto havaitsee tiedoston laajennus muodossa:

import com.aspose.threed.Scene;

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

Yhteiset ongelmat ja korjaukset

FileNotFoundException Kun soittaa Scene.fromFile() Käytössäsi olevaa tietä ei ole olemassa tai käytetään väärää eristäjää. java.nio.file.Paths.get() varmistaa, että tiedostomuoto on oikein.

Tietämätön muoto virhe Varmista, että tiedoston laajennus vastaa todellista muotoa. Kirjasto havaitsee muodon Laajennus open() ja fromFile().• Anna selkeä muotoon parametri ylittää.

Tyhjä kohtaus latauksen jälkeen Jotkut binary muotoja voi vaatia erityisiä kuormitus vaihtoehtoja. Yritä käyttää selkeä ylikuormitusta laitteen latausvaihtoehtoja, jos oletusarvo tuottaa tyhjän kohtauksen.

UnsupportedOperationException tietyillä menetelmillä Jotkut menetelmät (näytön renderointi, vesimerkintä) eivät ole saatavilla FOSS-version. Tarkista rajoitusdokumentaatio ennen kehittyneiden ominaisuuksien käyttöä.

Usein kysyttyjä kysymyksiä

Tarvitsetko Aspose.3D FOSSin alkuperäisiä DLL:itä?

Kirjasto on puhdas Java, jossa ei ole kotimaisia riippuvuuksia tai ulkoisia binareja.

Millaisia Java-versioita tuetaan?

Kirjasto toimii Windows, macOS, Linux ja Docker -tallissa.

Onko kirjasto vapaata kaupalliselle käytölle?

Kyllä. Se on julkaistu MIT-lisenssin mukaisesti. voit käyttää, muuttaa ja jakaa sitä uudelleen mihin tahansa tarkoitukseen, mukaan lukien kaupalliset sovellukset.

Millaisia 3D-muotoja voin lukea ja kirjoittaa?

Kirjasto tukee OBJ, STL, glTF 2.0 / GLB ja FBX sekä lukemiseen ja kirjoittamiseen. Käytä sitä Scene.save() laajennuspohjainen API vientiä mihin tahansa tukemaan muotoon.

Voinko luoda 3D-näytön skratchista?

Rakennetaan a Scene Ei ole mitään väitteitä, lisää lapsen voiteita scene.getRootNode(),ja ja halutun muodon mukaan.