Aspose.3D FOSS for Python

API-referentie voor aspose-3d-foss 26.1.0 (Python 3.7 – 3.12, MIT-licentie).

Alle klassen worden geïmporteerd vanuit de aspose.threed package of zijn subpackages. De hoofdimport is:

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

Kern Scene Graph

Methods	Methods
`Scene`	Top-level container voor alle 3D-scènegegevens. Bevat het rootknooppunt, assetmetadata en animatieclips. Biedt `from_file()`, `open()`, en `save()` als de primaire I/O-ingangspunten.
`Node`	Een benoemd knooppunt in de scènehiërarchie. Bevat een lijst van kindknooppunten en een lijst van gekoppelde `Entity` objecten zoals meshes, camera’s en lampen. Draagt een lokale `Transform`.
`Entity`	Abstracte basisklasse voor alle objecten die aan een `Node`. Biedt naam en identiteit maar geen eigen geometrie.
`SceneObject`	Basisklasse gedeeld door `Node` en `Entity`. Biedt de eigenschapencollectie‑interface die wordt gebruikt voor door de gebruiker gedefinieerde metadata.
`A3DObject`	Root-basisklasse voor alle Aspose.3D beheerde objecten. Biedt de naam‑eigenschap en de `Properties` collectie.
`INamedObject`	Interface die een garandeert `name` eigenschap. Geïmplementeerd door `Node`, `Entity`, en verschillende formatspecifieke descriptor types.

Geometrie en Mesh

Methods	Methods
`Mesh`	Polygonmesh-entiteit. Slaat controlepunten op (vertexposities als `Vector4`), polygonvlakkenlijsten (lijsten van controlepuntindices), en vertex-elementlagen (normals, UV’s, vertexkleuren).
`Geometry`	Abstracte basis voor mesh-achtige geometrietypen. Definieert de controlepuntarray en de collectie van `VertexElement` lagen. `Mesh` erft van `Geometry`.
`VertexElement`	Abstracte basis voor een datalaag gekoppeld aan geometrie (normals, UV’s, kleuren, etc.). Bevat `mapping_mode`, `reference_mode`, en een `data` lijst.
`VertexElementNormal`	Slaat één normal vector op per vertex of per polygonhoek, afhankelijk van `mapping_mode`. Gegevenswaarden zijn `FVector4` instanties (single-precision) met `w` ongebruikt.
`VertexElementUV`	Slaat textuurcoördinaatgegevens op als `FVector4` per vertex of per polygonhoek (alleen `x` en `y` componenten worden gebruikt voor UV). Een mesh kan meerdere UV-lagen dragen voor verschillende textuurkanalen.
`VertexElementVertexColor`	Slaat per-vertex of per-corner RGBA-kleurgegevens op als `FVector4` (r, g, b, a in het bereik 0–1).
`VertexElementSmoothingGroup`	Slaat per-polygon gladheidsgroep gehele getal-ID’s op, gebruikt door de OBJ-importer om de oorspronkelijke gladheidsgroeps-toewijzingen uit het bronbestand te reproduceren.
`VertexElementType`	Enumeratie die de semantische rol van een vertex-elementlaag identificeert: `NORMAL`, `UV`, `VERTEX_COLOR`, `SMOOTHING_GROUP`, en anderen. Geef waarden door aan `Mesh.get_element()`.
`MappingMode`	Enumeratie die bepaalt naar welke primitive een vertex-elementwaarde wordt gemapt: `CONTROL_POINT`, `POLYGON_VERTEX`, `POLYGON`, `EDGE`, of `ALL_SAME`.
`ReferenceMode`	Enumeratie die bepaalt hoe waarden worden geïndexeerd: `DIRECT` (één waarde per mapping-primitive) of `INDEX_TO_DIRECT` (waardenarray plus een aparte indexarray).
`PolygonModifier`	Statische hulpprogrammaklasse met methoden om te trianguleren `Mesh` objecten en volledige `Scene` grafen.

Transformatie en Spatial

