Python 控制台#
Python 控制台为测试代码片段和探索 Blender 的 API 提供了一种快捷方式。它会执行您在 >>>
提示符上输入的任何内容,并具有命令历史记录和自动完成功能。
界面#
主视图#
键位绑定
LMB -- 沿着输入行移动光标。
Left / Right -- 光标移动一个字符距离。
Ctrl-Left / Ctrl-Right -- 光标移动一个单词距离。
Shift-Left / Shift-Right -- 选择左/右侧的字符。
Shift-Ctrl-Left / Shift-Ctrl-Right -- 选择左/右侧的单词。
Ctrl-A 选择所有文本和文本历史。
回退键 / Delete -- 擦除字符。
Ctrl-回退键 / Ctrl-Delete -- 擦除单词。
Return -- 执行命令。
Shift-Return -- 添加到命令历史记录而不执行。
用法#
别名#
一些变量和模块可以方便使用:
C
: 快速访问bpy.context
。D
: 快速访问bpy.data
。bpy
: 顶层级 Blender Python API 模块。
初探控制台环境#
要查看全局函数和变量列表,请键入 dir()
并按 回车 执行。
自动补全#
控制台可以预览模块或变量的可用成员。例如,键入 bpy.
并按 Tab:
子模块以绿色列出。属性和方法将以同样的方式列出,方法用尾部的 (
表示。
示例#
bpy.context#
通过该模块可以访问当前场景、当前选中的物体、当前物体模式等。
Note
要使以下命令显示正确的输出,请确保在3D视图中有选中的物体。
获取当前3D视图的模式 (物体、 编辑、 雕刻等):
bpy.context.mode
获取活动物体:
bpy.context.object
bpy.context.active_object
将活动物体 X 坐标更改为 1:
bpy.context.object.location.x = 1
将活动物体沿 X 轴移动 0.5:
bpy.context.object.location.x += 0.5
一次性更改所有三个位置坐标:
bpy.context.object.location = (1, 2, 3)
只更改 X 和 Y 坐标:
bpy.context.object.location.xy = (1, 2)
获取选中的物体:
bpy.context.selected_objects
获取除了活动项以外的选中物体:
[obj for obj in bpy.context.selected_objects if obj != bpy.context.object]
bpy.data#
让您可以访问 blend 文件中的所有数据,无论其当前是否处于活动状态或已被选中。
bpy.ops#
“操作符” 是通常由按钮或菜单项触发的操作,但也可以通过编程调用。有关所有操作符的列表,请参阅 bpy.ops API 文档。