Instalēšana

Instalēšana Aspose.3D FOSS priekš Python

Aspose.3D FOSS priekš Python tiek izplatīts kā tīrs-Python pakotne PyPI. Nav jākompilē vietējie paplašinājumi, nav jāinstalē sistēmas bibliotēkas, un nav vajadzīgs Microsoft Office vai kāds cits trešās puses izpildlaiks.

Priekšnosacījumi

1. Install via pip (Recommended)

Visvienkāršākais veids, kā instalēt Aspose.3D FOSS, ir tieši no PyPI:

pip install aspose-3d-foss

pip lejupielādēs un instalēs pakotni, un to reģistrēs jūsu vidē. Nav vajadzīga papildu konfigurācija pēc instalēšanas.

Lai instalētu fiksētu versiju reproducējamiem būvēšanas procesiem:

pip install aspose-3d-foss==26.1.0

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

Virtuālās vides izmantošana saglabā bibliotēku izolētu no citiem Python projektiem un novērš versiju konfliktus.

Izveidojiet un aktivizējiet virtuālo vidi:

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

Instalējiet bibliotēku aktivizētajā vidē:

pip install aspose-3d-foss

Reģistrējiet atkarības reproducējamībai:

pip freeze > requirements.txt

Lai atjaunotu vidi citā datorā:

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

3. Verify the Installation

Pēc instalēšanas pārbaudiet, vai bibliotēka tiek importēta pareizi:

from aspose.threed import Scene

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

Sagaidāmais izvadījums:

Aspose.3D FOSS installed successfully
Root node name:

Piezīme: Saknes mezglam nav noklusējuma nosaukuma — scene.root_node.name atgriež tukšu virkni.

Jūs varat arī pārbaudīt instalēto versiju, izmantojot pip:

pip show aspose-3d-foss

Tas izdrukās versiju, autoru un licenci (MIT).

Ātrais sākums: ielādējiet ainu un pārbaudiet to

Sekojošais skripts ielādē 3D failu, izdrukā informāciju par katru režģa mezglu un atkārtoti eksportē ainu GLB formātā:

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

Ja jums vēl nav OBJ faila, bibliotēka var arī izveidot ainu no nulles:

from aspose.threed import Scene

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

Platformas piezīmes

Windows, macOS, Linux: Bibliotēka ir identiska visās platformās. Nav platformai specifisku koda ceļu vai bināru paplašinājumu.

Docker / serverless: Tā kā nav sistēmas pakotņu atkarību, bibliotēka darbojas slaidu Docker attēlos (piemēram python:3.12-slim) bez papildu apt vai yum pakotņu instalēšanas.

CI/CD: Pievienot pip install aspose-3d-foss jūsu CI cauru līnijas atkarību solim. Papildu iestatīšana nav nepieciešama.

Conda: Ja jūsu projekts izmanto Conda, instalējiet bibliotēku no PyPI iekš Conda vides:

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

Papildu resursi

• Produkta lapa:Pārskats, funkciju kopsavilkums un atsauksmes
• Izstrādātāja rokasgrāmata: Pilnīgs API atsauce ar koda piemēriem
• Funkcijas un iespējas: Formāta atbalsts, ainas grafiks, materiāli, matemātikas utilītprogrammas un vairāk