Kaip pradėti su Aspose.3D FOSS Java

Aspose.3D FOSS Java yra nemokama, MIT licencija biblioteka 3D failams atsisiųsti, manipuliuoti ir išsaugoti – jokių gimtojo binarų nereikia, švarus Java iš Maven Central.

Žingsnis po žingsnio vadovėlis

1 žingsnis: pridėti Maven priklausomybę

Įtraukite šią priklausomybę į savo pom.xml (Java 21 arba vėliau reikalingas):

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

Įsitikinkite, kad įrenginys yra teisingai įkrautas:

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

2 žingsnis: Reikalingos klasės importo

Importuoti pagrindines klases scenos įkrovimui ir manipuliavimui:

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

3 žingsnis: įkeliate 3D failą

Naudojimas Scene.fromFile() bet kokio palaikomo formato įkrovimas. biblioteka atpažįsta formatą Automatinis iš failų plėtinės:

import com.aspose.threed.Scene;

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

arba naudokite open() Įrodymų metodas:

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

4 žingsnis: peržengti sceną grafikas

Sklypas yra medžio Node Objektas, įsikūręs 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);

5 žingsnis: išsaugoti į kitą formatą

Naudojimas Scene.save() eksportuoti į bet kurį remiamą išleidimo formatą. biblioteka atpažįsta, kad Išleidimo formatas iš failų plėtinės:

import com.aspose.threed.Scene;

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

Bendros problemos ir fiksacijos

FileNotFoundException Kai skambina Scene.fromFile() Kelias, kurį praeinate, neegzistuoja arba naudoja neteisingą atskyrėją. java.nio.file.Paths.get() užtikrinti, kad failo maršrutas būtų teisingas.

Nežinomas formato klaidas Įsitikinkite, kad failų plėtinė atitinka tikrąjį formatą. biblioteka atpažįsta formatus pagal Išplėstinė už open() ir fromFile().Pasidalinti aiškią formato parametrą perviršyti.

Laisva scena po įkrovimo Kai kuriems binariniams formatams gali prireikti konkrečių apkrovos variantų. pabandykite naudoti aiškią perkaitą su įkrovimo galimybėmis, jei numatyta sukuria tuščią scenos.

UnsupportedOperationException Tam tikrų metodų Kai kurie metodai (scenos atranka, vandens ženklinimas) nėra prieinami FOSS leidinyje. Peržiūrėkite apribojimų dokumentaciją prieš naudodami pažangias funkcijas.

Dažnai užduodami klausimai

Ar Aspose.3D FOSS reikalauja bet kokių gimtojo DLL?

Biblioteka yra gryna Java, be gimtojo priklausomybės ar išorinių binarių.

Kokios Java versijos yra palaikomos?

Biblioteka veikia Windows, macOS, Linux ir Docker konteineriuose.

Ar biblioteka yra nemokama komercinio naudojimo tikslais?

Taip. Jis išleistas pagal MIT licenciją. galite jį naudoti, modifikuoti ir perparduoti bet kokiu tikslu, įskaitant komercinę programą.

Kokius 3D formatus galiu skaityti ir rašyti?

Biblioteka palaiko OBJ, STL, glTF 2.0 / GLB ir FBX tiek skaityti ir rašyti. Naudokite jį Scene.save() API, pagrįsta plėtiniais, eksportuojami į bet kurį palaikytą formatą.

Ar galiu sukurti 3D scenos iš skraidančio?

Konstrukcija A Scene be jokių argumentų, pridėkite vaiko mazgai į scene.getRootNode(),ir Išsaugokite pageidaujamą formą.