Aspose.3D FOSS for .NET

Rujukan API untuk Aspose.3D 26.1.0 (.NET 10.0+, lesen MIT).

Semua kelas berada dalam Aspose.ThreeD ruang nama root. Arahan using root ialah:

using Aspose.ThreeD;

Konvensyen penamaan C#: Semua sifat menggunakan sintaks sifat C# standard. Sebagai contoh, gunakan scene.RootNode daripada scene.getRootNode(), dan transform.Translation = ... daripada transform.setTranslation(...).

Penamaan medan vektor: Pustaka ini mempunyai dua set jenis vektor. Aspose.ThreeD.Utilities.Vector2/3/4 (digunakan oleh Mesh.ControlPoints, geometri, dan kebanyakan operasi matematik) adalah presisi-dobel dengan huruf kecil medan awam (v.x, v.y, v.z, v.w). Yang lebih mudah Aspose.ThreeD.Vector2/3/4 struktur (di Vector.cs) ialah presisi tunggal (float) dengan huruf besar medan awam (v.X, v.Y, v.Z). FVector2/3/4 dan Quaternion dan Matrix4 gunakan akses medan huruf besar. Gunakan Aspose.ThreeD.Utilities jenis untuk kerja geometri.


Graf Adegan Teras

MethodsMethods
SceneBekas peringkat atas untuk semua data adegan 3D. Menyimpan nod akar, metadata aset, dan klip animasi. Mendedahkan Open() dan Save() sebagai titik masuk I/O utama.
NodeNod bernama dalam hierarki adegan. Memiliki senarai nod anak dan senarai yang dilampirkan Entity objek seperti mesh, kamera, dan lampu. Membawa setempat Transform.
EntityKelas asas abstrak untuk semua objek yang boleh dilampirkan kepada Node. Menyediakan nama dan identiti tetapi tiada geometri sendiri.
SceneObjectKelas asas yang dikongsi oleh Node dan Entity. Menyediakan antara muka koleksi sifat yang digunakan untuk metadata yang ditakrifkan pengguna.
A3DObjectKelas asas akar untuk semua objek terurus Aspose.3D. Mendedahkan Name harta dan Properties koleksi.
INamedObjectAntara muka yang menjamin satu Name harta. Dilaksanakan oleh Node, Entity, dan beberapa jenis penerangan khusus format.

Geometri dan Mesh

MethodsMethods
MeshEntiti jaring poligon. Menyimpan titik kawalan (kedudukan verteks sebagai Vector4), senarai muka poligon (senarai indeks titik kawalan), dan lapisan elemen verteks (normal, UV, warna verteks).
GeometryAsas abstrak untuk jenis geometri berasaskan jaring. Menentukan tatasusunan titik kawalan dan koleksi VertexElement lapisan. Mesh mewarisi dari Geometry.
VertexElementAsas abstrak untuk lapisan data yang dilampirkan pada geometri (normal, UV, warna, dll.). Membawa MappingMode, ReferenceMode, dan senarai data.
VertexElementNormalMenyimpan satu vektor normal per verteks atau per bucu poligon, bergantung pada mod pemetaan.
VertexElementUVMenyimpan pasangan koordinat tekstur (Vector2) per verteks atau per bucu poligon.
VertexElementVertexColorMenyimpan data warna RGBA per-verteks atau per-bucu sebagai Vector4.

Primitif Terbina Dalam

MethodsMethods
BoxKotak berparameter selari paksi dengan lebar, tinggi, dan kedalaman yang boleh dikonfigurasi. Boleh dilampirkan kepada a Node secara langsung atau ditukar kepada Mesh melalui ToMesh().
SphereSfera berparameter dengan jejari yang boleh dikonfigurasi. Menyokong ToMesh() penukaran.
CylinderSilinder parametrik dengan jejari atas, jejari bawah, dan tinggi yang boleh dikonfigurasi. Menyokong ToMesh() penukaran.

Transformasi dan Spatial

MethodsMethods
TransformTransformasi setempat yang dilampirkan kepada a Node. Menyediakan Translation (FVector3), Rotation (Quaternion), Scale (FVector3), dan Matrix (Matrix4) ciri.
GlobalTransformPaparan baca-sahaja bagi matriks transformasi ruang-dunia sesebuah nod selepas menggabungkan semua transformasi nenek moyang. Diakses melalui node.GlobalTransform. Menunjukkan satu Matrix ciri.
AssetInfoBlok metadata yang dilampirkan kepada Scene. Mewarisi dari A3DObject menyediakan Name dan Properties. Tiada ciri tambahan yang ditakrifkan dalam edisi ini.

Bahan dan Pewarnaan

MethodsMethods
MaterialKelas asas abstrak untuk semua jenis bahan. Menyediakan nama dan koleksi sifat.
LambertMaterialBahan klasik hanya difus dengan Ambient, Diffuse, Emissive, Reflective, Transparency, dan Texture ciri-ciri. Namespace: Aspose.ThreeD.Shading.
PhongMaterialMeneruskan Lambert dengan Specular, Shininess, dan SpecularPower ciri-ciri. Namespace: Aspose.ThreeD.Shading.
PbrMaterialBahan Physically Based Rendering dengan BaseColor, Metallic, Roughness, Occlusion, dan sifat slot tekstur. Namespace: Aspose.ThreeD.Shading.

