bpy.ops.curves.snap_curves_to_surface

将曲线沿着表面对齐。

参数

• target: 对齐的表面。
• mode (可选): 对齐模式。可选值为 "CLOSEST" 和 "PROJECT"。默认为 "CLOSEST"。
• method (可选): 对齐方法。可选值为 "MEDIAN" 和 "CENTER"。默认为 "MEDIAN"。
• project_limit (可选): 仅适用于 "PROJECT" 模式。沿着表面投影的最大距离。默认为 10000.0。

返回值

• {'FINISHED'}: 成功执行。

示例

import bpy

# 获取选中的曲线和表面
curves = bpy.context.selected_editable_objects
surface = bpy.context.active_object

# 将曲线沿着表面对齐
bpy.ops.curves.snap_curves_to_surface(target=surface)

# 选中曲线并切换到编辑模式以查看结果
for curve in curves:
    curve.select_set(True)

# 将视图区设置为曲线的编辑模式
bpy.ops.object.mode_set(mode='EDIT_CURVE')

异常

• RuntimeError: 选中了多个表面或没有选中表面时抛出。
• RuntimeError: 未选中曲线时抛出。