SkinLayerStudio API (Beta)
/
API Reference
/
Bone
set_trs()
下载 Markdown写入这根骨骼的移动、旋转和缩放,并立刻反映到视口。
旋转单位是度。子骨骼会跟着走,和用 Gizmo 旋转时一样。三个值都必须是长度为 3 的数字列表。
space="local" 是相对父骨骼。没有父子关系会 SessionError。骨骼不在视口里会 BoneError。
签名
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"。默认是世界。 |
示例
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。