Початок роботи

Aspose.3D FOSS для Python

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

Передумови

Перш ніж встановлювати, переконайтеся, що ваше середовище відповідає цим вимогам:

Python Версія

  • Python 3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
  • CPython є референтним інтерпретатором; усі шість версій тестуються в кожному випуску

Менеджер пакетів

  • pip (включено у всі сучасні встановлення Python)
  • Інші інструменти збірки, компілятори чи системні пакети не потрібні

Операційна система

  • Windows, macOS та Linux підтримуються
  • Бібліотека написана повністю на Python: немає нативних розширень, специфічних для платформи, які потрібно компілювати

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

Встановіть з PyPI за допомогою pip:

pip install aspose-3d-foss

Перегляньте Посібник з встановлення для налаштування віртуального середовища, кроків перевірки та швидкого прикладу коду.

Aspose.3D FOSS для Python

Після встановлення ви можете одразу:

  • Завантажити файли OBJ (з підтримкою матеріалів .mtl), STL, glTF 2.0, GLB, COLLADA та 3MF
  • Переглянути ієрархії сцен: обходити вузли, читати меші, отримувати нормалі вершин та UV-координати
  • Трансформувати сцени: застосовувати позиції, обертання (через Quaternion), та масштаби за допомогою Transform
  • Застосувати матеріали: працювати з LambertMaterial і PhongMaterial на вузлах сцени
  • Експорт у будь‑який підтримуваний формат з параметрами збереження для кожного формату
  • Обчислити геометрію: запитувати обмежувальні коробки, накопичувати трансформації у світовому просторі з GlobalTransform
  • Зчитати анімацію: доступ AnimationClip і KeyframeSequence дані з завантажених файлів glTF та COLLADA

Швидкий старт

Наступний код завантажує файл сцени, виводить дочірні елементи кореневого вузла та зберігає сцену у форматі GLB:

from aspose.threed import Scene

scene = Scene.from_file("input.obj")

print(f"Root node children: {len(scene.root_node.child_nodes)}")
for node in scene.root_node.child_nodes:
    entity_type = type(node.entity).__name__ if node.entity else "no entity"
    print(f"  {node.name} [{entity_type}]")

scene.save("output.glb")
print("Saved output.glb")

Наступні кроки

 Українська