Aspose.3D FOSS for Python

API-viite kohteelle aspose-3d-foss 26.1.0 (Python 3.7 – 3.12, MIT-lisenssi).

Kaikki luokat tuodaan aspose.threed paketista tai sen alipaketeista. Juuri‑tuonti on:

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

Ydin‑kohtausgrafiikka

Methods	Methods
`Scene`	Ylätason säiliö kaikille 3D‑kohtausdatalle. Sisältää juurisolmun, resurssin metatiedot ja animaatioleikkeet. Paljastaa `from_file()`, `open()`, ja `save()` ensisijaisina I/O‑sisääntulopisteinä.
`Node`	Nimetty solmu kohtaushierarkiassa. Omistaa luettelon alisolmuista ja liitettyjen `Entity` objekteja, kuten verkkoja, kameroita ja valoja. Sisältää paikallisen `Transform`.
`Entity`	Abstrakti perusluokka kaikille objekteille, jotka voidaan liittää `Node`. Tarjoaa nimen ja identiteetin, mutta ei omaa geometriaa.
`SceneObject`	Perusluokka, jota jakavat `Node` ja `Entity`. Tarjoaa ominaisuuskokoelman rajapinnan, jota käytetään käyttäjän määrittelemään metatietoon.
`A3DObject`	Juuri‑perusluokka kaikille Aspose.3D‑hallinnoiduille objekteille. Paljastaa nimen ominaisuuden ja the `Properties` kokoelma.
`INamedObject`	Rajapinta, joka takaa `name` ominaisuus. Toteutettu `Node`, `Entity`, ja useita formaattiin perustuvia kuvaustyyppejä.

Geometria ja verkko

Methods	Methods
`Mesh`	Polygoniverkon entiteetti. Tallentaa ohjauspisteet (solmupisteet muodossa `Vector4`), polygonin kasvojen listat (ohjauspisteindeksien listat) ja solmu‑elementtikerrokset (normaalit, UV:t, solmujen värit).
`Geometry`	Abstrakti perusluokka verkkomaisille geometrioille. Määrittelee ohjauspiste‑taulukon ja kokoelman `VertexElement` kerroksia. `Mesh` perii luokasta `Geometry`.
`VertexElement`	Abstrakti perusluokka geometriassa kiinnitetylle datakerrokselle (normaalit, UV:t, värit jne.). Sisältää `mapping_mode`, `reference_mode`, ja `data` lista.
`VertexElementNormal`	Tallentaa yhden normaalivektorin per solmu tai per polygonin kulma, riippuen `mapping_mode`. Datarvot ovat `FVector4` instansseja (yksinkertaisella tarkkuudella), joissa on `w` käyttämättömiä.
`VertexElementUV`	Tallentaa tekstuurikoordinaattidataa muodossa `FVector4` per solmu tai per polygonin kulma (vain `x` ja `y` komponentteja käytetään UV:lle). Verkko voi sisältää useita UV‑kerroksia eri tekstuurikanaville.
`VertexElementVertexColor`	Tallentaa per-vertex- tai per-corner- RGBA-väridataa muodossa `FVector4` (r, g, b, a välillä 0–1).
`VertexElementSmoothingGroup`	Tallentaa per-polygon- tasoitusryhmän kokonaislukutunnisteet, joita OBJ-tuonti käyttää alkuperäisten tasoitusryhmän määritysten toistamiseen lähdetiedostosta.
`VertexElementType`	Luettelo, joka tunnistaa vertex-elementin kerroksen semanttisen roolin: `NORMAL`, `UV`, `VERTEX_COLOR`, `SMOOTHING_GROUP`, ja muita. Välitä arvot kohteeseen `Mesh.get_element()`.
`MappingMode`	Luettelo, joka hallitsee, mihin primitiiviin vertex-elementin arvo kartoitetaan: `CONTROL_POINT`, `POLYGON_VERTEX`, `POLYGON`, `EDGE`, tai `ALL_SAME`.
`ReferenceMode`	Luettelo, joka hallitsee, miten arvot indeksoidaan: `DIRECT` (yksi arvo per kartoitusprimitiivi) tai `INDEX_TO_DIRECT` (arvot-taulukko plus erillinen indeksitaulukko).
`PolygonModifier`	Staattinen apuluokka, jossa on menetelmiä kolmiointiin `Mesh` objekteja ja koko `Scene` graafeja.

Transformaatio ja avaruus

