bpy.ops.armature.symmetrize()

简介

bpy.ops.armature.symmetrize() 是一个用于逆向对称化骨架的操作函数，它将对称点左侧的骨骼节点复制到右侧，从而使得骨架成为对称的。

参数

• direction: 对称化的方向。可以是 "POS_X"、"POS_Y"、"POS_Z"、"NEG_X"、"NEG_Y"、"NEG_Z" 中的一个。默认为 "NEG_X"。

• threshold: 对称化的阈值。当骨骼节点的位置差异小于该值时，该节点将被复制。默认为 0.0001。

• lock_x: 是否固定对称轴 X 的位置。默认为 False。

• lock_y: 是否固定对称轴 Y 的位置。默认为 False。

• lock_z: 是否固定对称轴 Z 的位置。默认为 False。

返回值

• {'FINISHED'}: 成功运行操作。

• {'CANCELLED'}: 操作被取消。

示例

import bpy

# 选择要对称化的骨架
armature = bpy.context.active_object

# 对称化
bpy.ops.armature.symmetrize(
    armature,
    direction='NEG_X',
    threshold=0.0001,
    lock_x=False,
    lock_y=False,
    lock_z=False
)

异常

无

注意事项

• 只有具有对称特性的骨架才能使用此操作。

• 操作将更改当前选定骨架的形状和位置。如果不确定操作的效果，请先备份或复制该骨架。

• 对称化不会更改已经连接到骨架的网格的形状。如需更新网格，请选择骨架并执行 "Recalculate Normals" 操作。