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:

import com.aspose.threed.*;

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

KlasseBeschreibung
SceneTop-Level-Container für alle 3D-Szenendaten. fromFile(), open(), und save() als primäre E/A-Eingangspunkte.
NodeEin 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.
EntityAbstrakte Basisklasse für alle Objekte, die an eine Node.Der Name und die Identität, aber keine eigene Geometrie.
SceneObjectBasisklasse geteilt von Node und Entity.Bietet die Eigenschaftssammlungsschnittstelle, die für benutzerdefinierte Metadaten verwendet wird.
A3DObjectRoot-Basisklasse für alle verwalteten Objekte von Aspose.3D. Erläutert die Eigenschaft Name und den Properties Sammlung.
INamedObjectSchnittstelle, die eine getName() Methode. Durchführte durch: Node, Entity, und mehrere formatspezifische Deskriptortypen.

Geometrie und Netzwerk

KlasseBeschreibung
MeshPolygonmascheneinheit. Speichert Kontrollpunkte (Spitzenpositionen als Vector4), Polygon-Gesichtslisten (Listen von Kontrollpunktindizes) und Oberflächenelementenlagen (Normale, UVs, Oberflachenfarben).
GeometryAbstrakte Basis für maschenartige Geometrie-Typen. Definition des Kontrollpunktarrays und der Sammlung von VertexElement Schichten. Mesh Erbt von Geometry.
VertexElementAbstrakte Basis für eine Datenlage, die an Geometrie angehängt ist (Normale, UV-Strahlen, Farben usw.). getMappingMode(), getReferenceMode(), und eine Datenliste.
VertexElementNormalSpeichert je nach Kartierungsmodus einen normalen Vektor pro Punkt oder Polygon-Ecke. Die Datenwerte sind: Vector4 Instanzen mit w nicht benutzt.
VertexElementUVSpeichert Strukturkoordinatenpaare (Vector2Ein Netz kann mehrere UV-Schichten für verschiedene Texturkanäle tragen.
VertexElementVertexColorSpeichert Farbdaten pro Spitze oder Ecke als Vector4 (r, g, b, a im Bereich 0-1).
VertexElementTypeAufzählung, die die semantische Rolle einer Vertex-Elementschicht identifiziert: NORMAL, UV, VERTEX_COLOR, und andere. Mesh.getElement().
MappingModeAufzählung, die kontrolliert, welcher primitive Wert eines Wertelementes zu: CONTROL_POINT, POLYGON_VERTEX,oder , POLYGON.
ReferenceModeAufzä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

KlasseBeschreibung
TransformLokalverarbeitung mit einem Node.Die Übersetzung, die Rotation (wie in der Regel bei den Quaternion), und Skalenkomponenten sowie Bequemlichkeitsmethoden für Euler-Winkel.
GlobalTransformLeseberechtigte Ansicht der Weltraumtransformation eines Knoten nach dem Zusammenstellen aller Vorfahren-Transformationen. Zugriff über node.getGlobalTransform().
AssetInfoMetadatenblock, 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

KlasseBeschreibung
MaterialAbstrakte Basisklasse für alle Materialtypen. Gibt einen Namen und eine Eigenschaftssammlung für numerische und farbige Parameter.
PbrMaterialSpeichert 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

KlasseBeschreibung
CameraKamera-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

KlasseBeschreibung
Vector2Doppelpräzise zweikomponente Vektor (x, y) Für UV-Texturkoordinaten verwendet.
Vector3Doppelpräzise 3-Komponenten-Vektor (x, y, z) für Positionen, Richtungen und Maßstab verwendet.
Vector4Doppelpräzise 4-Komponenten-Vektor (x, y, z, w) Für Kontrollpunkte (homogene Positionen) und normale Daten verwendet.
FVector3Einpräziser 3-Komponenten-Floatvektor. Er erscheint in Vertexelementdatenarchiven für Normalwerte und Tangente.
FVector4Einzigpräzise 4-Komponenten-Floatvektor. Der Speichertyp von VertexElementFVector Daten.
QuaternionEinheit für die Darstellung von Rotationen (w, x, y, z) Verwendet von: Transform.getRotation().
Matrix44x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxAchsgebundene Grenzfläche, definiert durch: getMinimum() und . getMaximum() DieVector3 Wir benutzen sie für räumliche Abfragen und Frust-Aufnahmehilfen.

Animation und Film

KlasseBeschreibung
AnimationClipBenannte 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 dieBeschreibung
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.
FileFormatRegistrierung der unterstützten Dateiformate. Enthält Eingaben wie: FileFormat.WAVEFRONTOBJ, FileFormat.GLTF2, FileFormat.FBX7400ASCII.
IOServiceInterne E/A-Abstraktion, die von den Import- und Exportunternehmen verwendet wird. Nicht in der Regel direkt durch Anwendungscode verwendet.
LoadOptionsBasisklasse für alle formatspezifischen Ladeoptionsobjekte. Unterklassifiziert durch: ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions.
SaveOptionsBasisklasse für alle formatspezifischen Speicheroptionsobjekte. Unterklassen durch ObjSaveOptions, StlSaveOptions, GltfSaveOptions.

OBJ-Format

KlasseBeschreibung
ObjImporterInterne Importeurklasse, die Wavefront OBJ- und MTL-Dateien analysiert. automatisch von der Scene.fromFile() für die .obj Erweiterungen.
ObjLoadOptionsLadeoptionen für Wavefront OBJ-Dateien. Schlüsselmerkmale: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal().
ObjSaveOptionsSpeichern Sie Optionen für Wavefront OBJ-Ausgabe. Steuert Normale, UVs, Materialreferenzen und Punktwolkmodus.
ObjFormatFormatdeskriptor für Wavefront OBJ. Zugänglich als FileFormat.WAVEFRONTOBJ.

STL-Format

KlasseBeschreibung
StlImporterInterner Importeur, der sowohl binäre als auch ASCII-STL-Dateien liest.
StlExporterInnerer Exporteur, der STL schreibt.
StlLoadOptionsLadeoptionen für STL-Dateien. Unterstützt setFlipCoordinateSystem(), setRecalculateNormal(),und . setContentType().
StlSaveOptionsSpeichern von Optionen für die STL-Ausgabe. setFlipCoordinateSystem(), setAxisSystem(),und . setContentType().
StlFormatFormatdeskriptor für STL.

glTF-Format

KlasseBeschreibung
GltfLoadOptionsLadeoptionen für glTF 2.0 und GLB-Dateien. Schlüsselmerkmale: setFlipCoordinateSystem(), setPrettyPrint().
GltfSaveOptionsSpeichern Sie Optionen für glTF 2.0 und GLB-Ausgabe. Verwenden setContentType(FileContentType.BINARY) Die Kommission hat die .glb - Das Paket.
GltfFormatFormatdeskriptor 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.

KlasseBeschreibung
FbxLoadOptionsLadeoptionen für FBX-Dateien. Schlüssel Eigenschaft: setFlipCoordinateSystem().
FbxFormatFormatdeskriptor für FBX. Zugänglich als FileFormat.FBX7400ASCII.

Aufzählungen

AufzählungBeschreibung
AxisIdentifiziert eine Koordinaten-Achse: X_AXIS, Y_AXIS, Z_AXIS. Verwendet bei Neumappen von Koordinatensystemen.
CoordinateSystemFestlegung der Handhaftigkeitskonvention: RIGHT_HANDED oder LEFT_HANDED.
TextureMappingIdentifiziert, wie eine Textur in die Geometrie eingebunden wird: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, usw.
BooleanOperationCSG Boolean-Betriebstypen: UNION, DIFFERENCE, INTERSECTION.

Eigenschaftssystem

KlasseBeschreibung
PropertyEine einzelne benannte eingetippte Eigenschaft auf einem A3DObject.Speichert den Eigentumsnamen, Typdeskriptor und aktuellen Wert.
PropertyCollectionDie unablässige Sammlung von Property Gegenstände, die an eine A3DObject. Unterstützt die Suche nach Namen und Iterationen über alle definierten Eigenschaften.
CustomObjectEin 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

KlasseBeschreibung
ImageRenderOptionsOptionen 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:

 Deutsch