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‑сцены без установки какого-либо нативного runtime, внешнего 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‑контейнерах и безсерверных средах. Для корпоративных функций и поддержки см. 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/texture для более быстрого разбора.
  • Бинарный 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-licensed, open-source и приветствует сообщения об ошибках и вклады на 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. Сообщения об ошибках и запросы на включение изменений приветствуются.

  

Ресурсы поддержки и обучения

 Русский