Memulai
Aspose.3D FOSS untuk Python
Selamat datang di Aspose.3D FOSS untuk Python, sebuah perpustakaan gratis berlisensi MIT untuk memuat, membangun, dan mengekspor adegan 3D dari Python. Panduan ini akan membawa Anda dari lingkungan baru ke adegan yang berfungsi dalam beberapa menit.
Prasyarat
Sebelum menginstal, pastikan lingkungan Anda memenuhi persyaratan berikut:
Versi Python
- Python 3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
- CPython adalah interpreter referensi; semua enam versi diuji pada setiap rilis
Manajer Paket
- pip (disertakan dengan semua instalasi Python modern)
- Tidak diperlukan alat build, kompiler, atau paket sistem lainnya
Sistem Operasi
- Windows, macOS, dan Linux semuanya didukung
- Perpustakaan ini murni Python: tidak ada ekstensi native spesifik platform yang harus dikompilasi
Instalasi
Instal dari PyPI menggunakan pip:
pip install aspose-3d-fossLihat Panduan Instalasi untuk penyiapan lingkungan virtual, langkah verifikasi, dan contoh kode cepat.
Aspose.3D FOSS untuk Python
Setelah diinstal Anda dapat langsung:
- Muat file OBJ (dengan dukungan material .mtl), STL, glTF 2.0, GLB, COLLADA, dan 3MF
- Periksa hierarki adegan: telusuri node, baca mesh, akses normal vertex dan UV
- Transformasi adegan: terapkan posisi, rotasi (melalui
Quaternion), dan skala menggunakanTransform - Terapkan material: bekerja dengan
LambertMaterialdanPhongMaterialpada node adegan - Ekspor ke format apa pun yang didukung dengan opsi penyimpanan per-format
- Hitung geometri: kueri kotak pembatas, akumulasi transformasi ruang-dunia dengan
GlobalTransform - Baca animasi: akses
AnimationClipdanKeyframeSequencedata dari file glTF dan COLLADA yang dimuat
Mulai Cepat
Kode berikut memuat file adegan, mencetak anak node akar, dan menyimpan ulang adegan dalam format GLB:
from aspose.threed import Scene
scene = Scene.from_file("input.obj")
print(f"Root node children: {len(scene.root_node.child_nodes)}")
for node in scene.root_node.child_nodes:
entity_type = type(node.entity).__name__ if node.entity else "no entity"
print(f" {node.name} [{entity_type}]")
scene.save("output.glb")
print("Saved output.glb")Langkah Selanjutnya
- Panduan Instalasi: Penyiapan lingkungan virtual, instalasi pip, dan verifikasi
- Panduan Pengembang: Referensi API lengkap, detail dukungan format, dan contoh kode
- Fitur dan Fungsionalitas: Penyelaman mendalam ke setiap area fitur dengan contoh Python yang berfungsi