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

Aspose.3D FOSS dla Python

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

Aspose.3D FOSS for Python Aspose.3D FOSS
for Python

Dokumentacja GitHub

Biblioteka Python typu open-source do przetwarzania plików 3D

Aspose.3D FOSS dla Python to biblioteka na licencji MIT, czysto-Python, przeznaczona do pracy z formatami plików 3D. Zainstaluj ją jednym poleceniem pip 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, Light 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 / GLB (materiały PBR), COLLADA (DAE), 3MF i FBX. Opcje ładowania i zapisu dla każdego formatu pozwalają kontrolować odwracanie współrzędnych, skalę, normalizację wektorów normalnych oraz ładowanie materiałów, bez konieczności pisania kodu parsującego specyficznego dla formatu.

Aspose.3D FOSS obsługuje Python 3.7‑3.12 i działa identycznie na Windows, macOS i Linux w środowiskach CI, kontenerach Docker oraz w środowiskach serverless. Nie wymaga kompilacji żadnego natywnego rozszerzenia ani instalacji pakietu systemowego.

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 oraz wyjście binarne GLB przy użyciu GltfSaveOptions.
  • COLLADA, 3MF, FBX: Dodatkowa obsługa formatów z klasami opcji specyficznymi dla każdego formatu.
  • API grafu sceny: Scene, Node, Mesh, Camera, Light, 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/GLB bez natywnego silnika.
  • Procesy druku 3D: Odczytuj, weryfikuj i ponownie eksportuj pliki STL i 3MF.
  • Web backends: Obsługuj punkty końcowe 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, aby przyspieszyć parsowanie.
  • Wyjście binarne vs. JSON: Wybierz kompaktowy GLB lub czytelny dla człowieka glTF za pomocą opcji.
  • Wierność w cyklu round‑trip: Struktura grafu sceny jest zachowywana podczas cykli ładowania i zapisu (wierność zachowania węzłów zależy od formatu i nie jest niezależnie weryfikowana dla wszystkich formatów).

Doświadczenie dewelopera

Aspose.3D FOSS dla instalacji Python za pomocą jednego polecenia pip install aspose-3d-foss. Biblioteka jest czystym Python, 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

Zainstaluj za pomocą pip, a następnie wywołaj Scene.open() z ObjLoadOptions, 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.

pip install aspose-3d-foss

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions

# Załaduj plik OBJ (z materiałami .mtl)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())

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

Konwertuj STL na binarny GLB z odwracaniem współrzędnych

Aby uzyskać kompaktowy binarny GLB zamiast domyślnego JSON glTF, przekaż instancję GltfSaveOptions z binary_mode = True. Ten sam schemat ma zastosowanie do korekt systemu współrzędnych — zamień klasę opcji na format, który jest celem.

from aspose.threed import Scene
from aspose.threed.formats import GltfSaveOptions

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

# Zapisz jako binarny GLB
opts = GltfSaveOptions()
opts.binary_mode = True
scene.save("mesh.glb", opts)

Najczęściej Zadawane Pytania

Czym jest Aspose.3D FOSS dla Python?

Jest to darmowa, na licencji MIT, biblioteka pure-Python 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 i GLB, COLLADA (DAE), 3MF oraz FBX. Każdy format ma dedykowaną klasę opcji ładowania/zapisu.

Czy wymaga jakichkolwiek natywnych zależności?

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

Jak to zainstalować?

Uruchom pip install aspose-3d-foss. Nie są wymagane dodatkowe pakiety systemowe ani natywne rozszerzenia.

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

Tak. Klasy opcji dla poszczególnych formatów pozwalają odwrócić osie, dostosować skalę i znormalizować wektory normalne bez pisania kodu parsującego specyficznego dla formatu.

Które wersje Python są obsługiwane?

Python 3.7 do 3.12 są obsługiwane. Biblioteka działa identycznie na wszystkich głównych systemach operacyjnych.

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

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

  

Zasoby Wsparcia i Nauki

 Polski