Installation

Installation af Aspose.3D FOSS til Python

Aspose.3D FOSS for Python distribueres som en ren‑Python‑pakke på PyPI. Der er ingen native udvidelser at kompilere, ingen systembiblioteker at installere, og hverken Microsoft Office eller andre tredjeparts‑runtime er påkrævet.

Forudsætninger

1. Installer via pip (Anbefalet)

Den enkleste måde at installere Aspose.3D FOSS på er direkte fra PyPI:

pip install aspose-3d-foss

pip vil downloade og installere pakken og registrere den i dit miljø. Ingen efterinstallationskonfiguration er nødvendig.

For at installere en fastlåst version for reproducerbare builds:

pip install aspose-3d-foss==26.1.0

2. Opsæt et virtuelt miljø (anbefalet til projekter)

Brug af et virtuelt miljø holder biblioteket isoleret fra andre Python‑projekter og undgår versionskonflikter.

Opret og aktiver et virtuelt miljø:

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

Installer biblioteket i det aktiverede miljø:

pip install aspose-3d-foss

Registrer afhængigheder for reproducerbarhed:

pip freeze > requirements.txt

For at genskabe miljøet på en anden maskine:

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

3. Bekræft installationen

Efter installationen skal du bekræfte, at biblioteket importeres korrekt:

from aspose.threed import Scene

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

Forventet output:

Aspose.3D FOSS installed successfully
Root node name:

Note: Røtnoden har ingen standardnavn — scene.root_node.name returnerer en tom streng.

Du kan også tjekke den installerede version med pip:

pip show aspose-3d-foss

Dette vil udskrive versionen, forfatteren og licensen (MIT).

Hurtig start: Indlæs en scene og inspicer den

Det følgende script indlæser en 3D‑fil, udskriver information om hver mesh‑node og eksporterer scenen igen til GLB‑format:

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

Hvis du endnu ikke har en OBJ-fil, kan biblioteket også oprette en scene fra bunden:

from aspose.threed import Scene

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

Platformnoter

Windows, macOS, Linux: Biblioteket er identisk på alle platforme. Der er ingen platformspecifikke kodeveje eller binære udvidelser.

Docker / serverless: Fordi der ikke er nogen systempakke‑afhængigheder, fungerer biblioteket i slanke Docker‑images (såsom python:3.12-slim) uden at installere yderligere apt‑ eller yum‑pakker.

CI/CD: Tilføj pip install aspose-3d-foss til din CI-pipelines afhængighedstrin. Ingen yderligere opsætning er påkrævet.

Conda: Hvis dit projekt bruger Conda, installer biblioteket fra PyPI inden for et Conda-miljø:

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

Yderligere ressourcer

• Product Page: Oversigt, funktionsoversigt og udtalelser
• Developer Guide: Komplet API-reference med kodeeksempler
• Features and Functionalities: Formatunderstøttelse, scenegraph, materialer, matematiske værktøjer og mere