Встановлення

Встановлення Aspose.3D FOSS для Python

Aspose.3D FOSS для Python розповсюджується як чистий Python пакет на PyPI. Немає нативних розширень для компіляції, немає системних бібліотек для встановлення, і не потрібен Microsoft Office чи інше стороннє середовище виконання.

Вимоги

1. Install via pip (Recommended)

Найпростіший спосіб встановити Aspose.3D FOSS — безпосередньо з PyPI:

pip install aspose-3d-foss

pip завантажить і встановить пакет і зафіксує його у вашому середовищі. Додаткове налаштування після встановлення не потрібне.

Щоб встановити зафіксовану версію для відтворюваних збірок:

pip install aspose-3d-foss==26.1.0

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

Використання віртуального середовища тримає бібліотеку ізольованою від інших проєктів 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. Verify the Installation

Після встановлення перевірте, чи бібліотека імпортується правильно:

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 конвеєра. Додаткове налаштування не потрібне.

Conda: Якщо ваш проєкт використовує Conda, встановіть бібліотеку з PyPI всередині середовища Conda:

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

Додаткові ресурси

• Сторінка продукту: Огляд, короткий опис функцій та відгуки
• Посібник розробника: Повний довідник API з прикладами коду
• Функції та можливості: Підтримка форматів, граф сцени, матеріали, математичні утиліти та інше