Methods	Methods
`Transform`	Paikallinen muunnos, joka on liitetty kohteeseen `Node`. Tarjoaa siirtymän, kierron (kuten `Quaternion`), ja skaalauskomponentit, sekä kätevät ominaisuudet Euler-kulmille.
`GlobalTransform`	Vain luku -näkymä solmun maailmanavaruuden muunnoksesta, kun kaikki vanhempien muunnokset on yhdistetty. Käytettävissä kautta `Node.global_transform`.
`AssetInfo`	Metatietolohko, joka on liitetty kohteeseen `Scene`. Tallentaa tekijäohjelman nimen, yksikön nimen, yksikön skaalauskerroin, koordinaatistojärjestelmän akselien määritelmät sekä luonti-/muokkausaikaleimat.

Materiaalit ja varjostus

Methods	Methods
`Material`	Abstrakti perusluokka kaikille materiaalityypeille. Tarjoaa nimen ja ominaisuuskokoelman numeerisille ja väri‑parametreille.
`LambertMaterial`	Vain hajautusmateriaalimalli. Tallentaa ambienttivärin, hajautusvärin, säteilyvärin ja läpinäkyvyyden. Ladataan OBJ‑tiedostoista, jotka käyttävät perus `Ka`/`Kd`/`Ke` määrittelyjä.
`PhongMaterial`	Methods `LambertMaterial` spesulaarivärin ja kiiltoisuuden (spesulaarinen eksponentti) kanssa. Ladataan OBJ‑tiedostoista, jotka käyttävät `Ks`/`Ns` määrittelyjä.
`PbrMaterial`	Fysiikassa perustuva renderöintimateriaali. Tallentaa albedon, metallisuuden tekijän, karheuden tekijän ja niihin liittyvät tekstuurit. Käytetään glTF 2.0:ssa ja muissa PBR-yhteensopivissa formaateissa.

Kamera ja valaistus

Methods	Methods
`Camera`	Kameraentiteetti. Vain `projection_type` ja `name` ovat toiminnallisia tässä versiossa; kaikki muut numeeriset ominaisuudet (`near_plane`, `far_plane`, `field_of_view`, `aspect_ratio`) ovat testirakenteita, jotka palauttavat oletusarvot. Liitetty `Node` määrittelemään näkökulman muunnokset.
`Light`	Valonlähdeentiteetti. Perii `Camera` testiluokkana; `Light` luokka itsessään ei paljasta lisäominaisuuksia tässä julkaisussa.
`LightType`	Luettelo tuetuista valokategorioista: `POINT`, `DIRECTIONAL`, `SPOT`, `AREA`, `VOLUME`.
`ProjectionType`	Luettelo kameran projektiotiloista: `PERSPECTIVE` ja `ORTHOGRAPHIC`.

Matematiikkatyökalut

Methods	Methods
`Vector2`	Kaksoistarkkuuden 2-komponenttinen vektori (`x`, `y`).
`Vector3`	Kaksoistarkkuuden 3-komponenttinen vektori (`x`, `y`, `z`).
`Vector4`	Kaksoistarkkuinen 4-komponenttinen vektori (`x`, `y`, `z`, `w`). Käytetään ohjauspisteisiin (homogeeniset sijainnit) ja normaalidataan.
`FVector2`	Yksittäistarkkuinen 2-komponenttinen float-vektori. Käytetään sisäisesti tiiviiseen tallennukseen vertex-elementtien data-taulukoissa.
`FVector3`	Yksittäistarkkuinen 3-komponenttinen float-vektori. Esiintyy vertex-elementtien data-taulukoissa normaalien ja tangenttien osalta.
`FVector4`	Yhden tarkkuuden 4-komponenttinen float-vektori. Tallennustyyppi `VertexElementFVector.data`.
`Quaternion`	Yksikkökvaternion kiertojen esittämiseen (`w`, `x`, `y`, `z`). Käytetään `Transform.rotation`.
`Matrix4`	4×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
`BoundingBox`	Akselien suuntaama rajaava laatikko, jonka määrittävät `minimum` ja `maximum` `Vector3` kulmat. Käytetään spatiaalisiin kyselyihin ja näkökentän leikkausapureihin.

Methods

