Panduan Pengembang
Aspose.3D FOSS untuk TypeScript adalah perpustakaan sumber terbuka berlisensi MIT yang memungkinkan pengembang Node.js memuat, membangun, mentransformasi, dan mengekspor scene 3D dengan keamanan tipe TypeScript penuh. Baik Anda membangun pipeline aset, layanan konversi format, alat validasi geometri, atau skrip authoring konten 3D, perpustakaan ini menyediakan API yang bersih dan konsisten didukung oleh model scene-graph yang mencerminkan konsep 3D standar industri.
Panduan Pengembang ini mencakup semua yang Anda perlukan untuk melampaui instalasi cepat dan menulis kode pemrosesan 3D berkualitas produksi.
Apa yang Akan Anda Temukan di Bagian Ini
Fitur dan Fungsionalitas
The Fitur halaman adalah referensi utama untuk bekerja dengan Aspose.3D FOSS untuk TypeScript. Ini mencakup:
- Dukungan format: OBJ (dengan material .mtl), glTF 2.0 / GLB biner, STL (biner dan ASCII), COLLADA (DAE), 3MF, dan FBX, dengan kelas opsi muat dan simpan per-format termasuk
ObjLoadOptionsdanGltfSaveOptions. - Grafik adegan: Bagaimana
Scene,Node,Entity,Transform, danSceneObjectmenyusun menjadi hierarki adegan lengkap, termasuk pola traversi node anak. - API geometri dan mesh: Bekerja dengan
Mesh,Geometry,VertexElementNormal,VertexElementUV,VertexElementVertexColor,MappingMode, danReferenceModeuntuk pemrosesan geometri. - Sistem material: Menerapkan
LambertMaterial,PhongMaterial, danPbrMaterial(PBR for glTF) ke node adegan, dan membaca properti material yang dimuat dari file .mtl. - Utilitas Matematika: Menggunakan
Vector3,Vector4,Matrix4,Quaternion, danBoundingBoxuntuk transformasi, kueri kotak pembatas, dan perhitungan geometris. - Animasi: Membuat dan membaca
AnimationClip,AnimationNode,AnimationChannel,KeyFrame,KeyframeSequence,Interpolation, danExtrapolationdata. - Dukungan streaming dan buffer: Memuat adegan 3D dari memori
Bufferobjek melaluiscene.openFromBuffer()untuk kasus penggunaan serverless dan streaming. - Contoh penggunaan lengkap: Skrip TypeScript end-to-end untuk memuat OBJ, mengekspor GLB, melakukan round-tripping STL, dan menelusuri grafik adegan.
- Tips, masalah umum, dan FAQ: Panduan praktis untuk menghindari jebakan umum dalam penggunaan produksi.
- Ringkasan referensi API: Daftar referensi cepat semua kelas utama dan metode utama mereka.
Konsep Kunci
Graf adegan: Semua konten 3D dalam Aspose.3D FOSS direpresentasikan sebagai pohon dari Node objek yang berakar pada scene.rootNode. Setiap node dapat membawa sebuah Entity (seperti sebuah Mesh, Camera, atau Light) dan sebuah Transform yang menempatkannya dalam hierarki.
API yang tidak tergantung pada format: Anda membuka format yang didukung apa pun melalui scene.open() atau scene.openFromBuffer() dan menyimpan ke format yang didukung apa pun melalui scene.save(). Objek grafik-skena yang sama digunakan terlepas dari format sumber atau tujuan.
Pengetikan TypeScript yang Kuat: Perpustakaan dilengkapi dengan pengaturan kompiler yang ketat (noImplicitAny, strictNullChecks) dan definisi tipe lengkap. Setiap kelas, metode, dan properti opsi sepenuhnya ditentukan tipenya, memberikan Anda autocomplete IDE dan keamanan waktu kompilasi sepanjang kode pemrosesan 3D Anda.
Dependensi tunggal: Satu-satunya dependensi runtime adalah xmldom, yang diinstal secara otomatis oleh npm. Tidak ada addon native untuk dikompilasi dan tidak ada paket sistem yang perlu diinstal.
Memulai
Jika Anda belum menginstal perpustakaan ini, lihat Memulai bagian dan the Instalasi panduan sebelum membaca lebih lanjut.
Available Topics: Topik yang Tersedia
- Fitur dan Fungsionalitas: Referensi API lengkap dengan contoh kode untuk setiap area fitur utama.