Aspose.3D FOSS for Python

Rujukan API untuk aspose-3d-foss 26.1.0 (Python 3.7 – 3.12, lesen MIT).

Semua kelas diimport dari aspose.threed pakej atau sub-pakejnya. Import utama ialah:

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

Graf Adegan Teras

Enumerations	Enumerations
`Scene`	Bekas peringkat atas untuk semua data adegan 3D. Menyimpan nod akar, metadata aset, dan klip animasi. Mendedahkan `from_file()`, `open()`, dan `save()` sebagai titik masuk I/O utama.
`Node`	Nod bernama dalam hierarki adegan. Mempunyai senarai nod anak dan senarai yang dilampirkan `Entity` objek seperti mesh, kamera, dan lampu. Membawa satu set tempatan `Transform`.
`Entity`	Kelas asas abstrak untuk semua objek yang boleh dilampirkan kepada `Node`. Menyediakan nama dan identiti tetapi tiada geometri sendiri.
`SceneObject`	Kelas asas yang dikongsi oleh `Node` dan `Entity`. Menyediakan antara muka koleksi sifat yang digunakan untuk metadata yang ditakrifkan pengguna.
`A3DObject`	Kelas asas akar untuk semua objek terurus Aspose.3D. Mendedahkan sifat nama dan `Properties` koleksi.
`INamedObject`	Antara muka yang menjamin satu `name` sifat. Dilaksanakan oleh `Node`, `Entity`, dan beberapa jenis deskriptor khusus format.

Geometri dan Mesh

Enumerations	Enumerations
`Mesh`	Entiti mesh poligon. Menyimpan titik kawalan (posisi verteks sebagai `Vector4`), senarai muka poligon (senarai indeks titik kawalan), dan lapisan elemen verteks (normal, UVs, warna verteks).
`Geometry`	Asas abstrak untuk jenis geometri seperti mesh. Menentukan tatasusunan titik kawalan dan koleksi `VertexElement` lapisan. `Mesh` mewarisi dari `Geometry`.
`VertexElement`	Asas abstrak untuk lapisan data yang dilampirkan pada geometri (normal, UVs, warna, dll.). Membawa `mapping_mode`, `reference_mode`, dan satu `data` senarai.
`VertexElementNormal`	Menyimpan satu vektor normal per verteks atau per sudut poligon, bergantung pada `mapping_mode`. Nilai data adalah `FVector4` contoh (presisi tunggal) dengan `w` tidak digunakan.
`VertexElementUV`	Menyimpan data koordinat tekstur sebagai `FVector4` per verteks atau per sudut poligon (hanya `x` dan `y` komponen yang digunakan untuk UV). Sebuah mesh boleh membawa pelbagai lapisan UV untuk saluran tekstur yang berbeza.
`VertexElementVertexColor`	Menyimpan data warna RGBA per-vertex atau per-corner sebagai `FVector4` (r, g, b, a dalam julat 0–1).
`VertexElementSmoothingGroup`	Menyimpan ID integer kumpulan pelicinan per-polygon, yang digunakan oleh pengimport OBJ untuk menghasilkan semula penetapan kumpulan pelicinan asal dari fail sumber.
`VertexElementType`	Enumerasi yang mengenal pasti peranan semantik lapisan elemen vertex: `NORMAL`, `UV`, `VERTEX_COLOR`, `SMOOTHING_GROUP`, dan lain-lain. Hantar nilai kepada `Mesh.get_element()`.
`MappingMode`	Enumerasi yang mengawal ke primitif mana nilai elemen verteks dipetakan kepada: `CONTROL_POINT`, `POLYGON_VERTEX`, `POLYGON`, `EDGE`, atau `ALL_SAME`.
`ReferenceMode`	Enumerasi yang mengawal bagaimana nilai diindeks: `DIRECT` (satu nilai per primitif pemetaan) atau `INDEX_TO_DIRECT` (array nilai ditambah array indeks berasingan).
`PolygonModifier`	Kelas utiliti statik dengan kaedah untuk mentriangulasi `Mesh` objek dan keseluruhan `Scene` graf.

Transform dan Spatial

