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.

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),該參數用於指定要回傳哪一個設定清單條目。

屬性

int

setting_count

0

方法

NodePath

get_path_3d(index: int) const

int

get_tilt_fade_in(index: int) const

int

get_tilt_fade_out(index: int) const

bool

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)


屬性說明

int setting_count = 0 🔗

  • void set_setting_count(value: int)

  • int get_setting_count()

設定的數量。


方法說明

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。