Methods	Methods
`Transform`	Lokale transformatie gekoppeld aan een `Node`. Biedt translatie, rotatie (als `Quaternion`), en schaalcomponenten, plus handige eigenschappen voor Eulerhoeken.
`GlobalTransform`	Alleen-lezen weergave van de wereldruimtetransformatie van een knoop na het samenstellen van alle vooroudertransformaties. Toegankelijk via `Node.global_transform`.
`AssetInfo`	Metadatablok gekoppeld aan een `Scene`. Slaat de naam van de authoring-toepassing, eenheidsnaam, eenheids-schaalfactor, definities van coördinatensysteemassen, en aanmaak-/wijzigings-tijdstempels op.

Materialen en Shading

Methods	Methods
`Material`	Abstracte basisklasse voor alle materiaaltypes. Biedt een naam en een verzameling eigenschappen voor numerieke en kleurparameters.
`LambertMaterial`	Alleen-diffuse materiaalmodel. Slaat de omgevingskleur, diffuse kleur, emissiekleur en transparantie op. Geladen uit OBJ-bestanden die basis `Ka`/`Kd`/`Ke` declaraties.
`PhongMaterial`	Methods `LambertMaterial` met speculaire kleur en glans (speculaire exponent). Geladen uit OBJ-bestanden die `Ks`/`Ns` declaraties.
`PbrMaterial`	Physically Based Rendering-materiaal. Slaat albedo, metallic factor, roughness factor en bijbehorende textures op. Wordt gebruikt door glTF 2.0 en andere PBR-compatibele formaten.

Camera en Verlichting

Methods	Methods
`Camera`	Camera‑entiteit. Alleen `projection_type` en `name` zijn functioneel in deze editie; alle andere numerieke eigenschappen (`near_plane`, `far_plane`, `field_of_view`, `aspect_ratio`) zijn stubs die standaardwaarden teruggeven. Bevestigd aan een `Node` om kijkpunttransformaties te definiëren.
`Light`	Lichtbron‑entiteit. Erft van `Camera` als een stub‑klasse; de `Light` klasse zelf exposeert geen extra eigenschappen in deze release.
`LightType`	Enumeratie van ondersteunde lichtcategorieën: `POINT`, `DIRECTIONAL`, `SPOT`, `AREA`, `VOLUME`.
`ProjectionType`	Enumeratie van cameraprojectiemodi: `PERSPECTIVE` en `ORTHOGRAPHIC`.

Wiskundige Hulpmiddelen

Methods	Methods
`Vector2`	Dubbelprecisie 2-component vector (`x`, `y`). Gebruikt voor UV‑textuurcoördinaten.
`Vector3`	Dubbelprecisie 3-component vector (`x`, `y`, `z`). Gebruikt voor posities, richtingen en schaal.
`Vector4`	Dubbele-precisie 4-componentenvector (`x`, `y`, `z`, `w`). Gebruikt voor controlepunten (homogene posities) en normaalgegevens.
`FVector2`	Enkelprecisie 2-componenten floatvector. Intern gebruikt voor compacte opslag in vertex-elementgegevensarrays.
`FVector3`	Enkelprecisie 3-componenten floatvector. Komt voor in vertex-elementgegevensarrays voor normalen en tangenten.
`FVector4`	Single-precision 4-component float vector. Het opslagtype van `VertexElementFVector.data`.
`Quaternion`	Unit quaternion voor het representeren van rotaties (`w`, `x`, `y`, `z`). Gebruikt door `Transform.rotation`.
`Matrix4`	4×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
`BoundingBox`	Axis-aligned bounding box gedefinieerd door `minimum` en `maximum` `Vector3` hoeken. Gebruikt voor ruimtelijke queries en frustum culling‑hulpmiddelen.

Methods

