Instalace

Instalace Aspose.3D FOSS pro Python

Aspose.3D FOSS pro Python je distribuován jako čistý balíček Pythonu na PyPI. Nejsou k tomu kompilovány žádné nativní rozšíření, nejsou k dispozici žádná systémová knihovny a není vyžadována žádna Microsoft Office nebo jiná doba spuštění třetí strany.

Předpoklady

1. Install via pip (Recommended)

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

Pip stáhne a nainstaluje balíček a zaznamená ho ve vašem prostředí. Není zapotřebí žádné konfigurace po instalaci.

Pro instalaci přilepené verze pro reprodukovatelné buildy:

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

Použití virtuálního prostředí udržuje knihovnu izolovanou od jiných Pythonových projektů a vyhýbá se konfliktům verzí.

Vytvořit a aktivovat 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

Nainstalovat knihovnu do aktivovaného prostředí:

Závislost záznamu na reprodukovatelnosti:

pip freeze > requirements.txt

Pro vytvoř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. Verify the Installation

Po instalaci ověřte, zda knihovna správně dováží:

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: Root node nemá předvolený název scene.root_node.name Vrátí prázdný řetěz.

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

pip show aspose-3d-foss

To vytiskne verzi, autora a licenci (MIT).

Rychlý start: Nahrát scénu a zkontrolovat ji

Následující skript načte 3D soubor, vytiskne informace o každém mřížovém uzlu a znovu vyveze 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, může knihovna 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 stejná. Nejsou zde žádné cesty kódů specifické pro platformu ani binární rozšíření.

Docker / bez serveru: Protože nejsou žádné závislosti na systémových balíčcích, knihovna pracuje uvnitř jemných Docker obrazů (např. python:3.12-slim) bez instalace dalších balíčků apt nebo yum.

CI/CD: Přidání: pip install aspose-3d-foss Žádné další nastavení není zapotřebí.

- Cože ?: Pokud váš projekt používá Condu, nainstalujte knihovnu z PyPI do prostředí Conda:

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

Další zdroje

• Stránka produktu: Přehled, shrnutí prvků a svědectví
• Příručka pro vývojáře: Kompletní odkaz na API s příklady kódů
• Charakteristika a funkčnost: Podpora formátu, grafický graf scény, materiály, matematické nástroje a další