Instalație

Instalarea Aspose.3D FOSS pentru Python

Aspose.3D FOSS pentru Python este distribuit ca un pachet pure-Python pe PyPI. Nu există extensii native de compilat, nu sunt necesare biblioteci de sistem de instalat și nu este necesar Microsoft Office sau alt runtime de la terți.

Precondiții

1. Install via pip (Recommended)

Cea mai simplă metodă de a instala Aspose.3D FOSS este direct de pe PyPI:

pip install aspose-3d-foss

pip va descărca și instala pachetul și îl va înregistra în mediul tău. Nu este necesară nicio configurare post-instalare.

Pentru a instala o versiune fixă pentru construcții reproductibile:

pip install aspose-3d-foss==26.1.0

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

Folosirea unui mediu virtual menține biblioteca izolată de alte proiecte Python și evită conflictele de versiune.

Creează și activează un mediu virtual:

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

Instalează biblioteca în interiorul mediului activat:

pip install aspose-3d-foss

Înregistrează dependențele pentru reproductibilitate:

pip freeze > requirements.txt

Pentru a recrea mediul pe o altă mașină:

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

3. Verify the Installation

După instalare, verifică că biblioteca se importă corect:

from aspose.threed import Scene

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

Ieșire așteptată:

Aspose.3D FOSS installed successfully
Root node name:

Notă: Nodul rădăcină nu are un nume implicit — scene.root_node.name returnează un șir gol.

Poți verifica, de asemenea, versiunea instalată cu pip:

pip show aspose-3d-foss

Aceasta va afișa versiunea, autorul și licența (MIT).

Începe rapid: Încarcă o scenă și inspecteaz-o

Scriptul următor încarcă un fișier 3D, afișează informații despre fiecare nod de plasă și reexportă scena în format GLB:

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

Dacă nu ai încă un fișier OBJ, biblioteca poate, de asemenea, să creeze o scenă de la zero:

from aspose.threed import Scene

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

Note privind platforma

Windows, macOS, Linux: Biblioteca este identică pe toate platformele. Nu există căi de cod specifice platformei sau extensii binare.

Docker / serverless: Deoarece nu există dependențe de pachete de sistem, biblioteca funcționează în interiorul imaginilor Docker subțiri (cum ar fi python:3.12-slim) fără a instala pachete suplimentare apt sau yum.

CI/CD: Adaugă pip install aspose-3d-foss la pasul de dependență al pipeline-ului tău CI. Nu este necesară nicio configurare suplimentară.

Conda: Dacă proiectul tău folosește Conda, instalează biblioteca din PyPI în interiorul unui mediu Conda:

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

Resurse suplimentare

• Pagina produsului: Prezentare generală, rezumat al caracteristicilor și testimoniale
• Ghid pentru dezvoltatori: Referință completă a API-ului cu exemple de cod
• Caracteristici și funcționalități: Suport pentru formate, graf de scenă, materiale, utilitare matematice și altele