Methods	Methods
`AnimationClip`	Naamgevende container voor een set van geanimeerde kanalen die één afspeelbereik bestrijken. Een `Scene` kan meerdere clips bevatten (bijv. “Walk”, “Run”).
`AnimationNode`	Bindt een `AnimationClip` aan een specifiek sceneknooppunt of eigenschap. Werkt als de brug tussen clipgegevens en scene‑graph objecten.
`AnimationChannel`	Een enkele geanimeerde eigenschapsstroom binnen een clip, gericht op een benoemde eigenschap van een object (bijv., `Transform.translation.x`).
`KeyFrame`	Een enkele tijd‑waarde monster binnen een `KeyframeSequence`. Slaat de tijd (in seconden) en de waarde op dat moment op.
`KeyframeSequence`	Een geordende lijst van `KeyFrame` objecten voor één scalair kanaal, samen met interpolatie‑ en extrapolatie‑instellingen.
`Interpolation`	Enumeratie van interpolatiemodi tussen keyframes: `CONSTANT`, `LINEAR`, `BEZIER`, `B_SPLINE`, `CARDINAL_SPLINE`, `TCB_SPLINE`.
`ExtrapolationType`	Opsomming van gedragingen buiten het eerste en laatste keyframe: `CONSTANT`, `GRADIENT`, `CYCLE`, `CYCLE_RELATIVE`, `OSCILLATE`.

Formaat I/O

Methods	Methods
`Scene.from_file(path)`	Statische methode. Opent het bestand op `path`, detecteert het formaat aan de hand van de extensie, en retourneert een gevulde `Scene`. Werpt een fout bij bestand‑niet‑gevonden of niet‑ondersteund formaat.
`Scene.open(path, options=None)`	Instantiemethode. Opent een bestand in een bestaande `Scene` instantie, eventueel met een formaat‑specifieke `LoadOptions` subklasse.
`Scene.save(path, options=None)`	Instantiemethode. Serialiseert de scène naar `path` gebruikmakend van het formaat afgeleid van de extensie, eventueel met een formaat‑specifieke `SaveOptions` subklasse.
`FileFormat`	Register van ondersteunde bestandsformaten. Bevat items zoals `FileFormat.WAVEFRONT_OBJ`, `FileFormat.GLTF`, `FileFormat.FBX7400ASCII`, `FileFormat.MICROSOFT_3MF`. Formaat‑specifieke varianten zijn toegankelijk via optieklassen (bijv., `ColladaSaveOptions`, `GltfSaveOptions`).
`IOService`	Interne I/O‑abstrahering gebruikt door formaat‑importeurs en -exporteurs. Wordt doorgaans niet rechtstreeks door toepassingscode gebruikt.
`LoadOptions`	Basisklasse voor alle formaat‑specifieke laadoptie‑objecten. Gesubklasseerd door `ObjLoadOptions`, `StlLoadOptions`, `GltfLoadOptions`, `FbxLoadOptions`, `ColladaLoadOptions`, `ThreeMfLoadOptions`.
`SaveOptions`	Basisklasse voor alle formaat‑specifieke opslaan‑optie‑objecten. Gesubklasseerd door `ObjSaveOptions`, `StlSaveOptions`, `GltfSaveOptions`, `FbxSaveOptions`, `ColladaSaveOptions`, `ThreeMfSaveOptions`.

OBJ-formaat

Methods	Methods
`ObjImporter`	Interne importklasse die Wavefront OBJ‑ en MTL‑bestanden parseert. Automatisch aangeroepen door `Scene.from_file()` voor `.obj` extensies.
`ObjLoadOptions`	Laadopties voor Wavefront OBJ‑bestanden. Belangrijke eigenschappen: `flip_coordinate_system`, `scale`, `enable_materials`, `normalize_normal`.
`ObjSaveOptions`	Opslaanopties voor Wavefront OBJ-uitvoer. Beheert normalen, UV’s, materiaallinks en puntwolk-modus.
`ObjFormat`	Formaatbeschrijving voor Wavefront OBJ. Toegankelijk als `FileFormat.WAVEFRONT_OBJ()`.

STL-formaat

Methods	Methods
`StlImporter`	Interne importeur die zowel binaire als ASCII STL-bestanden leest. Automatisch geselecteerd op basis van extensie.
`StlExporter`	Interne exporteur die STL schrijft.
`StlLoadOptions`	Laadopties voor STL‑bestanden. Ondersteunt `flip_coordinate_system` en `scale`.
`StlSaveOptions`	Opslaanopties voor STL‑output. Regelt `binary_mode`, `scale`, en `flip_coordinate_system`.
`StlFormat`	Formaatdescriptor voor STL.