Enumerations	Enumerations
`Transform`	Transformasi setempat yang dilampirkan kepada `Node`. Menyediakan terjemahan, putaran (sebagai `Quaternion`), dan komponen skala, serta sifat kemudahan untuk sudut Euler.
`GlobalTransform`	Paparan baca-sahaja bagi transformasi ruang-dunia nod selepas menyusun semua transformasi nenek moyang. Diakses melalui `Node.global_transform`.
`AssetInfo`	Blok metadata yang dilampirkan kepada `Scene`. Menyimpan nama aplikasi pengarang, nama unit, faktor skala unit, definisi paksi sistem koordinat, serta cap masa penciptaan/pengubahsuaian.

Bahan dan Shading

Enumerations	Enumerations
`Material`	Kelas asas abstrak untuk semua jenis bahan. Menyediakan nama dan koleksi sifat untuk parameter berangka dan warna.
`LambertMaterial`	Model bahan hanya difus. Menyimpan warna ambient, warna difus, warna emisif, dan ketelusan. Dimuatkan dari fail OBJ yang menggunakan asas `Ka`/`Kd`/`Ke` pengisytiharan.
`PhongMaterial`	Enumerations `LambertMaterial` dengan warna spekular dan kilauan (eksponen spekular). Dimuatkan dari fail OBJ yang menggunakan `Ks`/`Ns` pengisytiharan.
`PbrMaterial`	Bahan Physically Based Rendering. Menyimpan albedo, faktor logam, faktor kekasaran, dan tekstur yang berkaitan. Digunakan oleh glTF 2.0 dan format lain yang menyokong PBR.

Kamera dan Pencahayaan

Enumerations	Enumerations
`Camera`	Entiti kamera. Hanya `projection_type` dan `name` berfungsi dalam edisi ini; semua sifat numerik lain (`near_plane`, `far_plane`, `field_of_view`, `aspect_ratio`) adalah stub yang mengembalikan nilai lalai. Dilampirkan kepada satu `Node` untuk menentukan transformasi pandangan.
`Light`	Entiti sumber cahaya. Mewarisi dari `Camera` sebagai kelas stub; `Light` kelas itu sendiri tidak mendedahkan sifat tambahan dalam keluaran ini.
`LightType`	Enumerasi kategori cahaya yang disokong: `POINT`, `DIRECTIONAL`, `SPOT`, `AREA`, `VOLUME`.
`ProjectionType`	Enumerasi mod proyeksi kamera: `PERSPECTIVE` dan `ORTHOGRAPHIC`.

Utiliti Matematik

Enumerations	Enumerations
`Vector2`	Vektor 2-komponen berpresisi berganda (`x`, `y`). Digunakan untuk koordinat tekstur UV.
`Vector3`	Vektor 3-komponen berpresisi berganda (`x`, `y`, `z`). Digunakan untuk kedudukan, arah, dan skala.
`Vector4`	Vektor 4-komponen berpresisi berganda (`x`, `y`, `z`, `w`). Digunakan untuk titik kawalan (kedudukan homogen) dan data normal.
`FVector2`	Vektor float 2-komponen berpresisi tunggal. Digunakan secara dalaman untuk penyimpanan mampat dalam tatasusunan data unsur verteks.
`FVector3`	Vektor float 3-komponen berpresisi tunggal. Muncul dalam tatasusunan data unsur verteks untuk normal dan tangen.
`FVector4`	Vektor titik apung 4-komponen dengan ketepatan tunggal. Jenis penyimpanan bagi `VertexElementFVector.data`.
`Quaternion`	Quaternion unit untuk mewakili putaran (`w`, `x`, `y`, `z`). Digunakan oleh `Transform.rotation`.
`Matrix4`	4×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
`BoundingBox`	Kotak sempadan selari paksi yang ditakrifkan oleh `minimum` dan `maximum` `Vector3` sudut. Digunakan untuk pertanyaan spasial dan pembantu pemangkasan frustum.

Enumerations

