Aspose.3D FOSS for Python
API-Referenz für: Aspose-3d-Foss 26.1.0 (Python 3.7 3.12, MIT-Lizenz).
Alle Klassen werden aus dem Vereinigten Königreich eingeführt. aspose.threed die Wurzelinport ist:
Kernszenegrafik
| Klasse | Beschreibung |
|---|
Scene | Top-Level Container für alle 3D-Szenendaten. enthält den Root Node, Asset Metadaten und Animationsclips. Exposes from_file(), open(),und . save() als primäre E/A-Eingangspunkte. |
Node | Ein benannter Knoten in der Szenenhierarchie. Besitzt eine Liste von Kinderknoten und einer Liste der angeschlossenen Entity Die Verarbeitung von Objekten wie Maschen, Kameras und Lichtern. 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 für benutzerdefinierte Metadaten. |
A3DObject | Root-Basisklasse für alle verwalteten Objekte von Aspose.3D. Erläutert die Eigenschaft Name und den Properties Sammlung. |
INamedObject | Schnittstelle, die eine name Immobilien. Durchführungsbericht: 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.). mapping_mode, reference_mode, und a data Liste. |
VertexElementNormal | Speichert einen normalen Vektor pro Punkt oder für jede Ecke des Polygons, je nach mapping_mode.Die Datenwerte sind: FVector4 Instanzen (einfachgenau) mit w nicht benutzt. |
VertexElementUV | Speichert Texturkoordinaten-Daten als FVector4 pro Punkt oder Ecke eines Polygons (nur x und . y Ein Netz kann mehrere UV-Schichten für verschiedene Texturkanäle tragen. |
VertexElementVertexColor | Speichert Farbdaten pro Spitze oder Ecke als FVector4 (r, g, b, a im Bereich 01). |
VertexElementSmoothingGroup | Speichert die Zahl-IDs der Glättungsgruppen pro Polygon, mit denen der OBJ-Importeur die ursprünglichen Glätungsgruppezuweisungen aus der Quelldatei reproduziert. |
VertexElementType | Aufzählung, die die semantische Rolle einer Vertex-Elementschicht identifiziert: NORMAL, UV, VERTEX_COLOR, SMOOTHING_GROUP, und andere. Mesh.get_element(). |
MappingMode | Aufzählung, die kontrolliert, welcher primitive Wert eines Wertelementes zu: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE,oder , ALL_SAME. |
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). |
PolygonModifier | Statische Nutzungsklasse mit Methoden zur Triangulation Mesh Gegenstände und ganze Scene Die Grafiken. |
Transform und Raumfahrt
| Klasse | Beschreibung |
|---|
Transform | Lokalverarbeitung mit einem Node.Die Übersetzung, die Rotation (wie in der Regel bei den Quaternion), und Skalenkomponenten sowie Komfort-Eigenschaften für Eulerwinkel. |
GlobalTransform | Leseberechtigte Ansicht der Weltraumtransformation eines Knoten nach dem Zusammenstellen aller Vorfahren-Transformationen. Zugriff über Node.global_transform. |
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. |
LambertMaterial | Modell für nur diffuse Materialien, speichert Umgebungsfarbe, diffus Farbe und Emissionsfarben sowie Transparenz. Ka/Kd/Ke Erklärungen. |
PhongMaterial | Ausdehnung LambertMaterial Die Daten werden von OBJ-Dateien geladen, die den Speicher mit einer Spiegelfarbe und einem Spiegelschein verwenden. Ks/Ns Erklärungen. |
PbrMaterial | Speichert Albedo, Metallfaktor, Rauheit Faktor und zugehörige Texturen. Verwendet von glTF 2.0 und anderen PBR-fähigen Formaten. |
Kamera und Beleuchtung
| Klasse | Beschreibung |
|---|
Camera | Nur die Kamera-Einheit. projection_type und . name sind in dieser Ausgabe funktional; alle anderen numerischen Eigenschaften (near_plane, far_plane, field_of_view, aspect_ratio) sind Stubs, die Standardwerte zurückgeben. Node Die Definition von Perspektiven verändert sich. |
Light | Lichtquelle-Einheit. Erbt von Camera als Stubklasse; die Light Die Klasse selbst zeigt in dieser Veröffentlichung keine zusätzlichen Eigenschaften auf. |
LightType | Aufzählung der unterstützten Lichtkategorien: POINT, DIRECTIONAL, SPOT, AREA, VOLUME. |
ProjectionType | Aufzählung der Projektionsmodi von Kameras: PERSPECTIVE und . ORTHOGRAPHIC. |
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. |
FVector2 | Einpräziser zweikomponenter Float-Vektor. Intern für kompakte Speicherung in Vertexelementdatenarchiven 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.data. |
Quaternion | Einheit für die Darstellung von Rotationen (w, x, y, z) Verwendet von: Transform.rotation. |
Matrix4 | 4×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions. |
BoundingBox | Achsgebundene Grenzfläche, definiert durch: minimum und . maximum DieVector3 Wir benutzen sie für räumliche Abfragen und Frust-Aufnahmehilfen. |
Animation und Film
| Klasse | Beschreibung |
|---|
AnimationClip | Benannte Container für eine Reihe von animierten Kanälen, die einen Wiedergabebereich abdecken. A Scene kann mehrere Klammern (z. B. “Walk”, “Run”) halten;. |
AnimationNode | Die Kommission hat die AnimationClip Als Brücke zwischen Clip-Daten und Szenengraphobjekten fungiert. |
AnimationChannel | Ein einzelner animierter Eigenschaftsstrom innerhalb eines Clips, der auf eine benannte Eigenschaft eines Objekts abzielt (z. B., Transform.translation.x). |
KeyFrame | Eine einzelne Zeit-Wertprobe innerhalb einer KeyframeSequence.Speichert die Zeit (in Sekunden) und den Wert zu diesem Zeitpunkt. |
KeyframeSequence | Eine geordnete Liste von KeyFrame Objekte für einen skalaren Kanal, zusammen mit Interpolation und Extrapolierungs-Einstellungen. |
Interpolation | Aufzählung der Interpolationsträger zwischen Schlüsselbildern: CONSTANT, LINEAR, BEZIER, B_SPLINE, CARDINAL_SPLINE, TCB_SPLINE. |
ExtrapolationType | Auflistung von Verhaltensweisen über den ersten und letzten Schlüsselrahmen hinaus: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATE. |
E/A-Format
| Symbol für die | Beschreibung |
|---|
Scene.from_file(path) | Statische Methode. Öffnet die Datei unter: path, erkennt das Format aus der Erweiterung und gibt ein ausgefülltes Scene.Aufsteigt auf Dateien, die nicht gefunden oder nicht unterstützt werden. |
Scene.open(path, options=None) | Instance-Methode. Öffnet eine Datei in einer vorhandenen Scene In diesem Fall ist die Verwendung eines Format-spezifischen LoadOptions Unterklasse. |
Scene.save(path, options=None) | 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.WAVEFRONT_OBJ, FileFormat.GLTF, FileFormat.FBX7400ASCII, FileFormat.MICROSOFT_3MF.Die Format-spezifischen Varianten werden über Optionsklassen (z. B., ColladaSaveOptions, GltfSaveOptions). |
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, ColladaLoadOptions, ThreeMfLoadOptions. |
SaveOptions | Basisklasse für alle formatspezifischen Speicheroptionsobjekte. Unterklassen durch ObjSaveOptions, StlSaveOptions, GltfSaveOptions, FbxSaveOptions, ColladaSaveOptions, ThreeMfSaveOptions. |
OBJ-Format
| Klasse | Beschreibung |
|---|
ObjImporter | Interne Importeurklasse, die Wavefront OBJ- und MTL-Dateien analysiert. automatisch von der Scene.from_file() für die .obj Erweiterungen. |
ObjLoadOptions | Ladeoptionen für Wavefront OBJ-Dateien. Schlüsselmerkmale: flip_coordinate_system, scale, enable_materials, normalize_normal. |
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.WAVEFRONT_OBJ(). |
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 flip_coordinate_system und . scale. |
StlSaveOptions | Speichern von Optionen für die STL-Ausgabe. binary_mode, scale,und . flip_coordinate_system. |
StlFormat | Formatdeskriptor für STL. |
glTF-Format
| Klasse | Beschreibung |
|---|
GltfLoadOptions | Ladeoptionen für glTF 2.0 und GLB-Dateien. Schlüssel Eigenschaft: flip_tex_coord_v. |
GltfSaveOptions | Speichern Sie Optionen für glTF 2.0 Ausgabe. Verwenden binary_mode=True für ein eigenständiges GLB-Paket. |
GltfFormat | Formatdeskriptor für glTF 2.0 / GLB. Zugänglich als FileFormat.GLTF2(). |
FBX-Format
| Klasse | Beschreibung |
|---|
FbxLoadOptions | - Schlüssel-Eigenschaften: keep_builtin_global_settings, compatible_mode. |
FbxSaveOptions | Speichern Sie Optionen für FBX-Ausgabe. FBx Export erhöht sich NotImplementedError bedingungslos; FbxSaveOptions Die Kommission hat die Möglichkeit, den Handel mit anderen Ländern zu verhindern. |
FbxFormat | Formatdeskriptor für FBX. Zugänglich als FileFormat.FBX7400ASCII(). |
COLLADA Format (auf Englisch)
| Klasse | Beschreibung |
|---|
ColladaLoadOptions | Die Lastoptionen für COLLADA (.daeDie Elemente, die für den Import von Waren erforderlich sind, werden in der Tabelle 1 aufgeführt. |
ColladaSaveOptions | Speichern Sie Optionen für COLLADA-Ausgabe. indented, flip_coordinate_system, und Material-Export. |
ColladaFormat | Formatdeskriptor für COLLADA. automatisch von der .dae Dateierweiterung. |
3MF Format
| Klasse | Beschreibung |
|---|
ThreeMfLoadOptions | Lastoptionen für 3MF (.3mf) Dateien. |
ThreeMfSaveOptions | Speicheroptionen für 3MF-Ausgabe. 3 MF ist das bevorzugte Format für 3-D-Druckworkflows. |
ThreeMfFormat | Formatdeskriptor für 3MF. Zugänglich als FileFormat.MICROSOFT_3MF_FORMAT(). |
Aufzählungen
| Aufzählung | Beschreibung |
|---|
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. Scene.render() Erhöhung NotImplementedError; Rendering ist in dieser Version nicht implementiert. |
Siehe auch: