Instalasi

Python 3.7 – 3.12 diperlukan.Penginstal dengan ‘pip install aspose-3d-foss’.Pure Python: tidak diperlukan kompilasi.

Aspose.3D FOSS untuk Python didistribusikan sebagai paket pure-Python di PyPI. Tidak ada ekstensi native yang harus dikompilasi, tidak ada pustaka sistem yang harus diinstal, dan tidak diperlukan Microsoft Office atau runtime pihak ketiga lainnya.

Prasyarat

1. Install via pip (Recommended)

Cara termudah untuk menginstal Aspose.3D FOSS adalah langsung dari PyPI:

pip install aspose-3d-foss

pip akan mengunduh dan menginstal paket serta mencatatnya di lingkungan Anda. Tidak diperlukan konfigurasi pasca-instal.

Untuk menginstal versi yang dipatok untuk build yang dapat direproduksi:

pip install aspose-3d-foss==26.1.0

2. Set Up a Virtual Environment (Recommended for Projects)

Menggunakan lingkungan virtual menjaga pustaka terisolasi dari proyek Python lainnya dan menghindari konflik versi.

Buat dan aktifkan lingkungan virtual:

##Create the environment
python -m venv .venv

##Activate on Linux / macOS
source .venv/bin/activate

##Activate on Windows (Command Prompt)
.venv\Scripts\activate.bat

##Activate on Windows (PowerShell)
.venv\Scripts\Activate.ps1

Instal pustaka di dalam lingkungan yang telah diaktifkan:

pip install aspose-3d-foss

Catat dependensi untuk reproduktibilitas:

pip freeze > requirements.txt

Untuk membuat ulang lingkungan di mesin lain:

python -m venv .venv
source .venv/bin/activate   # or the Windows equivalent
pip install -r requirements.txt

3. Verify the Installation

Setelah menginstal, verifikasi bahwa pustaka dapat diimpor dengan benar:

from aspose.threed import Scene

scene = Scene()
print("Aspose.3D FOSS installed successfully")
print(f"Root node name: {scene.root_node.name}")

Output yang diharapkan:

Aspose.3D FOSS installed successfully
Root node name: RootNode

Anda juga dapat memeriksa versi yang terinstal dengan pip:

pip show aspose-3d-foss

Ini akan mencetak versi, penulis, dan lisensi (MIT).

Panduan Cepat: Muat Adegan dan Periksa

Skrip berikut memuat file 3D, mencetak informasi tentang setiap node mesh, dan mengekspor ulang adegan ke format GLB:

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions

##Load an OBJ file with material support
options = ObjLoadOptions()
options.enable_materials = True
options.flip_coordinate_system = False

scene = Scene()
scene.open("model.obj", options)

##Print the scene hierarchy
print(f"Top-level nodes: {len(scene.root_node.child_nodes)}")

for node in scene.root_node.child_nodes:
    if node.entity is None:
        continue
    mesh = node.entity
    print(f"  Node: {node.name}")
    print(f"    Vertices: {len(mesh.control_points)}")
    print(f"    Polygons: {len(mesh.polygons)}")
    if node.material:
        print(f"    Material: {type(node.material).__name__}")

##Re-export to GLB (binary glTF)
scene.save("output.glb")
print("Saved output.glb")

Jika Anda belum memiliki file OBJ, perpustakaan juga dapat membuat adegan dari awal:

from aspose.threed import Scene

##Create an empty scene and save it as glTF
scene = Scene()
scene.save("empty.gltf")
print("Created empty.gltf")

Catatan Platform

Windows, macOS, Linux: Pustaka ini identik di semua platform. Tidak ada jalur kode atau ekstensi biner yang spesifik platform.

Docker / serverless: Karena tidak ada ketergantungan paket sistem, pustaka ini berfungsi di dalam image Docker yang ramping (seperti python:3.12-slim) tanpa menginstal paket apt atau yum tambahan.

CI/CD: Tambahkan pip install aspose-3d-foss ke langkah dependensi pipeline CI Anda. Tidak diperlukan pengaturan tambahan.

Conda: Jika proyek Anda menggunakan Conda, instal perpustakaan dari PyPI di dalam lingkungan Conda:

conda create -n my-env python=3.12
conda activate my-env
pip install aspose-3d-foss

Sumber Daya Tambahan

• Halaman Produk: Ikhtisar, ringkasan fitur, dan testimoni
• Panduan Pengembang: Referensi API lengkap dengan contoh kode
• Fitur dan Fungsionalitas: Dukungan format, grafik adegan, material, utilitas matematika, dan lainnya