Methods

MethodsMethods
CameraEntiti Kamera. Mewarisi dari Frustum. Dilampirkan kepada satu Node untuk menentukan transformasi sudut pandang. Tiada sifat khusus format yang dipaparkan dalam edisi ini.

Utiliti Matematik

MethodsMethods
Vector2Presisi berganda 2-component vector (lowercase fields: x, y). Ruang nama: Aspose.ThreeD.Utilities. Digunakan untuk koordinat tekstur UV.
Vector3Presisi berganda 3-component vector (lowercase fields: x, y, z). Ruang nama: Aspose.ThreeD.Utilities. Vektor ruang tujuan umum untuk geometri.
Vector4Presisi berganda 4-component vector (lowercase fields: x, y, z, w). Ruang nama: Aspose.ThreeD.Utilities. Digunakan untuk Mesh.ControlPoints dan data normal.
FVector3Vektor titik terapung 3-komponen dengan ketepatan tunggal (medan huruf besar: X, Y, Z). Digunakan oleh Transform.Translation dan Transform.Scale.
FVector4Vektor Single-precision 4-component float vector (medan huruf besar: X, Y, Z, W).
QuaternionKuaternion Unit untuk mewakili putaran (W, X, Y, Z). Digunakan oleh Transform.Rotation.
Matrix44x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix.
BoundingBoxKotak sempadan Axis-aligned yang ditakrifkan oleh Minimum dan Maximum FVector3 bucu.

Methods

MethodsMethods
AnimationClipKontena bernama untuk julat animasi. Sebuah Scene mungkin mengandungi berbilang klip. Stub deklarasi — data keyframe dan playback belum lagi dilaksanakan.

Format I/O

MethodsMethods
Scene.Open(path)Membuka fail, mengesan format daripada sambungan, dan mengisi scene.
Scene.Open(path, options)Membuka fail dengan format-specific LoadOptions.
Scene.Open(stream)Membuka dari aliran, auto-detecting format daripada kandungan.
Scene.Open(stream, options)Membuka dari aliran dengan format-specific LoadOptions.
Scene.Save(path)Menyimpan adegan ke fail; format dikesan daripada ekstensi.
Scene.Save(path, options)Menyimpan dengan format-specific SaveOptions.
Scene.Save(stream, options)Menyimpan ke aliran dengan format-specific SaveOptions.
FileFormatDaftar format fail yang disokong. Gunakan FileFormat.Formats (sebuah IList<FileFormat>) untuk menyenaraikan semua format yang disokong, atau FileFormat.Detect(fileName) untuk mengesan format mengikut nama fail. Pemalar bernama (ObjFormat, GltfFormat, FbxFormat, dll.) adalah internal dan tidak dapat diakses dari kod pengguna.
IOServiceAbstraksi I/O dalaman. Menyediakan DetectFormat() untuk pengesanan format berasaskan aliran.
LoadOptionsKelas asas untuk pilihan pemuatan khusus format.
SaveOptionsKelas asas untuk pilihan penyimpanan khusus format.

Format OBJ

MethodsMethods
ObjLoadOptionsPilihan pemuatan untuk fail Wavefront OBJ.
ObjSaveOptionsPilihan penyimpanan untuk output Wavefront OBJ.

Format STL

MethodsMethods
StlLoadOptionsPilihan pemuatan untuk fail STL.
StlSaveOptionsPilihan penyimpanan untuk output STL.

Format glTF

MethodsMethods
GltfLoadOptionsPilihan pemuatan untuk fail glTF 2.0 dan GLB.
GltfSaveOptionsPilihan penyimpanan untuk output glTF 2.0 dan GLB. Tiada sifat khusus format yang dipaparkan dalam edisi ini; gunakan .glb ekstensi untuk output binari.

Format FBX

MethodsMethods
FbxLoadOptionsPilihan muat untuk fail FBX.
FbxSaveOptionsPilihan simpan untuk output FBX. Eksport FBX sentiasa menghasilkan output binari; eksport FBX ASCII tidak aktif dalam versi ini.

3MF Format

MethodsMethods
TmfLoadOptionsPilihan muat untuk fail 3MF.
TmfSaveOptionsOpsyen simpan untuk output 3MF.

Methods

MethodsMethods
FileContentTypePenerangan jenis kandungan: ASCII, Binary. Tersedia sebagai sifat pada FileFormat.
AxisMengenal pasti paksi koordinat: XAxis, YAxis, ZAxis.
CoordinateSystemMenentukan konvensyen tangan: RightHand atau LeftHand.

Sistem Sifat

MethodsMethods
PropertySatu sifat berjenis bernama pada satu A3DObject.
PropertyCollectionKoleksi boleh diiterasi bagi Property objek yang dilampirkan kepada satu A3DObject.

Lihat Juga

 Bahasa Melayu