bpy.ops.gpencil.stroke_outline

简介

此操作用于在笔画的外围绘制一个边框

参数

• mode：边框绘制模式，可选值为 SELECTED、ALL 或 VISIBLE，默认值为 SELECTED
• thickness：边框线条厚度，浮点数类型，默认值为 0.1
• color：颜色，元组类型 (r, g, b, a)，r, g, b, a 分别表示红色、绿色、蓝色和 Alpha 值，浮点数类型，可选值为 [0, 1]，默认值为 (1.0, 1.0, 1.0, 1.0)

返回值

• {'FINISHED'}：操作执行成功

示例

import bpy

# 选中笔画
bpy.ops.object.select_all(action='DESELECT')
bpy.data.objects['GPencilObjectName'].select_set(True)
bpy.context.view_layer.objects.active = bpy.data.objects['GPencilObjectName']

# 声明操作参数
mode = 'SELECTED'
thickness = 0.15
color = (1.0, 0.0, 0.0, 1.0)

# 绘制边框
bpy.ops.gpencil.stroke_outline(mode=mode, thickness=thickness, color=color)

print("Stroke outline added successfully!")

异常

• RuntimeError：如果没有选择任何笔画或设置了错误的模式，则操作无法执行
• ValueError：如果设置了错误的参数类型，则操作无法执行

作者

Blender Foundation