Instalacija

Instalacija Aspose.3D FOSS za Python

Aspose.3D FOSS za Python se distribuira kao čist-Python paket na PyPI. Nema nativnih ekstenzija za kompajliranje, nema sistemskih biblioteka za instalaciju, i nije potreban Microsoft Office niti drugi treći‑strani runtime.

Preduslovi

1. Install via pip (Recommended)

Najjednostavniji način za instalaciju Aspose.3D FOSS je direktno sa PyPI‑a:

pip install aspose-3d-foss

pip će preuzeti i instalirati paket i zabeležiti ga u vašem okruženju. Nije potrebna nikakva post‑instalaciona konfiguracija.

Za instalaciju fiksirane verzije radi reprodukovanih build‑ova:

pip install aspose-3d-foss==26.1.0

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

Korišćenje virtuelnog okruženja drži biblioteku izolovanom od drugih Python projekata i izbegava konflikte verzija.

Kreirajte i aktivirajte virtuelno okruženje:

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

Instalirajte biblioteku unutar aktiviranog okruženja:

pip install aspose-3d-foss

Zabeležite zavisnosti radi reprodukovanosti:

pip freeze > requirements.txt

Da biste ponovo kreirali okruženje na drugoj mašini:

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

3. Verify the Installation

Nakon instalacije, proverite da li se biblioteka pravilno uvozi:

from aspose.threed import Scene

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

Očekivani izlaz:

Aspose.3D FOSS installed successfully
Root node name:

Napomena: Korenski čvor nema podrazumevano ime — scene.root_node.name vraća prazan string.

Takođe možete proveriti instaliranu verziju pomoću pip-a:

pip show aspose-3d-foss

Ovo će ispisati verziju, autora i licencu (MIT).

Brzi početak: Učitajte scenu i pregledajte je

Sledeći skript učitava 3D fajl, ispisuje informacije o svakom čvoru mreže i ponovo izvozi scenu u 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")

Ako još nemate OBJ fajl, biblioteka takođe može da kreira scenu od nule:

from aspose.threed import Scene

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

Napomene o platformi

Windows, macOS, Linux: Biblioteka je identična na svim platformama. Ne postoje platformno‑specifični kodni putevi niti binarni ekstenziji.

Docker / serverless: Pošto ne postoje zavisnosti sistemskih paketa, biblioteka radi unutar tankih Docker slika (kao što su python:3.12-slim) bez instaliranja dodatnih apt ili yum paketa.

CI/CD: Dodajte pip install aspose-3d-foss u korak zavisnosti vašeg CI pipeline-a. Nije potrebno dodatno podešavanje.

Conda: Ako vaš projekat koristi Conda, instalirajte biblioteku sa PyPI unutar Conda okruženja:

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

Dodatni resursi

• Stranica proizvoda:Pregled, sažetak funkcija i izjave
• Vodič za programere: Kompletna API referenca sa primerima koda
• Karakteristike i funkcionalnosti: Podrška za formate, graf scena, materijali, matematički alati i još mnogo toga