Руководство разработчика

Aspose.3D FOSS для Python — это открытая библиотека с лицензией MIT, позволяющая разработчикам Python загружать, конструировать, трансформировать и экспортировать 3D‑сцены без каких-либо внешних зависимостей во время выполнения. Будь то построение конвейера ассетов, инструмент валидации, скрипт обработки геометрии или сервис конвертации форматов, эта библиотека предоставляет чистый, согласованный API, основанный на модели графа сцены, отражающей отраслевые стандарты 3D‑концепций.

Это Руководство разработчика охватывает всё, что необходимо, чтобы выйти за пределы быстрой установки и писать производственный код обработки 3D.

Что вы найдете в этом разделе

Функции и возможности

Эта Возможности страница является основным справочным материалом для работы с Aspose.3D FOSS для Python. Она охватывает:

  • Поддержка форматов: OBJ (с материалами .mtl), STL (бинарный и ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF и разрабатываемый токенизатор FBX, с классами опций загрузки и сохранения для каждого формата.
  • Граф сцены: Как Scene, Node, Entity, Transform, и GlobalTransform соберите в полную иерархию сцены, включая шаблоны обхода дочерних узлов.
  • Mesh API: Работа с control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, и VertexElementSmoothingGroup для обработки геометрии.
  • Система материалов: Применение LambertMaterial и PhongMaterial к узлам сцены и чтению свойств материалов, загруженных из файлов .mtl.
  • Математические утилиты: Использование Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, и BoundingBox для преобразований, запросов ограничивающих коробок и геометрических вычислений.
  • Анимация: Создание и чтение AnimationClip, AnimationNode, KeyFrame, и KeyframeSequence данные.
  • Параметры загрузки и сохранения: Классы параметров для каждого формата, такие как ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Полные примеры использования: Скрипты сквозного Python для загрузки OBJ, экспорта STL, обратного преобразования glTF и обхода графов сцены.
  • Советы, распространённые проблемы и FAQ: Практические рекомендации по избежанию распространённых подводных камней при промышленном использовании.
  • Сводка справки API: Быстрый справочный список всех ключевых классов.

Ключевые концепции

Граф сцены: Весь 3D‑контент в Aspose.3D FOSS представлен в виде дерева Node объектов, корневых в scene.root_node. Каждый узел может содержать Entity (например Mesh, Camera, или Light) и Transform что размещает его в иерархии.

API, независимое от формата: Вы открываете любой поддерживаемый формат через Scene.open() или Scene.from_file() и сохраняете в любой поддерживаемый формат через Scene.save(). Одни и те же объекты графа сцены используются независимо от исходного или целевого формата.

Нулевые зависимости: Библиотека полностью написана на Python. Нет нативных расширений для компиляции, нет системных пакетов для установки и нет сторонних библиотек для управления.

Начало работы

Если вы ещё не установили библиотеку, см. Начало работы раздел и Установка руководство, прежде чем продолжать чтение.

Доступные темы

 Русский