Installasjon

Installasjon av Aspose.3D FOSS for Python

Aspose.3D FOSS for Python distribueres som en ren-Python pakke på PyPI. Det finnes ingen native utvidelser som må kompileres, ingen systembiblioteker som må installeres, og ingen Microsoft Office eller annen tredjeparts runtime kreves.

Forutsetninger

1. Install via pip (Recommended)

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

pip install aspose-3d-foss

pip vil laste ned og installere pakken og registrere den i ditt miljø. Ingen etterinstallasjonskonfigurasjon er nødvendig.

For å installere en fastlåst versjon for reproducerbare bygg:

pip install aspose-3d-foss==26.1.0

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

Å bruke et virtuelt miljø holder biblioteket isolert fra andre Python-prosjekter og unngår versjonskonflikter.

Opprett 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 aktiverte miljøet:

pip install aspose-3d-foss

Registrer avhengigheter for reproducerbarhet:

pip freeze > requirements.txt

For å gjenskape miljøet på en annen maskin:

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

3. Verify the Installation

Etter installasjon, verifiser 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 utdata:

Aspose.3D FOSS installed successfully
Root node name:

Merk: Rotnoden har ingen standardnavn — scene.root_node.name returnerer en tom streng.

Du kan også sjekke den installerte versjonen med pip:

pip show aspose-3d-foss

Dette vil skrive ut versjonen, forfatteren og lisensen (MIT).

Rask start: Last inn en scene og inspiser den

Følgende skript laster en 3D-fil, skriver ut informasjon om hver mesh-node, og eksporterer scenen på nytt 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 ennå ikke har en OBJ-fil, kan biblioteket også lage en scene fra bunnen av:

from aspose.threed import Scene

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

Plattformnotater

Windows, macOS, Linux: Biblioteket er identisk på alle plattformer. Det finnes ingen plattformspesifikke kodeveier eller binære utvidelser.

Docker / serverless: Fordi det ikke finnes noen systempakke‑avhengigheter, fungerer biblioteket i slanke Docker‑bilder (som for eksempel python:3.12-slim) uten å installere noen ekstra apt‑ eller yum‑pakker.

CI/CD: Legg til pip install aspose-3d-foss til avhengighetssteget i CI-pipelinen din. Ingen ekstra oppsett er nødvendig.

Conda: Hvis prosjektet ditt bruker Conda, installer biblioteket fra PyPI i et Conda-miljø:

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

Ytterligere ressurser

• Produktside: Oversikt, funksjonssammendrag og uttalelser
• Utviklerguide: Fullstendig API-referanse med kodeeksempler
• Funksjoner og funksjonalitet: Støtte for formater, scene‑graf, materialer, matematiske verktøy og mer