bpy.ops.gpencil.duplicate

描述

该操作复制并粘贴笔划，并将其放置在新的位置。复制笔划的现有属性和材料。

语法

bpy.ops.gpencil.duplicate(
    trans_x=0, 
    trans_y=0, 
    trans_z=0,
    rotate=0, 
    scale=1,
    mode='SELECTED',
    fitview=False,
    duplicate_gpencil=False,
    linked_dupli=False,
    use_transform_data=True
    )

参数

• trans_x (float) - 沿 X 轴移动笔划的距离。单位：厘米。
• trans_y (float) - 沿 Y 轴移动笔划的距离。单位：厘米。
• trans_z (float) - 沿 Z 轴移动笔划的距离。单位：厘米。
• rotate (float) - 旋转笔划的角度。单位：度。
• scale (float) - 缩放笔划的大小。
• mode (str) - 复制的笔划模式，可选值为：SELECTED（选择的笔划）, ALL（全部笔划）。
• fitview (bool) - 是否自适应视图。
• duplicate_gpencil (bool) - 是否复制笔划数据。
• linked_dupli (bool) - 是否关联复制。
• use_transform_data (bool) - 是否使用变换数据。

返回值

• {'FINISHED'} - 操作完成

• {'CANCELLED'} - 操作取消

示例

该操作可用于复制笔记或漫画中的手绘图形。

import bpy

# 选择笔划
bpy.ops.gpencil.select_all(action='DESELECT')
bpy.context.view_layer.objects.active = bpy.data.objects['笔划']
bpy.ops.object.mode_set(mode='EDIT_GPENCIL')
bpy.ops.gpencil.select_all(action='SELECT')

# 复制笔划
bpy.ops.gpencil.duplicate(
    trans_x=5, 
    trans_y=0, 
    trans_z=0,
    rotate=45, 
    scale=0.5,
    mode='SELECTED',
    fitview=False,
    duplicate_gpencil=False,
    linked_dupli=False,
    use_transform_data=True
    )

更多资料

• 官方文档