glTF-formaat

Methods	Methods
`GltfLoadOptions`	Laadopties voor glTF 2.0‑ en GLB‑bestanden. Belangrijke eigenschap: `flip_tex_coord_v`.
`GltfSaveOptions`	Opslaanopties voor glTF 2.0‑output. Gebruik `binary_mode=True` voor een zelfstandige GLB‑package.
`GltfFormat`	Formaatdescriptor voor glTF 2.0 / GLB. Toegankelijk als `FileFormat.GLTF2()`.

FBX-formaat

Methods	Methods
`FbxLoadOptions`	Laadopties voor FBX‑bestanden. Belangrijke eigenschappen: `keep_builtin_global_settings`, `compatible_mode`.
`FbxSaveOptions`	Opslaanopties voor FBX‑output. FBX‑export veroorzaakt `NotImplementedError` onvoorwaardelijk; `FbxSaveOptions` bestaat, maar export is niet geïmplementeerd.
`FbxFormat`	Formaatdescriptor voor FBX. Toegankelijk als `FileFormat.FBX7400ASCII()`.

COLLADA-formaat

Methods	Methods
`ColladaLoadOptions`	Laadopties voor COLLADA (`.dae`)‑bestanden. Regelt asremapping en eenheidsschaal bij import.
`ColladaSaveOptions`	Opslaanopties voor COLLADA-uitvoer. Besturingselementen `indented`, `flip_coordinate_system`, en materiaalexport.
`ColladaFormat`	Formaatdescriptor voor COLLADA. Automatisch bepaald van `.dae` bestandsextensie.

3MF Format

Methods	Methods
`ThreeMfLoadOptions`	Laad opties voor 3MF (`.3mf`) bestanden.
`ThreeMfSaveOptions`	Sla opties op voor 3MF-uitvoer. 3MF is het voorkeursformaat voor 3D‑printworkflows.
`ThreeMfFormat`	Formaatdescriptor voor 3MF. Toegankelijk als `FileFormat.MICROSOFT_3MF_FORMAT()`.

Methods

Methods	Methods
`TextureMapping`	Identificeert hoe een textuur op geometrie wordt gemapt: `DIFFUSE`, `SPECULAR`, `EMISSIVE`, `NORMAL`, `AMBIENT`, enz.
`BooleanOperation`	CSG Booleaanse bewerkingstype: `UNION`, `DIFFERENCE`, `INTERSECTION`.

Eigenschappen Systeem

Methods	Methods
`Property`	Een enkele benoemde getypeerde eigenschap op een `A3DObject`. Slaat de eigenschapsnaam, type‑descriptor en huidige waarde op.
`PropertyCollection`	Iterabele collectie van `Property` objecten gekoppeld aan een `A3DObject`. Ondersteunt opzoeken op naam en iteratie over alle gedefinieerde eigenschappen.
`CustomObject`	Een lichtgewicht `A3DObject` subklasse die alleen een naam en een willekeurige `PropertyCollection`. Gebruikt voor het opslaan van door gebruikers gedefinieerde metadata op scène‑objecten.

Afbeelding en Render

Methods	Methods
`ImageRenderOptions`	Opties voor software‑rasterisatie bij het renderen van een scène naar een afbeeldingsbuffer. Slaat achtergrondkleur, afbeeldingsafmetingen en camerareferentie op. `Scene.render()` verhoogt `NotImplementedError`; rendering is niet geïmplementeerd in deze release.

Aspose.3D FOSS for Python

Kern Scene Graph

Geometrie en Mesh

Transformatie en Spatial

Materialen en Shading

Camera en Verlichting

Wiskundige Hulpmiddelen

Methods

Formaat I/O

OBJ-formaat

STL-formaat

glTF-formaat

FBX-formaat

COLLADA-formaat

3MF Format

Methods

Eigenschappen Systeem

Afbeelding en Render

Zie ook