1. Produkty
  2.   Aspose.3D
  3.   Aspose.3D FOSS for Java

Aspose.3D FOSS dla Java

Ładuj, twórz, przekształcaj i eksportuj sceny 3D z Java — darmowe i open-source.

Aspose.3D FOSS for Java Aspose.3D FOSS
for Java

Dokumentacja GitHub

Biblioteka Java typu Open-Source do przetwarzania plików 3D

Aspose.3D FOSS dla Java to biblioteka na licencji MIT, czysto-Java, przeznaczona do pracy z formatami plików 3D. Dodaj jedną zależność Maven i od razu zacznij odczytywać, konstruować i zapisywać sceny 3D bez instalowania żadnego natywnego środowiska uruchomieniowego, zewnętrznego SDK ani renderera firm trzecich.

Biblioteka udostępnia czyste API grafu sceny oparte na Scene, Node, Mesh, Camera i Transform, tym samym modelu koncepcyjnym używanym przez profesjonalne narzędzia 3D. Obsługa formatów obejmuje OBJ (z ładowaniem materiałów .mtl), STL (binarny i ASCII, zweryfikowane w trybie round‑trip), glTF 2.0 (materiały PBR), GLB (binarny glTF) oraz FBX (tylko import). Opcje ładowania i zapisu dla każdego formatu pozwalają kontrolować odwracanie współrzędnych, skalę, normalizację wektorów normalnych oraz ładowanie materiałów bez pisania kodu parsującego specyficznego dla formatu.

Aspose.3D FOSS wymaga Java 21 lub nowszego i działa identycznie na Windows, macOS i Linux w środowiskach CI, kontenerach Docker oraz w środowiskach serverless. Nie ma natywnego rozszerzenia do kompilacji ani pakietu systemowego do instalacji.

Obsługa formatów 3D i API grafu sceny

  • OBJ / MTL: Ładuj pliki Wavefront OBJ wraz z towarzyszącymi definicjami materiałów.
  • STL: Odczytuj i zapisuj zarówno binarne, jak i ASCII STL z pełną weryfikacją round‑trip.
  • glTF 2.0 / GLB: Ładowanie materiałów PBR i eksport przy użyciu GltfSaveOptions. Użyj setContentType(FileContentType.BINARY) dla wyjścia GLB.
  • FBX: Obsługa importu plików FBX (eksport niedostępny).
  • API grafu sceny: Scene, Node, Mesh, Camera, Transform.

Gdzie Aspose.3D FOSS może być używany

  • Potoki weryfikacji zasobów: Weryfikuj, zmieniaj orientację i ponownie eksportuj zasoby 3D w CI.
  • Narzędzia do tworzenia gier: Przetwarzaj wsadowo siatki OBJ i STL bez natywnego silnika.
  • Procesy druku 3D: Odczytuj, weryfikuj i ponownie eksportuj pliki STL.
  • Web backends: Serwuj endpointy konwersji 3D w Dockerze lub funkcjach serverless.
  • Content migration: Konwertuj pomiędzy rodzinami formatów na dużą skalę.

Opcje per-formatowe i kontrola współrzędnych

  • Orientacja układu współrzędnych: Odwróć osie i dostosuj skalę w zależności od formatu bez własnego kodu.
  • Normalizacja wektorów normalnych: Automatycznie normalizuj wektory normalne wierzchołków przy ładowaniu lub zapisie.
  • Kontrola ładowania materiałów: Włącz lub wyłącz ładowanie plików MTL/tekstur dla szybszego parsowania.
  • Formatowanie wyjścia: Wybierz kompaktowy lub czytelny dla człowieka JSON glTF za pomocą opcji.
  • Wierność przy dwukierunkowym przetwarzaniu: Nieznane węzły grafu sceny są zachowywane dosłownie przy ponownym zapisie.

Doświadczenie dewelopera

Aspose.3D FOSS dla instalacji Java z jedną zależnością Maven (com.aspose:aspose-3d-foss:26.1.0). Biblioteka jest czystym Java, bez natywnych rozszerzeń do kompilacji i bez konieczności instalacji pakietów systemowych.

API grafu sceny odzwierciedla koncepcyjny model profesjonalnych narzędzi 3D, więc krzywa uczenia się jest krótka dla każdego, kto zna model danych Three.js lub Blendera. Biblioteka jest licencjonowana na licencji MIT, open‑source i zachęca do zgłaszania błędów oraz wkładów na GitHubie.

Wczytaj scenę OBJ i wyeksportuj jako glTF

Dodaj zależność Maven, a następnie wywołaj Scene.fromFile("model.obj"), aby wczytać plik OBJ wraz z definicjami materiałów MTL. Jedno wywołanie scene.save() z rozszerzeniem .gltf zapisuje plik JSON glTF 2.0, bez potrzeby rejestru formatów ani obiektu konwertera.

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

import com.aspose.threed.*;

// Załaduj plik OBJ (z materiałami .mtl)
Scene scene = Scene.fromFile("model.obj");

// Eksportuj jako glTF 2.0
scene.save("model.gltf");

Konwertuj STL do glTF przy użyciu GltfSaveOptions

Aby wygenerować plik glTF z korektą układu współrzędnych, przekaż instancję GltfSaveOptions z wywołaniem setFlipCoordinateSystem(true). Ten sam wzorzec obowiązuje wszystkie opcje specyficzne dla formatu — zamień klasę opcji na tę odpowiadającą formatowi, który chcesz użyć.

import com.aspose.threed.*;

Scene scene = new Scene();
scene.open("mesh.stl");

// Zapisz jako glTF z opcjami
GltfSaveOptions opts = new GltfSaveOptions();
opts.setFlipCoordinateSystem(true);
opts.setPrettyPrint(true);
scene.save("mesh.gltf", opts);

Najczęściej Zadawane Pytania

Czym jest Aspose.3D FOSS dla Java?

Jest to darmowa, na licencji MIT, czysta biblioteka pure-Java do ładowania, manipulacji i zapisywania scen 3D bez instalowania żadnego natywnego środowiska uruchomieniowego ani zewnętrznego SDK.

Jakie formaty 3D są obsługiwane?

OBJ (z .mtl), STL (binarny i ASCII), glTF 2.0, GLB (binarny glTF) oraz FBX (tylko import). Każdy format ma dedykowaną klasę opcji ładowania/zapisu.

Czy wymaga jakichkolwiek natywnych zależności?

Nie. Aspose.3D FOSS dla Java to czysty Java bez żadnych natywnych rozszerzeń. Działa na Windows, macOS i Linux bez żadnego kroku kompilacji.

Jak to zainstalować?

Dodaj zależność Maven com.aspose:aspose-3d-foss:26.1.0 do swojego projektu. Nie są wymagane dodatkowe pakiety systemowe ani natywne rozszerzenia.

Czy mogę kontrolować orientację układu współrzędnych?

Tak. Klasy opcji dla każdego formatu pozwalają odwrócić osie, dostosować skalę i znormalizować wektory normalne bez pisania kodu parsującego specyficznego dla formatu.

Które wersje Java są obsługiwane?

Java 21 i nowsze są obsługiwane. Biblioteka działa identycznie na wszystkich głównych systemach operacyjnych.

Czy kod źródłowy jest dostępny?

Tak. Biblioteka jest MIT-licensed i hostowana na GitHub. Zgłoszenia błędów i pull requesty są mile widziane.

  

Zasoby Wsparcia i Nauki

 Polski