Mula Menggunakan

Aspose.3D FOSS untuk Python

Selamat datang ke Aspose.3D FOSS untuk Python, sebuah perpustakaan percuma, berlesen MIT untuk memuatkan, membina, dan mengeksport adegan 3D daripada Python. Panduan ini akan membawa anda dari persekitaran baru ke adegan yang berfungsi dalam beberapa minit.


Prasyarat

Sebelum memasang, pastikan persekitaran anda memenuhi keperluan berikut:

Versi Python

  • Python 3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
  • CPython adalah interpreter rujukan; semua enam versi diuji pada setiap pelepasan

Pengurus Pakej

  • pip (disertakan dengan semua pemasangan Python moden)
  • Tiada alat binaan, pengkompil, atau pakej sistem lain yang diperlukan

Sistem Operasi

  • Windows, macOS, dan Linux semuanya disokong
  • Perpustakaan ini murni Python: tiada sambungan asli khusus platform untuk dikompilasi

Pemasangan

Pasang dari PyPI menggunakan pip:

pip install aspose-3d-foss

Lihat Panduan Pemasangan untuk penyediaan persekitaran maya, langkah pengesahan, dan contoh kod permulaan pantas.


Aspose.3D FOSS untuk Python

Setelah dipasang anda boleh serta-merta:

  • Muat fail OBJ (dengan sokongan bahan .mtl), STL, glTF 2.0, GLB, COLLADA, dan 3MF
  • Periksa hierarki adegan: lalui nod, baca mesh, akses normal vertex dan UV
  • Ubah adegan: terapkan posisi, putaran (melalui Quaternion), dan skala menggunakan Transform
  • Terapkan bahan: bekerja dengan LambertMaterial dan PhongMaterial pada scene nodes
  • Eksport ke mana-mana format yang disokong dengan pilihan simpan per-format
  • Kira geometri: pertanyaan kotak sempadan, mengumpul transformasi ruang-dunia dengan GlobalTransform
  • Baca animasi: akses AnimationClip dan KeyframeSequence data daripada fail glTF dan COLLADA yang dimuatkan

Mula Cepat

Kod berikut memuatkan fail adegan, mencetak anak nod akar, dan menyimpan semula 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 Seterusnya

 Bahasa Melayu