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

Aspose.3D FOSS for 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‑ранерах, Docker‑контейнерах і безсерверних середовищах. Немає нативного розширення для компіляції та системного пакету для встановлення.

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

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

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

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

Опції для кожного формату та контроль координат

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

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

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

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

# Завантажити файл OBJ (з матеріалами .mtl)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())

# Експортувати як 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")

# Зберегти як бінарний 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. Повідомлення про помилки та запити на злиття вітаються.

  

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

 Українська