Przewodnik programisty

Aspose.3D FOSS for Python to otwartoźródłowa biblioteka na licencji MIT, która umożliwia programistom Python ładowanie, konstruowanie, transformowanie i eksportowanie scen 3D bez żadnych zewnętrznych zależności uruchomieniowych. Niezależnie od tego, czy tworzysz pipeline zasobów, narzędzie walidacyjne, skrypt przetwarzania geometrii, czy usługę konwersji formatów, ta biblioteka zapewnia czyste, spójne API oparte na modelu grafu sceny odzwierciedlającym standardowe koncepcje 3D w branży.

Ten przewodnik dla programistów obejmuje wszystko, co potrzebne, aby wyjść poza szybkie uruchomienie i pisać kod przetwarzania 3D o jakości produkcyjnej.

Co znajdziesz w tej sekcji

Funkcje i możliwości

Ten Funkcje strona jest podstawowym odniesieniem do pracy z Aspose.3D FOSS dla Python. Obejmuje:

  • Obsługa formatów: OBJ (z materiałami .mtl), STL (binarny i ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF oraz trwający tokenizator FBX, z klasami opcji ładowania i zapisu dla każdego formatu.
  • Graf sceny: Jak Scene, Node, Entity, Transform, i GlobalTransform zbuduj pełną hierarchię sceny, włączając wzorce przeglądania węzłów potomnych.
  • Mesh API: Praca z control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, i VertexElementSmoothingGroup do przetwarzania geometrii.
  • System materiałów: Stosowanie LambertMaterial i PhongMaterial do węzłów sceny, oraz odczytywanie właściwości materiałów załadowanych z plików .mtl.
  • Narzędzia matematyczne: Używanie Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, i BoundingBox dla przekształceń, zapytań o ramki ograniczające i obliczeń geometrycznych.
  • Animacja: Tworzenie i odczytywanie AnimationClip, AnimationNode, KeyFrame, oraz KeyframeSequence dane.
  • Opcje ładowania i zapisywania: Klasy opcji per-format, takie jak ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Pełne przykłady użycia: Skrypty end-to-end Python do ładowania OBJ, eksportowania STL, dwukierunkowego przetwarzania glTF oraz przeglądania grafów sceny.
  • Wskazówki, typowe problemy i FAQ: Praktyczne wskazówki, jak unikać typowych pułapek w użyciu produkcyjnym.
  • Podsumowanie referencji API: Szybki przegląd listy wszystkich kluczowych klas.

Kluczowe pojęcia

Graf sceny: Cała zawartość 3D w Aspose.3D FOSS jest reprezentowana jako drzewo Node obiektów zakorzenionych w scene.root_node. Każdy węzeł może zawierać Entity (takich jak Mesh, Camera, lub Light) Transform który pozycjonuje go w hierarchii.

API niezależne od formatu: Otwierasz dowolny obsługiwany format za pomocą Scene.open() lub Scene.from_file() i zapisz do dowolnego obsługiwanego formatu za pomocą Scene.save(). Te same obiekty grafu sceny są używane niezależnie od formatu źródłowego lub docelowego.

Zero zależności: Biblioteka jest czystym Python. Nie ma natywnego rozszerzenia do kompilacji, żadnego pakietu systemowego do instalacji ani zewnętrznej biblioteki do zarządzania.

Rozpoczęcie

Jeśli jeszcze nie zainstalowałeś biblioteki, zobacz Rozpoczęcie sekcję i Instalacja przewodnik przed dalszym czytaniem.

Dostępne tematy

 Polski