Enumerations	Enumerations
`AnimationClip`	Bekas bernama untuk satu set saluran animasi yang meliputi satu julat main semula. Sebuah `Scene` boleh memegang berbilang klip (contoh, “Walk”, “Run”).
`AnimationNode`	Mengikat satu `AnimationClip` kepada nod adegan atau sifat tertentu. Bertindak sebagai jambatan antara data klip dan objek graf adegan.
`AnimationChannel`	Satu aliran sifat animasi tunggal dalam klip, menyasarkan sifat bernama pada objek (contoh,., `Transform.translation.x`).
`KeyFrame`	Satu contoh masa–nilai tunggal dalam `KeyframeSequence`. Menyimpan masa (dalam saat) dan nilai pada masa tersebut.
`KeyframeSequence`	Senarai teratur bagi `KeyFrame` objek untuk satu saluran skalar, bersama dengan tetapan interpolasi dan ekstrapolasi.
`Interpolation`	Enumerasi mod interpolasi antara bingkai kunci: `CONSTANT`, `LINEAR`, `BEZIER`, `B_SPLINE`, `CARDINAL_SPLINE`, `TCB_SPLINE`.
`ExtrapolationType`	Enumerasi tingkah laku di luar bingkai kunci pertama dan terakhir: `CONSTANT`, `GRADIENT`, `CYCLE`, `CYCLE_RELATIVE`, `OSCILLATE`.

Format I/O

Enumerations	Enumerations
`Scene.from_file(path)`	Kaedah statik. Membuka fail pada `path`, mengesan format daripada sambungan, dan mengembalikan yang telah diisi `Scene`. Menaikkan pengecualian apabila fail tidak ditemui atau format tidak disokong.
`Scene.open(path, options=None)`	Kaedah contoh. Membuka fail ke dalam contoh yang sedia ada `Scene` contoh, secara pilihan menggunakan format khusus `LoadOptions` subkelas.
`Scene.save(path, options=None)`	Kaedah contoh. Menserialisasikan adegan ke `path` menggunakan format yang disimpulkan daripada sambungan, secara pilihan menggunakan format khusus `SaveOptions` subkelas.
`FileFormat`	Daftar format fail yang disokong. Mengandungi entri seperti `FileFormat.WAVEFRONT_OBJ`, `FileFormat.GLTF`, `FileFormat.FBX7400ASCII`, `FileFormat.MICROSOFT_3MF`. Varian khusus format diakses melalui kelas pilihan (contohnya,., `ColladaSaveOptions`, `GltfSaveOptions`).
`IOService`	Abstraksi I/O dalaman yang digunakan oleh pengimport dan pengeksport format. Tidak biasanya digunakan secara langsung oleh kod aplikasi.
`LoadOptions`	Kelas asas untuk semua objek pilihan‑muat format khusus. Disubkelaskan oleh `ObjLoadOptions`, `StlLoadOptions`, `GltfLoadOptions`, `FbxLoadOptions`, `ColladaLoadOptions`, `ThreeMfLoadOptions`.
`SaveOptions`	Kelas asas untuk semua objek pilihan‑simpan format khusus. Disubkelaskan oleh `ObjSaveOptions`, `StlSaveOptions`, `GltfSaveOptions`, `FbxSaveOptions`, `ColladaSaveOptions`, `ThreeMfSaveOptions`.

Format OBJ

Enumerations	Enumerations
`ObjImporter`	Kelas pengimport dalaman yang menghurai fail Wavefront OBJ dan MTL. Dipanggil secara automatik oleh `Scene.from_file()` untuk `.obj` sambungan.
`ObjLoadOptions`	Pilihan muat untuk fail Wavefront OBJ. Sifat utama: `flip_coordinate_system`, `scale`, `enable_materials`, `normalize_normal`.
`ObjSaveOptions`	Simpan pilihan untuk output Wavefront OBJ. Mengawal normal, UV, rujukan bahan, dan mod awan titik.
`ObjFormat`	Penerangan format untuk Wavefront OBJ. Boleh diakses sebagai `FileFormat.WAVEFRONT_OBJ()`.

Format STL

