Инсталиране

Инсталиране на Aspose.3D FOSS за Python

Aspose.3D FOSS for Python се разпространява като чисто‑Python пакет в PyPI. Няма native разширения за компилиране, няма системни библиотеки за инсталиране и не се изисква Microsoft Office или друг трети‑страна runtime.

Предварителни изисквания

1. Инсталиране чрез pip (Препоръчително)

Най‑лесният начин за инсталиране на Aspose.3D FOSS е директно от PyPI:

pip install aspose-3d-foss

pip ще изтегли и инсталира пакета и ще го запише във вашата среда. Не е необходима конфигурация след инсталацията.

За да инсталирате фиксирана версия за възпроизвеждаеми изграждания:

pip install aspose-3d-foss==26.1.0

2. Настройване на виртуална среда (Препоръчително за проекти)

Използването на виртуална среда държи библиотеката изолирана от други Python проекти и избягва конфликтите с версии.

Създайте и активирайте виртуална среда:

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

Инсталирайте библиотеката в активираната среда:

pip install aspose-3d-foss

Записване на зависимостите за възпроизводимост:

pip freeze > requirements.txt

За да възстановите средата на друга машина:

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

3. Проверка на инсталацията

След инсталиране, проверете дали библиотеката се импортира правилно:

from aspose.threed import Scene

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

Очакван изход:

Aspose.3D FOSS installed successfully
Root node name:

Забележка: Кореновият възел няма подразбиращо се име — scene.root_node.name връща празен низ.

Можете също да проверите инсталираната версия с pip:

pip show aspose-3d-foss

Това ще отпечата версията, автора и лиценза (MIT).

Бърз старт: Заредете сцена и я инспектирайте

Следният скрипт зарежда 3D файл, отпечатва информация за всеки възел на мрежата и отново експортира сцената във формат 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")

Ако все още нямате OBJ файл, библиотеката също може да създаде сцена от нулата:

from aspose.threed import Scene

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

Бележки за платформата

Windows, macOS, Linux: Библиотеката е идентична на всички платформи. Няма специфични за платформата кодови пътеки или бинарни разширения.

Docker / serverless: Тъй като няма зависимости от системни пакети, библиотеката работи в тънки Docker образи (като python:3.12-slim) без инсталиране на допълнителни apt или yum пакети.

CI/CD: Добавете pip install aspose-3d-foss към стъпката за зависимости във вашия CI pipeline. Не е необходима допълнителна настройка.

Conda: Ако вашият проект използва Conda, инсталирайте библиотеката от PyPI в Conda среда:

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

Допълнителни ресурси

• Product Page: Общ преглед, резюме на функциите и отзиви
• Developer Guide: Пълен справочник на API с примерен код
• Features and Functionalities: Поддръжка на формати, граф на сцената, материали, математически инструменти и др.