bpy.ops.gpencil.layer_duplicate_object

描述

该操作可以复制当前动画素材或图层中的笔画或物件，并将其粘贴到同一图层中。 新的笔画或物件将显示在它们的原始位置上并将被选中。

用法

使用前需要先选中一个动画素材或图层。然后可以通过以下步骤执行此操作：

• 打开[bpy.ops.gpencil.layer_duplicate_object]（https://docs.blender.org/api/current/bpy.ops.gpencil.html#bpy.ops.gpencil.layer_duplicate_object）。
• 选择需要复制的笔画或物件。
• 确认您想要复制物件到的图层。
• 单击“执行”。

参数

• 选定选择 - 此参数确定您要复制和粘贴的物件类型（笔画或物件）。

• 重新命名 - 如果选中此复选框，则可以将新创建的图层命名为您选择的名称。如果未选中此选项，则默认使用“图层XX”（其中“XX”是图层的编号）。若需使用默认值请不选择。

• 选定图层 - 此参数确定要将图层复制到的位置。您可以使用下拉框选择现有的图层，或使用“新图层”选项创建一个新的图层。

• 新图层名称 - 如果新建立图层，则可以在此输入文本框中指定新图层的名称。如果未输入文本，则默认为“图层XX”（其中“XX”是图层的编号）。若需使用默认值请不选择。

返回值

该方法不返回任何值，但它会创建并选中一个新的笔划或物件。

示例

以下代码将选定当前动画素材或图层中的所有笔画或物件，并将它们复制到一个名为“新层”的新图层中：

import bpy

bpy.ops.gpencil.layer_duplicate_object(type='STROKE')
bpy.ops.gpencil.select_all(action='SELECT')
bpy.ops.gpencil.layer_duplicate_object(type='STROKE', clonedlayers='NEW', name='New Layer')

异常

• RuntimeError - 如果没有选择动画素材或图层，则可能引发此异常。

• ValueError - 如果输入的参数无效，则可能引发此异常。