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 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 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 aufgebaut ist, dem gleichen konzeptuellen 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.

Unterstützung für 3D-Formate und typisierte Szenen‑Graph‑API

  • OBJ / MTL: Laden Sie Wavefront‑OBJ‑Dateien mit zugehörigen Materialdefinitionen.
  • glTF 2.0 / GLB: PBR‑Materialladen und binäre GLB‑Ausgabe über GltfSaveOptions.
  • STL: Lesen und schreiben Sie sowohl binäre als auch ASCII‑STL mit vollständiger Round‑Trip‑Verifizierung.
  • COLLADA, 3MF, FBX: Zusätzliche Formatunterstützung mit format‑spezifischen Optionsklassen.
  • Vollständige TypeScript‑Typen: 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, validieren und Geometrie neu ausrichten und in CI als GLB exportieren.
  • Spiel-Tools: 3D-Meshes stapelweise verarbeiten ohne native Engine oder Renderer.
  • 3D‑Druck‑Workflows: STL- und 3MF-Dateien lesen, validieren und erneut exportieren.
  • Serverlose Backends: Führen Sie 3D-Konvertierungsendpunkte in Lambda oder Cloud Functions aus.
  • Inhaltsmigration: Konvertieren Sie im großen Maßstab zwischen Formatfamilien mit einem einzigen Skript.

Optionen pro Format und Koordinatensteuerung

  • Koordinatensystemorientierung: Achsen umkehren und Skalierung je nach Format mit Optionsklassen anpassen.
  • Normalen-Normalisierung: Vertex-Normalen beim Laden oder Speichern automatisch normalisieren.
  • Binär- vs. JSON-Ausgabe: Kompaktes GLB oder lesbares glTF über GltfSaveOptions auswählen.
  • Steuerung des Materialladens: MTL/Texture-Laden aktivieren oder deaktivieren für schnellere Analyse.
  • Rundreise‑Treue: Unbekannte Szenengraph‑Knoten werden beim erneuten Speichern unverändert beibehalten.

Entwicklererfahrung

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

Die stark typisierte API bietet vollständige IDE‑Autovervollständigung für jede Szenegraph‑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.

Lade eine OBJ‑Szene und exportiere sie als glTF

Installieren Sie mit npm und verwenden Sie dann die synchrone Methode scene.open() mit ObjLoadOptions, um das Mesh zusammen mit seiner MTL‑Materialdatei zu laden. Ein Aufruf von scene.save() mit der Erweiterung .gltf 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());

// Exportieren als glTF 2.0 JSON
scene.save("model.gltf");

Konvertiere STL in ein binäres GLB

Um ein kompaktes binäres GLB anstelle des standardmäßigen JSON glTF zu erzeugen, übergeben Sie GltfSaveOptions mit binaryMode = true.

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

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

// Als kompaktes binäres GLB speichern
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?

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 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 wird zu CommonJS kompiliert 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 Vertauschen von Achsen, Anpassen der Skalierung und Normalisieren von Normalen, ohne eigenen 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