Установка

Установка Aspose.3D FOSS для Python

Aspose.3D FOSS for 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 с примерами кода
• Функции и возможности: Поддержка форматов, граф сцены, материалы, математические утилиты и многое другое