Asennus

Python 3.7–3.12:n asennus vaaditaan aspose-3d-foss -asennuksella.

Aspose.3D FOSS Python:lle jaetaan puhtaana Python-pakettina PyPI:ssä. Ei ole natiivisia laajennuksia käännettävänä, ei järjestelmäkirjastoja asennettavana, eikä Microsoft Officea tai muita kolmannen osapuolen ajonaikaisia komponentteja vaadita.

Ehdlytykset

1. Install via pip (Recommended)

Yksinkertaisin tapa asentaa Aspose.3D FOSS on suoraan PyPI:stä:

pip install aspose-3d-foss

pip lataa ja asentaa paketin ja kirjaa sen ympäristöösi. Jälkiasennusasetuksia ei tarvita.

Asentaaksesi kiinnitetyn version toistettavien rakennelmien vuoksi:

pip install aspose-3d-foss==26.1.0

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

Virtuaaliympäristön käyttö pitää kirjaston eristettynä muista Python-projekteista ja välttää versioristiriidat.

Luo ja aktivoi virtuaaliympäristö:

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

Asenna kirjasto aktivoidun ympäristön sisällä:

pip install aspose-3d-foss

Tallenna riippuvuudet toistettavuutta varten:

pip freeze > requirements.txt

Luodaksesi ympäristön uudelleen toisella koneella:

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

3. Verify the Installation

Asennuksen jälkeen tarkista, että kirjasto tuodaan oikein:

from aspose.threed import Scene

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

Odotettu tuotto :

Aspose.3D FOSS installed successfully
Root node name: RootNode

Voit myös tarkistaa asennetun version pipillä:

pip show aspose-3d-foss

Tämä tulostaa version, tekijän ja lisenssin (MIT).

Pika-aloitus: Lataa kohtaus ja tarkastele sitä

Seuraava skripti lataa 3D-tiedoston, tulostaa tietoja jokaisesta verkko-solmusta ja vie kohtauksen uudelleen GLB-muotoon:

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

Jos sinulla ei vielä ole OBJ-tiedostoa, kirjasto voi myös luoda kohtauksen alusta alkaen:

from aspose.threed import Scene

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

Alustan huomautukset

Windows, macOS, Linux: Kirjasto on identtinen kaikilla alustoilla. Alustakohtaisia koodipolkuja tai binaarilaajennuksia ei ole.

Docker / serverless: Koska järjestelmäpakettiriippuvuuksia ei ole, kirjasto toimii ohuiden Docker-kuvien sisällä (kuten python:3.12-slim) asentamatta ylimääräisiä apt- tai yum-paketteja.

CI/CD: Lisää pip install aspose-3d-foss CI-putkesi riippuvuusvaiheeseen. Lisäasetuksia ei tarvita.

Conda: Jos projektisi käyttää Condaa, asenna kirjasto PyPI:stä Conda-ympäristön sisällä:

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

Lisäresurssit

• Tuotesivu: Yleiskatsaus, ominaisuuksien yhteenveto ja asiakaspalautteet
• Kehittäjän opas: Täydellinen API-viite koodiesimerkeillä
• Ominaisuudet ja toiminnot: Tiedostomuotojen tuki, kohtausgrafiikka, materiaalit, matemaattiset apuohjelmat ja paljon muuta