Entwicklerhandbuch

Aspose.3D FOSS für TypeScript ist eine MIT-lizenzierte Open-Source-Bibliothek, mit der Node.js-Entwickler 3D-Szenen mit vollständiger TypeScript-Typsicherheit laden, konstruieren, transformieren und exportieren können.Ob Sie eine Asset-Pipeline, einen Format-Konvertierungsdienst, ein Werkzeug zur Geometrievalidierung oder ein 3D-Inhaltsschreiben erstellen, diese Bibliothek bietet eine saubere, konsistente API, die durch ein Szenengrafikmodell unterstützt wird, das branchenübliche 3D-Konzepte widerspiegelt.

Dieser Entwickler-Leitfaden deckt alles ab, was Sie brauchen, um über die schnelle Installation hinaus zu gehen und Produktionskvalität 3D-Verarbeitungscode zu schreiben.

Was Sie in diesem Abschnitt finden werden

Funktionen und Funktionen

Der Funktionen Seite ist die primäre Referenz für die Arbeit mit Aspose.3D FOSS für TypeScript. Sie behandelt:

  • Formatunterstützung: OBJ (mit .mtl-Materialien), glTF 2.0 / GLB-Binär, STL (binär und ASCII), COLLADA (DAE), 3MF und FBX, mit pro-Format Lade- und Speicheroption‑Klassen einschließlich ObjLoadOptions und GltfSaveOptions.
  • Szenengraph: Wie Scene, Node, Entity, Transform, und SceneObject zu einer vollständigen Szenenhierarchie zusammensetzen, einschließlich Traversalmustern für Kindknoten.
  • Geometrie- und Mesh-API: Arbeiten mit Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, und ReferenceMode für die Geometrieverarbeitung.
  • Materialsystem: Anwenden LambertMaterial, PhongMaterial, und PbrMaterial (PBR für glTF) auf Szenenknoten und das Lesen von Materialeigenschaften, die aus .mtl-Dateien geladen wurden.
  • Mathematische Hilfsfunktionen: Verwenden Vector3, Vector4, Matrix4, Quaternion, und BoundingBox für Transformationen, Bounding-Box‑Abfragen und geometrische Berechnungen.
  • Animation: Erstellen und Lesen AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, und Extrapolation Daten.
  • Stream- und Pufferunterstützung: Laden von 3D-Szenen aus dem Arbeitsspeicher Buffer Objekte über scene.openFromBuffer() für serverlose und Streaming-Anwendungsfälle.
  • Vollständige Anwendungsbeispiele: End-to-End TypeScript-Skripte zum Laden von OBJ, Exportieren von GLB, Rundreise von STL und Durchlaufen von Szenengraphen.
  • Tipps, häufige Probleme und FAQ:Praktische Anleitung zur Vermeidung häufiger Fallstricke im Produktionseinsatz.
  • Zusammenfassung der API-Referenz: Kurzreferenzliste aller wichtigen Klassen und ihrer Hauptmethoden.

Wichtige Konzepte

Szenengraph: Alle 3D-Inhalte in Aspose.3D FOSS werden als Baum von Node Objekten mit Wurzel bei scene.rootNode. Jeder Knoten kann ein Entity (wie z. B. ein Mesh, Camera, oder Light) Transform das ihn in der Hierarchie positioniert.

Formatunabhängige API: Sie öffnen jedes unterstützte Format über scene.open() oder scene.openFromBuffer() und speichern in jedes unterstützte Format über scene.save(). Die gleichen Szenengraph-Objekte werden unabhängig vom Quell- oder Zielformat verwendet.

Starke TypeScript-Typisierung: Die Bibliothek wird mit strengen Compiler-Einstellungen (noImplicitAny, strictNullChecks) und vollständigen Typdefinitionen. Jede Klasse, Methode und Options‑Eigenschaft ist vollständig typisiert, was Ihnen IDE‑Autovervollständigung und Compile‑Zeit‑Sicherheit für Ihren gesamten 3D‑Verarbeitungscode bietet.

Einzige Abhängigkeit: Die einzige Laufzeitabhängigkeit ist xmldom, die automatisch über npm installiert wird. Es gibt keine nativen Add‑Ons zum Kompilieren und keine Systempakete zu installieren.

Erste Schritte

Wenn Sie die Bibliothek noch nicht installiert haben, siehe die Erste Schritte Abschnitt und die Installation Leitfaden, bevor Sie weiter lesen.

Verfügbare Themen

 Deutsch