Installation

Installation av Aspose.3D FOSS för Python

Aspose.3D FOSS för Python distribueras som ett ren-Python-paket på PyPI. Det finns inga inhemska tillägg att kompilera, inga systembibliotek att installera och ingen Microsoft Office eller annan tredjepartsruntime krävs.

Förutsättningar

1. Install via pip (Recommended)

Det enklaste sättet att installera Aspose.3D FOSS är direkt från PyPI:

pip install aspose-3d-foss

pip kommer att ladda ner och installera paketet och registrera det i din miljö. Ingen efterinstallationskonfiguration behövs.

För att installera en fast version för reproducerbara byggen:

pip install aspose-3d-foss==26.1.0

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

Att använda en virtuell miljö håller biblioteket isolerat från andra Python-projekt och undviker versionskonflikter.

Skapa och aktivera en virtuell 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

Installera biblioteket i den aktiverade miljön:

pip install aspose-3d-foss

Registrera beroenden för reproducerbarhet:

pip freeze > requirements.txt

För att återskapa miljön på en annan maskin:

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

3. Verify the Installation

Efter installationen, verifiera att biblioteket importeras korrekt:

from aspose.threed import Scene

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

Förväntad output:

Aspose.3D FOSS installed successfully
Root node name:

Obs: Rotnoden har inget standardnamn — scene.root_node.name returnerar en tom sträng.

Du kan också kontrollera den installerade versionen med pip:

pip show aspose-3d-foss

Detta kommer att skriva ut versionen, författaren och licensen (MIT).

Snabbstart: Ladda en scen och inspektera den

Följande skript laddar en 3D-fil, skriver ut information om varje mesh-nod och exporterar scenen igen till 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")

Om du ännu inte har en OBJ-fil kan biblioteket också skapa en scen från grunden:

from aspose.threed import Scene

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

Plattformsanteckningar

Windows, macOS, Linux: Biblioteket är identiskt på alla plattformar. Det finns inga plattformspecifika kodvägar eller binära tillägg.

Docker / serverless: Eftersom det inte finns några systempaketberoenden fungerar biblioteket i tunna Docker‑bilder (såsom python:3.12-slim) utan att installera några ytterligare apt‑ eller yum‑paket.

CI/CD: Lägg till pip install aspose-3d-foss till ditt CI-pipelines beroendesteg. Ingen ytterligare konfiguration krävs.

Conda: Om ditt projekt använder Conda, installera biblioteket från PyPI i en Conda-miljö:

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

Ytterligare resurser

• Produktsida: Översikt, funktionssammanfattning och vittnesmål
• Utvecklarguide: Fullständig API-referens med kodexempel
• Funktioner och funktionalitet: Formatstöd, scengraf, material, matematiska verktyg och mer