描述

3DCoat Python API旨在触发 UI 命令、操作场景和创建新工具。它与 C++Core API非常相似，但有其自身的优点和缺点。

• 不需要任何额外的设置来制作你的脚本； Python 嵌入到3DCoat分发包中。
• Python 就像一把瑞士刀，让您可以将 Python 库的全部功能带入3DCoat中。
• Python 比 C++ 慢很多，所以它可能只用于一般管理，而不用于深度和复杂的算法。
• 如果您已经熟悉 C++ Core API，那么 Python API 非常相似，几乎是 1:1，具有相同的逻辑和函数名称。

用法

• 使用Scripts->Create Python Script创建一个新脚本。您可以选择一个初始模板开始。 .py 文件将在与 .py 文件关联的当前编辑器中打开。
• 我们使用嵌入式Python 3.8.10来操作。这是最后一个可以在 Windows 7 上运行的 Python 版本。
• 如果需要，您可以创建一个名为 requirements.txt 的文件，其中包含已用模块的列表；在这种情况下，模块将在脚本运行之前自动安装。
• 我们推荐 Visual Studio Code，因为它会自动识别3DCoat专用命令语法并提供正确的提示。
• 注意：位于项目文件夹中的文件 coat.pyi 负责 Visual Studio 中的 coat 模块提示。您可以打开该文件，因为它包含所有类和命令的列表，这可能有助于快速参考。
• 使用Scripts->Show Python Console查看 Python 的控制台输出。目前这是调试 scripth 的唯一方法。稍后我们计划使用 Visual Studio Code 添加本机调试。
• 您可以使用Scripts->Install Python Modules为 Python 安装额外的模块。另一种方法是在与 .py 文件所在位置相同的文件夹中使用 requirements.txt。

主要课程

通用 I/O： coat.io
对话框管理： coat.dialog
网格操作： coat.Mesh
场景根源： coat.Scene
场景元素： coat.SceneElement
体积管理： coat.Volume
界面管理： coat.ui
二维向量数学： coat.vec2
3D 向量数学： coat.vec3
4D 向量数学： coat.vec4
3D 矩阵数学： coat.mat3
4D 矩阵数学： coat.mat4
对称管理： coat.symm