API-Referenz für Aspose.3D 26.1.0 (.NET 10.0+, MIT-Lizenz).
Alle Klassen befinden sich im Aspose.ThreeD Root-Namespace. Die Root-Using-Direktive lautet:
C#-Namenskonvention: Alle Eigenschaften verwenden die standardmäßige C#-Eigenschaftssyntax. Zum Beispiel verwenden Sie scene.RootNode statt scene.getRootNode(), und transform.Translation = ... statt transform.setTranslation(...).
Vektorfeld-Schreibweise: Die Bibliothek hat zwei Sätze von Vektortypen. Aspose.ThreeD.Utilities.Vector2/3/4 (verwendet von Mesh.ControlPoints, Geometrie und den meisten mathematischen Operationen) sind Doppelpräzision mit kleingeschriebenen öffentlichen Feldern (v.x, v.y, v.z, v.w). Die einfacheren Aspose.ThreeD.Vector2/3/4 Strukturen (in Vector.cs) sind Einzelpräzision (float) mit Großbuchstaben öffentliche Felder (v.X, v.Y, v.Z). FVector2/3/4 und Quaternion und Matrix4 verwenden Sie den Zugriff auf Felder in Großbuchstaben. Verwenden Sie Aspose.ThreeD.Utilities Typen für geometrische Arbeiten.
Kern‑Szenengraph
| Methods | Methods |
|---|
Scene | Container auf oberster Ebene für alle 3D‑Szenendaten. Enthält den Wurzelknoten, Asset-Metadaten und Animationsclips. Stellt bereit Open() und Save() als die primären I/O-Einstiegspunkte. |
Node | Ein benannter Knoten in der Szenenhierarchie. Besitzt eine Liste von Kindknoten und eine Liste von angehängten Entity Objekte wie Meshes, Kameras und Lichter. Trägt ein lokales Transform. |
Entity | Abstrakte Basisklasse für alle Objekte, die an ein Node. Bietet Namen und Identität, aber keine eigene Geometrie. |
SceneObject | Gemeinsame Basisklasse für Node und Entity. Bietet die Schnittstelle für die Eigenschaftssammlung, die für benutzerdefinierte Metadaten verwendet wird. |
A3DObject | Wurzelbasisklasse für alle Aspose.3D verwalteten Objekte. Gibt das Name Eigenschaft und das Properties Sammlung. |
INamedObject | Schnittstelle, die ein Name Eigenschaft. Implementiert von Node, Entity, und mehrere format-spezifische Deskriptortypen. |
Geometrie und Mesh
| Methods | Methods |
|---|
Mesh | Polygonnetz-Entität. Speichert Kontrollpunkte (Vertex-Positionen als Vector4), Polygonflächenlisten (Listen von Kontrollpunkt-Indizes) und Vertex-Elementschichten (Normalen, UVs, Vertex-Farben). |
Geometry | Abstrakte Basisklasse für netzähnliche Geometrietypen. Definiert das Kontrollpunkt-Array und die Sammlung von VertexElement Schichten. Mesh erbt von Geometry. |
VertexElement | Abstrakte Basisklasse für eine Datenschicht, die an Geometrie angehängt ist (Normalen, UVs, Farben usw.). Enthält MappingMode, ReferenceMode, und eine Datenliste. |
VertexElementNormal | Speichert einen Normalenvektor pro Vertex oder pro Polygon-Ecke, abhängig vom Mapping-Modus. |
VertexElementUV | Speichert Texturkoordinatenpaare (Vector2) pro Vertex oder pro Polygon-Ecke. |
VertexElementVertexColor | Speichert pro-Vertex- oder pro-Eckpunkt-RGBA-Farbdaten als Vector4. |
Eingebaute Primitive
| Methods | Methods |
|---|
Box | Parametrische achsenorientierte Box mit konfigurierbarer Breite, Höhe und Tiefe. Kann an ein(e) Node direkt oder konvertiert zu Mesh über ToMesh(). |
Sphere | Parametrische Kugel mit konfigurierbarem Radius. Unterstützt ToMesh() Konvertierung. |
Cylinder | Parametrischer Zylinder mit konfigurierbarem oberen Radius, unteren Radius und Höhe. Unterstützt ToMesh() Konvertierung. |
Transformation und Spatial
| Methods | Methods |
|---|
Transform | Lokale Transformation, die an ein(e) Node. Bietet Translation (FVector3), Rotation (Quaternion), Scale (FVector3), und Matrix (Matrix4) Eigenschaften. |
GlobalTransform | Nur-Lese-Ansicht der Welt-Raum-Transformationsmatrix eines Knotens nach Zusammensetzen aller Vorfahren-Transformationen. Zugriff über node.GlobalTransform. Stellt ein einzelnes Matrix Eigenschaft. |
AssetInfo | Metadatenblock, der an ein(e) Scene.Erbt von A3DObject bietet Name und Properties. Es sind keine zusätzlichen Eigenschaften in dieser Ausgabe definiert. |
Materialien und Schattierung
| Methods | Methods |
|---|
Material | Abstrakte Basisklasse für alle Materialtypen. Stellt einen Namen und eine Eigenschaftssammlung bereit. |
LambertMaterial | Klassisches reines Diffusmaterial mit Ambient, Diffuse, Emissive, Reflective, Transparency, und Texture Eigenschaften. Namensraum: Aspose.ThreeD.Shading. |
PhongMaterial | Erweitert Lambert mit Specular, Shininess, und SpecularPower Eigenschaften. Namensraum: Aspose.ThreeD.Shading. |
PbrMaterial | Physically Based Rendering-Material mit BaseColor, Metallic, Roughness, Occlusion, und Textur‑Slot‑Eigenschaften. Namensraum: Aspose.ThreeD.Shading. |
Methods
| Methods | Methods |
|---|
Camera | Kamera‑Entität. Erbt von Frustum. Angeheftet an ein Node um Sichtpunkt-Transformationen zu definieren. Keine format-spezifischen Eigenschaften werden in dieser Ausgabe offengelegt. |
Mathematische Hilfsfunktionen
| Methods | Methods |
|---|
Vector2 | Doppelpräzision 2-component vector (lowercase fields: x, y). Namensraum: Aspose.ThreeD.Utilities. Wird für UV-Texturkoordinaten verwendet. |
Vector3 | Doppelpräzision 3-component vector (lowercase fields: x, y, z). Namensraum: Aspose.ThreeD.Utilities. Allgemeiner räumlicher Vektor für Geometrie. |
Vector4 | Doppelpräzision 4-component vector (lowercase fields: x, y, z, w). Namensraum: Aspose.ThreeD.Utilities. Wird für Mesh.ControlPoints und Normaldaten. |
FVector3 | Einzelpräzisions-3-Komponenten-Float-Vektor (Großbuchstaben-Felder: X, Y, Z). Verwendet von Transform.Translation und Transform.Scale. |
FVector4 | Einzelpräzisions-4-Komponenten-Float-Vektor (Großbuchstaben-Felder: X, Y, Z, W). |
Quaternion | Einheitlicher Quaternion zur Darstellung von Rotationen (W, X, Y, Z). Verwendet von Transform.Rotation. |
Matrix4 | 4x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix. |
BoundingBox | Achsenparallel ausgerichtete Begrenzungsbox definiert durch Minimum und Maximum FVector3 Ecken. |
Methods
| Methods | Methods |
|---|
AnimationClip | Benannter Container für einen Animationsbereich. Ein Scene kann mehrere Clips enthalten. Deklarations-Stub — Keyframe-Daten und Wiedergabe sind noch nicht implementiert. |
Format-E/A
| Methods | Methods |
|---|
Scene.Open(path) | Öffnet eine Datei, erkennt das Format anhand der Erweiterung und füllt die Szene. |
Scene.Open(path, options) | Öffnet eine Datei mit formatabhängigem LoadOptions. |
Scene.Open(stream) | Öffnet aus einem Stream, erkennt das Format automatisch anhand des Inhalts. |
Scene.Open(stream, options) | Öffnet aus einem Stream mit formatabhängigem LoadOptions. |
Scene.Save(path) | Speichert die Szene in einer Datei; das Format wird aus der Erweiterung abgeleitet. |
Scene.Save(path, options) | Speichert mit formatabhängigem SaveOptions. |
Scene.Save(stream, options) | Speichert in einen Stream mit formatabhängigem SaveOptions. |
FileFormat | Register unterstützter Dateiformate. Verwenden FileFormat.Formats (ein IList<FileFormat>) um alle unterstützten Formate aufzulisten, oder FileFormat.Detect(fileName) um ein Format anhand des Dateinamens zu erkennen. Die benannten Konstanten (ObjFormat, GltfFormat, FbxFormat, usw.) sind internal und nicht aus Benutzercode zugänglich. |
IOService | Interne I/O-Abstraktion. Stellt DetectFormat() für die streambasierte Formaterkennung. |
LoadOptions | Basisklasse für formatbezogene Ladeoptionen. |
SaveOptions | Basisklasse für formatbezogene Speicheroptionen. |
OBJ-Format
STL-Format
glTF-Format
| Methods | Methods |
|---|
GltfLoadOptions | Ladeoptionen für glTF 2.0- und GLB-Dateien. |
GltfSaveOptions | Speicheroptionen für glTF 2.0- und GLB-Ausgabe. Keine format-spezifischen Eigenschaften werden in dieser Edition bereitgestellt; verwenden Sie .glb Erweiterung für binäre Ausgabe. |
FBX-Format
| Methods | Methods |
|---|
FbxLoadOptions | Ladeoptionen für FBX-Dateien. |
FbxSaveOptions | Speicheroptionen für FBX-Ausgabe. Der FBX-Export erzeugt immer binäre Ausgabe; ASCII-FBX-Export ist in dieser Version nicht aktiv. |
3MF Format
Methods
| Methods | Methods |
|---|
FileContentType | Inhaltstyp-Deskriptor: ASCII, Binary. Verfügbar als Eigenschaft von FileFormat. |
Axis | Identifiziert eine Koordinatenachse: XAxis, YAxis, ZAxis. |
CoordinateSystem | Gibt die Händigkeit‑Konvention an: RightHand oder LeftHand. |
Properties System
| Methods | Methods |
|---|
Property | Eine einzelne benannte typisierte Eigenschaft auf einem A3DObject. |
PropertyCollection | Iterierbare Sammlung von Property Objekte, die an einem A3DObject. |
Siehe auch
