用于在当前画笔集合中添加一个新画笔。
bpy.ops.brush.add(paint_mode='VERTEX_PAINT', name='', radius=10.0, color=(0.0, 0.0, 0.0), strength=1.0, texture=None, texture_slot=None, use_random_texture=False, texture_brightness=1.0, texture_contrast=1.0, texture_saturation=1.0, gradient_stroke_type='LINEAR', gradient_stroke_color_type='RGB', gradient_stroke_vector_type='VIEW', gradient_stroke_angle=0.0, gradient_stroke_position=0.0, gradient_stroke_width=1.0, gradient_stroke_sharpness=1.0, gradient_stroke_mirrored=False, cursor=None, show_cursor=True, release_confirm=True)
paint_mode
(string): 画笔模式,默认为 'VERTEX_PAINT'.name
(string): 画笔名称,默认为空。radius
(float): 画笔半径,默认为 10.0.color
(tuple of 3 floats): 画笔颜色,默认为 (0.0, 0.0, 0.0).strength
(float): 画笔强度,默认为 1.0.texture
(blender image): 画笔使用的纹理,默认为空.texture_slot
(int): 画笔使用的纹理槽,用于更改或者删除纹理,默认为 None.use_random_texture
(bool): 是否使用随机纹理,默认为 False.texture_brightness
(float): 纹理等亮度,默认为 1.0.texture_contrast
(float): 纹理对比度,默认为 1.0.texture_saturation
(float): 纹理饱和度,默认为 1.0.gradient_stroke_type
(string): 渐变笔画类型,默认为 'LINEAR'.gradient_stroke_color_type
(string): 渐变笔画颜色类型,默认为 'RGB'.gradient_stroke_vector_type
(string): 渐变笔画矢量类型,默认为 'VIEW'.gradient_stroke_angle
(float): 渐变笔画角度,默认为 0.0.gradient_stroke_position
(float): 渐变笔画位置,默认为 0.0.gradient_stroke_width
(float): 渐变笔画宽度,默认为 1.0.gradient_stroke_sharpness
(float): 渐变笔画锐度,默认为 1.0.gradient_stroke_mirrored
(bool): 是否以对称的方式绘制渐变笔画,默认为 False.cursor
(enum): 允许使用不同类型的光标,默认为空.show_cursor
(bool): 是否显示光标,默认为 True.release_confirm
(bool): 是否需要确认释放鼠标,默认为 True.{'FINISHED'}
: 添加画笔操作成功完成。import bpy
# 添加画笔
bpy.ops.brush.add(paint_mode='VERTEX_PAINT', name='my_brush', radius=10.0, color=(0.8, 0.2, 0.4), strength=0.8)
# 添加带有纹理的画笔
bpy.ops.brush.add(paint_mode='VERTEX_PAINT', name='my_brush_with_texture', radius=10.0, texture=bpy.data.images['my_texture'])
# 添加渐变笔画
bpy.ops.brush.add(paint_mode='VERTEX_PAINT', name='my_gradient_brush', gradient_stroke_type='RADIAL', gradient_stroke_color_type='HSV', gradient_stroke_vector_type='NORMAL', gradient_stroke_angle=-45.0, gradient_stroke_position=0.5, gradient_stroke_width=5.0, gradient_stroke_sharpness=0.2)
该操作会添加一个新的画笔,并将其添加到当前的画笔集合中。可以根据需要设置各种画笔属性。如果需要添加一个使用纹理或者渐变笔画的画笔,则需要将对应的参数设置正确。注意事项:该操作不会影响当前的场景。添加一个新画笔不会影响现有的可见性或者选择性设置,也不会影响选择一组物体或者设置其他属性。完全可以在添加新画笔之前或者之后执行其它操作。