Referensi API untuk aspose-3d-foss 26.1.0 (Java 21+, lisensi MIT).
Semua kelas berada di com.aspose.threed paket root. Impor rootnya adalah:
Tata letak paket: Hampir semua kelas publik berada di com.aspose.threed. Satu-satunya sub-paket yang biasanya digunakan adalah com.aspose.threed.shading (untuk PbrMaterial). Sub-paket com.aspose.threed.formats berisi importir/pengekspor internal dan biasanya tidak diimpor secara langsung.
konvensi penamaan Java: Semua properti menggunakan metode getter/setter. Misalnya, gunakan node.getTransform() alih-alih node.transform, dan transform.setTranslation(...) alih-alih transform.translation = .... Perhatikan bahwa Vector3, Vector4, Quaternion, Matrix4, dan FVector tipe menggunakan bidang publik (v.x, v.y, v.z) daripada getter untuk mengakses komponen.
Grafik Adegan Inti
| Enumerations | Enumerations |
|---|
Scene | Kontainer tingkat atas untuk semua data adegan 3D. Menyimpan node akar, metadata aset, dan klip animasi. Mengekspos fromFile(), open(), dan save() sebagai titik masuk I/O utama. |
Node | Node bernama dalam hierarki adegan. Memiliki daftar node anak dan daftar yang terlampir Entity objek seperti mesh, kamera, dan lampu. Membawa sebuah 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 dibagi oleh Node dan Entity. |
A3DObject | Kelas dasar akar untuk semua objek yang dikelola Aspose.3D. Mengekspos properti nama dan Properties koleksi. |
INamedObject | Antarmuka yang menjamin sebuah getName() metode. Diimplementasikan oleh Node, Entity, dan beberapa tipe deskriptor spesifik format. |
Geometri dan Mesh
| Enumerations | Enumerations |
|---|
Mesh | Entitas mesh poligon. Menyimpan titik kontrol (posisi vertex sebagai Vector4), daftar wajah poligon (daftar indeks titik kontrol), dan lapisan elemen vertex (normal, UV, warna vertex). |
Geometry | Basis abstrak untuk tipe geometri mirip mesh. Mendefinisikan array titik kontrol dan koleksi VertexElement lapisan. Mesh mewarisi dari Geometry. |
VertexElement | Basis abstrak untuk lapisan data yang terikat pada geometri (normal, UV, warna, dll.). Membawa getMappingMode(), getReferenceMode(), dan daftar data. |
VertexElementNormal | Menyimpan satu vektor normal per vertex atau per sudut poligon, tergantung pada mode pemetaan. Nilai data adalah Vector4 instansi dengan w tidak terpakai. |
VertexElementUV | Menyimpan pasangan koordinat tekstur (Vector2) per vertex atau per sudut poligon. Sebuah mesh dapat membawa beberapa lapisan UV untuk saluran tekstur yang berbeda. |
VertexElementVertexColor | Menyimpan data warna RGBA per-vertex atau per-sudut sebagai Vector4 (r, g, b, a dalam rentang 0–1). |
VertexElementType | Enumerasi yang mengidentifikasi peran semantik lapisan elemen vertex: NORMAL, UV, VERTEX_COLOR, dan lainnya. Kirim nilai ke Mesh.getElement(). |
MappingMode | Enumerasi yang mengontrol primitif mana nilai elemen vertex dipetakan ke: CONTROL_POINT, POLYGON_VERTEX, atau POLYGON. |
ReferenceMode | Enumerasi yang mengontrol bagaimana nilai diindeks: DIRECT (satu nilai per primitif pemetaan) atau INDEX_TO_DIRECT (array nilai plus array indeks terpisah). |
Transformasi dan Spasial
| Enumerations | Enumerations |
|---|
Transform | Transformasi lokal yang terpasang pada sebuah Node. Menyediakan translasi, rotasi (sebagai Quaternion), dan komponen skala, plus metode kemudahan untuk sudut Euler. |
GlobalTransform | Tampilan hanya-baca dari transformasi ruang-dunia sebuah node setelah menggabungkan semua transformasi nenek moyang. Diakses melalui node.getGlobalTransform(). |
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
| Enumerations | Enumerations |
|---|
Material | Kelas dasar abstrak untuk semua tipe material. Menyediakan nama dan kumpulan properti untuk parameter numerik dan warna. |
PbrMaterial | Material Physically Based Rendering. Menyimpan albedo, faktor metalik, faktor kekasaran, warna emisif, transparansi, dan tekstur terkait. Digunakan oleh glTF 2.0 dan format lain yang mendukung PBR. Impor: com.aspose.threed.shading.PbrMaterial. |
Enumerations
| Enumerations | Enumerations |
|---|
Camera | Entitas kamera. Mewarisi dari Entity. Tidak ada properti spesifik format yang ditampilkan dalam edisi Java FOSS selain nama yang diwarisi dan kumpulan properti. Terlampir pada sebuah Node untuk mendefinisikan transformasi sudut pandang. |
Catatan: Enumerations Light kelas tidak tersedia dalam edisi Java dari Aspose.3D FOSS. Data pencahayaan adegan dari file yang diimpor disimpan sebagai generic Entity objek.
Utilitas Matematika
| Enumerations | Enumerations |
|---|
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. |
FVector3 | Vektor float 3-komponen presisi tunggal. Muncul dalam array data elemen vertex untuk normal dan tangen. |
FVector4 | Vektor float 4-komponen presisi tunggal. Tipe penyimpanan dari VertexElementFVector data. |
Quaternion | Quaternion satuan untuk merepresentasikan rotasi (w, x, y, z). Digunakan oleh Transform.getRotation(). |
Matrix4 | 4x4 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 getMinimum() dan getMaximum() Vector3 sudut. Digunakan untuk kueri spasial dan pembantu culling frustum. |
Enumerations
| Enumerations | Enumerations |
|---|
AnimationClip | Kontainer bernama untuk rentang animasi. Sebuah Scene dapat menampung beberapa klip (mis., “Walk”, “Run”). Stub deklarasi — data keyframe dan pemutaran belum diimplementasikan. |
I/O Format
| Enumerations | Enumerations |
|---|
Scene.fromFile(path) | Metode statis. Membuka file di path, mendeteksi format dari ekstensi, dan mengembalikan yang terisi Scene. Melempar ketika file tidak ditemukan atau format tidak didukung. |
Scene.open(path, options) | Metode instance. Membuka file ke dalam sebuah Scene instance, secara opsional menggunakan format-spesifik LoadOptions subkelas. |
Scene.save(path, options) | Metode instance. Menyerialkan adegan ke path menggunakan format yang disimpulkan dari ekstensi, secara opsional menggunakan format-spesifik SaveOptions subkelas. |
FileFormat | Registri format file yang didukung. Berisi entri seperti FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII(). |
IOService | Abstraksi I/O internal yang digunakan oleh pengimpor dan pengekspor format. Tidak biasanya digunakan secara langsung oleh kode aplikasi. |
LoadOptions | Kelas dasar untuk semua objek opsi‑muat yang spesifik format. Di‑subclass oleh ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions. |
SaveOptions | Kelas dasar untuk semua objek opsi‑simpan yang spesifik format. Di‑subclass oleh ObjSaveOptions, StlSaveOptions, GltfSaveOptions. |
Format OBJ
| Enumerations | Enumerations |
|---|
ObjImporter | Kelas pengimpor internal yang mengurai file Wavefront OBJ dan MTL. Dipanggil secara otomatis oleh Scene.fromFile() untuk .obj ekstensi. |
ObjLoadOptions | Opsi muat untuk file Wavefront OBJ. Properti utama: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal(). |
ObjSaveOptions | Opsi simpan untuk output Wavefront OBJ. Mengontrol normal, UV, referensi material, dan mode point‑cloud. |
ObjFormat | Deskriptor format untuk Wavefront OBJ. Dapat diakses sebagai FileFormat.WAVEFRONT_OBJ(). |
Format STL
| Enumerations | Enumerations |
|---|
StlImporter | Pengimpor internal yang membaca file STL baik biner maupun ASCII. Dipilih secara otomatis berdasarkan ekstensi. |
StlExporter | Pengekspor internal yang menulis STL. |
StlLoadOptions | Opsi muat untuk file STL. Mendukung setFlipCoordinateSystem(), setRecalculateNormal(), dan setContentType(). |
StlSaveOptions | Opsi simpan untuk output STL. Mengontrol setFlipCoordinateSystem(), setAxisSystem(), dan setContentType(). |
StlFormat | Deskriptor format untuk STL. |
Format glTF
| Enumerations | Enumerations |
|---|
GltfLoadOptions | Muat opsi untuk file glTF 2.0 dan GLB. Properti utama: setFlipCoordinateSystem(), setPrettyPrint(). |
GltfSaveOptions | Simpan opsi untuk output glTF 2.0 dan GLB. Gunakan setContentType(FileContentType.BINARY) untuk menghasilkan yang berdiri sendiri .glb paket. |
GltfFormat | Deskriptor format untuk glTF 2.0 / GLB. Dapat diakses sebagai FileFormat.GLTF2(). |
Format FBX
FBX didukung untuk hanya impor. Ekspor ke FBX tidak tersedia dalam edisi FOSS Java.
| Enumerations | Enumerations |
|---|
FbxLoadOptions | Opsi pemuatan untuk file FBX. Properti kunci: setFlipCoordinateSystem(). |
FbxFormat | Deskriptor format untuk FBX. Dapat diakses sebagai FileFormat.FBX7400ASCII(). |
Enumerations
| Enumerations | Enumerations |
|---|
Axis | Mengidentifikasi sumbu koordinat: X_AXIS, Y_AXIS, Z_AXIS. Digunakan dalam opsi pemetaan ulang sistem koordinat. |
CoordinateSystem | Menentukan konvensi handedness: RIGHT_HANDED atau LEFT_HANDED. |
TextureMapping | Mengidentifikasi bagaimana tekstur dipetakan ke geometri: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, dll. |
BooleanOperation | Tipe operasi Boolean CSG: UNION, DIFFERENCE, INTERSECTION. |
Sistem Properti
| Enumerations | Enumerations |
|---|
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 yang ringan A3DObject subkelas yang hanya membawa sebuah nama dan sebuah nilai sewenang-wenang PropertyCollection. Digunakan untuk menyimpan metadata yang ditentukan pengguna pada objek adegan. |
Gambar dan Render
| Enumerations | Enumerations |
|---|
ImageRenderOptions | Opsi untuk rasterisasi perangkat lunak saat merender adegan ke buffer gambar. Menyimpan warna latar belakang, dimensi gambar, dan referensi kamera. Fitur ini tersedia dalam konfigurasi yang didukung. |
Lihat Juga
