快速入门

Aspose.3D FOSS 用于 Python

欢迎来到 Aspose.3D FOSS for Python,，一个免费、MIT 许可证的库，用于从 Python 加载、构建和导出 3D 场景。本指南将在几分钟内帮助您从全新环境快速创建出可运行的场景。.

前置条件

在安装之前，请确保您的环境满足以下要求：:

Python 版本

  • Python 3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
  • CPython 是参考解释器；所有六个版本均在每个发行版上进行测试

包管理器

  • pip （随所有现代 Python 安装一起捆绑）
  • 不需要其他构建工具、编译器或系统软件包

操作系统

  • 支持 Windows、macOS 和 Linux
  • 该库是纯 Python：无需编译平台特定的本机扩展

安装

使用 pip 从 PyPI 安装：:

pip install aspose-3d-foss

请参阅 安装指南 了解虚拟环境设置、验证步骤以及快速入门代码示例。.

Aspose.3D FOSS 用于 Python

安装完成后，你可以立即：:

  • 加载 OBJ（支持 .mtl 材质），STL，glTF 2.0，GLB，COLLADA 和 3MF 文件
  • 检查 场景层次结构：遍历节点，读取网格，访问顶点法线和 UV 坐标
  • 变换 场景：应用位置、旋转（通过 Quaternion），以及使用 Transform
  • 应用材质:：与 LambertMaterial 和 PhongMaterial 在场景节点上
  • 导出 到任何受支持的格式，并使用每种格式的保存选项
  • 计算几何体: 查询边界框，累积世界空间变换，使用 GlobalTransform
  • 读取动画: 访问 AnimationClip 和 KeyframeSequence 从已加载的 glTF 和 COLLADA 文件中获取数据

快速入门

以下代码加载场景文件，打印根节点的子节点，并以 GLB 格式重新保存场景：:

from aspose.threed import Scene

scene = Scene.from_file("input.obj")

print(f"Root node children: {len(scene.root_node.child_nodes)}")
for node in scene.root_node.child_nodes:
    entity_type = type(node.entity).__name__ if node.entity else "no entity"
    print(f"  {node.name} [{entity_type}]")

scene.save("output.glb")
print("Saved output.glb")

后续步骤

 中文