Aspose.3D FOSS for Python

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

Semua kelas diimpor dari aspose.threed paket atau sub-paketnya. Impor rootnya adalah:

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

Grafik Adegan Inti

Methods	Methods
`Scene`	Kontainer tingkat atas untuk semua data adegan 3D. Menyimpan node akar, metadata aset, dan klip animasi. Mengekspos `from_file()`, `open()`, dan `save()` sebagai titik masuk I/O utama.
`Node`	Node bernama dalam hierarki adegan. Memiliki daftar node anak dan daftar objek yang terlampir `Entity` objek seperti mesh, kamera, dan lampu. Membawa lokal `Transform`.
`Entity`	Kelas dasar abstrak untuk semua objek yang dapat dilampirkan ke sebuah `Node`. Menyediakan nama dan identitas tetapi tidak memiliki geometri sendiri.
`SceneObject`	Kelas dasar yang dibagikan oleh `Node` dan `Entity`. Menyediakan antarmuka koleksi properti yang digunakan untuk metadata yang didefinisikan pengguna.
`A3DObject`	Kelas dasar utama untuk semua objek yang dikelola Aspose.3D. Menampilkan properti nama dan `Properties` koleksi.
`INamedObject`	Antarmuka yang menjamin sebuah `name` properti. Diimplementasikan oleh `Node`, `Entity`, dan beberapa tipe deskriptor spesifik format.

Geometri dan Mesh

Methods	Methods
`Mesh`	Entitas mesh poligon. Menyimpan titik kontrol (posisi vertex sebagai `Vector4`), daftar wajah poligon (daftar indeks titik kontrol), dan lapisan elemen vertex (normals, UVs, vertex colours).
`Geometry`	Basis abstrak untuk tipe geometri berbentuk mesh. Mendefinisikan array titik kontrol dan koleksi `VertexElement` lapisan. `Mesh` mewarisi dari `Geometry`.
`VertexElement`	Basis abstrak untuk lapisan data yang terlampir pada geometri (normals, UVs, colours, dll.). Membawa `mapping_mode`, `reference_mode`, dan sebuah `data` daftar.
`VertexElementNormal`	Menyimpan satu vektor normal per vertex atau per sudut poligon, tergantung pada `mapping_mode`. Nilai data adalah `FVector4` instances (single-precision) dengan `w` tidak terpakai.
`VertexElementUV`	Menyimpan data koordinat tekstur sebagai `FVector4` per vertex atau per sudut poligon (hanya `x` dan `y` komponen yang digunakan untuk UV). Sebuah mesh dapat membawa beberapa lapisan UV untuk saluran tekstur yang berbeda.
`VertexElementVertexColor`	Menyimpan data warna RGBA per-vertex atau per-corner sebagai `FVector4` (r, g, b, a dalam rentang 0–1).
`VertexElementSmoothingGroup`	Menyimpan ID integer grup smoothing group per-polygon, yang digunakan oleh pengimpor OBJ untuk mereproduksi penugasan grup smoothing group asli dari file sumber.
`VertexElementType`	Enumerasi yang mengidentifikasi peran semantik lapisan elemen vertex: `NORMAL`, `UV`, `VERTEX_COLOR`, `SMOOTHING_GROUP`, dan lainnya. Lewatkan nilai ke `Mesh.get_element()`.
`MappingMode`	Enumerasi yang mengontrol ke primitif mana nilai elemen vertex dipetakan: `CONTROL_POINT`, `POLYGON_VERTEX`, `POLYGON`, `EDGE`, atau `ALL_SAME`.
`ReferenceMode`	Enumerasi yang mengontrol bagaimana nilai diindeks: `DIRECT` (satu nilai per primitif pemetaan) atau `INDEX_TO_DIRECT` (array nilai plus array indeks terpisah).
`PolygonModifier`	Kelas utilitas statis dengan metode untuk melakukan triangulasi `Mesh` objek dan seluruh `Scene` graf.

Transformasi dan Spasial

