Aspose.3D FOSS for Python

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

Alle klasser importeres fra aspose.threed pakke eller dens underpakker. Rotimporten 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

Kjerne Scengraf

Methods	Methods
`Scene`	Toppnivåbeholder for alle 3D-scenedata. Inneholder rot-noden, metadata for eiendeler og animasjonsklipp. Eksponerer `from_file()`, `open()`, og `save()` som de primære I/O-inngangspunktene.
`Node`	En navngitt node i scenehierarkiet. Eier en liste over undernoder og en liste over tilknyttede `Entity` objekter som mesh, kameraer og lys. Bærer en lokal `Transform`.
`Entity`	Abstrakt basisklasse for alle objekter som kan festes til en `Node`. Gir navn og identitet, men ingen egen geometri.
`SceneObject`	Basisklasse delt av `Node` og `Entity`. Tilbyr grensesnittet for egenskapskolleksjon brukt til brukerdefinert metadata.
`A3DObject`	Rotbasisklasse for alle Aspose.3D-administrerte objekter. Eksponerer navnegenskapen og the `Properties` samling.
`INamedObject`	Grensesnitt som garanterer en `name` egenskap. Implementert av `Node`, `Entity`, og flere formatspesifikke deskriptortyper.

Geometri og Mesh

Methods	Methods
`Mesh`	Polygonnett-entity. Lagrer kontrollpunkter (vertex positions as `Vector4`), polygon face lists (lists of control-point indices), and vertex element layers (normals, UVs, vertex colours).
`Geometry`	Abstrakt base for mesh-lignende geometrityper. Definerer kontrollpunktarrayet og samlingen av `VertexElement` lag. `Mesh` arver fra `Geometry`.
`VertexElement`	Abstrakt base for et datalag festet til geometri (normals, UVs, colours, etc.). Bærer `mapping_mode`, `reference_mode`, og en `data` liste.
`VertexElementNormal`	Lagrer én normalvektor per vertex eller per polygonhjørne, avhengig av `mapping_mode`. Dataverdier er `FVector4` instanser (enkeltpresisjon) med `w` ubrukt.
`VertexElementUV`	Lagrer teksturkoordinatdata som `FVector4` per vertex eller per polygonhjørne (kun `x` og `y` komponenter brukes for UV). Et mesh kan ha flere UV-lag for ulike teksturkanaler.
`VertexElementVertexColor`	Lagrer per-vertex eller per-corner RGBA-fargedata som `FVector4` (r, g, b, a i området 0–1).
`VertexElementSmoothingGroup`	Lagrer per-polygon smoothing group heltalls‑ID‑er, brukt av OBJ‑importøren for å gjenskape de opprinnelige smoothing group‑tildelingene fra kildefilen.
`VertexElementType`	Enumering som identifiserer den semantiske rollen til et vertex‑element‑lag: `NORMAL`, `UV`, `VERTEX_COLOR`, `SMOOTHING_GROUP`, og andre. Overfør verdier til `Mesh.get_element()`.
`MappingMode`	Opptelling som styrer hvilken primitive en vertex-elementverdi kartlegges til: `CONTROL_POINT`, `POLYGON_VERTEX`, `POLYGON`, `EDGE`, eller `ALL_SAME`.
`ReferenceMode`	Opptelling som styrer hvordan verdier indekseres: `DIRECT` (én verdi per kartleggingsprimitive) eller `INDEX_TO_DIRECT` (verdier-array pluss et separat indeks-array).
`PolygonModifier`	Statisk verktøyklasse med metoder for å triangulere `Mesh` objekter og hele `Scene` grafer.

Transformasjon og Romlig

