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

Aspose.3D FOSS for Python

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

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

Dokumentacja GitHub

Biblioteka Python 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 czysty API graf sceny zbudowany wokół Scene, Node, Mesh, Camera, Light 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 / 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 pisania kodu specyficznego dla danego formatu.

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

Wsparcie formatu 3D i API Scene-Graph

  • OBJ / MTL: Ładuj pliki Wavefront OBJ wraz z definicjami materiałów.
  • STL: Odczyt i zapis zarówno binarnych, jak i ASCII STL z pełną weryfikacją roundtrip.
  • glTF 2.0 / GLB: Ładowanie materiałów PBR i binarny output GLB poprzez GltfSaveOptions.
  • COLLADA, 3MF, FBX: Dodatkowe wsparcie formatów z klasami opcji dla każdego formatu.
  • Scene-graph API: Scene, Node, Mesh, Camera, Light, 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/GLB bez silnika.
  • Przepływy pracy druku 3D: Czytanie, walidacja i reeksport plików STL i 3MF.
  • ** 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 ładowaniu lub zapisywaniu.
  • Kontrolka ładowania materiału: Włącz lub wyłącz ładzenie MTL/tekstury w celu szybszego analizowania.
  • Wydaj opcje binarne vs. JSON: Wybierz skompakowane GLB lub czytelne dla człowieka glTF za pomocą opcji.
  • Fidelity Round-trip: Struktura grafu sceny jest utrzymywana w cyklach ładowania i zapisywania (fidelia zachowania węzła zależy od formatu i nie została zweryfikowana niezależnie dla wszystkich formatów).

Doświadczenie twórcy

Aspose.3D FOSS dla Pythona instaluje się za pomocą jednego polecenia pip install aspose-3d-foss. Biblioteka jest czystym Pythonem, bez natywnych rozszerzeń do kompilowania i bez pakietów systemowych do instalacji.

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

Instaluj z pip, a następnie zadzwoń Scene.open() za pomocą ObjLoadOptions do ładowania pliku OBJ wraz z definicjami materiałów MTL. Jedno połączenie scene.save() ze rozszerzeniem .gltf pisze plik JSON glTF 2.0 nie potrzeba rejestru formatu ani konwertera obiektu.

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")

Konwersja STL na binarny GLB za pomocą odwrócenia współrzędnych

Aby wyprodukować kompaktowy binarny GLB zamiast domyślnego JSON glTF, prześlij instancję GltfSaveOptions z binary_mode = True. Ten sam wzór dotyczy dostosowań systemu współrzędnych wymiana klasy opcji dla formatu, który jest docelowany.

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

Co to jest Aspose.3D FOSS dla Pythona?

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

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

Obj (z .mtl), STL (binary i ASCII), glTF 2.0 i GLB, COLLADA (DAE), 3MF i FBX. Każdy format ma dedykowaną klasę opcji ładowania / zapisywania.

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

Wykonaj pip install aspose-3d-foss. 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 Pythona 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