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:

import aspose.threed
##or selectively:
from aspose.threed import Scene, Node
from aspose.threed.entities import Mesh, Camera, Light
from aspose.threed.formats import ObjLoadOptions, StlSaveOptions, GltfSaveOptions
from aspose.threed.utilities import Vector3, Matrix4, BoundingBox
from aspose.threed.animation import AnimationClip, KeyFrame

Kernszenegrafik

KlasseBeschreibung
SceneTop-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.
NodeEin 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.
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 für benutzerdefinierte Metadaten.
A3DObjectRoot-Basisklasse für alle verwalteten Objekte von Aspose.3D. Erläutert die Eigenschaft Name und den Properties Sammlung.
INamedObjectSchnittstelle, die eine name Immobilien. Durchführungsbericht: 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.). mapping_mode, reference_mode, und a data Liste.
VertexElementNormalSpeichert 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.
VertexElementUVSpeichert 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.
VertexElementVertexColorSpeichert Farbdaten pro Spitze oder Ecke als FVector4 (r, g, b, a im Bereich 01).
VertexElementSmoothingGroupSpeichert die Zahl-IDs der Glättungsgruppen pro Polygon, mit denen der OBJ-Importeur die ursprünglichen Glätungsgruppezuweisungen aus der Quelldatei reproduziert.
VertexElementTypeAufzählung, die die semantische Rolle einer Vertex-Elementschicht identifiziert: NORMAL, UV, VERTEX_COLOR, SMOOTHING_GROUP, und andere. Mesh.get_element().
MappingModeAufzählung, die kontrolliert, welcher primitive Wert eines Wertelementes zu: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE,oder , ALL_SAME.
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).
PolygonModifierStatische Nutzungsklasse mit Methoden zur Triangulation Mesh Gegenstände und ganze Scene Die Grafiken.

Transform und Raumfahrt

KlasseBeschreibung
TransformLokalverarbeitung mit einem Node.Die Übersetzung, die Rotation (wie in der Regel bei den Quaternion), und Skalenkomponenten sowie Komfort-Eigenschaften für Eulerwinkel.
GlobalTransformLeseberechtigte Ansicht der Weltraumtransformation eines Knoten nach dem Zusammenstellen aller Vorfahren-Transformationen. Zugriff über Node.global_transform.
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.
LambertMaterialModell für nur diffuse Materialien, speichert Umgebungsfarbe, diffus Farbe und Emissionsfarben sowie Transparenz. Ka/Kd/Ke Erklärungen.
PhongMaterialAusdehnung LambertMaterial Die Daten werden von OBJ-Dateien geladen, die den Speicher mit einer Spiegelfarbe und einem Spiegelschein verwenden. Ks/Ns Erklärungen.
PbrMaterialSpeichert Albedo, Metallfaktor, Rauheit Faktor und zugehörige Texturen. Verwendet von glTF 2.0 und anderen PBR-fähigen Formaten.

Kamera und Beleuchtung

KlasseBeschreibung
CameraNur 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.
LightLichtquelle-Einheit. Erbt von Camera als Stubklasse; die Light Die Klasse selbst zeigt in dieser Veröffentlichung keine zusätzlichen Eigenschaften auf.
LightTypeAufzählung der unterstützten Lichtkategorien: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.
ProjectionTypeAufzählung der Projektionsmodi von Kameras: PERSPECTIVE und . ORTHOGRAPHIC.

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.
FVector2Einpräziser zweikomponenter Float-Vektor. Intern für kompakte Speicherung in Vertexelementdatenarchiven verwendet.
FVector3Einpräziser 3-Komponenten-Floatvektor. Er erscheint in Vertexelementdatenarchiven für Normalwerte und Tangente.
FVector4Einzigpräzise 4-Komponenten-Floatvektor. Der Speichertyp von VertexElementFVector.data.
QuaternionEinheit für die Darstellung von Rotationen (w, x, y, z) Verwendet von: Transform.rotation.
Matrix44×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxAchsgebundene Grenzfläche, definiert durch: minimum und . maximum DieVector3 Wir benutzen sie für räumliche Abfragen und Frust-Aufnahmehilfen.

Animation und Film

