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

Aspose.3D FOSS für TypeScript

Laden, konstruieren, transformieren und exportieren Sie 3D‑Szenen aus Node.js — vollständig typisiert, Open-Source und produktionsreif mit einer einzigen npm-Installation.

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

Dokumentation GitHub

Open-Source TypeScript-Bibliothek für 3D-Dateiverarbeitung

Aspose.3D FOSS für TypeScript ist eine MIT-lizenzierte Bibliothek zum Arbeiten mit 3D-Dateiformaten in Node.js-Anwendungen. Installieren Sie sie mit einem einzigen npm install @aspose/3d-Befehl und beginnen Sie sofort damit, 3D‑Szenen in TypeScript zu lesen, zu konstruieren und zu schreiben, ohne native Add‑Ons kompilieren zu müssen, ohne externe SDKs installieren zu müssen und ohne dass ein Renderer erforderlich ist.

Die Bibliothek stellt eine vollständig typisierte Szenen‑Graph‑API bereit, die um Scene, Node, Entity, Mesh, Camera, Light und Transform herum gebaut ist, das gleiche konzeptionelle Modell, das von professionellen 3D‑Tools verwendet wird. Die Formatunterstützung umfasst OBJ (Wavefront, mit .mtl‑Materialladen), glTF 2.0 und GLB‑Binär (PBR‑Materialien), STL (binär und ASCII, voller Rundweg), COLLADA (DAE), 3MF und FBX. Formatbezogene Optionsklassen wie ObjLoadOptions und GltfSaveOptions geben Ihnen präzise Kontrolle über die Orientierung des Koordinatensystems, Skalierung, Normalen‑Normalisierung, binär vs. JSON‑Ausgabe und das Laden von Materialien.

Aspose.3D FOSS zielt auf Node.js 18, 20 und 22+ mit TypeScript 5.0+ ab und kompiliert zu CommonJS. Die Bibliothek wird mit strengen TypeScript‑Compiler‑Einstellungen (noImplicitAny, strictNullChecks) ausgeliefert, sodass Ihre IDE vollständige Autovervollständigung und Kompilierzeit‑Sicherheit bietet. Ihre einzige Laufzeitabhängigkeit, xmldom, wird automatisch installiert. Für die Enterprise‑Produktfamilie siehe Aspose.3D — Enterprise Product Family.

3D-Formatunterstützung und typisierte Szenen‑Graph‑API

  • OBJ / MTL: Wavefront OBJ-Dateien mit zugehörigen Materialdefinitionen laden.
  • glTF 2.0 / GLB: PBR-Materialladen und binäre GLB-Ausgabe über GltfSaveOptions.
  • STL: Lesen und Schreiben von binären und ASCII STL mit vollständiger Rundreise‑Verifizierung.
  • COLLADA, 3MF, FBX: Zusätzliche Formatunterstützung mit klassenbezogenen Optionen pro Format.
  • Full TypeScript types: Jede Klasse, Methode und Option ist stark typisiert mit noImplicitAny und strictNullChecks.

Wo Aspose.3D FOSS verwendet werden kann

  • Node.js asset pipelines: OBJ-Dateien importieren, Geometrie validieren und neu ausrichten und als GLB im CI exportieren.
  • Spiel-Tools: Stapelverarbeitung von 3D-Meshes ohne native Engine oder Renderer.
  • 3D-Druck-Workflows: Lesen, validieren und STL- und 3MF-Dateien erneut exportieren.
  • Serverlose Backends: Führen Sie 3D‑Konvertierungsendpunkte in Lambda oder Cloud Functions aus.
  • Inhaltsmigration: Konvertieren Sie zwischen Formatfamilien in großem Umfang aus einem einzigen Skript.

