Instalace

Instalace Aspose.3D FOSS pro Python

Aspose.3D FOSS for Python je distribuován jako čistě‑Python balíček na PyPI. Neexistují žádná nativní rozšíření ke kompilaci, žádné systémové knihovny k instalaci a není vyžadován Microsoft Office ani jiný runtime třetí strany.

Požadavky

1. Instalace pomocí pip (doporučeno)

Nejjednodušší způsob, jak nainstalovat Aspose.3D FOSS, je přímo z PyPI:

pip install aspose-3d-foss

pip stáhne a nainstaluje balíček a zaznamená jej ve vašem prostředí. Žádná následná konfigurace po instalaci není potřeba.

Pro instalaci připnuté verze pro reprodukovatelné sestavení:

pip install aspose-3d-foss==26.1.0

2. Nastavte virtuální prostředí (doporučeno pro projekty)

Použití virtuálního prostředí udržuje knihovnu izolovanou od ostatních projektů v Pythonu a zabraňuje konfliktům verzí.

Vytvořte a aktivujte virtuální prostředí:

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

Nainstalujte knihovnu do aktivovaného prostředí:

pip install aspose-3d-foss

Zaznamenat závislosti pro reprodukovatelnost:

pip freeze > requirements.txt

Pro znovuvytvoření prostředí na jiném počítači:

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

3. Ověřte instalaci

Po instalaci ověřte, že se knihovna správně importuje:

from aspose.threed import Scene

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

Očekávaný výstup:

Aspose.3D FOSS installed successfully
Root node name:

Poznámka: Kořenový uzel nemá výchozí název — scene.root_node.name vrací prázdný řetězec.

Můžete také zkontrolovat nainstalovanou verzi pomocí pip:

pip show aspose-3d-foss

Toto vytiskne verzi, autora a licenci (MIT).

Rychlý start: Načtěte scénu a prozkoumejte ji

Následující skript načte 3D soubor, vypíše informace o každém uzlu sítě a znovu exportuje scénu do formátu 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")

Pokud ještě nemáte soubor OBJ, knihovna může také vytvořit scénu od nuly:

from aspose.threed import Scene

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

Poznámky k platformě

Windows, macOS, Linux: Knihovna je na všech platformách identická. Neexistují žádné platformně specifické cesty kódu ani binární rozšíření.

Docker / serverless: Protože neexistují žádné závislosti na systémových balíčcích, knihovna funguje uvnitř slim Docker images (jako python:3.12-slim) bez instalace dalších apt nebo yum balíčků.

CI/CD: Přidejte pip install aspose-3d-foss do kroku závislostí vašeho CI pipeline. Žádné další nastavení není vyžadováno.

Conda: Pokud váš projekt používá Conda, nainstalujte knihovnu z PyPI uvnitř Conda prostředí:

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

Další zdroje

• Product Page: Přehled, souhrn funkcí a reference
• Developer Guide: Kompletní referenční příručka API s ukázkami kódu
• Features and Functionalities: Podpora formátů, graf scény, materiály, matematické utility a další