API-Referenz für aspose-3d-foss 26.1.0 (Java 21+, MIT-Lizenz).
Alle Klassen befinden sich im com.aspose.threed Root-Paket. Der Root-Import ist:
Paketstruktur: Fast alle öffentlichen Klassen befinden sich in com.aspose.threed. Das einzige Unterpaket, das typischerweise verwendet wird, ist com.aspose.threed.shading (für PbrMaterial). Das com.aspose.threed.formats Unterpaket enthält interne Importer/Exporter und wird normalerweise nicht direkt importiert.
Java Benennungskonvention: Alle Eigenschaften verwenden Getter/Setter-Methoden. Zum Beispiel verwenden Sie node.getTransform() statt node.transform, und transform.setTranslation(...) statt transform.translation = .... Beachten Sie, dass Vector3, Vector4, Quaternion, Matrix4, und FVector Typen verwenden öffentliche Felder (v.x, v.y, v.z) anstelle von Gettern für den Komponenten‑Zugriff.
Kern‑Szenengraph
| Enumerations | Enumerations |
|---|
Scene | Oberster Container für alle 3D‑Szenendaten. Enthält den Wurzelknoten, Asset‑Metadaten und Animationsclips. Stellt bereit fromFile(), 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. Stellt Namen und Identität bereit, enthält jedoch keine eigene Geometrie. |
SceneObject | Basisklasse, die gemeinsam genutzt wird von Node und Entity. Stellt die Schnittstelle für die Eigenschaftssammlung bereit, die für benutzerdefinierte Metadaten verwendet wird. |
A3DObject | Wurzelbasisklasse für alle Aspose.3D verwalteten Objekte. Gibt die Namenseigenschaft und die Properties Sammlung. |
INamedObject | Schnittstelle, die ein getName() Methode. Implementiert von Node, Entity, und mehrere format-spezifische Deskriptortypen. |
Geometrie und Mesh
| Enumerations | Enumerations |
|---|
Mesh | Polygonnetz-Entität. Speichert Kontrollpunkte (Scheitelpunktpositionen als Vector4), Polygonflächenlisten (Listen von Kontrollpunktindizes) und Scheitel-Elementebenen (Normalen, UVs, Scheitelpunktfarben). |
Geometry | Abstrakte Basisklasse für netzähnliche Geometrietypen. Definiert das Kontrollpunkt-Array und die Sammlung von VertexElement Ebenen. Mesh erbt von Geometry. |
VertexElement | Abstrakte Basisklasse für eine an Geometrie angehängte Datenschicht (Normalen, UVs, Farben usw.). Enthält getMappingMode(), getReferenceMode(), und eine Datenliste. |
VertexElementNormal | Speichert einen Normalenvektor pro Scheitelpunkt oder pro Polygon-Ecke, abhängig vom Abbildungsmodus. Datenwerte sind Vector4 Instanzen mit w ungenutzt. |
VertexElementUV | Speichert Texturkoordinatenpaare (Vector2) pro Scheitelpunkt oder pro Polygon‑Ecke. Ein Mesh kann mehrere UV‑Layer für verschiedene Texturkanäle enthalten. |
VertexElementVertexColor | Speichert pro Scheitelpunkt oder pro Ecke RGBA‑Farbdaten als Vector4 (r, g, b, a im Bereich 0–1). |
VertexElementType | Aufzählung, die die semantische Rolle einer Vertex‑Element‑Schicht identifiziert: NORMAL, UV, VERTEX_COLOR, und andere. Werte übergeben an Mesh.getElement(). |
MappingMode | Aufzählung, die steuert, zu welchem Primitive ein Vertex‑Element‑Wert zugeordnet wird: CONTROL_POINT, POLYGON_VERTEX, oder POLYGON. |
ReferenceMode | Aufzählung, die steuert, wie Werte indiziert werden: DIRECT (ein Wert pro Mapping-Primitive) oder INDEX_TO_DIRECT (Werte-Array plus ein separates Index-Array). |
Transformation und Spatial
| Enumerations | Enumerations |
|---|
Transform | Lokale Transformation, die an ein(e) Node. Liefert Translation, Rotation (als Quaternion), und Skalierungs‑Komponenten, plus Komfortmethoden für Euler‑Winkel. |
GlobalTransform | Schreibgeschützte Ansicht der Welt‑Raum-Transformation eines Knotens nach Zusammensetzen aller übergeordneten Transformationen. Zugriff über node.getGlobalTransform(). |
AssetInfo | Metadatenblock, der an ein(e) Scene.Speichert den Namen der Erstellungsanwendung, den Einheitennamen, den Einheitenskalierungsfaktor, die Achsen‑Definitionen des Koordinatensystems sowie Erstellungs‑/Änderungszeitstempel. |
Materialien und Shading
| Enumerations | Enumerations |
|---|
Material | Abstrakte Basisklasse für alle Materialtypen. Stellt einen Namen und eine Eigenschaftssammlung für numerische und Farbparameter bereit. |
PbrMaterial | Physically Based Rendering‑Material. Speichert Albedo, Metallfaktor, Rauheitsfaktor, Emissionsfarbe, Transparenz und zugehörige Texturen. Wird von glTF 2.0 und anderen PBR‑fähigen Formaten verwendet. Import: com.aspose.threed.shading.PbrMaterial. |
Enumerations
| Enumerations | Enumerations |
|---|
Camera | Kamera‑Entität. Erbt von Entity. Keine formatbezogenen Eigenschaften werden in der Java FOSS-Edition über den geerbten Namen und die Eigenschaftssammlung hinaus bereitgestellt. Angeheftet an ein Node zur Definition von Sichtpunkt-Transformationen. |
Hinweis: Enumerations Light Klasse ist in der Java-Edition von Aspose.3D FOSS nicht verfügbar. Szenenbeleuchtungsdaten aus importierten Dateien werden als generische Entity Objekte.
Mathematik‑Hilfsprogramme
| Enumerations | Enumerations |
|---|
Vector2 | Doppeltpräsiziser 2-Komponenten-Vektor (x, y). Verwendet für UV-Texturkoordinaten. |
Vector3 | Doppeltpräsiziser 3-Komponenten-Vektor (x, y, z). Verwendet für Positionen, Richtungen und Skalierung. |
Vector4 | Doppeltpräsiziser 4-Komponenten-Vektor (x, y, z, w). Verwendet für Kontrollpunkte (homogene Positionen) und Normaldaten. |
FVector3 | Einzelpräzisions‑3‑Komponenten‑Float‑Vektor. Er erscheint in Vertex‑Element‑Datenarrays für Normalen und Tangenten. |
FVector4 | Einzelpräzisions‑4‑Komponenten‑Float‑Vektor. Der Speichertyp von VertexElementFVector Daten. |
Quaternion | Einheitsquaternion zur Darstellung von Rotationen (w, x, y, z). Verwendet von Transform.getRotation(). |
Matrix4 | 4x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions. |
BoundingBox | Achsen‑ausgerichtete Begrenzungsbox definiert durch getMinimum() und getMaximum() Vector3 Ecken. Wird für räumliche Abfragen und Frustum‑Culling‑Hilfen verwendet. |
Enumerations
| Enumerations | Enumerations |
|---|
AnimationClip | Benannter Container für einen Animationsbereich. Ein Scene kann mehrere Clips enthalten (z. B. “Walk”, “Run”). Deklarations-Stub — Keyframe-Daten und Wiedergabe sind noch nicht implementiert. |
Format‑E/A
| Enumerations | Enumerations |
|---|
Scene.fromFile(path) | Statische Methode. Öffnet die Datei unter path, erkennt das Format anhand der Erweiterung und gibt ein gefülltes Scene. Wirft bei Datei‑nicht‑gefunden oder nicht unterstütztem Format. |
Scene.open(path, options) | Instanzmethode. Öffnet eine Datei in ein bestehendes Scene Instanz, optional unter Verwendung einer format-spezifischen LoadOptions Unterklasse. |
Scene.save(path, options) | Instanzmethode. Serialisiert die Szene nach path unter Verwendung des aus der Erweiterung abgeleiteten Formats, optional unter Nutzung einer format-spezifischen SaveOptions Unterklasse. |
FileFormat | Register der unterstützten Dateiformate. Enthält Einträge wie FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII(). |
IOService | Interne I/O-Abstraktion, die von Format-Importeuren und -Exporteuren verwendet wird. Wird normalerweise nicht direkt vom Anwendungscode genutzt. |
LoadOptions | Basisklasse für alle format-spezifischen Ladeoption-Objekte. Subklassiert von ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions. |
SaveOptions | Basisklasse für alle format-spezifischen Speicheroption-Objekte. Subklassiert von ObjSaveOptions, StlSaveOptions, GltfSaveOptions. |
OBJ-Format
| Enumerations | Enumerations |
|---|
ObjImporter | Interne Importer-Klasse, die Wavefront OBJ- und MTL-Dateien analysiert. Wird automatisch aufgerufen von Scene.fromFile() für .obj Erweiterungen. |
ObjLoadOptions | Ladeoptionen für Wavefront OBJ-Dateien. Wichtige Eigenschaften: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal(). |
ObjSaveOptions | Speicheroptionen für Wavefront OBJ-Ausgabe. Steuert Normalen, UVs, Materialreferenzen und den Punktwolkenmodus. |
ObjFormat | Formatbeschreiber für Wavefront OBJ. Zugänglich als FileFormat.WAVEFRONT_OBJ(). |
STL-Format
| Enumerations | Enumerations |
|---|
StlImporter | Interner Importer, der sowohl binäre als auch ASCII STL-Dateien liest. Wird automatisch anhand der Erweiterung ausgewählt. |
StlExporter | Interner Exporter, der STL schreibt. |
StlLoadOptions | Ladeoptionen für STL-Dateien. Unterstützt setFlipCoordinateSystem(), setRecalculateNormal(), und setContentType(). |
StlSaveOptions | Speicheroptionen für STL-Ausgabe. Steuert setFlipCoordinateSystem(), setAxisSystem(), und setContentType(). |
StlFormat | Formatbeschreibung für STL. |
glTF-Format
| Enumerations | Enumerations |
|---|
GltfLoadOptions | Ladeoptionen für glTF 2.0- und GLB-Dateien. Wichtige Eigenschaften: setFlipCoordinateSystem(), setPrettyPrint(). |
GltfSaveOptions | Speicheroptionen für glTF 2.0- und GLB-Ausgabe. Verwenden Sie setContentType(FileContentType.BINARY) um ein eigenständiges .glb Paket zu erzeugen. |
GltfFormat | Formatbeschreibung für glTF 2.0 / GLB. Zugänglich als FileFormat.GLTF2(). |
FBX-Format
FBX wird unterstützt für nur Import. Export nach FBX ist nicht verfügbar in der Java FOSS-Edition.
| Enumerations | Enumerations |
|---|
FbxLoadOptions | Ladeoptionen für FBX-Dateien. Schlüsseleigenschaft: setFlipCoordinateSystem(). |
FbxFormat | Formatbeschreiber für FBX. Zugänglich als FileFormat.FBX7400ASCII(). |
Enumerations
| Enumerations | Enumerations |
|---|
Axis | Identifiziert eine Koordinatenachse: X_AXIS, Y_AXIS, Z_AXIS. Verwendet in Optionen zur Neuzuordnung des Koordinatensystems. |
CoordinateSystem | Gibt die Händeregelung an: RIGHT_HANDED oder LEFT_HANDED. |
TextureMapping | Identifiziert, wie eine Textur auf Geometrie abgebildet wird: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, usw. |
BooleanOperation | CSG-Boolean-Operationstyp: UNION, DIFFERENCE, INTERSECTION. |
Eigenschaften-System
| Enumerations | Enumerations |
|---|
Property | Eine einzelne benannte, typisierte Eigenschaft an einem A3DObject. Speichert den Eigenschaftsnamen, den Typbeschreiber und den aktuellen Wert. |
PropertyCollection | Iterierbare Sammlung von Property Objekten, die an einem A3DObject. Unterstützt das Nachschlagen nach Namen und die Iteration über alle definierten Eigenschaften. |
CustomObject | Ein leichtgewichtiges A3DObject Unterklasse, die nur einen Namen und ein beliebiges PropertyCollection. Wird verwendet, um benutzerdefinierte Metadaten auf Szenenobjekten zu speichern. |
Bild und Rendering
| Enumerations | Enumerations |
|---|
ImageRenderOptions | Optionen für die Software-Rasterisierung beim Rendern einer Szene in einen Bildpuffer. Speichert Hintergrundfarbe, Bildabmessungen und Kamerareferenz. Diese Funktion ist in unterstützten Konfigurationen verfügbar. |
Siehe auch
