Jak zacząć z Aspose.3D FOSS dla Java

Jak zacząć z Aspose.3D FOSS dla Java

Aspose.3D FOSS dla Java to darmowa, licencjonowana biblioteka MIT do ładowania, manipulacji i oszczędzania plików 3D – nie wymagane są native binary, czysty Java z Maven Central.

Przewodnik krok po kroku

Krok 1: Dodaj uzależnienie od Maven

Dodaj następującą zależność do Twojego pom.xml (Java 21 lub później wymagane):

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

Sprawdź, czy instalacja jest prawidłowo ładowana:

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

Krok 2: Import wymaganych klas

Importowanie podstawowych klas do ładowania i manipulacji sceny:

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

Krok 3: Pobierz plik 3D

Używanie Scene.fromFile() do pobierania dowolnego obsługiwanego formatu. biblioteka wykrywa format automatycznie z rozszerzenia pliku:

import com.aspose.threed.Scene;

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

lub użyj open() Metoda przypuszczenia:

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

Krok 4: Przejdź przez scenę grafiki

„Przemocny sceną jest drzewo Node Obiekty z korzeniami w 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);

Krok 5: Zapisz do innego formatu

Używanie Scene.save() do eksportu do dowolnego obsługiwanego formatu wyjścia. biblioteka wykrywa Format wyjścia z rozszerzenia pliku:

import com.aspose.threed.Scene;

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

Wspólne problemy i rozwiązania

FileNotFoundException Kiedy zadzwonić Scene.fromFile() Droga, którą przeszedłeś nie istnieje lub używa błędnego oddzielnika. java.nio.file.Paths.get() Aby upewnić się, że droga do pliku jest poprawna.

Nieznany błąd formatowy Upewnij się, że rozszerzenie pliku odpowiada rzeczywistemu formatowi. biblioteka wykrywa format przez Rozszerzenie dla open() i fromFile().Przeprowadź wyraźny parametr formatu do przełomu.

Puste miejsce po ładowaniu Niektóre formaty binarne mogą wymagać konkretnych opcji ładowania. spróbuj używać wyraźnego nadładunku z opcjami ładowania, jeśli domyślnie powstaje pusta scena.

UnsupportedOperationException W przypadku niektórych metod Niektóre metody (renderowanie scen, woda) nie są dostępne w edycji FOSS. Sprawdź dokumentację ograniczeń przed użyciem zaawansowanych funkcji.

Często zadawane pytania

Czy Aspose.3D FOSS wymaga native DLL?

Biblioteka jest czysta Java bez domowych uzależnień ani zewnętrznych binarów wymaganych.

Jakie wersje Java są obsługiwane?

Biblioteka działa na kontenerach Windows, macOS, Linux i Docker.

Czy biblioteka jest wolna do użytku komercyjnego?

Jest on wydany na podstawie licencji MIT. Możesz używać, modyfikować i redistribuować go do jakiegokolwiek celu, w tym aplikacji komercyjnych.

Jakie formaty 3D można czytać i pisać?

Biblioteka obsługuje OBJ, STL, glTF 2.0 / GLB i FBX zarówno do czytania jak i pisania. Użyjmy Scene.save() API oparte na rozszerzeniach do eksportu do dowolnego obsługiwanego formatu.

Czy mogę stworzyć scenę 3D z scratch?

Konstrukcja A Scene bez argumentów, dodaj dziecięce węzły do scene.getRootNode(),i Wystarczy przechowywać w pożądanej formie.

Zobacz również

 Polski