Entwickler-Leitfaden

Aspose.3D FOSS für TypeScript ist eine Open-Source, MIT-lizenzierte Bibliothek, die es Node.js Entwicklern ermöglicht 3D Szenen mit vollem Typ Script Sicherheit zu laden, zu konstruieren, umzuwandeln und zu exportieren. Ob Sie nun ein Assets Pipeline erstellen, einen Formatkonvertierungsdienst, ein Geometrievalidierungstool oder ein 3d Content Authoring Skript, diese Bibliotheek bietet eine saubere, konsistente API unterstützt durch ein Szene-Grafikmodell, das branchenübliche 3 D Konzepte widerspiegelt.

Dieser Entwicklerführer deckt alles ab, was Sie brauchen, um über die schnelle Installation hinaus zu gehen und 3D-Verarbeitungskode in Produktionsqualität zu schreiben.

Was Sie in diesem Abschnitt finden werden

Merkmale und Funktionalität

Die Eigenschaften page ist die primäre Referenz für die Arbeit mit Aspose.3D FOSS für TypeScript.:

  • Formatunterstützung: OBJ (mit .mtl-Materialien), glTF 2.0 / GLB-Binär, STL (binär und ASCII), COLLADA (DAE), 3MF und FBX, mit Klassen für Lade- und Speicheroptionen pro Format, einschließlich ObjLoadOptions und GltfSaveOptions.
  • Schaubild:Wie: Scene, Node, Entity, Transform, und SceneObject Kompositionen in einer vollständigen Szenenhierarchie, einschließlich Kinderknoten-Traversal-Muster.
  • Geometrie und Mesh-API:Die Zusammenarbeit mit den Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode,und . ReferenceMode für die Geometrieverarbeitung.
  • Materialsystem: Anwendung LambertMaterial, PhongMaterial,und . PbrMaterial (PBR für glTF) zu Szenenknoten und zum Lesen von Material-Eigenschaften, die aus .mtl-Dateien geladen werden.
  • Mathematik-Dienste:Verwendung: Vector3, Vector4, Matrix4, Quaternion,und . BoundingBox für Transformationen, Grenzfeldabfragen und geometrische Berechnungen.
  • Animation und Film: Konstruktion und Lese AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation,und . Extrapolation Daten.
  • Strom- und Pufferunterstützung: Lade 3D-Szenen aus dem Speicher ein Buffer Objekte über die scene.openFromBuffer() für Serverlose und Streaming-Anwendungsfälle.
  • Vollständige Anwendungsbeispiele: End-to-end TypeScript Skripte zum Laden von OBJ, Exportieren von GLB, Rundreisen von STL und Durchlaufen von Szenengraphen.
  • Tipps, häufige Probleme und FAQs: Praktische Leitlinien zur Vermeidung von häufigen Fallstricken bei der Produktion.
  • Zusammenfassung der API-Referenzen: Schnelle Referenzliste aller Schlüsselklassen und ihrer primären Methoden.

Schlüsselbegriffe

Schaubild:Alle 3D-Inhalte in Aspose.3D FOSS sind als Baum von Node Objekte, die auf der scene.rootNode.Jeder Knoten kann eine Entity (wie z. B. eine Mesh, Camera,oder , Light) und a) Transform Das positioniert es in der Hierarchie.

Format-agnostische 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 TypScript-Typisierung:Die Bibliothek wird mit strengen Kompilator-Einstellungen ausgeliefert (noImplicitAny, strictNullChecksJede Klasse, jede Methode und jeder Options-Eigenschaft ist vollständig getypet, was Ihnen Autocomplete IDE und Kompilierungszeit Sicherheit während Ihres 3D-Verarbeitungskodes gibt.

Einzelne Abhängigkeit:Die einzige Laufzeit-Abhängigkeit ist: xmldom, das automatisch von npm installiert wird. Es gibt keine nativen Addons zu kompilieren und keine Systempakete zu installe.

Wie man anfängt

Wenn Sie die Bibliothek noch nicht installiert haben, sehen Sie den Abschnitt “Lösungen” unter Wie man anfängt Abschnitt und die Installation Vor dem Weiterlesen.

Erhältliche Themen

 Deutsch