Panduan Pengembang
Aspose.3D FOSS untuk Python adalah perpustakaan open-source dengan lisensi MIT yang memungkinkan pengembang Python memuat, membangun, mentransformasi, dan mengekspor adegan 3D tanpa ketergantungan runtime eksternal. Baik Anda sedang membangun pipeline aset, alat validasi, skrip pemrosesan geometri, atau layanan konversi format, perpustakaan ini menyediakan API yang bersih dan konsisten yang 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 dengan kualitas produksi.
Apa yang Akan Anda Temukan di Bagian Ini
Fitur dan Fungsionalitas
Halaman Fitur halaman adalah referensi utama untuk bekerja dengan Aspose.3D FOSS untuk Python. Ini mencakup:
- Dukungan format: OBJ (dengan material .mtl), STL (biner dan ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF, dan tokenizer FBX yang sedang dalam pengembangan, dengan kelas opsi muat dan simpan per-format.
- Graf adegan: Bagaimana
Scene,Node,Entity,Transform, danGlobalTransformsusun menjadi hierarki adegan lengkap, termasuk pola traversi node anak. - Mesh API: Bekerja dengan
control_points,VertexElementNormal,VertexElementUV,VertexElementVertexColor, danVertexElementSmoothingGroupuntuk pemrosesan geometri. - Sistem material: Menerapkan
LambertMaterialdanPhongMaterialke node adegan, dan membaca properti material yang dimuat dari file .mtl. - Utilitas Matematika: Menggunakan
Vector2,Vector3,Vector4,FVector3,Quaternion,Matrix4, danBoundingBoxuntuk transformasi, kueri kotak pembatas, dan perhitungan geometris. - Animasi: Membuat dan membaca
AnimationClip,AnimationNode,KeyFrame, danKeyframeSequencedata. - Opsi memuat dan menyimpan: Kelas opsi per-format seperti
ObjLoadOptions(flip_coordinate_system, scale, enable_materials, normalize_normal) andStlSaveOptions. - Contoh penggunaan lengkap: Skrip Python end-to-end untuk memuat OBJ, mengekspor STL, melakukan round-tripping glTF, 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.
Konsep Utama
Grafik adegan: Semua konten 3D dalam Aspose.3D FOSS direpresentasikan sebagai pohon dari Node objek yang berakar pada scene.root_node. Setiap node dapat membawa sebuah Entity (seperti sebuah Mesh, Camera, atau Light) dan sebuah Transform yang menempatkannya dalam hierarki.
API agnostik format: Anda membuka format yang didukung apa pun melalui Scene.open() atau Scene.from_file() dan menyimpan ke format yang didukung apa pun melalui Scene.save(). Objek scene-graph yang sama digunakan terlepas dari format sumber atau tujuan.
Tanpa ketergantungan: Perpustakaan ini murni Python. Tidak ada ekstensi native yang harus dikompilasi, tidak ada paket sistem yang harus dipasang, dan tidak ada perpustakaan pihak ketiga yang harus dikelola.
Memulai
Jika Anda belum menginstal perpustakaan, lihat Memulai bagian dan Instalasi panduan sebelum melanjutkan membaca.
Topik yang Tersedia
- Fitur dan Fungsionalitas: Referensi API lengkap dengan contoh kode untuk setiap area fitur utama.