Panduan Pembangun

Aspose.3D FOSS untuk Python adalah perpustakaan sumber terbuka berlesen MIT yang membolehkan pembangun Python memuat, membina, menukar, dan mengeksport adegan 3D tanpa sebarang kebergantungan runtime luaran. Sama ada anda membina saluran aset, alat pengesahan, skrip pemprosesan geometri, atau perkhidmatan penukaran format, perpustakaan ini menyediakan API yang bersih dan konsisten yang disokong oleh 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 produksi.

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 Python. Ia merangkumi:

  • Sokongan format: OBJ (dengan bahan .mtl), STL (binari dan ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF, dan penjejak token FBX yang sedang dalam proses, dengan kelas pilihan muat naik dan simpan per-format.
  • Graf adegan: Bagaimana Scene, Node, Entity, Transform, dan GlobalTransform susun menjadi hierarki adegan penuh, termasuk corak traversing nod anak.
  • Mesh API: Bekerja dengan control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, dan VertexElementSmoothingGroup untuk pemprosesan geometri.
  • Sistem bahan: Menerapkan LambertMaterial dan PhongMaterial kepada scene nodes, dan membaca sifat bahan yang dimuatkan dari fail .mtl.
  • Utiliti Matematik: Menggunakan Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, dan BoundingBox untuk transformasi, pertanyaan kotak sempadan, dan pengiraan geometri.
  • Animasi: Membina dan membaca AnimationClip, AnimationNode, KeyFrame, dan KeyframeSequence data.
  • Pilihan muat dan simpan: Kelas pilihan per-format seperti ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Contoh penggunaan lengkap: Skrip Python end-to-end untuk memuat OBJ, mengeksport STL, round-tripping glTF, dan menelusuri graf adegan.
  • : Petua, isu biasa, dan Soalan Lazim: Panduan praktikal untuk mengelakkan perangkap biasa dalam penggunaan produksi.
  • : Ringkasan rujukan API: Senarai rujukan cepat bagi semua kelas utama.

Konsep Utama

: Graf adegan: Semua kandungan 3D dalam Aspose.3D FOSS diwakili sebagai pokok Node : objek yang berakar pada scene.root_node. Setiap nod boleh membawa satu Entity (seperti satu Mesh, Camera, atau Light) dan satu Transform yang menempatkannya dalam hierarki.

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

Tiada kebergantungan: Perpustakaan ini murni Python. Tiada sambungan asli untuk dikompilasi, tiada pakej sistem untuk dipasang, dan tiada perpustakaan pihak ketiga untuk diurus.

Mula Menggunakan

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

Topik yang Tersedia

 Bahasa Melayu