Pemasangan

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

Aspose.3D FOSS untuk Python diedarkan sebagai pakej pure-Python di PyPI. Tiada sambungan asli untuk disusun, tiada perpustakaan sistem untuk dipasang, dan tiada Microsoft Office atau runtime pihak ketiga lain yang diperlukan.

Prasyarat

1. Install via pip (Recommended)

Cara paling mudah untuk memasang Aspose.3D FOSS ialah secara langsung dari PyPI:

pip install aspose-3d-foss

pip akan memuat turun dan memasang pakej serta merekodkannya dalam persekitaran anda. Tiada konfigurasi selepas pemasangan diperlukan.

Untuk memasang versi yang dipatok bagi binaan yang boleh diulangi:

pip install aspose-3d-foss==26.1.0

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

Menggunakan persekitaran maya memastikan perpustakaan terasing daripada projek Python lain dan mengelakkan konflik versi.

Cipta dan aktifkan persekitaran maya:

##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

Pasang perpustakaan di dalam persekitaran yang diaktifkan:

pip install aspose-3d-foss

Rekod kebergantungan untuk kebolehulangan:

pip freeze > requirements.txt

Untuk mencipta semula persekitaran pada mesin lain:

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

3. Verify the Installation

Selepas memasang, sahkan bahawa perpustakaan diimport dengan betul:

from aspose.threed import Scene

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

Output yang dijangka:

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

Anda juga boleh menyemak versi yang dipasang dengan pip:

pip show aspose-3d-foss

Ini akan mencetak versi, pengarang, dan lesen (MIT).

Mula Cepat: Muatkan Adegan dan Periksa Ia

Skrip berikut memuatkan fail 3D, mencetak maklumat tentang setiap nod mesh, dan mengeksport semula 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 mempunyai fail OBJ, perpustakaan juga boleh mencipta 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")

Nota Platform

Windows, macOS, Linux: Perpustakaan ini adalah serupa pada semua platform. Tiada laluan kod khusus platform atau sambungan binari.

Docker / serverless: Oleh kerana tiada kebergantungan pakej sistem, perpustakaan ini berfungsi dalam imej Docker slim (seperti python:3.12-slim) tanpa memasang sebarang pakej apt atau yum tambahan.

CI/CD: Tambah pip install aspose-3d-foss ke langkah kebergantungan CI pipeline anda. Tiada persediaan tambahan diperlukan.

Conda: Jika projek anda menggunakan Conda, pasang perpustakaan dari PyPI dalam persekitaran Conda:

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

Sumber Tambahan

• Halaman Produk: Gambaran keseluruhan, ringkasan ciri, dan testimoni
• Panduan Pembangun: Rujukan API lengkap dengan contoh kod
• Ciri-ciri dan Fungsi: Sokongan format, graf adegan, bahan, utiliti matematik, dan banyak lagi