Methods	Methods
`Transform`	Lokal transformasjon festet til en `Node`. Tilbyr translasjon, rotasjon (som `Quaternion`), og skaleringskomponenter, pluss praktiske egenskaper for Euler‑vinkler.
`GlobalTransform`	Kun‑lese‑visning av en nodes verdensromtransformasjon etter å ha komponert alle foreldertransformasjoner. Tilgjengelig via `Node.global_transform`.
`AssetInfo`	Metadatablokk festet til en `Scene`. Lagrer navnet på forfatterapplikasjonen, enhetsnavn, enhetens skaleringsfaktor, definisjoner av koordinatsystemaksene, samt opprettelses‑/modifiseringstidspunkter.

Materialer og Skyggelegging

Methods	Methods
`Material`	Abstrakt baseklasse for alle materialtyper. Tilbyr et navn og en egenskapskoleksjon for numeriske og colour‑parametere.
`LambertMaterial`	Kun diffus materialmodell. Lagrer omgivelsesfarge, diffus farge, emissiv farge og gjennomsiktighet. Lastet fra OBJ-filer som bruker grunnleggende `Ka`/`Kd`/`Ke` deklarasjoner.
`PhongMaterial`	Methods `LambertMaterial` med spekulær farge og glans (spekulær eksponent). Lastet fra OBJ-filer som bruker `Ks`/`Ns` deklarasjoner.
`PbrMaterial`	Fysisk basert rendering-materiale. Lagrer albedo, metallisk faktor, ruhetsfaktor og tilhørende teksturer. Brukes av glTF 2.0 og andre PBR-kompatible formater.

Kamera og Belysning

Methods	Methods
`Camera`	Kameraenhet. Kun `projection_type` og `name` er funksjonelle i denne utgaven; alle andre numeriske egenskaper (`near_plane`, `far_plane`, `field_of_view`, `aspect_ratio`) er stubb som returnerer standardverdier. Festet til en `Node` for å definere synspunkttransformasjoner.
`Light`	Lyskildeenhet. Arver fra `Camera` som en stub-klasse; `Light` klassen i seg selv eksponerer ikke ekstra egenskaper i denne utgivelsen.
`LightType`	Oppramsing av støttede lys-kategorier: `POINT`, `DIRECTIONAL`, `SPOT`, `AREA`, `VOLUME`.
`ProjectionType`	Oppramsing av kameraprojekjsonsmoduser: `PERSPECTIVE` og `ORTHOGRAPHIC`.

Matematikkverktøy

Methods	Methods
`Vector2`	Dobbelpresisjon 2-komponent vektor (`x`, `y`). Brukes for UV-teksturkoordinater.
`Vector3`	Dobbelpresisjon 3-komponent vektor (`x`, `y`, `z`). Brukes for posisjoner, retninger og skala.
`Vector4`	Dobbelpresisjon 4-komponent vektor (`x`, `y`, `z`, `w`). Brukes for kontrollpunkter (homogene posisjoner) og normaldata.
`FVector2`	Enkeltpresisjon 2-komponent floatvektor. Brukes internt for kompakt lagring i vertex element data arrays.
`FVector3`	Enkeltpresisjon 3-komponent floatvektor. Vises i vertex element data arrays for normaler og tangenter.
`FVector4`	Flyttallsvektor med enkel presisjon og 4 komponenter. Lagringstypen til `VertexElementFVector.data`.
`Quaternion`	Enhetskvaternion for å representere rotasjoner (`w`, `x`, `y`, `z`). Brukt av `Transform.rotation`.
`Matrix4`	4×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
`BoundingBox`	Aksialt justert avgrensningsboks definert av `minimum` og `maximum` `Vector3` hjørner. Brukt for romlige spørringer og frustum‑culling‑hjelpere.

Methods

