bpy.ops.gpencil.vertex_color_set

简介

该操作用于设置指定手绘笔画中的顶点颜色。

参数

• gpencil_object：指定的手绘笔对象；
• mode：颜色设置模式。支持以下几种选项：
  • 'REPLACE'：使用单一颜色替换所有顶点颜色；
  • 'MIX'：将指定颜色与原有颜色进行混合；
  • 'ADD'：将指定颜色与原有颜色进行相加；
• color：指定的颜色。为一个长度为3的列表，元素的数值范围在0.0到1.0之间；
• replace_strength：替换强度。取值范围在0.0到1.0之间。

返回值

返回一个包含操作结果信息的元组。

示例

import bpy

# 获取指定手绘笔画对象
gpencil_obj = bpy.data.objects['GPencil']

# 设置一个新的顶点颜色
color = [0.5, 0.7, 0.3]
bpy.ops.gpencil.vertex_color_set(gpencil_object=gpencil_obj, mode='REPLACE', color=color, replace_strength=1.0)