开发者指南

Aspose.3D FOSS for Python 是一个开源、MIT 许可证的库，允许 Python 开发者加载、构建、转换和导出 3D 场景，且无需任何外部运行时依赖。无论您是在构建资产管线、验证工具、几何处理脚本，还是格式转换服务，该库都提供了一个简洁、一致的 API，基于场景图模型，映射行业标准的 3D 概念。.

本开发者指南涵盖了超越快速入门安装、编写生产级 3D 处理代码所需的全部内容。.

本节您将会找到的内容

功能与特性

该 功能 页面是使用 Aspose.3D FOSS for 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 参考摘要:关键类的快速参考列表。.

关键概念

场景图:在 Aspose.3D FOSS 中，所有 3D 内容都表示为一棵树， Node 以对象为根的 scene.root_node.每个节点可以携带一个 Entity (例如一个 Mesh, Camera, 或 Light) 和一个 Transform 将其定位于层次结构中。.

格式无关的 API:：您可以通过以下方式打开任何受支持的格式 Scene.open() 或 Scene.from_file() 并通过以下方式保存为任何受支持的格式 Scene.save().。无论源格式或目标格式如何，均使用相同的场景图对象。.

零依赖:：该库是纯 Python。无需编译本机扩展，无需安装系统软件包，也无需管理第三方库。.

入门指南

如果您尚未安装该库，请参阅 入门指南 章节以及 安装 在继续阅读之前的指南。.

可用主题

  • 功能与特性: 完整的 API 参考，包含每个主要功能区的代码示例。.
 中文