# bone()

按名字取屏幕上正在动的一根骨骼。

拼写必须一致。`Bip001 Spine` 和 `Bip001Spine` 是两根不同的骨骼。没有这个名字会抛出 `BoneError`，不会给你一个空把手。

只在权重列表里、视口里不动的骨骼，这里取不到。那些名字在 [bone_names](bone-names.md)。

### 签名
```python
api.bone(name) -> bone
```

| 参数 | 含义 |
|---|---|
| `name` | 视口里的骨骼名字。字符串。 |

### 示例
```python
bone = api.bone("Bip001 L UpperArm")
print(bone.name)
print(bone.trs())
```

需要名字列表时，先调用 [bones](bones.md)。