Aspose.3D FOSS for Python

API-reference for aspose-3d-foss 26.1.0 (Python 3.7 – 3.12, MIT-licens).

Alle klasser importeres fra aspose.threed pakke eller dens underpakker. Rodimporten er:

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

Kerne‑scengraf

Methods	Methods
`Scene`	Top‑niveau container for alle 3D‑scenedata. Indeholder rotnoden, aktivmetadata og animationsklip. Eksponerer `from_file()`, `open()`, og `save()` som de primære I/O‑indgangspunkt.
`Node`	En navngivet node i scenens hierarki. Ejer en liste over under‑noder og en liste over vedhæftede `Entity` objekter såsom mesh‑net, kameraer og lys. Bærer en lokal `Transform`.
`Entity`	Abstrakt grundklasse for alle objekter, der kan vedhæftes til en `Node`. Giver navn og identitet, men ingen egen geometri.
`SceneObject`	Grundklasse delt af `Node` og `Entity`. Giver grænsefladen for egenskabssamling, der bruges til brugerdefineret metadata.
`A3DObject`	Rod‑grundklasse for alle Aspose.3D‑administrerede objekter. Eksponerer navnegenskaben og the `Properties` samling.
`INamedObject`	Interface der garanterer en `name` egenskab. Implementeret af `Node`, `Entity`, og flere format‑specifikke deskriptortyper.

Geometri og net

Methods	Methods
`Mesh`	Polygonnet-entity. Gemmer kontrolpunkter (vertex positioner som `Vector4`), polygonfladelister (lister over kontrolpunktindekser), og vertex-elementlag (normals, UVs, vertex colours).
`Geometry`	Abstrakt base for mesh-lignende geometrityper. Definerer kontrolpunktarrayet og samlingen af `VertexElement` lag. `Mesh` arver fra `Geometry`.
`VertexElement`	Abstrakt base for et datalag, der er knyttet til geometri (normals, UVs, colours osv.). Bærer `mapping_mode`, `reference_mode`, og en `data` liste.
`VertexElementNormal`	Gemmer én normalvektor pr. vertex eller pr. polygonhjørne, afhængig af `mapping_mode`. Dataværdier er `FVector4` instanser (single-precision) med `w` ubrugt.
`VertexElementUV`	Gemmer teksturkoordinatdata som `FVector4` pr. vertex eller pr. polygonhjørne (kun `x` og `y` komponenter bruges til UV). Et mesh kan indeholde flere UV-lag for forskellige teksturkanaler.
`VertexElementVertexColor`	Gemmer per-vertex eller per-corner RGBA-farvedata som `FVector4` (r, g, b, a i intervallet 0–1).
`VertexElementSmoothingGroup`	Gemmer per-polygon udglatningsgruppe heltals‑ID’er, som bruges af OBJ‑importøren til at genskabe de oprindelige udglatningsgruppe‑tildelinger fra kildefilen.
`VertexElementType`	Enumeration, der identificerer den semantiske rolle for et vertex‑elementlag: `NORMAL`, `UV`, `VERTEX_COLOR`, `SMOOTHING_GROUP`, og andre. Overfør værdier til `Mesh.get_element()`.
`MappingMode`	Enumeration, der styrer hvilken primitive en vertex-elementværdi kortlægges til: `CONTROL_POINT`, `POLYGON_VERTEX`, `POLYGON`, `EDGE`, eller `ALL_SAME`.
`ReferenceMode`	Enumeration, der styrer hvordan værdier indekseres: `DIRECT` (én værdi pr. kortlægningsprimitive) eller `INDEX_TO_DIRECT` (værdier-array plus et separat indeks-array).
`PolygonModifier`	Statisk hjælpeklasse med metoder til at triangulere `Mesh` objekter og hele `Scene` grafer.

Transformation og rum

