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

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 и обхождане на графове на сцената.
  • Съвети, чести проблеми и ЧЗВ: Практически насоки за избягване на чести капани при продукционно използване.
  • Обобщение на API справочника: Бърз справочник с изброяване на всички ключови класове.

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

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

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

Нулеви зависимости: Библиотеката е чиста Python. Няма нативно разширение за компилиране, няма системен пакет за инсталиране и няма трета страна библиотека за управление.

Започване

Ако все още не сте инсталирали библиотеката, вижте Започване раздела и Инсталация ръководството, преди да продължите с четенето.

Налични теми

 Български