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

Aspose.3D FOSS for TypeScript

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

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

Dokumentation GitHub

Open-Source TypeScript Bibliothek für die 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 erstellen 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 ein vollständig typisiertes Szenen‑Graph‑API bereit, das um Scene, Node, Entity, Mesh, Camera, Light und Transform herum aufgebaut ist – das gleiche konzeptionelle Modell, das von professionellen 3D‑Tools verwendet wird. Unterstützte Formate umfassen OBJ (Wavefront, mit .mtl‑Materialladen), glTF 2.0 und GLB‑Binär (PBR‑Materialien), STL (binär und ASCII, voller Round‑Trip), COLLADA (DAE), 3MF und FBX. Format‑spezifische Optionsklassen wie ObjLoadOptions und GltfSaveOptions geben Ihnen präzise Kontrolle über die Orientierung des Koordinatensystems, Skalierung, Normalen‑Normalisierung, binäre vs. JSON‑Ausgabe und das Laden von Materialien.

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

Unterstützung von 3D-Format und eingetypter Scene-Graph API

  • ** OBJ/MTL:** Befördern Sie die Wavefront-OBJ-Dateien mit den dazugehörigen Materialdefinitionen.
  • glTF 2.0 / GLB: PBR-Materialbelastung und binäre GDB-Ausgabe über GltfSaveOptions.
  • STL: Lesen und Schreiben von binären und ASCII-ST L mit vollständiger Rundreiseüberprüfung.
  • COLLADA, 3MF, FBX: Zusätzliche Formatunterstützung mit Optionsklassen pro Format.
  • Vollständige TypScript-Typen: Jede Klasse, Methode und Option ist stark mit noImplicitAny und strictNullChecks eingegeben.

Wo Aspose.3D FOSS verwendet werden kann

  • Node.js-Asset Pipelines: Importieren von OBJ-Dateien, Validieren und Neuausrichten der Geometrie sowie Export als GLB in CI.
  • Spielwerkzeug: 3D-Maschen ohne native Engine oder Render.
  • 3D-Druckarbeitsflüsse: STL- und 3MF-dateien lesen, validieren und wiederexportieren.
  • Serverless-Backends: Führen Sie 3D-Konvertierungseindpunkte in Lambda oder Cloud Functions aus.
  • Inhaltmigration: Konvertieren zwischen Formatfamilien in einem einzigen Skript.

Optionen für das Format und Koordinatensteuerung

  • ** Koordinatensystemorientierung:** Umdrehen der Achsen und Anpassung des Maßstabs je Format mit Optionsklassen.
  • Normale Normalisierung: Normaliseren Sie automatisch die normalen Werte beim Laden oder Speichern.
  • ** Binär-JSON-Ausgabe:** Wählen Sie kompakt GLB oder lesbares glTF über GltfSaveOptions.
  • Material-Ladungskontroll: MTL/Texture-Loading für eine schnellere Analyse aktivieren oder deaktiviern.
  • ** Rundfahrt-Fidelität:** Unbekannte Szenengrafen werden beim Wiederherstellen buchstäblich erhalten.

Entwicklererfahrung

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

Der stark typisierte API bietet vollständige IDE‑Autovervollständigung 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 Entwickler‑Workstations und ist unter der MIT‑Lizenz mit einem offenen Issue‑Tracker auf GitHub veröffentlicht.

Laden Sie eine OBJ-Szene und exportieren als glTF

Installieren Sie mit npm, dann verwenden Sie scene.open() mit ObjLoadOptions um das Netz zusammen mit seiner MTL-Materialdatei zu laden. Sowohl open() als auch save() sind synchron keine await oder Promise Chaining erforderlich. Das Aufrufen von scene.save() durch eine .gltf Erweiterung schreibt standard glTF 2.0 JSON ?? das Format wird automatisch aus der Dateierweitung 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");

Umwandeln von STL in binäres GLB

Um eine kompakte binäre GLB anstelle des Standard-JSON glTF zu erzeugen, geben Sie GltfSaveOptions mit binaryMode = true weiter. Sowohl open() als auch save() sind synchron es ist kein await erforderlich.

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 TypScript?

Es ist eine kostenlose, mit MIT-Lizenz lizenzierte TypeScript/Node.js Bibliothek zum Laden, Manipulieren und Speichern von 3D-Szenen ohne Installation eines nativen Addons oder externen SDKs.

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 spezielle Typoptionsklasse.

Ist ein natives Node.js-Addon erforderlich?

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

Wie installiere ich es?

Führen Sie npm install @aspose/3d aus. Es sind keine zusätzlichen Systempakete oder nativen Add‑Ons erforderlich.

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

Node.js 18, 20 und 22+. TypeScript 5.0+ Die Bibliothek wird auf CommonJS kompiliert und arbeitet mit strengen Typescript-Einstellungen.

Wird es mit TypScript-Typdefinitionen geliefert?

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

Kann ich die Koordinatensystemorientierung steuern?

Ja. Per-format Option Klassen wie ObjLoadOptions und GltfSaveOptions lassen Sie Achsen umdrehen, Skala anpassen und Normalen ohne benutzerdefinierten Parsing Code normalisieren.

Wo finde ich den Quellcode?

Die Bibliothek ist MIT-lizenziert und auf GitHub gehostet. Bugberichte und Pull Requests sind willkommen.

  

Support und Lernressourcen

 Deutsch