Methods	Methods
`AnimationClip`	Nimetty säiliö joukolle animoituja kanavia, jotka kattavat yhden toistovälin. A `Scene` voi sisältää useita leikkeitä (esim. “Walk”, “Run”).
`AnimationNode`	Sidoo `AnimationClip` tiettyyn kohtaussolmuun tai ominaisuuteen. Toimii sillan tavoin leikkedata ja kohtausgraafin objektien välillä.
`AnimationChannel`	Yksi animoitu ominaisuusvirta leikkeen sisällä, kohdistettuna nimettyyn ominaisuuteen objektissa (esim., `Transform.translation.x`).
`KeyFrame`	Yksi aika‑arvo‑näyte `KeyframeSequence`. Tallentaa ajan (sekunteina) ja arvon kyseisessä ajassa.
`KeyframeSequence`	Järjestetty luettelo `KeyFrame` objekteja yhdelle skalaarikanavalle, sekä interpolointi- ja ekstrapolointiasetukset.
`Interpolation`	Luettelo interpolointitiloista avainruutujen välillä: `CONSTANT`, `LINEAR`, `BEZIER`, `B_SPLINE`, `CARDINAL_SPLINE`, `TCB_SPLINE`.
`ExtrapolationType`	Luettelo käyttäytymisistä ensimmäisen ja viimeisen avainkehyksen ulkopuolella: `CONSTANT`, `GRADIENT`, `CYCLE`, `CYCLE_RELATIVE`, `OSCILLATE`.

Formaatti I/O

Methods	Methods
`Scene.from_file(path)`	Staattinen metodi. Avaa tiedoston osoitteessa `path`, havaitsee muodon tiedostopäätteestä ja palauttaa täytetyn `Scene`. Nostaa poikkeuksen, jos tiedostoa ei löydy tai formaatti ei ole tuettu.
`Scene.open(path, options=None)`	Instanssimetodi. Avaa tiedoston olemassa olevaan `Scene` instanssiin, valinnaisesti käyttäen formaattikohtaista `LoadOptions` aliluokkaa.
`Scene.save(path, options=None)`	Instanssimetodi. Sarjoittaa kohtauksen kohteeseen `path` käyttäen tiedostopäätteestä pääteltyä formaattia, valinnaisesti käyttäen formaattikohtaista `SaveOptions` aliluokkaa.
`FileFormat`	Tuettujen tiedostomuotojen rekisteri. Sisältää merkintöjä kuten `FileFormat.WAVEFRONT_OBJ`, `FileFormat.GLTF`, `FileFormat.FBX7400ASCII`, `FileFormat.MICROSOFT_3MF`. Formaattikohtaisia variantteja haetaan vaihtoehtoluokkien kautta (esim., `ColladaSaveOptions`, `GltfSaveOptions`).
`IOService`	Sisäinen I/O-abstraktio, jota formaattien tuonti- ja vientitoiminnot käyttävät. Ei yleensä käytetä suoraan sovelluskoodissa.
`LoadOptions`	Perusluokka kaikille formaattikohtaisille latausvaihtoehto-objekteille. Aliluokkana toimii `ObjLoadOptions`, `StlLoadOptions`, `GltfLoadOptions`, `FbxLoadOptions`, `ColladaLoadOptions`, `ThreeMfLoadOptions`.
`SaveOptions`	Perusluokka kaikille formaattikohtaisille tallennusvaihtoehto-objekteille. Aliluokkana toimii `ObjSaveOptions`, `StlSaveOptions`, `GltfSaveOptions`, `FbxSaveOptions`, `ColladaSaveOptions`, `ThreeMfSaveOptions`.

OBJ-muoto

Methods	Methods
`ObjImporter`	Sisäinen tuontiluokka, joka jäsentää Wavefront OBJ- ja MTL-tiedostoja. Kutsutaan automaattisesti `Scene.from_file()` kohteelle `.obj` tiedostopäätteet.
`ObjLoadOptions`	Latausvaihtoehdot Wavefront OBJ -tiedostoille. Keskeiset ominaisuudet: `flip_coordinate_system`, `scale`, `enable_materials`, `normalize_normal`.
`ObjSaveOptions`	Tallenna asetukset Wavefront OBJ -tulosteelle. Säätää normaalit, UV-koordinaatit, materiaaliviitteet ja pistepilvimoodin.
`ObjFormat`	Muodon kuvaus Wavefront OBJ:lle. Käytettävissä muodossa `FileFormat.WAVEFRONT_OBJ()`.

STL-muoto

Methods	Methods
`StlImporter`	Sisäinen tuonti, joka lukee sekä binaari- että ASCII STL -tiedostoja. Valitaan automaattisesti tiedostopäätteen perusteella.
`StlExporter`	Sisäinen vienti, joka kirjoittaa STL:n.
`StlLoadOptions`	Lataa asetukset STL-tiedostoille. Tukee `flip_coordinate_system` ja `scale`.
`StlSaveOptions`	Tallennusasetukset STL-tulosteelle. Ohjaa `binary_mode`, `scale`, ja `flip_coordinate_system`.
`StlFormat`	Formaattikuvaus STL:lle.