KlasseBeschreibung
AnimationClipBenannte Container für eine Reihe von animierten Kanälen, die einen Wiedergabebereich abdecken. A Scene kann mehrere Klammern (z. B. “Walk”, “Run”) halten;.
AnimationNodeDie Kommission hat die AnimationClip Als Brücke zwischen Clip-Daten und Szenengraphobjekten fungiert.
AnimationChannelEin einzelner animierter Eigenschaftsstrom innerhalb eines Clips, der auf eine benannte Eigenschaft eines Objekts abzielt (z. B., Transform.translation.x).
KeyFrameEine einzelne Zeit-Wertprobe innerhalb einer KeyframeSequence.Speichert die Zeit (in Sekunden) und den Wert zu diesem Zeitpunkt.
KeyframeSequenceEine geordnete Liste von KeyFrame Objekte für einen skalaren Kanal, zusammen mit Interpolation und Extrapolierungs-Einstellungen.
InterpolationAufzählung der Interpolationsträger zwischen Schlüsselbildern: CONSTANT, LINEAR, BEZIER, B_SPLINE, CARDINAL_SPLINE, TCB_SPLINE.
ExtrapolationTypeAuflistung von Verhaltensweisen über den ersten und letzten Schlüsselrahmen hinaus: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATE.

E/A-Format

Symbol für dieBeschreibung
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.
FileFormatRegistrierung 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).
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, ColladaLoadOptions, ThreeMfLoadOptions.
SaveOptionsBasisklasse für alle formatspezifischen Speicheroptionsobjekte. Unterklassen durch ObjSaveOptions, StlSaveOptions, GltfSaveOptions, FbxSaveOptions, ColladaSaveOptions, ThreeMfSaveOptions.

OBJ-Format

KlasseBeschreibung
ObjImporterInterne Importeurklasse, die Wavefront OBJ- und MTL-Dateien analysiert. automatisch von der Scene.from_file() für die .obj Erweiterungen.
ObjLoadOptionsLadeoptionen für Wavefront OBJ-Dateien. Schlüsselmerkmale: flip_coordinate_system, scale, enable_materials, normalize_normal.
ObjSaveOptionsSpeichern Sie Optionen für Wavefront OBJ-Ausgabe. Steuert Normale, UVs, Materialreferenzen und Punktwolkmodus.
ObjFormatFormatdeskriptor für Wavefront OBJ. Zugänglich als FileFormat.WAVEFRONT_OBJ().

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 flip_coordinate_system und . scale.
StlSaveOptionsSpeichern von Optionen für die STL-Ausgabe. binary_mode, scale,und . flip_coordinate_system.
StlFormatFormatdeskriptor für STL.

glTF-Format

KlasseBeschreibung
GltfLoadOptionsLadeoptionen für glTF 2.0 und GLB-Dateien. Schlüssel Eigenschaft: flip_tex_coord_v.
GltfSaveOptionsSpeichern Sie Optionen für glTF 2.0 Ausgabe. Verwenden binary_mode=True für ein eigenständiges GLB-Paket.
GltfFormatFormatdeskriptor für glTF 2.0 / GLB. Zugänglich als FileFormat.GLTF2().

FBX-Format

KlasseBeschreibung
FbxLoadOptions- Schlüssel-Eigenschaften: keep_builtin_global_settings, compatible_mode.
FbxSaveOptionsSpeichern 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.
FbxFormatFormatdeskriptor für FBX. Zugänglich als FileFormat.FBX7400ASCII().

COLLADA Format (auf Englisch)

KlasseBeschreibung
ColladaLoadOptionsDie Lastoptionen für COLLADA (.daeDie Elemente, die für den Import von Waren erforderlich sind, werden in der Tabelle 1 aufgeführt.
ColladaSaveOptionsSpeichern Sie Optionen für COLLADA-Ausgabe. indented, flip_coordinate_system, und Material-Export.
ColladaFormatFormatdeskriptor für COLLADA. automatisch von der .dae Dateierweiterung.

3MF Format

KlasseBeschreibung
ThreeMfLoadOptionsLastoptionen für 3MF (.3mf) Dateien.
ThreeMfSaveOptionsSpeicheroptionen für 3MF-Ausgabe. 3 MF ist das bevorzugte Format für 3-D-Druckworkflows.
ThreeMfFormatFormatdeskriptor für 3MF. Zugänglich als FileFormat.MICROSOFT_3MF_FORMAT().

Aufzählungen

AufzählungBeschreibung
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. Scene.render() Erhöhung NotImplementedError; Rendering ist in dieser Version nicht implementiert.

Siehe auch:

 Deutsch