Aspose.3D FOSS for Java
API-Referenz für: Aspose-3d-Foss 26.1.0 (Java 21+, MIT-Lizenz).
Alle Klassen befinden sich in der com.aspose.threed Das Root-Import ist:
Verpackungsformat: Die meisten öffentlichen Klassen sind in der Schule. com.aspose.threed.Die einzige typisch verwendete Unterverpackung ist die com.aspose.threed.shading (für die PbrMaterial) Die com.aspose.threed.formats Die Unterpackung enthält interne Einführer/Ausfuhrer und wird in der Regel nicht direkt eingeführt.
Java-Namenkonvention: Alle Eigenschaften verwenden Getter-/Settermethoden. node.getTransform() statt der node.transform,und . transform.setTranslation(...) statt der transform.translation = ....Beachten Sie , dass: Vector3, Vector4, Quaternion, Matrix4,und . FVector Verwendungstypen öffentliche Felder (v.x, v.y, v.z) als Getter für den Zugang zu Komponenten.
Kernszenegrafik
| Klasse | Beschreibung |
|---|
Scene | Top-Level-Container für alle 3D-Szenendaten. fromFile(), open(), und save() als primäre E/A-Eingangspunkte. |
Node | Ein benannter Knoten in der Szenenhierarchie. Besitzt eine Liste der Kinderknoten und eine Liste der angeschlossenen Entity Einige von ihnen sind in der Lage, die Daten zu übertragen, die sie benötigen. Transform. |
Entity | Abstrakte Basisklasse für alle Objekte, die an eine Node.Der Name und die Identität, aber keine eigene Geometrie. |
SceneObject | Basisklasse geteilt von Node und Entity.Bietet die Eigenschaftssammlungsschnittstelle, die für benutzerdefinierte Metadaten verwendet wird. |
A3DObject | Root-Basisklasse für alle verwalteten Objekte von Aspose.3D. Erläutert die Eigenschaft Name und den Properties Sammlung. |
INamedObject | Schnittstelle, die eine getName() Methode. Durchführte durch: Node, Entity, und mehrere formatspezifische Deskriptortypen. |
Geometrie und Netzwerk
| Klasse | Beschreibung |
|---|
Mesh | Polygonmascheneinheit. Speichert Kontrollpunkte (Spitzenpositionen als Vector4), Polygon-Gesichtslisten (Listen von Kontrollpunktindizes) und Oberflächenelementenlagen (Normale, UVs, Oberflachenfarben). |
Geometry | Abstrakte Basis für maschenartige Geometrie-Typen. Definition des Kontrollpunktarrays und der Sammlung von VertexElement Schichten. Mesh Erbt von Geometry. |
VertexElement | Abstrakte Basis für eine Datenlage, die an Geometrie angehängt ist (Normale, UV-Strahlen, Farben usw.). getMappingMode(), getReferenceMode(), und eine Datenliste. |
VertexElementNormal | Speichert je nach Kartierungsmodus einen normalen Vektor pro Punkt oder Polygon-Ecke. Die Datenwerte sind: Vector4 Instanzen mit w nicht benutzt. |
VertexElementUV | Speichert Strukturkoordinatenpaare (Vector2Ein Netz kann mehrere UV-Schichten für verschiedene Texturkanäle tragen. |
VertexElementVertexColor | Speichert Farbdaten pro Spitze oder Ecke als Vector4 (r, g, b, a im Bereich 0-1). |
VertexElementType | Aufzählung, die die semantische Rolle einer Vertex-Elementschicht identifiziert: NORMAL, UV, VERTEX_COLOR, und andere. Mesh.getElement(). |
MappingMode | Aufzählung, die kontrolliert, welcher primitive Wert eines Wertelementes zu: CONTROL_POINT, POLYGON_VERTEX,oder , POLYGON. |
ReferenceMode | Aufzählung, die den Index der Werte kontrolliert: DIRECT (ein Wert pro Mapping-Primitiv) oder INDEX_TO_DIRECT (Werte-Array plus ein separates Index-Arsch). |
Transform und Raumfahrt
| Klasse | Beschreibung |
|---|
Transform | Lokalverarbeitung mit einem Node.Die Übersetzung, die Rotation (wie in der Regel bei den Quaternion), und Skalenkomponenten sowie Bequemlichkeitsmethoden für Euler-Winkel. |
GlobalTransform | Leseberechtigte Ansicht der Weltraumtransformation eines Knoten nach dem Zusammenstellen aller Vorfahren-Transformationen. Zugriff über node.getGlobalTransform(). |
AssetInfo | Metadatenblock, der an eine Scene.Speichert den Namen der Anwendungsbearbeitungen, den Einheitennamen, die Größenordnung des Einheitsfaktors, Definitionen von Koordinatensystemachsen und Zeitstempel für Erstellung/Änderung. |
Materialien und Schattierungen
| Klasse | Beschreibung |
|---|
Material | Abstrakte Basisklasse für alle Materialtypen. Gibt einen Namen und eine Eigenschaftssammlung für numerische und farbige Parameter. |
PbrMaterial | Speichert Albedo, Metallfaktor, Rauheit Faktor, Emissionsfarbe, Transparenz und verwandte Texturen. Verwendet von glTF 2.0 und anderen PBR-fähigen Formaten. Import: com.aspose.threed.shading.PbrMaterial. |
Kamera und Bildschirm
| Klasse | Beschreibung |
|---|
Camera | Kamera-Einheit. Erbt von Entity.In der Java FOSS-Edition werden keine formatspezifischen Eigenschaften über die vererbte Name und Property Collection hinaus freigegeben. An einem Node Die Definition von Perspektiven verändert sich. |
Anmerkung: Die Light Die Klasse ist in der Java-Edition von Aspose.3D FOSS nicht verfügbar. Scene Lighting Daten aus importierten Dateien werden als generische gespeichert Entity Objekte.
Mathematik-Dienste
| Klasse | Beschreibung |
|---|
Vector2 | Doppelpräzise zweikomponente Vektor (x, y) Für UV-Texturkoordinaten verwendet. |
Vector3 | Doppelpräzise 3-Komponenten-Vektor (x, y, z) für Positionen, Richtungen und Maßstab verwendet. |
Vector4 | Doppelpräzise 4-Komponenten-Vektor (x, y, z, w) Für Kontrollpunkte (homogene Positionen) und normale Daten verwendet. |
FVector3 | Einpräziser 3-Komponenten-Floatvektor. Er erscheint in Vertexelementdatenarchiven für Normalwerte und Tangente. |
FVector4 | Einzigpräzise 4-Komponenten-Floatvektor. Der Speichertyp von VertexElementFVector Daten. |
Quaternion | Einheit für die 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 | Achsgebundene Grenzfläche, definiert durch: getMinimum() und . getMaximum() DieVector3 Wir benutzen sie für räumliche Abfragen und Frust-Aufnahmehilfen. |
Animation und Film
| Klasse | Beschreibung |
|---|
AnimationClip | Benannte Container für einen Animationsbereich. A Scene kann mehrere Klammern (z. B. “Walk”, “Run”) halten;. Erklärungsstück Keyframe-Daten und Wiedergabe sind noch nicht implementiert. |
E/A-Format
| Symbol für die | Beschreibung |
|---|
Scene.fromFile(path) | Statische Methode. Öffnet die Datei unter: path, erkennt das Format aus der Erweiterung und gibt ein ausgefülltes Scene. Gießt auf Datei nicht gefunden oder ununterstützt Format. |
Scene.open(path, options) | Instance-Methode. Öffnet eine Datei in einer vorhandenen Scene In diesem Fall ist die Verwendung eines Format-spezifischen LoadOptions Unterklasse. |
Scene.save(path, options) | Die Instanz-Methode serialisiert die Szene auf: path Die Veröffentlichung der Daten wird unter Verwendung des aus dem Erweiterungsvorgang abgeleiteten Formats, optional aber mit einem für das Format bestimmten SaveOptions Unterklasse. |
FileFormat | Registrierung der unterstützten Dateiformate. Enthält Eingaben wie: FileFormat.WAVEFRONTOBJ, FileFormat.GLTF2, FileFormat.FBX7400ASCII. |
IOService | Interne E/A-Abstraktion, die von den Import- und Exportunternehmen verwendet wird. Nicht in der Regel direkt durch Anwendungscode verwendet. |
LoadOptions | Basisklasse für alle formatspezifischen Ladeoptionsobjekte. Unterklassifiziert durch: ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions. |
SaveOptions | Basisklasse für alle formatspezifischen Speicheroptionsobjekte. Unterklassen durch ObjSaveOptions, StlSaveOptions, GltfSaveOptions. |
OBJ-Format
| Klasse | Beschreibung |
|---|
ObjImporter | Interne Importeurklasse, die Wavefront OBJ- und MTL-Dateien analysiert. automatisch von der Scene.fromFile() für die .obj Erweiterungen. |
ObjLoadOptions | Ladeoptionen für Wavefront OBJ-Dateien. Schlüsselmerkmale: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal(). |
ObjSaveOptions | Speichern Sie Optionen für Wavefront OBJ-Ausgabe. Steuert Normale, UVs, Materialreferenzen und Punktwolkmodus. |
ObjFormat | Formatdeskriptor für Wavefront OBJ. Zugänglich als FileFormat.WAVEFRONTOBJ. |
STL-Format
| Klasse | Beschreibung |
|---|
StlImporter | Interner Importeur, der sowohl binäre als auch ASCII-STL-Dateien liest. |
StlExporter | Innerer Exporteur, der STL schreibt. |
StlLoadOptions | Ladeoptionen für STL-Dateien. Unterstützt setFlipCoordinateSystem(), setRecalculateNormal(),und . setContentType(). |
StlSaveOptions | Speichern von Optionen für die STL-Ausgabe. setFlipCoordinateSystem(), setAxisSystem(),und . setContentType(). |
StlFormat | Formatdeskriptor für STL. |
glTF-Format
| Klasse | Beschreibung |
|---|
GltfLoadOptions | Ladeoptionen für glTF 2.0 und GLB-Dateien. Schlüsselmerkmale: setFlipCoordinateSystem(), setPrettyPrint(). |
GltfSaveOptions | Speichern Sie Optionen für glTF 2.0 und GLB-Ausgabe. Verwenden setContentType(FileContentType.BINARY) Die Kommission hat die .glb - Das Paket. |
GltfFormat | Formatdeskriptor für glTF 2.0 / GLB. Zugänglich als FileFormat.GLTF2. |
FBX-Format
FBX wird für: nur für den Import.Export auf FBX ist in der Java FOSS-Edition nicht verfügbar.
| Klasse | Beschreibung |
|---|
FbxLoadOptions | Ladeoptionen für FBX-Dateien. Schlüssel Eigenschaft: setFlipCoordinateSystem(). |
FbxFormat | Formatdeskriptor für FBX. Zugänglich als FileFormat.FBX7400ASCII. |
Aufzählungen
| Aufzählung | Beschreibung |
|---|
Axis | Identifiziert eine Koordinaten-Achse: X_AXIS, Y_AXIS, Z_AXIS. Verwendet bei Neumappen von Koordinatensystemen. |
CoordinateSystem | Festlegung der Handhaftigkeitskonvention: RIGHT_HANDED oder LEFT_HANDED. |
TextureMapping | Identifiziert, wie eine Textur in die Geometrie eingebunden wird: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, usw. |
BooleanOperation | CSG Boolean-Betriebstypen: UNION, DIFFERENCE, INTERSECTION. |
Eigenschaftssystem
| Klasse | Beschreibung |
|---|
Property | Eine einzelne benannte eingetippte Eigenschaft auf einem A3DObject.Speichert den Eigentumsnamen, Typdeskriptor und aktuellen Wert. |
PropertyCollection | Die unablässige Sammlung von Property Gegenstände, die an eine A3DObject. Unterstützt die Suche nach Namen und Iterationen über alle definierten Eigenschaften. |
CustomObject | Ein leichtes Gewicht. A3DObject Unterklasse, die nur einen Namen und eine beliebige PropertyCollection. Verwendet für die Speicherung von benutzerdefinierten Metadaten über Szenenobjekte. |
Bild und Darstellung
| Klasse | Beschreibung |
|---|
ImageRenderOptions | Optionen für die Software-Rasterisierung beim Rendern einer Szene in einem Bildpuffer. Speichert Hintergrundfarbe, Bildmaße und Kamerareferenz. Anmerkung: Alle Render-Methoden werfen UnsupportedOperationException in der FOSS-Ausgabe; keine Darstellung verfügbar. |
Siehe auch: