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

Aspose.3D FOSS dla TypeScript

Ładuj, konstruuj, przekształcaj i eksportuj sceny 3D z Node.js — w pełni typowane, open-source i gotowe do produkcji przy jednorazowej instalacji npm.

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

Dokumentacja GitHub

Open-Source biblioteka TypeScript do przetwarzania plików 3D

Aspose.3D FOSS for TypeScript jest biblioteką na licencji MIT do pracy z formatami plików 3D w aplikacjach Node.js. Zainstaluj ją za pomocą jednego polecenia npm install @aspose/3d i od razu zacznij odczytywać, konstruować i zapisywać sceny 3D w TypeScript, bez natywnych dodatków do kompilacji, bez zewnętrznych SDK do instalacji i bez wymaganego renderera.

Biblioteka udostępnia w pełni typowane API grafu sceny zbudowane 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 celuje w Node.js 18, 20 i 22+ z TypeScript 5.0+ i kompiluje do CommonJS. Biblioteka jest dostarczana z rygorystycznymi ustawieniami kompilatora TypeScript (noImplicitAny, strictNullChecks), dzięki czemu Twoje IDE zapewnia pełne uzupełnianie i bezpieczeństwo w czasie kompilacji. Jej jedyna zależność w czasie wykonywania, xmldom, jest instalowana automatycznie. Dla rodziny produktów korporacyjnych zobacz Aspose.3D — Enterprise Product Family.

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

  • OBJ / MTL: Ładuj pliki Wavefront OBJ wraz z towarzyszącymi definicjami materiałów.
  • glTF 2.0 / GLB: Ładowanie materiału PBR i binarny output GLB przez GltfSaveOptions.
  • STL: Odczyt i zapis zarówno binarnego, jak i ASCII STL z pełną weryfikacją roundtrip.
  • COLLADA, 3MF, FBX: Dodatkowe wsparcie formatów z klasami opcji specyficznymi dla każdego formatu.
  • Pełne typy TypeScript: Każda klasa, metoda i opcja jest ściśle typowana przy użyciu noImplicitAny i strictNullChecks.

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

  • Node.js asset pipelines: Importuj pliki OBJ, weryfikuj i zmieniaj orientację geometrii, a następnie eksportuj jako GLB w CI.
  • Narzędzia do gier: Przetwarzaj wsadowo siatki 3D bez natywnego silnika lub renderera.
  • 3D printing workflows: Odczyt, weryfikacja i ponowny eksport plików STL i 3MF.
  • Serverless backends: Uruchom punkty końcowe konwersji 3D w Lambda lub Cloud Functions.
  • Migracja treści: Konwertuj pomiędzy rodzinami formatów na dużą skalę z jednego skryptu.

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 przy użyciu klas opcji.
  • Normal normalization: Automatycznie normalizuj normalne wierzchołków przy ładowaniu lub zapisie.
  • Binarny vs. JSON wyjście: Wybierz kompaktowy GLB lub czytelny glTF za pomocą GltfSaveOptions.
  • Kontrola ładowania materiału: Włącz lub wyłącz ładowanie MTL/tekstur w celu szybszego parsowania.
  • Round-trip fidelity: Nieznane węzły grafu sceny są zachowywane dosłownie przy ponownym zapisie.

Doświadczenie dewelopera

Instaluje Aspose.3D FOSS dla TypeScript za pomocą jednego polecenia npm install @aspose/3d. Nie ma natywnych dodatków do kompilacji. Biblioteka jest czystym TypeScript/JavaScript z jedną automatycznie instalowaną zależnością (xmldom).

Silnie typowane API zapewnia pełne podpowiedzi IDE dla każdej klasy grafu sceny i opcji formatu. Biblioteka jest przeznaczona dla Node.js 18–22+ i TypeScript 5.0+, działa identycznie na Linux CI runners i stacjach roboczych deweloperów, oraz jest MIT-licensed z otwartym issue trackerem na GitHub.

Wczytaj scenę OBJ i wyeksportuj jako glTF

Zainstaluj przy użyciu npm, a następnie użyj scene.open() z ObjLoadOptions, aby załadować siatkę wraz z jej plikiem materiału MTL. Zarówno open(), jak i save() są synchroniczne — nie jest potrzebny await ani łańcuchowanie Promise. Wywołanie scene.save() z rozszerzeniem .gltf zapisuje standardowy glTF 2.0 JSON — format jest automatycznie wywnioskowany z rozszerzenia 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");

Konwertuj STL na Binary GLB

Aby uzyskać kompaktowy binarny GLB zamiast domyślnego JSON glTF, przekaż GltfSaveOptions z binaryMode = true. Zarówno open(), jak i save() są synchroniczne — nie jest potrzebny 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

Czym jest Aspose.3D FOSS dla TypeScript?

Jest to darmowa, na licencji MIT biblioteka TypeScript/Node.js do ładowania, manipulacji i zapisywania scen 3D bez instalowania żadnych natywnych dodatków ani zewnętrznych SDK.

Jakie formaty 3D są obsługiwane?

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

Czy wymaga natywnych dodatków Node.js?

Nie. Aspose.3D FOSS dla TypeScript to czysty JavaScript/TypeScript. Nie wymaga kroku kompilacji i ma jedną zależność w czasie wykonywania (xmldom) instalowaną automatycznie przez npm.

Jak to zainstalować?

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

Jakie wersje Node.js i TypeScript są obsługiwane?

Node.js 18, 20 i 22+. TypeScript 5.0+. Biblioteka kompiluje się do CommonJS i działa z rygorystycznymi ustawieniami TypeScript.

Czy jest dostarczany z definicjami typów TypeScript?

Tak. Wszystkie klasy, metody, wyliczenia i typy opcji są w pełni typowane przy włączonych noImplicitAny i strictNullChecks.

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

Tak. Klasy opcji dla poszczególnych formatów, takie jak ObjLoadOptions i GltfSaveOptions, pozwalają odwrócić osie, dostosować skalę i znormalizować wektory normalne bez własnego kodu parsującego.

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

Biblioteka jest licencjonowana na licencji MIT i hostowana na GitHubie. Zgłoszenia błędów i pull requesty są mile widziane.

  

Zasoby Wsparcia i Nauki

 Polski