简介

Python 是一门面向对象的、交互的解释型编程语言。它集成了模块、异常、动态类型、高水平的动态数据类型和类。Python 兼具强大的功能和清晰的语法。

Python 脚本是一种强大而灵活的用于扩展 Blender 功能的方法。Blender 的大部分功能都可以脚本化，包括动画、渲染、导入与导出、创建物体和自动重复任务的脚本。

脚本可以利用紧密集成的 API 与 Blender 进行交互。

常规资料

对写脚本有帮助的链接：

• Python.org -- 关于 Python 的基本信息。

• Blender Python API -- 官方 API 文档。在编写脚本时，可以用它来参考。

• API 介绍 -- 一个简短的介绍，让你开始使用 API。包含了一些例子。

用于发布脚本的链接：

• Sharing scripts -- Information on how to share your scripts and get them included in the official Blender distribution.

• Creating Add-ons -- Add-ons are used to encapsulate and distribute scripts.

• Add-ons project -- Project to maintain a central repository of extensions to Blender.

入门

手册链接

以下链接包含从基础到进阶的 Blender Python 脚本。

• 文本编辑器

• Python 控制台

• 信息编辑器

外部链接

下面的外部链接包含了很多学习资料，包括如何开始编写 Blender 脚本：

• Python API: 快速入门

• CG Cookie: Blender 2.8 Python Scripting Superpowers for Non-Programmers

• Olav3D 教程: Python新手3D编程

• Blender Artists: Python支持论坛

扩展 Blender

插件

Add-ons are scripts that enable Blender to gain extra functionality; they can be enabled from the Preferences.

在 Blender 可执行文件之外，还有许多人编写的数百个插件：

• Blender 会捆绑一些官方插件。

• Other Testing add-ons are included in development builds of Blender but not official releases. Many of them work reliably and are very useful but are not yet ensured to be stable for release.

See also

Blender内置插件见插件文档。

脚本

除了插件之外，还有其他几种类型的脚本可以扩展 Blender 的功能：

模块

用于导入到其他脚本中的实用进程库。

预设

Blender 工具和关键配置的设置。

启动

这些文档在启动 Blender 时导入。它们定义了 Blender 的大部分 UI，以及一些额外的核心运算符。

自定义脚本

与插件相比，它们通常旨在通过文本编辑器进行一次性执行。

保存你的脚本

文件位置

所有脚本都从本地、系统和用户路径下的 scripts 文件夹载入。

你可以在文件路径 偏好设置 ‣ 文件路径 中设置额外的脚本查找路径。

安装

Add-ons are conveniently installed through Blender in the Preferences. Click the Install... button and select the .py or .zip file.

To manually install scripts or add-ons, place them in the addons, modules, presets, or startup directory according to their type. See the description above.

You can also run scripts by loading them in the Text Editor.