Methods	Methods
`Transform`	Lokal transformation knyttet til en `Node`. Giver oversættelse, rotation (som `Quaternion`), og skaleringskomponenter, plus bekvemmelighedsegenskaber for Euler-vinkler.
`GlobalTransform`	Skrivebeskyttet visning af en nodes verdensrumstransformation efter sammensætning af alle forældretransformeringer. Tilgås via `Node.global_transform`.
`AssetInfo`	Metadata-blok knyttet til en `Scene`. Gemmer navnet på forfatterapplikationen, enhedens navn, enhedens skaleringsfaktor, definitioner af koordinatsystemets akser samt oprettelses-/ændringstidspunkter.

Materialer og skygge

Methods	Methods
`Material`	Abstrakt grundklasse for alle materialetyper. Giver et navn og en egenskabssamling for numeriske og farveparametre.
`LambertMaterial`	Kun-diffus materialmodel. Gemmer omgivende farve, diffus farve, emissiv farve og gennemsigtighed. Indlæst fra OBJ-filer, der bruger grundlæggende `Ka`/`Kd`/`Ke` deklarationer.
`PhongMaterial`	Methods `LambertMaterial` med spekulær farve og glans (speculær eksponent). Indlæst fra OBJ-filer, der bruger `Ks`/`Ns` deklarationer.
`PbrMaterial`	Physically Based Rendering-materiale. Gemmer albedo, metallisk faktor, ruhedsfaktor og tilknyttede teksturer. Bruges af glTF 2.0 og andre PBR-kompatible formater.

Kamera og belysning

Methods	Methods
`Camera`	Kameraenhed. Kun `projection_type` og `name` er funktionelle i denne udgave; alle andre numeriske egenskaber (`near_plane`, `far_plane`, `field_of_view`, `aspect_ratio`) er stubber, der returnerer standardværdier. Tilknyttet en `Node` for at definere synspunktstransformationer.
`Light`	Lyskildeenhed. Arver fra `Camera` som en stub-klasse; den `Light` klasse i sig selv eksponerer ikke yderligere egenskaber i denne udgivelse.
`LightType`	Enumeration af understøttede lys‑kategorier: `POINT`, `DIRECTIONAL`, `SPOT`, `AREA`, `VOLUME`.
`ProjectionType`	Enumeration af kamera‑projektionstilstande: `PERSPECTIVE` og `ORTHOGRAPHIC`.

Matematiske værktøjer

Methods	Methods
`Vector2`	Dobbeltpræcisions 2‑komponent vektor (`x`, `y`) Bruges til UV‑teksturkoordinater.
`Vector3`	Dobbeltpræcisions 3‑komponent vektor (`x`, `y`, `z`) Bruges til positioner, retninger og skala.
`Vector4`	Dobbeltpræcision 4-komponent vektor (`x`, `y`, `z`, `w`). Bruges til kontrolpunkter (homogene positioner) og normaldata.
`FVector2`	Enkeltpræcision 2-komponent float vektor. Bruges internt til kompakt lagring i vertex element data arrays.
`FVector3`	Enkeltpræcision 3-komponent float vektor. Forekommer i vertex element data arrays for normaler og tangenter.
`FVector4`	Enkeltpræcision 4-komponent float-vektor. Lagringstypen for `VertexElementFVector.data`.
`Quaternion`	Enhedsquaternion til at repræsentere rotationer (`w`, `x`, `y`, `z`). Bruges af `Transform.rotation`.
`Matrix4`	4×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
`BoundingBox`	Aksialt justeret begrænsningsboks defineret af `minimum` og `maximum` `Vector3` hjørner. Bruges til rumlige forespørgsler og frustum culling-hjælperedskaber.

Methods

