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

Aspose.3D FOSS for TypeScript

Ładuj, twórz, przekształcaj i eksportuj sceny 3D z Node.js — w pełni typowany, open‑source i gotowy do produkcji przy jednym poleceniu npm install.

Aspose.3D FOSS for TypeScript Aspose.3D FOSS
for TypeScript

Dokumentacja GitHub

Biblioteka typu Open-Source TypeScript do przetwarzania plików 3D

Aspose.3D FOSS dla TypeScript to biblioteka na licencji MIT do pracy z formatami plików 3D w aplikacjach Node.js. Zainstaluj ją jednym poleceniem npm install @aspose/3d i od razu zacznij odczytywać, konstruować i zapisywać sceny 3D w TypeScript, bez konieczności kompilacji natywnych dodatków, bez instalacji zewnętrznych SDK i bez wymaganego renderera.

Biblioteka udostępnia w pełni typowany graf sceny API zbudowany wokół Scene, Node, Entity, Mesh, Camera, Light i Transform, tego samego modelu koncepcyjnego używanego przez profesjonalne narzędzia 3D. Obsługa formatów obejmuje OBJ (Wavefront, z ładowaniem materiałów .mtl), glTF 2.0 i binarny GLB (materiały PBR), STL (binarny i ASCII, pełny roundtrip), COLLADA (DAE), 3MF i FBX. Klasy opcji per-formatowych, takie jak ObjLoadOptions i GltfSaveOptions, dają precyzyjną kontrolę nad orientacją układu współrzędnych, skalą, normalizacją wektorów normalnych, wyjściem binarnym vs. JSON, oraz ładowaniem materiałów.

Aspose.3D FOSS jest przeznaczony dla Node.js 18, 20 i 22+ z TypeScript 5.0+ i kompiluje się do CommonJS. Biblioteka jest dostarczana z rygorystycznymi ustawieniami kompilatora TypeScript (noImplicitAny, strictNullChecks), dzięki czemu Twoje IDE zapewnia pełne podpowiedzi i bezpieczeństwo w czasie kompilacji. Jej jedyną zależnością w czasie wykonywania jest xmldom, instalowaną automatycznie. Aby zobaczyć rodzinę produktów enterprise, zobacz Aspose.3D — Enterprise Product Family.

Wsparcie formatu 3D i API graficznego scenografii typu

  • ** OBJ / MTL:** Wykorzystanie plików OBD z obok definicji materiałów.
  • glTF 2.0 / GLB: Obciążenie materiału PBR i wyjście binarne z GDB za pośrednictwem GltfSaveOptions.
  • STL: Czytanie i zapisywanie zarówno STL binarnych, jak i ASCII z pełną weryfikacją w obie strony.
  • COLLADA, 3MF, FBX: Dodatkowy format obsługi z klasami opcji na jeden format.
  • ** Pełne typy typograficzne:** Każda klasa, metoda i opcja są mocno zapisywane za pomocą noImplicitAny i strictNullChecks.

Gdzie Aspose.3D FOSS może być używany

  • Pipeline aktywów w node.js: Importowanie plików OBJ, weryfikacja i ponowne ukierunkowanie geometrii oraz eksport jako GLB w CI.
  • ** Narzędzia do gry:** Wyrób 3D bez natywnej maszyny lub renderera.
  • Przepływy pracy druku 3D: Czytanie, walidacja i reeksport plików STL i 3MF.
  • Backendy bez serwera: Uruchom 3D konwersje w Lambda lub Cloud Functions.
  • Migracja treści: Konwersja pomiędzy rodzinami formatów w skali z jednego skryptu.

Opcje w postaci formatu i kontrola koordynacji

  • Orygnacja z układu współrzędnych: Przewróć osi i dostosuj skalę w zależności od formatu, przy użyciu opcji klas.
  • Normalna normalizacja: Automatycznie normalizuj normalne szczyty przy ładowaniu lub zapisywaniu.
  • Wytrysk binarny vs. JSON: Wybierz kompaktowy GLB lub czytelny glTF za pośrednictwem GltfSaveOptions.
  • Kontrolka ładowania materiału: Włącz lub wyłącz ładzenie MTL/tekstury w celu szybszego analizowania.
  • Fidelity round-trip: Nieznane węzły scenograficzne są zachowywane dosłownie przy ponownym zapisywaniu.

