Rujukan API untuk aspose-3d-foss 26.1.0 (Java 21+, MIT license).
Semua kelas berada dalam com.aspose.threed pakej root. Import root ialah:
Susun atur Pakej: Hampir semua kelas awam berada dalam com.aspose.threed. Sub-pakej tunggal yang biasanya digunakan ialah com.aspose.threed.shading (untuk PbrMaterial). Sub-pakej com.aspose.threed.formats sub-pakej mengandungi importir/pengekspor dalaman dan biasanya tidak diimport secara langsung.
Java konvensyen penamaan: Semua sifat menggunakan kaedah getter/setter. Sebagai contoh, gunakan node.getTransform() daripada node.transform, dan transform.setTranslation(...) daripada transform.translation = .... Perhatikan bahawa Vector3, Vector4, Quaternion, Matrix4, dan FVector jenis menggunakan medan awam (v.x, v.y, v.z) berbanding getter untuk akses komponen.
Graf Adegan Teras
| Enumerations | Enumerations |
|---|
Scene | Bekas peringkat atas untuk semua data adegan 3D. Menyimpan nod akar, metadata aset, dan klip animasi. Mendedahkan fromFile(), open(), dan save() sebagai titik masuk I/O utama. |
Node | Nod bernama dalam hierarki adegan. Memiliki senarai nod anak dan senarai yang dilampirkan Entity objek seperti mesh, kamera, dan lampu. Membawa satu 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 getName() kaedah. Dilaksanakan oleh Node, Entity, dan beberapa jenis penerangan khusus format. |
Geometri dan Mesh
| Enumerations | Enumerations |
|---|
Mesh | Entiti mesh poligon. Menyimpan titik kawalan (kedudukan vertex sebagai Vector4), senarai muka poligon (senarai indeks titik kawalan), dan lapisan elemen vertex (normals, UVs, vertex colours). |
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 (normals, UVs, colours, dll.). Membawa getMappingMode(), getReferenceMode(), dan senarai data. |
VertexElementNormal | Menyimpan satu normal vector per vertex atau per polygon corner, bergantung pada mapping mode. Nilai data adalah Vector4 instans dengan w tidak digunakan. |
VertexElementUV | Menyimpan pasangan koordinat tekstur (Vector2) per vertex atau per polygon corner. Mesh boleh membawa berbilang lapisan UV untuk saluran tekstur yang berbeza. |
VertexElementVertexColor | Menyimpan data warna RGBA per-vertex atau per-corner sebagai Vector4 (r, g, b, a dalam julat 0–1). |
VertexElementType | Enumerasi yang mengenal pasti peranan semantik lapisan elemen vertex: NORMAL, UV, VERTEX_COLOR, dan lain-lain. Hantar nilai kepada Mesh.getElement(). |
MappingMode | Enumerasi yang mengawal primitif mana nilai elemen vertex dipetakan kepada: CONTROL_POINT, POLYGON_VERTEX, atau POLYGON. |
ReferenceMode | Enumerasi yang mengawal cara nilai diindeks: DIRECT (satu nilai per mapping primitive) atau INDEX_TO_DIRECT (tatasusunan nilai plus tatasusunan indeks berasingan). |
Transform dan Spatial
| Enumerations | Enumerations |
|---|
Transform | Transformasi setempat yang dilampirkan kepada a Node. Menyediakan terjemahan, putaran (sebagai Quaternion), dan komponen skala, serta kaedah kemudahan untuk sudut Euler. |
GlobalTransform | Paparan baca-sahaja bagi transformasi ruang-dunia nod selepas menggabungkan semua transformasi nenek moyang. Diakses melalui node.getGlobalTransform(). |
AssetInfo | Blok metadata yang dilampirkan kepada Scene. Menyimpan nama aplikasi pengarang, nama unit, faktor skala unit, definisi paksi sistem koordinat, dan 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. |
PbrMaterial | Bahan Physically Based Rendering. Menyimpan albedo, faktor logam, faktor kekasaran, warna emisif, ketelusan, dan tekstur yang berkaitan. Digunakan oleh glTF 2.0 dan format lain yang menyokong PBR. Import: com.aspose.threed.shading.PbrMaterial. |
Enumerations
| Enumerations | Enumerations |
|---|
Camera | Entiti kamera. Mewarisi daripada Entity. Tiada sifat khusus format yang dipaparkan dalam edisi Java FOSS selain nama yang diwarisi dan koleksi sifat. Dilampirkan kepada satu Node untuk menentukan transformasi sudut pandang. |
Nota: Enumerations Light kelas tidak tersedia dalam edisi Java Aspose.3D FOSS. Data pencahayaan adegan daripada fail yang diimport disimpan sebagai generic Entity objek.
Utiliti Matematik
| Enumerations | Enumerations |
|---|
Vector2 | Vektor 2-komponen berketepatan berganda (x, y). Digunakan untuk koordinat tekstur UV. |
Vector3 | Vektor 3-komponen berketepatan berganda (x, y, z). Digunakan untuk kedudukan, arah, dan skala. |
Vector4 | Vektor 4-komponen berketepatan berganda (x, y, z, w). Digunakan untuk titik kawalan (kedudukan homogen) dan data normal. |
FVector3 | Vektor float 3-komponen presisi tunggal. Muncul dalam tatasusunan data unsur verteks untuk normal dan tangen. |
FVector4 | Vektor float 4-komponen presisi tunggal. Jenis penyimpanan bagi VertexElementFVector data. |
Quaternion | Quaternion unit untuk mewakili putaran (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 | Kotak sempadan selari paksi yang ditakrifkan oleh getMinimum() dan getMaximum() Vector3 sudut. Digunakan untuk pertanyaan spatial dan pembantu pemangkasan frustum. |
Enumerations
| Enumerations | Enumerations |
|---|
AnimationClip | Bekas bernama untuk julat animasi. Sebuah Scene boleh memegang pelbagai klip (contoh, “Walk”, “Run”). Stub deklarasi — data bingkai kunci dan main balik belum lagi dilaksanakan. |
Format I/O
| Enumerations | Enumerations |
|---|
Scene.fromFile(path) | Kaedah statik. Membuka fail di path, mengesan format daripada sambungan, dan mengembalikan satu yang telah diisi Scene. Membaling ralat apabila fail tidak ditemui atau format tidak disokong. |
Scene.open(path, options) | Kaedah contoh. Membuka fail ke dalam satu yang sedia ada Scene contoh, secara pilihan menggunakan satu yang khusus format LoadOptions subkelas. |
Scene.save(path, options) | Kaedah contoh. Menserialisasikan adegan ke path menggunakan format yang disimpulkan daripada sambungan, secara pilihan menggunakan format khusus SaveOptions subkelas. |
FileFormat | Registri format fail yang disokong. Mengandungi entri seperti FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII(). |
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-spesifik. Disubkelaskan oleh ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions. |
SaveOptions | Kelas asas untuk semua objek pilihan-simpan format-spesifik. Disubkelaskan oleh ObjSaveOptions, StlSaveOptions, GltfSaveOptions. |
Format OBJ
| Enumerations | Enumerations |
|---|
ObjImporter | Kelas pengimport dalaman yang menghurai fail Wavefront OBJ dan MTL. Dipanggil secara automatik oleh Scene.fromFile() untuk .obj sambungan. |
ObjLoadOptions | Pilihan muat untuk fail Wavefront OBJ. Sifat utama: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal(). |
ObjSaveOptions | Pilihan simpan 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 setFlipCoordinateSystem(), setRecalculateNormal(), dan setContentType(). |
StlSaveOptions | Pilihan simpan untuk output STL. Mengawal setFlipCoordinateSystem(), setAxisSystem(), dan setContentType(). |
StlFormat | Penerangan format untuk STL. |
Format glTF
| Enumerations | Enumerations |
|---|
GltfLoadOptions | Muat pilihan untuk fail glTF 2.0 dan GLB. Ciri utama: setFlipCoordinateSystem(), setPrettyPrint(). |
GltfSaveOptions | Simpan pilihan untuk output glTF 2.0 dan GLB. Gunakan setContentType(FileContentType.BINARY) untuk menghasilkan satu pakej yang berdiri sendiri .glb pakej. |
GltfFormat | Penerangan format untuk glTF 2.0 / GLB. Boleh diakses sebagai FileFormat.GLTF2(). |
Format FBX
FBX disokong untuk import sahaja. Eksport ke FBX tidak tersedia dalam edisi Java FOSS.
| Enumerations | Enumerations |
|---|
FbxLoadOptions | Pilihan muat untuk fail FBX. Sifat utama: setFlipCoordinateSystem(). |
FbxFormat | Penerangan format untuk FBX. Boleh diakses sebagai FileFormat.FBX7400ASCII(). |
Enumerations
| Enumerations | Enumerations |
|---|
Axis | Mengenal pasti paksi koordinat: X_AXIS, Y_AXIS, Z_AXIS. Digunakan dalam pilihan pemetaan semula sistem koordinat. |
CoordinateSystem | Menentukan konvensyen tangan: RIGHT_HANDED atau LEFT_HANDED. |
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 satu 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. |
Lihat Juga
