特性

blender的python API有如下特性：

1. 编辑用户界面可以编辑的任意数据(场景，网格，粒子等)。
2. 修改用户首选项、键映射和主题。
3. 运行自己的配置运行工具。
4. 创建用户界面元素，如菜单、标题和面板。
5. 创建新的工具。
6. 场景交互式工具。
7. 创建与Blender集成的新渲染引擎。
8. 修改模型的数据和属性。
9. 在Blender现有的数据中定义新的设置。
10. 使用Python在3D视图中绘制。

目前未实现的特性：

1. 创建新的空间类型。
2. 为每个类型分配自定义属性。

运行脚本

有两种方法运行脚本，第一种是在内置的编辑器中或是在python控制台输入命令。这两种方法都在顶部菜单单击Scripting可以打开，显示在UI布局中。

可以从编辑器打开.py文件或者从剪贴板粘贴代码上去，运行脚本并测试代码。Python控制台通常用于输入代码片段测试以获得即时反馈，但也可以将整个脚本粘贴到其中。

关键概念

数据访问

访问数据块

可以使用Python API来访问Blender的数据，访问加载的blender文件是通过bpy.data完成的。下面是在控制台输出的示例：

>>> bpy.data.objects # 当前对象集合
<bpy_collection[3], BlendDataObjects>
>>> bpy.data.scenes # 当前场景集合
<bpy_collection[1], BlendDataScenes>
bpy.data.materials # 当前材质结合
<bpy_collection[1], BlendDataMaterials>

访问集合

可以通过索引或字符串来访问集合的成员。

import bpy
l = list(bpy.data.objects)
print(l)
print(bpy.data.objects[0])
print(bpy.data.objects['Cube'])
# [bpy.data.objects['Camera'], bpy.data.objects['Cube'], bpy.data.objects['Light']]
# bpy.data.objects["Cube"]
# bpy.data.objects['Cube']

访问属性

可以查看数据块的属性。

>>> bpy.data.objects[0].name
'Camera'
>>> bpy.data.scenes["Scene"]
bpy.data.scenes['Scene']
>>> bpy.data.materials.new("MyMaterial")
bpy.data.materials['MyMaterial']
>>> bpy.data.scenes[0].render.resolution_percentage
100
>>> bpy.data.scenes[0].objects["Cube"].data.vertices[0].co.x
1.0

数据的创建与移除

新的数据块无法通过调用类来创建。

>>> bpy.types.Mesh()
Traceback (most recent call last):File "<blender_console>", line 1