Inštalácia

Inštalácia Aspose.3D FOSS pre Python

Aspose.3D FOSS pre Python je distribuovaný ako čistý-Python balík na PyPI. Nie sú potrebné žiadne natívne rozšírenia na kompiláciu, žiadne systémové knižnice na inštaláciu a nie je potrebný Microsoft Office ani iný runtime tretích strán.

Predpoklady

1. Install via pip (Recommended)

Najjednoduchší spôsob, ako nainštalovať Aspose.3D FOSS, je priamo z PyPI:

pip install aspose-3d-foss

pip stiahne a nainštaluje balík a zaznamená ho vo vašom prostredí. Nie je potrebná žiadna konfigurácia po inštalácii.

Na inštaláciu pevne určeného (pinned) verzie pre reprodukovateľné zostavenia:

pip install aspose-3d-foss==26.1.0

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

Použitie virtuálneho prostredia udržiava knižnicu izolovanú od ostatných projektov Python a zabraňuje konfliktom verzií.

Vytvorte a aktivujte virtuálne prostredie:

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

Nainštalujte knižnicu v aktivovanom prostredí:

pip install aspose-3d-foss

Zaznamenajte závislosti pre reprodukovateľnosť:

pip freeze > requirements.txt

Na obnovenie prostredia na inom počítači:

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

3. Verify the Installation

Po inštalácii overte, že sa knižnica správne importuje:

from aspose.threed import Scene

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

Očakávaný výstup:

Aspose.3D FOSS installed successfully
Root node name:

Poznámka: Koreňový uzol nemá predvolené meno — scene.root_node.name vracia prázdny reťazec.

Môžete tiež skontrolovať nainštalovanú verziu pomocou pip:

pip show aspose-3d-foss

Toto vypíše verziu, autora a licenciu (MIT).

Rýchly štart: Načítajte scénu a skontrolujte ju

Nasledujúci skript načíta 3D súbor, vypíše informácie o každom uzle siete 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")

Ak ešte nemáte OBJ súbor, knižnica dokáže tiež vytvoriť scénu od začiatku:

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ám

Windows, macOS, Linux: Knižnica je na všetkých platformách identická. Neexistujú žiadne platformovo špecifické cesty kódu ani binárne rozšírenia.

Docker / serverless: Pretože neexistujú žiadne závislosti na systémových balíčkoch, knižnica funguje v úzkych Docker obrazoch (napríklad python:3.12-slim) bez inštalácie akýchkoľvek ďalších apt alebo yum balíčkov.

CI/CD: Pridať pip install aspose-3d-foss do kroku závislostí vo vašom CI pipeline. Nie je potrebné žiadne ďalšie nastavenie.

Conda: Ak váš projekt používa Conda, nainštalujte knižnicu z PyPI v rámci Conda prostredia:

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

Ďalšie zdroje

• Stránka produktu: Prehľad, zhrnutie funkcií a referencie
• Príručka pre vývojárov: Kompletná referenčná dokumentácia API s príkladmi kódu
• Funkcie a vlastnosti: Podpora formátov, scénový graf, materiály, matematické nástroje a ďalšie