Посібник розробника

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. Не потрібно компілювати нативні розширення, не потрібно встановлювати системні пакети і не потрібно керувати сторонніми бібліотеками.

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

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

Доступні теми

 Українська