1. Продукти
  2.   Aspose.3D
  3.   Aspose.3D FOSS for Python

Aspose.3D FOSS для Python

Завантажуйте, створюйте, трансформуйте та експортуйте 3D‑сцени з Python — безкоштовно та з відкритим вихідним кодом.

Aspose.3D FOSS for Python Aspose.3D FOSS
for Python

Документація GitHub

Бібліотека Python з відкритим вихідним кодом для обробки 3D‑файлів

Aspose.3D FOSS для Python — це бібліотека з ліцензією MIT, чисто-Python, для роботи з 3D форматами файлів. Встановіть її за допомогою однієї команди pip і одразу починайте читати, конструювати та записувати 3D сцени без встановлення будь‑якого нативного середовища виконання, зовнішнього SDK або стороннього рендерера.

Бібліотека надає чистий API графу сцени, побудований навколо Scene, Node, Mesh, Camera, Light та Transform, тієї ж концептуальної моделі, яку використовують професійні 3D‑інструменти. Підтримка форматів включає OBJ (з завантаженням матеріалів .mtl), STL (бінарний і ASCII, перевірено у зворотному процесі), glTF 2.0 / GLB (PBR‑матеріали), COLLADA (DAE), 3MF та FBX. Параметри завантаження та збереження для кожного формату дозволяють керувати інвертуванням координат, масштабом, нормалізацією нормалей та завантаженням матеріалів без написання коду парсингу, специфічного для формату.

Aspose.3D FOSS підтримує Python 3.7 до 3.12 і працює ідентично на Windows, macOS та Linux CI‑runner’ах, Docker‑контейнерах і безсерверних середовищах. Для функцій та підтримки корпоративного рівня дивіться Aspose.3D for Python — Enterprise Product.

Підтримка 3D‑форматів та API графа сцени

  • OBJ / MTL: Завантажуйте файли Wavefront OBJ з відповідними визначеннями матеріалів.
  • STL: Читати та записувати як двійкові, так і ASCII STL з повною перевіркою кругового проходу.
  • glTF 2.0 / GLB: Завантаження PBR-матеріалів та бінарний вивід GLB через GltfSaveOptions.
  • COLLADA, 3MF, FBX: Додаткова підтримка форматів з класами параметрів для кожного формату.
  • API графа сцени: Scene, Node, Mesh, Camera, Light, Transform.

Де Aspose.3D FOSS можна використовувати

  • Пайплайни валідації активів: Перевіряти, переорієнтовувати та повторно експортувати 3D-активи в CI.
  • Інструменти розробки ігор: Пакетна обробка OBJ/GLB сіток без нативного рушія.
  • Робочі процеси 3D друку: Читати, перевіряти та повторно експортувати файли STL і 3MF.
  • Web backends: Обслуговуйте 3D конвертаційні кінцеві точки в Docker або безсерверних функціях.
  • Міграція вмісту: Конвертуйте між сімействами форматів у масштабі.

Параметри для кожного формату та контроль координат

  • Орієнтація системи координат: Перевернути осі та налаштувати масштаб для кожного формату без користувацького коду.
  • Нормалізація нормалей: Автоматично нормалізувати нормалі вершин під час завантаження або збереження.
  • Керування завантаженням матеріалів: Увімкнути або вимкнути завантаження MTL/текстур для швидшого розбору.
  • Бінарний vs. JSON вивід: Виберіть компактний GLB або читабельний для людей glTF за допомогою параметрів.
  • Round-trip fidelity: Структура графа сцени зберігається під час циклів завантаження та збереження (точність збереження вузлів залежить від формату і не перевіряється незалежно для всіх форматів).

Досвід розробника

Aspose.3D FOSS для Python встановлюється за допомогою однієї команди pip install aspose-3d-foss. Бібліотека є чистим Python, без нативних розширень для компіляції та без системних пакетів для встановлення.

scene-graph API відображає концептуальну модель професійних 3D‑інструментів, тому крива навчання коротка для будь‑кого, хто знайомий з моделлю даних Three.js або Blender. Бібліотека має ліцензію MIT, є відкритим кодом і вітає повідомлення про помилки та внески на GitHub.

Завантажте сцену OBJ і експортуйте у glTF

Встановіть за допомогою pip, потім викличте Scene.open() з ObjLoadOptions, щоб завантажити файл OBJ разом з його визначеннями матеріалів MTL. Один виклик scene.save() з розширенням .gltf записує файл glTF 2.0 JSON — реєстр форматів або об’єкт конвертера не потрібні.

pip install aspose-3d-foss

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions
# Load an OBJ file (with .mtl materials)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())
# Export as glTF 2.0
scene.save("model.gltf")

Конвертувати STL у бінарний GLB з інвертуванням координат

Щоб створити компактний бінарний GLB замість типового JSON glTF, передайте екземпляр GltfSaveOptions з binary_mode = True. Така ж схема застосовується до налаштувань системи координат — замініть клас параметрів на формат, який ви цілите.

from aspose.threed import Scene
from aspose.threed.formats import GltfSaveOptions
scene = Scene()
scene.open("mesh.stl")
# Save as binary GLB
opts = GltfSaveOptions()
opts.binary_mode = True
scene.save("mesh.glb", opts)

Часті Питання

Що таке Aspose.3D FOSS для Python?

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

Які 3D формати підтримуються?

OBJ (з .mtl), STL (бінарний та ASCII), glTF 2.0 і GLB, COLLADA (DAE), 3MF та FBX. Кожен формат має окремий клас параметрів завантаження/збереження.

Чи потребує воно будь‑яких нативних залежностей?

Ні. Aspose.3D FOSS для Python — це чистий Python без жодних нативних розширень. Працює на Windows, macOS та Linux без будь‑якого кроку компіляції.

Як його встановити?

Запустіть pip install aspose-3d-foss. Додаткові системні пакети або нативні розширення не потрібні.

Чи можу я керувати орієнтацією системи координат?

Так. Класи параметрів для кожного формату дозволяють перевертати осі, регулювати масштаб і нормалізувати нормалі без написання коду парсингу, специфічного для формату.

Які версії Python підтримуються?

Python 3.7‑3.12 підтримуються. Бібліотека працює однаково на всіх основних операційних системах.

Чи доступний вихідний код?

Так. Бібліотека має ліцензію MIT і розміщена на GitHub. Звіти про помилки та pull‑request’и вітаються.

  

Ресурси Підтримки та Навчання

 Українська