Aspose.3D FOSS
Python
Početak rada
Instalacija

Instalacija

Treba instalirati s ‘pip install aspose-3d-foss’.

Aspose.3D FOSS za Python distribuira se kao čist-Python paket na PyPI-ju. Nema izvornih ekstenzija za kompilaciju, nema sistemskih biblioteka za instalaciju i ne zahtijeva Microsoft Office niti druge treće strane runtime.

Preduvjeti

ZahtjevDetalj
Python verzija3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
Upravitelj paketapip (ugrađen uz CPython)
Operativni sustavWindows, macOS, Linux (bilo koja platforma koja pokreće CPython)
Kompajler / alati za izgradnjuNije potrebno
Sistemski paketiNije potrebno

1. Install via pip (Recommended)

Najjednostavniji način za instalaciju Aspose.3D FOSS je izravno s PyPI-ja:

pip install aspose-3d-foss

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

Za instalaciju fiksirane verzije radi reproducibilnih izgradnji:

pip install aspose-3d-foss==26.1.0

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

Korištenje virtualnog okruženja drži biblioteku izoliranom od drugih Python projekata i izbjegava sukobe verzija.

Stvorite i aktivirajte virtualno 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

Zabilježite ovisnosti radi reproducibilnosti:

pip freeze > requirements.txt

Za ponovno stvaranje okruženja na drugom računalu:

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

3. Verify the Installation

Nakon instalacije, provjerite da 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: RootNode

Također možete provjeriti 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

Sljedeći skript učitava 3D datoteku, ispisuje informacije o svakom čvoru mreže i ponovno 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 datoteku, biblioteka također može stvoriti 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: Budući da ne postoje ovisnosti o sistemskim paketima, biblioteka radi unutar tankih Docker slika (kao što su python:3.12-slim).

CI/CD: Dodaj pip install aspose-3d-foss u korak ovisnosti vašeg CI pipelinea. Nije potrebno dodatno postavljanje.

Conda: Ako vaš projekt koristi Conda, instalirajte biblioteku s PyPI unutar Conda okruženja:

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

Dodatni resursi

 Hrvatski