bpy.ops.curve.reveal

该操作会将曲线对象的选定部分展开成平面上的曲线。

参数

• extend: 如果选中物体为曲线对象的一部分，则默认为 True。如果为 False，则只展开曲线对象中选定部分。
• use_bone_envelopes: 是否使用骨骼缩放。默认为 False。
• axis: 展开轴向。可选值为 X、Y 和 Z。默认为 Y。
• mode: 展开模式。可选值为 ANGLE、SCALE 和 LENGTH。默认为 ANGLE。

返回值

该操作返回一个字典，包含以下键值对：

• FINISHED：如果操作成功完成，则设为 True。
• CANCELLED：如果操作被取消，则设为 True。
• ERROR：如果操作失败，则设为 True。
• selected_objects：包含所有选中的物体的列表。
• curve_mapping：一个字典，其中包含每个曲线的展开映射关系。

报错

如果无法选择曲线对象，则会抛出一个 RuntimeError。

示例

import bpy

# Select a curve object
curve_obj = bpy.context.selected_objects[0]

# Set the desired axis and mode
axis = 'X'
mode = 'SCALE'

# Run the reveal operation
result = bpy.ops.curve.reveal(
    extend=True,
    use_bone_envelopes=False,
    axis=axis,
    mode=mode
)

# Print the results
if result.get('FINISHED'):
    mapping = result['curve_mapping'][curve_obj.name]
    print(f"{curve_obj.name} was successfully revealed with mapping {mapping}")
else:
    print("Operation failed")