Przewodnik programisty

Aspose.3D FOSS for TypeScript to otwarto‑źródłowa biblioteka na licencji MIT, która umożliwia programistom Node.js ładowanie, konstruowanie, transformowanie i eksportowanie scen 3D z pełnym bezpieczeństwem typów TypeScript. Niezależnie od tego, czy tworzysz pipeline zasobów, usługę konwersji formatów, narzędzie do walidacji geometrii, czy skrypt do tworzenia treści 3D, ta biblioteka zapewnia czyste, spójne API oparte na modelu grafu sceny, odzwierciedlającym standardowe koncepcje 3D w branży.

Ten Przewodnik Dewelopera 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 TypeScript. Obejmuje:

  • Obsługa formatów: OBJ (z materiałami .mtl), glTF 2.0 / GLB binarny, STL (binarny i ASCII), COLLADA (DAE), 3MF i FBX, z klasami opcji ładowania i zapisu dla każdego formatu, w tym ObjLoadOptions i GltfSaveOptions.
  • Graf sceny: Jak Scene, Node, Entity, Transform, i SceneObject tworzą pełną hierarchię sceny, w tym wzorce przeglądania węzłów potomnych.
  • API geometrii i siatek: Praca z Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, i ReferenceMode do przetwarzania geometrii.
  • System materiałowy:Stosowanie LambertMaterial, PhongMaterial, oraz PbrMaterial (PBR for glTF) do węzłów sceny, oraz odczytywanie właściwości materiałów wczytanych z plików .mtl.
  • Narzędzia matematyczne: Używanie Vector3, Vector4, Matrix4, Quaternion, i BoundingBox dla transformacji, zapytań o ramki ograniczające i obliczeń geometrycznych.
  • Animacja: Tworzenie i odczytywanie AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, i Extrapolation dane.
  • Obsługa strumieni i buforów: Ładowanie scen 3D z pamięci Buffer obiekty przez scene.openFromBuffer() dla przypadków użycia serverless i strumieniowych.
  • Kompletne przykłady użycia: Kompletne skrypty TypeScript end-to-end do ładowania OBJ, eksportowania GLB, dwukierunkowego przetwarzania STL oraz przeglądania grafów sceny.
  • Wskazówki, typowe problemy i FAQ: Praktyczne wskazówki, jak unikać typowych pułapek w środowisku produkcyjnym.
  • Podsumowanie referencji API: Szybki przegląd wszystkich kluczowych klas i ich podstawowych metod.

Kluczowe pojęcia

Graf sceny: Cała zawartość 3D w Aspose.3D FOSS jest reprezentowana jako drzewo Node obiektów z korzeniem w scene.rootNode. Każdy węzeł może przechowywać Entity (np. a 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.openFromBuffer() i zapisujesz 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.

Silne typowanie TypeScript: Biblioteka jest dostarczana z surowymi ustawieniami kompilatora (noImplicitAny, strictNullChecks) oraz pełnymi definicjami typów. Każda klasa, metoda i właściwość opcji jest w pełni typowana, zapewniając autouzupełnianie w IDE oraz bezpieczeństwo w czasie kompilacji w całym kodzie przetwarzania 3D.

Jedna zależność: Jedyną zależnością w czasie wykonywania jest xmldom, które jest instalowane automatycznie przez npm. Nie ma natywnych dodatków do kompilacji ani pakietów systemowych do zainstalowania.

Rozpoczęcie

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

Dostępne tematy

 Polski