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...
SplineIK3D
繼承: ChainIK3D < IKModifier3D < SkeletonModifier3D < Node3D < Node < Object
用於沿 Path3D 對齊骨骼的 SkeletonModifier3D。
說明
一種用於沿 Path3D(3D路徑)對齊骨骼的 SkeletonModifier3D(3D骨骼修改器)。擬合的平滑度取決於 Curve3D.bake_interval(曲線3D的烘焙間隔)。
如果你希望 Path3D 附著在某個特定的骨骼上,建議將 ModifierBoneTarget3D(修改器骨骼目標3D)放在 SkeletonModifier3D 清單(Skeleton3D 的子節點)中 SplineIK3D 的前面,然後將 Path3D 作為 ModifierBoneTarget3D 的子節點放置。
骨骼的扭轉由 Curve3D.get_point_tilt()(曲線3D取得點傾斜度)方法決定。
如果根骨骼關節與 Curve3D(曲線3D)的起點是分離的,它會假設兩者之間存在一條直線段。這意味著,指向 Curve3D 起點的向量,其優先級會高於沿 Curve3D 的最短交點。
如果末端骨骼關節超出了路徑的長度,它會盡可能地向著 Curve3D 的終點彎曲。
注意: 該類中的所有方法都帶有一個 index(索引)參數。如果 IK(反向動力學)有多個條目(例如 settings//root_bone_name),該參數用於指定要回傳哪一個設定清單條目。
屬性
|
方法
get_path_3d(index: int) const |
|
get_tilt_fade_in(index: int) const |
|
get_tilt_fade_out(index: int) const |
|
is_tilt_enabled(index: int) const |
|
void |
set_path_3d(index: int, path_3d: NodePath) |
void |
set_tilt_enabled(index: int, enabled: bool) |
void |
set_tilt_fade_in(index: int, size: int) |
void |
set_tilt_fade_out(index: int, size: int) |
屬性說明
設定的數量。
方法說明
NodePath get_path_3d(index: int) const 🔗
回傳描述路徑的 Path3D 的節點路徑。
int get_tilt_fade_in(index: int) const 🔗
根骨骼與 Curve3D 起始點不重合時,回傳它們之間使用的傾斜插值方法。另見 set_tilt_fade_in()。
int get_tilt_fade_out(index: int) const 🔗
當末端骨骼和 Curve3D 的終點不重合時,回傳它們之間使用的傾斜插值的方法。另見 set_tilt_fade_out()。
bool is_tilt_enabled(index: int) const 🔗
回傳 Curve3D 的傾斜屬性是否影響骨骼扭轉。
void set_path_3d(index: int, path_3d: NodePath) 🔗
設定描述路徑的 Path3D 的節點路徑。
void set_tilt_enabled(index: int, enabled: bool) 🔗
設定 Curve3D 的傾斜屬性是否應該影響骨骼的扭轉。
void set_tilt_fade_in(index: int, size: int) 🔗
如果 size 大於 0,則當它們彼此分離時,傾斜角度會在從 Curve3D 起始點起的 size 個起始骨骼之間進行插值計算。
如果 size 等於 0,則根骨骼頭部和 Curve3D 起始點之間的傾斜角度將與 Curve3D 起始點的傾斜角度保持一致。
如果 size 小於 0,則根骨骼和 Curve3D 起始點之間的傾斜角度為 0.0。
void set_tilt_fade_out(index: int, size: int) 🔗
如果 size 大於 0,則當它們彼此分離時,傾斜角度會在從 Curve3D 終點起的 size 個末端骨骼之間進行插值計算。
如果 size 等於 0,則末端骨骼尾部與 Curve3D 終點之間的傾斜角度將與 Curve3D 終點的傾斜角度保持一致。
如果 size 小於 0,則末端骨骼與 Curve3D 終點之間的傾斜角度為 0.0。