bpy.ops.curve.extrude_move

描述

使用此操作将给定曲线的选择部分沿着其法线方向拉伸，并沿给定向量进行平移移动。

语法

bpy.ops.curve.extrude_move(CURVE_OT_extrude=None, TRANSFORM_OT_translate=None, value=(0, 0, 0))

参数

• CURVE_OT_extrude: 长度为1的元组，指定要进行操作的曲线。如果未提供或设置为 None，则选择活动曲线。
• TRANSFORM_OT_translate：长度为1的元组，指定平移操作。如果未提供或设置为None，则使用默认值。
• value：长度为3的（x，y，z）元组，指定平移移动的距离。

返回值

• 如果成功，则返回 {'FINISHED'}。
• 如果未能执行操作，则返回 {'CANCELLED'}。

使用示例

以下示例演示如何使用bpy.ops.curve.extrude_move()操作，将活动曲线的选择部分向下沿Y轴拉伸5单位，并沿Z轴移动5单位。

import bpy

# 获取活动曲线并选择其前两个点
curve = bpy.context.active_object.data
curve.splines[0].points[0].select = True
curve.splines[0].points[1].select = True

# 使用extrude_move()将它们向下沿Y轴拉伸5单位，并沿Z轴移动5单位
bpy.ops.curve.extrude_move(value=(0, -5, 5))

异常

• Context：如果无法执行操作，则引发此异常。要避免此错误，请确保在执行操作时，必须处于适当的环境中，例如在3D视图区域窗口中选中适当的对象后执行操作。
• ValueError：如果给定的值未设置为长度为1的元组，则引发此异常。