Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

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 = "" 🔗

所附着骨骼的名称。

NodePath 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 节点更新其位置的地方，以便在未设置为覆盖骨骼姿势时正确绑定。