Methods	Methods
`AnimationClip`	Navngitt beholder for et sett med animerte kanaler som dekker ett avspillingsområde. En `Scene` kan inneholde flere klipp (f.eks. “Walk”, “Run”).
`AnimationNode`	Binder en `AnimationClip` til en spesifikk scenenode eller egenskap. Fungerer som broen mellom klippdata og scenegrafobjekter.
`AnimationChannel`	En enkelt animert egenskapsstrøm innenfor et klipp, som retter seg mot en navngitt egenskap på et objekt (f.eks., `Transform.translation.x`).
`KeyFrame`	Et enkelt tids‑verdi‑prøvepunkt innenfor en `KeyframeSequence`. Lagrer tiden (i sekunder) og verdien på det tidspunktet.
`KeyframeSequence`	En ordnet liste over `KeyFrame` objekter for én skalar kanal, sammen med interpolasjons- og ekstrapoleringinnstillinger.
`Interpolation`	Opplisting av interpolasjonsmoduser mellom nøkkelrammer: `CONSTANT`, `LINEAR`, `BEZIER`, `B_SPLINE`, `CARDINAL_SPLINE`, `TCB_SPLINE`.
`ExtrapolationType`	Oppramsing av atferder utover den første og siste nøkkelrammen: `CONSTANT`, `GRADIENT`, `CYCLE`, `CYCLE_RELATIVE`, `OSCILLATE`.

Format I/U

Methods	Methods
`Scene.from_file(path)`	Statisk metode. Åpner filen på `path`, oppdager formatet fra filendelsen, og returnerer en populert `Scene`. Kaster ved fil‑ikke‑funnet eller ikke‑støttet format.
`Scene.open(path, options=None)`	Instansmetode. Åpner en fil inn i en eksisterende `Scene` instans, eventuelt ved bruk av en formatspesifikk `LoadOptions` underklasse.
`Scene.save(path, options=None)`	Instansmetode. Serialiserer scenen til `path` ved å bruke formatet som er avledet fra filendelsen, eventuelt ved bruk av en formatspesifikk `SaveOptions` underklasse.
`FileFormat`	Register over støttede filformater. Inneholder oppføringer som `FileFormat.WAVEFRONT_OBJ`, `FileFormat.GLTF`, `FileFormat.FBX7400ASCII`, `FileFormat.MICROSOFT_3MF`. Formatspesifikke varianter nås via alternativklasser (f.eks., `ColladaSaveOptions`, `GltfSaveOptions`).
`IOService`	Intern I/O-abstraksjon brukt av formatimportører og eksportører. Vanligvis ikke brukt direkte av applikasjonskode.
`LoadOptions`	Basisklasse for alle formatspesifikke lastingsalternativ‑objekter. Underklasse av `ObjLoadOptions`, `StlLoadOptions`, `GltfLoadOptions`, `FbxLoadOptions`, `ColladaLoadOptions`, `ThreeMfLoadOptions`.
`SaveOptions`	Basisklasse for alle formatspesifikke lagringsalternativ‑objekter. Underklasse av `ObjSaveOptions`, `StlSaveOptions`, `GltfSaveOptions`, `FbxSaveOptions`, `ColladaSaveOptions`, `ThreeMfSaveOptions`.

OBJ-format

Methods	Methods
`ObjImporter`	Intern importørklasse som parser Wavefront OBJ‑ og MTL‑filer. Kalles automatisk av `Scene.from_file()` for `.obj` filendelser.
`ObjLoadOptions`	Lastingsalternativer for Wavefront OBJ‑filer. Viktige egenskaper: `flip_coordinate_system`, `scale`, `enable_materials`, `normalize_normal`.
`ObjSaveOptions`	Lagre alternativer for Wavefront OBJ-utdata. Kontrollerer normaler, UV-er, materialreferanser og punkt‑sky-modus.
`ObjFormat`	Formatbeskrivelse for Wavefront OBJ. Tilgjengelig som `FileFormat.WAVEFRONT_OBJ()`.

STL-format

Methods	Methods
`StlImporter`	Intern importør som leser både binære og ASCII STL-filer. Velges automatisk etter filendelse.
`StlExporter`	Intern eksportør som skriver STL.
`StlLoadOptions`	Last inn-alternativer for STL-filer. Støtter `flip_coordinate_system` og `scale`.
`StlSaveOptions`	Lagringsalternativer for STL-utdata. Kontrollerer `binary_mode`, `scale`, og `flip_coordinate_system`.
`StlFormat`	Formatbeskrivelse for STL.

