bpy.ops.armature.select_similar

描述

bpy.ops.armature.select_similar 操作将选择具有相似特征的骨骼。该操作旨在简化复杂的骨架选择过程，以提高工作效率。

语法

bpy.ops.armature.select_similar(type='NAME', threshold=0.1, extend=True)

参数

• type (str) - 选择的特征类型。可以是以下值之一：

  • 'NAME' - 骨骼名称
  • 'MATRIX' - 骨架变换矩阵。
  • 'BONELEN' - 骨骼长度。
  • 'CHILDREN' - 子骨骼数目。

• threshold (float) - 特征匹配的阈值。在选择相似骨骼时，匹配特征值的范围由此参数控制。阈值越大，则在特性匹配时所需的匹配精度越高。

• extend (bool) - 指定是否扩展选择。如果为 True，则选择将扩展到所有满足相似特征值的骨骼。否则，选择仅限于单个骨骼。

示例

选择所有名称相似的骨骼

import bpy

bpy.ops.armature.select_similar(type='NAME', threshold=0.0, extend=True)

选择所有长度相似的骨骼

import bpy

bpy.ops.armature.select_similar(type='BONELEN', threshold=0.1, extend=True)

选择所有具有相似子骨骼数的骨骼

import bpy

bpy.ops.armature.select_similar(type='CHILDREN', threshold=0.01, extend=True)

选择具有相似变换矩阵的骨骼

import bpy

bpy.ops.armature.select_similar(type='MATRIX', threshold=0.1, extend=True)

异常

• 当操作无法执行时，会引发 RuntimeError。

参考

• bpy.ops.armature 模块：https://docs.blender.org/api/current/bpy.ops.armature.html