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, służąca 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, zweryfikowany roundtrip), glTF 2.0 / GLB (materiały PBR), COLLADA (DAE), 3MF i FBX. Opcje ładowania i zapisu dla poszczególnych formatów pozwalają kontrolować odwracanie współrzędnych, skalę, normalizację wektorów normalnych oraz ładowanie materiałów bez pisania kodu specyficznego dla danego formatu.

Aspose.3D FOSS obsługuje Python 3.7 do 3.12 i działa identycznie na Windows, macOS i Linux CI runners, kontenerach Docker oraz w środowiskach serverless. Aby uzyskać informacje o funkcjach i wsparciu dla przedsiębiorstw, zobacz Aspose.3D for Python — Enterprise Product.

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

  • OBJ / MTL: Ładuj pliki Wavefront OBJ wraz z towarzyszącymi 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łu PBR i binarny plik wyjściowy GLB za pośrednictwem GltfSaveOptions.
  • COLLADA, 3MF, FBX: Dodatkowe wsparcie 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: Sprawdź, zmień orientację i ponownie wyeksportuj zasoby 3D w CI.
  • Narzędzia do tworzenia gier: Przetwarzaj wsadowo siatki OBJ/GLB bez natywnego silnika.
  • 3D printing workflows: Odczyt, weryfikacja i ponowny eksport plików STL i 3MF.
  • Web backends: Obsługuj punkty końcowe konwersji 3D w Dockerze lub funkcjach serverless.
  • Migracja treści: 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.
  • Normal normalization: Automatycznie normalizuj normalne wierzchołków przy ładowaniu lub zapisie.
  • Kontrola ładowania materiału: Włącz lub wyłącz ładowanie MTL/tekstur w celu szybszego parsowania.
  • Binarny vs. JSON wyjście: Wybierz kompaktowy GLB lub czytelny dla człowieka glTF za pomocą opcji.
  • Round-trip fidelity: Struktura grafu sceny jest zachowywana w cyklach ładowania i zapisu (dokładność zachowania węzłów jest zależna od formatu i nie została niezależnie zweryfikowana dla wszystkich formatów).

Doświadczenie dewelopera

Aspose.3D FOSS dla Python instaluje się jednym poleceniem pip install aspose-3d-foss. Biblioteka jest czystym Python, bez natywnych rozszerzeń do kompilacji i bez pakietów systemowych do instalacji.

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 MIT-licensed, open-source i zachęca do zgłaszania błędów oraz wkładów na GitHub.

Wczytaj scenę OBJ i wyeksportuj jako glTF

Zainstaluj przy pomocy 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 glTF 2.0 JSON — nie jest potrzebny rejestr formatów ani obiekt konwertera.

pip install aspose-3d-foss

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions
# Load an OBJ file (with .mtl materials)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())
# Export as glTF 2.0
scene.save("model.gltf")

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

Aby wygenerować 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")
# Save as binary 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ę systemu współrzędnych?

Tak. Per-format option classes pozwalają na odwracanie osi, regulację skali i normalizację wektorów normalnych bez konieczności pisania kodu parsującego specyficznego dla formatu.

Jakie wersje Python są obsługiwane?

Python 3.7 do 3.12 są wspierane. 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 hostowana na GitHubie. Zgłoszenia błędów i pull requesty są mile widziane.

  

Zasoby Wsparcia i Nauki

 Polski