Telepítés

Python 3.7–3.12 szükséges. telepítse a „pip install aspose-3d-foss” programmal. tiszta Python: nincs szükség kompilációra.

A Aspose.3D FOSS a Python számára tiszta Python csomagként kerül terjesztésre a PyPI-n. Nincsenek lefordítandó natív kiterjesztések, nincs telepítendő rendszerkönyvtár, és nem szükséges Microsoft Office vagy más harmadik fél futtatókörnyezete.

Előfeltételek

1. Install via pip (Recommended)

A legegyszerűbb módja a Aspose.3D FOSS telepítésének közvetlenül a PyPI-ról:

pip install aspose-3d-foss

A pip letölti és telepíti a csomagot, és rögzíti azt a környezetedben. Nem szükséges utólagos konfiguráció.

Egy rögzített verzió telepítéséhez a reprodukálható buildekhez:

pip install aspose-3d-foss==26.1.0

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

A virtuális környezet használata izolálja a könyvtárat a többi Python projekttől, és elkerüli a verzióütközéseket.

Virtuális környezet létrehozása és aktiválása:

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

A könyvtár telepítése az aktivált környezeten belül:

pip install aspose-3d-foss

Függőségek rögzítése a reprodukálhatóság érdekében:

pip freeze > requirements.txt

A környezet újbóli létrehozásához egy másik gépen:

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

3. Verify the Installation

A telepítés után ellenőrizd, hogy a könyvtár helyesen importálható-e:

from aspose.threed import Scene

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

Várható kimenet:

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

A telepített verziót a pip segítségével is ellenőrizheted:

pip show aspose-3d-foss

Ez kiírja a verziót, a szerzőt és a licencet (MIT).

Gyors kezdés: Tölts be egy jelenetet és vizsgáld meg

A következő szkript betölti egy 3D fájlt, kiírja minden hálócsomópont információját, és újraexportálja a jelenetet GLB formátumba:

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")

Ha még nincs OBJ fájlod, a könyvtár képes egy jelenetet is létrehozni a semmiből:

from aspose.threed import Scene

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

Platform megjegyzések

Windows, macOS, Linux: A könyvtár minden platformon azonos. Nincsenek platform‑specifikus kódelágak vagy bináris kiterjesztések.

Docker / serverless: Mivel nincsenek rendszercsomag‑függőségek, a könyvtár működik vékony Docker képekben (például python:3.12-slim) anélkül, hogy további apt vagy yum csomagokat telepítenénk.

CI/CD: Add pip install aspose-3d-foss a CI pipeline függőségi lépéséhez. Nem szükséges további beállítás.

Conda: Ha a projekted Conda-t használ, telepítsd a könyvtárat a PyPI-ról egy Conda környezeten belül:

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

További források

• Termékoldal: Áttekintés, funkciók összefoglalása és vélemények
• Fejlesztői útmutató: Teljes API-referencia kódpéldákkal
• Jellemzők és funkciók: Formátumtámogatás, jelenetgrafikon, anyagok, matematikai segédeszközök és továbbiak