Doświadczenie twórcy

Aspose.3D FOSS for TypeScript instaluje się za pomocą jednego polecenia npm install @aspose/3d. Nie ma natywnych dodatków do kompilacji. Biblioteka jest czystym typograficznym / JavaScriptem z jedną automatycznie zainstalowaną zależnością (xmldom).

Silnie napisane API zapewnia pełne automatyczne uzupełnianie IDE dla każdej klasy i opcji formatu scenografu. Biblioteka jest ukierunkowana na Node.js 1822+ oraz TypeScript 5.0+, działa identycznie w Linux CI runnerach i stacjach roboczych programistów, a także posiada licencję MIT z otwartym śledzeniem problemów na GitHub .

Władowanie sceny OBJ i wyeksportowanie jako glTF

Instaluj z npm, a następnie użyj scene.open() ze ObjLoadOptions do ładowania siatki wraz z plikem materiału MTL. Zarówno open() i save() są synchroniczne nie ma await lub jest potrzebne łańcuchowanie obietnicy. Wzywanie scene.save() z rozszerzeniem .gltf pisze standardowy glTF 2.0 JSON ?? format automatycznie wywnioskowany z przedłużenia pliku.

npm install @aspose/3d

import { Scene } from "@aspose/3d";
import { ObjLoadOptions } from "@aspose/3d/formats/obj";
const scene = new Scene();
scene.open("model.obj", new ObjLoadOptions());
// Export as glTF 2.0 JSON
scene.save("model.gltf");

Konwersja STL na binarny GLB

Aby wygenerować kompaktowy binarny GLB zamiast domyślnego JSON glTF, prześlij GltfSaveOptions z binaryMode = true. Zarówno open() jak i save() są synchroniczne nie potrzeba await .

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";
const scene = new Scene();
scene.open("mesh.stl");
// Save as compact binary GLB
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Najczęściej Zadawane Pytania

Co to jest Aspose.3D FOSS dla TypeScript?

Jest to darmowa, licencjonowana przez MIT biblioteka TypeScript/Node.js do ładowania, manipulowania i zapisywania scen 3D bez instalowania żadnego native addon lub zewnętrznego SDK.

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

OBJ (z .mtl), glTF 2.0 i GLB, STL (binary and ASCII), COLLADA (DAE), 3MF oraz FBX. Każdy format ma dedykowaną klasę opcji typów.

Czy wymaga natywnych dodatków Node.js?

Nie. Aspose.3D FOSS dla TypeScript jest czystym JavaScript/TypeScript. Nie wymaga kroku kompilowania i ma jedną zależność czasu uruchomienia (xmldom) zainstalowaną automatycznie przez npm.

Jak go zainstalować?

Uruchom npm install @aspose/3d. Nie są wymagane dodatkowe pakiety systemowe ani natywne dodatki.

Które wersje Node.js i TypeScript są obsługiwane?

Node.js 18, 20 i 22+. TypeScript 5.0+. Biblioteka kompiliuje w CommonJS i działa z ścisłymi ustawieniami Typskrypta .

Czy dostarcza się z definicjami typów TypeScript?

Tak. Wszystkie klasy, metody, enum i typy opcji są w pełni napisane z noImplicitAny i strictNullChecks włączone.

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

Tak. Klasy opcji na format, takie jak ObjLoadOptions i GltfSaveOptions pozwalają przewrócić osi, dostosować skalę i normalizację normalnych bez kodów do analizy niestandardowej.

Gdzie mogę znaleźć kod źródłowy?

Biblioteka jest licencjonowana przez MIT i hostowana na GitHub.

  

Zasoby Wsparcia i Nauki

 Polski