glTF-muoto

Methods	Methods
`GltfLoadOptions`	Lataa asetukset glTF 2.0- ja GLB-tiedostoille. Keskeinen ominaisuus: `flip_tex_coord_v`.
`GltfSaveOptions`	Tallennusasetukset glTF 2.0 -tulosteelle. Käytä `binary_mode=True` saadaksesi itsenäisen GLB-paketin.
`GltfFormat`	Formaattikuvaus glTF 2.0 / GLB:lle. Saatavilla nimellä `FileFormat.GLTF2()`.

FBX-muoto

Methods	Methods
`FbxLoadOptions`	Lataa asetukset FBX-tiedostoille. Keskeiset ominaisuudet: `keep_builtin_global_settings`, `compatible_mode`.
`FbxSaveOptions`	Tallennusasetukset FBX-tulosteelle. FBX-vienti aiheuttaa `NotImplementedError` ehdottomasti; `FbxSaveOptions` on olemassa, mutta vientiä ei ole toteutettu.
`FbxFormat`	Formaattikuvaus FBX:lle. Saatavilla nimellä `FileFormat.FBX7400ASCII()`.

COLLADA-muoto

Methods	Methods
`ColladaLoadOptions`	Lataa asetukset COLLADA (`.dae`) tiedostoille. Ohjaa akselien uudelleenmääritystä ja yksikön skaalaa tuonnissa.
`ColladaSaveOptions`	Tallenna asetukset COLLADA-tulosteelle. Ohjaimet `indented`, `flip_coordinate_system`, ja materiaalin vienti.
`ColladaFormat`	Muodon kuvaus COLLADA:lle. Ratkaistaan automaattisesti tiedostopäätteestä `.dae` tiedostopääte.

3MF Format

Methods	Methods
`ThreeMfLoadOptions`	Lataa asetukset 3MF (`.3mf`) tiedostoille.
`ThreeMfSaveOptions`	Tallenna asetukset 3MF-tulosteelle. 3MF on suositeltu formaatti 3D-tulostustyönkulkuja varten.
`ThreeMfFormat`	Muotoilukuvaus 3MF:lle. Käytettävissä muodossa `FileFormat.MICROSOFT_3MF_FORMAT()`.

Methods

Methods	Methods
`TextureMapping`	Määrittää, miten tekstuuri kartoitetaan geometriaan: `DIFFUSE`, `SPECULAR`, `EMISSIVE`, `NORMAL`, `AMBIENT`, jne.
`BooleanOperation`	CSG Boolean-operaatiotyypi: `UNION`, `DIFFERENCE`, `INTERSECTION`.

Ominaisuuksien järjestelmä

Methods	Methods
`Property`	Yksittäinen nimetty tyyppinen ominaisuus kohteessa `A3DObject`. Tallentaa ominaisuuden nimen, tyyppikuvauksen ja nykyisen arvon.
`PropertyCollection`	Iteroitava kokoelma `Property` objekteja, jotka on liitetty kohteeseen `A3DObject`. Tukee hakua nimen perusteella ja iterointia kaikkien määriteltyjen ominaisuuksien yli.
`CustomObject`	Kevyt `A3DObject` aliluokka, joka sisältää vain nimen ja mielivaltaisen `PropertyCollection`. Käytetään käyttäjän määrittelemän metatiedon tallentamiseen kohtausobjekteihin.

Kuva ja renderöinti

Methods	Methods
`ImageRenderOptions`	Asetukset ohjelmistorasteroinnille, kun renderöidään kohtaus kuvatyppiseen puskurin. Tallentaa taustavärin, kuvan mitat ja kameraviitteen. `Scene.render()` nostaa `NotImplementedError`; renderöintiä ei ole toteutettu tässä julkaisussa.

Aspose.3D FOSS for Python

Ydin‑kohtausgrafiikka

Geometria ja verkko

Transformaatio ja avaruus

Materiaalit ja varjostus

Kamera ja valaistus

Matematiikkatyökalut

Methods

Formaatti I/O

OBJ-muoto

STL-muoto

glTF-muoto

FBX-muoto

COLLADA-muoto

3MF Format

Methods

Ominaisuuksien järjestelmä

Kuva ja renderöinti

Katso myös