Pro-Format-Optionen und Koordinatensteuerung

  • Koordinatensystemorientierung: Achsen umkehren und Skalierung pro Format mit Optionsklassen anpassen.
  • Normalnormalisierung: Normalisieren Sie automatisch Vertex-Normalen beim Laden oder Speichern.
  • Binär vs. JSON Ausgabe: Wählen Sie kompaktes GLB oder lesbares glTF über GltfSaveOptions.
  • Material-Ladekontrolle: Aktivieren oder deaktivieren Sie das Laden von MTL/Textur für schnellere Analyse.
  • Round-trip fidelity: Unbekannte Szenengraph‑Knoten werden beim erneuten Speichern unverändert beibehalten.

Entwicklererfahrung

Aspose.3D FOSS für TypeScript wird mit einem einzigen npm install @aspose/3d-Befehl installiert. Es gibt keine nativen Addons zum Kompilieren. Die Bibliothek ist reines TypeScript/JavaScript mit einer automatisch installierten Abhängigkeit (xmldom).

Die stark typisierte API bietet vollständige IDE‑Autocomplete für jede Scene‑Graph‑Klasse und Formatoption. Die Bibliothek zielt auf Node.js 18–22+ und TypeScript 5.0+ ab, läuft identisch auf Linux‑CI‑Runnern und Entwicklerarbeitsplätzen und ist MIT‑lizenziert mit einem offenen Issue‑Tracker auf GitHub.

Lade eine OBJ‑Szene und exportiere sie als glTF

Installieren Sie mit npm, dann verwenden Sie scene.open() mit ObjLoadOptions, um das Mesh zusammen mit seiner MTL‑Materialdatei zu laden. Sowohl open() als auch save() sind synchron — kein await oder Promise‑Chaining ist erforderlich. Der Aufruf von scene.save() mit einer .gltf‑Erweiterung schreibt standardmäßiges glTF 2.0 JSON — das Format wird automatisch aus der Dateierweiterung abgeleitet.

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");

STL in Binäres GLB konvertieren

Um ein kompaktes binäres GLB anstelle des standardmäßigen JSON glTF zu erzeugen, übergeben Sie GltfSaveOptions mit binaryMode = true. Sowohl open() als auch save() sind synchron — es wird kein await benötigt.

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);

Häufig gestellte Fragen

Was ist Aspose.3D FOSS für TypeScript?

Es ist eine kostenlose, MIT-lizenzierte TypeScript/Node.js-Bibliothek zum Laden, Manipulieren und Speichern von 3D‑Szenen, ohne ein natives Add‑on oder externes SDK installieren zu müssen.

Welche 3D-Formate werden unterstützt?

OBJ (mit .mtl), glTF 2.0 und GLB, STL (binär und ASCII), COLLADA (DAE), 3MF und FBX. Jedes Format hat eine dedizierte typisierte Optionsklasse.

Benötigt es native Node.js-Addons?

Nr. Aspose.3D FOSS für TypeScript ist reines JavaScript/TypeScript. Es erfordert keinen Kompilierungsschritt und hat eine einzige Laufzeitabhängigkeit (xmldom) automatisch von npm installiert.

Wie installiere ich es?

Führen Sie npm install @aspose/3d aus. Es werden keine zusätzlichen Systempakete oder nativen Add‑ons benötigt.

Welche Node.js- und TypeScript-Versionen werden unterstützt?

Node.js 18, 20 und 22+. TypeScript 5.0+. Die Bibliothek kompiliert zu CommonJS und funktioniert mit strengen TypeScript‑Einstellungen.

Wird es mit TypeScript-Typdefinitionen ausgeliefert?

Ja. Alle Klassen, Methoden, Enums und Optionstypen sind vollständig typisiert, wobei noImplicitAny und strictNullChecks aktiviert sind.

Kann ich die Orientierung des Koordinatensystems steuern?

Ja. Formatbezogene Optionsklassen wie ObjLoadOptions und GltfSaveOptions ermöglichen das Drehen von Achsen, Anpassen der Skalierung und Normalisieren von Normalen ohne benutzerdefinierten Parsing‑Code.

Wo finde ich den Quellcode?

Die Bibliothek ist unter der MIT‑Lizenz veröffentlicht und auf GitHub gehostet. Fehlerberichte und Pull‑Requests sind willkommen.

  

Support und Lernressourcen

 Deutsch