# set_trs()

写入这根骨骼的移动、旋转和缩放，并立刻反映到视口。

旋转单位是度。子骨骼会跟着走，和用 Gizmo 旋转时一样。三个值都必须是长度为 3 的数字列表。

`space="local"` 是相对父骨骼。没有父子关系会 `SessionError`。骨骼不在视口里会 `BoneError`。

### 签名
```python
bone.set_trs(translation, rotation_deg, scale, space="world") -> None
```

| 参数 | 含义 |
|---|---|
| `translation` | `(x, y, z)` 移动。 |
| `rotation_deg` | `(x, y, z)` 旋转。单位是度。 |
| `scale` | `(x, y, z)` 缩放。 |
| `space` | `"world"` 或 `"local"`。默认是世界。 |

### 示例
```python
bone = api.bone("Bip001 Spine")
move, rot, scale = bone.trs()
# 世界坐标向上 5 厘米
bone.set_trs((move[0], move[1], move[2] + 5), rot, scale)
```

这是先读出来、只改一根轴、再写回去。需要矩阵就读 [world_matrix](world-matrix.md)。