Methods	Methods
`Transform`	Transformasi lokal yang terlampir pada sebuah `Node`. Menyediakan translasi, rotasi (sebagai `Quaternion`), dan komponen skala, serta properti kemudahan untuk sudut Euler.
`GlobalTransform`	Tampilan read-only dari transformasi ruang-dunia sebuah node setelah menggabungkan semua transformasi leluhur. Diakses melalui `Node.global_transform`.
`AssetInfo`	Blok metadata yang terlampir pada sebuah `Scene`. Menyimpan nama aplikasi authoring, nama unit, faktor skala unit, definisi sumbu sistem koordinat, serta cap waktu pembuatan/modifikasi.

Material dan Shading

Methods	Methods
`Material`	Kelas dasar abstrak untuk semua tipe material. Menyediakan nama dan koleksi properti untuk parameter numerik dan warna.
`LambertMaterial`	Model material hanya difus. Menyimpan warna ambient, warna difus, warna emisif, dan transparansi. Dimuat dari file OBJ yang menggunakan dasar `Ka`/`Kd`/`Ke` deklarasi.
`PhongMaterial`	Methods `LambertMaterial` dengan warna spekular dan kilap (eksponen spekular). Dimuat dari file OBJ yang menggunakan `Ks`/`Ns` deklarasi.
`PbrMaterial`	Material Physically Based Rendering. Menyimpan albedo, faktor metalik, faktor kekasaran, dan tekstur terkait. Digunakan oleh glTF 2.0 dan format lain yang mendukung PBR.

Kamera dan Pencahayaan

Methods	Methods
`Camera`	Entitas kamera. Hanya `projection_type` dan `name` berfungsi dalam edisi ini; semua properti numerik lainnya (`near_plane`, `far_plane`, `field_of_view`, `aspect_ratio`) adalah stub yang mengembalikan nilai default. Ditempelkan pada sebuah `Node` untuk mendefinisikan transformasi sudut pandang.
`Light`	Entitas sumber cahaya. Mewarisi dari `Camera` sebagai kelas stub; kelas `Light` itu sendiri tidak mengekspos properti tambahan dalam rilis ini.
`LightType`	Enumerasi kategori cahaya yang didukung: `POINT`, `DIRECTIONAL`, `SPOT`, `AREA`, `VOLUME`.
`ProjectionType`	Enumerasi mode proyeksi kamera: `PERSPECTIVE` dan `ORTHOGRAPHIC`.

Utilitas Matematika