Methods	Methods
`AnimationClip`	Navngivet container for et sæt af animerede kanaler, der dækker et afspilningsinterval. En `Scene` kan indeholde flere klip (f.eks. “Walk”, “Run”).
`AnimationNode`	Binder en `AnimationClip` til en specifik scenenode eller egenskab. Fungerer som broen mellem klipdata og scenegraph-objekter.
`AnimationChannel`	En enkelt animeret egenskabsstrøm inden for et klip, der målretter en navngivet egenskab på et objekt (f.eks., `Transform.translation.x`).
`KeyFrame`	Et enkelt tids‑værdi‑sample inden for en `KeyframeSequence`. Gemmer tiden (i sekunder) og værdien på det tidspunkt.
`KeyframeSequence`	En ordnet liste over `KeyFrame` objekter for en skalar kanal, sammen med interpolations- og ekstrapolationsindstillinger.
`Interpolation`	Enumeration af interpolations‑tilstande mellem nøgleframes: `CONSTANT`, `LINEAR`, `BEZIER`, `B_SPLINE`, `CARDINAL_SPLINE`, `TCB_SPLINE`.
`ExtrapolationType`	Enumeration af adfærd ud over den første og sidste keyframe: `CONSTANT`, `GRADIENT`, `CYCLE`, `CYCLE_RELATIVE`, `OSCILLATE`.

Format I/O

Methods	Methods
`Scene.from_file(path)`	Statisk metode. Åbner filen på `path`, registrerer formatet ud fra filendelsen og returnerer en udfyldt `Scene`. Kaster en fejl ved fil‑ikke‑fundet eller ikke‑understøttet format.
`Scene.open(path, options=None)`	Instansmetode. Åbner en fil i en eksisterende `Scene` instans, eventuelt ved brug af en format‑specifik `LoadOptions` underklasse.
`Scene.save(path, options=None)`	Instansmetode. Serialiserer scenen til `path` ved at bruge formatet udledt fra filendelsen, eventuelt ved brug af en format‑specifik `SaveOptions` underklasse.
`FileFormat`	Register over understøttede filformater. Indeholder poster såsom `FileFormat.WAVEFRONT_OBJ`, `FileFormat.GLTF`, `FileFormat.FBX7400ASCII`, `FileFormat.MICROSOFT_3MF`. Format‑specifikke varianter tilgås via optionsklasser (f.eks., `ColladaSaveOptions`, `GltfSaveOptions`).
`IOService`	Intern I/O-abstraktion brugt af formatimportører og -eksportører. Typisk ikke brugt direkte af applikationskode.
`LoadOptions`	Basisklasse for alle format‑specifikke indlæsnings‑optionsobjekter. Underklasset af `ObjLoadOptions`, `StlLoadOptions`, `GltfLoadOptions`, `FbxLoadOptions`, `ColladaLoadOptions`, `ThreeMfLoadOptions`.
`SaveOptions`	Basisklasse for alle format‑specifikke gemme‑optionsobjekter. Underklasset af `ObjSaveOptions`, `StlSaveOptions`, `GltfSaveOptions`, `FbxSaveOptions`, `ColladaSaveOptions`, `ThreeMfSaveOptions`.

OBJ Format

Methods	Methods
`ObjImporter`	Intern importørklasse som parser Wavefront OBJ- og MTL-filer. Kaldt automatisk af `Scene.from_file()` for `.obj` filendelser.
`ObjLoadOptions`	Indlæsnings‑options for Wavefront OBJ-filer. Nøgleegenskaber: `flip_coordinate_system`, `scale`, `enable_materials`, `normalize_normal`.
`ObjSaveOptions`	Gem indstillinger for Wavefront OBJ-uddata. Styrer normaler, UV’er, materialereferencer og punkt-sky-tilstand.
`ObjFormat`	Formatbeskrivelse for Wavefront OBJ. Tilgængelig som `FileFormat.WAVEFRONT_OBJ()`.

STL Format

