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

Aspose.3D FOSS for Java

Ładuj, twórz, przekształcaj i eksportuj sceny 3D z Java — darmowy i otwartoźródłowy.

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

Dokumentacja GitHub

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

Aspose.3D FOSS dla Java to biblioteka na licencji MIT, czysto-Java, służąca 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 czysty API graf sceny zbudowany wokół Scene, Node, Mesh, Camera i Transform, tego samego modelu koncepcyjnego używanego przez profesjonalne narzędzia 3D. Obsługa formatów obejmuje OBJ (z ładowaniem materiałów .mtl), STL (binarny i ASCII, zweryfikowany roundtrip), 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 i ł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 CI runners, kontenerach Docker oraz w środowiskach serverless. Edycja enterprise, Aspose.3D for Java, oferuje dodatkowe możliwości i wsparcie.

Wsparcie formatu 3D i API Scene-Graph

  • OBJ / MTL: Ładuj pliki Wavefront OBJ wraz z definicjami materiałów.
  • STL: Odczyt i zapis zarówno binarnego, jak i ASCII STL z pełną weryfikacją roundtrip.
  • glTF 2.0 / GLB: Ładowanie materiałów PBR i eksport za pomocą GltfSaveOptions. Użyj setContentType(FileContentType.BINARY) do wyjścia GLB.
  • FBX: Obsługa importu plików FBX (eksport niedostępny).
  • Scene-graph API: Scene, Node, Mesh, Camera, Transform.

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

  • Pidliny walidacji aktywów: Weryfikacja, przekierowanie i ponowny wywóz aktyw 3D w CI.
  • ** Narzędzia do tworzenia gier:** Wyrób batch-proces OBJ i STL bez silnika.
  • Przepływy pracy druku 3D: Czytanie, walidacja i reeksport plików STL.
  • ** Web backends:** Służba 3D konwersji punktów końcowych w Docker lub bezserwernych funkcji.
  • Migracja treści: Konwersja pomiędzy rodzinami formatów w skali.

Opcje w postaci formatu i kontrola koordynacji

  • Orygnacja z układu współrzędnych: Przewrócić osi i dostosować skalę w każdym formacie bez kodów niestandardowych.
  • Normalna normalizacja: Automatycznie normalizuj normalne szczyty przy obciążeniu (ObjLoadOptions.setNormalizeNormal()).
  • Kontrolka ładowania materiału: Włącz lub wyłącz ładzenie MTL/tekstury w celu szybszego analizowania.
  • Wydaj w formie “Pretty-print”: Wybierz skompakowany lub czytelny dla człowieka glTF JSON za pomocą opcji.

Doświadczenie twórcy

Aspose.3D FOSS dla Java instaluje się z pojedynczą zależnością Maven (org.aspose:aspose-3d-foss:26.5.0). Biblioteka jest czystą Jawą, bez natywnych rozszerzeń do kompilowania i żadnych pakietów systemowych do zainstalowania.

API scenograficzne odzwierciedla konceptualny model profesjonalnych narzędzi 3D, więc krzywa uczenia się jest krótka dla każdego, kto zna Three.js lub model danych Blender’a. Biblioteka jest licencjonowana przez MIT i otwarta pod kątem źródła, a także witamy raporty o błędach i wkłady na GitHub .

Władowanie sceny OBJ i wyeksportowanie jako glTF

Dodaj zależność Maven, a następnie zadzwoń Scene.fromFile("model.obj") do załadowania pliku OBJ wraz z definicjami materiału MTL. Jedno połączenie scene.save() ze rozszerzeniem .gltf pisze plik JSON glTF 2.0, bez potrzeby rejestru formatu lub obiektu konwertera.

<dependency>
  <groupId>org.aspose</groupId>
  <artifactId>aspose-3d-foss</artifactId>
  <version>26.5.0</version>
</dependency>
import com.aspose.threed.*;
// Load an OBJ file (with .mtl materials)
Scene scene = Scene.fromFile("model.obj");
// Export as glTF 2.0
scene.save("model.gltf");

Konwersja STL na glTF za pomocą GltfSaveOptions

Aby wyprodukować plik glTF z dostosowaniami systemu współrzędnych, przekaż instancję GltfSaveOptions za pomocą setFlipCoordinateSystem(true). Ten sam wzór dotyczy wszystkich opcji na format zamienić klasę opcje dla formatu, który zamierzasz.

import com.aspose.threed.*;
Scene scene = new Scene();
scene.open("mesh.stl");
// Save as glTF with options
GltfSaveOptions opts = new GltfSaveOptions();
opts.setFlipCoordinateSystem(true);
opts.setPrettyPrint(true);
scene.save("mesh.gltf", opts);

Najczęściej Zadawane Pytania

Co to jest Aspose.3D FOSS dla Java?

Jest to darmowa, licencjonowana przez MIT biblioteka czystej Java do ładowania, manipulowania i zapisywania scen 3D bez instalowania żadnego rodzinnego czasu działania lub zewnętrznego SDK.

Które formaty 3D są obsługiwane?

Obj (z .mtl), STL (binary i ASCII), glTF 2.0, GLB (binarne glTP) oraz FBX (tylko do importu). Każdy format ma dedykowaną klasę opcji ładowania/zapisywania.

Czy wymaga żadnych 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 go zainstalować?

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

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

Tak. Klasy opcji na format pozwalają odwrócić osi, dostosować skalę i normalizację normalnych bez pisania kodu analizy specyficznego dla formatu.

Które wersje Java są obsługiwane?

Biblioteka działa identycznie na wszystkich głównych systemach operacyjnych.

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

Tak, biblioteka jest licencjonowana przez MIT i hostowana na GitHub.

  

Zasoby Wsparcia i Nauki

 Polski