bpy.ops.gpencil.convert

描述

将当前活动的笔划图层转换为多边形、曲线或纹理面板。转换后，可以在3D视图中进行编辑。

语法

bpy.ops.gpencil.convert(type='CURVE', use_timing_data=True, use_timing_data_end=True, 
                        use_stroke_endpoints=True, use_stroke_leap=True, use_stroke_direction=False,
                        use_stroke_timing_split=True, timing_mode='AUTO', use_timing_fix=True, fix_time=1.0)

参数

• type (string, optional) - 要转换的类型，可取值为：'CURVE'，'POLY'或'TEXTURE' (默认为'CURVE')。
• use_timing_data (boolean) - 是否使用笔划动画定时数据，默认为True。
• use_timing_data_end (boolean) - 是否在定时数据结尾停止笔画，默认为True。
• use_stroke_endpoints (boolean) - 是否在笔划端点处创建一个新的多边形或曲线路径，默认为True。
• use_stroke_leap (boolean) - 是否在笔画之间创建一个新的多边形或曲线路径，默认为True。
• use_stroke_direction (boolean) - 是否使用笔划的方向来创建路径，如果为False则使用笔划的方向来创建路径，默认为False。
• use_stroke_timing_split (boolean) - 是否在笔画的动画定时数据上分割连续的笔画，默认为True。
• timing_mode (string, optional) - 在笔画的动画定时数据上应用的模式，可选值为：'AUTO' ，'LINEAR' 或 'BEZIER'（默认为AUTO）。
• use_timing_fix (boolean) - 是否启用时间修复功能，默认为True。
• fix_time (float) - 用于修复时间差异的固定时间值，默认为1.0。

返回值

• {'FINISHED'} - 转换完成。

示例

将笔划图层转换为纹理面板：

import bpy

# 选择笔划图层
bpy.context.view_layer.objects.active = bpy.data.objects['GPencilObjectName']

# 将笔划图层转换为纹理面板
bpy.ops.gpencil.convert(type='TEXTURE')

异常

• RuntimeError - 如果无法完成转换，则会引发异常。