Methods	Methods
`StlImporter`	Intern importør, der læser både binære og ASCII STL-filer. Vælges automatisk efter filendelse.
`StlExporter`	Intern eksportør, der skriver STL.
`StlLoadOptions`	Indlæsningsindstillinger for STL-filer. Understøtter `flip_coordinate_system` og `scale`.
`StlSaveOptions`	Gemningsindstillinger for STL-output. Styrer `binary_mode`, `scale`, og `flip_coordinate_system`.
`StlFormat`	Formatbeskriver for STL.

glTF Format

Methods	Methods
`GltfLoadOptions`	Indlæsningsindstillinger for glTF 2.0- og GLB-filer. Nøgleegenskab: `flip_tex_coord_v`.
`GltfSaveOptions`	Gemningsindstillinger for glTF 2.0-output. Brug `binary_mode=True` til en selvstændig GLB-pakke.
`GltfFormat`	Formatbeskriver for glTF 2.0 / GLB. Tilgængelig som `FileFormat.GLTF2()`.

FBX Format

Methods	Methods
`FbxLoadOptions`	Indlæsningsindstillinger for FBX-filer. Nøgleegenskaber: `keep_builtin_global_settings`, `compatible_mode`.
`FbxSaveOptions`	Gemningsindstillinger for FBX-output. FBX-eksport udløser `NotImplementedError` ubetinget; `FbxSaveOptions` findes, men eksport er ikke implementeret.
`FbxFormat`	Formatbeskriver for FBX. Tilgængelig som `FileFormat.FBX7400ASCII()`.

COLLADA Format

Methods	Methods
`ColladaLoadOptions`	Indlæsningsindstillinger for COLLADA (`.dae`) filer. Styrer akse-omlægning og enhedsskala ved import.
`ColladaSaveOptions`	Gem indstillinger for COLLADA-uddata. Kontroller `indented`, `flip_coordinate_system`, og materialeeksport.
`ColladaFormat`	Formatbeskrivelse for COLLADA. Løses automatisk fra `.dae` filendelse.

3MF Format

Methods	Methods
`ThreeMfLoadOptions`	Indlæs indstillinger for 3MF (`.3mf`) filer.
`ThreeMfSaveOptions`	Gem indstillinger for 3MF-output. 3MF er det foretrukne format til 3D-printarbejdsprocesser.
`ThreeMfFormat`	Formatbeskriver for 3MF. Tilgængelig som `FileFormat.MICROSOFT_3MF_FORMAT()`.

Methods

Methods	Methods
`TextureMapping`	Identificerer hvordan en tekstur er kortlagt til geometri: `DIFFUSE`, `SPECULAR`, `EMISSIVE`, `NORMAL`, `AMBIENT`, osv.
`BooleanOperation`	CSG Boolesk operationstype: `UNION`, `DIFFERENCE`, `INTERSECTION`.

Egenskabssystem

Methods	Methods
`Property`	En enkelt navngivet typet egenskab på en `A3DObject`. Gemmer egenskabsnavnet, typebeskrivelsen og den aktuelle værdi.
`PropertyCollection`	Itererbar samling af `Property` objekter knyttet til en `A3DObject`. Understøtter opslag efter navn og iteration over alle definerede egenskaber.
`CustomObject`	En letvægts `A3DObject` underklasse, der kun indeholder et navn og en vilkårlig `PropertyCollection`. Bruges til at gemme brugerdefineret metadata på scenobjekter.

Billede og Rendering

Methods	Methods
`ImageRenderOptions`	Indstillinger for software rasterisering ved rendering af en scene til en billedbuffer. Gemmer baggrundsfarve, billeddimensioner og kamerareference. `Scene.render()` løfter `NotImplementedError`; rendering er ikke implementeret i denne udgave.

Aspose.3D FOSS for Python

Kerne‑scengraf

Geometri og net

Transformation og rum

Materialer og skygge

Kamera og belysning

Matematiske værktøjer

Methods

Format I/O

OBJ Format

STL Format

glTF Format

FBX Format

COLLADA Format

3MF Format

Methods

Egenskabssystem

Billede og Rendering

Se også