Blender Python API中文介绍文档一

前言：Blender Python API没有中文教程，尝试翻译了官网的入门文档，因英文水平有限，很多是直译，希望各位能够多多指正，也希望这篇翻译对你多少有一丝作用

脚本和扩展

Python
是一个解释，交互，面向对象的编程语言。它集成了模块，异常处理，动态类型，高级动态数据

类型，和类。它有着强大的功能和清晰的语义

python
将 blender
拓展地功能强大且具有通用性，blender
各个方面都可以用脚本来实现，包括动画，

渲染，导入导出，创建对象，脚本实现重复任务。

为了和blender交互，脚本需要使用紧密集成的API

基本信息

下面的链接对些脚本是有帮助的：

1.Python.org-python的基本信息

2.Blender Python API-Blender
Python API

3.API introductionAPI介绍

4.CookBook-菜谱

下面的链接是为了发布你的脚本

1.Sharing scripts-共享脚本

2.Creating Add-ons-创建插件

3.Extensions
project-扩展工程-维持blender扩展的中央学习库

开始-手册链接

以下链接帮助你对
python 脚本和
blender 从基本过度到高级认知

1.Text Editor-文档编辑器

Blender 有一个文本编辑器，快捷键为
shift-F11

新打开的文本编辑器是灰色且为空

从左到右，有标准的窗口类型选择按钮和窗口菜单，然后是文本ID浏览按钮，新建按钮

添加文件后会显示你所添加的文件名字，接着是+按钮，X按钮用来删除文本

接下来三个按钮是行号，自动换行，语义高亮

下面是键盘快捷键命令：

ctrl-c/x/v

ctrl-d复制当前文本

tab 间隔

shift+tab 非间隔s

hift-ctrl-alt-s文件选择

alt-s 保存当前文档

alt-o 加载文档，文件选择器出现

alt-p执行脚本

ctrl-z 撤销

ctrl-shift-z 取消撤销

alt-R重新打开当前文档

文本编辑窗口可以写 README,保存的时候要确定它是可见的

2.Python
Console-python终端

shift-F4
启动

为了检查解释器中加载的东西，输入
dir（）并执行

以下是输入的快速预览：

C:迅速进入
bpy.context

D:迅速进入
bpy.data

autocomplete:迅速补全，当你输入
bpy.后点击自动补全会绿色显示所有的模块名字

1)所有的物体都在
context 中，有各种操作方式

2)任何情况下，只有一个物体被激活，但是可以有多个物体被选择

3)所有的物体作为数据（data）存放于blender中

例子：

bpy.context:

上面列出的所有场景（并非所有）都可以通过 bpy模块提供相关的功能和修改数据

以下是一些简单的测试：

bpy.context.object.location= (1,2,3)
bpy.context.object.location.xyz= (1,2,3)
bpy.context.object.location.x+= 0.5

bpy.data:

提供功能和属性，来操作 blender
文件中的所有数据

你可以得到以下数据，通过当前 blender
文件：

objects,meshes,matrials,textures,scenes,screen,sounds,scripts等

bpy.ops:

工具系统是建立在操作器的概念之上，操作典型执行通过按钮和菜单，也可以直接通过终端来操作

详细见 api
文档

让我们在 3D
视图中建立五个立方体，首先删除存在的立方体，选择它-并按下X

mylayers = [False] *20
mylayers[0] =True
add_cube = bpy.ops.mesh.primitive_cube_add
for index in range(5):

开始-拓展链接

以下是外部链接，包含很多有用的信息，方便开始学习
blender 脚本开发

1.Introductory tutorial by Satish Goda帮助你开始，教导你如何进行基本的API控制

2.Ira Krakow’s video tutorials-系列教程中的第一部

3.Quickstart guide
- .一个快速的开始对于那些已经熟悉了部分 python和blender的人

4.Examples thread
- 一个论坛包括了很多短小的脚本例子

5.Introduction
to Python -一个一小时教程关于Python和Blender
的.

扩展 Blender

插件

插件是
blender 中你可以得到额外功能的脚本，它们可以从用户自定义界面激活

大约有上百个插件，为很多人所开发

1.官方支持的插件与blender是捆绑的

2.其他测试中的脚本在开发者版本中包含，但是没有在官方发布版中，很多脚本工作可靠，非常有用，但

是不一定会在发布版中运行稳定

若要了解全部插件，请看脚本结构和扩展跟踪Scripts
Catalog and
Extensions tracker.

脚本

除了插件，也有其他脚本可以使用来扩展
blender 的功能

1.模块：作为库来导入其他脚本中

2.预置：blender工具的设置和关键配置

3.启动：这些文件可以在blender启动时加载，blender大多数界面和一些额外的操作都在其中定义

4.用户脚本：对比于插件，这是典型的一次执行用过文本编辑面板

保存你自己的脚本

文件定位

所有的脚本都从脚本目录加载，本地，系统，用户路径

你可以设置一个额外的搜索路径（用户自定义-文件路径）

安装

插件很方便安装，通过用户自定义-插件窗口，点击从文件安装按钮，选择py文件或zip文件

手动安装脚本和插件的方式，是把它们放置在插件，模块，预置，启动路径下，究竟哪种路径取决于插

件或脚本的类型

你也可以将它们加载到文本编辑面板中来运行