Aspose.3D FOSS
Python
Pradžia
Diegimas

Diegimas

Reikalingas Python 3.7–3.12. Įdiegti su „pip install aspose-3d-foss“.

Aspose.3D FOSS Python platinamas kaip grynas Python paketas PyPI. Nėra jokių natūralių plėtinių, kuriuos reikėtų kompiliuoti, nėra sisteminių bibliotekų, kurias reikia įdiegti, ir nėra reikalingų Microsoft Office ar kitų trečiųjų šalių vykdymo aplinkų.

Reikalavimai

ReikalavimasDetalė
Python versija3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
Paketo tvarkyklėpip (įtrauktas su CPython)
Operacinė sistemaWindows, macOS, Linux (bet kuri platforma, kuri veikia CPython)
Kompiliatorius / kūrimo įrankiaiNereikia
Sistemos paketaiNereikia

1. Install via pip (Recommended)

Paprastaus būdas įdiegti Aspose.3D FOSS yra tiesiogiai iš PyPI:

pip install aspose-3d-foss

pip atsisiųs ir įdiegs paketą bei įrašys jį į jūsų aplinką. Papildoma konfigūracija po įdiegimo nėra reikalinga.

Norėdami įdiegti fiksuotą versiją, kad būtų užtikrintas pakartojamumas:

pip install aspose-3d-foss==26.1.0

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

Naudojant virtualią aplinką biblioteka lieka izoliuota nuo kitų Python projektų ir išvengiate versijų konfliktų.

Sukurkite ir aktyvuokite virtualią aplinką:

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

Įdiekite biblioteką aktyvuotoje aplinkoje:

pip install aspose-3d-foss

Įrašykite priklausomybes, kad būtų pakartojama:

pip freeze > requirements.txt

Norėdami atkurti aplinką kitoje mašinoje:

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

3. Verify the Installation

Po įdiegimo patikrinkite, ar biblioteka teisingai importuojama:

from aspose.threed import Scene

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

Tikėtinas išvestis:

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

Taip pat galite patikrinti įdiegtą versiją naudodami pip:

pip show aspose-3d-foss

Tai atspausdins versiją, autorių ir licenciją (MIT).

Greitas pradžia: Įkelti sceną ir ją patikrinti

Šis scenarijus įkelia 3D failą, atspausdina informaciją apie kiekvieną tinklelio mazgą ir iš naujo eksportuoja sceną į 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")

Jei dar neturite OBJ failo, biblioteka taip pat gali sukurti sceną nuo pat pradžių:

from aspose.threed import Scene

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

Platformų pastabos

Windows, macOS, Linux: Biblioteka yra identiška visose platformose. Nėra platformai specifinių kodo kelių ar binarinių plėtinių.

Docker / serverless: Kadangi nėra sistemos paketų priklausomybių, biblioteka veikia plonose Docker atvaizduose (pvz. python:3.12-slim) be neįdiegiant jokių papildomų apt arba yum paketų.

CI/CD: Pridėti pip install aspose-3d-foss į jūsų CI konvejerio priklausomybės žingsnį. Papildomas nustatymas nereikalingas.

Conda: Jei jūsų projektas naudoja Conda, įdiekite biblioteką iš PyPI Conda aplinkoje:

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

Papildomi ištekliai

 Lietuvių