glTF-format

Methods	Methods
`GltfLoadOptions`	Last inn-alternativer for glTF 2.0- og GLB-filer. Nøkkel‑egenskap: `flip_tex_coord_v`.
`GltfSaveOptions`	Lagringsalternativer for glTF 2.0-utdata. Bruk `binary_mode=True` for en selvstendig GLB-pakke.
`GltfFormat`	Formatbeskrivelse for glTF 2.0 / GLB. Tilgjengelig som `FileFormat.GLTF2()`.

FBX-format

Methods	Methods
`FbxLoadOptions`	Last inn-alternativer for FBX-filer. Nøkkel‑egenskaper: `keep_builtin_global_settings`, `compatible_mode`.
`FbxSaveOptions`	Lagringsalternativer for FBX-utdata. FBX-eksport utløser `NotImplementedError` ubetinget; `FbxSaveOptions` eksisterer, men eksport er ikke implementert.
`FbxFormat`	Formatbeskrivelse for FBX. Tilgjengelig som `FileFormat.FBX7400ASCII()`.

COLLADA-format

Methods	Methods
`ColladaLoadOptions`	Last inn-alternativer for COLLADA (`.dae`) filer. Kontrollerer akse‑omkartlegging og enhetsskala ved import.
`ColladaSaveOptions`	Lagre alternativer for COLLADA‑utdata. Kontroller `indented`, `flip_coordinate_system`, og materialeksport.
`ColladaFormat`	Formatbeskrivelse for COLLADA. Løses automatisk fra `.dae` filendelse.

3MF Format

Methods	Methods
`ThreeMfLoadOptions`	Last inn alternativer for 3MF (`.3mf`) filer.
`ThreeMfSaveOptions`	Lagre alternativer for 3MF-utdata. 3MF er det foretrukne formatet for 3D‑utskriftsarbeidsflyter.
`ThreeMfFormat`	Formatbeskrivelse for 3MF. Tilgjengelig som `FileFormat.MICROSOFT_3MF_FORMAT()`.

Methods

Methods	Methods
`TextureMapping`	Identifiserer hvordan en tekstur er kartlagt til geometri: `DIFFUSE`, `SPECULAR`, `EMISSIVE`, `NORMAL`, `AMBIENT`, osv.
`BooleanOperation`	CSG boolsk operasjonstype: `UNION`, `DIFFERENCE`, `INTERSECTION`.

Egenskapssystem

Methods	Methods
`Property`	En enkelt navngitt typet egenskap på en `A3DObject`. Lagrer egenskapsnavnet, typebeskrivelsen og gjeldende verdi.
`PropertyCollection`	Itererbar samling av `Property` objekter festet til en `A3DObject`. Støtter oppslag etter navn og iterasjon over alle definerte egenskaper.
`CustomObject`	En lettvektig `A3DObject` underklasse som kun inneholder et navn og en vilkårlig `PropertyCollection`. Brukes til å lagre brukerdefinerte metadata på scenobjekter.

Bilde og gjengivelse

Methods	Methods
`ImageRenderOptions`	Alternativer for programvare‑rasterisering når en scene rendres til en bildbuffer. Lagrer bakgrunnsfarge, bildedimensjoner og kamerareferanse. `Scene.render()` kaster `NotImplementedError`; rendering er ikke implementert i denne utgivelsen.

Aspose.3D FOSS for Python

Kjerne Scengraf

Geometri og Mesh

Transformasjon og Romlig

Materialer og Skyggelegging

Kamera og Belysning

Matematikkverktøy

Methods

Format I/U

OBJ-format

STL-format

glTF-format

FBX-format

COLLADA-format

3MF Format

Methods

Egenskapssystem

Bilde og gjengivelse

Se også