Panduan Pembangun

Aspose.3D FOSS untuk TypeScript ialah perpustakaan sumber terbuka berlesen MIT yang membolehkan pembangun Node.js memuat, membina, menukar, dan mengeksport adegan 3D dengan keselamatan jenis TypeScript penuh. Sama ada anda membina saluran aset, perkhidmatan penukaran format, alat pengesahan geometri, atau skrip penulisan kandungan 3D, perpustakaan ini menyediakan API yang bersih dan konsisten berasaskan model graf-seni yang mencerminkan konsep 3D standard industri.

Panduan Pembangun ini merangkumi segala yang anda perlukan untuk melangkaui pemasangan cepat dan menulis kod pemprosesan 3D berkualiti pengeluaran.

Apa Yang Anda Akan Temui dalam Bahagian Ini

Ciri-ciri dan Fungsi

The Ciri-ciri halaman adalah rujukan utama untuk bekerja dengan Aspose.3D FOSS untuk TypeScript. Ia merangkumi:

  • Sokongan format: OBJ (dengan bahan .mtl), glTF 2.0 / GLB binari, STL (binari dan ASCII), COLLADA (DAE), 3MF, dan FBX, dengan kelas pilihan muat naik dan simpan per-format termasuk ObjLoadOptions dan GltfSaveOptions.
  • Graf adegan: Bagaimana Scene, Node, Entity, Transform, dan SceneObject digabungkan menjadi hierarki adegan penuh, termasuk corak traversing nod anak.
  • API geometri dan mesh: Bekerja dengan Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, ReferenceMode untuk pemprosesan geometri.
  • Sistem bahan: Menerapkan LambertMaterial, PhongMaterial, dan PbrMaterial (PBR for glTF) kepada nod adegan, dan membaca sifat bahan yang dimuatkan dari fail .mtl.
  • Utiliti Matematik: Menggunakan Vector3, Vector4, Matrix4, Quaternion, dan BoundingBox untuk transformasi, pertanyaan kotak sempadan, dan pengiraan geometri.
  • Animasi: Membina dan membaca AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, dan Extrapolation data.
  • Sokongan aliran dan penimbal: Memuatkan adegan 3D dari memori dalam Buffer objek melalui scene.openFromBuffer() untuk kes penggunaan tanpa pelayan dan penstriman.
  • Contoh penggunaan lengkap: Skrip TypeScript hujung-ke-hujung untuk memuat OBJ, mengeksport GLB, pusing semula STL, dan menelusuri graf adegan.
  • Petua, isu biasa, dan Soalan Lazim: Panduan praktikal untuk mengelakkan perangkap biasa dalam penggunaan produksi.
  • Ringkasan rujukan API: Senarai rujukan pantas semua kelas utama dan kaedah utama mereka.

Konsep Utama

Scene graph: Semua kandungan 3D dalam Aspose.3D FOSS diwakili sebagai pokok Node objek yang berakar pada scene.rootNode. Setiap nod boleh membawa satu Entity (seperti satu Mesh, Camera, atau Light) and a Transform yang menempatkannya dalam hierarki.

API bebas format: Anda membuka mana-mana format yang disokong melalui scene.open() atau scene.openFromBuffer() dan menyimpan ke mana-mana format yang disokong melalui scene.save(). Objek graf-skena yang sama digunakan tanpa mengira format sumber atau destinasi.

Pengetikan TypeScript yang kuat: Pustaka ini disertakan dengan tetapan penyusun yang ketat (noImplicitAny, strictNullChecks) dan definisi jenis yang lengkap. Setiap kelas, kaedah, dan sifat pilihan ditaip sepenuhnya, memberikan anda auto lengkap IDE dan keselamatan masa kompilasi sepanjang kod pemprosesan 3D anda.

Kebergantungan tunggal: Satu-satunya kebergantungan masa jalan ialah xmldom, yang dipasang secara automatik oleh npm. Tiada addon asli untuk disusun dan tiada pakej sistem untuk dipasang.

Mula Menggunakan

Jika anda belum lagi memasang pustaka, lihat the Mula Menggunakan bahagian dan Pemasangan panduan sebelum membaca lebih lanjut.

Topik Tersedia

 Bahasa Melayu