bpy.ops.gpencil.extract_palette_vertex

将 Grease Pencil 绘图笔刷中的调色板顶点转化为另一个 Grease Pencil 数据

描述

bpy.ops.gpencil.extract_palette_vertex 是一个用于将 Grease Pencil 绘图笔刷中的调色板顶点数据提取并将其转化为另一个 Grease Pencil 数据的 bpy 操作。

该操作是在 bpy.types.GPENCIL_OT_extract_palette_vertex 中实现，并提供了选择需要转化的绘图笔刷、调色板类型、调色板名称等选项。

用法

1. 准备至少两个 Grease Pencil 数据
2. 将其中一个数据的一种或多种调色板使用不同的调色板颜色绘制
3. 选中其中包含调色板的 Grease Pencil 数据，并进入 Grease Pencil Mode
4. 在调色板切换菜单中选择需要提取的调色板
5. 在 Object 菜单中选择 Grease Pencil > Extract Palette Vertex
6. 在弹出的选项面板中选择目标数据、调色板类型和调色板名称，并确认转化

参数

• data (bpy.types.GreasePencil)：需要提取调色板的 Grease Pencil 数据对象
• target_data (bpy.types.GreasePencil)：新建的 Grease Pencil 数据对象，用于存储提取后的调色板
• palette_type (Enum)：调色板类型，支持 COLOR_PALETTE 和 MATERIAL_PALETTE 两种类型
• palette_name (String)：调色板名称，提取指定名称的调色板
• use_colors (Boolean)：是否使用调色板颜色绘制提取出的数据，默认为 True
• remove_unused_colors (Boolean)：是否删除未使用的调色板颜色，默认为 True

返回值

该操作没有返回值。提取后的调色板数据将保存在选择的目标数据中。

异常

该操作可能引发以下异常：

• RuntimeError：内部操作错误，未能完成转化