BoneAttachment3D

继承： Node3D < Node < Object

对父级 Skeleton3D 中某个骨骼的 3D 变换进行复制或覆盖的节点。

描述

这个节点能够选中 Skeleton3D 中的某个骨骼并附加到这个骨骼上。这样 BoneAttachment3D 节点就能够动态复制或覆盖所选骨骼的 3D 变换。

属性

int	bone_idx	-1
String	bone_name	""
NodePath	external_skeleton
bool	override_pose	false
PhysicsInterpolationMode	physics_interpolation_mode	2 (overrides Node)
bool	use_external_skeleton	false

方法

Skeleton3D	get_skeleton()
void	on_skeleton_update()

---

属性说明

int bone_idx = -1 🔗

• void set_bone_idx(value: int)

• int get_bone_idx()

所附着骨骼的索引。

---

String bone_name = "" 🔗

• void set_bone_name(value: String)

• String get_bone_name()

所附着骨骼的名称。

---

NodePath external_skeleton 🔗

• void set_external_skeleton(value: NodePath)

• NodePath get_external_skeleton()

指向外部 Skeleton3D 节点的 NodePath。

---

bool override_pose = false 🔗

• void set_override_pose(value: bool)

• bool get_override_pose()

BoneAttachment3D 节点是否会覆盖所附着骨骼的骨骼姿势。设置为 true 时，BoneAttachment3D 节点能够更改骨骼的姿势。设置为 false 时，BoneAttachment3D 始终为该骨骼的变换。

注意：由于固有的设计，覆盖是在骨架更新的过程中使用信号打断执行的。与 SkeletonModifier3D 一起使用时可能会造成预料之外的行为。

---

bool use_external_skeleton = false 🔗

• void set_use_external_skeleton(value: bool)

• bool get_use_external_skeleton()

设置 BoneAttachment3D 节点是否使用外部 Skeleton3D 节点，而不是尝试使用其父节点作为 Skeleton3D。当设置为 true 时，BoneAttachment3D 节点将使用 external_skeleton 中设置的外部 Skeleton3D 节点。

---

方法说明

Skeleton3D get_skeleton() 🔗

如果存在父级或外部 Skeleton3D 节点则将其返回，否则返回 null。

---

void on_skeleton_update() 🔗

当 Skeleton3D 被更新时自动调用的函数。该函数是 BoneAttachment3D 节点更新其位置的地方，以便在未设置为覆盖骨骼姿势时正确绑定。