bpy.ops.gpencil.vertex_color_hsv

该操作允许您在笔画中以HSV（色相、饱和度、值）值的形式指定顶点颜色。

参数

• hue（float）-顶点的色相值。取值范围为0.0到1.0之间。
• saturation（float）-顶点的饱和度值。取值范围为0.0到1.0之间。
• value（float）-顶点的值。取值范围为0.0到1.0之间。
• threshold（float）-对于饱和度或价值而言，越低的阈值最终会导致更少的颜色变化。取值范围为0.0到1.0之间。
• tint_color（float数组）-要在颜色上混合的红色、绿色、蓝色、透明度（RGBA）值列表。RGBA值的取值范围为0.0到1.0之间。

返回值

• {'FINISHED'}：操作已成功完成。
• {'CANCELLED'}：发生错误或操作被取消。

示例

import bpy

# 获取当前活动的3D视图
view3d = bpy.context.space_data

# 获取笔画集合中的第一个笔画
gpencil = bpy.context.active_object.data

# 获取笔画中的第一个笔画层
layer = gpencil.layers[0]

# 获取笔画层中的第一个笔画
stroke = layer.strokes[0]

# 在第一个笔画的第一个顶点处设置颜色
bpy.ops.gpencil.vertex_color_hsv(
    hue=0.2,
    saturation=1.0,
    value=1.0,
    threshold=0.0,
    tint_color=(1.0, 1.0, 1.0, 1.0)
)

异常

• RuntimeError：如果没有选定笔画，则引发异常。

注意

• 笔画必须选定才能使用此操作。
• 该操作仅适用于“顶点颜色”绘画风格。
• HSV值将覆盖笔画中所设置的RGB值，因此最终颜色将通过此操作中的HSV值呈现。
• 如果将tint_color参数设置为一个具有a值的RGBA颜色列表，则此颜色将与HSV颜色合并。

参考

• 官方文档