Installatie

Installatie van Aspose.3D FOSS voor Python

Aspose.3D FOSS voor Python wordt gedistribueerd als een pure-Python pakket op PyPI. Er zijn geen native extensies om te compileren, geen systeembibliotheken om te installeren, en geen Microsoft Office of andere runtime van derden vereist.

Vereisten

1. Install via pip (Recommended)

De eenvoudigste manier om Aspose.3D FOSS te installeren is rechtstreeks vanaf PyPI:

pip install aspose-3d-foss

pip downloadt en installeert het pakket en registreert het in je omgeving. Er is geen post-installatieconfiguratie nodig.

Om een vastgezette versie te installeren voor reproduceerbare builds:

pip install aspose-3d-foss==26.1.0

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

Het gebruik van een virtuele omgeving houdt de bibliotheek geïsoleerd van andere Python-projecten en voorkomt versieconflicten.

Maak en activeer een virtuele omgeving:

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

Installeer de bibliotheek binnen de geactiveerde omgeving:

pip install aspose-3d-foss

Registreer afhankelijkheden voor reproduceerbaarheid:

pip freeze > requirements.txt

Om de omgeving op een andere machine te reproduceren:

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

3. Verify the Installation

Na de installatie, controleer of de bibliotheek correct kan worden geïmporteerd:

from aspose.threed import Scene

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

Verwachte output:

Aspose.3D FOSS installed successfully
Root node name:

Opmerking: De rootknooppunt heeft geen standaardnaam — scene.root_node.name geeft een lege string terug.

Je kunt de geïnstalleerde versie ook controleren met pip:

pip show aspose-3d-foss

Dit zal de versie, auteur en licentie (MIT) afdrukken.

Snelstart: Laad een scène en inspecteer deze

Het volgende script laadt een 3D‑bestand, drukt informatie af over elke mesh‑node en exporteert de scène opnieuw naar GLB‑formaat:

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

Als je nog geen OBJ‑bestand hebt, kan de bibliotheek ook een scène vanaf nul maken:

from aspose.threed import Scene

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

Platformopmerkingen

Windows, macOS, Linux: De bibliotheek is identiek op alle platforms. Er zijn geen platformspecifieke codepaden of binaire extensies.

Docker / serverless: Omdat er geen systeem-pakketafhankelijkheden zijn, werkt de bibliotheek binnen slanke Docker‑images (zoals python:3.12-slim) zonder extra apt‑ of yum‑pakketten te installeren.

CI/CD: Toevoegen pip install aspose-3d-foss naar de afhankelijkheidsstap van je CI-pijplijn. Er is geen extra configuratie nodig.

Conda: Als je project Conda gebruikt, installeer de bibliotheek vanaf PyPI binnen een Conda-omgeving:

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

Aanvullende bronnen

• Productpagina: Overzicht, functiebeschrijving en getuigenissen
• Ontwikkelaarsgids: Volledige API-referentie met codevoorbeelden
• Functies en functionaliteiten: Ondersteuning voor formaten, scenegraph, materialen, wiskundige hulpprogramma’s en meer