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 typowane, open-source i gotowe do produkcji przy jednorazowej instalacji npm.

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

Dokumentacja GitHub

Biblioteka TypeScript open-source do przetwarzania plików 3D

Aspose.3D FOSS for TypeScript jest biblioteką na licencji MIT umożliwiającą pracę 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, instalowania zewnętrznych SDK ani wymaganego renderera.

Biblioteka udostępnia w pełni typowane API grafu sceny oparte na Scene, Node, Entity, Mesh, Camera, Light i Transform, czyli tym samym modelu koncepcyjnym używanym 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 round‑trip), COLLADA (DAE), 3MF i FBX. Klasy opcji specyficzne dla formatu, 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. Jedyną zależnością w czasie wykonywania jest xmldom, która jest instalowana automatycznie.

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

  • OBJ / MTL: Ładowanie plików Wavefront OBJ wraz z towarzyszącymi definicjami materiałów.
  • glTF 2.0 / GLB: Ładowanie materiałów PBR oraz binarne wyjście GLB za pomocą GltfSaveOptions.
  • STL: Odczyt i zapis zarówno binarnego, jak i ASCII STL z pełną weryfikacją round‑trip.
  • COLLADA, 3MF, FBX: Dodatkowa obsługa formatów z klasami opcji specyficznymi dla każdego formatu.
  • Pełne typy TypeScript: Każda klasa, metoda i opcja jest silnie typowana przy użyciu noImplicitAny i strictNullChecks.

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

  • Potoki zasobów Node.js: Importuj pliki OBJ, weryfikuj i ponownie orientuj geometrię oraz eksportuj jako GLB w CI.
  • Narzędzia do gier: Przetwarzaj wsadowo siatki 3D bez natywnego silnika lub renderera.
  • Procesy druku 3D: Odczytuj, weryfikuj i ponownie eksportuj pliki STL i 3MF.
  • Serverless backends: Uruchamiaj endpointy konwersji 3D w Lambda lub Cloud Functions.
  • Content migration: Konwertuj pomiędzy rodzinami formatów na dużą skalę z jednego skryptu.

Opcje specyficzne dla formatu 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.
  • Normalizacja wektorów normalnych: Automatycznie normalizuj wektory normalne wierzchołków przy ładowaniu lub zapisie.
  • Wyjście binarne vs. JSON: Wybierz kompaktowy GLB lub czytelny glTF za pomocą GltfSaveOptions.
  • Kontrola ładowania materiałów: Włącz lub wyłącz ładowanie MTL/tekstur, aby przyspieszyć parsowanie.
  • Wierność przy round-trip: Nieznane węzły grafu sceny są zachowywane dosłownie przy ponownym zapisie.

Doświadczenie dewelopera

Aspose.3D FOSS dla instalacji 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 Linuxowych runnerach CI oraz stacjach roboczych deweloperów, a jest licencjonowana na licencji MIT z otwartym trackerem zgłoszeń na GitHubie.

Wczytaj scenę OBJ i wyeksportuj jako glTF

Zainstaluj za pomocą npm, a następnie użyj synchronicznej metody scene.open() z ObjLoadOptions, aby wczytać siatkę wraz z jej plikiem materiałów MTL. 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());

// Eksportuj jako glTF 2.0 JSON
scene.save("model.gltf");

Konwertuj STL na binarny GLB

Aby wygenerować kompaktowy binarny GLB zamiast domyślnego JSON glTF, przekaż GltfSaveOptions z ustawieniem binaryMode = true.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";

const scene = new Scene();
scene.open("mesh.stl");

// Zapisz jako kompaktowy binarny 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ętrznego 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 for TypeScript to czysty JavaScript/TypeScript. Nie wymaga kroku kompilacji i ma jedną zależność w czasie wykonywania (xmldom) instalowaną automatycznie przez npm.

Jak go 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 specyficzne dla formatu, 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 zasadach MIT i hostowana na GitHubie. Zgłoszenia błędów oraz pull requesty są mile widziane.

  

Zasoby Wsparcia i Nauki

 Polski