课程
Updated Registration Method
emmmm 就是把 register() 里注册的类放到一个 for 循环里：
def register():
bpy.utils.register_class(NODE_OT_compGroup)
bpy.utils.register_class(NODE_PT_customPanel)
def unregister():
bpy.utils.unregister_class(NODE_OT_compGroup)
bpy.utils.unregister_class(NODE_PT_customPanel)
if __name__ == "__main__":
register()改为：
classes = [NODE_OT_compGroup, NODE_PT_customPanel, YOUR_CLASS_NAME]
def register():
for cls in classes:
bpy.utils.register_class(cls)
def unregister():
for cls in classes:
bpy.utils.unregister_class(cls)
if __name__ == "__main__":
register()5 Scripting Tips for Beginners
介绍了一些小技巧：
在 python console 里，输入代码：
列出场景中已有的 3D 物体：
list(bpy.data.objects)列出场景中已有的材质：
list(bpy.data.materials)新建一个材质：
bpy.data.materials.new("My Material")Text Editor 中，Text-Live Edit 可以实时运行脚本。
Enumerator / Drop down Menu
这段代码定义了两个类和两个函数，用于在 Blender 中添加一个面板和一个操作员。
- ADDONNAME_PT_TemplatePanel 类 该类继承自 bpy.types.Panel，它创建了一个面板并定义了它的一些属性。bl_label 属性定义了面板的名称，bl_idname 属性是面板的唯一标识符，bl_space_type 和 bl_region_type 属性定义了面板在哪个空间和区域中显示，bl_category 属性定义了面板应该显示在哪个选项卡中。draw() 方法定义了面板的布局和内容，layout 变量用来管理面板的布局和元素，layout.operator() 方法添加了一个操作按钮，该按钮调用名为 "wm.template_operator" 的操作员。
- ADDONANE_OT_TemplateOperator 类 该类继承自 bpy.types.Operator，它创建了一个操作员，并定义了它的一些属性。bl_label 属性创建了操作员的按钮标签，bl_idname 属性是操作员的唯一标识符。preset_enum 属性是一个枚举值，它提供了三个不同的选项，每个选项都有一个唯一的 id、一个名称和一个描述。invoke() 方法定义了当用户单击操作员时执行的代码，draw() 方法定义了操作员的布局和内容，execute() 方法定义了操作员执行的代码。
- register() 函数 该函数使用 bpy.utils.register_class() 方法注册 ADDONNAME_PT_TemplatePanel 和 ADDONANE_OT_TemplateOperator 两个类，将它们添加到 Blender 中。
- unregister() 函数 该函数使用 bpy.utils.unregister_class() 方法取消注册 ADDONNAME_PT_TemplatePanel 和 ADDONANE_OT_TemplateOperator 两个类，将它们从 Blender 中移除。
最后，如果该脚本被直接运行（而不是被其他脚本导入），则调用 register() 函数将 ADDONNAME_PT_TemplatePanel 和 ADDONANE_OT_TemplateOperator 两个类添加到 Blender 中。
import bpy
class ADDONNAME_PT_TemplatePanel(bpy.types.Panel):
bl_label = 'Name of the Panel'
bl_idname = 'ADDONNAME_PT_TemplatePanel'
bl_space_type = 'VIEW_3D'
bl_region_type = 'UI'
bl_category = 'Template Tab'
def draw(self, context):
layout = self.layout
layout.operator('wm.template_operator')
class ADDONANE_OT_TemplateOperator(bpy.types.Operator):
bl_label = 'Template Operator'
bl_idname = 'wm.template_operator'
preset_enum: bpy.props.EnumProperty(
name='',
description='Select an option',
items=[
('OP1', 'Cube', 'Add a Cube to the scene'),
('OP2', 'Sphere', ''),
('OP3', 'Suzanne', 'Add Suzanne to the scene')
]
)
def invoke(self, context, event):
wm = context.window_manager
return wm.invoke_props_dialog(self)
def draw(self, context):
layout = self.layout
layout.prop(self, 'preset_enum')
def execute(self, context):
if self.preset_enum == 'OP1':
bpy.ops.mesh.primitive_cube_add()
if self.preset_enum == 'OP2':
bpy.ops.mesh.primitive_uv_sphere_add()
if self.preset_enum == 'OP3':
bpy.ops.mesh.primitive_monkey_add()
return {'FINISHED'}
def register():
bpy.utils.register_class(ADDONNAME_PT_TemplatePanel)
bpy.utils.register_class(ADDONANE_OT_TemplateOperator)
def unregister():
bpy.utils.unsregister_class(ADDONNAME_PT_TemplatePanel)
bpy.utils.unregister_class(ADDONANE_OT_TemplateOperator)
if __name__ == '__main__':
register()运行代码，enum 会创建一个下拉菜单：
Class Naming Convention
介绍了 Blender 命名传统规则：Darkfall : Blender Python Tutorial: Class Naming Convention (darkfallblender.blogspot.com)
How to create and assign a Material Shader
这段代码实现了一个简单的 Blender 插件，在 3D 视图空间中添加了一个面板和一个操作。具体解释如下：
import bpy导入了 Blender 的 Python API。ADDONNAME_PT_main_panel(bpy.types.Panel)定义了一个继承自bpy.types.Panel的面板类，并将其命名为ADDONNAME_PT_main_panel。在类的内部，定义了面板的相关属性和draw()方法。- 在
bl_label中指定了面板标签文本，bl_idname中指定了面板的 ID。bl_space_type指定了面板支持的空间类型，这里使用'VIEW_3D'表示只会在 3D 视图空间中显示。bl_region_type指定了面板所占的区域类型，这里使用'UI'表示在 UI 区域中显示。bl_category指定了面板所属的类别，这里使用'New Tab'表示添加到一个名为'New Tab'的新标签页中。- 在
draw()方法中，通过self.layout.operator()添加了一个操作按钮，用于执行ADDONNAME_OT_add_basic操作。ADDONNAME_OT_add_basic(bpy.types.Operator)类定义了一个继承自bpy.types.Operator的操作类，并将其命名为ADDONNAME_OT_add_basic。其中，bl_label指定了操作在 UI 中的显示名称，bl_idname指定了操作的 ID。- 在类中定义了一个名为
col的属性，类型为bpy.props.FloatVectorProperty。这个属性是一个四元组，表示 RGBA 颜色值。execute()方法中实现了插件的核心逻辑，用于创建一个新的材质，并将其应用到当前选择的对象上。具体来说，这个方法中首先创建了一个名为material_basic的新材质，并设置其使用节点。然后通过material_basic.node_tree.nodes.get('Principled BSDF')获取材质的 Principled BSDF 节点，并将其 metallic 参数设置为 0.08。接着，创建了一个 ShaderNodeRGB 节点，并将其颜色值设置为self.col中存储的颜色值。最后，通过material_basic.node_tree.links.new()创建了两个节点之间的连接，并将材质应用到当前选择的对象上。invoke()方法用于在用户执行操作时打开一个小型对话框，以便用户在对话框中设置属性值。返回值表示执行结果。classes = [ADDONNAME_PT_main_panel, ADDONNAME_OT_add_basic]定义了一个列表，其中包含了需要进行注册的所有类。- 在
register()函数中，使用bpy.utils.register_class()分别注册了classes列表中的每一个类。- 在
unregister()函数中，使用bpy.utils.unregister_class()分别注销了classes列表中的每一个类。if __name__ == "__main__": register()是一个常用的语法，表示在插件文件被直接运行时自动执行注册函数进行注册。
原网址 Darkfall : Blender Python Tutorial: How to Create and Assign a Shader Material (darkfallblender.blogspot.com) 下的代码太旧了，要把 col = bpy.props.FloatVectorProperty(name= "Color", subtype= 'COLOR_GAMMA', size=4, default=(0.0, 1.0, 0.0, 1.0)) 改成 col: bpy.props.FloatVectorProperty(name= "Color", subtype= 'COLOR_GAMMA', size=4, default=(0.0, 1.0, 0.0, 1.0)) 才能跑，这是我第二次进坑了 orz
import bpy
class ADDONNAME_PT_main_panel(bpy.types.Panel):
bl_label = "Add Shader Panel"
bl_idname = "ADDONNAME_PT_main_panel"
bl_space_type = 'VIEW_3D'
bl_region_type = 'UI'
bl_category = 'New Tab'
def draw(self, context):
layout = self.layout
layout.operator("addonname.addbasic_operator")
class ADDONNAME_OT_add_basic(bpy.types.Operator):
bl_label = "Add Basic Shader"
bl_idname = "addonname.addbasic_operator"
col: bpy.props.FloatVectorProperty(name= "Color", subtype= 'COLOR_GAMMA', size=4, default=(0.0, 1.0, 0.0, 1.0))
def execute(self, context):
material_basic = bpy.data.materials.new(name= "Basic")
material_basic.use_nodes = True
principled_node = material_basic.node_tree.nodes.get('Principled BSDF')
principled_node.inputs[7].default_value = 0.08
rgb_node = material_basic.node_tree.nodes.new('ShaderNodeRGB')
rgb_node.location = (-250, 0)
rgb_node.outputs[0].default_value = self.col
link = material_basic.node_tree.links.new
link(rgb_node.outputs[0], principled_node.inputs[0])
bpy.context.object.active_material = material_basic
return {'FINISHED'}
def invoke(self, context, event):
return context.window_manager.invoke_props_dialog(self)
classes = [ADDONNAME_PT_main_panel, ADDONNAME_OT_add_basic]
def register():
for cls in classes:
bpy.utils.register_class(cls)
def unregister():
for cls in classes:
bpy.utils.unregister_class(cls)
if __name__ == "__main__":
register()开跑！
Create Property Group & Enumerator (Panel)
这段代码是一个 Blender 插件的示例，用来创建一个面板和操作符，实现一些简单的功能。
首先，定义了一个
MyProperties类，继承自bpy.types.PropertyGroup。它定义了三个属性：my_string属性为字符串类型，显示为一个文本框；my_float_vector为浮点向量类型，显示为三个滑块；my_enum为枚举类型，显示为一个下拉菜单，其中包含三个不同的操作选项。然后，定义了一个
ADDONNAME_PT_main_panel类，继承自bpy.types.Panel。它定义了一个面板，包含上述三个属性的控件，并在最后添加了一个名为addonname.myop_operator的操作符按钮。接下来，定义了一个
ADDONNAME_OT_my_op类，继承自bpy.types.Operator，用来处理该操作符按钮的执行操作。execute()方法中根据当前选择的操作选项，使用 Blender 提供的函数进行不同的操作。例如，如果选择了“Add Cube”选项，则使用bpy.ops.mesh.primitive_cube_add()函数创建一个立方体，并将其命名为mytool.my_string；同时，根据mytool.my_float_vector中的值对其进行缩放。最后，返回一个{'FINISHED'}字典表示操作已完成。最后，定义了
classes列表包含上述三个类，以及注册和注销插件的函数register()和unregister()，在注册时将MyProperties类的实例指针赋值给bpy.types.Scene.my_tool属性。当运行该脚本时，将自动注册插件。总体来说，这段代码是一个简单的 Blender 插件示例，展示了如何创建自定义属性和操作符，并将它们添加到面板中以实现简单的交互式操作。
import bpy
class MyProperties(bpy.types.PropertyGroup):
my_string: bpy.props.StringProperty(name='Enter Text')
my_float_vector: bpy.props.FloatVectorProperty(name='Enter Value', soft_min=0, soft_max=1000, default=(1, 1, 1))
my_enum: bpy.props.EnumProperty(
name='Enumerator / Dropdown',
description='sample text',
items=[('OP1', 'Add Cube', ''),
('OP2', 'Add Sphere', ''),
('OP3', 'Add Suzanne', '')
]
)
class ADDONNAME_PT_main_panel(bpy.types.Panel):
bl_label = "Main Panel"
bl_idname = "ADDONNAME_PT_main_panel"
bl_space_type = 'VIEW_3D'
bl_region_type = 'UI'
bl_category = "New Tab"
def draw(self, context):
layout = self.layout
scene = context.scene
mytool = scene.my_tool
layout.prop(mytool, 'my_string')
layout.prop(mytool, 'my_float_vector')
layout.prop(mytool, 'my_enum')
row = layout.row()
row.operator("addonname.myop_operator")
class ADDONNAME_OT_my_op(bpy.types.Operator):
bl_label = "Operator"
bl_idname = "addonname.myop_operator"
def execute(self, context):
scene = context.scene
mytool = scene.my_tool
if mytool.my_enum == 'OP1':
bpy.ops.mesh.primitive_cube_add()
bpy.context.object.name = mytool.my_string
bpy.context.object.scale[0] = mytool.my_float_vector[0]
bpy.context.object.scale[1] = mytool.my_float_vector[1]
bpy.context.object.scale[2] = mytool.my_float_vector[2]
if mytool.my_enum == 'OP2':
bpy.ops.mesh.primitive_uv_sphere_add()
bpy.context.object.name = mytool.my_string
bpy.context.object.scale[0] = mytool.my_float_vector[0]
bpy.context.object.scale[1] = mytool.my_float_vector[1]
bpy.context.object.scale[2] = mytool.my_float_vector[2]
if mytool.my_enum == 'OP3':
bpy.ops.mesh.primitive_monkey_add()
bpy.context.object.name = mytool.my_string
bpy.context.object.scale[0] = mytool.my_float_vector[0]
bpy.context.object.scale[1] = mytool.my_float_vector[1]
bpy.context.object.scale[2] = mytool.my_float_vector[2]
return {'FINISHED'}
classes = [MyProperties, ADDONNAME_PT_main_panel, ADDONNAME_OT_my_op]
def register():
for cls in classes:
bpy.utils.register_class(cls)
bpy.types.Scene.my_tool = bpy.props.PointerProperty(type=MyProperties)
def unregister():
for cls in classes:
bpy.utils.unregister_class(cls)
del bpy.types.Scene.my_tool
if __name__ == "__main__":
register()创建了一个可以创建模型并设置相关参数的插件：
Property Subtypes and Password Protection
主要介绍了StringProperty 和 FloatVectorProperty中的 subtype 属性：
在 Blender Python API 中，
StringProperty和FloatVectorProperty中的subtype属性都有以下选项：对于
StringProperty：
FILE_PATH: 文件路径类型。DIR_PATH: 目录路径类型。FILE_NAME: 文件名类型。PASSWORD: 密码类型。NONE: 普通文本类型。对于
FloatVectorProperty：
COLOR: 表示颜色值(RGB)类型。TRANSLATION: 表示平移向量类型。DIRECTION: 表示方向向量类型。VELOCITY: 表示速率/速度向量类型。ACCELERATION: 表示加速度向量类型。NONE: 普通浮点数类型。使用这些不同的
subtype值，可以在 Blender 中创建不同类型的属性，以便更好地适应特定的场景和需求。例如，使用FILE_PATH或DIR_PATH可以创建一个文件选择器或目录选择器，方便用户选择相应的文件或目录；使用COLOR可以创建一种颜色选择器，方便用户选择 RGB 值。
一个密码的使用案例：
import bpy
class MyProperties(bpy.types.PropertyGroup):
my_string : bpy.props.StringProperty(name= "Password", subtype= 'PASSWORD')
class ADDONNAME_PT_main_panel(bpy.types.Panel):
bl_label = "Main Panel"
bl_idname = "ADDONNAME_PT_main_panel"
bl_space_type = 'VIEW_3D'
bl_region_type = 'UI'
bl_category = "New Tab"
def draw(self, context):
layout = self.layout
scene = context.scene
mytool = scene.my_tool
row = layout.row()
split = row.split(factor= 0.5)
row.prop(mytool, "my_string")
layout.operator("addonname.myop_operator")
class ADDONNAME_OT_my_op(bpy.types.Operator):
bl_label = "Confirm"
bl_idname = "addonname.myop_operator"
def execute(self, context):
scene = context.scene
mytool = scene.my_tool
if mytool.my_string == "awesomepassword":
bpy.ops.mesh.primitive_cube_add()
return {'FINISHED'}
classes = [MyProperties, ADDONNAME_PT_main_panel, ADDONNAME_OT_my_op]
def register():
for cls in classes:
bpy.utils.register_class(cls)
bpy.types.Scene.my_tool = bpy.props.PointerProperty(type= MyProperties)
def unregister():
for cls in classes:
bpy.utils.unregister_class(cls)
del bpy.types.Scene.my_tool
if __name__ == "__main__":
register()
Blender 2.90 is here! - Scripting Changes!!?
介绍了 2.9 版本的特性……emmm 我都用上 3.5.1 了
Read an Error Message and how to Fix it [learn python for beginners]
教你怎么看错误提示并根据此进行代码调试。
Importing Modules
教你怎么用 from ... import 语句。