Methods	Methods
`Vector2`	Vektor 2-komponen double-precision (`x`, `y`) . Digunakan untuk koordinat tekstur UV.
`Vector3`	Vektor 3-komponen double-precision (`x`, `y`, `z`) . Digunakan untuk posisi, arah, dan skala.
`Vector4`	Vektor 4-komponen double-precision (`x`, `y`, `z`, `w`). Digunakan untuk titik kontrol (posisi homogen) dan data normal.
`FVector2`	Vektor float 2-komponen single-precision. Digunakan secara internal untuk penyimpanan kompak dalam array data elemen vertex.
`FVector3`	Vektor float 3-komponen single-precision. Muncul dalam array data elemen vertex untuk normal dan tangen.
`FVector4`	Vektor float 4-komponen dengan presisi tunggal. Tipe penyimpanan dari `VertexElementFVector.data`.
`Quaternion`	Quaternion satuan untuk merepresentasikan rotasi (`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`	Bounding box yang sejajar sumbu didefinisikan oleh `minimum` dan `maximum` `Vector3` sudut. Digunakan untuk kueri spasial dan pembantu culling frustum.

Methods

Methods	Methods
`AnimationClip`	Kontainer bernama untuk sekumpulan saluran animasi yang mencakup satu rentang pemutaran. Sebuah `Scene` dapat menampung beberapa klip (mis., “Walk”, “Run”).
`AnimationNode`	Mengikat sebuah `AnimationClip` ke node atau properti scene tertentu. Berfungsi sebagai jembatan antara data klip dan objek grafik scene.
`AnimationChannel`	Sebuah aliran properti animasi tunggal dalam sebuah klip, menargetkan properti bernama pada sebuah objek (misalnya,., `Transform.translation.x`).
`KeyFrame`	Sebuah sampel waktu–nilai tunggal dalam sebuah `KeyframeSequence`. Menyimpan waktu (dalam detik) dan nilai pada waktu tersebut.
`KeyframeSequence`	Daftar terurut dari `KeyFrame` objek untuk satu saluran skalar, bersama dengan pengaturan interpolasi dan ekstrapolasi.
`Interpolation`	Enumerasi mode interpolasi antara keyframe: `CONSTANT`, `LINEAR`, `BEZIER`, `B_SPLINE`, `CARDINAL_SPLINE`, `TCB_SPLINE`.
`ExtrapolationType`	Enumerasi perilaku di luar keyframe pertama dan terakhir: `CONSTANT`, `GRADIENT`, `CYCLE`, `CYCLE_RELATIVE`, `OSCILLATE`.

Format I/O

Methods	Methods
`Scene.from_file(path)`	Metode statis. Membuka file di `path`, mendeteksi format dari ekstensi, dan mengembalikan objek yang terisi `Scene`. Menghasilkan error ketika file tidak ditemukan atau format tidak didukung.
`Scene.open(path, options=None)`	Metode instance. Membuka file ke dalam instance yang sudah ada `Scene` instance, secara opsional menggunakan subclass khusus format `LoadOptions` subclass.
`Scene.save(path, options=None)`	Metode instance. Menyerialkan scene ke `path` menggunakan format yang diinferrensi dari ekstensi, secara opsional menggunakan subclass khusus format `SaveOptions` subclass.
`FileFormat`	Registri format file yang didukung. Berisi entri seperti `FileFormat.WAVEFRONT_OBJ`, `FileFormat.GLTF`, `FileFormat.FBX7400ASCII`, `FileFormat.MICROSOFT_3MF`. Varian khusus format dapat diakses melalui kelas opsi (misalnya,., `ColladaSaveOptions`, `GltfSaveOptions`).
`IOService`	Abstraksi I/O internal yang digunakan oleh pengimpor dan pengekspor format. biasanya tidak digunakan secara langsung oleh kode aplikasi.
`LoadOptions`	Kelas dasar untuk semua objek opsi-muat khusus format. Di-subclass oleh `ObjLoadOptions`, `StlLoadOptions`, `GltfLoadOptions`, `FbxLoadOptions`, `ColladaLoadOptions`, `ThreeMfLoadOptions`.
`SaveOptions`	Kelas dasar untuk semua objek opsi-simpan khusus format. Di-subclass oleh `ObjSaveOptions`, `StlSaveOptions`, `GltfSaveOptions`, `FbxSaveOptions`, `ColladaSaveOptions`, `ThreeMfSaveOptions`.

Format OBJ

Methods	Methods
`ObjImporter`	Kelas pengimpor internal yang mengurai file Wavefront OBJ dan MTL. Dipanggil secara otomatis oleh `Scene.from_file()` untuk `.obj` ekstensi.
`ObjLoadOptions`	Opsi muat untuk file Wavefront OBJ. Properti utama: `flip_coordinate_system`, `scale`, `enable_materials`, `normalize_normal`.
`ObjSaveOptions`	Opsi penyimpanan untuk output Wavefront OBJ. Mengontrol normal, UV, referensi material, dan mode point-cloud.
`ObjFormat`	Deskripsi format untuk Wavefront OBJ. Dapat diakses sebagai `FileFormat.WAVEFRONT_OBJ()`.

Format STL

Methods	Methods
`StlImporter`	Pengimpor internal yang membaca file STL baik dalam format biner maupun ASCII. Dipilih secara otomatis berdasarkan ekstensi.
`StlExporter`	Ekspor internal yang menulis STL.
`StlLoadOptions`	Opsi muat untuk file STL. Mendukung `flip_coordinate_system` dan `scale`.
`StlSaveOptions`	Opsi simpan untuk output STL. Mengontrol `binary_mode`, `scale`, dan `flip_coordinate_system`.
`StlFormat`	Deskriptor format untuk STL.

Format glTF

Methods	Methods
`GltfLoadOptions`	Opsi muat untuk file glTF 2.0 dan GLB. Properti kunci: `flip_tex_coord_v`.
`GltfSaveOptions`	Opsi simpan untuk output glTF 2.0. Gunakan `binary_mode=True` untuk paket GLB yang berdiri sendiri.
`GltfFormat`	Deskriptor format untuk glTF 2.0 / GLB. Dapat diakses sebagai `FileFormat.GLTF2()`.

Format FBX

Methods	Methods
`FbxLoadOptions`	Opsi muat untuk file FBX. Properti kunci: `keep_builtin_global_settings`, `compatible_mode`.
`FbxSaveOptions`	Opsi simpan untuk output FBX. Ekspor FBX menghasilkan `NotImplementedError` tanpa syarat; `FbxSaveOptions` ada tetapi ekspor belum diimplementasikan.
`FbxFormat`	Deskriptor format untuk FBX. Dapat diakses sebagai `FileFormat.FBX7400ASCII()`.

Format COLLADA

Methods	Methods
`ColladaLoadOptions`	Opsi muat untuk file COLLADA (`.dae`) file. Mengontrol pemetaan ulang sumbu dan skala unit saat impor.
`ColladaSaveOptions`	Simpan opsi untuk output COLLADA. Kontrol `indented`, `flip_coordinate_system`, dan ekspor material.
`ColladaFormat`	Deskriptor format untuk COLLADA. Diselesaikan secara otomatis dari `.dae` ekstensi file.

3MF Format

Methods	Methods
`ThreeMfLoadOptions`	Muat opsi untuk 3MF (`.3mf`) file.
`ThreeMfSaveOptions`	Simpan opsi untuk output 3MF. 3MF adalah format yang disukai untuk alur kerja pencetakan 3D.
`ThreeMfFormat`	Deskriptor format untuk 3MF. Dapat diakses sebagai `FileFormat.MICROSOFT_3MF_FORMAT()`.

Methods

Methods	Methods
`TextureMapping`	Mengidentifikasi bagaimana tekstur dipetakan ke geometri: `DIFFUSE`, `SPECULAR`, `EMISSIVE`, `NORMAL`, `AMBIENT`, dll.
`BooleanOperation`	Tipe operasi Boolean CSG: `UNION`, `DIFFERENCE`, `INTERSECTION`.

Sistem Properti

Methods	Methods
`Property`	Sebuah properti bertipe bernama tunggal pada sebuah `A3DObject`. Menyimpan nama properti, deskripsi tipe, dan nilai saat ini.
`PropertyCollection`	Koleksi yang dapat diiterasi dari `Property` objek yang terlampir pada sebuah `A3DObject`. Mendukung pencarian berdasarkan nama dan iterasi atas semua properti yang didefinisikan.
`CustomObject`	Sebuah ringan `A3DObject` subkelas yang hanya memuat sebuah nama dan sebuah `PropertyCollection`. Digunakan untuk menyimpan metadata yang ditentukan pengguna pada objek scene.

Gambar dan Render

Methods	Methods
`ImageRenderOptions`	Opsi untuk rasterisasi perangkat lunak saat merender sebuah scene ke buffer gambar. Menyimpan warna latar belakang, dimensi gambar, dan referensi kamera. `Scene.render()` menimbulkan `NotImplementedError`; rendering belum diimplementasikan dalam rilis ini.

Aspose.3D FOSS for Python

Grafik Adegan Inti

Geometri dan Mesh

Transformasi dan Spasial

Material dan Shading

Kamera dan Pencahayaan

Utilitas Matematika

Methods

Format I/O

Format OBJ

Format STL

Format glTF

Format FBX

Format COLLADA

3MF Format

Methods

Sistem Properti

Gambar dan Render

Lihat Juga