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.

RetargetModifier3D

繼承: SkeletonModifier3D < Node3D < Node < Object

修改器,能夠將父骨架的姿勢(或全域姿勢)轉移給在模型空間中具有不同放鬆姿勢的子骨架。

說明

取得模型空間中相對於父骨架放鬆姿勢的姿勢(或全域姿勢)並將其轉移給子 Skeleton。

修改器會在父骨架的更新過程中直接重寫子骨架的姿勢。這意味著它會覆蓋目標骨架上正常處理過程中設定的映射骨骼姿勢。如果你想要在重新定向後設定目標骨架的骨骼姿勢,則需要向目標骨架新增一個 SkeletonModifier3D 子節點才能修改姿勢。

注意:啟用 use_global_pose 時,即便是未映射的骨骼也可能導致視覺問題,因為如果父骨骼存在映射的子骨骼,那麼應用全域姿勢時會忽略父骨骼的姿勢。另見 use_global_pose。

屬性

bool

copy_bone_skin_scale

true

BitField[TransformFlag]

enable

7

SkeletonProfile

profile

bool

use_global_pose

false

方法

bool

is_position_enabled() const

bool

is_rotation_enabled() const

bool

is_scale_enabled() const

void

set_position_enabled(enabled: bool)

void

set_rotation_enabled(enabled: bool)

void

set_scale_enabled(enabled: bool)


列舉

flags TransformFlag: 🔗

TransformFlag TRANSFORM_FLAG_POSITION = 1

如果設定,則允許重新導向位置。

TransformFlag TRANSFORM_FLAG_ROTATION = 2

如果設定,則允許重新導向旋轉。

TransformFlag TRANSFORM_FLAG_SCALE = 4

如果設定,則允許重新導向縮放。

TransformFlag TRANSFORM_FLAG_ALL = 7

如果設定,則允許重新導向位置、旋轉、位置。


屬性說明

bool copy_bone_skin_scale = true 🔗

  • void set_copy_bone_skin_scale(value: bool)

  • bool is_copying_bone_skin_scale()

If true, copies Skeleton3D.get_bone_skin_scale() of the source skeleton's bones to the child skeletons' mapped bones.

If false, the skin scale of the child skeletons' mapped bones are reset to Vector3(1, 1, 1) once and will not be overwritten after that.

Note: If you want to use Skeleton3D.set_bone_skin_scale() on a child skeleton's mapped bone, set this to false. Even if you are not using Skeleton3D.set_bone_skin_scale() with parent skeleton, Vector3(1, 1, 1) will always be set for the child skeletons' mapped bones.


BitField[TransformFlag] enable = 7 🔗

停用 use_global_pose 時,用於單獨控制變換元素過程的標誌。


SkeletonProfile profile 🔗

用於重新導向與骨骼清單中名稱匹配骨骼的 SkeletonProfile。


bool use_global_pose = false 🔗

  • void set_use_global_pose(value: bool)

  • bool is_using_global_pose()

如果為 false,則在目標骨架的骨骼數量少於源骨架時,源骨架父級的變換將被忽略。

這樣可以在不同體型的模型之間進行重新導向,位置、旋轉和縮放都可以單獨重新導向。

如果為 true,則在重新導向時會考慮全域姿勢。

在目標骨架的骨骼數量少於源骨架的情況下,會考慮源骨架父級的變換。然而,骨架之間的骨骼長度必須完全匹配,否則骨骼將被強制擴充或縮小。

適用於在骨骼數量不同的模型之間進行重新導向時使用長度為 0 的虛設骨骼來匹配姿勢。


方法說明

bool is_position_enabled() const 🔗

如果 enable 中有 TRANSFORM_FLAG_POSITION 則回傳 true。


bool is_rotation_enabled() const 🔗

如果 enable 中有 TRANSFORM_FLAG_ROTATION 則回傳 true。


bool is_scale_enabled() const 🔗

如果 enable 中有 TRANSFORM_FLAG_SCALE 則回傳 true。


void set_position_enabled(enabled: bool) 🔗

在 enable 中設定 TRANSFORM_FLAG_POSITION。


void set_rotation_enabled(enabled: bool) 🔗

在 enable 中設定 TRANSFORM_FLAG_ROTATION。


void set_scale_enabled(enabled: bool) 🔗

在 enable 中設定 TRANSFORM_FLAG_SCALE。