Enumerations	Enumerations
`StlImporter`	Pengimport dalaman yang membaca kedua-dua fail STL binari dan ASCII. Dipilih secara automatik mengikut sambungan.
`StlExporter`	Pengeksport dalaman yang menulis STL.
`StlLoadOptions`	Pilihan muat untuk fail STL. Menyokong `flip_coordinate_system` dan `scale`.
`StlSaveOptions`	Pilihan simpan untuk output STL. Mengawal `binary_mode`, `scale`, dan `flip_coordinate_system`.
`StlFormat`	Penerangan format untuk STL.

Format glTF

Enumerations	Enumerations
`GltfLoadOptions`	Pilihan muat untuk fail glTF 2.0 dan GLB. Sifat utama: `flip_tex_coord_v`.
`GltfSaveOptions`	Pilihan simpan untuk output glTF 2.0. Gunakan `binary_mode=True` untuk pakej GLB yang berdiri sendiri.
`GltfFormat`	Penerangan format untuk glTF 2.0 / GLB. Boleh diakses sebagai `FileFormat.GLTF2()`.

Format FBX

Enumerations	Enumerations
`FbxLoadOptions`	Pilihan muat untuk fail FBX. Sifat utama: `keep_builtin_global_settings`, `compatible_mode`.
`FbxSaveOptions`	Pilihan simpan untuk output FBX. Mengawal pemampatan, penyematan tekstur, dan sifat bahan.
`FbxFormat`	Penerangan format untuk FBX. Boleh diakses sebagai `FileFormat.FBX7400ASCII()`.

Format COLLADA

Enumerations	Enumerations
`ColladaLoadOptions`	Pilihan muat untuk COLLADA (`.dae`) fail. Mengawal pemetaan semula paksi dan skala unit semasa import.
`ColladaSaveOptions`	Pilihan simpan untuk output COLLADA. Mengawal `indented`, `flip_coordinate_system`, dan eksport bahan.
`ColladaFormat`	Penerangan format untuk COLLADA. Diselesaikan secara automatik daripada `.dae` sambungan fail.

3MF Format

Enumerations	Enumerations
`ThreeMfLoadOptions`	Pilihan muat untuk 3MF (`.3mf`) fail.
`ThreeMfSaveOptions`	Opsyen simpan untuk output 3MF. 3MF adalah format pilihan untuk aliran kerja percetakan 3D.
`ThreeMfFormat`	Penerangan format untuk 3MF. Boleh diakses sebagai `FileFormat.MICROSOFT_3MF_FORMAT()`.

Enumerations

Enumerations	Enumerations
`TextureMapping`	Mengenal pasti bagaimana tekstur dipetakan ke geometri: `DIFFUSE`, `SPECULAR`, `EMISSIVE`, `NORMAL`, `AMBIENT`, dll.
`BooleanOperation`	Jenis operasi Boolean CSG: `UNION`, `DIFFERENCE`, `INTERSECTION`.

Sistem Sifat

Enumerations	Enumerations
`Property`	Satu sifat berjenis bernama pada `A3DObject`. Menyimpan nama sifat, penerangan jenis, dan nilai semasa.
`PropertyCollection`	Koleksi boleh diiterasi `Property` objek yang dilampirkan kepada `A3DObject`. Menyokong carian mengikut nama dan iterasi ke atas semua sifat yang ditakrifkan.
`CustomObject`	Ringan `A3DObject` subkelas yang hanya membawa nama dan satu nilai sewenang-wenangnya `PropertyCollection`. Digunakan untuk menyimpan metadata yang ditakrifkan pengguna pada objek adegan.

Imej dan Render

Enumerations	Enumerations
`ImageRenderOptions`	Pilihan untuk rasterisasi perisian semasa merender adegan ke dalam penampan imej. Menyimpan warna latar belakang, dimensi imej, dan rujukan kamera. Ciri ini tersedia dalam konfigurasi yang disokong.

Aspose.3D FOSS for Python

Graf Adegan Teras

Geometri dan Mesh

Transform dan Spatial

Bahan dan Shading

Kamera dan Pencahayaan

Utiliti Matematik

Enumerations

Format I/O

Format OBJ

Format STL

Format glTF

Format FBX

Format COLLADA

3MF Format

Enumerations

Sistem Sifat

Imej dan Render

Lihat Juga