bpy.ops.armature.select_hierarchy

描述

选择模型的整个骨架层次结构。骨架层次结构包括骨骼及其子骨骼的连接。

语法

bpy.ops.armature.select_hierarchy(direction='DESCEND')

参数

• direction (字符串，可选) - 选择的方向，有两个可选参数'ASCEND'和'DESCEND'，默认值为'DESCEND'。

返回值

• {'FINISHED'}。操作成功完成。

示例

import bpy

# 选择当前活动对象的骨架层次结构
bpy.ops.object.mode_set(mode='POSE')
bpy.ops.armature.select_hierarchy()

# 选择一个特定的骨架及其子骨骼
bpy.ops.object.mode_set(mode='POSE')
armature = bpy.data.objects['Armature']
bone = armature.pose.bones['Bone']
bone.select = True
bpy.ops.armature.select_hierarchy()

异常

• RuntimeError - 如果当前没有选定的对象或对象不是骨架，则会引发此异常。

注意事项

• 此操作将自动进入“POSE”模式以执行所需操作。
• 如果骨架中存在已选择的骨骼，则只会选择它们和它们的子骨骼。

版本兼容性

支持版本:

• Blender 2.8x 或更高版本。

参考

• Blender Python API: bpy.ops.armature.select_hierarchy